xypriss-security 2.0.9 → 2.1.1

package/dist/src/types/PasswordManagerOptions.d.ts

@@ -0,0 +1,142 @@
+import { PasswordHashOptions } from ".";
+/**
+ * Constructor options for `PasswordManager`.
+ * These become the permanent defaults for every `hash()` and `verify()` call.
+ */
+export interface PasswordManagerOptions extends PasswordHashOptions {
+    /**
+     * Hashing algorithm to use.
+     * @default "argon2id"
+     */
+    algorithm?: "argon2id" | "scrypt" | "pbkdf2" | string;
+    /**
+     * Memory cost in KiB (Argon2id).
+     * Higher = more resistant to brute-force at the cost of RAM.
+     * @default 65536 (64 MiB)
+     */
+    memoryCost?: number;
+    /**
+     * Number of time iterations (Argon2id / PBKDF2).
+     * @default 3
+     */
+    iterations?: number;
+    /**
+     * Degree of parallelism / thread count (Argon2id).
+     * @default 4
+     */
+    parallelism?: number;
+    /**
+     * Secret pepper appended to every password before hashing.
+     * Store separately from the database (e.g., an environment variable).
+     */
+    pepper?: string;
+}
+/**
+ * Criteria for generating a secure random password.
+ */
+export interface PasswordGenerateOptions {
+    /**
+     * Total length of the generated password.
+     * Must be between 8 and 512 inclusive.
+     * @default 20
+     */
+    length?: number;
+    /** Include uppercase letters (A-Z). @default true */
+    uppercase?: boolean;
+    /** Include lowercase letters (a-z). @default true */
+    lowercase?: boolean;
+    /** Include digits (0-9). @default true */
+    numbers?: boolean;
+    /** Include special symbols. @default true */
+    symbols?: boolean;
+    /** Remove visually similar characters (e.g. 0, O, l, 1). @default false */
+    excludeSimilar?: boolean;
+    /**
+     * Custom characters to inject into the password (guarantee at least one
+     * occurrence of each char in this string).
+     * Extra chars are *injected* at random positions, not appended.
+     */
+    extra?: string;
+}
+/**
+ * Criteria for generating a memorable passphrase.
+ */
+export interface PassphraseOptions {
+    /**
+     * Number of words in the passphrase.
+     * Must be between 3 and 20 inclusive.
+     * @default 5
+     */
+    wordCount?: number;
+    /** Word separator. @default "-" */
+    separator?: string;
+    /** Capitalize the first letter of each word. @default true */
+    capitalize?: boolean;
+    /**
+     * Append a random number block at the end (e.g. "-4827").
+     * Significantly increases entropy.
+     * @default true
+     */
+    appendNumbers?: boolean;
+    /**
+     * EFF wordlist variant to use.
+     * - `"large"` (default): 7 776 words, ~12.9 bits/word
+     * - `"short1"`: 1 296 words, ~10.3 bits/word
+     * - `"short2"`: 1 296 words, ~10.3 bits/word (uniquely decodable)
+     * @default "large"
+     */
+    variant?: "large" | "short1" | "short2";
+    /**
+     * Directory containing the EFF `.txt` wordlist files.
+     * Defaults to the `src/mods/` directory bundled with the package.
+     */
+    dir?: string;
+    /**
+     * Custom file path to an EFF-formatted wordlist.
+     * Takes precedence over `dir` + `variant`.
+     */
+    filePath?: string;
+    /**
+     * Fallback behaviour if the EFF file cannot be loaded.
+     * - `"silent"` (default): use built-in 256-word list silently.
+     * - `"warn"`: use built-in list but print a console warning.
+     * - `false`: throw an error instead of falling back.
+     * @default "silent"
+     */
+    allowFallback?: "silent" | "warn" | false;
+}
+/**
+ * Result of a password strength analysis.
+ */
+export interface PasswordStrengthResult {
+    /** Score from 0 (very weak) to 100 (extremely strong). */
+    score: number;
+    /** Human-readable label. */
+    label: "very-weak" | "weak" | "fair" | "strong" | "very-strong";
+    /** Specific improvement suggestions. */
+    suggestions: string[];
+    /** Detailed breakdown of the analysis. */
+    analysis: {
+        length: number;
+        hasUppercase: boolean;
+        hasLowercase: boolean;
+        hasNumbers: boolean;
+        hasSymbols: boolean;
+        hasRepeats: boolean;
+        hasSequences: boolean;
+        entropy: number;
+    };
+}
+/**
+ * Result of a HaveIBeenPwned breach check.
+ */
+export interface BreachCheckResult {
+    /** Whether the password was found in any known breach corpus. */
+    breached: boolean;
+    /**
+     * Number of times the password appeared across all known breaches.
+     * `0` means no match was found.
+     */
+    occurrences: number;
+}
+//# sourceMappingURL=PasswordManagerOptions.d.ts.map

package/dist/src/types/PasswordManagerOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordManagerOptions.d.ts","sourceRoot":"","sources":["../../../src/types/PasswordManagerOptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,GAAG,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEtD;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;IAChE,wCAAwC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/types/PasswordManagerOptions.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Types ────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PasswordManagerOptions.js.map

package/dist/src/types/PasswordManagerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordManagerOptions.js","sourceRoot":"","sources":["../../../src/types/PasswordManagerOptions.ts"],"names":[],"mappings":";AAAA,iFAAiF"}

package/dist/src/types/index.d.ts

@@ -5,7 +5,7 @@
  * XyPriss Security framework. It ensures consistent data structures and
  * type safety across all security-related operations.
  *
- * @author NEHONIX (iDevo - https://github.com/iDevo-ll)
+ * @author NEHONIX (Nehonix-Team - https://github.com/Nehonix-Team)
  * @license Nehonix Open Source License (NOSL)
  ****************************************************************************/
 /**

package/dist/src/types/index.js

@@ -6,7 +6,7 @@
  * XyPriss Security framework. It ensures consistent data structures and
  * type safety across all security-related operations.
  *
- * @author NEHONIX (iDevo - https://github.com/iDevo-ll)
+ * @author NEHONIX (Nehonix-Team - https://github.com/Nehonix-Team)
  * @license Nehonix Open Source License (NOSL)
  ****************************************************************************/
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/utils/CryptoAlgorithmUtils.d.ts

@@ -3,7 +3,7 @@
  *
  * Provides professional metadata and classification for supported algorithms.
  *
- * @author NEHONIX (iDevo - https://github.com/iDevo-ll)
+ * @author NEHONIX (Nehonix-Team - https://github.com/Nehonix-Team)
  * @license Nehonix Open Source License (NOSL)
  ****************************************************************************/
 import { AlgorithmInfo } from "../types";

package/dist/src/utils/CryptoAlgorithmUtils.js

@@ -4,7 +4,7 @@
  *
  * Provides professional metadata and classification for supported algorithms.
  *
- * @author NEHONIX (iDevo - https://github.com/iDevo-ll)
+ * @author NEHONIX (Nehonix-Team - https://github.com/Nehonix-Team)
  * @license Nehonix Open Source License (NOSL)
  ****************************************************************************/
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/utils/index.d.ts

@@ -1,7 +1,7 @@
 /***************************************************************************
  * XyPriss Security - Unified Utility Hub
  *
- * @author NEHONIX (iDevo - https://github.com/iDevo-ll)
+ * @author NEHONIX (Nehonix-Team - https://github.com/Nehonix-Team)
  * @license Nehonix Open Source License (NOSL)
  ****************************************************************************/
 export * from "./encoding";

package/dist/src/utils/index.js

@@ -2,7 +2,7 @@
 /***************************************************************************
  * XyPriss Security - Unified Utility Hub
  *
- * @author NEHONIX (iDevo - https://github.com/iDevo-ll)
+ * @author NEHONIX (Nehonix-Team - https://github.com/Nehonix-Team)
  * @license Nehonix Open Source License (NOSL)
  ****************************************************************************/
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xypriss-security",
-  "version": "2.0.9",
+  "version": "2.1.1",
   "description": "Advanced High-Performance Security Framework powered by a Go Core. Military-grade encryption, post-quantum resilience, and fortified data structures.",
   "author": {
     "name": "NEHONIX",
@@ -15,7 +15,7 @@
   "scripts": {
     "build": "xfpm run build:ts",
     "build:core": "node scripts/build-core.js",
-    "build:ts": "rimraf dist && tsc",
+    "build:ts": "rimraf dist && tsc && mkdir -p dist/src/mods && cp src/mods/*.txt dist/src/mods/",
     "build:release": "bash scripts/release-build.sh",
     "build:all": "npm run build && npm run build:release",
     "postinstall": "node scripts/build-core.js",