@agirails/sdk 2.0.0 → 2.0.1-beta

package/dist/utils/NonceManager.d.ts

@@ -1,267 +1,34 @@
-/**
- * Nonce Manager Implementation
- * Tracks nonces per DID + message type for AIP-4 delivery proofs
- * Reference: AIP-4 §3.2 (nonce field requirement)
- *
- * SECURITY FIXES:
- * - C-2: Added atomic nonce allocation with locking
- * - H-1: Added persistent nonce storage option
- * - H-5: Added nonce upper bound validation
- */
-/**
- * Maximum allowed nonce value.
- * SECURITY FIX (H-5): Prevents nonce overflow attacks.
- * Using Number.MAX_SAFE_INTEGER (2^53 - 1) to ensure safe JavaScript integer operations.
- */
-export declare const MAX_NONCE_VALUE: number;
-/**
- * Nonce Manager Interface (from DeliveryProofBuilder)
- */
 export interface NonceManager {
-    /**
-     * Get next nonce for message type
-     * @param messageType - Message type identifier (e.g., "agirails.delivery.v1")
-     * @returns Monotonically increasing nonce
-     */
     getNextNonce(messageType: string): number;
-    /**
-     * Record nonce usage
-     * @param messageType - Message type identifier
-     * @param nonce - Nonce used
-     */
     recordNonce(messageType: string, nonce: number): void;
-    /**
-     * Get current nonce (last used)
-     * @param messageType - Message type identifier
-     * @returns Current nonce or 0 if none used
-     */
     getCurrentNonce(messageType: string): number;
-    /**
-     * Reset nonce for message type
-     * @param messageType - Message type identifier
-     */
     resetNonce(messageType: string): void;
 }
-/**
- * In-Memory Nonce Manager
- * Simple implementation using Map for per-message-type nonce tracking
- *
- * SECURITY FIXES:
- * - C-2: Added atomic getAndIncrementNonce() to prevent race conditions
- * - H-5: Added nonce upper bound validation
- *
- * ⚠️ WARNING: Nonces are lost on process restart. For production:
- * - Use persistent storage (Redis, PostgreSQL, etc.)
- * - Implement nonce recovery from blockchain events
- * - Add DID-scoped nonce tracking
- */
 export declare class InMemoryNonceManager implements NonceManager {
     private nonces;
-    private locks;
-    /**
-     * Create in-memory nonce manager
-     * @param initialNonces - Optional initial nonce values (for recovery)
-     */
     constructor(initialNonces?: Record<string, number>);
-    /**
-     * SECURITY FIX (C-2 + DEADLOCK-FIX): Acquire lock for message type
-     * Ensures atomic nonce operations.
-     *
-     * FIXED: Previous implementation had a deadlock bug where:
-     * - The resolver was stored in a closure but never accessible to releaseLock()
-     * - releaseLock() just deleted the entry without resolving waiting Promises
-     *
-     * New implementation stores both promise AND resolver together.
-     */
-    private acquireLock;
-    /**
-     * SECURITY FIX (C-2 + DEADLOCK-FIX): Release lock for message type
-     *
-     * FIXED: Now properly resolves the Promise before deleting,
-     * so any waiting acquireLock() calls can proceed.
-     */
-    private releaseLock;
-    /**
-     * Get next nonce for message type
-     * @param messageType - Message type identifier
-     * @returns Monotonically increasing nonce
-     */
     getNextNonce(messageType: string): number;
-    /**
-     * SECURITY FIX (C-2): Atomic get-and-increment nonce
-     * Returns the next nonce and records it atomically to prevent race conditions.
-     *
-     * @param messageType - Message type identifier
-     * @returns Atomically allocated nonce
-     */
-    getAndIncrementNonce(messageType: string): Promise<number>;
-    /**
-     * Record nonce usage
-     * @param messageType - Message type identifier
-     * @param nonce - Nonce used
-     */
     recordNonce(messageType: string, nonce: number): void;
-    /**
-     * Get current nonce (last used)
-     * @param messageType - Message type identifier
-     * @returns Current nonce or 0 if none used
-     */
     getCurrentNonce(messageType: string): number;
-    /**
-     * Reset nonce for message type
-     * @param messageType - Message type identifier
-     */
     resetNonce(messageType: string): void;
-    /**
-     * Get all nonces (for persistence)
-     * @returns Record of all message type nonces
-     */
     getAllNonces(): Record<string, number>;
-    /**
-     * Clear all nonces
-     */
     clearAll(): void;
 }
-/**
- * DID-Scoped Nonce Manager
- * Tracks nonces per DID + message type combination
- * Recommended for multi-agent scenarios
- */
 export declare class DIDScopedNonceManager implements NonceManager {
     private nonces;
     private currentDID;
-    /**
-     * Create DID-scoped nonce manager
-     * @param did - DID to track nonces for
-     * @param initialNonces - Optional initial nonce values
-     */
     constructor(did: string, initialNonces?: Record<string, number>);
-    /**
-     * Get next nonce for message type (current DID)
-     * @param messageType - Message type identifier
-     * @returns Monotonically increasing nonce
-     */
     getNextNonce(messageType: string): number;
-    /**
-     * Record nonce usage (current DID)
-     * @param messageType - Message type identifier
-     * @param nonce - Nonce used
-     */
     recordNonce(messageType: string, nonce: number): void;
-    /**
-     * Get current nonce (current DID)
-     * @param messageType - Message type identifier
-     * @returns Current nonce or 0 if none used
-     */
     getCurrentNonce(messageType: string): number;
-    /**
-     * Reset nonce for message type (current DID)
-     * @param messageType - Message type identifier
-     */
     resetNonce(messageType: string): void;
-    /**
-     * Get next nonce for specific DID + message type
-     * @param did - DID identifier
-     * @param messageType - Message type identifier
-     * @returns Monotonically increasing nonce
-     */
     getNextNonceForDID(did: string, messageType: string): number;
-    /**
-     * Record nonce usage for specific DID + message type
-     * @param did - DID identifier
-     * @param messageType - Message type identifier
-     * @param nonce - Nonce used
-     */
     recordNonceForDID(did: string, messageType: string, nonce: number): void;
-    /**
-     * Get current nonce for specific DID + message type
-     * @param did - DID identifier
-     * @param messageType - Message type identifier
-     * @returns Current nonce or 0 if none used
-     */
     getCurrentNonceForDID(did: string, messageType: string): number;
-    /**
-     * Reset nonce for specific DID + message type
-     * @param did - DID identifier
-     * @param messageType - Message type identifier
-     */
     resetNonceForDID(did: string, messageType: string): void;
-    /**
-     * Switch current DID context
-     * @param did - New DID to track
-     */
     switchDID(did: string): void;
-    /**
-     * Get all nonces for all DIDs (for persistence)
-     * @returns Nested record of DID → message type → nonce
-     */
     getAllNonces(): Record<string, Record<string, number>>;
-    /**
-     * Clear all nonces for all DIDs
-     */
     clearAll(): void;
 }
-/**
- * File-based Nonce Manager for Persistent Storage
- *
- * SECURITY FIX (H-1): Persists nonces to disk to survive process restarts.
- * SECURITY FIX (NEW-H-4): File locking to prevent concurrent write corruption.
- * Uses atomic file writes (temp file + rename) for crash safety.
- *
- * @module utils/NonceManager
- */
-export declare class FileBasedNonceManager implements NonceManager {
-    private inMemory;
-    private filePath;
-    private fs;
-    private path;
-    private lockfile;
-    /**
-     * Create file-based nonce manager
-     * @param stateDirectory - Directory to store nonces file
-     */
-    constructor(stateDirectory: string);
-    /**
-     * Load nonces from file
-     */
-    private loadFromFile;
-    /**
-     * Save nonces to file atomically with file locking
-     *
-     * SECURITY FIX (NEW-H-4): File locking prevents concurrent write corruption
-     */
-    private saveToFile;
-    getNextNonce(messageType: string): number;
-    /**
-     * Atomic get and increment with persistence
-     */
-    getAndIncrementNonce(messageType: string): Promise<number>;
-    recordNonce(messageType: string, nonce: number): void;
-    getCurrentNonce(messageType: string): number;
-    resetNonce(messageType: string): void;
-    getAllNonces(): Record<string, number>;
-    clearAll(): void;
-}
-/**
- * Create nonce manager based on environment
- * @param options - Configuration options
- * @returns NonceManager instance
- *
- * @example
- * ```typescript
- * // In-memory (default)
- * const manager = createNonceManager();
- *
- * // DID-scoped
- * const manager = createNonceManager({ did: 'did:ethr:0x...' });
- *
- * // Persistent (survives restarts)
- * const manager = createNonceManager({ stateDirectory: '/path/to/project' });
- * ```
- */
-export declare function createNonceManager(options?: {
-    did?: string;
-    initialNonces?: Record<string, number>;
-    stateDirectory?: string;
-}): NonceManager;
+export declare function createNonceManager(did?: string, initialNonces?: Record<string, number>): NonceManager;
 //# sourceMappingURL=NonceManager.d.ts.map

package/dist/utils/NonceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NonceManager.d.ts","sourceRoot":"","sources":["../../src/utils/NonceManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAA0B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtD;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,MAAM,CAAkC;IAGhD,OAAO,CAAC,KAAK,CAA2E;IAExF;;;OAGG;gBACS,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAclD;;;;;;;;;OASG;YACW,WAAW;IAiBzB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAezC;;;;;;OAMG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBhE;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAoBrD;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI5C;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIrC;;;OAGG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAItC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;gBACS,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAY/D;;;;OAIG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIzC;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrD;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI5C;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAS5D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAoBxE;;;;;OAKG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAK/D;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAOxD;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUtD;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,EAAE,CAAsB;IAChC,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,QAAQ,CAAmC;IAEnD;;;OAGG;gBACS,cAAc,EAAE,MAAM;IAiBlC;;OAEG;IACH,OAAO,CAAC,YAAY;IA4BpB;;;;OAIG;YACW,UAAU;IA8CxB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOhE,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQrD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI5C,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQrC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAItC,QAAQ,IAAI,IAAI;CAMjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,YAAY,CAWd"}
+{"version":3,"file":"NonceManager.d.ts","sourceRoot":"","sources":["../../src/utils/NonceManager.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAM3B,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAO1C,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAOtD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAM7C,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAWD,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,MAAM,CAAkC;gBAMpC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAalD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAUzC,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBrD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ5C,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQrC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOtC,QAAQ,IAAI,IAAI;CAGjB;AAOD,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,UAAU,CAAS;gBAOf,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiB/D,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IASzC,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASrD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ5C,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAUrC,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAe5D,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA0BxE,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAU/D,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAWxD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAatD,QAAQ,IAAI,IAAI;CAGjB;AAQD,wBAAgB,kBAAkB,CAChC,GAAG,CAAC,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,YAAY,CAKd"}