nduka 1.0.0

package/dist/security/tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester.js","sourceRoot":"","sources":["../../src/security/tester.ts"],"names":[],"mappings":"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"}

package/dist/self-improvement/index.d.ts

@@ -0,0 +1,2 @@
+export * from './trace-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/self-improvement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/self-improvement/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/self-improvement/index.js

@@ -0,0 +1,2 @@
+export * from './trace-store.js';
+//# sourceMappingURL=index.js.map

package/dist/self-improvement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/self-improvement/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/self-improvement/trace-store.d.ts

@@ -0,0 +1,27 @@
+export type SelfImprovementTraceKind = 'planner_decision' | 'plan_rejected' | 'async_job_failure' | 'tool_followup_resolution' | 'tool_execution_result' | 'runtime_regression_candidate';
+export interface StoreSelfImprovementTraceInput {
+    kind: SelfImprovementTraceKind;
+    chatJid?: string;
+    correlationId?: string;
+    summary: string;
+    payload?: Record<string, unknown>;
+    createdAt?: number;
+}
+export interface SelfImprovementTraceRecord {
+    traceId: string;
+    kind: SelfImprovementTraceKind;
+    chatJid: string | null;
+    correlationId: string | null;
+    summary: string;
+    payload: Record<string, unknown>;
+    createdAt: number;
+}
+export declare class SelfImprovementTraceStore {
+    private db;
+    private initialized;
+    constructor();
+    private init;
+    store(input: StoreSelfImprovementTraceInput): SelfImprovementTraceRecord;
+    listRecent(kind?: SelfImprovementTraceKind, limit?: number): SelfImprovementTraceRecord[];
+}
+//# sourceMappingURL=trace-store.d.ts.map

package/dist/self-improvement/trace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.d.ts","sourceRoot":"","sources":["../../src/self-improvement/trace-store.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,wBAAwB,GAChC,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,0BAA0B,GAC1B,uBAAuB,GACvB,8BAA8B,CAAC;AAEnC,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAsDD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,WAAW,CAAS;;IAM5B,OAAO,CAAC,IAAI;IAmBZ,KAAK,CAAC,KAAK,EAAE,8BAA8B,GAAG,0BAA0B;IAuBxE,UAAU,CAAC,IAAI,CAAC,EAAE,wBAAwB,EAAE,KAAK,SAAK,GAAG,0BAA0B,EAAE;CAOtF"}

package/dist/self-improvement/trace-store.js

@@ -0,0 +1,88 @@
+import { randomUUID } from 'node:crypto';
+import { DatabaseManager } from '../database/index.js';
+const SENSITIVE_KEYS = /secret|token|api[_-]?key|password|auth|cookie|credential/i;
+function traceId() {
+    return `trace_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
+}
+function cleanText(value, maxLength) {
+    const cleaned = (value || '').replace(/\s+/g, ' ').trim();
+    return cleaned ? cleaned.slice(0, maxLength) : null;
+}
+function redact(value) {
+    if (Array.isArray(value))
+        return value.map(redact);
+    if (!value || typeof value !== 'object')
+        return value;
+    const output = {};
+    for (const [key, inner] of Object.entries(value)) {
+        output[key] = SENSITIVE_KEYS.test(key) ? '[REDACTED]' : redact(inner);
+    }
+    return output;
+}
+function parsePayload(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function mapRow(row) {
+    return {
+        traceId: row.trace_id,
+        kind: row.kind,
+        chatJid: row.chat_jid,
+        correlationId: row.correlation_id,
+        summary: row.summary,
+        payload: parsePayload(row.payload_json),
+        createdAt: row.created_at,
+    };
+}
+export class SelfImprovementTraceStore {
+    db = DatabaseManager.getInstance();
+    initialized = false;
+    constructor() {
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        this.db.getDb().exec(`
+      CREATE TABLE IF NOT EXISTS self_improvement_traces (
+        trace_id TEXT PRIMARY KEY NOT NULL,
+        kind TEXT NOT NULL,
+        chat_jid TEXT,
+        correlation_id TEXT,
+        summary TEXT NOT NULL,
+        payload_json TEXT NOT NULL DEFAULT '{}',
+        created_at INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_self_improvement_traces_kind ON self_improvement_traces(kind, created_at);
+      CREATE INDEX IF NOT EXISTS idx_self_improvement_traces_correlation ON self_improvement_traces(correlation_id);
+    `);
+        this.initialized = true;
+    }
+    store(input) {
+        const id = traceId();
+        const summary = cleanText(input.summary, 1000);
+        if (!summary)
+            throw new Error('Self-improvement trace requires a summary.');
+        const createdAt = input.createdAt || Date.now();
+        const payload = redact(input.payload || {});
+        this.db.getDb().prepare(`
+      INSERT INTO self_improvement_traces (trace_id, kind, chat_jid, correlation_id, summary, payload_json, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(id, input.kind, cleanText(input.chatJid, 300), cleanText(input.correlationId, 120), summary, JSON.stringify(payload), createdAt);
+        return { traceId: id, kind: input.kind, chatJid: input.chatJid || null, correlationId: input.correlationId || null, summary, payload, createdAt };
+    }
+    listRecent(kind, limit = 20) {
+        const boundedLimit = Math.max(1, Math.min(limit, 100));
+        const rows = kind
+            ? this.db.getDb().prepare(`SELECT * FROM self_improvement_traces WHERE kind = ? ORDER BY created_at DESC LIMIT ?`).all(kind, boundedLimit)
+            : this.db.getDb().prepare(`SELECT * FROM self_improvement_traces ORDER BY created_at DESC LIMIT ?`).all(boundedLimit);
+        return rows.map(mapRow);
+    }
+}
+//# sourceMappingURL=trace-store.js.map

package/dist/self-improvement/trace-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.js","sourceRoot":"","sources":["../../src/self-improvement/trace-store.ts"],"names":[],"mappings":"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"}

package/dist/session/index.d.ts

@@ -0,0 +1,9 @@
+export { SessionManager } from './manager.js';
+export type { SessionHealth, SessionMetadata } from './manager.js';
+export { SessionValidator } from './validator.js';
+export type { ValidationResult, ValidationError, ValidationWarning } from './validator.js';
+export { SessionSnapshotService } from './snapshot.js';
+export type { Snapshot, SnapshotList } from './snapshot.js';
+export { SessionRecoveryService } from './recovery.js';
+export type { RecoveryAction, RecoveryDecision, RecoveryConfig } from './recovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,5 @@
+export { SessionManager } from './manager.js';
+export { SessionValidator } from './validator.js';
+export { SessionSnapshotService } from './snapshot.js';
+export { SessionRecoveryService } from './recovery.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,65 @@
+import type { AuthenticationCreds } from '@whiskeysockets/baileys';
+/** Session metadata stored alongside auth state. */
+export interface SessionMetadata {
+    version: number;
+    createdAt: string;
+    lastRotatedAt: string | null;
+    deviceCount: number;
+    reLinkCount: number;
+    gatewayId: string;
+    integrityHash: string;
+}
+export interface SessionHealth {
+    healthy: boolean;
+    issues: string[];
+    version: number;
+    lastCheck: Date;
+    ownerPid: number | null;
+    ownerStartedAt: string | null;
+    isLocked: boolean;
+}
+export declare class SessionManager {
+    private processId;
+    private gatewayId;
+    private version;
+    private isOwner;
+    constructor();
+    /**
+     * Acquire session ownership.
+     * Returns true if this process becomes the session owner.
+     * Returns false if another process already owns the session.
+     */
+    acquireOwnership(): boolean;
+    /** Release session ownership. */
+    releaseOwnership(): void;
+    /** Check if this process owns the session. */
+    get ownsSession(): boolean;
+    /** Increment session version (call on credential changes). */
+    incrementVersion(): number;
+    /** Get current session version. */
+    getVersion(): number;
+    /** Record a device re-link event. Does not destroy historical data. */
+    recordReLink(): void;
+    /** Record credential rotation. */
+    recordCredentialRotation(): void;
+    /** Get device re-link count. */
+    getReLinkCount(): number;
+    /**
+     * Compute an integrity hash of the current credentials.
+     * Used to detect corruption by comparing against stored hash.
+     */
+    computeCredentialHash(creds: AuthenticationCreds): string;
+    /** Store integrity hash. */
+    storeIntegrityHash(hash: string): void;
+    /** Get stored integrity hash. */
+    getStoredIntegrityHash(): string | null;
+    /** Get current session health status. */
+    getHealth(): SessionHealth;
+    private isLockStale;
+    private updateLockVersion;
+    private loadMetadata;
+    private loadMetadataRaw;
+    private saveMetadataRaw;
+    private saveMetadata;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAYnE,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAUD,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;;IAQxB;;;;OAIG;IACH,gBAAgB,IAAI,OAAO;IAoD3B,iCAAiC;IACjC,gBAAgB,IAAI,IAAI;IAiBxB,8CAA8C;IAC9C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,8DAA8D;IAC9D,gBAAgB,IAAI,MAAM;IAO1B,mCAAmC;IACnC,UAAU,IAAI,MAAM;IAMpB,uEAAuE;IACvE,YAAY,IAAI,IAAI;IAQpB,kCAAkC;IAClC,wBAAwB,IAAI,IAAI;IAQhC,gCAAgC;IAChC,cAAc,IAAI,MAAM;IAMxB;;;OAGG;IACH,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM;IAkBzD,4BAA4B;IAC5B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtC,iCAAiC;IACjC,sBAAsB,IAAI,MAAM,GAAG,IAAI;IAMvC,yCAAyC;IACzC,SAAS,IAAI,aAAa;IAoC1B,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,YAAY;CAKrB"}

package/dist/session/manager.js

@@ -0,0 +1,265 @@
+/**
+ * Session Manager
+ *
+ * Enforces single ownership of the WhatsApp auth session.
+ * Multiple gateways must never share the same auth state.
+ *
+ * Features:
+ *  - Lock-based ownership enforcement (prevents dual-ownership corruption)
+ *  - Session versioning (monotonic counter for tracking changes)
+ *  - Multi-device synchronization support
+ *  - Credential rotation handling
+ *  - Device re-linking without destroying historical data
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync, } from 'node:fs';
+import { dirname } from 'node:path';
+// ─── Config ──────────────────────────────────────────────────────────────────
+const LOCK_FILE = process.env.SESSION_LOCK_FILE || './data/session.lock';
+const META_FILE = process.env.SESSION_META_FILE || './data/session_meta.json';
+const LOCK_STALE_MS = 60_000; // Lock considered stale after 60s
+// ─── Session Manager ─────────────────────────────────────────────────────────
+export class SessionManager {
+    processId;
+    gatewayId;
+    version;
+    isOwner = false;
+    constructor() {
+        this.processId = process.pid;
+        this.gatewayId = `${process.pid}_${randomUUID().slice(0, 8)}`;
+        this.version = 1;
+    }
+    /**
+     * Acquire session ownership.
+     * Returns true if this process becomes the session owner.
+     * Returns false if another process already owns the session.
+     */
+    acquireOwnership() {
+        // Ensure data directory exists
+        const dir = dirname(LOCK_FILE);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Check existing lock
+        if (existsSync(LOCK_FILE)) {
+            try {
+                const raw = readFileSync(LOCK_FILE, 'utf-8');
+                const lock = JSON.parse(raw);
+                // Check if existing lock is stale
+                if (this.isLockStale(lock)) {
+                    // Stale lock — take over
+                    console.warn(`[SessionManager] Stale lock from PID ${lock.processId} — taking over`);
+                }
+                else if (lock.processId !== this.processId) {
+                    // Another live process owns the session
+                    console.error(`[SessionManager] Session owned by PID ${lock.processId} (started ${lock.startedAt})`);
+                    return false;
+                }
+            }
+            catch {
+                // Corrupt lock file — take over
+                console.warn('[SessionManager] Corrupt lock file — taking over');
+            }
+        }
+        // Write lock
+        const lock = {
+            processId: this.processId,
+            startedAt: new Date().toISOString(),
+            gatewayId: this.gatewayId,
+            version: this.version,
+        };
+        writeFileSync(LOCK_FILE, JSON.stringify(lock, null, 2), 'utf-8');
+        this.isOwner = true;
+        // Load or create metadata
+        this.loadMetadata();
+        console.log(`[SessionManager] Ownership acquired (PID ${this.processId}, v${this.version})`);
+        return true;
+    }
+    /** Release session ownership. */
+    releaseOwnership() {
+        if (!this.isOwner)
+            return;
+        try {
+            if (existsSync(LOCK_FILE)) {
+                const raw = readFileSync(LOCK_FILE, 'utf-8');
+                const lock = JSON.parse(raw);
+                if (lock.processId === this.processId) {
+                    unlinkSync(LOCK_FILE);
+                }
+            }
+        }
+        catch (err) {
+            console.error('[SessionManager] Failed to release lock:', err.message);
+        }
+        this.isOwner = false;
+    }
+    /** Check if this process owns the session. */
+    get ownsSession() {
+        return this.isOwner;
+    }
+    // ─── Versioning ──────────────────────────────────────────────────────────
+    /** Increment session version (call on credential changes). */
+    incrementVersion() {
+        this.version++;
+        this.updateLockVersion();
+        this.saveMetadata();
+        return this.version;
+    }
+    /** Get current session version. */
+    getVersion() {
+        return this.version;
+    }
+    // ─── Device Management ──────────────────────────────────────────────────
+    /** Record a device re-link event. Does not destroy historical data. */
+    recordReLink() {
+        const meta = this.loadMetadataRaw();
+        meta.reLinkCount = (meta.reLinkCount || 0) + 1;
+        meta.version = this.version;
+        this.saveMetadataRaw(meta);
+        this.incrementVersion();
+    }
+    /** Record credential rotation. */
+    recordCredentialRotation() {
+        const meta = this.loadMetadataRaw();
+        meta.lastRotatedAt = new Date().toISOString();
+        meta.version = this.version;
+        this.saveMetadataRaw(meta);
+        this.incrementVersion();
+    }
+    /** Get device re-link count. */
+    getReLinkCount() {
+        return this.loadMetadataRaw().reLinkCount || 0;
+    }
+    // ─── Integrity ──────────────────────────────────────────────────────────
+    /**
+     * Compute an integrity hash of the current credentials.
+     * Used to detect corruption by comparing against stored hash.
+     */
+    computeCredentialHash(creds) {
+        // Hash key fields that must remain intact
+        const fields = {
+            me: creds.me?.id,
+            noiseKeyPublic: creds.noiseKey?.public
+                ? Buffer.from(creds.noiseKey.public).toString('base64').slice(0, 20)
+                : 'none',
+            registrationId: creds.registrationId,
+            registered: creds.registered,
+            accountSyncCounter: creds.accountSyncCounter,
+        };
+        return createHash('sha256')
+            .update(JSON.stringify(fields))
+            .digest('hex')
+            .slice(0, 16);
+    }
+    /** Store integrity hash. */
+    storeIntegrityHash(hash) {
+        const meta = this.loadMetadataRaw();
+        meta.integrityHash = hash;
+        this.saveMetadataRaw(meta);
+    }
+    /** Get stored integrity hash. */
+    getStoredIntegrityHash() {
+        return this.loadMetadataRaw().integrityHash || null;
+    }
+    // ─── Health ─────────────────────────────────────────────────────────────
+    /** Get current session health status. */
+    getHealth() {
+        const issues = [];
+        if (!this.isOwner) {
+            issues.push('not_owner');
+        }
+        if (!existsSync(LOCK_FILE)) {
+            issues.push('no_lock_file');
+        }
+        else {
+            try {
+                const raw = readFileSync(LOCK_FILE, 'utf-8');
+                const lock = JSON.parse(raw);
+                if (lock.processId !== this.processId) {
+                    issues.push('owned_by_other_process');
+                }
+            }
+            catch {
+                issues.push('corrupt_lock_file');
+            }
+        }
+        const meta = this.loadMetadataRaw();
+        return {
+            healthy: issues.length === 0 && this.isOwner,
+            issues,
+            version: meta.version || 1,
+            lastCheck: new Date(),
+            ownerPid: this.isOwner ? this.processId : null,
+            ownerStartedAt: this.isOwner ? new Date().toISOString() : null,
+            isLocked: existsSync(LOCK_FILE),
+        };
+    }
+    // ─── Private ────────────────────────────────────────────────────────────
+    isLockStale(lock) {
+        try {
+            const startedAt = new Date(lock.startedAt).getTime();
+            return Date.now() - startedAt > LOCK_STALE_MS;
+        }
+        catch {
+            return true;
+        }
+    }
+    updateLockVersion() {
+        if (!this.isOwner || !existsSync(LOCK_FILE))
+            return;
+        try {
+            const raw = readFileSync(LOCK_FILE, 'utf-8');
+            const lock = JSON.parse(raw);
+            lock.version = this.version;
+            writeFileSync(LOCK_FILE, JSON.stringify(lock, null, 2), 'utf-8');
+        }
+        catch {
+            // Lock file may have been removed
+        }
+    }
+    loadMetadata() {
+        const meta = this.loadMetadataRaw();
+        this.version = meta.version || 1;
+    }
+    loadMetadataRaw() {
+        if (!existsSync(META_FILE)) {
+            const meta = {
+                version: 1,
+                createdAt: new Date().toISOString(),
+                lastRotatedAt: null,
+                deviceCount: 1,
+                reLinkCount: 0,
+                gatewayId: this.gatewayId,
+                integrityHash: '',
+            };
+            this.saveMetadataRaw(meta);
+            return meta;
+        }
+        try {
+            return JSON.parse(readFileSync(META_FILE, 'utf-8'));
+        }
+        catch {
+            return {
+                version: 1,
+                createdAt: new Date().toISOString(),
+                lastRotatedAt: null,
+                deviceCount: 1,
+                reLinkCount: 0,
+                gatewayId: this.gatewayId,
+                integrityHash: '',
+            };
+        }
+    }
+    saveMetadataRaw(meta) {
+        const dir = dirname(META_FILE);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(META_FILE, JSON.stringify(meta, null, 2), 'utf-8');
+    }
+    saveMetadata() {
+        const meta = this.loadMetadataRaw();
+        meta.version = this.version;
+        this.saveMetadataRaw(meta);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"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"}

package/dist/session/recovery.d.ts

@@ -0,0 +1,44 @@
+import { SingleFileAuthStore } from '../gateway/auth/store.js';
+import { SessionSnapshotService, type Snapshot } from './snapshot.js';
+export type RecoveryAction = 'retry_reconnect' | 'reload_credentials' | 'rollback_snapshot' | 'trigger_repair' | 'give_up';
+export interface RecoveryDecision {
+    action: RecoveryAction;
+    reason: string;
+    delayMs: number;
+    retryCount: number;
+}
+export interface RecoveryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    reloadAfterRetries: number;
+    rollbackAfterRetries: number;
+}
+export interface SnapshotRestoreResult {
+    success: boolean;
+    restoredFrom?: string;
+    error?: string;
+}
+export declare class SessionRecoveryService {
+    private config;
+    private validator;
+    private snapshotService;
+    private authStore;
+    private retryCount;
+    private onRepairNeeded;
+    constructor(authStore: SingleFileAuthStore, snapshotService?: SessionSnapshotService, config?: Partial<RecoveryConfig>);
+    constructor(authFilePath: string, snapshotDir?: string, config?: Partial<RecoveryConfig>);
+    onRepairNeededCallback(callback: () => void): void;
+    backupCurrentSession(): Snapshot | null;
+    restoreFromSnapshot(snapshotId: string): SnapshotRestoreResult;
+    decideRecovery(disconnectReason: string, statusCode?: number): RecoveryDecision;
+    executeRecovery(decision: RecoveryDecision): Promise<boolean>;
+    private reloadCredentials;
+    private rollbackToSnapshot;
+    validateBeforeConnect(): Promise<boolean>;
+    reset(): void;
+    private isFreshPairingState;
+    private calculateDelay;
+    private extractStatusCode;
+}
+//# sourceMappingURL=recovery.d.ts.map

package/dist/session/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/session/recovery.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE3H,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAA6B;gBAEvC,SAAS,EAAE,mBAAmB,EAAE,eAAe,CAAC,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;gBAC1G,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAcxF,sBAAsB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAElD,oBAAoB,IAAI,QAAQ,GAAG,IAAI;IAOvC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB;IAU9D,cAAc,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAYzE,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnE,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,kBAAkB;IAapB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IAyB/C,KAAK,IAAI,IAAI;IAEb,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,iBAAiB;CAgB1B"}