feat(errors): ERR_UNSUPPORTED_RESOLVE_REQUEST

Signed-off-by: Lexus Drumgold <[email protected]>

Author: unicornware

README.md

@@ -168,6 +168,7 @@ This package exports the following identifiers:
   - `ERR_UNKNOWN_MODULE_FORMAT`
   - `ERR_UNSUPPORTED_DIR_IMPORT`
   - `ERR_UNSUPPORTED_ESM_URL_SCHEME`
+  - `ERR_UNSUPPORTED_RESOLVE_REQUEST`
 - [`formatList`](#formatlistlist-type)
 - [`hideStackFrames`](#hidestackframesfn)
 - [`isNodeError`](#isnodeerrorvalue)

src/__snapshots__/errors.integration.snap

@@ -49,3 +49,5 @@ exports[`integration:errors > ERR_UNKNOWN_MODULE_FORMAT > #toString > should ret
 exports[`integration:errors > ERR_UNSUPPORTED_DIR_IMPORT > #toString > should return string representation of error 1`] = `Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '../errors' is not supported resolving ES modules imported from file://\${process.cwd()}/src/__tests__/errors.integration.spec.ts`;
 
 exports[`integration:errors > ERR_UNSUPPORTED_ESM_URL_SCHEME > #toString > should return string representation of error 1`] = `Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: data, file, and node are supported by the default ESM loader. Received protocol 'https:'`;
+
+exports[`integration:errors > ERR_UNSUPPORTED_RESOLVE_REQUEST > #toString > should return string representation of error 1`] = `TypeError [ERR_UNSUPPORTED_RESOLVE_REQUEST]: Failed to resolve module specifier "not-found" from "data:text/javascript,export default import.meta.resolve('not-found')": Invalid relative URL or base scheme is not hierarchical.`;

src/__snapshots__/index.e2e.snap

@@ -30,6 +30,7 @@ exports[`e2e:errnode > should expose public api 1`] = `
   "ERR_UNKNOWN_MODULE_FORMAT",
   "ERR_UNSUPPORTED_DIR_IMPORT",
   "ERR_UNSUPPORTED_ESM_URL_SCHEME",
+  "ERR_UNSUPPORTED_RESOLVE_REQUEST",
   "errors",
   "determineSpecificType",
   "formatList",

src/__tests__/errors.integration.spec.ts

@@ -106,6 +106,12 @@ describe('integration:errors', () => {
       Error,
       new URL('unist-util-visit', 'https://esm.sh/@flex-development/'),
       ['data', 'file', 'node']
+    ],
+    [
+      codes.ERR_UNSUPPORTED_RESOLVE_REQUEST,
+      TypeError,
+      'not-found',
+      'data:text/javascript,export default import.meta.resolve(\'not-found\')'
     ]
   ])('%s', (code, Base, ...args) => {
     let subject: NodeError

src/errors/__tests__/err-unsupported-resolve-request.spec-d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file Type Tests - ERR_UNSUPPORTED_RESOLVE_REQUEST
+ * @module errnode/errors/tests/unit-d/ERR_UNSUPPORTED_RESOLVE_REQUEST
+ */
+
+import { codes } from '#src/enums'
+import type { NodeError, NodeErrorConstructor } from '#src/interfaces'
+import type * as TestSubject from '../err-unsupported-resolve-request'
+
+describe('unit-d:errors/ERR_UNSUPPORTED_RESOLVE_REQUEST', () => {
+  describe('ERR_UNSUPPORTED_RESOLVE_REQUEST', () => {
+    it('should be ErrUnsupportedResolveRequestConstructor', () => {
+      expectTypeOf<typeof TestSubject.default>()
+        .toEqualTypeOf<TestSubject.ErrUnsupportedResolveRequestConstructor>()
+    })
+  })
+
+  describe('ErrUnsupportedResolveRequest', () => {
+    it('should extend NodeError<codes.ERR_UNSUPPORTED_RESOLVE_REQUEST>', () => {
+      expectTypeOf<TestSubject.ErrUnsupportedResolveRequest>()
+        .toMatchTypeOf<NodeError<codes.ERR_UNSUPPORTED_RESOLVE_REQUEST>>()
+    })
+
+    it('should extend TypeError', () => {
+      expectTypeOf<TestSubject.ErrUnsupportedResolveRequest>()
+        .toMatchTypeOf<TypeError>()
+    })
+  })
+
+  describe('ErrUnsupportedResolveRequestConstructor', () => {
+    it('should match NodeErrorConstructor', () => {
+      // Arrange
+      type T = TestSubject.ErrUnsupportedResolveRequest
+      type Args = TestSubject.ErrUnsupportedResolveRequestArgs
+
+      // Expect
+      expectTypeOf<TestSubject.ErrUnsupportedResolveRequestConstructor>()
+        .toMatchTypeOf<NodeErrorConstructor<T, Args>>()
+    })
+  })
+})

src/errors/err-unsupported-resolve-request.ts

@@ -0,0 +1,84 @@
+/**
+ * @file Errors - ERR_UNSUPPORTED_RESOLVE_REQUEST
+ * @module errnode/errors/ERR_UNSUPPORTED_RESOLVE_REQUEST
+ * @see https://github.com/nodejs/node/blob/v22.7.0/lib/internal/errors.js#L1839-L1841
+ */
+
+import E from '#e'
+import { codes } from '#src/enums'
+import type { NodeError, NodeErrorConstructor } from '#src/interfaces'
+
+/**
+ * `ERR_UNSUPPORTED_RESOLVE_REQUEST` schema.
+ *
+ * @see {@linkcode NodeError}
+ * @see https://nodejs.org/api/errors.html#err_unsupported_resolve_request
+ *
+ * @extends {NodeError<codes.ERR_UNSUPPORTED_RESOLVE_REQUEST>}
+ * @extends {TypeError}
+ */
+interface ErrUnsupportedResolveRequest
+  extends NodeError<codes.ERR_UNSUPPORTED_RESOLVE_REQUEST>, TypeError {}
+
+/**
+ * `ERR_UNSUPPORTED_RESOLVE_REQUEST` message arguments.
+ */
+type Args = [specifier: string, base: URL | string]
+
+/**
+ * `ERR_UNSUPPORTED_RESOLVE_REQUEST` constructor.
+ *
+ * @see {@linkcode Args}
+ * @see {@linkcode ErrUnsupportedResolveRequest}
+ * @see {@linkcode NodeErrorConstructor}
+ *
+ * @extends {NodeErrorConstructor<ErrUnsupportedResolveRequest,Args>}
+ */
+interface ErrUnsupportedResolveRequestConstructor
+  extends NodeErrorConstructor<ErrUnsupportedResolveRequest, Args> {
+  /**
+   * Create a new `ERR_UNSUPPORTED_RESOLVE_REQUEST` error.
+   *
+   * @see {@linkcode ErrUnsupportedResolveRequest}
+   *
+   * @param {string} specifier
+   *  The module specifier that failed to resolve
+   * @param {URL | string} base
+   *  Parent module id
+   * @return {ErrUnsupportedResolveRequest}
+   */
+  new (specifier: string, base: URL | string): ErrUnsupportedResolveRequest
+}
+
+/**
+ * `ERR_UNSUPPORTED_RESOLVE_REQUEST` model.
+ *
+ * Thrown when an attempt is made to resolve an invalid module referrer. This
+ * can happen when importing or calling `import.meta.resolve()` with either:
+ * - a bare specifier that is not a builtin module from a module whose URL
+ *   scheme is not file.
+ * - a [relative URL][relative-url] from a module whose URL scheme is not a
+ *   [special scheme][special-scheme].
+ *
+ * [relative-url]: https://url.spec.whatwg.org/#relative-url-string
+ * [special-scheme]: https://url.spec.whatwg.org/#special-scheme
+ *
+ * @see {@linkcode ErrUnsupportedResolveRequestConstructor}
+ *
+ * @type {ErrUnsupportedResolveRequestConstructor}
+ *
+ * @class
+ */
+const ERR_UNSUPPORTED_RESOLVE_REQUEST: ErrUnsupportedResolveRequestConstructor =
+  E(
+    codes.ERR_UNSUPPORTED_RESOLVE_REQUEST,
+    TypeError,
+    'Failed to resolve module specifier "%s" from "%s": Invalid relative URL or base scheme is not hierarchical.'
+  )
+
+export {
+  ERR_UNSUPPORTED_RESOLVE_REQUEST as default,
+  type ErrUnsupportedResolveRequest,
+  type Args as ErrUnsupportedResolveRequestArgs,
+  type ErrUnsupportedResolveRequestConstructor
+}

src/errors/index.ts

@@ -154,3 +154,9 @@ export {
   type ErrUnsupportedEsmUrlSchemeArgs,
   type ErrUnsupportedEsmUrlSchemeConstructor
 } from './err-unsupported-esm-url-scheme'
+export {
+  default as ERR_UNSUPPORTED_RESOLVE_REQUEST,
+  type ErrUnsupportedResolveRequest,
+  type ErrUnsupportedResolveRequestArgs,
+  type ErrUnsupportedResolveRequestConstructor
+} from './err-unsupported-resolve-request'