@oimdb/core 1.1.0 → 1.2.1

package/README.md

@@ -366,6 +366,48 @@ const user = selectEntityByPk(users, 'user1');
 const teamUsers = useSelectEntitiesByPks(users, userIds);
 ```
 
+### With Redux (@oimdb/redux-adapter)
+
+Migrate from Redux to OIMDB gradually or use both systems side-by-side with automatic two-way synchronization:
+
+```typescript
+import { OIMDBAdapter } from '@oimdb/redux-adapter';
+import { createStore, combineReducers, applyMiddleware } from 'redux';
+
+// Create Redux adapter
+const adapter = new OIMDBAdapter(queue);
+
+// Create Redux reducer from OIMDB collection
+const usersReducer = adapter.createCollectionReducer(users);
+
+// Create middleware for automatic flushing
+const middleware = adapter.createMiddleware();
+
+// Use in existing Redux store
+const store = createStore(
+    combineReducers({
+        users: usersReducer, // OIMDB-backed reducer
+        ui: uiReducer,       // Existing Redux reducer
+    }),
+    applyMiddleware(middleware)
+);
+
+adapter.setStore(store);
+
+// OIMDB changes automatically sync to Redux
+// Redux actions automatically sync back to OIMDB with child reducers
+// Middleware automatically flushes queue after each action - no manual flush needed!
+```
+
+**Key Benefits:**
+- **🔄 Gradual Migration**: Migrate one collection at a time without breaking changes
+- **🔄 Two-Way Sync**: Automatic synchronization between OIMDB and Redux
+- **⚡ Automatic Flushing**: Middleware automatically processes events after Redux actions
+- **📦 Production Ready**: Battle-tested adapter optimized for large datasets
+- **🎯 Flexible**: Works with any Redux state structure via custom mappers
+
+[📖 See @oimdb/redux-adapter documentation](../redux-adapter/README.md) for complete migration guide and examples.
+
 ### Standalone Usage
 
 Use core classes directly for maximum control:

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   EOIMCollectionEventType: () => EOIMCollectionEventType,
+  EOIMEventQueueEventType: () => EOIMEventQueueEventType,
   EOIMEventQueueSchedulerEventType: () => EOIMEventQueueSchedulerEventType,
   EOIMIndexEventType: () => EOIMIndexEventType,
   EOIMUpdateEventCoalescerEventType: () => EOIMUpdateEventCoalescerEventType,
@@ -348,6 +349,8 @@ var OIMIndex = class {
 // src/enum/EOIMUpdateEventCoalescerEventType.ts
 var EOIMUpdateEventCoalescerEventType = /* @__PURE__ */ ((EOIMUpdateEventCoalescerEventType2) => {
   EOIMUpdateEventCoalescerEventType2[EOIMUpdateEventCoalescerEventType2["HAS_CHANGES"] = 0] = "HAS_CHANGES";
+  EOIMUpdateEventCoalescerEventType2[EOIMUpdateEventCoalescerEventType2["BEFORE_FLUSH"] = 1] = "BEFORE_FLUSH";
+  EOIMUpdateEventCoalescerEventType2[EOIMUpdateEventCoalescerEventType2["AFTER_FLUSH"] = 2] = "AFTER_FLUSH";
   return EOIMUpdateEventCoalescerEventType2;
 })(EOIMUpdateEventCoalescerEventType || {});
 
@@ -584,8 +587,16 @@ var OIMUpdateEventCoalescer = class {
    * Clear all updated keys and reset the changed state
    */
   clearUpdatedKeys() {
+    this.emitter.emit(
+      1 /* BEFORE_FLUSH */,
+      void 0
+    );
     this.updatedKeysIndex.setPks(OIMDBSettings.UPDATED_KEYS_INDEX_KEY, []);
     this.hasEmittedChanges = false;
+    this.emitter.emit(
+      2 /* AFTER_FLUSH */,
+      void 0
+    );
   }
   /**
    * Add keys to the updated set and emit HAS_CHANGES event if needed
@@ -774,6 +785,14 @@ var OIMCollection = class {
     this.store.removeManyByPks(pks);
     this.emitter.emit(0 /* UPDATE */, { pks });
   }
+  removeOneByPk(pk) {
+    this.store.removeOneByPk(pk);
+    this.emitter.emit(0 /* UPDATE */, { pks: [pk] });
+  }
+  removeManyByPks(pks) {
+    this.store.removeManyByPks(pks);
+    this.emitter.emit(0 /* UPDATE */, { pks });
+  }
   clear() {
     this.store.clear();
     this.emitter.emit(0 /* UPDATE */, { pks: [] });
@@ -890,9 +909,17 @@ var OIMComparatorFactory = class {
   }
 };
 
+// src/enum/EOIMEventQueueEventType.ts
+var EOIMEventQueueEventType = /* @__PURE__ */ ((EOIMEventQueueEventType2) => {
+  EOIMEventQueueEventType2[EOIMEventQueueEventType2["AFTER_FLUSH"] = 0] = "AFTER_FLUSH";
+  EOIMEventQueueEventType2[EOIMEventQueueEventType2["BEFORE_FLUSH"] = 1] = "BEFORE_FLUSH";
+  return EOIMEventQueueEventType2;
+})(EOIMEventQueueEventType || {});
+
 // src/core/OIMEventQueue.ts
 var OIMEventQueue = class {
   constructor(options = {}) {
+    this.emitter = new OIMEventEmitter();
     this.queue = [];
     this.scheduler = options.scheduler;
     if (this.scheduler) {
@@ -919,11 +946,13 @@ var OIMEventQueue = class {
    */
   flush() {
     if (this.queue.length === 0) return;
+    this.emitter.emit(1 /* BEFORE_FLUSH */, void 0);
     const currentQueue = this.queue.slice();
     this.queue.length = 0;
     for (let i = 0; i < currentQueue.length; i++) {
       currentQueue[i]();
     }
+    this.emitter.emit(0 /* AFTER_FLUSH */, void 0);
   }
   /**
    * Get the current number of queued functions.
@@ -1228,6 +1257,7 @@ var OIMEventQueueSchedulerFactory = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   EOIMCollectionEventType,
+  EOIMEventQueueEventType,
   EOIMEventQueueSchedulerEventType,
   EOIMIndexEventType,
   EOIMUpdateEventCoalescerEventType,

package/dist/index.d.cts

@@ -193,6 +193,8 @@ declare class OIMDBSettings {
 declare abstract class OIMUpdateEventCoalescer<TKey extends TOIMPk> {
     readonly emitter: OIMEventEmitter<{
         0: void;
+        1: void;
+        2: void;
     }>;
     protected readonly updatedKeysIndex: OIMIndexManual<typeof OIMDBSettings.UPDATED_KEYS_INDEX_KEY, TKey>;
     private hasEmittedChanges;
@@ -227,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;
@@ -378,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[];
@@ -598,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;
@@ -614,4 +626,4 @@ type TOIMUpdatePayload<TKey> = {
     keys: readonly TKey[];
 };
 
-export { EOIMCollectionEventType, 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 };
+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

@@ -193,6 +193,8 @@ declare class OIMDBSettings {
 declare abstract class OIMUpdateEventCoalescer<TKey extends TOIMPk> {
     readonly emitter: OIMEventEmitter<{
         0: void;
+        1: void;
+        2: void;
     }>;
     protected readonly updatedKeysIndex: OIMIndexManual<typeof OIMDBSettings.UPDATED_KEYS_INDEX_KEY, TKey>;
     private hasEmittedChanges;
@@ -227,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;
@@ -378,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[];
@@ -598,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;
@@ -614,4 +626,4 @@ type TOIMUpdatePayload<TKey> = {
     keys: readonly TKey[];
 };
 
-export { EOIMCollectionEventType, 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 };
+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.js

@@ -292,6 +292,8 @@ var OIMIndex = class {
 // src/enum/EOIMUpdateEventCoalescerEventType.ts
 var EOIMUpdateEventCoalescerEventType = /* @__PURE__ */ ((EOIMUpdateEventCoalescerEventType2) => {
   EOIMUpdateEventCoalescerEventType2[EOIMUpdateEventCoalescerEventType2["HAS_CHANGES"] = 0] = "HAS_CHANGES";
+  EOIMUpdateEventCoalescerEventType2[EOIMUpdateEventCoalescerEventType2["BEFORE_FLUSH"] = 1] = "BEFORE_FLUSH";
+  EOIMUpdateEventCoalescerEventType2[EOIMUpdateEventCoalescerEventType2["AFTER_FLUSH"] = 2] = "AFTER_FLUSH";
   return EOIMUpdateEventCoalescerEventType2;
 })(EOIMUpdateEventCoalescerEventType || {});
 
@@ -528,8 +530,16 @@ var OIMUpdateEventCoalescer = class {
    * Clear all updated keys and reset the changed state
    */
   clearUpdatedKeys() {
+    this.emitter.emit(
+      1 /* BEFORE_FLUSH */,
+      void 0
+    );
     this.updatedKeysIndex.setPks(OIMDBSettings.UPDATED_KEYS_INDEX_KEY, []);
     this.hasEmittedChanges = false;
+    this.emitter.emit(
+      2 /* AFTER_FLUSH */,
+      void 0
+    );
   }
   /**
    * Add keys to the updated set and emit HAS_CHANGES event if needed
@@ -718,6 +728,14 @@ var OIMCollection = class {
     this.store.removeManyByPks(pks);
     this.emitter.emit(0 /* UPDATE */, { pks });
   }
+  removeOneByPk(pk) {
+    this.store.removeOneByPk(pk);
+    this.emitter.emit(0 /* UPDATE */, { pks: [pk] });
+  }
+  removeManyByPks(pks) {
+    this.store.removeManyByPks(pks);
+    this.emitter.emit(0 /* UPDATE */, { pks });
+  }
   clear() {
     this.store.clear();
     this.emitter.emit(0 /* UPDATE */, { pks: [] });
@@ -834,9 +852,17 @@ var OIMComparatorFactory = class {
   }
 };
 
+// src/enum/EOIMEventQueueEventType.ts
+var EOIMEventQueueEventType = /* @__PURE__ */ ((EOIMEventQueueEventType2) => {
+  EOIMEventQueueEventType2[EOIMEventQueueEventType2["AFTER_FLUSH"] = 0] = "AFTER_FLUSH";
+  EOIMEventQueueEventType2[EOIMEventQueueEventType2["BEFORE_FLUSH"] = 1] = "BEFORE_FLUSH";
+  return EOIMEventQueueEventType2;
+})(EOIMEventQueueEventType || {});
+
 // src/core/OIMEventQueue.ts
 var OIMEventQueue = class {
   constructor(options = {}) {
+    this.emitter = new OIMEventEmitter();
     this.queue = [];
     this.scheduler = options.scheduler;
     if (this.scheduler) {
@@ -863,11 +889,13 @@ var OIMEventQueue = class {
    */
   flush() {
     if (this.queue.length === 0) return;
+    this.emitter.emit(1 /* BEFORE_FLUSH */, void 0);
     const currentQueue = this.queue.slice();
     this.queue.length = 0;
     for (let i = 0; i < currentQueue.length; i++) {
       currentQueue[i]();
     }
+    this.emitter.emit(0 /* AFTER_FLUSH */, void 0);
   }
   /**
    * Get the current number of queued functions.
@@ -1171,6 +1199,7 @@ var OIMEventQueueSchedulerFactory = class {
 };
 export {
   EOIMCollectionEventType,
+  EOIMEventQueueEventType,
   EOIMEventQueueSchedulerEventType,
   EOIMIndexEventType,
   EOIMUpdateEventCoalescerEventType,

package/package.json

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