Support Node.js >= 12.

- Update changelog and add special note.
- Update workflow.
- Add browserify testing to workflow.
- Update dependencies.
  - Remove unneeded dependencies.
  - Update dependencies that required newer Node.js versions.
- Remove node6 code generation.
- Remove other earlier Node.js version hacks.

Author: davidlehn

.github/workflows/main.yml

@@ -8,7 +8,7 @@ jobs:
     timeout-minutes: 10
     strategy:
       matrix:
-        node-version: [10.x, 12.x, 14.x]
+        node-version: [12.x, 14.x]
     steps:
     - uses: actions/checkout@v2
     - name: Use Node.js ${{ matrix.node-version }}
@@ -27,6 +27,7 @@ jobs:
     strategy:
       matrix:
         node-version: [14.x]
+        bundler: [webpack, browserify]
     steps:
     - uses: actions/checkout@v2
     - name: Use Node.js ${{ matrix.node-version }}
@@ -39,6 +40,8 @@ jobs:
       run: npm run fetch-test-suites
     - name: Run karma tests
       run: npm run test-karma
+      env:
+        BUNDLER: ${{ matrix.bundler }}
   lint:
     runs-on: ubuntu-latest
     timeout-minutes: 10

CHANGELOG.md

@@ -2,23 +2,33 @@
 
 ## 5.0.0 - TBD
 
+### Notes
+- Support is dropped for Node.js versions earlier than v12. This reduces the
+  maintenance burden of being limited by older APIs, development tools, and
+  dependencies. If you need to use an earlier Node.js then either use a
+  previous jsonld.js version or use translation tools and polyfills as needed.
+  (The built-in process to make browser bundles may work for this.) Bug fixes
+  and updates may be back-ported to previous versions from time to time or on
+  request (preferably with a patch).
+
 ### Changed
-- Node documentLoader now uses `@digitalbazaar/http-client` instead of
+- Node.js documentLoader now uses `@digitalbazaar/http-client` instead of
   `request`.
-- **BREAKING** Supported node version is now node >= 10.
+- **BREAKING** Only support Node.js >= 12. Remove related unneeded polyfills,
+  tests, and `node6` output. Update dependencies that needed newer Node.js
+  versions.
 - Use Babel `usage` mode rather than listing individual polyfills. May increase
-  bundle size but is more automated and likely more accurately supporting
-  intended output targets.
+  bundle size due to more accurate support of intended output targets.
 
 ### Added
 - Distribute a `jsonld.esm.min.js` bundle optimized for the features available
   in browsers that support ES Modules.
 
 ### Removed
-- Use of deprecated library `request` in node documentLoader.
-- **BREAKING** Parameter `request` has been removed from the node
+- Use of deprecated library `request` in Node.js documentLoader.
+- **BREAKING** Parameter `request` has been removed from the Node.js
   documentLoader.
-- Node documentLoader should no longer be included in browser build.
+- Node.js documentLoader should no longer be included in browser build.
 
 ## 4.0.1 - 2021-02-11
 

karma.conf.js

@@ -131,8 +131,25 @@ module.exports = function(config) {
     },
 
     browserify: {
-      debug: true
-      //transform: ['uglifyify']
+      debug: false,
+      transform: [
+        //'uglifyify',
+        [
+          'envify', {
+            BAIL: process.env.BAIL,
+            EARL: process.env.EARL,
+            JSONLD_BENCHMARK: process.env.JSONLD_BENCHMARK,
+            JSONLD_TESTS: process.env.JSONLD_TESTS,
+            TEST_ROOT_DIR: __dirname,
+            VERBOSE_SKIP: process.env.VERBOSE_SKIP
+          }
+        ]
+      ],
+      plugin: [
+        [
+          require('esmify')
+        ]
+      ]
     },
 
     // test results reporter to use

lib/index.js

@@ -3,17 +3,6 @@
  *
  * @author Dave Longley
  *
- * Copyright 2010-2017 Digital Bazaar, Inc.
+ * Copyright 2010-2021 Digital Bazaar, Inc.
  */
-// FIXME: remove after change to core-js 3 and dropping node6 support
-const fromEntries = require('object.fromentries');
-if(!Object.fromEntries) {
-  fromEntries.shim();
-}
-
-if(require('semver').gte(process.version, '8.6.0')) {
-  module.exports = require('./jsonld');
-} else {
-  require('core-js/fn/object/entries');
-  module.exports = require('../dist/node6/lib/jsonld');
-}
+module.exports = require('./jsonld');

package.json

@@ -25,20 +25,16 @@
   "files": [
     "dist/*.js",
     "dist/*.js.map",
-    "dist/node6/**/*.js",
     "lib/*.js",
     "lib/**/*.js"
   ],
   "dependencies": {
     "@digitalbazaar/http-client": "^1.0.0",
     "canonicalize": "^1.0.1",
-    "lru-cache": "^5.1.1",
-    "object.fromentries": "^2.0.4",
-    "rdf-canonize": "^2.0.1",
-    "semver": "^6.3.0"
+    "lru-cache": "^6.0.0",
+    "rdf-canonize": "^2.0.1"
   },
   "devDependencies": {
-    "@babel/cli": "^7.13.10",
     "@babel/core": "^7.13.10",
     "@babel/plugin-proposal-object-rest-spread": "^7.13.8",
     "@babel/plugin-transform-modules-commonjs": "^7.13.8",
@@ -48,39 +44,42 @@
     "@babel/runtime": "^7.13.10",
     "babel-loader": "^8.0.5",
     "benchmark": "^2.1.4",
-    "browserify": "^16.2.3",
+    "browserify": "^17.0.0",
     "chai": "^4.3.3",
     "core-js": "^3.9.1",
     "cors": "^2.7.1",
-    "cross-env": "^5.2.0",
-    "eslint": "^6.8.0",
-    "eslint-config-digitalbazaar": "2.5.x",
+    "cross-env": "^7.0.3",
+    "envify": "^4.1.0",
+    "eslint": "^7.21.0",
+    "eslint-config-digitalbazaar": "^2.6.1",
+    "esmify": "^2.1.1",
     "express": "^4.16.4",
-    "fs-extra": "^8.1.0",
+    "fs-extra": "^9.1.0",
     "join-path-js": "0.0.0",
-    "karma": "^4.4.1",
+    "karma": "^5.2.3",
     "karma-babel-preprocessor": "^8.0.0",
-    "karma-browserify": "^6.0.0",
-    "karma-chrome-launcher": "^2.2.0",
+    "karma-browserify": "^8.0.0",
+    "karma-chrome-launcher": "^3.1.0",
     "karma-edge-launcher": "^0.4.2",
-    "karma-firefox-launcher": "^1.1.0",
+    "karma-firefox-launcher": "^2.1.0",
     "karma-ie-launcher": "^1.0.0",
-    "karma-mocha": "^1.3.0",
+    "karma-mocha": "^2.0.1",
     "karma-mocha-reporter": "^2.2.5",
     "karma-safari-launcher": "^1.0.0",
     "karma-server-side": "^1.7.0",
     "karma-sourcemap-loader": "^0.3.7",
     "karma-tap-reporter": "0.0.6",
     "karma-webpack": "^4.0.2",
-    "mocha": "^6.2.2",
+    "mocha": "^8.3.1",
     "mocha-lcov-reporter": "^1.3.0",
-    "nyc": "^14.1.1",
+    "nyc": "^15.1.0",
+    "watchify": "^3.11.1",
     "webpack": "^4.29.5",
-    "webpack-cli": "^3.2.3",
-    "webpack-merge": "^4.2.1"
+    "webpack-cli": "^4.5.0",
+    "webpack-merge": "^5.7.3"
   },
   "engines": {
-    "node": ">=10"
+    "node": ">=12"
   },
   "keywords": [
     "JSON",
@@ -92,9 +91,8 @@
   ],
   "scripts": {
     "prepublish": "npm run build",
-    "build": "npm run build-webpack && npm run build-node6",
+    "build": "npm run build-webpack",
     "build-webpack": "webpack",
-    "build-node6": "BROWSERSLIST='node 6' babel --no-babelrc lib --out-dir dist/node6/lib --presets=@babel/preset-env",
     "fetch-test-suites": "npm run fetch-json-ld-wg-test-suite && npm run fetch-json-ld-org-test-suite && npm run fetch-normalization-test-suite",
     "fetch-json-ld-wg-test-suite": "npm run fetch-json-ld-api-test-suite && npm run fetch-json-ld-framing-test-suite",
     "fetch-json-ld-api-test-suite": "if [ ! -e test-suites/json-wg-api ]; then git clone --depth 1 https://github.com/w3c/json-ld-api.git test-suites/json-ld-api; fi",

tests/test.js

@@ -22,20 +22,6 @@
  *
  * Copyright (c) 2011-2019 Digital Bazaar, Inc. All rights reserved.
  */
-
-// support async/await tests in node6
-if(!require('semver').gte(process.version, '8.6.0')) {
-  require('@babel/register')({
-    presets: [
-      [
-        '@babel/preset-env', {
-          targets: 'node 6'
-        }
-      ]
-    ]
-  });
-}
-
 const assert = require('chai').assert;
 const common = require('./test-common');
 const fs = require('fs-extra');

webpack.config.js

@@ -6,7 +6,9 @@
  * Copyright 2010-2017 Digital Bazaar, Inc.
  */
 const path = require('path');
-const webpackMerge = require('webpack-merge');
+const {
+  merge: webpackMerge
+} = require('webpack-merge');
 
 // build multiple outputs
 module.exports = [];