feat(errors): ERR_NO_CRYPTO

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

Author: unicornware

README.md

@@ -168,6 +168,7 @@ This package exports the following identifiers:
   - `ERR_MISSING_OPTION`
   - `ERR_MODULE_NOT_FOUND`
   - `ERR_NETWORK_IMPORT_DISALLOWED`
+  - `ERR_NO_CRYPTO`
   - `ERR_OPERATION_FAILED`
   - `ERR_PACKAGE_IMPORT_NOT_DEFINED`
   - `ERR_PACKAGE_PATH_NOT_EXPORTED`

src/__snapshots__/errors.integration.snap

@@ -50,6 +50,8 @@ exports[`integration:errors > ERR_MODULE_NOT_FOUND > #toString > should return s
 
 exports[`integration:errors > ERR_NETWORK_IMPORT_DISALLOWED > #toString > should return string representation of error 1`] = `Error [ERR_NETWORK_IMPORT_DISALLOWED]: import of 'https://esm.sh/@flex-development/unist-util-builder' by file://\${process.cwd()}/src/__tests__/errors.integration.spec.ts is not supported: ES modules cannot be loaded by require() from the network`;
 
+exports[`integration:errors > ERR_NO_CRYPTO > #toString > should return string representation of error 1`] = `Error [ERR_NO_CRYPTO]: Node.js is not compiled with OpenSSL crypto support`;
+
 exports[`integration:errors > ERR_OPERATION_FAILED > #toString > should return string representation of error 1`] = `Error [ERR_OPERATION_FAILED]: Operation failed: Out of memory`;
 
 exports[`integration:errors > ERR_PACKAGE_IMPORT_NOT_DEFINED > #toString > should return string representation of error 1`] = `TypeError [ERR_PACKAGE_IMPORT_NOT_DEFINED]: Package import specifier '#src' is not defined in package \${process.cwd()}/package.json imported from file://\${process.cwd()}/src/__tests__/errors.integration.spec.ts`;

src/__snapshots__/index.e2e.snap

@@ -30,6 +30,7 @@ exports[`e2e:errnode > should expose public api 1`] = `
   "ERR_MISSING_OPTION",
   "ERR_MODULE_NOT_FOUND",
   "ERR_NETWORK_IMPORT_DISALLOWED",
+  "ERR_NO_CRYPTO",
   "ERR_OPERATION_FAILED",
   "ERR_PACKAGE_IMPORT_NOT_DEFINED",
   "ERR_PACKAGE_PATH_NOT_EXPORTED",

src/__tests__/errors.integration.spec.ts

@@ -103,6 +103,7 @@ describe('integration:errors', () => {
       import.meta.url,
       'ES modules cannot be loaded by require() from the network'
     ],
+    [codes.ERR_NO_CRYPTO, Error],
     [codes.ERR_OPERATION_FAILED, Error, 'Out of memory'],
     [
       codes.ERR_PACKAGE_IMPORT_NOT_DEFINED,

src/errors/__tests__/err-no-crypto.spec-d.ts

@@ -0,0 +1,36 @@
+/**
+ * @file Type Tests - ERR_NO_CRYPTO
+ * @module errnode/errors/tests/unit-d/ERR_NO_CRYPTO
+ */
+
+import { codes } from '#src/enums'
+import type { NodeError, NodeErrorConstructor } from '#src/interfaces'
+import type * as TestSubject from '../err-no-crypto'
+
+describe('unit-d:errors/ERR_NO_CRYPTO', () => {
+  describe('ERR_NO_CRYPTO', () => {
+    it('should be ErrNoCryptoConstructor', () => {
+      expectTypeOf<typeof TestSubject.default>()
+        .toEqualTypeOf<TestSubject.ErrNoCryptoConstructor>()
+    })
+  })
+
+  describe('ErrNoCrypto', () => {
+    it('should extend NodeError<codes.ERR_NO_CRYPTO>', () => {
+      expectTypeOf<TestSubject.ErrNoCrypto>()
+        .toMatchTypeOf<NodeError<codes.ERR_NO_CRYPTO>>()
+    })
+  })
+
+  describe('ErrNoCryptoConstructor', () => {
+    it('should match NodeErrorConstructor', () => {
+      // Arrange
+      type T = TestSubject.ErrNoCrypto
+      type Args = TestSubject.ErrNoCryptoArgs
+
+      // Expect
+      expectTypeOf<TestSubject.ErrNoCryptoConstructor>()
+        .toMatchTypeOf<NodeErrorConstructor<T, Args>>()
+    })
+  })
+})

src/errors/err-no-crypto.ts

@@ -0,0 +1,69 @@
+/**
+ * @file Errors - ERR_NO_CRYPTO
+ * @module errnode/errors/ERR_NO_CRYPTO
+ * @see https://github.com/nodejs/node/blob/v22.8.0/lib/internal/errors.js#L1603-L1604
+ */
+
+import E from '#e'
+import { codes } from '#src/enums'
+import type { NodeError, NodeErrorConstructor } from '#src/interfaces'
+
+/**
+ * `ERR_NO_CRYPTO` schema.
+ *
+ * @see {@linkcode NodeError}
+ * @see https://nodejs.org/api/errors.html#err_no_crypto
+ *
+ * @extends {NodeError<codes.ERR_NO_CRYPTO>}
+ */
+interface ErrNoCrypto extends NodeError<codes.ERR_NO_CRYPTO> {}
+
+/**
+ * `ERR_NO_CRYPTO` message arguments.
+ */
+type Args = []
+
+/**
+ * `ERR_NO_CRYPTO` constructor.
+ *
+ * @see {@linkcode ErrNoCrypto}
+ * @see {@linkcode NodeErrorConstructor}
+ *
+ * @extends {NodeErrorConstructor<ErrNoCrypto,Args>}
+ */
+interface ErrNoCryptoConstructor
+  extends NodeErrorConstructor<ErrNoCrypto, Args> {
+  /**
+   * Create a new `ERR_NO_CRYPTO` error.
+   *
+   * @see {@linkcode ErrNoCrypto}
+   *
+   * @return {ErrNoCrypto}
+   */
+  new (): ErrNoCrypto
+}
+
+/**
+ * `ERR_NO_CRYPTO` model.
+ *
+ * Thrown when an attempt was made to use crypto features while Node.js was not
+ * compiled with OpenSSL crypto support.
+ *
+ * @see {@linkcode ErrNoCryptoConstructor}
+ *
+ * @type {ErrNoCryptoConstructor}
+ *
+ * @class
+ */
+const ERR_NO_CRYPTO: ErrNoCryptoConstructor = E(
+  codes.ERR_NO_CRYPTO,
+  Error,
+  'Node.js is not compiled with OpenSSL crypto support'
+)
+
+export {
+  ERR_NO_CRYPTO as default,
+  type ErrNoCrypto,
+  type Args as ErrNoCryptoArgs,
+  type ErrNoCryptoConstructor
+}

src/errors/index.ts

@@ -154,6 +154,12 @@ export {
   type ErrNetworkImportDisallowedArgs,
   type ErrNetworkImportDisallowedConstructor
 } from './err-network-import-disallowed'
+export {
+  default as ERR_NO_CRYPTO,
+  type ErrNoCrypto,
+  type ErrNoCryptoArgs,
+  type ErrNoCryptoConstructor
+} from './err-no-crypto'
 export {
   default as ERR_OPERATION_FAILED,
   type ErrOperationFailed,