@foony/chat 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to `@foony/chat`. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com); versions are semver.
 
+## 0.3.1
+
+### Fixed
+
+- Chat continues without its local cache when browser privacy settings block IndexedDB or the cache runs out of space.
+
 ## 0.3.0
 
 ### Added

package/lib/storage.d.ts

@@ -23,8 +23,9 @@ export type ChatStorage = {
     remove(room: string): Promise<void>;
 };
 /**
- * A {@link ChatStorage} backed by IndexedDB, or null where IndexedDB does not exist (Node,
- * some webviews) so callers can pass the result straight to `new ChatClient(...)`.
+ * Create an optional IndexedDB cache. Return null when access is unavailable or blocked.
+ * If opening or using the database fails, reads resolve with null and writes resolve without
+ * saving. Cache failures never reject, so live chat can continue without persistence.
  *
  * @example
  * const chat = new ChatClient(realtime, { storage: indexedDbChatStorage() ?? undefined });

package/lib/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG;IACxB,gEAAgE;IAChE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACvD,mCAAmC;IACnC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,qFAAqF;IACrF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAKF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAe,GAAG,WAAW,GAAG,IAAI,CAqB9E"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG;IACxB,gEAAgE;IAChE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACvD,mCAAmC;IACnC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,qFAAqF;IACrF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAKF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAe,GAAG,WAAW,GAAG,IAAI,CA6C9E"}

package/lib/storage.js

@@ -6,36 +6,61 @@
 /** Object store holding one record per room inside the IndexedDB database. */
 const STORE = 'rooms';
 /**
- * A {@link ChatStorage} backed by IndexedDB, or null where IndexedDB does not exist (Node,
- * some webviews) so callers can pass the result straight to `new ChatClient(...)`.
+ * Create an optional IndexedDB cache. Return null when access is unavailable or blocked.
+ * If opening or using the database fails, reads resolve with null and writes resolve without
+ * saving. Cache failures never reject, so live chat can continue without persistence.
  *
  * @example
  * const chat = new ChatClient(realtime, { storage: indexedDbChatStorage() ?? undefined });
  */
 export function indexedDbChatStorage(dbName = 'foony-chat') {
-    if (typeof indexedDB === 'undefined') {
+    let factory;
+    try {
+        factory = globalThis.indexedDB;
+        if (!factory) {
+            return null;
+        }
+    }
+    catch {
         return null;
     }
-    const database = openDatabase(dbName);
+    // Attach the rejection handler now, before a room has asked to use the cache.
+    const database = openDatabase(factory, dbName).catch(() => null);
+    let failed = false;
+    async function withDatabase(operation, fallback) {
+        const db = await database;
+        if (!db || failed) {
+            return fallback;
+        }
+        try {
+            return await operation(db);
+        }
+        catch {
+            // Quota and privacy failures can persist for the whole session. Stop retrying this cache.
+            failed = true;
+            return fallback;
+        }
+    }
     return {
         async load(room) {
-            const db = await database;
-            return await requestOf(db.transaction(STORE, 'readonly').objectStore(STORE).get(room)) ?? null;
+            return withDatabase(async (db) => await requestOf(db.transaction(STORE, 'readonly').objectStore(STORE).get(room)) ?? null, null);
         },
         async save(room, state) {
-            const db = await database;
-            await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).put(state, room));
+            return withDatabase(async (db) => {
+                await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).put(state, room));
+            }, undefined);
         },
         async remove(room) {
-            const db = await database;
-            await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).delete(room));
+            return withDatabase(async (db) => {
+                await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).delete(room));
+            }, undefined);
         },
     };
 }
 /** Open (or create) the database with its single room store. */
-function openDatabase(dbName) {
+function openDatabase(factory, dbName) {
     return new Promise((resolve, reject) => {
-        const request = indexedDB.open(dbName, 1);
+        const request = factory.open(dbName, 1);
         request.onupgradeneeded = () => {
             request.result.createObjectStore(STORE);
         };

package/lib/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH,8EAA8E;AAC9E,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAM,GAAG,YAAY;IACxD,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,IAAY;YACrB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;YAC1B,OAAO,MAAM,SAAS,CACpB,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAC/D,IAAI,IAAI,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,KAAyB;YAChD,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;YAC1B,MAAM,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAY;YACvB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;YAC1B,MAAM,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,eAAe,GAAG,GAAG,EAAE;YAC7B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;QACF,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gCAAgC;AAChC,SAAS,SAAS,CAAI,OAAsB;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/lib-cjs/storage.js

@@ -9,36 +9,61 @@ exports.indexedDbChatStorage = indexedDbChatStorage;
 /** Object store holding one record per room inside the IndexedDB database. */
 const STORE = 'rooms';
 /**
- * A {@link ChatStorage} backed by IndexedDB, or null where IndexedDB does not exist (Node,
- * some webviews) so callers can pass the result straight to `new ChatClient(...)`.
+ * Create an optional IndexedDB cache. Return null when access is unavailable or blocked.
+ * If opening or using the database fails, reads resolve with null and writes resolve without
+ * saving. Cache failures never reject, so live chat can continue without persistence.
  *
  * @example
  * const chat = new ChatClient(realtime, { storage: indexedDbChatStorage() ?? undefined });
  */
 function indexedDbChatStorage(dbName = 'foony-chat') {
-    if (typeof indexedDB === 'undefined') {
+    let factory;
+    try {
+        factory = globalThis.indexedDB;
+        if (!factory) {
+            return null;
+        }
+    }
+    catch {
         return null;
     }
-    const database = openDatabase(dbName);
+    // Attach the rejection handler now, before a room has asked to use the cache.
+    const database = openDatabase(factory, dbName).catch(() => null);
+    let failed = false;
+    async function withDatabase(operation, fallback) {
+        const db = await database;
+        if (!db || failed) {
+            return fallback;
+        }
+        try {
+            return await operation(db);
+        }
+        catch {
+            // Quota and privacy failures can persist for the whole session. Stop retrying this cache.
+            failed = true;
+            return fallback;
+        }
+    }
     return {
         async load(room) {
-            const db = await database;
-            return await requestOf(db.transaction(STORE, 'readonly').objectStore(STORE).get(room)) ?? null;
+            return withDatabase(async (db) => await requestOf(db.transaction(STORE, 'readonly').objectStore(STORE).get(room)) ?? null, null);
         },
         async save(room, state) {
-            const db = await database;
-            await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).put(state, room));
+            return withDatabase(async (db) => {
+                await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).put(state, room));
+            }, undefined);
         },
         async remove(room) {
-            const db = await database;
-            await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).delete(room));
+            return withDatabase(async (db) => {
+                await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).delete(room));
+            }, undefined);
         },
     };
 }
 /** Open (or create) the database with its single room store. */
-function openDatabase(dbName) {
+function openDatabase(factory, dbName) {
     return new Promise((resolve, reject) => {
-        const request = indexedDB.open(dbName, 1);
+        const request = factory.open(dbName, 1);
         request.onupgradeneeded = () => {
             request.result.createObjectStore(STORE);
         };

package/lib-cjs/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAkCH,oDAqBC;AA/BD,8EAA8E;AAC9E,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,MAAM,GAAG,YAAY;IACxD,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,IAAY;YACrB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;YAC1B,OAAO,MAAM,SAAS,CACpB,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAC/D,IAAI,IAAI,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,KAAyB;YAChD,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;YAC1B,MAAM,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAY;YACvB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC;YAC1B,MAAM,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,eAAe,GAAG,GAAG,EAAE;YAC7B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC;QACF,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gCAAgC;AAChC,SAAS,SAAS,CAAI,OAAsB;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foony/chat",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Chat API (rooms, messages, typing, reactions, presence, occupancy) built on @foony/realtime.",
   "license": "Apache-2.0",
   "repository": {

package/src/storage.ts

@@ -30,39 +30,64 @@ export type ChatStorage = {
 const STORE = 'rooms';
 
 /**
- * A {@link ChatStorage} backed by IndexedDB, or null where IndexedDB does not exist (Node,
- * some webviews) so callers can pass the result straight to `new ChatClient(...)`.
+ * Create an optional IndexedDB cache. Return null when access is unavailable or blocked.
+ * If opening or using the database fails, reads resolve with null and writes resolve without
+ * saving. Cache failures never reject, so live chat can continue without persistence.
  *
  * @example
  * const chat = new ChatClient(realtime, { storage: indexedDbChatStorage() ?? undefined });
  */
 export function indexedDbChatStorage(dbName = 'foony-chat'): ChatStorage | null {
-  if (typeof indexedDB === 'undefined') {
+  let factory: IDBFactory;
+  try {
+    factory = globalThis.indexedDB;
+    if (!factory) {
+      return null;
+    }
+  } catch {
     return null;
   }
-  const database = openDatabase(dbName);
+  // Attach the rejection handler now, before a room has asked to use the cache.
+  const database = openDatabase(factory, dbName).catch(() => null);
+  let failed = false;
+
+  async function withDatabase<T>(operation: (db: IDBDatabase) => Promise<T>, fallback: T): Promise<T> {
+    const db = await database;
+    if (!db || failed) {
+      return fallback;
+    }
+    try {
+      return await operation(db);
+    } catch {
+      // Quota and privacy failures can persist for the whole session. Stop retrying this cache.
+      failed = true;
+      return fallback;
+    }
+  }
+
   return {
     async load(room: string): Promise<PersistedRoomState | null> {
-      const db = await database;
-      return await requestOf<PersistedRoomState | undefined>(
+      return withDatabase(async db => await requestOf<PersistedRoomState | undefined>(
         db.transaction(STORE, 'readonly').objectStore(STORE).get(room),
-      ) ?? null;
+      ) ?? null, null);
     },
     async save(room: string, state: PersistedRoomState): Promise<void> {
-      const db = await database;
-      await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).put(state, room));
+      return withDatabase(async db => {
+        await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).put(state, room));
+      }, undefined);
     },
     async remove(room: string): Promise<void> {
-      const db = await database;
-      await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).delete(room));
+      return withDatabase(async db => {
+        await requestOf(db.transaction(STORE, 'readwrite').objectStore(STORE).delete(room));
+      }, undefined);
     },
   };
 }
 
 /** Open (or create) the database with its single room store. */
-function openDatabase(dbName: string): Promise<IDBDatabase> {
+function openDatabase(factory: IDBFactory, dbName: string): Promise<IDBDatabase> {
   return new Promise((resolve, reject) => {
-    const request = indexedDB.open(dbName, 1);
+    const request = factory.open(dbName, 1);
     request.onupgradeneeded = () => {
       request.result.createObjectStore(STORE);
     };