@oimdb/core 2.1.0 → 2.2.0

package/dist/index.cjs

@@ -879,17 +879,39 @@ var OIMCollectionStoreMapDriven = class extends OIMCollectionStore {
   constructor() {
     super(...arguments);
     this.slots = /* @__PURE__ */ new Map();
+    // Slots reserved by indexes for PKs whose entity has not arrived yet.
+    // They carry `item: undefined` and live apart from `slots` so they do not
+    // leak into entity enumeration (getAll/getAllPks/countAll). When the entity
+    // is finally written, the reserved slot is promoted into `slots` — keeping
+    // the reference that indexes already hold, so it fills in live.
+    this.reservedSlots = /* @__PURE__ */ new Map();
   }
   setOneByPk(pk, entity) {
     const slot = this.slots.get(pk);
     if (slot) {
       slot.item = entity;
       return slot;
-    } else {
-      const nextSlot = { pk, item: entity };
-      this.slots.set(pk, nextSlot);
-      return nextSlot;
     }
+    const reserved = this.reservedSlots.get(pk);
+    if (reserved) {
+      reserved.item = entity;
+      this.reservedSlots.delete(pk);
+      this.slots.set(pk, reserved);
+      return reserved;
+    }
+    const nextSlot = { pk, item: entity };
+    this.slots.set(pk, nextSlot);
+    return nextSlot;
+  }
+  getOrReserveSlotByPk(pk) {
+    const slot = this.slots.get(pk);
+    if (slot) return slot;
+    let reserved = this.reservedSlots.get(pk);
+    if (!reserved) {
+      reserved = { pk, item: void 0 };
+      this.reservedSlots.set(pk, reserved);
+    }
+    return reserved;
   }
   setManyByPks(pks, entities) {
     const slots = [];
@@ -922,6 +944,11 @@ var OIMCollectionStoreMapDriven = class extends OIMCollectionStore {
     const slot = this.slots.get(pk);
     if (slot) slot.item = void 0;
     this.slots.delete(pk);
+    const reserved = this.reservedSlots.get(pk);
+    if (reserved) {
+      reserved.item = void 0;
+      this.reservedSlots.delete(pk);
+    }
   }
   removeManyByPks(pks) {
     for (const pk of pks) {
@@ -959,6 +986,10 @@ var OIMCollectionStoreMapDriven = class extends OIMCollectionStore {
       slot.item = void 0;
     }
     this.slots.clear();
+    for (const slot of this.reservedSlots.values()) {
+      slot.item = void 0;
+    }
+    this.reservedSlots.clear();
   }
   getAllPks() {
     return Array.from(this.slots.keys());
@@ -1000,6 +1031,9 @@ var OIMCollection = class {
   getSlotByPk(pk) {
     return this.store.getSlotByPk(pk);
   }
+  getOrReserveSlotByPk(pk) {
+    return this.store.getOrReserveSlotByPk(pk);
+  }
   getSlotsByPks(pks) {
     return this.store.getSlotsByPks(pks);
   }
@@ -1625,7 +1659,7 @@ var OIMReactiveIndexManualArrayBased = class extends OIMReactiveIndexArrayBased
 // src/core/OIMReactiveCollectionIndexManualArrayBased.ts
 var OIMReactiveCollectionIndexManualArrayBased = class extends OIMReactiveIndexManualArrayBased {
   constructor(queue, opts) {
-    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getSlotByPk(pk) : opts.resolveSlot;
+    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getOrReserveSlotByPk(pk) : opts.resolveSlot;
     super(queue, {
       indexOptions: opts.indexOptions
     });
@@ -1675,11 +1709,7 @@ var OIMReactiveCollectionIndexManualArrayBased = class extends OIMReactiveIndexM
   }
   resolveRequiredSlot(pk) {
     const slot = this.resolveSlot(pk);
-    if (!slot) {
-      throw new Error(
-        `[OIMReactiveCollectionIndexManualArrayBased]: Unable to resolve slot for PK "${String(pk)}".`
-      );
-    }
+    if (!slot) return { pk, item: void 0 };
     return slot;
   }
 };
@@ -1747,7 +1777,7 @@ var OIMReactiveIndexManualSetBased = class extends OIMReactiveIndexSetBased {
 // src/core/OIMReactiveCollectionIndexManualSetBased.ts
 var OIMReactiveCollectionIndexManualSetBased = class extends OIMReactiveIndexManualSetBased {
   constructor(queue, opts) {
-    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getSlotByPk(pk) : opts.resolveSlot;
+    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getOrReserveSlotByPk(pk) : opts.resolveSlot;
     super(queue, {
       indexOptions: opts.indexOptions
     });
@@ -1801,11 +1831,7 @@ var OIMReactiveCollectionIndexManualSetBased = class extends OIMReactiveIndexMan
   }
   resolveRequiredSlot(pk) {
     const slot = this.resolveSlot(pk);
-    if (!slot) {
-      throw new Error(
-        `[OIMReactiveCollectionIndexManualSetBased]: Unable to resolve slot for PK "${String(pk)}".`
-      );
-    }
+    if (!slot) return { pk, item: void 0 };
     return slot;
   }
 };

package/dist/index.d.cts

@@ -10,6 +10,13 @@ type TOIMEntitySlotResolver<TPk extends TOIMPk> = (pk: TPk) => TOIMAnyEntitySlot
 declare abstract class OIMCollectionStore<TEntity extends object, TPk extends TOIMPk> {
     abstract setOneByPk(pk: TPk, entity: TEntity): TOIMEntitySlot<TEntity, TPk>;
     abstract getSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk> | undefined;
+    /**
+     * Returns the canonical slot for `pk`, creating a reserved empty slot
+     * (`item: undefined`) if no entity exists yet. The reserved slot is a stable
+     * reference that fills in when the entity is later written, so indexes can
+     * hold it ahead of the entity's arrival without crashing.
+     */
+    abstract getOrReserveSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk>;
     abstract getSlotsByPks(pks: readonly TPk[]): TOIMEntitySlot<TEntity, TPk>[];
     abstract getAllSlots(): TOIMEntitySlot<TEntity, TPk>[];
     abstract removeOneByPk(pk: TPk): void;
@@ -381,6 +388,7 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     getOneByPk(pk: TPk): TEntity | undefined;
     getManyByPks(pks: readonly TPk[]): TEntity[];
     getSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk> | undefined;
+    getOrReserveSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk>;
     getSlotsByPks(pks: readonly TPk[]): TOIMEntitySlot<TEntity, TPk>[];
     getAllSlots(): TOIMEntitySlot<TEntity, TPk>[];
     upsertOneByPk(pk: TPk, entity: Partial<TEntity>): TOIMEntitySlot<TEntity, TPk>;
@@ -849,7 +857,9 @@ declare class OIMReactiveObject<TKey extends string, TValue> extends OIMObject<T
 
 declare class OIMCollectionStoreMapDriven<TEntity extends object, TPk extends TOIMPk> extends OIMCollectionStore<TEntity, TPk> {
     protected readonly slots: Map<TPk, TOIMEntitySlot<TEntity, TPk>>;
+    protected readonly reservedSlots: Map<TPk, TOIMEntitySlot<TEntity, TPk>>;
     setOneByPk(pk: TPk, entity: TEntity): TOIMEntitySlot<TEntity, TPk>;
+    getOrReserveSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk>;
     setManyByPks(pks: readonly TPk[], entities: TEntity[]): TOIMEntitySlot<TEntity, TPk>[];
     getSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk> | undefined;
     getSlotsByPks(pks: readonly TPk[]): TOIMEntitySlot<TEntity, TPk>[];

package/dist/index.d.ts

@@ -10,6 +10,13 @@ type TOIMEntitySlotResolver<TPk extends TOIMPk> = (pk: TPk) => TOIMAnyEntitySlot
 declare abstract class OIMCollectionStore<TEntity extends object, TPk extends TOIMPk> {
     abstract setOneByPk(pk: TPk, entity: TEntity): TOIMEntitySlot<TEntity, TPk>;
     abstract getSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk> | undefined;
+    /**
+     * Returns the canonical slot for `pk`, creating a reserved empty slot
+     * (`item: undefined`) if no entity exists yet. The reserved slot is a stable
+     * reference that fills in when the entity is later written, so indexes can
+     * hold it ahead of the entity's arrival without crashing.
+     */
+    abstract getOrReserveSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk>;
     abstract getSlotsByPks(pks: readonly TPk[]): TOIMEntitySlot<TEntity, TPk>[];
     abstract getAllSlots(): TOIMEntitySlot<TEntity, TPk>[];
     abstract removeOneByPk(pk: TPk): void;
@@ -381,6 +388,7 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     getOneByPk(pk: TPk): TEntity | undefined;
     getManyByPks(pks: readonly TPk[]): TEntity[];
     getSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk> | undefined;
+    getOrReserveSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk>;
     getSlotsByPks(pks: readonly TPk[]): TOIMEntitySlot<TEntity, TPk>[];
     getAllSlots(): TOIMEntitySlot<TEntity, TPk>[];
     upsertOneByPk(pk: TPk, entity: Partial<TEntity>): TOIMEntitySlot<TEntity, TPk>;
@@ -849,7 +857,9 @@ declare class OIMReactiveObject<TKey extends string, TValue> extends OIMObject<T
 
 declare class OIMCollectionStoreMapDriven<TEntity extends object, TPk extends TOIMPk> extends OIMCollectionStore<TEntity, TPk> {
     protected readonly slots: Map<TPk, TOIMEntitySlot<TEntity, TPk>>;
+    protected readonly reservedSlots: Map<TPk, TOIMEntitySlot<TEntity, TPk>>;
     setOneByPk(pk: TPk, entity: TEntity): TOIMEntitySlot<TEntity, TPk>;
+    getOrReserveSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk>;
     setManyByPks(pks: readonly TPk[], entities: TEntity[]): TOIMEntitySlot<TEntity, TPk>[];
     getSlotByPk(pk: TPk): TOIMEntitySlot<TEntity, TPk> | undefined;
     getSlotsByPks(pks: readonly TPk[]): TOIMEntitySlot<TEntity, TPk>[];

package/dist/index.js

@@ -779,17 +779,39 @@ var OIMCollectionStoreMapDriven = class extends OIMCollectionStore {
   constructor() {
     super(...arguments);
     this.slots = /* @__PURE__ */ new Map();
+    // Slots reserved by indexes for PKs whose entity has not arrived yet.
+    // They carry `item: undefined` and live apart from `slots` so they do not
+    // leak into entity enumeration (getAll/getAllPks/countAll). When the entity
+    // is finally written, the reserved slot is promoted into `slots` — keeping
+    // the reference that indexes already hold, so it fills in live.
+    this.reservedSlots = /* @__PURE__ */ new Map();
   }
   setOneByPk(pk, entity) {
     const slot = this.slots.get(pk);
     if (slot) {
       slot.item = entity;
       return slot;
-    } else {
-      const nextSlot = { pk, item: entity };
-      this.slots.set(pk, nextSlot);
-      return nextSlot;
     }
+    const reserved = this.reservedSlots.get(pk);
+    if (reserved) {
+      reserved.item = entity;
+      this.reservedSlots.delete(pk);
+      this.slots.set(pk, reserved);
+      return reserved;
+    }
+    const nextSlot = { pk, item: entity };
+    this.slots.set(pk, nextSlot);
+    return nextSlot;
+  }
+  getOrReserveSlotByPk(pk) {
+    const slot = this.slots.get(pk);
+    if (slot) return slot;
+    let reserved = this.reservedSlots.get(pk);
+    if (!reserved) {
+      reserved = { pk, item: void 0 };
+      this.reservedSlots.set(pk, reserved);
+    }
+    return reserved;
   }
   setManyByPks(pks, entities) {
     const slots = [];
@@ -822,6 +844,11 @@ var OIMCollectionStoreMapDriven = class extends OIMCollectionStore {
     const slot = this.slots.get(pk);
     if (slot) slot.item = void 0;
     this.slots.delete(pk);
+    const reserved = this.reservedSlots.get(pk);
+    if (reserved) {
+      reserved.item = void 0;
+      this.reservedSlots.delete(pk);
+    }
   }
   removeManyByPks(pks) {
     for (const pk of pks) {
@@ -859,6 +886,10 @@ var OIMCollectionStoreMapDriven = class extends OIMCollectionStore {
       slot.item = void 0;
     }
     this.slots.clear();
+    for (const slot of this.reservedSlots.values()) {
+      slot.item = void 0;
+    }
+    this.reservedSlots.clear();
   }
   getAllPks() {
     return Array.from(this.slots.keys());
@@ -900,6 +931,9 @@ var OIMCollection = class {
   getSlotByPk(pk) {
     return this.store.getSlotByPk(pk);
   }
+  getOrReserveSlotByPk(pk) {
+    return this.store.getOrReserveSlotByPk(pk);
+  }
   getSlotsByPks(pks) {
     return this.store.getSlotsByPks(pks);
   }
@@ -1525,7 +1559,7 @@ var OIMReactiveIndexManualArrayBased = class extends OIMReactiveIndexArrayBased
 // src/core/OIMReactiveCollectionIndexManualArrayBased.ts
 var OIMReactiveCollectionIndexManualArrayBased = class extends OIMReactiveIndexManualArrayBased {
   constructor(queue, opts) {
-    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getSlotByPk(pk) : opts.resolveSlot;
+    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getOrReserveSlotByPk(pk) : opts.resolveSlot;
     super(queue, {
       indexOptions: opts.indexOptions
     });
@@ -1575,11 +1609,7 @@ var OIMReactiveCollectionIndexManualArrayBased = class extends OIMReactiveIndexM
   }
   resolveRequiredSlot(pk) {
     const slot = this.resolveSlot(pk);
-    if (!slot) {
-      throw new Error(
-        `[OIMReactiveCollectionIndexManualArrayBased]: Unable to resolve slot for PK "${String(pk)}".`
-      );
-    }
+    if (!slot) return { pk, item: void 0 };
     return slot;
   }
 };
@@ -1647,7 +1677,7 @@ var OIMReactiveIndexManualSetBased = class extends OIMReactiveIndexSetBased {
 // src/core/OIMReactiveCollectionIndexManualSetBased.ts
 var OIMReactiveCollectionIndexManualSetBased = class extends OIMReactiveIndexManualSetBased {
   constructor(queue, opts) {
-    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getSlotByPk(pk) : opts.resolveSlot;
+    const resolveSlot = opts.collection !== void 0 ? (pk) => opts.collection.getOrReserveSlotByPk(pk) : opts.resolveSlot;
     super(queue, {
       indexOptions: opts.indexOptions
     });
@@ -1701,11 +1731,7 @@ var OIMReactiveCollectionIndexManualSetBased = class extends OIMReactiveIndexMan
   }
   resolveRequiredSlot(pk) {
     const slot = this.resolveSlot(pk);
-    if (!slot) {
-      throw new Error(
-        `[OIMReactiveCollectionIndexManualSetBased]: Unable to resolve slot for PK "${String(pk)}".`
-      );
-    }
+    if (!slot) return { pk, item: void 0 };
     return slot;
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oimdb/core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Core in-memory data library with type-safe indices, reactive subscriptions, and event processing",
   "type": "module",
   "main": "./dist/index.cjs",