@meshwhisper/sdk 0.1.0

package/dist/persistence/idb-storage.d.ts

@@ -0,0 +1,27 @@
+import type { StorageBackend } from './types.js';
+/**
+ * IndexedDB-backed storage for MeshWhisper. Use this in browsers and PWAs.
+ *
+ * ```ts
+ * import { IDBStorage } from '@meshwhisper/sdk/browser';
+ *
+ * const mw = await MeshWhisper.init({
+ *   namespace: 'com.example.app',
+ *   storage: new IDBStorage('com.example.app'),
+ * });
+ * ```
+ *
+ * When `MeshWhisper.init()` is called in a browser without an explicit
+ * `storage` option, an `IDBStorage` is created automatically.
+ */
+export declare class IDBStorage implements StorageBackend {
+    private readonly namespace;
+    private dbPromise;
+    constructor(namespace?: string);
+    private getDB;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=idb-storage.d.ts.map

package/dist/persistence/idb-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-storage.d.ts","sourceRoot":"","sources":["../../src/persistence/idb-storage.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwBjD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAW,YAAW,cAAc;IAGnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,SAAS,CAAqC;gBAEzB,SAAS,GAAE,MAAkB;IAE1D,OAAO,CAAC,KAAK;IAOP,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAM9C"}

package/dist/persistence/idb-storage.js

@@ -0,0 +1,75 @@
+// ============================================================
+// MeshWhisper SDK — IndexedDB Storage Backend
+// Implements StorageBackend for browsers and PWAs using the
+// native IndexedDB API. No external dependencies.
+// ============================================================
+const DB_NAME = 'meshwhisper';
+const STORE_NAME = 'kv';
+const DB_VERSION = 1;
+function openDB(namespace) {
+    return new Promise((resolve, reject) => {
+        const req = indexedDB.open(`${DB_NAME}:${namespace}`, DB_VERSION);
+        req.onupgradeneeded = () => {
+            req.result.createObjectStore(STORE_NAME);
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+function request(req) {
+    return new Promise((resolve, reject) => {
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+/**
+ * IndexedDB-backed storage for MeshWhisper. Use this in browsers and PWAs.
+ *
+ * ```ts
+ * import { IDBStorage } from '@meshwhisper/sdk/browser';
+ *
+ * const mw = await MeshWhisper.init({
+ *   namespace: 'com.example.app',
+ *   storage: new IDBStorage('com.example.app'),
+ * });
+ * ```
+ *
+ * When `MeshWhisper.init()` is called in a browser without an explicit
+ * `storage` option, an `IDBStorage` is created automatically.
+ */
+export class IDBStorage {
+    namespace;
+    dbPromise = null;
+    constructor(namespace = 'default') {
+        this.namespace = namespace;
+    }
+    getDB() {
+        if (!this.dbPromise) {
+            this.dbPromise = openDB(this.namespace);
+        }
+        return this.dbPromise;
+    }
+    async get(key) {
+        const db = await this.getDB();
+        const tx = db.transaction(STORE_NAME, 'readonly');
+        const val = await request(tx.objectStore(STORE_NAME).get(key));
+        return val ?? null;
+    }
+    async set(key, value) {
+        const db = await this.getDB();
+        const tx = db.transaction(STORE_NAME, 'readwrite');
+        await request(tx.objectStore(STORE_NAME).put(value, key));
+    }
+    async delete(key) {
+        const db = await this.getDB();
+        const tx = db.transaction(STORE_NAME, 'readwrite');
+        await request(tx.objectStore(STORE_NAME).delete(key));
+    }
+    async keys(prefix) {
+        const db = await this.getDB();
+        const tx = db.transaction(STORE_NAME, 'readonly');
+        const allKeys = await request(tx.objectStore(STORE_NAME).getAllKeys());
+        return allKeys.filter((k) => k.startsWith(prefix));
+    }
+}
+//# sourceMappingURL=idb-storage.js.map

package/dist/persistence/idb-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-storage.js","sourceRoot":"","sources":["../../src/persistence/idb-storage.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8CAA8C;AAC9C,4DAA4D;AAC5D,kDAAkD;AAClD,+DAA+D;AAI/D,MAAM,OAAO,GAAG,aAAa,CAAC;AAC9B,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,SAAS,MAAM,CAAC,SAAiB;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;QAClE,GAAG,CAAC,eAAe,GAAG,GAAG,EAAE;YACzB,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC,CAAC;QACF,GAAG,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAI,GAAkB;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,GAAG,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,UAAU;IAGQ;IAFrB,SAAS,GAAgC,IAAI,CAAC;IAEtD,YAA6B,YAAoB,SAAS;QAA7B,cAAS,GAAT,SAAS,CAAoB;IAAG,CAAC;IAEtD,KAAK;QACX,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAqB,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACnF,OAAO,GAAG,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAgB,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QACtF,OAAQ,OAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/persistence/index.d.ts

@@ -0,0 +1,4 @@
+export type { StorageBackend, StoredMessage } from './types.js';
+export { NodeStorage } from './node-storage.js';
+export { serializeRatchetState, deserializeRatchetState } from './serialization.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/persistence/index.js

@@ -0,0 +1,3 @@
+export { NodeStorage } from './node-storage.js';
+export { serializeRatchetState, deserializeRatchetState } from './serialization.js';
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/persistence/node-storage.d.ts

@@ -0,0 +1,33 @@
+import type { StorageBackend } from './types.js';
+/**
+ * Node.js StorageBackend backed by the local filesystem.
+ *
+ * Usage:
+ * ```ts
+ * import { MeshWhisper } from '@meshwhisper/sdk';
+ * import { NodeStorage } from '@meshwhisper/sdk/persistence/node';
+ *
+ * const mw = await MeshWhisper.init({
+ *   namespace: 'com.example.myapp',
+ *   storage: new NodeStorage('./data/meshwhisper'),
+ * });
+ * ```
+ *
+ * Data layout under `dataDir/`:
+ *   identity          — hex-encoded Ed25519 private key
+ *   sessions/<id>     — serialized RatchetState (JSON)
+ *   peers/<id>        — hex-encoded X25519 public key
+ *   contacts          — JSON array of peer ID strings
+ *   messages/<id>     — JSON array of StoredMessage
+ *   seen_ids          — JSON array of { id, ts } for deduplication
+ */
+export declare class NodeStorage implements StorageBackend {
+    private readonly root;
+    constructor(dataDir: string);
+    private resolve;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(prefix: string): Promise<string[]>;
+}
+//# sourceMappingURL=node-storage.d.ts.map

package/dist/persistence/node-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-storage.d.ts","sourceRoot":"","sources":["../../src/persistence/node-storage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,OAAO,EAAE,MAAM;IAK3B,OAAO,CAAC,OAAO;IAWT,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAmB9C"}

package/dist/persistence/node-storage.js

@@ -0,0 +1,90 @@
+// ============================================================
+// MeshWhisper SDK — Node.js StorageBackend
+// Filesystem-based persistence using one file per key.
+// Files are written with mode 0600 (owner read/write only).
+// ============================================================
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Node.js StorageBackend backed by the local filesystem.
+ *
+ * Usage:
+ * ```ts
+ * import { MeshWhisper } from '@meshwhisper/sdk';
+ * import { NodeStorage } from '@meshwhisper/sdk/persistence/node';
+ *
+ * const mw = await MeshWhisper.init({
+ *   namespace: 'com.example.myapp',
+ *   storage: new NodeStorage('./data/meshwhisper'),
+ * });
+ * ```
+ *
+ * Data layout under `dataDir/`:
+ *   identity          — hex-encoded Ed25519 private key
+ *   sessions/<id>     — serialized RatchetState (JSON)
+ *   peers/<id>        — hex-encoded X25519 public key
+ *   contacts          — JSON array of peer ID strings
+ *   messages/<id>     — JSON array of StoredMessage
+ *   seen_ids          — JSON array of { id, ts } for deduplication
+ */
+export class NodeStorage {
+    root;
+    constructor(dataDir) {
+        this.root = path.resolve(dataDir);
+        fs.mkdirSync(this.root, { recursive: true });
+    }
+    resolve(key) {
+        // Sanitize: only allow alphanumeric, underscore, hyphen, forward slash, dot
+        const safe = key.replace(/[^a-zA-Z0-9/_.-]/g, '_');
+        const abs = path.join(this.root, safe);
+        // Guard against path traversal
+        if (!abs.startsWith(this.root + path.sep) && abs !== this.root) {
+            throw new Error(`Storage key escapes data directory: ${key}`);
+        }
+        return abs;
+    }
+    async get(key) {
+        try {
+            return fs.readFileSync(this.resolve(key), 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value) {
+        const filePath = this.resolve(key);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        // Write atomically: write to a temp file, then rename
+        const tmp = `${filePath}.tmp`;
+        fs.writeFileSync(tmp, value, { encoding: 'utf-8', mode: 0o600 });
+        fs.renameSync(tmp, filePath);
+    }
+    async delete(key) {
+        try {
+            fs.unlinkSync(this.resolve(key));
+        }
+        catch {
+            // File doesn't exist — fine
+        }
+    }
+    async keys(prefix) {
+        // Walk the directory corresponding to the prefix
+        const prefixPath = this.resolve(prefix);
+        // The prefix may itself be a directory (e.g. "sessions/") or a path fragment
+        const dir = prefix.endsWith('/') ? prefixPath : path.dirname(prefixPath);
+        const base = prefix.endsWith('/') ? '' : path.basename(prefixPath);
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            return entries
+                .filter((e) => e.isFile() && e.name.startsWith(base))
+                .map((e) => {
+                const rel = path.relative(this.root, path.join(dir, e.name));
+                return rel.replace(/\\/g, '/'); // normalise on Windows
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=node-storage.js.map

package/dist/persistence/node-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-storage.js","sourceRoot":"","sources":["../../src/persistence/node-storage.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,uDAAuD;AACvD,4DAA4D;AAC5D,+DAA+D;AAE/D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,WAAW;IACL,IAAI,CAAS;IAE9B,YAAY,OAAe;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAEO,OAAO,CAAC,GAAW;QACzB,4EAA4E;QAC5E,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,+BAA+B;QAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,sDAAsD;QACtD,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,6EAA6E;QAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,OAAO,OAAO;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;iBACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7D,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,uBAAuB;YACzD,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/persistence/serialization.d.ts

@@ -0,0 +1,4 @@
+import type { RatchetState } from '../ratchet/index.js';
+export declare function serializeRatchetState(state: RatchetState): string;
+export declare function deserializeRatchetState(json: string): RatchetState;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/persistence/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/persistence/serialization.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA8BxD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAiBjE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAmBlE"}

package/dist/persistence/serialization.js

@@ -0,0 +1,49 @@
+// ============================================================
+// MeshWhisper SDK — RatchetState serialization
+// Converts between the in-memory RatchetState and a JSON string
+// suitable for storage. All Uint8Array fields are hex-encoded.
+// ============================================================
+// ---- Helpers ----
+function toHex(bytes) {
+    return Buffer.from(bytes).toString('hex');
+}
+function fromHex(hex) {
+    return new Uint8Array(Buffer.from(hex, 'hex'));
+}
+// ---- Public API ----
+export function serializeRatchetState(state) {
+    const obj = {
+        v: 1,
+        dhSendingPriv: toHex(state.dhSending.privateKey),
+        dhSendingPub: toHex(state.dhSending.publicKey),
+        dhReceiving: state.dhReceiving ? toHex(state.dhReceiving) : null,
+        rootKey: toHex(state.rootKey),
+        sendingChainKey: state.sendingChainKey ? toHex(state.sendingChainKey) : null,
+        receivingChainKey: state.receivingChainKey ? toHex(state.receivingChainKey) : null,
+        sendMessageNumber: state.sendMessageNumber,
+        receiveMessageNumber: state.receiveMessageNumber,
+        previousSendingChainLength: state.previousSendingChainLength,
+        skippedMessageKeys: Object.fromEntries([...state.skippedMessageKeys.entries()].map(([k, v]) => [k, toHex(v)])),
+    };
+    return JSON.stringify(obj);
+}
+export function deserializeRatchetState(json) {
+    const obj = JSON.parse(json);
+    if (obj.v !== 1)
+        throw new Error(`Unknown RatchetState version: ${obj.v}`);
+    return {
+        dhSending: {
+            privateKey: fromHex(obj.dhSendingPriv),
+            publicKey: fromHex(obj.dhSendingPub),
+        },
+        dhReceiving: obj.dhReceiving ? fromHex(obj.dhReceiving) : null,
+        rootKey: fromHex(obj.rootKey),
+        sendingChainKey: obj.sendingChainKey ? fromHex(obj.sendingChainKey) : null,
+        receivingChainKey: obj.receivingChainKey ? fromHex(obj.receivingChainKey) : null,
+        sendMessageNumber: obj.sendMessageNumber,
+        receiveMessageNumber: obj.receiveMessageNumber,
+        previousSendingChainLength: obj.previousSendingChainLength,
+        skippedMessageKeys: new Map(Object.entries(obj.skippedMessageKeys).map(([k, v]) => [k, fromHex(v)])),
+    };
+}
+//# sourceMappingURL=serialization.js.map

package/dist/persistence/serialization.js.map

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

package/dist/persistence/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Minimal key-value storage interface. Implement this for your platform:
+ *   - Node.js:      NodeStorage (provided)
+ *   - React Native: AsyncStorage or SQLCipher wrapper
+ *   - Browser:      IndexedDB wrapper
+ *
+ * Values are always JSON strings. Keys use forward-slash namespacing:
+ *   identity, sessions/<peerId>, peers/<peerId>, contacts, messages/<peerId>, seen_ids
+ */
+export interface StorageBackend {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** Returns all stored keys that start with the given prefix. */
+    keys(prefix: string): Promise<string[]>;
+}
+export interface StoredMessage {
+    id: string;
+    /** The peer ID of the other party in this conversation. */
+    conversationId: string;
+    senderId: string;
+    recipientId: string;
+    /** Message payload as a plain number array (JSON-serialisable Uint8Array). */
+    payload: number[];
+    timestamp: number;
+    direction: 'inbound' | 'outbound';
+    status: 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/persistence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,gEAAgE;IAChE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC9D"}

package/dist/persistence/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// MeshWhisper SDK — Persistence Types
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sCAAsC;AACtC,+DAA+D"}

package/dist/ratchet/index.d.ts

@@ -0,0 +1,80 @@
+import type { KeyPair } from '../types.js';
+export interface RatchetHeader {
+    dhPublicKey: Uint8Array;
+    previousChainLength: number;
+    messageNumber: number;
+}
+export interface RatchetState {
+    dhSending: KeyPair;
+    dhReceiving: Uint8Array | null;
+    rootKey: Uint8Array;
+    sendingChainKey: Uint8Array | null;
+    receivingChainKey: Uint8Array | null;
+    sendMessageNumber: number;
+    receiveMessageNumber: number;
+    previousSendingChainLength: number;
+    skippedMessageKeys: Map<string, Uint8Array>;
+}
+/**
+ * KDF root step: derive a new root key and chain key from a root key and DH output.
+ * output = BLAKE3(rootKey || dhOutput, dkLen=64), split into two 32-byte halves.
+ */
+export declare function kdfRootStep(rootKey: Uint8Array, dhOutput: Uint8Array): {
+    newRootKey: Uint8Array;
+    chainKey: Uint8Array;
+};
+/**
+ * KDF chain step: derive a message key and the next chain key from the current chain key.
+ * messageKey  = BLAKE3(chainKey || 0x01)
+ * newChainKey = BLAKE3(chainKey || 0x02)
+ */
+export declare function kdfChainStep(chainKey: Uint8Array): {
+    newChainKey: Uint8Array;
+    messageKey: Uint8Array;
+};
+/**
+ * Perform a DH ratchet step: compute new root key / receiving chain key from the
+ * remote's new public key, then generate a new sending keypair and compute the
+ * sending chain key.
+ */
+export declare function dhRatchetStep(state: RatchetState, remotePublicKey: Uint8Array): RatchetState;
+/**
+ * Initialize the ratchet state as the sender (initiator) after X3DH.
+ *
+ * The sender knows the shared secret and the remote's signed pre-key (or ratchet public key).
+ * It performs the first DH ratchet step immediately so it can begin sending.
+ */
+export declare function initSender(sharedSecret: Uint8Array, remotePublicKey: Uint8Array): RatchetState;
+/**
+ * Initialize the ratchet state as the receiver (responder) after X3DH.
+ *
+ * The receiver provides its own keypair (the signed pre-key used in X3DH) and
+ * the shared secret. It waits for the first message to complete the DH ratchet.
+ */
+export declare function initReceiver(sharedSecret: Uint8Array, localKeyPair: KeyPair): RatchetState;
+/**
+ * Encrypt a plaintext message, advancing the sending chain.
+ *
+ * Returns the updated state, a header (to be sent alongside the ciphertext), and
+ * the AES-256-GCM ciphertext.
+ */
+export declare function ratchetEncrypt(state: RatchetState, plaintext: Uint8Array): {
+    state: RatchetState;
+    header: RatchetHeader;
+    ciphertext: Uint8Array;
+};
+/**
+ * Decrypt a received message, handling DH ratchet steps and out-of-order delivery.
+ *
+ * 1. Try skipped message keys first (for out-of-order messages).
+ * 2. If the header's DH public key differs from our stored remote key, perform
+ *    a DH ratchet step (advancing the root chain).
+ * 3. Advance the receiving chain to the header's message number, storing any
+ *    skipped message keys along the way.
+ * 4. Decrypt with the derived message key.
+ */
+export declare function ratchetDecrypt(state: RatchetState, header: RatchetHeader, ciphertext: Uint8Array): {
+    state: RatchetState;
+    plaintext: Uint8Array;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ratchet/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAU3C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,UAAU,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,UAAU,CAAC;IACpB,eAAe,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,iBAAiB,EAAE,UAAU,GAAG,IAAI,CAAC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC7C;AAkBD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,UAAU,GACnB;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,UAAU,GACnB;IAAE,WAAW,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAIrD;AAsDD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,UAAU,GAC1B,YAAY,CA6Bd;AA8BD;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,UAAU,EACxB,eAAe,EAAE,UAAU,GAC1B,YAAY,CAgBd;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,UAAU,EACxB,YAAY,EAAE,OAAO,GACpB,YAAY,CAYd;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,UAAU,GACpB;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAsBxE;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,UAAU,GACrB;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAgDhD"}