@alwatr/crypto 4.2.1 → 4.3.0

package/CHANGELOG.md

@@ -3,6 +3,39 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [4.3.0](https://github.com/Alwatr/nanotron/compare/v4.2.2...v4.3.0) (2024-10-11)
+
+### Features
+
+* update `import`s & packages based on the latest changes of `nanolib` & prevent `sideeffects` from `build` result ([1d234b8](https://github.com/Alwatr/nanotron/commit/1d234b83152fb246b793476898e9cf026aa52874)) by @mohammadhonarvar
+
+### Bug Fixes
+
+* **crypto:** update types & `logger` & use `packageTracer` based on last changes of `nanolib` ([cf1a480](https://github.com/Alwatr/nanotron/commit/cf1a48071fe745226f6aed2afdf11038da5065e2)) by @mohammadhonarvar
+
+### Code Refactoring
+
+* update `import`s & packages based on the latest changes of `nanolib` ([7652b5d](https://github.com/Alwatr/nanotron/commit/7652b5d9cc69218f2ff28bda3d0d8f52f147c6f6)) by @mohammadhonarvar
+
+### Miscellaneous Chores
+
+* edited README ([d707d38](https://github.com/Alwatr/nanotron/commit/d707d389e085dd320402521cb23af5805013d777)) by @ArmanAsadian
+
+### Dependencies update
+
+* update ([834ffcc](https://github.com/Alwatr/nanotron/commit/834ffcc8f6de96cc11a1a6fa933f948b7813cde6)) by @mohammadhonarvar
+
+## [4.2.2](https://github.com/Alwatr/nanotron/compare/v4.2.1...v4.2.2) (2024-09-29)
+
+### Miscellaneous Chores
+
+* **crypto:** change the license to AGPL-3.0 ([a37fb50](https://github.com/Alwatr/nanotron/commit/a37fb50898bb0bc909746f44bc34d14bcf255a61)) by @ArmanAsadian
+
+### Dependencies update
+
+* bump @types/node in the development-dependencies group ([9c8d7d5](https://github.com/Alwatr/nanotron/commit/9c8d7d518d9a5da2ea57ac2b210a8697267e6d3d)) by @dependabot[bot]
+* update ([1c4ef63](https://github.com/Alwatr/nanotron/commit/1c4ef635fc969d4abd416aea2b954de674748da8)) by @AliMD
+
 ## [4.2.1](https://github.com/Alwatr/nanotron/compare/v4.2.0...v4.2.1) (2024-09-24)
 
 ### Dependencies update

package/README.md

@@ -18,3 +18,17 @@ A robust generator of secure authentication HOTP tokens, employing the HMAC-base
 - [HMAC Generator/Tester Tool](https://www.freeformatter.com/hmac-generator.html). FreeFormatter.
 - [How API Request Signing Works (And How to Implement HMAC in NodeJS)](https://blog.andrewhoang.me/how-api-request-signing-works-and-how-to-implement-it-in-nodejs-2/). (2016). Andrew Hoang.
 - [Implement HMAC Authentication](https://support.google.com/admanager/answer/7637490?hl=en). Google Ad Manager Help.
+
+## Sponsors
+
+The following companies, organizations, and individuals support Nanotron ongoing maintenance and development. Become a Sponsor to get your logo on our README and website.
+
+[![Exir Studio](https://avatars.githubusercontent.com/u/181194967?s=200&v=4)](https://exirstudio.com)
+
+### Contributing
+
+Contributions are welcome! Please read our [contribution guidelines](https://github.com/Alwatr/.github/blob/next/CONTRIBUTING.md) before submitting a pull request.
+
+### License
+
+This project is licensed under the [AGPL-3.0 License](LICENSE).

package/dist/api.d.ts

@@ -1,6 +1,6 @@
+import { type Duration } from '@alwatr/nanolib';
 import { AlwatrHashGenerator } from './hash.js';
 import { AlwatrTokenGenerator, type TokenValidity } from './token.js';
-import type { DurationString } from '@alwatr/parse-duration';
 /**
  * Configuration options for the CryptoFactory.
  */
@@ -12,7 +12,7 @@ export interface CryptoFactoryConfig {
     /**
      * The duration for which the token is valid.
      */
-    duration: DurationString | 'infinite';
+    duration: Duration | 'infinite';
 }
 /**
  * Crypto factory for generating self-validate user-id, user-token, secret, device-id.

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,WAAW,CAAC;AAO9C,OAAO,EAAC,oBAAoB,EAAE,KAAK,aAAa,EAAC,MAAM,YAAY,CAAC;AAEpE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,cAAc,GAAG,UAAU,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,SAAS,CAAC,WAAW;;;;;MAAC;IAEtB;;;OAGG;gBACS,MAAM,EAAE,mBAAmB;IAYvC;;;;;;;;;;OAUG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;;;OAQG;IACH,aAAa,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIxD;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAI5E;;;;;;;;;;OAUG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;;OAOG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAC,mBAAmB,EAAC,MAAM,WAAW,CAAC;AAO9C,OAAO,EAAC,oBAAoB,EAAE,KAAK,aAAa,EAAC,MAAM,YAAY,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,SAAS,CAAC,WAAW;;;;;MAAC;IAEtB;;;OAGG;gBACS,MAAM,EAAE,mBAAmB;IAYvC;;;;;;;;;;OAUG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;;;OAQG;IACH,aAAa,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIxD;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAI5E;;;;;;;;;;OAUG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;;;OAOG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C"}

package/dist/main.cjs

@@ -1,3 +1,361 @@
-/* @alwatr/crypto v4.2.1 */
-"use strict";var c=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var x=(t,e)=>{for(var r in e)c(t,r,{get:e[r],enumerable:!0})},v=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of C(e))!_.call(t,o)&&o!==r&&c(t,o,{get:()=>e[o],enumerable:!(n=y(e,o))||n.enumerable});return t};var k=t=>v(c({},"__esModule",{value:!0}),t);var G={};x(G,{AlwatrCryptoFactory:()=>m,AlwatrHashGenerator:()=>i,AlwatrTokenGenerator:()=>s,deviceIdGeneratorRecommendedConfig:()=>d,secretGeneratorRecommendedConfig:()=>f,userIdGeneratorRecommendedConfig:()=>g,userTokenGeneratorRecommendedConfig:()=>p});module.exports=k(G);var a=require("node:crypto"),i=class{constructor(e){this.config=e}generateRandom(){return this.generate((0,a.randomBytes)(16))}generateRandomSelfValidate(){return this.generateSelfValidate((0,a.randomBytes)(16))}generate(e){return this.config.prefix+(0,a.createHash)(this.config.algorithm).update(e).digest(this.config.encoding)}generateCrc(e){let r=(0,a.createHash)("sha1").update(e).digest(this.config.encoding);return this.config.crcLength==null||this.config.crcLength<1?r:r.slice(0,this.config.crcLength)}generateSelfValidate(e){let r=this.generate(e),n=this.generateCrc(r);return r+n}verify(e,r){return r===this.generate(e)}verifySelfValidate(e){let r=e.length-this.config.crcLength,n=e.slice(0,r);return e.slice(r)===this.generateCrc(n)}};var h=require("node:crypto"),u=require("@alwatr/parse-duration"),s=class{constructor(e){this.config=e;this._duration=e.duration=="infinite"?0:(0,u.parseDuration)(e.duration)}get _epoch(){return this._duration==0?0:Math.floor(Date.now()/this._duration)}generate(e){return this._generate(e,this._epoch)}verify(e,r){let n=this._epoch;return r===this._generate(e,n)?"valid":this._duration==0?"invalid":r===this._generate(e,n-1)?"expired":"invalid"}_generate(e,r){return this.config.prefix+(0,h.createHmac)(this.config.algorithm,e).update(e+r).digest(this.config.encoding)}};var g={prefix:"u",algorithm:"sha1",encoding:"base64url",crcLength:4},d={...g,prefix:"d"},f={prefix:"s",algorithm:"sha384",encoding:"base64url",crcLength:4},p={prefix:"t",algorithm:"sha224",encoding:"base64url"};var m=class{constructor(e){this._generators={secret:new i(f),deviceId:new i(d),userId:new i(g),token:new s({...p,...e})}}generateUserId(){return this._generators.userId.generateRandomSelfValidate()}verifyUserId(e){return this._generators.userId.verifySelfValidate(e)}generateToken(e){return this._generators.token.generate(e.join())}verifyToken(e,r){return this._generators.token.verify(e.join(),r)}generateSecret(){return this._generators.secret.generateRandomSelfValidate()}verifySecret(e){return this._generators.secret.verifySelfValidate(e)}generateDeviceId(){return this._generators.deviceId.generateRandomSelfValidate()}verifyDeviceId(e){return this._generators.deviceId.verifySelfValidate(e)}};var l=require("@alwatr/logger");(0,l.definePackage)("@alwatr/crypto","4.2.1");0&&(module.exports={AlwatrCryptoFactory,AlwatrHashGenerator,AlwatrTokenGenerator,deviceIdGeneratorRecommendedConfig,secretGeneratorRecommendedConfig,userIdGeneratorRecommendedConfig,userTokenGeneratorRecommendedConfig});
+/* @alwatr/crypto v4.3.0 */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/main.ts
+var main_exports = {};
+__export(main_exports, {
+  AlwatrCryptoFactory: () => AlwatrCryptoFactory,
+  AlwatrHashGenerator: () => AlwatrHashGenerator,
+  AlwatrTokenGenerator: () => AlwatrTokenGenerator,
+  deviceIdGeneratorRecommendedConfig: () => deviceIdGeneratorRecommendedConfig,
+  secretGeneratorRecommendedConfig: () => secretGeneratorRecommendedConfig,
+  userIdGeneratorRecommendedConfig: () => userIdGeneratorRecommendedConfig,
+  userTokenGeneratorRecommendedConfig: () => userTokenGeneratorRecommendedConfig
+});
+module.exports = __toCommonJS(main_exports);
+
+// src/hash.ts
+var import_node_crypto = require("node:crypto");
+var AlwatrHashGenerator = class {
+  /**
+   * Creates a new instance of the AlwatrHashGenerator class.
+   * @param config The configuration for the hash generator.
+   */
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Generate a random hash.
+   * @returns The generated hash.
+   * @example
+   * ```typescript
+   * const clientId = hashGenerator.generateRandom();
+   * ```
+   */
+  generateRandom() {
+    return this.generate((0, import_node_crypto.randomBytes)(16));
+  }
+  /**
+   * Generate a **self-validate** random hash.
+   * @returns The generated self-validated hash.
+   * @example
+   * ```typescript
+   * const userId = hashGenerator.generateRandomSelfValidate();
+   * ```
+   */
+  generateRandomSelfValidate() {
+    return this.generateSelfValidate((0, import_node_crypto.randomBytes)(16));
+  }
+  /**
+   * Generate a hash from data.
+   * @param data - The data to generate the hash from.
+   * @returns The generated hash.
+   * @example
+   * ```typescript
+   * const crcHash = hashGenerator.generate(data);
+   * ```
+   */
+  generate(data) {
+    return this.config.prefix + (0, import_node_crypto.createHash)(this.config.algorithm).update(data).digest(this.config.encoding);
+  }
+  /**
+   * Generate a crc hash.
+   * @param data - The data to generate the crc hash from.
+   * @returns The generated crc hash.
+   */
+  generateCrc(data) {
+    const crc = (0, import_node_crypto.createHash)("sha1").update(data).digest(this.config.encoding);
+    return this.config.crcLength == null || this.config.crcLength < 1 ? crc : crc.slice(0, this.config.crcLength);
+  }
+  /**
+   * Generate a **self-validate** hash from data.
+   * @param data - The data to generate the self-validated hash from.
+   * @returns The generated self-validated hash.
+   * @example
+   * ```typescript
+   * const userId = hashGenerator.generateSelfValidate(data);
+   * ```
+   */
+  generateSelfValidate(data) {
+    const mainHash = this.generate(data);
+    const crcHash = this.generateCrc(mainHash);
+    return mainHash + crcHash;
+  }
+  /**
+   * Verify if the generated hash matches the provided hash.
+   * @param data - The data to verify.
+   * @param hash - The hash to compare against.
+   * @returns `true` if the hash is verified, `false` otherwise.
+   * @example
+   * ```typescript
+   * if (!hashGenerator.verify(data, hash)) {
+   *   new Error('data_corrupted');
+   * }
+   * ```
+   */
+  verify(data, hash) {
+    return hash === this.generate(data);
+  }
+  /**
+   * Verify a **self-validate** hash to check if it was generated by this class (with the same options).
+   * @param hash - The self-validated hash to verify.
+   * @returns `true` if the hash is verified, `false` otherwise.
+   * @example
+   * ```typescript
+   * if (!hashGenerator.verifySelfValidate(hash)) {
+   *   new Error('invalid_hash');
+   * }
+   * ```
+   */
+  verifySelfValidate(hash) {
+    const gapPos = hash.length - this.config.crcLength;
+    const mainHash = hash.slice(0, gapPos);
+    const crcHash = hash.slice(gapPos);
+    return crcHash === this.generateCrc(mainHash);
+  }
+};
+
+// src/token.ts
+var import_node_crypto2 = require("node:crypto");
+var import_nanolib = require("@alwatr/nanolib");
+var AlwatrTokenGenerator = class {
+  /**
+   * Creates a new instance of AlwatrTokenGenerator.
+   * @param config The configuration for the token generator.
+   */
+  constructor(config) {
+    this.config = config;
+    this._duration = config.duration == "infinite" ? 0 : (0, import_nanolib.parseDuration)(config.duration);
+  }
+  /**
+   * The current epoch based on the configured duration.
+   */
+  get _epoch() {
+    return this._duration == 0 ? 0 : Math.floor(Date.now() / this._duration);
+  }
+  /**
+   * Generates a HOTP token based on the provided data for special duration.
+   * @param data The data to generate the token from.
+   * @returns The generated token.
+   * @example
+   * ```typescript
+   * user.auth = tokenGenerator.generate(`${user.id}-${user.role}`);
+   * ```
+   */
+  generate(data) {
+    return this._generate(data, this._epoch);
+  }
+  /**
+   * Verifies if a token is valid.
+   * @param data The data used to generate the token.
+   * @param token The token to verify.
+   * @returns The validity of the token.
+   * @example
+   * ```typescript
+   * const validateStatus = tokenGenerator.verify([user.id,user.role].join(), user.auth);
+   * ```
+   */
+  verify(data, token) {
+    const epoch = this._epoch;
+    if (token === this._generate(data, epoch)) return "valid";
+    if (this._duration == 0) return "invalid";
+    if (token === this._generate(data, epoch - 1)) return "expired";
+    return "invalid";
+  }
+  /**
+   * Generates a cryptographic token based on the provided data and epoch.
+   * @param data - The data to be used in the token generation.
+   * @param epoch - The epoch value to be used in the token generation.
+   * @returns The generated cryptographic token.
+   */
+  _generate(data, epoch) {
+    return this.config.prefix + (0, import_node_crypto2.createHmac)(this.config.algorithm, data).update(data + epoch).digest(this.config.encoding);
+  }
+};
+
+// src/api.ts
+var import_nanolib2 = require("@alwatr/nanolib");
+
+// src/pre-config.ts
+var userIdGeneratorRecommendedConfig = {
+  prefix: "u",
+  algorithm: "sha1",
+  encoding: "base64url",
+  crcLength: 4
+};
+var deviceIdGeneratorRecommendedConfig = {
+  ...userIdGeneratorRecommendedConfig,
+  prefix: "d"
+};
+var secretGeneratorRecommendedConfig = {
+  prefix: "s",
+  algorithm: "sha384",
+  encoding: "base64url",
+  crcLength: 4
+};
+var userTokenGeneratorRecommendedConfig = {
+  prefix: "t",
+  algorithm: "sha224",
+  encoding: "base64url"
+};
+
+// src/api.ts
+__dev_mode__: import_nanolib2.packageTracer.add("@alwatr/crypto", "4.3.0");
+var AlwatrCryptoFactory = class {
+  /**
+   * Creates a new instance of crypto factory.
+   * @param config The configuration used to create the crypto factory.
+   */
+  constructor(config) {
+    this._generators = {
+      secret: new AlwatrHashGenerator(secretGeneratorRecommendedConfig),
+      deviceId: new AlwatrHashGenerator(deviceIdGeneratorRecommendedConfig),
+      userId: new AlwatrHashGenerator(userIdGeneratorRecommendedConfig),
+      token: new AlwatrTokenGenerator({
+        ...userTokenGeneratorRecommendedConfig,
+        ...config
+      })
+    };
+  }
+  /**
+   * Generate self-verifiable user ID.
+   * @returns The generated user ID.
+   * @example
+   * ```typescript
+   * const newUser = {
+   *   id: cryptoFactory.generateUserId(),
+   *   ...
+   * }
+   * ```
+   */
+  generateUserId() {
+    return this._generators.userId.generateRandomSelfValidate();
+  }
+  /**
+   * Verify a user ID without token.
+   * @param userId The user ID to verify.
+   * @returns A boolean indicating whether the user ID is valid.
+   * @example
+   * ```typescript
+   * if (!cryptoFactory.verifyUserId(user.id)) {
+   *   throw new Error('invalid_user');
+   * }
+   * ```
+   */
+  verifyUserId(userId) {
+    return this._generators.userId.verifySelfValidate(userId);
+  }
+  /**
+   * Generate authentication token.
+   * @param uniquelyList The list of uniq values to generate the token from.
+   * @returns The generated user token.
+   * @example
+   * ```typescript
+   * const userToken = cryptoFactory.generateToken([user.id, user.lpe]);
+   * ```
+   */
+  generateToken(uniquelyList) {
+    return this._generators.token.generate(uniquelyList.join());
+  }
+  /**
+   * Verify a authentication token.
+   * @param uniquelyList The list of uniq values used to generate the token.
+   * @param token The user token to verify.
+   * @returns The validity of the token.
+   * @example
+   * ```typescript
+   * if (!cryptoFactory.verifyToken([user.id, user.lpe], userToken)) {
+   *   throw new Error('invalid_token');
+   * }
+   * ```
+   */
+  verifyToken(uniquelyList, token) {
+    return this._generators.token.verify(uniquelyList.join(), token);
+  }
+  /**
+   * Generate self-verifiable secret.
+   * @returns The generated secret.
+   * @example
+   * ```typescript
+   * const config = {
+   *   storageToken: cryptoFactory.generateSecret(),
+   *   ...
+   * }
+   * ```
+   */
+  generateSecret() {
+    return this._generators.secret.generateRandomSelfValidate();
+  }
+  /**
+   * Verify a secret.
+   * @param secret The secret to verify.
+   * @returns A boolean indicating whether the secret is valid.
+   * @example
+   * ```typescript
+   * if (!cryptoFactory.verifySecret(config.storageToken)) {
+   *   throw new Error('invalid_secret');
+   * }
+   * ```
+   */
+  verifySecret(secret) {
+    return this._generators.secret.verifySelfValidate(secret);
+  }
+  /**
+   * Generate self-verifiable device ID.
+   * @returns The generated device ID.
+   * @example
+   * ```typescript
+   * const deviceId = deviceFactory.generateDeviceId();
+   * ```
+   */
+  generateDeviceId() {
+    return this._generators.deviceId.generateRandomSelfValidate();
+  }
+  /**
+   * Verify a device ID.
+   * @param deviceId The device ID to verify.
+   * @returns A boolean indicating whether the device ID is valid.
+   * @example
+   * ```typescript
+   * if (!deviceFactory.verifyDeviceId(bodyJson.deviceId)) {
+   *   throw {
+   *    ok: false,
+   *    status: 400,
+   *    error: 'invalid_device_id',
+   *   }
+   * }
+   * ```
+   */
+  verifyDeviceId(deviceId) {
+    return this._generators.deviceId.verifySelfValidate(deviceId);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AlwatrCryptoFactory,
+  AlwatrHashGenerator,
+  AlwatrTokenGenerator,
+  deviceIdGeneratorRecommendedConfig,
+  secretGeneratorRecommendedConfig,
+  userIdGeneratorRecommendedConfig,
+  userTokenGeneratorRecommendedConfig
+});
+/*! For license information please see main.cjs.LEGAL.txt */
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/main.ts", "../src/hash.ts", "../src/token.ts", "../src/pre-config.ts", "../src/api.ts"],
-  "sourcesContent": ["import {definePackage} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\n\nexport * from './hash.js';\nexport * from './token.js';\nexport * from './api.js';\nexport * from './type.js';\nexport * from './pre-config.js';\n\ndefinePackage('@alwatr/crypto', __package_version__);\n", "import {createHash, randomBytes, type BinaryLike} from 'node:crypto';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\n/**\n * Represents the configuration for a hash generator.\n */\nexport interface HashGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The length of the CRC (Cyclic Redundancy Check) value.\n   */\n  crcLength: number;\n}\n\n/**\n * Secure **self-validate** hash generator.\n */\nexport class AlwatrHashGenerator {\n  /**\n   * Creates a new instance of the AlwatrHashGenerator class.\n   * @param config The configuration for the hash generator.\n   */\n  constructor(public config: HashGeneratorConfig) {}\n\n  /**\n   * Generate a random hash.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const clientId = hashGenerator.generateRandom();\n   * ```\n   */\n  generateRandom(): string {\n    return this.generate(randomBytes(16));\n  }\n\n  /**\n   * Generate a **self-validate** random hash.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateRandomSelfValidate();\n   * ```\n   */\n  generateRandomSelfValidate(): string {\n    return this.generateSelfValidate(randomBytes(16));\n  }\n\n  /**\n   * Generate a hash from data.\n   * @param data - The data to generate the hash from.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const crcHash = hashGenerator.generate(data);\n   * ```\n   */\n  generate(data: BinaryLike): string {\n    return this.config.prefix + createHash(this.config.algorithm).update(data).digest(this.config.encoding);\n  }\n\n  /**\n   * Generate a crc hash.\n   * @param data - The data to generate the crc hash from.\n   * @returns The generated crc hash.\n   */\n  generateCrc(data: BinaryLike): string {\n    const crc = createHash('sha1').update(data).digest(this.config.encoding);\n    return this.config.crcLength == null || this.config.crcLength < 1 ? crc : crc.slice(0, this.config.crcLength);\n  }\n\n  /**\n   * Generate a **self-validate** hash from data.\n   * @param data - The data to generate the self-validated hash from.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateSelfValidate(data);\n   * ```\n   */\n  generateSelfValidate(data: BinaryLike): string {\n    const mainHash = this.generate(data);\n    const crcHash = this.generateCrc(mainHash);\n    return mainHash + crcHash;\n  }\n\n  /**\n   * Verify if the generated hash matches the provided hash.\n   * @param data - The data to verify.\n   * @param hash - The hash to compare against.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verify(data, hash)) {\n   *   new Error('data_corrupted');\n   * }\n   * ```\n   */\n  verify(data: BinaryLike, hash: string): boolean {\n    return hash === this.generate(data);\n  }\n\n  /**\n   * Verify a **self-validate** hash to check if it was generated by this class (with the same options).\n   * @param hash - The self-validated hash to verify.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verifySelfValidate(hash)) {\n   *   new Error('invalid_hash');\n   * }\n   * ```\n   */\n  verifySelfValidate(hash: string): boolean {\n    const gapPos = hash.length - this.config.crcLength;\n    const mainHash = hash.slice(0, gapPos);\n    const crcHash = hash.slice(gapPos);\n    return crcHash === this.generateCrc(mainHash);\n  }\n}\n", "import {createHmac} from 'node:crypto';\n\nimport {parseDuration, type DurationString} from '@alwatr/parse-duration';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\nexport type TokenValidity = 'valid' | 'invalid' | 'expired';\n\n/**\n * Represents the configuration for a token generator.\n */\nexport interface TokenGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: DurationString | 'infinite';\n}\n\n/**\n * Secure authentication HOTP token generator (HMAC-based One-Time Password algorithm).\n */\nexport class AlwatrTokenGenerator {\n  private _duration: number;\n\n  /**\n   * The current epoch based on the configured duration.\n   */\n  protected get _epoch(): number {\n    return this._duration == 0 ? 0 : Math.floor(Date.now() / this._duration);\n  }\n\n  /**\n   * Creates a new instance of AlwatrTokenGenerator.\n   * @param config The configuration for the token generator.\n   */\n  constructor(public config: TokenGeneratorConfig) {\n    this._duration = config.duration == 'infinite' ? 0 : parseDuration(config.duration);\n  }\n\n  /**\n   * Generates a HOTP token based on the provided data for special duration.\n   * @param data The data to generate the token from.\n   * @returns The generated token.\n   * @example\n   * ```typescript\n   * user.auth = tokenGenerator.generate(`${user.id}-${user.role}`);\n   * ```\n   */\n  generate(data: string): string {\n    return this._generate(data, this._epoch);\n  }\n\n  /**\n   * Verifies if a token is valid.\n   * @param data The data used to generate the token.\n   * @param token The token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * const validateStatus = tokenGenerator.verify([user.id,user.role].join(), user.auth);\n   * ```\n   */\n  verify(data: string, token: string): TokenValidity {\n    const epoch = this._epoch;\n    if (token === this._generate(data, epoch)) return 'valid';\n    if (this._duration == 0) return 'invalid';\n    if (token === this._generate(data, epoch - 1)) return 'expired';\n    return 'invalid';\n  }\n\n  /**\n   * Generates a cryptographic token based on the provided data and epoch.\n   * @param data - The data to be used in the token generation.\n   * @param epoch - The epoch value to be used in the token generation.\n   * @returns The generated cryptographic token.\n   */\n  protected _generate(data: string, epoch: number): string {\n    return (\n      this.config.prefix +\n      createHmac(this.config.algorithm, data)\n        .update(data + epoch)\n        .digest(this.config.encoding)\n    );\n  }\n}\n", "import type {HashGeneratorConfig} from './hash.js';\nimport type {TokenGeneratorConfig} from './token.js';\n\n/**\n * Alwatr hash generator recommended configuration for making random self-validate **user-id**.\n */\nexport const userIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 'u',\n  algorithm: 'sha1',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Hash generator recommended configuration for making random self-validate **device-id**.\n */\nexport const deviceIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  ...userIdGeneratorRecommendedConfig,\n  prefix: 'd',\n};\n\n/**\n * Hash generator pre configuration for making random self-validate **secrets**.\n */\nexport const secretGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 's',\n  algorithm: 'sha384',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Token generator recommended configuration for making secure self-validate **user-token**.\n */\nexport const userTokenGeneratorRecommendedConfig: Omit<TokenGeneratorConfig, 'secret' | 'duration'> = {\n  prefix: 't',\n  algorithm: 'sha224',\n  encoding: 'base64url',\n};\n", "import {AlwatrHashGenerator} from './hash.js';\nimport {\n  deviceIdGeneratorRecommendedConfig,\n  secretGeneratorRecommendedConfig,\n  userIdGeneratorRecommendedConfig,\n  userTokenGeneratorRecommendedConfig,\n} from './pre-config.js';\nimport {AlwatrTokenGenerator, type TokenValidity} from './token.js';\n\nimport type {DurationString} from '@alwatr/parse-duration';\n\n/**\n * Configuration options for the CryptoFactory.\n */\nexport interface CryptoFactoryConfig {\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: DurationString | 'infinite';\n}\n\n/**\n * Crypto factory for generating self-validate user-id, user-token, secret, device-id.\n */\nexport class AlwatrCryptoFactory {\n  protected _generators;\n\n  /**\n   * Creates a new instance of crypto factory.\n   * @param config The configuration used to create the crypto factory.\n   */\n  constructor(config: CryptoFactoryConfig) {\n    this._generators = {\n      secret: new AlwatrHashGenerator(secretGeneratorRecommendedConfig),\n      deviceId: new AlwatrHashGenerator(deviceIdGeneratorRecommendedConfig),\n      userId: new AlwatrHashGenerator(userIdGeneratorRecommendedConfig),\n      token: new AlwatrTokenGenerator({\n        ...userTokenGeneratorRecommendedConfig,\n        ...config,\n      }),\n    } as const;\n  }\n\n  /**\n   * Generate self-verifiable user ID.\n   * @returns The generated user ID.\n   * @example\n   * ```typescript\n   * const newUser = {\n   *   id: cryptoFactory.generateUserId(),\n   *   ...\n   * }\n   * ```\n   */\n  generateUserId(): string {\n    return this._generators.userId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a user ID without token.\n   * @param userId The user ID to verify.\n   * @returns A boolean indicating whether the user ID is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyUserId(user.id)) {\n   *   throw new Error('invalid_user');\n   * }\n   * ```\n   */\n  verifyUserId(userId: string): boolean {\n    return this._generators.userId.verifySelfValidate(userId);\n  }\n\n  /**\n   * Generate authentication token.\n   * @param uniquelyList The list of uniq values to generate the token from.\n   * @returns The generated user token.\n   * @example\n   * ```typescript\n   * const userToken = cryptoFactory.generateToken([user.id, user.lpe]);\n   * ```\n   */\n  generateToken(uniquelyList: (string | number)[]): string {\n    return this._generators.token.generate(uniquelyList.join());\n  }\n\n  /**\n   * Verify a authentication token.\n   * @param uniquelyList The list of uniq values used to generate the token.\n   * @param token The user token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyToken([user.id, user.lpe], userToken)) {\n   *   throw new Error('invalid_token');\n   * }\n   * ```\n   */\n  verifyToken(uniquelyList: (string | number)[], token: string): TokenValidity {\n    return this._generators.token.verify(uniquelyList.join(), token);\n  }\n\n  /**\n   * Generate self-verifiable secret.\n   * @returns The generated secret.\n   * @example\n   * ```typescript\n   * const config = {\n   *   storageToken: cryptoFactory.generateSecret(),\n   *   ...\n   * }\n   * ```\n   */\n  generateSecret(): string {\n    return this._generators.secret.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a secret.\n   * @param secret The secret to verify.\n   * @returns A boolean indicating whether the secret is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifySecret(config.storageToken)) {\n   *   throw new Error('invalid_secret');\n   * }\n   * ```\n   */\n  verifySecret(secret: string): boolean {\n    return this._generators.secret.verifySelfValidate(secret);\n  }\n\n  /**\n   * Generate self-verifiable device ID.\n   * @returns The generated device ID.\n   * @example\n   * ```typescript\n   * const deviceId = deviceFactory.generateDeviceId();\n   * ```\n   */\n  generateDeviceId(): string {\n    return this._generators.deviceId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a device ID.\n   * @param deviceId The device ID to verify.\n   * @returns A boolean indicating whether the device ID is valid.\n   * @example\n   * ```typescript\n   * if (!deviceFactory.verifyDeviceId(bodyJson.deviceId)) {\n   *   throw {\n   *    ok: false,\n   *    status: 400,\n   *    error: 'invalid_device_id',\n   *   }\n   * }\n   * ```\n   */\n  verifyDeviceId(deviceId: string): boolean {\n    return this._generators.deviceId.verifySelfValidate(deviceId);\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["main_exports", "__export", "AlwatrCryptoFactory", "AlwatrHashGenerator", "AlwatrTokenGenerator", "deviceIdGeneratorRecommendedConfig", "secretGeneratorRecommendedConfig", "userIdGeneratorRecommendedConfig", "userTokenGeneratorRecommendedConfig", "__toCommonJS", "import_node_crypto", "AlwatrHashGenerator", "config", "data", "crc", "mainHash", "crcHash", "hash", "gapPos", "import_node_crypto", "import_parse_duration", "AlwatrTokenGenerator", "config", "data", "token", "epoch", "userIdGeneratorRecommendedConfig", "deviceIdGeneratorRecommendedConfig", "secretGeneratorRecommendedConfig", "userTokenGeneratorRecommendedConfig", "AlwatrCryptoFactory", "config", "AlwatrHashGenerator", "secretGeneratorRecommendedConfig", "deviceIdGeneratorRecommendedConfig", "userIdGeneratorRecommendedConfig", "AlwatrTokenGenerator", "userTokenGeneratorRecommendedConfig", "userId", "uniquelyList", "token", "secret", "deviceId", "import_logger"]
+  "sources": ["../src/main.ts", "../src/hash.ts", "../src/token.ts", "../src/api.ts", "../src/pre-config.ts"],
+  "sourcesContent": ["export * from './hash.js';\nexport * from './token.js';\nexport * from './api.js';\nexport * from './type.js';\nexport * from './pre-config.js';\n", "import {createHash, randomBytes, type BinaryLike} from 'node:crypto';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\n/**\n * Represents the configuration for a hash generator.\n */\nexport interface HashGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The length of the CRC (Cyclic Redundancy Check) value.\n   */\n  crcLength: number;\n}\n\n/**\n * Secure **self-validate** hash generator.\n */\nexport class AlwatrHashGenerator {\n  /**\n   * Creates a new instance of the AlwatrHashGenerator class.\n   * @param config The configuration for the hash generator.\n   */\n  constructor(public config: HashGeneratorConfig) {}\n\n  /**\n   * Generate a random hash.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const clientId = hashGenerator.generateRandom();\n   * ```\n   */\n  generateRandom(): string {\n    return this.generate(randomBytes(16));\n  }\n\n  /**\n   * Generate a **self-validate** random hash.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateRandomSelfValidate();\n   * ```\n   */\n  generateRandomSelfValidate(): string {\n    return this.generateSelfValidate(randomBytes(16));\n  }\n\n  /**\n   * Generate a hash from data.\n   * @param data - The data to generate the hash from.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const crcHash = hashGenerator.generate(data);\n   * ```\n   */\n  generate(data: BinaryLike): string {\n    return this.config.prefix + createHash(this.config.algorithm).update(data).digest(this.config.encoding);\n  }\n\n  /**\n   * Generate a crc hash.\n   * @param data - The data to generate the crc hash from.\n   * @returns The generated crc hash.\n   */\n  generateCrc(data: BinaryLike): string {\n    const crc = createHash('sha1').update(data).digest(this.config.encoding);\n    return this.config.crcLength == null || this.config.crcLength < 1 ? crc : crc.slice(0, this.config.crcLength);\n  }\n\n  /**\n   * Generate a **self-validate** hash from data.\n   * @param data - The data to generate the self-validated hash from.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateSelfValidate(data);\n   * ```\n   */\n  generateSelfValidate(data: BinaryLike): string {\n    const mainHash = this.generate(data);\n    const crcHash = this.generateCrc(mainHash);\n    return mainHash + crcHash;\n  }\n\n  /**\n   * Verify if the generated hash matches the provided hash.\n   * @param data - The data to verify.\n   * @param hash - The hash to compare against.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verify(data, hash)) {\n   *   new Error('data_corrupted');\n   * }\n   * ```\n   */\n  verify(data: BinaryLike, hash: string): boolean {\n    return hash === this.generate(data);\n  }\n\n  /**\n   * Verify a **self-validate** hash to check if it was generated by this class (with the same options).\n   * @param hash - The self-validated hash to verify.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verifySelfValidate(hash)) {\n   *   new Error('invalid_hash');\n   * }\n   * ```\n   */\n  verifySelfValidate(hash: string): boolean {\n    const gapPos = hash.length - this.config.crcLength;\n    const mainHash = hash.slice(0, gapPos);\n    const crcHash = hash.slice(gapPos);\n    return crcHash === this.generateCrc(mainHash);\n  }\n}\n", "import {createHmac} from 'node:crypto';\n\nimport {parseDuration, type Duration} from '@alwatr/nanolib';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\nexport type TokenValidity = 'valid' | 'invalid' | 'expired';\n\n/**\n * Represents the configuration for a token generator.\n */\nexport interface TokenGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: Duration | 'infinite';\n}\n\n/**\n * Secure authentication HOTP token generator (HMAC-based One-Time Password algorithm).\n */\nexport class AlwatrTokenGenerator {\n  private _duration: number;\n\n  /**\n   * The current epoch based on the configured duration.\n   */\n  protected get _epoch(): number {\n    return this._duration == 0 ? 0 : Math.floor(Date.now() / this._duration);\n  }\n\n  /**\n   * Creates a new instance of AlwatrTokenGenerator.\n   * @param config The configuration for the token generator.\n   */\n  constructor(public config: TokenGeneratorConfig) {\n    this._duration = config.duration == 'infinite' ? 0 : parseDuration(config.duration);\n  }\n\n  /**\n   * Generates a HOTP token based on the provided data for special duration.\n   * @param data The data to generate the token from.\n   * @returns The generated token.\n   * @example\n   * ```typescript\n   * user.auth = tokenGenerator.generate(`${user.id}-${user.role}`);\n   * ```\n   */\n  generate(data: string): string {\n    return this._generate(data, this._epoch);\n  }\n\n  /**\n   * Verifies if a token is valid.\n   * @param data The data used to generate the token.\n   * @param token The token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * const validateStatus = tokenGenerator.verify([user.id,user.role].join(), user.auth);\n   * ```\n   */\n  verify(data: string, token: string): TokenValidity {\n    const epoch = this._epoch;\n    if (token === this._generate(data, epoch)) return 'valid';\n    if (this._duration == 0) return 'invalid';\n    if (token === this._generate(data, epoch - 1)) return 'expired';\n    return 'invalid';\n  }\n\n  /**\n   * Generates a cryptographic token based on the provided data and epoch.\n   * @param data - The data to be used in the token generation.\n   * @param epoch - The epoch value to be used in the token generation.\n   * @returns The generated cryptographic token.\n   */\n  protected _generate(data: string, epoch: number): string {\n    return (\n      this.config.prefix +\n      createHmac(this.config.algorithm, data)\n        .update(data + epoch)\n        .digest(this.config.encoding)\n    );\n  }\n}\n", "import {packageTracer, type Duration} from '@alwatr/nanolib';\n\nimport {AlwatrHashGenerator} from './hash.js';\nimport {\n  deviceIdGeneratorRecommendedConfig,\n  secretGeneratorRecommendedConfig,\n  userIdGeneratorRecommendedConfig,\n  userTokenGeneratorRecommendedConfig,\n} from './pre-config.js';\nimport {AlwatrTokenGenerator, type TokenValidity} from './token.js';\n\n__dev_mode__:  packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Configuration options for the CryptoFactory.\n */\nexport interface CryptoFactoryConfig {\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: Duration | 'infinite';\n}\n\n/**\n * Crypto factory for generating self-validate user-id, user-token, secret, device-id.\n */\nexport class AlwatrCryptoFactory {\n  protected _generators;\n\n  /**\n   * Creates a new instance of crypto factory.\n   * @param config The configuration used to create the crypto factory.\n   */\n  constructor(config: CryptoFactoryConfig) {\n    this._generators = {\n      secret: new AlwatrHashGenerator(secretGeneratorRecommendedConfig),\n      deviceId: new AlwatrHashGenerator(deviceIdGeneratorRecommendedConfig),\n      userId: new AlwatrHashGenerator(userIdGeneratorRecommendedConfig),\n      token: new AlwatrTokenGenerator({\n        ...userTokenGeneratorRecommendedConfig,\n        ...config,\n      }),\n    } as const;\n  }\n\n  /**\n   * Generate self-verifiable user ID.\n   * @returns The generated user ID.\n   * @example\n   * ```typescript\n   * const newUser = {\n   *   id: cryptoFactory.generateUserId(),\n   *   ...\n   * }\n   * ```\n   */\n  generateUserId(): string {\n    return this._generators.userId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a user ID without token.\n   * @param userId The user ID to verify.\n   * @returns A boolean indicating whether the user ID is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyUserId(user.id)) {\n   *   throw new Error('invalid_user');\n   * }\n   * ```\n   */\n  verifyUserId(userId: string): boolean {\n    return this._generators.userId.verifySelfValidate(userId);\n  }\n\n  /**\n   * Generate authentication token.\n   * @param uniquelyList The list of uniq values to generate the token from.\n   * @returns The generated user token.\n   * @example\n   * ```typescript\n   * const userToken = cryptoFactory.generateToken([user.id, user.lpe]);\n   * ```\n   */\n  generateToken(uniquelyList: (string | number)[]): string {\n    return this._generators.token.generate(uniquelyList.join());\n  }\n\n  /**\n   * Verify a authentication token.\n   * @param uniquelyList The list of uniq values used to generate the token.\n   * @param token The user token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyToken([user.id, user.lpe], userToken)) {\n   *   throw new Error('invalid_token');\n   * }\n   * ```\n   */\n  verifyToken(uniquelyList: (string | number)[], token: string): TokenValidity {\n    return this._generators.token.verify(uniquelyList.join(), token);\n  }\n\n  /**\n   * Generate self-verifiable secret.\n   * @returns The generated secret.\n   * @example\n   * ```typescript\n   * const config = {\n   *   storageToken: cryptoFactory.generateSecret(),\n   *   ...\n   * }\n   * ```\n   */\n  generateSecret(): string {\n    return this._generators.secret.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a secret.\n   * @param secret The secret to verify.\n   * @returns A boolean indicating whether the secret is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifySecret(config.storageToken)) {\n   *   throw new Error('invalid_secret');\n   * }\n   * ```\n   */\n  verifySecret(secret: string): boolean {\n    return this._generators.secret.verifySelfValidate(secret);\n  }\n\n  /**\n   * Generate self-verifiable device ID.\n   * @returns The generated device ID.\n   * @example\n   * ```typescript\n   * const deviceId = deviceFactory.generateDeviceId();\n   * ```\n   */\n  generateDeviceId(): string {\n    return this._generators.deviceId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a device ID.\n   * @param deviceId The device ID to verify.\n   * @returns A boolean indicating whether the device ID is valid.\n   * @example\n   * ```typescript\n   * if (!deviceFactory.verifyDeviceId(bodyJson.deviceId)) {\n   *   throw {\n   *    ok: false,\n   *    status: 400,\n   *    error: 'invalid_device_id',\n   *   }\n   * }\n   * ```\n   */\n  verifyDeviceId(deviceId: string): boolean {\n    return this._generators.deviceId.verifySelfValidate(deviceId);\n  }\n}\n", "import type {HashGeneratorConfig} from './hash.js';\nimport type {TokenGeneratorConfig} from './token.js';\n\n/**\n * Alwatr hash generator recommended configuration for making random self-validate **user-id**.\n */\nexport const userIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 'u',\n  algorithm: 'sha1',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Hash generator recommended configuration for making random self-validate **device-id**.\n */\nexport const deviceIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  ...userIdGeneratorRecommendedConfig,\n  prefix: 'd',\n};\n\n/**\n * Hash generator pre configuration for making random self-validate **secrets**.\n */\nexport const secretGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 's',\n  algorithm: 'sha384',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Token generator recommended configuration for making secure self-validate **user-token**.\n */\nexport const userTokenGeneratorRecommendedConfig: Omit<TokenGeneratorConfig, 'secret' | 'duration'> = {\n  prefix: 't',\n  algorithm: 'sha224',\n  encoding: 'base64url',\n};\n"],
+  "mappings": "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",
+  "names": ["import_node_crypto", "import_nanolib"]
 }

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/main.mjs

@@ -1,3 +1,329 @@
-/* @alwatr/crypto v4.2.1 */
-import{createHash as s,randomBytes as g}from"node:crypto";var n=class{constructor(e){this.config=e}generateRandom(){return this.generate(g(16))}generateRandomSelfValidate(){return this.generateSelfValidate(g(16))}generate(e){return this.config.prefix+s(this.config.algorithm).update(e).digest(this.config.encoding)}generateCrc(e){let r=s("sha1").update(e).digest(this.config.encoding);return this.config.crcLength==null||this.config.crcLength<1?r:r.slice(0,this.config.crcLength)}generateSelfValidate(e){let r=this.generate(e),t=this.generateCrc(r);return r+t}verify(e,r){return r===this.generate(e)}verifySelfValidate(e){let r=e.length-this.config.crcLength,t=e.slice(0,r);return e.slice(r)===this.generateCrc(t)}};import{createHmac as m}from"node:crypto";import{parseDuration as h}from"@alwatr/parse-duration";var i=class{constructor(e){this.config=e;this._duration=e.duration=="infinite"?0:h(e.duration)}get _epoch(){return this._duration==0?0:Math.floor(Date.now()/this._duration)}generate(e){return this._generate(e,this._epoch)}verify(e,r){let t=this._epoch;return r===this._generate(e,t)?"valid":this._duration==0?"invalid":r===this._generate(e,t-1)?"expired":"invalid"}_generate(e,r){return this.config.prefix+m(this.config.algorithm,e).update(e+r).digest(this.config.encoding)}};var o={prefix:"u",algorithm:"sha1",encoding:"base64url",crcLength:4},c={...o,prefix:"d"},d={prefix:"s",algorithm:"sha384",encoding:"base64url",crcLength:4},f={prefix:"t",algorithm:"sha224",encoding:"base64url"};var p=class{constructor(e){this._generators={secret:new n(d),deviceId:new n(c),userId:new n(o),token:new i({...f,...e})}}generateUserId(){return this._generators.userId.generateRandomSelfValidate()}verifyUserId(e){return this._generators.userId.verifySelfValidate(e)}generateToken(e){return this._generators.token.generate(e.join())}verifyToken(e,r){return this._generators.token.verify(e.join(),r)}generateSecret(){return this._generators.secret.generateRandomSelfValidate()}verifySecret(e){return this._generators.secret.verifySelfValidate(e)}generateDeviceId(){return this._generators.deviceId.generateRandomSelfValidate()}verifyDeviceId(e){return this._generators.deviceId.verifySelfValidate(e)}};import{definePackage as u}from"@alwatr/logger";u("@alwatr/crypto","4.2.1");export{p as AlwatrCryptoFactory,n as AlwatrHashGenerator,i as AlwatrTokenGenerator,c as deviceIdGeneratorRecommendedConfig,d as secretGeneratorRecommendedConfig,o as userIdGeneratorRecommendedConfig,f as userTokenGeneratorRecommendedConfig};
+/* @alwatr/crypto v4.3.0 */
+
+// src/hash.ts
+import { createHash, randomBytes } from "node:crypto";
+var AlwatrHashGenerator = class {
+  /**
+   * Creates a new instance of the AlwatrHashGenerator class.
+   * @param config The configuration for the hash generator.
+   */
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Generate a random hash.
+   * @returns The generated hash.
+   * @example
+   * ```typescript
+   * const clientId = hashGenerator.generateRandom();
+   * ```
+   */
+  generateRandom() {
+    return this.generate(randomBytes(16));
+  }
+  /**
+   * Generate a **self-validate** random hash.
+   * @returns The generated self-validated hash.
+   * @example
+   * ```typescript
+   * const userId = hashGenerator.generateRandomSelfValidate();
+   * ```
+   */
+  generateRandomSelfValidate() {
+    return this.generateSelfValidate(randomBytes(16));
+  }
+  /**
+   * Generate a hash from data.
+   * @param data - The data to generate the hash from.
+   * @returns The generated hash.
+   * @example
+   * ```typescript
+   * const crcHash = hashGenerator.generate(data);
+   * ```
+   */
+  generate(data) {
+    return this.config.prefix + createHash(this.config.algorithm).update(data).digest(this.config.encoding);
+  }
+  /**
+   * Generate a crc hash.
+   * @param data - The data to generate the crc hash from.
+   * @returns The generated crc hash.
+   */
+  generateCrc(data) {
+    const crc = createHash("sha1").update(data).digest(this.config.encoding);
+    return this.config.crcLength == null || this.config.crcLength < 1 ? crc : crc.slice(0, this.config.crcLength);
+  }
+  /**
+   * Generate a **self-validate** hash from data.
+   * @param data - The data to generate the self-validated hash from.
+   * @returns The generated self-validated hash.
+   * @example
+   * ```typescript
+   * const userId = hashGenerator.generateSelfValidate(data);
+   * ```
+   */
+  generateSelfValidate(data) {
+    const mainHash = this.generate(data);
+    const crcHash = this.generateCrc(mainHash);
+    return mainHash + crcHash;
+  }
+  /**
+   * Verify if the generated hash matches the provided hash.
+   * @param data - The data to verify.
+   * @param hash - The hash to compare against.
+   * @returns `true` if the hash is verified, `false` otherwise.
+   * @example
+   * ```typescript
+   * if (!hashGenerator.verify(data, hash)) {
+   *   new Error('data_corrupted');
+   * }
+   * ```
+   */
+  verify(data, hash) {
+    return hash === this.generate(data);
+  }
+  /**
+   * Verify a **self-validate** hash to check if it was generated by this class (with the same options).
+   * @param hash - The self-validated hash to verify.
+   * @returns `true` if the hash is verified, `false` otherwise.
+   * @example
+   * ```typescript
+   * if (!hashGenerator.verifySelfValidate(hash)) {
+   *   new Error('invalid_hash');
+   * }
+   * ```
+   */
+  verifySelfValidate(hash) {
+    const gapPos = hash.length - this.config.crcLength;
+    const mainHash = hash.slice(0, gapPos);
+    const crcHash = hash.slice(gapPos);
+    return crcHash === this.generateCrc(mainHash);
+  }
+};
+
+// src/token.ts
+import { createHmac } from "node:crypto";
+import { parseDuration } from "@alwatr/nanolib";
+var AlwatrTokenGenerator = class {
+  /**
+   * Creates a new instance of AlwatrTokenGenerator.
+   * @param config The configuration for the token generator.
+   */
+  constructor(config) {
+    this.config = config;
+    this._duration = config.duration == "infinite" ? 0 : parseDuration(config.duration);
+  }
+  /**
+   * The current epoch based on the configured duration.
+   */
+  get _epoch() {
+    return this._duration == 0 ? 0 : Math.floor(Date.now() / this._duration);
+  }
+  /**
+   * Generates a HOTP token based on the provided data for special duration.
+   * @param data The data to generate the token from.
+   * @returns The generated token.
+   * @example
+   * ```typescript
+   * user.auth = tokenGenerator.generate(`${user.id}-${user.role}`);
+   * ```
+   */
+  generate(data) {
+    return this._generate(data, this._epoch);
+  }
+  /**
+   * Verifies if a token is valid.
+   * @param data The data used to generate the token.
+   * @param token The token to verify.
+   * @returns The validity of the token.
+   * @example
+   * ```typescript
+   * const validateStatus = tokenGenerator.verify([user.id,user.role].join(), user.auth);
+   * ```
+   */
+  verify(data, token) {
+    const epoch = this._epoch;
+    if (token === this._generate(data, epoch)) return "valid";
+    if (this._duration == 0) return "invalid";
+    if (token === this._generate(data, epoch - 1)) return "expired";
+    return "invalid";
+  }
+  /**
+   * Generates a cryptographic token based on the provided data and epoch.
+   * @param data - The data to be used in the token generation.
+   * @param epoch - The epoch value to be used in the token generation.
+   * @returns The generated cryptographic token.
+   */
+  _generate(data, epoch) {
+    return this.config.prefix + createHmac(this.config.algorithm, data).update(data + epoch).digest(this.config.encoding);
+  }
+};
+
+// src/api.ts
+import { packageTracer } from "@alwatr/nanolib";
+
+// src/pre-config.ts
+var userIdGeneratorRecommendedConfig = {
+  prefix: "u",
+  algorithm: "sha1",
+  encoding: "base64url",
+  crcLength: 4
+};
+var deviceIdGeneratorRecommendedConfig = {
+  ...userIdGeneratorRecommendedConfig,
+  prefix: "d"
+};
+var secretGeneratorRecommendedConfig = {
+  prefix: "s",
+  algorithm: "sha384",
+  encoding: "base64url",
+  crcLength: 4
+};
+var userTokenGeneratorRecommendedConfig = {
+  prefix: "t",
+  algorithm: "sha224",
+  encoding: "base64url"
+};
+
+// src/api.ts
+__dev_mode__: packageTracer.add("@alwatr/crypto", "4.3.0");
+var AlwatrCryptoFactory = class {
+  /**
+   * Creates a new instance of crypto factory.
+   * @param config The configuration used to create the crypto factory.
+   */
+  constructor(config) {
+    this._generators = {
+      secret: new AlwatrHashGenerator(secretGeneratorRecommendedConfig),
+      deviceId: new AlwatrHashGenerator(deviceIdGeneratorRecommendedConfig),
+      userId: new AlwatrHashGenerator(userIdGeneratorRecommendedConfig),
+      token: new AlwatrTokenGenerator({
+        ...userTokenGeneratorRecommendedConfig,
+        ...config
+      })
+    };
+  }
+  /**
+   * Generate self-verifiable user ID.
+   * @returns The generated user ID.
+   * @example
+   * ```typescript
+   * const newUser = {
+   *   id: cryptoFactory.generateUserId(),
+   *   ...
+   * }
+   * ```
+   */
+  generateUserId() {
+    return this._generators.userId.generateRandomSelfValidate();
+  }
+  /**
+   * Verify a user ID without token.
+   * @param userId The user ID to verify.
+   * @returns A boolean indicating whether the user ID is valid.
+   * @example
+   * ```typescript
+   * if (!cryptoFactory.verifyUserId(user.id)) {
+   *   throw new Error('invalid_user');
+   * }
+   * ```
+   */
+  verifyUserId(userId) {
+    return this._generators.userId.verifySelfValidate(userId);
+  }
+  /**
+   * Generate authentication token.
+   * @param uniquelyList The list of uniq values to generate the token from.
+   * @returns The generated user token.
+   * @example
+   * ```typescript
+   * const userToken = cryptoFactory.generateToken([user.id, user.lpe]);
+   * ```
+   */
+  generateToken(uniquelyList) {
+    return this._generators.token.generate(uniquelyList.join());
+  }
+  /**
+   * Verify a authentication token.
+   * @param uniquelyList The list of uniq values used to generate the token.
+   * @param token The user token to verify.
+   * @returns The validity of the token.
+   * @example
+   * ```typescript
+   * if (!cryptoFactory.verifyToken([user.id, user.lpe], userToken)) {
+   *   throw new Error('invalid_token');
+   * }
+   * ```
+   */
+  verifyToken(uniquelyList, token) {
+    return this._generators.token.verify(uniquelyList.join(), token);
+  }
+  /**
+   * Generate self-verifiable secret.
+   * @returns The generated secret.
+   * @example
+   * ```typescript
+   * const config = {
+   *   storageToken: cryptoFactory.generateSecret(),
+   *   ...
+   * }
+   * ```
+   */
+  generateSecret() {
+    return this._generators.secret.generateRandomSelfValidate();
+  }
+  /**
+   * Verify a secret.
+   * @param secret The secret to verify.
+   * @returns A boolean indicating whether the secret is valid.
+   * @example
+   * ```typescript
+   * if (!cryptoFactory.verifySecret(config.storageToken)) {
+   *   throw new Error('invalid_secret');
+   * }
+   * ```
+   */
+  verifySecret(secret) {
+    return this._generators.secret.verifySelfValidate(secret);
+  }
+  /**
+   * Generate self-verifiable device ID.
+   * @returns The generated device ID.
+   * @example
+   * ```typescript
+   * const deviceId = deviceFactory.generateDeviceId();
+   * ```
+   */
+  generateDeviceId() {
+    return this._generators.deviceId.generateRandomSelfValidate();
+  }
+  /**
+   * Verify a device ID.
+   * @param deviceId The device ID to verify.
+   * @returns A boolean indicating whether the device ID is valid.
+   * @example
+   * ```typescript
+   * if (!deviceFactory.verifyDeviceId(bodyJson.deviceId)) {
+   *   throw {
+   *    ok: false,
+   *    status: 400,
+   *    error: 'invalid_device_id',
+   *   }
+   * }
+   * ```
+   */
+  verifyDeviceId(deviceId) {
+    return this._generators.deviceId.verifySelfValidate(deviceId);
+  }
+};
+export {
+  AlwatrCryptoFactory,
+  AlwatrHashGenerator,
+  AlwatrTokenGenerator,
+  deviceIdGeneratorRecommendedConfig,
+  secretGeneratorRecommendedConfig,
+  userIdGeneratorRecommendedConfig,
+  userTokenGeneratorRecommendedConfig
+};
+/*! For license information please see main.mjs.LEGAL.txt */
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/hash.ts", "../src/token.ts", "../src/pre-config.ts", "../src/api.ts", "../src/main.ts"],
-  "sourcesContent": ["import {createHash, randomBytes, type BinaryLike} from 'node:crypto';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\n/**\n * Represents the configuration for a hash generator.\n */\nexport interface HashGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The length of the CRC (Cyclic Redundancy Check) value.\n   */\n  crcLength: number;\n}\n\n/**\n * Secure **self-validate** hash generator.\n */\nexport class AlwatrHashGenerator {\n  /**\n   * Creates a new instance of the AlwatrHashGenerator class.\n   * @param config The configuration for the hash generator.\n   */\n  constructor(public config: HashGeneratorConfig) {}\n\n  /**\n   * Generate a random hash.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const clientId = hashGenerator.generateRandom();\n   * ```\n   */\n  generateRandom(): string {\n    return this.generate(randomBytes(16));\n  }\n\n  /**\n   * Generate a **self-validate** random hash.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateRandomSelfValidate();\n   * ```\n   */\n  generateRandomSelfValidate(): string {\n    return this.generateSelfValidate(randomBytes(16));\n  }\n\n  /**\n   * Generate a hash from data.\n   * @param data - The data to generate the hash from.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const crcHash = hashGenerator.generate(data);\n   * ```\n   */\n  generate(data: BinaryLike): string {\n    return this.config.prefix + createHash(this.config.algorithm).update(data).digest(this.config.encoding);\n  }\n\n  /**\n   * Generate a crc hash.\n   * @param data - The data to generate the crc hash from.\n   * @returns The generated crc hash.\n   */\n  generateCrc(data: BinaryLike): string {\n    const crc = createHash('sha1').update(data).digest(this.config.encoding);\n    return this.config.crcLength == null || this.config.crcLength < 1 ? crc : crc.slice(0, this.config.crcLength);\n  }\n\n  /**\n   * Generate a **self-validate** hash from data.\n   * @param data - The data to generate the self-validated hash from.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateSelfValidate(data);\n   * ```\n   */\n  generateSelfValidate(data: BinaryLike): string {\n    const mainHash = this.generate(data);\n    const crcHash = this.generateCrc(mainHash);\n    return mainHash + crcHash;\n  }\n\n  /**\n   * Verify if the generated hash matches the provided hash.\n   * @param data - The data to verify.\n   * @param hash - The hash to compare against.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verify(data, hash)) {\n   *   new Error('data_corrupted');\n   * }\n   * ```\n   */\n  verify(data: BinaryLike, hash: string): boolean {\n    return hash === this.generate(data);\n  }\n\n  /**\n   * Verify a **self-validate** hash to check if it was generated by this class (with the same options).\n   * @param hash - The self-validated hash to verify.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verifySelfValidate(hash)) {\n   *   new Error('invalid_hash');\n   * }\n   * ```\n   */\n  verifySelfValidate(hash: string): boolean {\n    const gapPos = hash.length - this.config.crcLength;\n    const mainHash = hash.slice(0, gapPos);\n    const crcHash = hash.slice(gapPos);\n    return crcHash === this.generateCrc(mainHash);\n  }\n}\n", "import {createHmac} from 'node:crypto';\n\nimport {parseDuration, type DurationString} from '@alwatr/parse-duration';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\nexport type TokenValidity = 'valid' | 'invalid' | 'expired';\n\n/**\n * Represents the configuration for a token generator.\n */\nexport interface TokenGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: DurationString | 'infinite';\n}\n\n/**\n * Secure authentication HOTP token generator (HMAC-based One-Time Password algorithm).\n */\nexport class AlwatrTokenGenerator {\n  private _duration: number;\n\n  /**\n   * The current epoch based on the configured duration.\n   */\n  protected get _epoch(): number {\n    return this._duration == 0 ? 0 : Math.floor(Date.now() / this._duration);\n  }\n\n  /**\n   * Creates a new instance of AlwatrTokenGenerator.\n   * @param config The configuration for the token generator.\n   */\n  constructor(public config: TokenGeneratorConfig) {\n    this._duration = config.duration == 'infinite' ? 0 : parseDuration(config.duration);\n  }\n\n  /**\n   * Generates a HOTP token based on the provided data for special duration.\n   * @param data The data to generate the token from.\n   * @returns The generated token.\n   * @example\n   * ```typescript\n   * user.auth = tokenGenerator.generate(`${user.id}-${user.role}`);\n   * ```\n   */\n  generate(data: string): string {\n    return this._generate(data, this._epoch);\n  }\n\n  /**\n   * Verifies if a token is valid.\n   * @param data The data used to generate the token.\n   * @param token The token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * const validateStatus = tokenGenerator.verify([user.id,user.role].join(), user.auth);\n   * ```\n   */\n  verify(data: string, token: string): TokenValidity {\n    const epoch = this._epoch;\n    if (token === this._generate(data, epoch)) return 'valid';\n    if (this._duration == 0) return 'invalid';\n    if (token === this._generate(data, epoch - 1)) return 'expired';\n    return 'invalid';\n  }\n\n  /**\n   * Generates a cryptographic token based on the provided data and epoch.\n   * @param data - The data to be used in the token generation.\n   * @param epoch - The epoch value to be used in the token generation.\n   * @returns The generated cryptographic token.\n   */\n  protected _generate(data: string, epoch: number): string {\n    return (\n      this.config.prefix +\n      createHmac(this.config.algorithm, data)\n        .update(data + epoch)\n        .digest(this.config.encoding)\n    );\n  }\n}\n", "import type {HashGeneratorConfig} from './hash.js';\nimport type {TokenGeneratorConfig} from './token.js';\n\n/**\n * Alwatr hash generator recommended configuration for making random self-validate **user-id**.\n */\nexport const userIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 'u',\n  algorithm: 'sha1',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Hash generator recommended configuration for making random self-validate **device-id**.\n */\nexport const deviceIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  ...userIdGeneratorRecommendedConfig,\n  prefix: 'd',\n};\n\n/**\n * Hash generator pre configuration for making random self-validate **secrets**.\n */\nexport const secretGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 's',\n  algorithm: 'sha384',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Token generator recommended configuration for making secure self-validate **user-token**.\n */\nexport const userTokenGeneratorRecommendedConfig: Omit<TokenGeneratorConfig, 'secret' | 'duration'> = {\n  prefix: 't',\n  algorithm: 'sha224',\n  encoding: 'base64url',\n};\n", "import {AlwatrHashGenerator} from './hash.js';\nimport {\n  deviceIdGeneratorRecommendedConfig,\n  secretGeneratorRecommendedConfig,\n  userIdGeneratorRecommendedConfig,\n  userTokenGeneratorRecommendedConfig,\n} from './pre-config.js';\nimport {AlwatrTokenGenerator, type TokenValidity} from './token.js';\n\nimport type {DurationString} from '@alwatr/parse-duration';\n\n/**\n * Configuration options for the CryptoFactory.\n */\nexport interface CryptoFactoryConfig {\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: DurationString | 'infinite';\n}\n\n/**\n * Crypto factory for generating self-validate user-id, user-token, secret, device-id.\n */\nexport class AlwatrCryptoFactory {\n  protected _generators;\n\n  /**\n   * Creates a new instance of crypto factory.\n   * @param config The configuration used to create the crypto factory.\n   */\n  constructor(config: CryptoFactoryConfig) {\n    this._generators = {\n      secret: new AlwatrHashGenerator(secretGeneratorRecommendedConfig),\n      deviceId: new AlwatrHashGenerator(deviceIdGeneratorRecommendedConfig),\n      userId: new AlwatrHashGenerator(userIdGeneratorRecommendedConfig),\n      token: new AlwatrTokenGenerator({\n        ...userTokenGeneratorRecommendedConfig,\n        ...config,\n      }),\n    } as const;\n  }\n\n  /**\n   * Generate self-verifiable user ID.\n   * @returns The generated user ID.\n   * @example\n   * ```typescript\n   * const newUser = {\n   *   id: cryptoFactory.generateUserId(),\n   *   ...\n   * }\n   * ```\n   */\n  generateUserId(): string {\n    return this._generators.userId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a user ID without token.\n   * @param userId The user ID to verify.\n   * @returns A boolean indicating whether the user ID is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyUserId(user.id)) {\n   *   throw new Error('invalid_user');\n   * }\n   * ```\n   */\n  verifyUserId(userId: string): boolean {\n    return this._generators.userId.verifySelfValidate(userId);\n  }\n\n  /**\n   * Generate authentication token.\n   * @param uniquelyList The list of uniq values to generate the token from.\n   * @returns The generated user token.\n   * @example\n   * ```typescript\n   * const userToken = cryptoFactory.generateToken([user.id, user.lpe]);\n   * ```\n   */\n  generateToken(uniquelyList: (string | number)[]): string {\n    return this._generators.token.generate(uniquelyList.join());\n  }\n\n  /**\n   * Verify a authentication token.\n   * @param uniquelyList The list of uniq values used to generate the token.\n   * @param token The user token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyToken([user.id, user.lpe], userToken)) {\n   *   throw new Error('invalid_token');\n   * }\n   * ```\n   */\n  verifyToken(uniquelyList: (string | number)[], token: string): TokenValidity {\n    return this._generators.token.verify(uniquelyList.join(), token);\n  }\n\n  /**\n   * Generate self-verifiable secret.\n   * @returns The generated secret.\n   * @example\n   * ```typescript\n   * const config = {\n   *   storageToken: cryptoFactory.generateSecret(),\n   *   ...\n   * }\n   * ```\n   */\n  generateSecret(): string {\n    return this._generators.secret.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a secret.\n   * @param secret The secret to verify.\n   * @returns A boolean indicating whether the secret is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifySecret(config.storageToken)) {\n   *   throw new Error('invalid_secret');\n   * }\n   * ```\n   */\n  verifySecret(secret: string): boolean {\n    return this._generators.secret.verifySelfValidate(secret);\n  }\n\n  /**\n   * Generate self-verifiable device ID.\n   * @returns The generated device ID.\n   * @example\n   * ```typescript\n   * const deviceId = deviceFactory.generateDeviceId();\n   * ```\n   */\n  generateDeviceId(): string {\n    return this._generators.deviceId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a device ID.\n   * @param deviceId The device ID to verify.\n   * @returns A boolean indicating whether the device ID is valid.\n   * @example\n   * ```typescript\n   * if (!deviceFactory.verifyDeviceId(bodyJson.deviceId)) {\n   *   throw {\n   *    ok: false,\n   *    status: 400,\n   *    error: 'invalid_device_id',\n   *   }\n   * }\n   * ```\n   */\n  verifyDeviceId(deviceId: string): boolean {\n    return this._generators.deviceId.verifySelfValidate(deviceId);\n  }\n}\n", "import {definePackage} from '@alwatr/logger';\n\nimport type {} from '@alwatr/nano-build';\n\nexport * from './hash.js';\nexport * from './token.js';\nexport * from './api.js';\nexport * from './type.js';\nexport * from './pre-config.js';\n\ndefinePackage('@alwatr/crypto', __package_version__);\n"],
-  "mappings": "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",
-  "names": ["createHash", "randomBytes", "AlwatrHashGenerator", "config", "data", "crc", "mainHash", "crcHash", "hash", "gapPos", "createHmac", "parseDuration", "AlwatrTokenGenerator", "config", "data", "token", "epoch", "userIdGeneratorRecommendedConfig", "deviceIdGeneratorRecommendedConfig", "secretGeneratorRecommendedConfig", "userTokenGeneratorRecommendedConfig", "AlwatrCryptoFactory", "config", "AlwatrHashGenerator", "secretGeneratorRecommendedConfig", "deviceIdGeneratorRecommendedConfig", "userIdGeneratorRecommendedConfig", "AlwatrTokenGenerator", "userTokenGeneratorRecommendedConfig", "userId", "uniquelyList", "token", "secret", "deviceId", "definePackage"]
+  "sources": ["../src/hash.ts", "../src/token.ts", "../src/api.ts", "../src/pre-config.ts"],
+  "sourcesContent": ["import {createHash, randomBytes, type BinaryLike} from 'node:crypto';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\n/**\n * Represents the configuration for a hash generator.\n */\nexport interface HashGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The length of the CRC (Cyclic Redundancy Check) value.\n   */\n  crcLength: number;\n}\n\n/**\n * Secure **self-validate** hash generator.\n */\nexport class AlwatrHashGenerator {\n  /**\n   * Creates a new instance of the AlwatrHashGenerator class.\n   * @param config The configuration for the hash generator.\n   */\n  constructor(public config: HashGeneratorConfig) {}\n\n  /**\n   * Generate a random hash.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const clientId = hashGenerator.generateRandom();\n   * ```\n   */\n  generateRandom(): string {\n    return this.generate(randomBytes(16));\n  }\n\n  /**\n   * Generate a **self-validate** random hash.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateRandomSelfValidate();\n   * ```\n   */\n  generateRandomSelfValidate(): string {\n    return this.generateSelfValidate(randomBytes(16));\n  }\n\n  /**\n   * Generate a hash from data.\n   * @param data - The data to generate the hash from.\n   * @returns The generated hash.\n   * @example\n   * ```typescript\n   * const crcHash = hashGenerator.generate(data);\n   * ```\n   */\n  generate(data: BinaryLike): string {\n    return this.config.prefix + createHash(this.config.algorithm).update(data).digest(this.config.encoding);\n  }\n\n  /**\n   * Generate a crc hash.\n   * @param data - The data to generate the crc hash from.\n   * @returns The generated crc hash.\n   */\n  generateCrc(data: BinaryLike): string {\n    const crc = createHash('sha1').update(data).digest(this.config.encoding);\n    return this.config.crcLength == null || this.config.crcLength < 1 ? crc : crc.slice(0, this.config.crcLength);\n  }\n\n  /**\n   * Generate a **self-validate** hash from data.\n   * @param data - The data to generate the self-validated hash from.\n   * @returns The generated self-validated hash.\n   * @example\n   * ```typescript\n   * const userId = hashGenerator.generateSelfValidate(data);\n   * ```\n   */\n  generateSelfValidate(data: BinaryLike): string {\n    const mainHash = this.generate(data);\n    const crcHash = this.generateCrc(mainHash);\n    return mainHash + crcHash;\n  }\n\n  /**\n   * Verify if the generated hash matches the provided hash.\n   * @param data - The data to verify.\n   * @param hash - The hash to compare against.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verify(data, hash)) {\n   *   new Error('data_corrupted');\n   * }\n   * ```\n   */\n  verify(data: BinaryLike, hash: string): boolean {\n    return hash === this.generate(data);\n  }\n\n  /**\n   * Verify a **self-validate** hash to check if it was generated by this class (with the same options).\n   * @param hash - The self-validated hash to verify.\n   * @returns `true` if the hash is verified, `false` otherwise.\n   * @example\n   * ```typescript\n   * if (!hashGenerator.verifySelfValidate(hash)) {\n   *   new Error('invalid_hash');\n   * }\n   * ```\n   */\n  verifySelfValidate(hash: string): boolean {\n    const gapPos = hash.length - this.config.crcLength;\n    const mainHash = hash.slice(0, gapPos);\n    const crcHash = hash.slice(gapPos);\n    return crcHash === this.generateCrc(mainHash);\n  }\n}\n", "import {createHmac} from 'node:crypto';\n\nimport {parseDuration, type Duration} from '@alwatr/nanolib';\n\nimport type {CryptoAlgorithm, CryptoEncoding} from './type.js';\n\nexport type TokenValidity = 'valid' | 'invalid' | 'expired';\n\n/**\n * Represents the configuration for a token generator.\n */\nexport interface TokenGeneratorConfig {\n  /**\n   * The prefix to be added to the generated hash.\n   */\n  prefix: string;\n\n  /**\n   * The algorithm used for hashing.\n   */\n  algorithm: CryptoAlgorithm;\n\n  /**\n   * The encoding used for the generated hash.\n   */\n  encoding: CryptoEncoding;\n\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: Duration | 'infinite';\n}\n\n/**\n * Secure authentication HOTP token generator (HMAC-based One-Time Password algorithm).\n */\nexport class AlwatrTokenGenerator {\n  private _duration: number;\n\n  /**\n   * The current epoch based on the configured duration.\n   */\n  protected get _epoch(): number {\n    return this._duration == 0 ? 0 : Math.floor(Date.now() / this._duration);\n  }\n\n  /**\n   * Creates a new instance of AlwatrTokenGenerator.\n   * @param config The configuration for the token generator.\n   */\n  constructor(public config: TokenGeneratorConfig) {\n    this._duration = config.duration == 'infinite' ? 0 : parseDuration(config.duration);\n  }\n\n  /**\n   * Generates a HOTP token based on the provided data for special duration.\n   * @param data The data to generate the token from.\n   * @returns The generated token.\n   * @example\n   * ```typescript\n   * user.auth = tokenGenerator.generate(`${user.id}-${user.role}`);\n   * ```\n   */\n  generate(data: string): string {\n    return this._generate(data, this._epoch);\n  }\n\n  /**\n   * Verifies if a token is valid.\n   * @param data The data used to generate the token.\n   * @param token The token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * const validateStatus = tokenGenerator.verify([user.id,user.role].join(), user.auth);\n   * ```\n   */\n  verify(data: string, token: string): TokenValidity {\n    const epoch = this._epoch;\n    if (token === this._generate(data, epoch)) return 'valid';\n    if (this._duration == 0) return 'invalid';\n    if (token === this._generate(data, epoch - 1)) return 'expired';\n    return 'invalid';\n  }\n\n  /**\n   * Generates a cryptographic token based on the provided data and epoch.\n   * @param data - The data to be used in the token generation.\n   * @param epoch - The epoch value to be used in the token generation.\n   * @returns The generated cryptographic token.\n   */\n  protected _generate(data: string, epoch: number): string {\n    return (\n      this.config.prefix +\n      createHmac(this.config.algorithm, data)\n        .update(data + epoch)\n        .digest(this.config.encoding)\n    );\n  }\n}\n", "import {packageTracer, type Duration} from '@alwatr/nanolib';\n\nimport {AlwatrHashGenerator} from './hash.js';\nimport {\n  deviceIdGeneratorRecommendedConfig,\n  secretGeneratorRecommendedConfig,\n  userIdGeneratorRecommendedConfig,\n  userTokenGeneratorRecommendedConfig,\n} from './pre-config.js';\nimport {AlwatrTokenGenerator, type TokenValidity} from './token.js';\n\n__dev_mode__:  packageTracer.add(__package_name__, __package_version__);\n\n/**\n * Configuration options for the CryptoFactory.\n */\nexport interface CryptoFactoryConfig {\n  /**\n   * The secret used for encryption and decryption tokens.\n   */\n  secret: string;\n\n  /**\n   * The duration for which the token is valid.\n   */\n  duration: Duration | 'infinite';\n}\n\n/**\n * Crypto factory for generating self-validate user-id, user-token, secret, device-id.\n */\nexport class AlwatrCryptoFactory {\n  protected _generators;\n\n  /**\n   * Creates a new instance of crypto factory.\n   * @param config The configuration used to create the crypto factory.\n   */\n  constructor(config: CryptoFactoryConfig) {\n    this._generators = {\n      secret: new AlwatrHashGenerator(secretGeneratorRecommendedConfig),\n      deviceId: new AlwatrHashGenerator(deviceIdGeneratorRecommendedConfig),\n      userId: new AlwatrHashGenerator(userIdGeneratorRecommendedConfig),\n      token: new AlwatrTokenGenerator({\n        ...userTokenGeneratorRecommendedConfig,\n        ...config,\n      }),\n    } as const;\n  }\n\n  /**\n   * Generate self-verifiable user ID.\n   * @returns The generated user ID.\n   * @example\n   * ```typescript\n   * const newUser = {\n   *   id: cryptoFactory.generateUserId(),\n   *   ...\n   * }\n   * ```\n   */\n  generateUserId(): string {\n    return this._generators.userId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a user ID without token.\n   * @param userId The user ID to verify.\n   * @returns A boolean indicating whether the user ID is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyUserId(user.id)) {\n   *   throw new Error('invalid_user');\n   * }\n   * ```\n   */\n  verifyUserId(userId: string): boolean {\n    return this._generators.userId.verifySelfValidate(userId);\n  }\n\n  /**\n   * Generate authentication token.\n   * @param uniquelyList The list of uniq values to generate the token from.\n   * @returns The generated user token.\n   * @example\n   * ```typescript\n   * const userToken = cryptoFactory.generateToken([user.id, user.lpe]);\n   * ```\n   */\n  generateToken(uniquelyList: (string | number)[]): string {\n    return this._generators.token.generate(uniquelyList.join());\n  }\n\n  /**\n   * Verify a authentication token.\n   * @param uniquelyList The list of uniq values used to generate the token.\n   * @param token The user token to verify.\n   * @returns The validity of the token.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifyToken([user.id, user.lpe], userToken)) {\n   *   throw new Error('invalid_token');\n   * }\n   * ```\n   */\n  verifyToken(uniquelyList: (string | number)[], token: string): TokenValidity {\n    return this._generators.token.verify(uniquelyList.join(), token);\n  }\n\n  /**\n   * Generate self-verifiable secret.\n   * @returns The generated secret.\n   * @example\n   * ```typescript\n   * const config = {\n   *   storageToken: cryptoFactory.generateSecret(),\n   *   ...\n   * }\n   * ```\n   */\n  generateSecret(): string {\n    return this._generators.secret.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a secret.\n   * @param secret The secret to verify.\n   * @returns A boolean indicating whether the secret is valid.\n   * @example\n   * ```typescript\n   * if (!cryptoFactory.verifySecret(config.storageToken)) {\n   *   throw new Error('invalid_secret');\n   * }\n   * ```\n   */\n  verifySecret(secret: string): boolean {\n    return this._generators.secret.verifySelfValidate(secret);\n  }\n\n  /**\n   * Generate self-verifiable device ID.\n   * @returns The generated device ID.\n   * @example\n   * ```typescript\n   * const deviceId = deviceFactory.generateDeviceId();\n   * ```\n   */\n  generateDeviceId(): string {\n    return this._generators.deviceId.generateRandomSelfValidate();\n  }\n\n  /**\n   * Verify a device ID.\n   * @param deviceId The device ID to verify.\n   * @returns A boolean indicating whether the device ID is valid.\n   * @example\n   * ```typescript\n   * if (!deviceFactory.verifyDeviceId(bodyJson.deviceId)) {\n   *   throw {\n   *    ok: false,\n   *    status: 400,\n   *    error: 'invalid_device_id',\n   *   }\n   * }\n   * ```\n   */\n  verifyDeviceId(deviceId: string): boolean {\n    return this._generators.deviceId.verifySelfValidate(deviceId);\n  }\n}\n", "import type {HashGeneratorConfig} from './hash.js';\nimport type {TokenGeneratorConfig} from './token.js';\n\n/**\n * Alwatr hash generator recommended configuration for making random self-validate **user-id**.\n */\nexport const userIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 'u',\n  algorithm: 'sha1',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Hash generator recommended configuration for making random self-validate **device-id**.\n */\nexport const deviceIdGeneratorRecommendedConfig: HashGeneratorConfig = {\n  ...userIdGeneratorRecommendedConfig,\n  prefix: 'd',\n};\n\n/**\n * Hash generator pre configuration for making random self-validate **secrets**.\n */\nexport const secretGeneratorRecommendedConfig: HashGeneratorConfig = {\n  prefix: 's',\n  algorithm: 'sha384',\n  encoding: 'base64url',\n  crcLength: 4,\n};\n\n/**\n * Token generator recommended configuration for making secure self-validate **user-token**.\n */\nexport const userTokenGeneratorRecommendedConfig: Omit<TokenGeneratorConfig, 'secret' | 'duration'> = {\n  prefix: 't',\n  algorithm: 'sha224',\n  encoding: 'base64url',\n};\n"],
+  "mappings": ";;;AAAA,SAAQ,YAAY,mBAAmC;AAgChD,IAAM,sBAAN,MAA0B;AAAA;AAAA;AAAA;AAAA;AAAA,EAK/B,YAAmB,QAA6B;AAA7B;AAAA,EAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUjD,iBAAyB;AACvB,WAAO,KAAK,SAAS,YAAY,EAAE,CAAC;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,6BAAqC;AACnC,WAAO,KAAK,qBAAqB,YAAY,EAAE,CAAC;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,SAAS,MAA0B;AACjC,WAAO,KAAK,OAAO,SAAS,WAAW,KAAK,OAAO,SAAS,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK,OAAO,QAAQ;AAAA,EACxG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,MAA0B;AACpC,UAAM,MAAM,WAAW,MAAM,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK,OAAO,QAAQ;AACvE,WAAO,KAAK,OAAO,aAAa,QAAQ,KAAK,OAAO,YAAY,IAAI,MAAM,IAAI,MAAM,GAAG,KAAK,OAAO,SAAS;AAAA,EAC9G;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,qBAAqB,MAA0B;AAC7C,UAAM,WAAW,KAAK,SAAS,IAAI;AACnC,UAAM,UAAU,KAAK,YAAY,QAAQ;AACzC,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,OAAO,MAAkB,MAAuB;AAC9C,WAAO,SAAS,KAAK,SAAS,IAAI;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,mBAAmB,MAAuB;AACxC,UAAM,SAAS,KAAK,SAAS,KAAK,OAAO;AACzC,UAAM,WAAW,KAAK,MAAM,GAAG,MAAM;AACrC,UAAM,UAAU,KAAK,MAAM,MAAM;AACjC,WAAO,YAAY,KAAK,YAAY,QAAQ;AAAA,EAC9C;AACF;;;ACtIA,SAAQ,kBAAiB;AAEzB,SAAQ,qBAAmC;AAuCpC,IAAM,uBAAN,MAA2B;AAAA;AAAA;AAAA;AAAA;AAAA,EAchC,YAAmB,QAA8B;AAA9B;AACjB,SAAK,YAAY,OAAO,YAAY,aAAa,IAAI,cAAc,OAAO,QAAQ;AAAA,EACpF;AAAA;AAAA;AAAA;AAAA,EAVA,IAAc,SAAiB;AAC7B,WAAO,KAAK,aAAa,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,IAAI,KAAK,SAAS;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,SAAS,MAAsB;AAC7B,WAAO,KAAK,UAAU,MAAM,KAAK,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAO,MAAc,OAA8B;AACjD,UAAM,QAAQ,KAAK;AACnB,QAAI,UAAU,KAAK,UAAU,MAAM,KAAK,EAAG,QAAO;AAClD,QAAI,KAAK,aAAa,EAAG,QAAO;AAChC,QAAI,UAAU,KAAK,UAAU,MAAM,QAAQ,CAAC,EAAG,QAAO;AACtD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQU,UAAU,MAAc,OAAuB;AACvD,WACE,KAAK,OAAO,SACZ,WAAW,KAAK,OAAO,WAAW,IAAI,EACnC,OAAO,OAAO,KAAK,EACnB,OAAO,KAAK,OAAO,QAAQ;AAAA,EAElC;AACF;;;ACxGA,SAAQ,qBAAmC;;;ACMpC,IAAM,mCAAwD;AAAA,EACnE,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,UAAU;AAAA,EACV,WAAW;AACb;AAKO,IAAM,qCAA0D;AAAA,EACrE,GAAG;AAAA,EACH,QAAQ;AACV;AAKO,IAAM,mCAAwD;AAAA,EACnE,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,UAAU;AAAA,EACV,WAAW;AACb;AAKO,IAAM,sCAAyF;AAAA,EACpG,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,UAAU;AACZ;;;AD3BA,aAAe,eAAc,IAAI,kBAAkB,OAAmB;AAoB/D,IAAM,sBAAN,MAA0B;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/B,YAAY,QAA6B;AACvC,SAAK,cAAc;AAAA,MACjB,QAAQ,IAAI,oBAAoB,gCAAgC;AAAA,MAChE,UAAU,IAAI,oBAAoB,kCAAkC;AAAA,MACpE,QAAQ,IAAI,oBAAoB,gCAAgC;AAAA,MAChE,OAAO,IAAI,qBAAqB;AAAA,QAC9B,GAAG;AAAA,QACH,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,iBAAyB;AACvB,WAAO,KAAK,YAAY,OAAO,2BAA2B;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,aAAa,QAAyB;AACpC,WAAO,KAAK,YAAY,OAAO,mBAAmB,MAAM;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,cAAc,cAA2C;AACvD,WAAO,KAAK,YAAY,MAAM,SAAS,aAAa,KAAK,CAAC;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,YAAY,cAAmC,OAA8B;AAC3E,WAAO,KAAK,YAAY,MAAM,OAAO,aAAa,KAAK,GAAG,KAAK;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,iBAAyB;AACvB,WAAO,KAAK,YAAY,OAAO,2BAA2B;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,aAAa,QAAyB;AACpC,WAAO,KAAK,YAAY,OAAO,mBAAmB,MAAM;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,mBAA2B;AACzB,WAAO,KAAK,YAAY,SAAS,2BAA2B;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,eAAe,UAA2B;AACxC,WAAO,KAAK,YAAY,SAAS,mBAAmB,QAAQ;AAAA,EAC9D;AACF;",
+  "names": []
 }

package/dist/token.d.ts

@@ -1,4 +1,4 @@
-import { type DurationString } from '@alwatr/parse-duration';
+import { type Duration } from '@alwatr/nanolib';
 import type { CryptoAlgorithm, CryptoEncoding } from './type.js';
 export type TokenValidity = 'valid' | 'invalid' | 'expired';
 /**
@@ -24,7 +24,7 @@ export interface TokenGeneratorConfig {
     /**
      * The duration for which the token is valid.
      */
-    duration: DurationString | 'infinite';
+    duration: Duration | 'infinite';
 }
 /**
  * Secure authentication HOTP token generator (HMAC-based One-Time Password algorithm).

package/dist/token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAC,eAAe,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,cAAc,GAAG,UAAU,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAcZ,MAAM,EAAE,oBAAoB;IAb/C,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACH,SAAS,KAAK,MAAM,IAAI,MAAM,CAE7B;IAED;;;OAGG;gBACgB,MAAM,EAAE,oBAAoB;IAI/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAQlD;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAQzD"}
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAC,eAAe,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAcZ,MAAM,EAAE,oBAAoB;IAb/C,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACH,SAAS,KAAK,MAAM,IAAI,MAAM,CAE7B;IAED;;;OAGG;gBACgB,MAAM,EAAE,oBAAoB;IAI/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAQlD;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAQzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwatr/crypto",
-  "version": "4.2.1",
+  "version": "4.3.0",
   "description": "A robust generator of secure authentication HOTP tokens, employing the HMAC-based One-Time Password algorithm, accompanied by a suite of cryptographic utilities, all encapsulated within a compact TypeScript module.",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "keywords": [
@@ -31,7 +31,7 @@
       "require": "./dist/main.cjs"
     }
   },
-  "license": "MIT",
+  "license": "AGPL-3.0-only",
   "files": [
     "**/*.{js,mjs,cjs,map,d.ts,html,md}",
     "!demo/**/*"
@@ -66,17 +66,16 @@
     "clean": "rm -rfv dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@alwatr/logger": "^3.2.14",
-    "@alwatr/parse-duration": "^1.0.11"
+    "@alwatr/nanolib": "^1.2.0"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^1.3.10",
-    "@alwatr/prettier-config": "^1.0.4",
-    "@alwatr/tsconfig-base": "^1.2.0",
-    "@alwatr/type-helper": "^1.2.6",
-    "@types/node": "^22.6.1",
+    "@alwatr/nano-build": "^2.0.1",
+    "@alwatr/prettier-config": "^1.0.6",
+    "@alwatr/tsconfig-base": "^1.3.2",
+    "@alwatr/type-helper": "^2.0.2",
+    "@types/node": "^22.7.5",
     "jest": "^29.7.0",
-    "typescript": "^5.6.2"
+    "typescript": "^5.6.3"
   },
-  "gitHead": "b4a2982e438591723fc4a19ce004cf2938b01971"
+  "gitHead": "5dd04b482d18bc8160ead9003f1d518512a62a8e"
 }