@agora-sdk/secure-chat-react-js 0.1.0 → 0.2.0

package/dist/cjs/crypto-web.js

@@ -32,6 +32,8 @@ function createWebSecureChatCrypto() {
         processProposal: notImplemented,
         exportGroupState: notImplemented,
         importGroupState: notImplemented,
+        exportDeviceState: notImplemented,
+        importDeviceState: notImplemented,
         exportBackup: notImplemented,
         importBackup: notImplemented,
     };

package/dist/cjs/crypto-web.js.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-web.js","sourceRoot":"","sources":["../../src/crypto-web.ts"],"names":[],"mappings":";AAAA,gDAAgD;AAChD,EAAE;AACF,6FAA6F;AAC7F,kGAAkG;AAClG,oGAAoG;AACpG,mFAAmF;AACnF,EAAE;AACF,mGAAmG;AACnG,sFAAsF;;AAUtF,8DAoBC;AA1BD,MAAM,OAAO,GAAG,8EAA8E,CAAC;AAE/F;;;GAGG;AACH,SAAgB,yBAAyB;IACvC,MAAM,cAAc,GAAG,GAAU,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO;QACL,sBAAsB,EAAE,cAAc;QACtC,mBAAmB,EAAE,cAAc;QACnC,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,cAAc;QAC5B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,cAAc;QAC/B,gBAAgB,EAAE,cAAc;QAChC,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,cAAc;KAC7B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"crypto-web.js","sourceRoot":"","sources":["../../src/crypto-web.ts"],"names":[],"mappings":";AAAA,gDAAgD;AAChD,EAAE;AACF,6FAA6F;AAC7F,kGAAkG;AAClG,oGAAoG;AACpG,mFAAmF;AACnF,EAAE;AACF,mGAAmG;AACnG,sFAAsF;;AAUtF,8DAsBC;AA5BD,MAAM,OAAO,GAAG,8EAA8E,CAAC;AAE/F;;;GAGG;AACH,SAAgB,yBAAyB;IACvC,MAAM,cAAc,GAAG,GAAU,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO;QACL,sBAAsB,EAAE,cAAc;QACtC,mBAAmB,EAAE,cAAc;QACnC,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,cAAc;QAC5B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,cAAc;QAC/B,gBAAgB,EAAE,cAAc;QAChC,gBAAgB,EAAE,cAAc;QAChC,iBAAiB,EAAE,cAAc;QACjC,iBAAiB,EAAE,cAAc;QACjC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,cAAc;KAC7B,CAAC;AACJ,CAAC"}

package/dist/cjs/index.d.ts

@@ -1,2 +1,4 @@
 export * from "@agora-sdk/secure-chat-core";
-export { createWebSecureChatCrypto } from "./crypto-web";
+export { createWebSecureChatCrypto } from "./crypto-web.js";
+export { createIndexedDBStore } from "./indexeddb-store.js";
+export type { IndexedDBStoreOptions } from "./indexeddb-store.js";

package/dist/cjs/index.js

@@ -19,8 +19,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWebSecureChatCrypto = void 0;
+exports.createIndexedDBStore = exports.createWebSecureChatCrypto = void 0;
 __exportStar(require("@agora-sdk/secure-chat-core"), exports);
-var crypto_web_1 = require("./crypto-web");
-Object.defineProperty(exports, "createWebSecureChatCrypto", { enumerable: true, get: function () { return crypto_web_1.createWebSecureChatCrypto; } });
+var crypto_web_js_1 = require("./crypto-web.js");
+Object.defineProperty(exports, "createWebSecureChatCrypto", { enumerable: true, get: function () { return crypto_web_js_1.createWebSecureChatCrypto; } });
+var indexeddb_store_js_1 = require("./indexeddb-store.js");
+Object.defineProperty(exports, "createIndexedDBStore", { enumerable: true, get: function () { return indexeddb_store_js_1.createIndexedDBStore; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,8CAA8C;;;;;;;;;;;;;;;;;AAE9C,8DAA4C;AAE5C,2CAAyD;AAAhD,uHAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,8CAA8C;;;;;;;;;;;;;;;;;AAE9C,8DAA4C;AAE5C,iDAA4D;AAAnD,0HAAA,yBAAyB,OAAA;AAClC,2DAA4D;AAAnD,0HAAA,oBAAoB,OAAA"}

package/dist/cjs/indexeddb-store.d.ts

@@ -0,0 +1,21 @@
+import type { SecureChatStore } from "@agora-sdk/secure-chat-core";
+/** Options for {@link createIndexedDBStore}. */
+export interface IndexedDBStoreOptions {
+    /** Database name. Default `agora-secure-chat`. */
+    dbName?: string;
+    /** Object store name. Default `kv`. */
+    storeName?: string;
+}
+/**
+ * Create an IndexedDB-backed {@link SecureChatStore} for the web.
+ *
+ * @param opts - {@link IndexedDBStoreOptions} — database + object-store names.
+ * @returns A durable store; pass it to `<SecureChatProvider store={...}>`.
+ * @throws {Error} On first access when `indexedDB` is unavailable (SSR / disabled).
+ *
+ * @example
+ * ```ts
+ * <SecureChatProvider store={createIndexedDBStore()} crypto={crypto} projectId={id} />
+ * ```
+ */
+export declare function createIndexedDBStore(opts?: IndexedDBStoreOptions): SecureChatStore;

package/dist/cjs/indexeddb-store.js

@@ -0,0 +1,72 @@
+"use strict";
+// Web SecureChatStore — IndexedDB-backed durable persistence.
+//
+// One object store keyed by string, value Uint8Array (structured-cloneable). Plaintext at rest for
+// Phase 2 — IndexedDB is readable by any same-origin script; the threat model is "blind server", and
+// passphrase backup (task 5) is the recovery path. The DB handle opens lazily on first use.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIndexedDBStore = createIndexedDBStore;
+function openDb(dbName, storeName) {
+    return new Promise((resolve, reject) => {
+        if (typeof indexedDB === "undefined") {
+            reject(new Error("IndexedDB is unavailable here; inject a different SecureChatStore (e.g. MemoryStore)."));
+            return;
+        }
+        const req = indexedDB.open(dbName, 1);
+        req.onupgradeneeded = () => {
+            const db = req.result;
+            if (!db.objectStoreNames.contains(storeName))
+                db.createObjectStore(storeName);
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+        req.onblocked = () => reject(new Error("IndexedDB open blocked by an existing connection — close other tabs and retry."));
+    });
+}
+function runTx(db, storeName, mode, fn) {
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeName, mode);
+        const req = fn(tx.objectStore(storeName));
+        tx.oncomplete = () => resolve(req.result);
+        tx.onerror = () => reject(tx.error);
+        tx.onabort = () => reject(tx.error);
+    });
+}
+/**
+ * Create an IndexedDB-backed {@link SecureChatStore} for the web.
+ *
+ * @param opts - {@link IndexedDBStoreOptions} — database + object-store names.
+ * @returns A durable store; pass it to `<SecureChatProvider store={...}>`.
+ * @throws {Error} On first access when `indexedDB` is unavailable (SSR / disabled).
+ *
+ * @example
+ * ```ts
+ * <SecureChatProvider store={createIndexedDBStore()} crypto={crypto} projectId={id} />
+ * ```
+ */
+function createIndexedDBStore(opts = {}) {
+    const dbName = opts.dbName ?? "agora-secure-chat";
+    const storeName = opts.storeName ?? "kv";
+    let dbPromise = null;
+    const db = () => (dbPromise ?? (dbPromise = openDb(dbName, storeName).catch((e) => {
+        dbPromise = null; // don't cache a rejection — allow a retry on the next call
+        throw e;
+    })));
+    return {
+        async get(key) {
+            const v = await runTx(await db(), storeName, "readonly", (s) => s.get(key));
+            return v ?? null;
+        },
+        async set(key, value) {
+            await runTx(await db(), storeName, "readwrite", (s) => s.put(value, key));
+        },
+        async delete(key) {
+            await runTx(await db(), storeName, "readwrite", (s) => s.delete(key));
+        },
+        async list(prefix) {
+            const keys = await runTx(await db(), storeName, "readonly", (s) => s.getAllKeys());
+            return keys.filter((k) => typeof k === "string" && k.startsWith(prefix));
+        },
+    };
+}
+//# sourceMappingURL=indexeddb-store.js.map

package/dist/cjs/indexeddb-store.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/esm/crypto-web.js

@@ -29,6 +29,8 @@ export function createWebSecureChatCrypto() {
         processProposal: notImplemented,
         exportGroupState: notImplemented,
         importGroupState: notImplemented,
+        exportDeviceState: notImplemented,
+        importDeviceState: notImplemented,
         exportBackup: notImplemented,
         importBackup: notImplemented,
     };

package/dist/esm/crypto-web.js.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-web.js","sourceRoot":"","sources":["../../src/crypto-web.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,6FAA6F;AAC7F,kGAAkG;AAClG,oGAAoG;AACpG,mFAAmF;AACnF,EAAE;AACF,mGAAmG;AACnG,sFAAsF;AAItF,MAAM,OAAO,GAAG,8EAA8E,CAAC;AAE/F;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,cAAc,GAAG,GAAU,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO;QACL,sBAAsB,EAAE,cAAc;QACtC,mBAAmB,EAAE,cAAc;QACnC,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,cAAc;QAC5B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,cAAc;QAC/B,gBAAgB,EAAE,cAAc;QAChC,gBAAgB,EAAE,cAAc;QAChC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,cAAc;KAC7B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"crypto-web.js","sourceRoot":"","sources":["../../src/crypto-web.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,6FAA6F;AAC7F,kGAAkG;AAClG,oGAAoG;AACpG,mFAAmF;AACnF,EAAE;AACF,mGAAmG;AACnG,sFAAsF;AAItF,MAAM,OAAO,GAAG,8EAA8E,CAAC;AAE/F;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,cAAc,GAAG,GAAU,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO;QACL,sBAAsB,EAAE,cAAc;QACtC,mBAAmB,EAAE,cAAc;QACnC,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,cAAc;QAC5B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,cAAc;QAC/B,gBAAgB,EAAE,cAAc;QAChC,gBAAgB,EAAE,cAAc;QAChC,iBAAiB,EAAE,cAAc;QACjC,iBAAiB,EAAE,cAAc;QACjC,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,cAAc;KAC7B,CAAC;AACJ,CAAC"}

package/dist/esm/index.d.ts

@@ -1,2 +1,4 @@
 export * from "@agora-sdk/secure-chat-core";
-export { createWebSecureChatCrypto } from "./crypto-web";
+export { createWebSecureChatCrypto } from "./crypto-web.js";
+export { createIndexedDBStore } from "./indexeddb-store.js";
+export type { IndexedDBStoreOptions } from "./indexeddb-store.js";

package/dist/esm/index.js

@@ -4,5 +4,6 @@
 // MLS crypto + IndexedDB group-state persistence. Use this package (not core directly) in browser
 // apps so the right crypto/persistence ships.
 export * from "@agora-sdk/secure-chat-core";
-export { createWebSecureChatCrypto } from "./crypto-web";
+export { createWebSecureChatCrypto } from "./crypto-web.js";
+export { createIndexedDBStore } from "./indexeddb-store.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,8CAA8C;AAE9C,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,8CAA8C;AAE9C,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/indexeddb-store.d.ts

@@ -0,0 +1,21 @@
+import type { SecureChatStore } from "@agora-sdk/secure-chat-core";
+/** Options for {@link createIndexedDBStore}. */
+export interface IndexedDBStoreOptions {
+    /** Database name. Default `agora-secure-chat`. */
+    dbName?: string;
+    /** Object store name. Default `kv`. */
+    storeName?: string;
+}
+/**
+ * Create an IndexedDB-backed {@link SecureChatStore} for the web.
+ *
+ * @param opts - {@link IndexedDBStoreOptions} — database + object-store names.
+ * @returns A durable store; pass it to `<SecureChatProvider store={...}>`.
+ * @throws {Error} On first access when `indexedDB` is unavailable (SSR / disabled).
+ *
+ * @example
+ * ```ts
+ * <SecureChatProvider store={createIndexedDBStore()} crypto={crypto} projectId={id} />
+ * ```
+ */
+export declare function createIndexedDBStore(opts?: IndexedDBStoreOptions): SecureChatStore;

package/dist/esm/indexeddb-store.js

@@ -0,0 +1,69 @@
+// Web SecureChatStore — IndexedDB-backed durable persistence.
+//
+// One object store keyed by string, value Uint8Array (structured-cloneable). Plaintext at rest for
+// Phase 2 — IndexedDB is readable by any same-origin script; the threat model is "blind server", and
+// passphrase backup (task 5) is the recovery path. The DB handle opens lazily on first use.
+function openDb(dbName, storeName) {
+    return new Promise((resolve, reject) => {
+        if (typeof indexedDB === "undefined") {
+            reject(new Error("IndexedDB is unavailable here; inject a different SecureChatStore (e.g. MemoryStore)."));
+            return;
+        }
+        const req = indexedDB.open(dbName, 1);
+        req.onupgradeneeded = () => {
+            const db = req.result;
+            if (!db.objectStoreNames.contains(storeName))
+                db.createObjectStore(storeName);
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+        req.onblocked = () => reject(new Error("IndexedDB open blocked by an existing connection — close other tabs and retry."));
+    });
+}
+function runTx(db, storeName, mode, fn) {
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeName, mode);
+        const req = fn(tx.objectStore(storeName));
+        tx.oncomplete = () => resolve(req.result);
+        tx.onerror = () => reject(tx.error);
+        tx.onabort = () => reject(tx.error);
+    });
+}
+/**
+ * Create an IndexedDB-backed {@link SecureChatStore} for the web.
+ *
+ * @param opts - {@link IndexedDBStoreOptions} — database + object-store names.
+ * @returns A durable store; pass it to `<SecureChatProvider store={...}>`.
+ * @throws {Error} On first access when `indexedDB` is unavailable (SSR / disabled).
+ *
+ * @example
+ * ```ts
+ * <SecureChatProvider store={createIndexedDBStore()} crypto={crypto} projectId={id} />
+ * ```
+ */
+export function createIndexedDBStore(opts = {}) {
+    const dbName = opts.dbName ?? "agora-secure-chat";
+    const storeName = opts.storeName ?? "kv";
+    let dbPromise = null;
+    const db = () => (dbPromise ?? (dbPromise = openDb(dbName, storeName).catch((e) => {
+        dbPromise = null; // don't cache a rejection — allow a retry on the next call
+        throw e;
+    })));
+    return {
+        async get(key) {
+            const v = await runTx(await db(), storeName, "readonly", (s) => s.get(key));
+            return v ?? null;
+        },
+        async set(key, value) {
+            await runTx(await db(), storeName, "readwrite", (s) => s.put(value, key));
+        },
+        async delete(key) {
+            await runTx(await db(), storeName, "readwrite", (s) => s.delete(key));
+        },
+        async list(prefix) {
+            const keys = await runTx(await db(), storeName, "readonly", (s) => s.getAllKeys());
+            return keys.filter((k) => typeof k === "string" && k.startsWith(prefix));
+        },
+    };
+}
+//# sourceMappingURL=indexeddb-store.js.map

package/dist/esm/indexeddb-store.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agora-sdk/secure-chat-react-js",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "license": "Apache-2.0",
   "author": "Agora SDK Plus, maintained by Jenova Marie",
@@ -34,16 +34,19 @@
     "dist"
   ],
   "dependencies": {
-    "@agora-sdk/secure-chat-core": "0.1.0"
+    "@agora-sdk/secure-chat-core": "0.2.0"
   },
   "peerDependencies": {
     "@agora-sdk/core": "^1.2.2",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
+  "devDependencies": {
+    "fake-indexeddb": "^6.2.5"
+  },
   "scripts": {
     "build:esm": "tsc -p tsconfig.esm.json",
-    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
     "build": "rimraf dist && pnpm run build:esm && pnpm run build:cjs",
     "prepublish": "pnpm run build"
   }