feat(models): ERR_MODULE_NOT_FOUND

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

Author: unicornware

src/models/__tests__/err-module-not-found.spec.ts

@@ -0,0 +1,42 @@
+/**
+ * @file Unit Tests - ERR_MODULE_NOT_FOUND
+ * @module errnode/models/tests/unit/ERR_MODULE_NOT_FOUND
+ */
+
+import { ErrorCode } from '#src/enums'
+import TestSubject from '../err-module-not-found'
+
+describe('unit:models/ERR_MODULE_NOT_FOUND', () => {
+  let base: string
+  let id: string
+
+  beforeEach(() => {
+    base = import.meta.url
+    id = 'target'
+  })
+
+  it('should return Error instance', () => {
+    expect(new TestSubject(id, base)).to.be.instanceof(Error)
+  })
+
+  it('should set error code', () => {
+    expect(new TestSubject(id, base))
+      .to.have.property('code')
+      .equal(ErrorCode.ERR_MODULE_NOT_FOUND)
+  })
+
+  it('should set error message', () => {
+    // Arrange
+    const cases: ConstructorParameters<typeof TestSubject>[] = [
+      [id, base],
+      [id, base, 'module']
+    ]
+
+    // Act + Expect
+    cases.forEach(([id, base, type]) => {
+      expect(new TestSubject(id, base, type))
+        .to.have.property('message')
+        .equal(`Cannot find ${type ?? 'package'} '${id}' imported from ${base}`)
+    })
+  })
+})

src/models/err-module-not-found.ts

@@ -0,0 +1,47 @@
+/**
+ * @file Error Models - ERR_MODULE_NOT_FOUND
+ * @module errnode/models/ERR_MODULE_NOT_FOUND
+ * @see https://github.com/nodejs/node/blob/v19.3.0/lib/internal/errors.js#L1470-L1472
+ */
+
+import { ErrorCode } from '#src/enums'
+import type { MessageFn, NodeError, NodeErrorConstructor } from '#src/types'
+import { createNodeError } from '#src/utils'
+
+/**
+ * `ERR_MODULE_NOT_FOUND` model.
+ *
+ * Thrown when a module file cannot be resolved by the ECMAScript modules loader
+ * while attempting an `import` operation or when loading a program entry point.
+ *
+ * @see https://nodejs.org/api/errors.html#err_module_not_found
+ *
+ * @class
+ *
+ * @param {string} id - Id of missing module
+ * @param {string} base - Id of module `id` was imported from
+ * @param {string?} [type='package'] - Module file type
+ * @return {NodeError} `Error` instance
+ */
+const ERR_MODULE_NOT_FOUND: NodeErrorConstructor<
+  ErrorConstructor,
+  MessageFn<[string, string, string?]>
+> = createNodeError(
+  ErrorCode.ERR_MODULE_NOT_FOUND,
+  Error,
+  /**
+   * Creates an [`ERR_MODULE_NOT_FOUND`][1] message.
+   *
+   * [1]: https://nodejs.org/api/errors.html#err_module_not_found
+   *
+   * @param {string} id - Id of missing module
+   * @param {string} base - Id of module `id` was imported from
+   * @param {string?} [type='package'] - Module file type
+   * @return {string} Error message
+   */
+  (id: string, base: string, type: string = 'package'): string => {
+    return `Cannot find ${type} '${id}' imported from ${base}`
+  }
+)
+
+export default ERR_MODULE_NOT_FOUND

src/models/index.ts

@@ -15,6 +15,7 @@ export { default as ERR_INCOMPATIBLE_OPTION_PAIR } from './err-incompatible-opti
 export { default as ERR_INVALID_MODULE_SPECIFIER } from './err-invalid-module-specifier'
 export { default as ERR_METHOD_NOT_IMPLEMENTED } from './err-method-not-implemented'
 export { default as ERR_MISSING_OPTION } from './err-missing-option'
+export { default as ERR_MODULE_NOT_FOUND } from './err-module-not-found'
 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_UNHANDLED_ERROR } from './err-unhandled-error'