cry-synced-db-client 0.1.216 → 0.1.217

package/dist/index.js

@@ -7684,17 +7684,30 @@ var _SyncedDb = class _SyncedDb {
       }
     }
   }
-  /** Stringify an Id parameter (ObjectId → hex string). */
+  /**
+   * Stringify an Id parameter (ObjectId → hex string).
+   *
+   * Throws when `id` is falsy (null, undefined, 0, "", false) or is a
+   * stringified-falsy value ("undefined", "null", "0", "false", "").
+   * Passing a garbage _id creates a stuck dirty item that can never be
+   * uploaded (server rejects it) and can never be auto-healed (library
+   * doesn't know the correct _id). Fail-fast prevents silent data loss.
+   */
   normalizeId(id, method, collection) {
     if (!id && id !== void 0) {
-      console.error(
-        `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id parameter is falsy (${JSON.stringify(id)}). This is a bug \u2014 the caller must provide a valid _id.`
-      );
+      const msg = `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id parameter is falsy (${JSON.stringify(id)}). This is a bug \u2014 the caller must provide a valid _id.`;
+      console.error(msg);
+      throw new Error(msg);
     }
     if (typeof id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(id)) {
-      console.error(
-        `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id is a stringified falsy value ("${id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id.`
-      );
+      const msg = `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id is a stringified falsy value ("${id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id.`;
+      console.error(msg);
+      throw new Error(msg);
+    }
+    if (id === void 0) {
+      const msg = `[SyncedDb] SyncedDb.${method != null ? method : "?"}("${collection != null ? collection : "?"}"): id parameter is undefined. This is a bug \u2014 the caller must provide a valid _id.`;
+      console.error(msg);
+      throw new Error(msg);
     }
     return typeof id === "object" && id !== null ? String(id) : id;
   }
@@ -7976,7 +7989,27 @@ var DexieDb = class extends Dexie {
     }
     return table;
   }
+  /**
+   * Convert an Id to its string representation for IndexedDB key storage.
+   * Throws on falsy values to prevent stuck-dirty items with garbage
+   * _id values like "undefined" / "null" that can never be uploaded.
+   */
   idToString(id) {
+    if (!id && id !== void 0) {
+      throw new Error(
+        `[DexieDb.idToString] id is falsy (${JSON.stringify(id)}). This is a bug \u2014 a valid _id is required.`
+      );
+    }
+    if (id === void 0) {
+      throw new Error(
+        `[DexieDb.idToString] id is undefined. This is a bug \u2014 a valid _id is required.`
+      );
+    }
+    if (typeof id === "string" && (id === "undefined" || id === "null" || id === "0" || id === "false" || id === "")) {
+      throw new Error(
+        `[DexieDb.idToString] id is a stringified falsy value ("${id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id.`
+      );
+    }
     return String(id);
   }
   /** Ensure _id is a primitive string. IndexedDB rejects ObjectId objects as keys. */

package/dist/src/db/DexieDb.d.ts

@@ -15,6 +15,11 @@ export declare class DexieDb extends Dexie implements I_DexieDb {
     private _isNewDatabase;
     constructor(tenant: string, collectionConfigs: CollectionConfig<any>[]);
     private getTable;
+    /**
+     * Convert an Id to its string representation for IndexedDB key storage.
+     * Throws on falsy values to prevent stuck-dirty items with garbage
+     * _id values like "undefined" / "null" that can never be uploaded.
+     */
     private idToString;
     /** Ensure _id is a primitive string. IndexedDB rejects ObjectId objects as keys. */
     private ensureStringId;

package/dist/src/db/SyncedDb.d.ts

@@ -617,7 +617,15 @@ export declare class SyncedDb implements I_SyncedDb {
      */
     private _autoRegisterTemporaryForFind;
     private static readonly STRINGIFIED_FALSY;
-    /** Stringify an Id parameter (ObjectId → hex string). */
+    /**
+     * Stringify an Id parameter (ObjectId → hex string).
+     *
+     * Throws when `id` is falsy (null, undefined, 0, "", false) or is a
+     * stringified-falsy value ("undefined", "null", "0", "false", "").
+     * Passing a garbage _id creates a stuck dirty item that can never be
+     * uploaded (server rejects it) and can never be auto-healed (library
+     * doesn't know the correct _id). Fail-fast prevents silent data loss.
+     */
     private normalizeId;
     /**
      * Warn if a query/data object has `_id` present but falsy.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-synced-db-client",
-  "version": "0.1.216",
+  "version": "0.1.217",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",