ES Modules (#295)

* Update package-lock.json file

* Fix broken tests in blank.spec.js

Blank binary file was not getting serialized as { type: "Buffer", data: [] }
because read(file) was returning a string instead of Buffer.

* Fix webpack error when running browser tests

Webpack 4 cannot parse module containing optional chaining operator.
See https://stackoverflow.com/questions/59972341/how-to-make-webpack-accept-optional-chaining-without-babel

* Fix tests in invalid.spec.js when running in Chrome

* Change statusCode to status

* Set the --openssl-legacy-provider flag when running browser tests

Recent versions of node upgraded to OpenSSL 3.0, which deprecated some
older crypto hashing algorithms including md4.

Webpack 4 hard codes the use of md4 ins some places, so we have to set this
flag until we can upgrade Webpack.

* Use isomorphic-fetch instead of node-fetch

Browser tests were failing as polyfill.js was loading a node package in a browser context.

* Increase minimum version of node to 17

This was when the --openssl-legacy-provider option was introduced.
Prior versions of node do not recognize this option.

* Add chokidar@3 as an explicit dev dependency

Browser tests are failing in the CI environment with:
chokidar@3: Error: Cannot find module 'chokidar'

Don't know why but this thread might be relevant:
facebook/create-react-app#10811

* Skip test assertion due to conflict on Windows

See also #286

* Explicitly define browsers and plugins in karma.conf.js

* Replace karma-edge-launcher with newer package

* Increase default timeout of async tests

* Change package type to module

* Change require/module.exports to import/export in source files

* Delete "use strict" directives from source code

* Update tests to ES modules

* Re-export $RefParser methods as standalone functions

Preserve backwards compatibility

* Make karma config file a .cjs file

Fixes “require() of ES Module …/config.js not supported” error

* Avoid top-level await in path.js

The current configuration of karma uses Webpack 4, which can't parse
modules with top-level await.

* Revert back to __dirname for browser tests

Karma configuration needs to upgrade to Webpack 5 in order to use import.meta.url

* Fix lint issues

* Disable code coverage in CI for now

* Revert "Disable code coverage in CI for now"

This reverts commit f571f0a.

* Replace nyc with c8 to work with ES modules

* Implement a dual CommonJS/ES module package.json

* Hack to allow $RefParser to be imported from require() without .default property

Without this hack, you would have to do this:

const $RefParser = require("@apidevtools/json-schema-ref-parser).default;

Now you can do this:

const $RefParser = require("@apidevtools/json-schema-ref-parser);

Author: jcmosc

.c8rc.json

@@ -0,0 +1,4 @@
+{
+  "extension": [".js", ".cjs", ".mjs", ".ts"],
+  "reporter": ["text", "lcov"]
+}

.eslintrc.yml

@@ -9,3 +9,5 @@ env:
   browser: true
 rules:
   "@typescript-eslint/no-explicit-any": ["off"]
+parserOptions:
+  sourceType: module

.mocharc.yml

@@ -7,4 +7,5 @@ spec: test/specs/**/*.spec.js
 bail: true
 recursive: true
 async-only: true
+timeout: "5000"
 require: ./test/fixtures/polyfill.js

.nycrc.yml

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json.schemastore.org/swcrc",
+  "jsc": {
+    "parser": {
+      "syntax": "ecmascript",
+      "exportDefaultFrom": true
+    }
+  },
+  "module": {
+    "type": "commonjs",
+
+    // These are defaults.
+    "strict": false,
+    "strictMode": true,
+    "lazy": false,
+    "noInterop": false
+  }
+}

.swcrc

@@ -45,6 +45,11 @@ module.exports = (karma) => {
     }
   });
 
+  config.files.push({
+    pattern: "test/**/*.js",
+    type: "module"
+  });
+
   if (config.logLevel !== karma.LOG_DISABLE) {
     console.debug("Karma Config:\n", nodeUtil.inspect(config, {
       depth: 10,

karma.conf.js renamed to karma.conf.cjs

@@ -1,10 +1,8 @@
-"use strict";
+import $Ref from "./ref.js";
+import Pointer from "./pointer.js";
+import * as url from "./util/url.js";
 
-const $Ref = require("./ref");
-const Pointer = require("./pointer");
-const url = require("./util/url");
-
-module.exports = bundle;
+export default bundle;
 
 /**
  * Bundles all external JSON references into the main JSON schema, thus resulting in a schema that

lib/bundle.js

@@ -1,11 +1,9 @@
-"use strict";
+import $Ref from "./ref.js";
+import Pointer from "./pointer.js";
+import { ono } from "@jsdevtools/ono";
+import * as url from "./util/url.js";
 
-const $Ref = require("./ref");
-const Pointer = require("./pointer");
-const { ono } = require("@jsdevtools/ono");
-const url = require("./util/url");
-
-module.exports = dereference;
+export default dereference;
 
 /**
  * Crawls the JSON schema, finds all JSON references, and dereferences them.

lib/dereference.js

@@ -1,26 +1,23 @@
 /* eslint-disable no-unused-vars */
-"use strict";
+import $Refs from "./refs.js";
+import _parse from "./parse.js";
+import normalizeArgs from "./normalize-args.js";
+import resolveExternal from "./resolve-external.js";
+import _bundle from "./bundle.js";
+import _dereference from "./dereference.js";
+import * as url from "./util/url.js";
+import { JSONParserError, InvalidPointerError, MissingPointerError, ResolverError, ParserError, UnmatchedParserError, UnmatchedResolverError, isHandledError, JSONParserErrorGroup } from "./util/errors.js";
+import maybe from "call-me-maybe";
+import { ono } from "@jsdevtools/ono";
 
-const $Refs = require("./refs");
-const _parse = require("./parse");
-const normalizeArgs = require("./normalize-args");
-const resolveExternal = require("./resolve-external");
-const _bundle = require("./bundle");
-const _dereference = require("./dereference");
-const url = require("./util/url");
-const { JSONParserError, InvalidPointerError, MissingPointerError, ResolverError, ParserError, UnmatchedParserError, UnmatchedResolverError, isHandledError, JSONParserErrorGroup } = require("./util/errors");
-const maybe = require("call-me-maybe");
-const { ono } = require("@jsdevtools/ono");
-
-module.exports = $RefParser;
-module.exports.default = $RefParser;
-module.exports.JSONParserError = JSONParserError;
-module.exports.InvalidPointerError = InvalidPointerError;
-module.exports.MissingPointerError = MissingPointerError;
-module.exports.ResolverError = ResolverError;
-module.exports.ParserError = ParserError;
-module.exports.UnmatchedParserError = UnmatchedParserError;
-module.exports.UnmatchedResolverError = UnmatchedResolverError;
+export default $RefParser;
+export { JSONParserError };
+export { InvalidPointerError };
+export { MissingPointerError };
+export { ResolverError };
+export { ParserError };
+export { UnmatchedParserError };
+export { UnmatchedResolverError };
 
 /**
  * This class parses a JSON schema, builds a map of its JSON references and their resolved values,
@@ -281,3 +278,13 @@ function finalize (parser) {
     throw new JSONParserErrorGroup(parser);
   }
 }
+
+export const parse = $RefParser.parse.bind($RefParser);
+export const resolve = $RefParser.resolve.bind($RefParser);
+export const bundle = $RefParser.bundle.bind($RefParser);
+export const dereference = $RefParser.dereference.bind($RefParser);
+
+// CommonJS default export hack
+if (typeof module === "object" && typeof module.exports === "object") {
+  module.exports = Object.assign(module.exports.default, module.exports);
+}

lib/index.js

@@ -1,8 +1,6 @@
-"use strict";
+import Options from "./options.js";
 
-const Options = require("./options");
-
-module.exports = normalizeArgs;
+export default normalizeArgs;
 
 /**
  * Normalizes the given arguments, accounting for optional args.