@oimdb/core 1.0.6 → 1.2.0

package/dist/index.d.cts

@@ -61,10 +61,23 @@ interface TOIMIndexUpdatePayload<TKey> {
  * Returns true if the arrays are considered equal, false if they differ. */
 type TOIMIndexComparator<TPk extends TOIMPk> = (existingPks: readonly TPk[], newPks: readonly TPk[]) => boolean;
 
+declare abstract class OIMIndexStore<TKey extends TOIMPk, TPk extends TOIMPk> {
+    abstract setOneByKey(key: TKey, pks: Set<TPk>): void;
+    abstract removeOneByKey(key: TKey): void;
+    abstract removeManyByKeys(keys: readonly TKey[]): void;
+    abstract getOneByKey(key: TKey): Set<TPk> | undefined;
+    abstract getManyByKeys(keys: readonly TKey[]): Map<TKey, Set<TPk>>;
+    abstract getAllKeys(): TKey[];
+    abstract getAll(): Map<TKey, Set<TPk>>;
+    abstract countAll(): number;
+    abstract clear(): void;
+}
+
 /**
  * Configuration options for index instances */
-type TOIMIndexOptions<TPk extends TOIMPk> = {
+type TOIMIndexOptions<TIndexKey extends TOIMPk, TPk extends TOIMPk> = {
     comparePks?: TOIMIndexComparator<TPk>;
+    store?: OIMIndexStore<TIndexKey, TPk>;
 };
 
 /**
@@ -72,12 +85,12 @@ type TOIMIndexOptions<TPk extends TOIMPk> = {
  * Provides common functionality and event system for key-to-PKs mappings.
  */
 declare abstract class OIMIndex<TKey extends TOIMPk, TPk extends TOIMPk> {
-    protected readonly pks: Map<TKey, Set<TPk>>;
     protected readonly comparePks?: TOIMIndexComparator<TPk>;
+    protected readonly store: OIMIndexStore<TKey, TPk>;
     readonly emitter: OIMEventEmitter<{
         0: TOIMIndexUpdatePayload<TKey>;
     }>;
-    constructor(options?: TOIMIndexOptions<TPk>);
+    constructor(options?: TOIMIndexOptions<TKey, TPk>);
     /**
      * Get primary keys for multiple index keys
      */
@@ -136,16 +149,56 @@ declare abstract class OIMIndex<TKey extends TOIMPk, TPk extends TOIMPk> {
     protected emitUpdate(keys: TKey[]): void;
 }
 
+/**
+ * Manual index that allows direct manipulation of key-to-primary-keys mappings.
+ * Extends the abstract OIMIndex with manual control methods and optional comparison.
+ */
+declare class OIMIndexManual<TIndexKey extends TOIMPk, TPk extends TOIMPk> extends OIMIndex<TIndexKey, TPk> {
+    constructor(options?: TOIMIndexOptions<TIndexKey, TPk>);
+    /**
+     * Set primary keys for a specific index key, replacing any existing values.
+     * Uses optional comparator to skip updates if PKs haven't actually changed.
+     */
+    setPks(key: TIndexKey, pks: TPk[]): void;
+    /**
+     * Add primary keys to a specific index key
+     */
+    addPks(key: TIndexKey, pks: readonly TPk[]): void;
+    /**
+     * Remove primary keys from a specific index key
+     */
+    removePks(key: TIndexKey, pks: readonly TPk[]): void;
+    /**
+     * Clear all primary keys for a specific index key, or all keys if no key specified
+     */
+    clear(key?: TIndexKey): void;
+}
+
+/**
+ * Static class containing OIMDB settings and constants.
+ * Provides access to configuration values used throughout the library.
+ */
+declare class OIMDBSettings {
+    /**
+     * Fixed key used in the manual index to store updated keys set in coalescers.
+     * This constant is exported so users can create their own indexes and pass them to coalescers.
+     */
+    static readonly UPDATED_KEYS_INDEX_KEY: "__updatedKeys__";
+}
+
 /**
  * Base abstract coalescer that groups updates by keys and emits consolidated events.
  * Designed to be extended for different entity types (collections, indexes, etc.).
  */
-declare abstract class OIMUpdateEventCoalescer<TKey> {
+declare abstract class OIMUpdateEventCoalescer<TKey extends TOIMPk> {
     readonly emitter: OIMEventEmitter<{
         0: void;
+        1: void;
+        2: void;
     }>;
-    protected updatedKeys: Set<TKey>;
+    protected readonly updatedKeysIndex: OIMIndexManual<typeof OIMDBSettings.UPDATED_KEYS_INDEX_KEY, TKey>;
     private hasEmittedChanges;
+    constructor(index?: OIMIndexManual<typeof OIMDBSettings.UPDATED_KEYS_INDEX_KEY, TKey>);
     /**
      * Get the set of keys that have been updated since last clear
      */
@@ -157,7 +210,7 @@ declare abstract class OIMUpdateEventCoalescer<TKey> {
     /**
      * Add keys to the updated set and emit HAS_CHANGES event if needed
      */
-    protected addUpdatedKeys(keys: TKey[]): void;
+    protected addUpdatedKeys(keys: readonly TKey[]): void;
     /**
      * Clean up event listeners when coalescer is no longer needed
      */
@@ -176,10 +229,16 @@ type TOIMEventQueueOptions = {
     scheduler?: OIMEventQueueScheduler;
 };
 
+declare enum EOIMEventQueueEventType {
+    AFTER_FLUSH = 0,
+    BEFORE_FLUSH = 1
+}
+
 /**
  * Event queue that can optionally integrate with a scheduler for automatic flushing.
  */
 declare class OIMEventQueue {
+    readonly emitter: OIMEventEmitter<Record<EOIMEventQueueEventType, void>>;
     protected queue: (() => void)[];
     protected readonly scheduler?: OIMEventQueueScheduler;
     protected flushBound?: () => void;
@@ -214,7 +273,7 @@ declare class OIMEventQueue {
 
 /**
  * Options for creating an update event emitter */
-type TOIMUpdateEventEmitterOptions<TKey> = {
+type TOIMUpdateEventEmitterOptions<TKey extends TOIMPk> = {
     coalescer: OIMUpdateEventCoalescer<TKey>;
     queue: OIMEventQueue;
 };
@@ -223,7 +282,7 @@ type TOIMUpdateEventEmitterOptions<TKey> = {
  * Universal event emitter that handles subscriptions and notifications for any key type.
  * Optimized for performance with adaptive algorithms and memory management.
  */
-declare class OIMUpdateEventEmitter<TKey> {
+declare class OIMUpdateEventEmitter<TKey extends TOIMPk> {
     protected keyHandlers: Map<TKey, Set<TOIMEventHandler<void>>>;
     protected coalescer: OIMUpdateEventCoalescer<TKey>;
     protected queue: OIMEventQueue;
@@ -261,7 +320,7 @@ declare enum EOIMIndexEventType {
  * Index-specific coalescer that tracks index key updates and emits consolidated change events.
  * Takes an event emitter directly instead of the whole index to avoid circular dependencies.
  */
-declare class OIMUpdateEventCoalescerIndex<TIndexKey> extends OIMUpdateEventCoalescer<TIndexKey> {
+declare class OIMUpdateEventCoalescerIndex<TIndexKey extends TOIMPk> extends OIMUpdateEventCoalescer<TIndexKey> {
     private readonly indexEmitter;
     constructor(indexEmitter: OIMEventEmitter<{
         [EOIMIndexEventType.UPDATE]: TOIMIndexUpdatePayload<TIndexKey>;
@@ -327,6 +386,8 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     upsertMany(entities: TEntity[]): void;
     removeOne(entity: TEntity): void;
     removeMany(entities: TEntity[]): void;
+    removeOneByPk(pk: TPk): void;
+    removeManyByPks(pks: readonly TPk[]): void;
     clear(): void;
     countAll(): number;
     getAll(): TEntity[];
@@ -354,48 +415,10 @@ declare class OIMUpdateEventCoalescerCollection<TPk extends TOIMPk> extends OIMU
     private handleUpdate;
 }
 
-declare class OIMReactiveCollection<TEntity extends object, TPk extends TOIMPk> {
-    readonly collection: OIMCollection<TEntity, TPk>;
+declare class OIMReactiveCollection<TEntity extends object, TPk extends TOIMPk> extends OIMCollection<TEntity, TPk> {
     readonly updateEventEmitter: OIMUpdateEventEmitter<TPk>;
     readonly coalescer: OIMUpdateEventCoalescerCollection<TPk>;
-    constructor(queue: OIMEventQueue, opts?: {
-        collectionOpts?: TOIMCollectionOptions<TEntity, TPk>;
-    });
-    upsertMany(entities: TEntity[]): void;
-    upsertOne(entity: TEntity): void;
-    removeMany(entities: TEntity[]): void;
-    removeOne(entity: TEntity): void;
-    getOneByPk(pk: TPk): TEntity | undefined;
-    getManyByPks(pks: readonly TPk[]): TEntity[];
-    clear(): void;
-    countAll(): number;
-    getAll(): TEntity[];
-    getAllPks(): TPk[];
-}
-
-/**
- * Manual index that allows direct manipulation of key-to-primary-keys mappings.
- * Extends the abstract OIMIndex with manual control methods and optional comparison.
- */
-declare class OIMIndexManual<TIndexKey extends TOIMPk, TPk extends TOIMPk> extends OIMIndex<TIndexKey, TPk> {
-    constructor(options?: TOIMIndexOptions<TPk>);
-    /**
-     * Set primary keys for a specific index key, replacing any existing values.
-     * Uses optional comparator to skip updates if PKs haven't actually changed.
-     */
-    setPks(key: TIndexKey, pks: TPk[]): void;
-    /**
-     * Add primary keys to a specific index key
-     */
-    addPks(key: TIndexKey, pks: readonly TPk[]): void;
-    /**
-     * Remove primary keys from a specific index key
-     */
-    removePks(key: TIndexKey, pks: readonly TPk[]): void;
-    /**
-     * Clear all primary keys for a specific index key, or all keys if no key specified
-     */
-    clear(key?: TIndexKey): void;
+    constructor(queue: OIMEventQueue, opts?: TOIMCollectionOptions<TEntity, TPk>);
 }
 
 declare class OIMReactiveIndexManual<TKey extends TOIMPk, TPk extends TOIMPk> extends OIMReactiveIndex<TKey, TPk, OIMIndexManual<TKey, TPk>> {
@@ -409,11 +432,11 @@ declare class OIMReactiveIndexManual<TKey extends TOIMPk, TPk extends TOIMPk> ex
     clear(key?: TKey): void;
 }
 
-declare class OIMRICollection<TEntity extends object, TPk extends TOIMPk, TIndexName extends string, TIndexKey extends TOIMPk, TIndex extends OIMIndex<TIndexKey, TPk>, TReactiveIndex extends OIMReactiveIndex<TIndexKey, TPk, TIndex>> extends OIMReactiveCollection<TEntity, TPk> {
-    readonly indexes: Record<TIndexName, TReactiveIndex>;
+declare class OIMRICollection<TEntity extends object, TPk extends TOIMPk, TIndexName extends string, TIndexKey extends TOIMPk, TIndex extends OIMIndex<TIndexKey, TPk>, TReactiveIndex extends OIMReactiveIndex<TIndexKey, TPk, TIndex>, TReactiveIndexMap extends Record<TIndexName, TReactiveIndex> = Record<TIndexName, TReactiveIndex>> extends OIMReactiveCollection<TEntity, TPk> {
+    readonly indexes?: TReactiveIndexMap;
     constructor(queue: OIMEventQueue, opts: {
         collectionOpts?: TOIMCollectionOptions<TEntity, TPk>;
-        indexes: Record<TIndexName, TReactiveIndex>;
+        indexes?: TReactiveIndexMap;
     });
 }
 
@@ -585,7 +608,9 @@ declare class OIMEventQueueSchedulerFactory {
 /**
  * Event types for update coalescers */
 declare enum EOIMUpdateEventCoalescerEventType {
-    HAS_CHANGES = 0
+    HAS_CHANGES = 0,
+    BEFORE_FLUSH = 1,
+    AFTER_FLUSH = 2
 }
 
 type TOIMIndexKey = string | number | bigint;
@@ -601,4 +626,4 @@ type TOIMUpdatePayload<TKey> = {
     keys: readonly TKey[];
 };
 
-export { EOIMCollectionEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMUpdateEventCoalescerEventType, type IOIMEventQueueSchedulerEvents, OIMCollection, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexComparatorFactory, OIMIndexManual, OIMMap2Keys, OIMPkSelectorFactory, OIMRICollection, OIMReactiveCollection, OIMReactiveIndex, OIMReactiveIndexManual, OIMUpdateEventCoalescer, OIMUpdateEventCoalescerCollection, OIMUpdateEventCoalescerIndex, OIMUpdateEventEmitter, type TOIMCollectionOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptions, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMPk, type TOIMPkSelector, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdateEventEmitterOptions, type TOIMUpdatePayload };
+export { EOIMCollectionEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMUpdateEventCoalescerEventType, type IOIMEventQueueSchedulerEvents, OIMCollection, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMDBSettings, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexComparatorFactory, OIMIndexManual, OIMMap2Keys, OIMPkSelectorFactory, OIMRICollection, OIMReactiveCollection, OIMReactiveIndex, OIMReactiveIndexManual, OIMUpdateEventCoalescer, OIMUpdateEventCoalescerCollection, OIMUpdateEventCoalescerIndex, OIMUpdateEventEmitter, type TOIMCollectionOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptions, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMPk, type TOIMPkSelector, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdateEventEmitterOptions, type TOIMUpdatePayload };

package/dist/index.d.ts

@@ -61,10 +61,23 @@ interface TOIMIndexUpdatePayload<TKey> {
  * Returns true if the arrays are considered equal, false if they differ. */
 type TOIMIndexComparator<TPk extends TOIMPk> = (existingPks: readonly TPk[], newPks: readonly TPk[]) => boolean;
 
+declare abstract class OIMIndexStore<TKey extends TOIMPk, TPk extends TOIMPk> {
+    abstract setOneByKey(key: TKey, pks: Set<TPk>): void;
+    abstract removeOneByKey(key: TKey): void;
+    abstract removeManyByKeys(keys: readonly TKey[]): void;
+    abstract getOneByKey(key: TKey): Set<TPk> | undefined;
+    abstract getManyByKeys(keys: readonly TKey[]): Map<TKey, Set<TPk>>;
+    abstract getAllKeys(): TKey[];
+    abstract getAll(): Map<TKey, Set<TPk>>;
+    abstract countAll(): number;
+    abstract clear(): void;
+}
+
 /**
  * Configuration options for index instances */
-type TOIMIndexOptions<TPk extends TOIMPk> = {
+type TOIMIndexOptions<TIndexKey extends TOIMPk, TPk extends TOIMPk> = {
     comparePks?: TOIMIndexComparator<TPk>;
+    store?: OIMIndexStore<TIndexKey, TPk>;
 };
 
 /**
@@ -72,12 +85,12 @@ type TOIMIndexOptions<TPk extends TOIMPk> = {
  * Provides common functionality and event system for key-to-PKs mappings.
  */
 declare abstract class OIMIndex<TKey extends TOIMPk, TPk extends TOIMPk> {
-    protected readonly pks: Map<TKey, Set<TPk>>;
     protected readonly comparePks?: TOIMIndexComparator<TPk>;
+    protected readonly store: OIMIndexStore<TKey, TPk>;
     readonly emitter: OIMEventEmitter<{
         0: TOIMIndexUpdatePayload<TKey>;
     }>;
-    constructor(options?: TOIMIndexOptions<TPk>);
+    constructor(options?: TOIMIndexOptions<TKey, TPk>);
     /**
      * Get primary keys for multiple index keys
      */
@@ -136,16 +149,56 @@ declare abstract class OIMIndex<TKey extends TOIMPk, TPk extends TOIMPk> {
     protected emitUpdate(keys: TKey[]): void;
 }
 
+/**
+ * Manual index that allows direct manipulation of key-to-primary-keys mappings.
+ * Extends the abstract OIMIndex with manual control methods and optional comparison.
+ */
+declare class OIMIndexManual<TIndexKey extends TOIMPk, TPk extends TOIMPk> extends OIMIndex<TIndexKey, TPk> {
+    constructor(options?: TOIMIndexOptions<TIndexKey, TPk>);
+    /**
+     * Set primary keys for a specific index key, replacing any existing values.
+     * Uses optional comparator to skip updates if PKs haven't actually changed.
+     */
+    setPks(key: TIndexKey, pks: TPk[]): void;
+    /**
+     * Add primary keys to a specific index key
+     */
+    addPks(key: TIndexKey, pks: readonly TPk[]): void;
+    /**
+     * Remove primary keys from a specific index key
+     */
+    removePks(key: TIndexKey, pks: readonly TPk[]): void;
+    /**
+     * Clear all primary keys for a specific index key, or all keys if no key specified
+     */
+    clear(key?: TIndexKey): void;
+}
+
+/**
+ * Static class containing OIMDB settings and constants.
+ * Provides access to configuration values used throughout the library.
+ */
+declare class OIMDBSettings {
+    /**
+     * Fixed key used in the manual index to store updated keys set in coalescers.
+     * This constant is exported so users can create their own indexes and pass them to coalescers.
+     */
+    static readonly UPDATED_KEYS_INDEX_KEY: "__updatedKeys__";
+}
+
 /**
  * Base abstract coalescer that groups updates by keys and emits consolidated events.
  * Designed to be extended for different entity types (collections, indexes, etc.).
  */
-declare abstract class OIMUpdateEventCoalescer<TKey> {
+declare abstract class OIMUpdateEventCoalescer<TKey extends TOIMPk> {
     readonly emitter: OIMEventEmitter<{
         0: void;
+        1: void;
+        2: void;
     }>;
-    protected updatedKeys: Set<TKey>;
+    protected readonly updatedKeysIndex: OIMIndexManual<typeof OIMDBSettings.UPDATED_KEYS_INDEX_KEY, TKey>;
     private hasEmittedChanges;
+    constructor(index?: OIMIndexManual<typeof OIMDBSettings.UPDATED_KEYS_INDEX_KEY, TKey>);
     /**
      * Get the set of keys that have been updated since last clear
      */
@@ -157,7 +210,7 @@ declare abstract class OIMUpdateEventCoalescer<TKey> {
     /**
      * Add keys to the updated set and emit HAS_CHANGES event if needed
      */
-    protected addUpdatedKeys(keys: TKey[]): void;
+    protected addUpdatedKeys(keys: readonly TKey[]): void;
     /**
      * Clean up event listeners when coalescer is no longer needed
      */
@@ -176,10 +229,16 @@ type TOIMEventQueueOptions = {
     scheduler?: OIMEventQueueScheduler;
 };
 
+declare enum EOIMEventQueueEventType {
+    AFTER_FLUSH = 0,
+    BEFORE_FLUSH = 1
+}
+
 /**
  * Event queue that can optionally integrate with a scheduler for automatic flushing.
  */
 declare class OIMEventQueue {
+    readonly emitter: OIMEventEmitter<Record<EOIMEventQueueEventType, void>>;
     protected queue: (() => void)[];
     protected readonly scheduler?: OIMEventQueueScheduler;
     protected flushBound?: () => void;
@@ -214,7 +273,7 @@ declare class OIMEventQueue {
 
 /**
  * Options for creating an update event emitter */
-type TOIMUpdateEventEmitterOptions<TKey> = {
+type TOIMUpdateEventEmitterOptions<TKey extends TOIMPk> = {
     coalescer: OIMUpdateEventCoalescer<TKey>;
     queue: OIMEventQueue;
 };
@@ -223,7 +282,7 @@ type TOIMUpdateEventEmitterOptions<TKey> = {
  * Universal event emitter that handles subscriptions and notifications for any key type.
  * Optimized for performance with adaptive algorithms and memory management.
  */
-declare class OIMUpdateEventEmitter<TKey> {
+declare class OIMUpdateEventEmitter<TKey extends TOIMPk> {
     protected keyHandlers: Map<TKey, Set<TOIMEventHandler<void>>>;
     protected coalescer: OIMUpdateEventCoalescer<TKey>;
     protected queue: OIMEventQueue;
@@ -261,7 +320,7 @@ declare enum EOIMIndexEventType {
  * Index-specific coalescer that tracks index key updates and emits consolidated change events.
  * Takes an event emitter directly instead of the whole index to avoid circular dependencies.
  */
-declare class OIMUpdateEventCoalescerIndex<TIndexKey> extends OIMUpdateEventCoalescer<TIndexKey> {
+declare class OIMUpdateEventCoalescerIndex<TIndexKey extends TOIMPk> extends OIMUpdateEventCoalescer<TIndexKey> {
     private readonly indexEmitter;
     constructor(indexEmitter: OIMEventEmitter<{
         [EOIMIndexEventType.UPDATE]: TOIMIndexUpdatePayload<TIndexKey>;
@@ -327,6 +386,8 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     upsertMany(entities: TEntity[]): void;
     removeOne(entity: TEntity): void;
     removeMany(entities: TEntity[]): void;
+    removeOneByPk(pk: TPk): void;
+    removeManyByPks(pks: readonly TPk[]): void;
     clear(): void;
     countAll(): number;
     getAll(): TEntity[];
@@ -354,48 +415,10 @@ declare class OIMUpdateEventCoalescerCollection<TPk extends TOIMPk> extends OIMU
     private handleUpdate;
 }
 
-declare class OIMReactiveCollection<TEntity extends object, TPk extends TOIMPk> {
-    readonly collection: OIMCollection<TEntity, TPk>;
+declare class OIMReactiveCollection<TEntity extends object, TPk extends TOIMPk> extends OIMCollection<TEntity, TPk> {
     readonly updateEventEmitter: OIMUpdateEventEmitter<TPk>;
     readonly coalescer: OIMUpdateEventCoalescerCollection<TPk>;
-    constructor(queue: OIMEventQueue, opts?: {
-        collectionOpts?: TOIMCollectionOptions<TEntity, TPk>;
-    });
-    upsertMany(entities: TEntity[]): void;
-    upsertOne(entity: TEntity): void;
-    removeMany(entities: TEntity[]): void;
-    removeOne(entity: TEntity): void;
-    getOneByPk(pk: TPk): TEntity | undefined;
-    getManyByPks(pks: readonly TPk[]): TEntity[];
-    clear(): void;
-    countAll(): number;
-    getAll(): TEntity[];
-    getAllPks(): TPk[];
-}
-
-/**
- * Manual index that allows direct manipulation of key-to-primary-keys mappings.
- * Extends the abstract OIMIndex with manual control methods and optional comparison.
- */
-declare class OIMIndexManual<TIndexKey extends TOIMPk, TPk extends TOIMPk> extends OIMIndex<TIndexKey, TPk> {
-    constructor(options?: TOIMIndexOptions<TPk>);
-    /**
-     * Set primary keys for a specific index key, replacing any existing values.
-     * Uses optional comparator to skip updates if PKs haven't actually changed.
-     */
-    setPks(key: TIndexKey, pks: TPk[]): void;
-    /**
-     * Add primary keys to a specific index key
-     */
-    addPks(key: TIndexKey, pks: readonly TPk[]): void;
-    /**
-     * Remove primary keys from a specific index key
-     */
-    removePks(key: TIndexKey, pks: readonly TPk[]): void;
-    /**
-     * Clear all primary keys for a specific index key, or all keys if no key specified
-     */
-    clear(key?: TIndexKey): void;
+    constructor(queue: OIMEventQueue, opts?: TOIMCollectionOptions<TEntity, TPk>);
 }
 
 declare class OIMReactiveIndexManual<TKey extends TOIMPk, TPk extends TOIMPk> extends OIMReactiveIndex<TKey, TPk, OIMIndexManual<TKey, TPk>> {
@@ -409,11 +432,11 @@ declare class OIMReactiveIndexManual<TKey extends TOIMPk, TPk extends TOIMPk> ex
     clear(key?: TKey): void;
 }
 
-declare class OIMRICollection<TEntity extends object, TPk extends TOIMPk, TIndexName extends string, TIndexKey extends TOIMPk, TIndex extends OIMIndex<TIndexKey, TPk>, TReactiveIndex extends OIMReactiveIndex<TIndexKey, TPk, TIndex>> extends OIMReactiveCollection<TEntity, TPk> {
-    readonly indexes: Record<TIndexName, TReactiveIndex>;
+declare class OIMRICollection<TEntity extends object, TPk extends TOIMPk, TIndexName extends string, TIndexKey extends TOIMPk, TIndex extends OIMIndex<TIndexKey, TPk>, TReactiveIndex extends OIMReactiveIndex<TIndexKey, TPk, TIndex>, TReactiveIndexMap extends Record<TIndexName, TReactiveIndex> = Record<TIndexName, TReactiveIndex>> extends OIMReactiveCollection<TEntity, TPk> {
+    readonly indexes?: TReactiveIndexMap;
     constructor(queue: OIMEventQueue, opts: {
         collectionOpts?: TOIMCollectionOptions<TEntity, TPk>;
-        indexes: Record<TIndexName, TReactiveIndex>;
+        indexes?: TReactiveIndexMap;
     });
 }
 
@@ -585,7 +608,9 @@ declare class OIMEventQueueSchedulerFactory {
 /**
  * Event types for update coalescers */
 declare enum EOIMUpdateEventCoalescerEventType {
-    HAS_CHANGES = 0
+    HAS_CHANGES = 0,
+    BEFORE_FLUSH = 1,
+    AFTER_FLUSH = 2
 }
 
 type TOIMIndexKey = string | number | bigint;
@@ -601,4 +626,4 @@ type TOIMUpdatePayload<TKey> = {
     keys: readonly TKey[];
 };
 
-export { EOIMCollectionEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMUpdateEventCoalescerEventType, type IOIMEventQueueSchedulerEvents, OIMCollection, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexComparatorFactory, OIMIndexManual, OIMMap2Keys, OIMPkSelectorFactory, OIMRICollection, OIMReactiveCollection, OIMReactiveIndex, OIMReactiveIndexManual, OIMUpdateEventCoalescer, OIMUpdateEventCoalescerCollection, OIMUpdateEventCoalescerIndex, OIMUpdateEventEmitter, type TOIMCollectionOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptions, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMPk, type TOIMPkSelector, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdateEventEmitterOptions, type TOIMUpdatePayload };
+export { EOIMCollectionEventType, EOIMEventQueueEventType, EOIMEventQueueSchedulerEventType, EOIMIndexEventType, EOIMUpdateEventCoalescerEventType, type IOIMEventQueueSchedulerEvents, OIMCollection, OIMCollectionStore, OIMCollectionStoreMapDriven, OIMComparatorFactory, OIMDBSettings, OIMEntityUpdaterFactory, OIMEventEmitter, OIMEventQueue, OIMEventQueueScheduler, OIMEventQueueSchedulerAnimationFrame, OIMEventQueueSchedulerFactory, OIMEventQueueSchedulerImmediate, OIMEventQueueSchedulerMicrotask, OIMEventQueueSchedulerTimeout, OIMIndex, OIMIndexComparatorFactory, OIMIndexManual, OIMMap2Keys, OIMPkSelectorFactory, OIMRICollection, OIMReactiveCollection, OIMReactiveIndex, OIMReactiveIndexManual, OIMUpdateEventCoalescer, OIMUpdateEventCoalescerCollection, OIMUpdateEventCoalescerIndex, OIMUpdateEventEmitter, type TOIMCollectionOptions, type TOIMCollectionUpdatePayload, type TOIMComparator, type TOIMEntityUpdater, type TOIMEventHandler, type TOIMEventQueueOptions, type TOIMIndexComparator, type TOIMIndexKey, type TOIMIndexOptions, type TOIMIndexPksUpdatePayload, type TOIMIndexUpdatePayload, type TOIMPk, type TOIMPkSelector, type TOIMSchedulerOptions, type TOIMSchedulerType, type TOIMUpdateEventEmitterOptions, type TOIMUpdatePayload };