@oimdb/core 1.2.0 → 1.2.2

package/README.md

@@ -371,28 +371,38 @@ const teamUsers = useSelectEntitiesByPks(users, userIds);
 Migrate from Redux to OIMDB gradually or use both systems side-by-side with automatic two-way synchronization:
 
 ```typescript
-import { OIMDBReducerFactory } from '@oimdb/redux-adapter';
-import { createStore, combineReducers } from 'redux';
+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 factory = new OIMDBReducerFactory(queue);
-const usersReducer = factory.createCollectionReducer(users);
+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 can sync back to OIMDB with child reducers
+// 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
 

package/dist/index.cjs

@@ -765,6 +765,10 @@ var OIMCollection = class {
   getManyByPks(pks) {
     return this.store.getManyByPks(pks);
   }
+  upsertOneByPk(pk, entity) {
+    this.upsertOneWithoutNotificationsByPk(pk, entity);
+    this.emitter.emit(0 /* UPDATE */, { pks: [pk] });
+  }
   upsertOne(entity) {
     const pk = this.upsertOneWithoutNotifications(entity);
     this.emitter.emit(0 /* UPDATE */, { pks: [pk] });
@@ -808,6 +812,15 @@ var OIMCollection = class {
   }
   upsertOneWithoutNotifications(entity) {
     const pk = this.selectPk(entity);
+    this.upsertOneWithoutNotificationsByPk(pk, entity);
+    return pk;
+  }
+  upsertOneWithoutNotificationsByPk(pk, entity) {
+    if (!pk) {
+      throw new Error(
+        `[OIMCollection]: PK is required to upsert an entity ${JSON.stringify(entity)}`
+      );
+    }
     const existingEntity = this.store.getOneByPk(pk);
     if (existingEntity) {
       this.store.setOneByPk(
@@ -817,7 +830,6 @@ var OIMCollection = class {
     } else {
       this.store.setOneByPk(pk, entity);
     }
-    return pk;
   }
 };
 

package/dist/index.d.cts

@@ -382,8 +382,9 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     constructor(opts?: TOIMCollectionOptions<TEntity, TPk>);
     getOneByPk(pk: TPk): TEntity | undefined;
     getManyByPks(pks: readonly TPk[]): TEntity[];
-    upsertOne(entity: TEntity): void;
-    upsertMany(entities: TEntity[]): void;
+    upsertOneByPk(pk: TPk, entity: Partial<TEntity>): void;
+    upsertOne(entity: TEntity | Partial<TEntity>): void;
+    upsertMany(entities: (TEntity | Partial<TEntity>)[]): void;
     removeOne(entity: TEntity): void;
     removeMany(entities: TEntity[]): void;
     removeOneByPk(pk: TPk): void;
@@ -392,7 +393,8 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     countAll(): number;
     getAll(): TEntity[];
     getAllPks(): TPk[];
-    protected upsertOneWithoutNotifications(entity: TEntity): TPk;
+    protected upsertOneWithoutNotifications(entity: TEntity | Partial<TEntity>): TPk;
+    protected upsertOneWithoutNotificationsByPk(pk: TPk, entity: Partial<TEntity> | TEntity): void;
 }
 
 declare enum EOIMCollectionEventType {

package/dist/index.d.ts

@@ -382,8 +382,9 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     constructor(opts?: TOIMCollectionOptions<TEntity, TPk>);
     getOneByPk(pk: TPk): TEntity | undefined;
     getManyByPks(pks: readonly TPk[]): TEntity[];
-    upsertOne(entity: TEntity): void;
-    upsertMany(entities: TEntity[]): void;
+    upsertOneByPk(pk: TPk, entity: Partial<TEntity>): void;
+    upsertOne(entity: TEntity | Partial<TEntity>): void;
+    upsertMany(entities: (TEntity | Partial<TEntity>)[]): void;
     removeOne(entity: TEntity): void;
     removeMany(entities: TEntity[]): void;
     removeOneByPk(pk: TPk): void;
@@ -392,7 +393,8 @@ declare class OIMCollection<TEntity extends object, TPk extends TOIMPk> {
     countAll(): number;
     getAll(): TEntity[];
     getAllPks(): TPk[];
-    protected upsertOneWithoutNotifications(entity: TEntity): TPk;
+    protected upsertOneWithoutNotifications(entity: TEntity | Partial<TEntity>): TPk;
+    protected upsertOneWithoutNotificationsByPk(pk: TPk, entity: Partial<TEntity> | TEntity): void;
 }
 
 declare enum EOIMCollectionEventType {

package/dist/index.js

@@ -708,6 +708,10 @@ var OIMCollection = class {
   getManyByPks(pks) {
     return this.store.getManyByPks(pks);
   }
+  upsertOneByPk(pk, entity) {
+    this.upsertOneWithoutNotificationsByPk(pk, entity);
+    this.emitter.emit(0 /* UPDATE */, { pks: [pk] });
+  }
   upsertOne(entity) {
     const pk = this.upsertOneWithoutNotifications(entity);
     this.emitter.emit(0 /* UPDATE */, { pks: [pk] });
@@ -751,6 +755,15 @@ var OIMCollection = class {
   }
   upsertOneWithoutNotifications(entity) {
     const pk = this.selectPk(entity);
+    this.upsertOneWithoutNotificationsByPk(pk, entity);
+    return pk;
+  }
+  upsertOneWithoutNotificationsByPk(pk, entity) {
+    if (!pk) {
+      throw new Error(
+        `[OIMCollection]: PK is required to upsert an entity ${JSON.stringify(entity)}`
+      );
+    }
     const existingEntity = this.store.getOneByPk(pk);
     if (existingEntity) {
       this.store.setOneByPk(
@@ -760,7 +773,6 @@ var OIMCollection = class {
     } else {
       this.store.setOneByPk(pk, entity);
     }
-    return pk;
   }
 };
 

package/package.json

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