feat(errors): ERR_INVALID_FILE_URL_HOST

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

README.md

@@ -143,6 +143,7 @@ This package exports the following identifiers:
 - [`codes`](#codes)
 - [`determineSpecificType`](#determinespecifictypevalue)
 - [`errors`](#errors)
+  - `ERR_ARG_NOT_ITERABLE`
   - `ERR_ENCODING_NOT_SUPPORTED`
   - `ERR_IMPORT_ASSERTION_TYPE_FAILED`
   - `ERR_IMPORT_ASSERTION_TYPE_MISSING`
@@ -153,6 +154,7 @@ This package exports the following identifiers:
   - `ERR_INCOMPATIBLE_OPTION_PAIR`
   - `ERR_INVALID_ARG_TYPE`
   - `ERR_INVALID_ARG_VALUE`
+  - `ERR_INVALID_FILE_URL_HOST`
   - `ERR_INVALID_MODULE_SPECIFIER`
   - `ERR_INVALID_PACKAGE_CONFIG`
   - `ERR_INVALID_PACKAGE_TARGET`

src/__snapshots__/errors.integration.snap

@@ -22,6 +22,8 @@ exports[`integration:errors > ERR_INVALID_ARG_TYPE > #toString > should return s
 
 exports[`integration:errors > ERR_INVALID_ARG_VALUE > #toString > should return string representation of error 1`] = `TypeError [ERR_INVALID_ARG_VALUE]: The argument 'address' is invalid. Received 1`;
 
+exports[`integration:errors > ERR_INVALID_FILE_URL_HOST > #toString > should return string representation of error 1`] = `TypeError [ERR_INVALID_FILE_URL_HOST]: File URL host must be "localhost" or empty on darwin`;
+
 exports[`integration:errors > ERR_INVALID_MODULE_SPECIFIER > #toString > should return string representation of error 1`] = `TypeError [ERR_INVALID_MODULE_SPECIFIER]: Invalid module '@flex-development%2Fpathe' is not a valid package name imported from \${process.cwd()}/scratch.ts`;
 
 exports[`integration:errors > ERR_INVALID_PACKAGE_CONFIG > #toString > should return string representation of error 1`] = `Error [ERR_INVALID_PACKAGE_CONFIG]: Invalid package config \${process.cwd()}/node_modules/@flex-development/pathe/package.json while importing file://\${process.cwd()}/loader.mjs. "exports" cannot contain some keys starting with '.' and some not. The exports object must either be an object of package subpath keys or an object of main entry condition name keys only.`;

src/__snapshots__/index.e2e.snap

@@ -16,6 +16,7 @@ exports[`e2e:errnode > should expose public api 1`] = `
   "ERR_INCOMPATIBLE_OPTION_PAIR",
   "ERR_INVALID_ARG_TYPE",
   "ERR_INVALID_ARG_VALUE",
+  "ERR_INVALID_FILE_URL_HOST",
   "ERR_INVALID_MODULE_SPECIFIER",
   "ERR_INVALID_PACKAGE_CONFIG",
   "ERR_INVALID_PACKAGE_TARGET",

src/__tests__/errors.integration.spec.ts

@@ -53,6 +53,7 @@ describe('integration:errors', () => {
     [codes.ERR_INCOMPATIBLE_OPTION_PAIR, TypeError, 'N', 'cost'],
     [codes.ERR_INVALID_ARG_TYPE, TypeError, 'ctor', 'Function', null],
     [codes.ERR_INVALID_ARG_VALUE, TypeError, 'address', 1],
+    [codes.ERR_INVALID_FILE_URL_HOST, TypeError, 'darwin'],
     [
       codes.ERR_INVALID_MODULE_SPECIFIER,
       TypeError,

src/errors/__tests__/err-invalid-file-url-host.spec-d.ts

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

src/errors/err-invalid-file-url-host.ts

@@ -0,0 +1,75 @@
+/**
+ * @file Errors - ERR_INVALID_FILE_URL_HOST
+ * @module errnode/errors/ERR_INVALID_FILE_URL_HOST
+ * @see https://github.com/nodejs/node/blob/v22.8.0/lib/internal/errors.js#L1470-L1471
+ */
+
+import E from '#e'
+import { codes } from '#src/enums'
+import type { NodeError, NodeErrorConstructor } from '#src/interfaces'
+
+/**
+ * `ERR_INVALID_FILE_URL_HOST` schema.
+ *
+ * @see {@linkcode NodeError}
+ * @see https://nodejs.org/api/errors.html#err_invalid_file_url_host
+ *
+ * @extends {NodeError<codes.ERR_INVALID_FILE_URL_HOST>}
+ * @extends {TypeError}
+ */
+interface ErrInvalidFileUrlHost
+  extends NodeError<codes.ERR_INVALID_FILE_URL_HOST>, TypeError {}
+
+/**
+ * `ERR_INVALID_FILE_URL_HOST` message arguments.
+ */
+type Args = [platform: string]
+
+/**
+ * `ERR_INVALID_FILE_URL_HOST` constructor.
+ *
+ * @see {@linkcode ErrInvalidFileUrlHost}
+ * @see {@linkcode NodeErrorConstructor}
+ *
+ * @extends {NodeErrorConstructor<ErrInvalidFileUrlHost,Args>}
+ */
+interface ErrInvalidFileUrlHostConstructor
+  extends NodeErrorConstructor<ErrInvalidFileUrlHost, Args> {
+  /**
+   * Create a new `ERR_INVALID_FILE_URL_HOST` error.
+   *
+   * @see {@linkcode ErrInvalidFileUrlHost}
+   *
+   * @param {string} platform
+   *  Platform invalid host was encountered on
+   * @return {ErrInvalidFileUrlHost}
+   */
+  new (platform: string): ErrInvalidFileUrlHost
+}
+
+/**
+ * `ERR_INVALID_FILE_URL_HOST` model.
+ *
+ * Thrown when a Node.js API that consumes `file:` URLs encountered a file URL
+ * with an incompatible host.
+ * This situation can only occur on Unix-like systems where only `localhost` or
+ * an empty host is supported.
+ *
+ * @see {@linkcode ErrInvalidFileUrlHostConstructor}
+ *
+ * @type {ErrInvalidFileUrlHostConstructor}
+ *
+ * @class
+ */
+const ERR_INVALID_FILE_URL_HOST: ErrInvalidFileUrlHostConstructor = E(
+  codes.ERR_INVALID_FILE_URL_HOST,
+  TypeError,
+  'File URL host must be "localhost" or empty on %s'
+)
+
+export {
+  ERR_INVALID_FILE_URL_HOST as default,
+  type ErrInvalidFileUrlHost,
+  type Args as ErrInvalidFileUrlHostArgs,
+  type ErrInvalidFileUrlHostConstructor
+}

src/errors/index.ts

@@ -70,6 +70,12 @@ export {
   type ErrInvalidArgValueArgs,
   type ErrInvalidArgValueConstructor
 } from './err-invalid-arg-value'
+export {
+  default as ERR_INVALID_FILE_URL_HOST,
+  type ErrInvalidFileUrlHost,
+  type ErrInvalidFileUrlHostArgs,
+  type ErrInvalidFileUrlHostConstructor
+} from './err-invalid-file-url-host'
 export {
   default as ERR_INVALID_MODULE_SPECIFIER,
   type ErrInvalidModuleSpecifier,