From aeed292379928c7c2e6c2876dc0c98fa64b82ec8 Mon Sep 17 00:00:00 2001
From: Lexus Drumgold <unicornware@flexdevelopment.llc>
Date: Fri, 30 Dec 2022 23:37:50 -0500
Subject: [PATCH] feat(models): `ERR_UNKNOWN_FILE_EXTENSION`

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>
---
 .../err-unknown-file-extension.spec.ts        | 52 +++++++++++++++++
 src/models/err-unknown-file-extension.ts      | 57 +++++++++++++++++++
 src/models/index.ts                           |  1 +
 3 files changed, 110 insertions(+)
 create mode 100644 src/models/__tests__/err-unknown-file-extension.spec.ts
 create mode 100644 src/models/err-unknown-file-extension.ts

diff --git a/src/models/__tests__/err-unknown-file-extension.spec.ts b/src/models/__tests__/err-unknown-file-extension.spec.ts
new file mode 100644
index 00000000..bc91603d
--- /dev/null
+++ b/src/models/__tests__/err-unknown-file-extension.spec.ts
@@ -0,0 +1,52 @@
+/**
+ * @file Unit Tests - ERR_UNKNOWN_FILE_EXTENSION
+ * @module errnode/models/tests/unit/ERR_UNKNOWN_FILE_EXTENSION
+ */
+
+import { ErrorCode } from '#src/enums'
+import path from 'node:path'
+import TestSubject from '../err-unknown-file-extension'
+
+describe('unit:models/ERR_UNKNOWN_FILE_EXTENSION', () => {
+  let ext: string
+  let id: string
+  let message: string
+  let suggestion: string
+
+  beforeEach(() => {
+    id = import.meta.url
+    ext = path.extname(id)
+    message = `Unknown file extension '${ext}' for ${id}`
+    suggestion = 'Use a custom loader'
+  })
+
+  it('should return TypeError instance', () => {
+    // Act
+    const result = new TestSubject(ext, id)
+
+    // Expect
+    expect(result).to.have.property('name').equal('TypeError')
+    expect(result).to.be.instanceof(TypeError)
+  })
+
+  it('should set error code', () => {
+    expect(new TestSubject(ext, id))
+      .to.have.property('code')
+      .equal(ErrorCode.ERR_UNKNOWN_FILE_EXTENSION)
+  })
+
+  it('should set error message', () => {
+    // Arrange
+    const cases: [...ConstructorParameters<typeof TestSubject>, string][] = [
+      [ext, id, undefined, message],
+      [ext, id, suggestion, `${message}. ${suggestion}`]
+    ]
+
+    // Act + Expect
+    cases.forEach(([ext, id, suggestion, expected]) => {
+      expect(new TestSubject(ext, id, suggestion))
+        .to.have.property('message')
+        .equal(expected)
+    })
+  })
+})
diff --git a/src/models/err-unknown-file-extension.ts b/src/models/err-unknown-file-extension.ts
new file mode 100644
index 00000000..54fcb093
--- /dev/null
+++ b/src/models/err-unknown-file-extension.ts
@@ -0,0 +1,57 @@
+/**
+ * @file Error Models - ERR_UNKNOWN_FILE_EXTENSION
+ * @module errnode/models/ERR_UNKNOWN_FILE_EXTENSION
+ * @see https://github.com/nodejs/node/blob/v19.3.0/lib/internal/errors.js#L1686-L1692
+ */
+
+import { ErrorCode } from '#src/enums'
+import type { MessageFn, NodeError, NodeErrorConstructor } from '#src/types'
+import { createNodeError } from '#src/utils'
+
+/**
+ * `ERR_UNKNOWN_FILE_EXTENSION` model.
+ *
+ * Thrown when an attempt is made to load a module with an unknown or
+ * unsupported file extension.
+ *
+ * @see https://nodejs.org/api/errors.html#err_unknown_file_extension
+ *
+ * @class
+ *
+ * @param {string} ext - Unknown or unsupported file extension
+ * @param {string} id - Id of module containing `ext`
+ * @param {string?} [suggestion=''] - Recommended fix
+ * @return {NodeError<TypeError>} `TypeError` instance
+ */
+const ERR_UNKNOWN_FILE_EXTENSION: NodeErrorConstructor<
+  TypeErrorConstructor,
+  MessageFn<[string, string, string?]>
+> = createNodeError(
+  ErrorCode.ERR_UNKNOWN_FILE_EXTENSION,
+  TypeError,
+  /**
+   * Creates an [`ERR_UNKNOWN_FILE_EXTENSION`][1] message.
+   *
+   * [1]: https://nodejs.org/api/errors.html#err_unknown_file_extension
+   *
+   * @param {string} ext - Unknown or unsupported file extension
+   * @param {string} id - Id of module containing `ext`
+   * @param {string?} [suggestion=''] - Recommended fix
+   * @return {string} Error message
+   */
+  (ext: string, id: string, suggestion: string = ''): string => {
+    /**
+     * Error message.
+     *
+     * @var {string} message
+     */
+    let message: string = `Unknown file extension '${ext}' for ${id}`
+
+    // add recommended fix
+    if (suggestion) message += `. ${suggestion}`
+
+    return message
+  }
+)
+
+export default ERR_UNKNOWN_FILE_EXTENSION
diff --git a/src/models/index.ts b/src/models/index.ts
index 59b31823..1d92e5ef 100644
--- a/src/models/index.ts
+++ b/src/models/index.ts
@@ -17,5 +17,6 @@ export { default as ERR_MISSING_OPTION } from './err-missing-option'
 export { default as ERR_NETWORK_IMPORT_DISALLOWED } from './err-network-import-disallowed'
 export { default as ERR_OPERATION_FAILED } from './err-operation-failed'
 export { default as ERR_UNKNOWN_ENCODING } from './err-unknown-encoding'
+export { default as ERR_UNKNOWN_FILE_EXTENSION } from './err-unknown-file-extension'
 export { default as ERR_UNKNOWN_MODULE_FORMAT } from './err-unknown-module-format'
 export { default as ERR_UNSUPPORTED_DIR_IMPORT } from './err-unsupported-dir-import'