cry-synced-db-client 0.1.124 → 0.1.125

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Versions
 
+## 0.1.125 (2026-04-08)
+
+- Detect stringified falsy `_id` values (`"undefined"`, `"null"`, `"0"`, `"false"`, `""`) across all DB operations
+
 ## 0.1.124 (2026-04-08)
 
 - Fix `ensureId` not generating `_id` when key is absent (caused `"undefined"` string ids)

package/dist/index.js

@@ -3416,7 +3416,7 @@ var NetworkStatusManager = class {
 };
 
 // src/db/SyncedDb.ts
-var SyncedDb = class _SyncedDb {
+var _SyncedDb = class _SyncedDb {
   constructor(config) {
     this.collections = /* @__PURE__ */ new Map();
     // State
@@ -4669,6 +4669,11 @@ var SyncedDb = class _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.`
       );
     }
+    if (typeof id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(id)) {
+      console.error(
+        `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.`
+      );
+    }
     return typeof id === "object" && id !== null ? String(id) : id;
   }
   /**
@@ -4681,6 +4686,11 @@ var SyncedDb = class _SyncedDb {
         `SyncedDb.${method}("${collection}"): _id is present in query/data but falsy (${JSON.stringify(data._id)}). This is a bug \u2014 _id must be valid when specified. Data keys: [${Object.keys(data).join(", ")}]`
       );
     }
+    if ("_id" in data && typeof data._id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(data._id)) {
+      console.error(
+        `SyncedDb.${method}("${collection}"): _id is a stringified falsy value ("${data._id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id. Data keys: [${Object.keys(data).join(", ")}]`
+      );
+    }
   }
   /**
    * Ensure `_id` on a data object is never falsy or absent.
@@ -4689,6 +4699,12 @@ var SyncedDb = class _SyncedDb {
    * @mutates — modifies the object in-place and returns it.
    */
   ensureId(data, method, collection) {
+    if (typeof data._id === "string" && _SyncedDb.STRINGIFIED_FALSY.has(data._id)) {
+      console.error(
+        `SyncedDb.${method}("${collection}"): _id is a stringified falsy value ("${data._id}"). This is a bug \u2014 a falsy value was coerced to string before being passed as _id. Data keys: [${Object.keys(data).join(", ")}]`
+      );
+      data._id = null;
+    }
     if (!data._id) {
       const newId = new ObjectId2().toHexString();
       if ("_id" in data) {
@@ -4765,6 +4781,14 @@ var SyncedDb = class _SyncedDb {
     );
   }
 };
+_SyncedDb.STRINGIFIED_FALSY = /* @__PURE__ */ new Set([
+  "undefined",
+  "null",
+  "0",
+  "false",
+  ""
+]);
+var SyncedDb = _SyncedDb;
 
 // src/db/DexieDb.ts
 import Dexie from "dexie";

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

@@ -208,6 +208,7 @@ export declare class SyncedDb implements I_SyncedDb {
     private loadCollectionsToInMem;
     private loadCollectionToInMem;
     private assertCollection;
+    private static readonly STRINGIFIED_FALSY;
     /** Stringify an Id parameter (ObjectId → hex string). */
     private normalizeId;
     /**

package/package.json

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