@nexigen/entity-normalizer 0.1.6 → 0.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 negixenjs
+Copyright (c) 2025 nexigenjs
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -105,8 +105,8 @@ yarn add @nexigen/entity-normalizer mobx mobx-react-lite
 
 ```ts
 export const ENTITY_KEY = {
-	VIEWER: 'viewers',
-	POST: 'posts',
+  VIEWER: 'viewers',
+  POST: 'posts',
 } as const;
 ```
 
@@ -116,20 +116,20 @@ export const ENTITY_KEY = {
 
 ```ts
 export const viewerSchema = createEntitySchema(
-	ENTITY_KEY.VIEWER,
-	{},
-	{ model: ViewerModel }
+  ENTITY_KEY.VIEWER,
+  {},
+  { model: ViewerModel },
 );
 ```
 
 ```ts
 export const postSchema = createEntitySchema(
-	ENTITY_KEY.POST,
-	{
-		viewer: viewerSchema,
-		viewers: [viewerSchema],
-	},
-	{ model: PostModel }
+  ENTITY_KEY.POST,
+  {
+    viewer: viewerSchema,
+    viewers: [viewerSchema],
+  },
+  { model: PostModel },
 );
 ```
 
@@ -139,8 +139,8 @@ export const postSchema = createEntitySchema(
 
 ```ts
 export const schemaMap = {
-	[ENTITY_KEY.VIEWER]: viewerSchema,
-	[ENTITY_KEY.POST]: postSchema,
+  [ENTITY_KEY.VIEWER]: viewerSchema,
+  [ENTITY_KEY.POST]: postSchema,
 };
 ```
 
@@ -153,16 +153,16 @@ They never own related entities directly.
 
 ```ts
 export class PostModel {
-	constructor(dto, get) {
-		this.id = dto.id;
-		this.viewerId = dto.viewerId;
-		this.title = dto.title;
-		makeAutoObservable(this);
-	}
-
-	get viewer() {
-		return this.get(ENTITY_KEY.VIEWER, this.viewerId);
-	}
+  constructor(dto, get) {
+    this.id = dto.id;
+    this.viewerId = dto.viewerId;
+    this.title = dto.title;
+    makeAutoObservable(this);
+  }
+
+  get viewer() {
+    return this.get(ENTITY_KEY.VIEWER, this.viewerId);
+  }
 }
 ```
 
@@ -175,22 +175,22 @@ They never store entity data directly.
 
 ```ts
 export class PostsStore {
-	lists;
-
-	constructor(deps) {
-		this.lists = deps.core.entities.createMultiCollection({
-			entityKey: ENTITY_KEY.POST,
-			collectionId: 'posts',
-			limit: 20,
-		});
-
-		makeAutoObservable(this);
-	}
-
-	fetchPosts = createDuck(async ({ group }) => {
-		const res = await deps.api.Posts.getPosts({ group });
-		this.lists[group].set(res);
-	});
+  lists;
+
+  constructor(deps) {
+    this.lists = deps.core.entities.createMultiCollection({
+      entityKey: ENTITY_KEY.POST,
+      collectionId: 'posts',
+      limit: 20,
+    });
+
+    makeAutoObservable(this);
+  }
+
+  fetchPosts = createDuck(async ({ group }) => {
+    const res = await deps.api.Posts.getPosts({ group });
+    this.lists[group].set(res);
+  });
 }
 ```
 
@@ -200,15 +200,15 @@ export class PostsStore {
 
 ```ts
 export const rootStore = createRootStore({
-	api: Api,
-	schemaMap,
-	stores: {
-		posts: PostsStore,
-		viewer: ViewerStore,
-	},
-	services: {
-		bootstrap: BootstrapService,
-	},
+  api: Api,
+  schemaMap,
+  stores: {
+    posts: PostsStore,
+    viewer: ViewerStore,
+  },
+  services: {
+    bootstrap: BootstrapService,
+  },
 });
 ```
 
@@ -222,18 +222,18 @@ registerRootStore(rootStore);
 
 ```ts
 export const { useStores, useServices, useCore } =
-	createStoreHooks<typeof rootStore>();
+  createStoreHooks<typeof rootStore>();
 ```
 
 ```tsx
 const PostsScreen = observer(() => {
-	const { posts } = useStores();
+  const { posts } = useStores();
 
-	useEffect(() => {
-		posts.fetchPosts.run({ group: 'active' });
-	}, []);
+  useEffect(() => {
+    posts.fetchPosts.run({ group: 'active' });
+  }, []);
 
-	return <List data={posts.lists.active.getList} />;
+  return <List data={posts.lists.active.getList} />;
 });
 ```
 

package/dist/async/async-duck.d.ts

@@ -9,6 +9,7 @@ export declare class AsyncDuck<TParams, TResult> {
     private _keyed;
     private _proxy?;
     private _pendingPromise;
+    private _lastRunParams?;
     constructor(fn: (params?: TParams) => Promise<TResult>);
     getKeyed(key: string): AsyncDuck<TParams, TResult>;
     private setLoading;
@@ -18,6 +19,7 @@ export declare class AsyncDuck<TParams, TResult> {
     private sleep;
     private runWithRetry;
     run(options?: RunOptions<TParams, TResult>): Promise<TResult | undefined>;
+    refresh(): Promise<TResult | undefined>;
     get isLoading(): boolean;
     get isRetrying(): boolean;
     get isError(): boolean;

package/dist/async/async-duck.js

@@ -1,4 +1,5 @@
 import { makeObservable, observable, action } from 'mobx';
+import { executionAsyncContext } from './execution-context';
 import { DUCK_TAG } from './marker';
 import { defaultRetryStrategy } from './retry';
 export class AsyncDuck {
@@ -76,6 +77,7 @@ export class AsyncDuck {
         this._data = null;
         this._hasEverRun = false;
         this._pendingPromise = null;
+        this._lastRunParams = undefined;
     }
     // -------------------------------------
     // UTILS
@@ -127,6 +129,9 @@ export class AsyncDuck {
             return this._pendingPromise;
         }
         const { params, onSuccess, onError, retryStrategy } = options ?? {};
+        if (params !== undefined) {
+            this._lastRunParams = params;
+        }
         const isRetry = !!retryStrategy;
         this.setLoading(isRetry);
         this._pendingPromise = (async () => {
@@ -147,6 +152,12 @@ export class AsyncDuck {
         })();
         return this._pendingPromise;
     }
+    refresh() {
+        if (!this._lastRunParams) {
+            return Promise.resolve(undefined);
+        }
+        return executionAsyncContext.runWith('refresh', () => this.run({ params: this._lastRunParams }));
+    }
     // -------------------------------------
     // GETTERS
     // -------------------------------------

package/dist/async/async-duck.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-duck.js","sourceRoot":"","sources":["../../src/async/async-duck.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"async-duck.js","sourceRoot":"","sources":["../../src/async/async-duck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAI/C,MAAM,OAAO,SAAS;IAcpB,YAAY,EAA0C;QAb9C,eAAU,GAAG,KAAK,CAAC;QACnB,gBAAW,GAAG,KAAK,CAAC;QACpB,WAAM,GAAiB,IAAI,CAAC;QAC5B,UAAK,GAAmB,IAAI,CAAC;QAC7B,gBAAW,GAAG,KAAK,CAAC;QAGpB,WAAM,GAAG,IAAI,GAAG,EAAuC,CAAC;QAExD,oBAAe,GAAwC,IAAI,CAAC;QAKlE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE;YAC5B,GAAG,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;gBAC5B,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACnB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;gBACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;SACF,CAAiE,CAAC;QAEnE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;YAC3C,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,cAAc,CAAC,IAAW,EAAE;YAC1B,UAAU,EAAE,UAAU;YACtB,WAAW,EAAE,UAAU;YACvB,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,UAAU;YAEvB,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,kBAAkB;IAClB,wCAAwC;IACxC,QAAQ,CAAC,GAAW;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,SAAS,CAAmB,IAAI,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC/B,CAAC;IAED,wCAAwC;IACxC,oBAAoB;IACpB,wCAAwC;IAChC,UAAU,CAAC,OAAO,GAAG,KAAK;QAChC,IAAI,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,UAAU,CAAC,IAAa,EAAE,SAAgC;QAChE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAEO,QAAQ,CAAC,GAAY,EAAE,OAA4B;QACzD,MAAM,UAAU,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAExB,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,wCAAwC;IACxC,QAAQ;IACR,wCAAwC;IAChC,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,wCAAwC;IACxC,eAAe;IACf,wCAAwC;IAChC,KAAK,CAAC,YAAY,CACxB,MAA2B,EAC3B,aAA4B;QAE5B,MAAM,KAAK,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,aAAa,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAE/B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,GAAG,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,UAAU,GACd,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAE5D,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;gBACxD,MAAM,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC;gBAE7B,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;oBACtB,MAAM,UAAU,CAAC;gBACnB,CAAC;gBAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBAExB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;gBAEtE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,wCAAwC;IACxC,aAAa;IACb,wCAAwC;IACxC,KAAK,CAAC,GAAG,CACP,OAAsC;QAEtC,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;gBACpC,GAAG,OAAO;gBACV,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,eAAgB,CAAC;QAC/B,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAEpE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC/B,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,CAAC,eAAe,GAAG,CAAC,KAAK,IAAI,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,aAAa;oBAC1B,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC;oBAChD,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;gBAE1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBACnC,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC5B,OAAO,SAAS,CAAC;YACnB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,qBAAqB,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CACnD,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,UAAU;IACV,wCAAwC;IACxC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;IACjE,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/async/execution-context.d.ts

@@ -0,0 +1,10 @@
+import { type ExecutionIntent } from './types';
+import type { PublicExecutionContext } from './public';
+export declare class ExecutionContext {
+    private stack;
+    runWith<T>(intent: ExecutionIntent, fn: () => Promise<T>): Promise<T>;
+    current(): ExecutionIntent;
+    is(intent: ExecutionIntent): boolean;
+}
+export declare function createExecutionContext(): PublicExecutionContext;
+export declare const executionAsyncContext: PublicExecutionContext;

package/dist/async/execution-context.js

@@ -0,0 +1,25 @@
+export class ExecutionContext {
+    constructor() {
+        this.stack = [];
+    }
+    async runWith(intent, fn) {
+        this.stack.push(intent);
+        try {
+            return await fn();
+        }
+        finally {
+            this.stack.pop();
+        }
+    }
+    current() {
+        return this.stack[this.stack.length - 1] ?? 'normal';
+    }
+    is(intent) {
+        return this.current() === intent;
+    }
+}
+export function createExecutionContext() {
+    return new ExecutionContext();
+}
+export const executionAsyncContext = createExecutionContext();
+//# sourceMappingURL=execution-context.js.map

package/dist/async/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/async/execution-context.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,gBAAgB;IAA7B;QACU,UAAK,GAAsB,EAAE,CAAC;IAkBxC,CAAC;IAhBC,KAAK,CAAC,OAAO,CAAI,MAAuB,EAAE,EAAoB;QAC5D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC;IACvD,CAAC;IAED,EAAE,CAAC,MAAuB;QACxB,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,MAAM,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAChC,sBAAsB,EAAE,CAAC"}

package/dist/async/index.d.ts

@@ -1 +1,2 @@
 export * from './create-duck';
+export * from './execution-context';

package/dist/async/index.js

@@ -1,2 +1,3 @@
 export * from './create-duck';
+export * from './execution-context';
 //# sourceMappingURL=index.js.map

package/dist/async/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}

package/dist/async/public.d.ts

@@ -1,4 +1,4 @@
-import type { AxiosError } from './types';
+import type { AxiosError, ExecutionIntent } from './types';
 export interface RetryStrategy {
     retries: number;
     delayMs: number;
@@ -13,8 +13,14 @@ export type RunOptions<TParams, TResult> = {
     skip?: boolean;
     retryStrategy?: RetryStrategy;
 };
+export interface PublicExecutionContext {
+    runWith<T>(intent: ExecutionIntent, fn: () => Promise<T>): Promise<T>;
+    current(): ExecutionIntent;
+    is(intent: ExecutionIntent): boolean;
+}
 export interface PublicAsyncDuck<TParams, TResult> {
     run(options?: RunOptions<TParams, TResult>): Promise<TResult | undefined>;
+    refresh(): Promise<TResult | undefined>;
     readonly isLoading: boolean;
     readonly isRetrying: boolean;
     readonly isError: boolean;

package/dist/async/types.d.ts

@@ -22,3 +22,4 @@ export type RunOptions<TParams, TResult> = {
     skip?: boolean;
     retryStrategy?: RetryStrategy;
 };
+export type ExecutionIntent = 'normal' | 'refresh';

package/dist/create/cleaner.d.ts

@@ -1,5 +1,12 @@
 import type { StoreShape } from './scanner';
 import type { SystemDeps } from '../root/types';
+/**
+ * Cleaner
+ *
+ * - resetStore is a **silent, infra-only operation**
+ * - MUST NOT trigger persistence notifications
+ * - persistence lifecycle is handled by StoreProxy / higher-level APIs
+ */
 export declare class Cleaner {
     private deps;
     constructor(deps: SystemDeps);

package/dist/create/cleaner.js

@@ -1,17 +1,19 @@
 import { runInAction } from 'mobx';
-const SUPPRESS_KEY = '__suppressPersistNotify';
-function incSuppress(store) {
-    store[SUPPRESS_KEY] = (store[SUPPRESS_KEY] ?? 0) + 1;
-}
-function decSuppress(store) {
-    store[SUPPRESS_KEY] = Math.max(0, (store[SUPPRESS_KEY] ?? 0) - 1);
-}
+import { incSuppress, decSuppress } from './utils';
+/**
+ * Cleaner
+ *
+ * - resetStore is a **silent, infra-only operation**
+ * - MUST NOT trigger persistence notifications
+ * - persistence lifecycle is handled by StoreProxy / higher-level APIs
+ */
 export class Cleaner {
     constructor(deps) {
         this.deps = deps;
     }
     applyReset(store, shape) {
         const initialPlain = shape.plain;
+        // already patched
         if (typeof store.resetStore === 'function') {
             return;
         }
@@ -21,47 +23,57 @@ export class Cleaner {
             writable: true,
             value: () => {
                 incSuppress(store);
-                runInAction(() => {
-                    // plain fields
-                    for (const [key, val] of Object.entries(initialPlain)) {
-                        try {
-                            store[key] = val;
-                        }
-                        catch { }
-                    }
-                    // single collections
-                    for (const key of shape.single) {
-                        try {
-                            store[key].reset?.();
+                try {
+                    runInAction(() => {
+                        // -------------------------
+                        // plain fields
+                        // -------------------------
+                        for (const [key, val] of Object.entries(initialPlain)) {
+                            try {
+                                store[key] = val;
+                            }
+                            catch { }
                         }
-                        catch { }
-                    }
-                    // multi collections
-                    for (const key of shape.multi) {
-                        const mc = store[key];
-                        try {
-                            if (mc?.resetAll) {
-                                mc.resetAll();
+                        // -------------------------
+                        // single collections
+                        // -------------------------
+                        for (const key of shape.single) {
+                            try {
+                                store[key]?.reset?.();
                             }
-                            else if (mc?.getSubCollections) {
-                                for (const col of mc.getSubCollections().values()) {
-                                    col.reset?.({ silent: true });
+                            catch { }
+                        }
+                        // -------------------------
+                        // multi collections
+                        // -------------------------
+                        for (const key of shape.multi) {
+                            const mc = store[key];
+                            try {
+                                if (mc?.resetAll) {
+                                    mc.resetAll();
+                                }
+                                else if (mc?.getSubCollections) {
+                                    for (const col of mc.getSubCollections().values()) {
+                                        col.reset?.({ silent: true });
+                                    }
                                 }
                             }
+                            catch { }
                         }
-                        catch { }
-                    }
-                    // records
-                    for (const key of shape.records) {
-                        try {
-                            store[key].reset?.();
+                        // -------------------------
+                        // records
+                        // -------------------------
+                        for (const key of shape.records) {
+                            try {
+                                store[key]?.reset?.();
+                            }
+                            catch { }
                         }
-                        catch { }
-                    }
-                });
-                decSuppress(store);
-                // 1 notify, async
-                queueMicrotask(() => this.deps?.getPersistence?.()?.onStoreStateChanged?.());
+                    });
+                }
+                finally {
+                    decSuppress(store);
+                }
             },
         });
     }

package/dist/create/cleaner.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleaner.js","sourceRoot":"","sources":["../../src/create/cleaner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAMnC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,SAAS,WAAW,CAAC,KAAU;IAC7B,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AACD,SAAS,WAAW,CAAC,KAAU;IAC7B,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,OAAO,OAAO;IAClB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAI,CAAC;IAEzC,UAAU,CACR,KAAU,EACV,KAAiE;QAEjE,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;QAEjC,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE;YACzC,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,GAAG,EAAE;gBACV,WAAW,CAAC,KAAK,CAAC,CAAC;gBAEnB,WAAW,CAAC,GAAG,EAAE;oBACf,eAAe;oBACf,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;wBACtD,IAAI,CAAC;4BACH,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;wBACnB,CAAC;wBAAC,MAAM,CAAC,CAAC,CAAC;oBACb,CAAC;oBAED,qBAAqB;oBACrB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;wBAC/B,IAAI,CAAC;4BACH,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;wBACvB,CAAC;wBAAC,MAAM,CAAC,CAAC,CAAC;oBACb,CAAC;oBAED,oBAAoB;oBACpB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;wBACtB,IAAI,CAAC;4BACH,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;gCACjB,EAAE,CAAC,QAAQ,EAAE,CAAC;4BAChB,CAAC;iCAAM,IAAI,EAAE,EAAE,iBAAiB,EAAE,CAAC;gCACjC,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;oCAClD,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gCAChC,CAAC;4BACH,CAAC;wBACH,CAAC;wBAAC,MAAM,CAAC,CAAC,CAAC;oBACb,CAAC;oBAED,UAAU;oBACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;wBAChC,IAAI,CAAC;4BACH,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;wBACvB,CAAC;wBAAC,MAAM,CAAC,CAAC,CAAC;oBACb,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,WAAW,CAAC,KAAK,CAAC,CAAC;gBAEnB,kBAAkB;gBAClB,cAAc,CAAC,GAAG,EAAE,CAClB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,CACvD,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"cleaner.js","sourceRoot":"","sources":["../../src/create/cleaner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKnD;;;;;;GAMG;AACH,MAAM,OAAO,OAAO;IAClB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,UAAU,CACR,KAAU,EACV,KAAiE;QAEjE,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;QAEjC,kBAAkB;QAClB,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE;YACzC,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,GAAG,EAAE;gBACV,WAAW,CAAC,KAAK,CAAC,CAAC;gBAEnB,IAAI,CAAC;oBACH,WAAW,CAAC,GAAG,EAAE;wBACf,4BAA4B;wBAC5B,eAAe;wBACf,4BAA4B;wBAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;4BACtD,IAAI,CAAC;gCACH,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;4BACnB,CAAC;4BAAC,MAAM,CAAC,CAAA,CAAC;wBACZ,CAAC;wBAED,4BAA4B;wBAC5B,qBAAqB;wBACrB,4BAA4B;wBAC5B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;4BAC/B,IAAI,CAAC;gCACH,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;4BACxB,CAAC;4BAAC,MAAM,CAAC,CAAA,CAAC;wBACZ,CAAC;wBAED,4BAA4B;wBAC5B,oBAAoB;wBACpB,4BAA4B;wBAC5B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;4BAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;4BACtB,IAAI,CAAC;gCACH,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;oCACjB,EAAE,CAAC,QAAQ,EAAE,CAAC;gCAChB,CAAC;qCAAM,IAAI,EAAE,EAAE,iBAAiB,EAAE,CAAC;oCACjC,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;wCAClD,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oCAChC,CAAC;gCACH,CAAC;4BACH,CAAC;4BAAC,MAAM,CAAC,CAAA,CAAC;wBACZ,CAAC;wBAED,4BAA4B;wBAC5B,UAAU;wBACV,4BAA4B;wBAC5B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;4BAChC,IAAI,CAAC;gCACH,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;4BACxB,CAAC;4BAAC,MAAM,CAAC,CAAA,CAAC;wBACZ,CAAC;oBACH,CAAC,CAAC,CAAC;gBACL,CAAC;wBAAS,CAAC;oBACT,WAAW,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/create/constants.d.ts

@@ -0,0 +1 @@
+export declare const SUPPRESS_KEY = "__suppressPersistNotify";

package/dist/create/constants.js

@@ -0,0 +1,2 @@
+export const SUPPRESS_KEY = '__suppressPersistNotify';
+//# sourceMappingURL=constants.js.map

package/dist/create/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/create/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC"}

package/dist/create/create-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../../src/create/create-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,UAAU,WAAW,CACzB,UAA4C,EAC5C,IAAuB;IAEvB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../../src/create/create-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIzC,MAAM,UAAU,WAAW,CACzB,UAA4C,EAC5C,IAAuB;IAEvB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC"}

package/dist/create/extractor.d.ts

@@ -1,8 +1,5 @@
-import { type StoreShape } from './scanner';
-import type { Scanner } from './scanner';
+import type { StoreShape } from './scanner';
 export declare class StoreSnapshotExtractor {
-    private scanner;
-    constructor(scanner: Scanner);
     getSnapshot(store: any, shape: StoreShape): Record<string, any>;
     applySnapshot(store: any, snap: any, shape: StoreShape): void;
 }

package/dist/create/extractor.js

@@ -1,13 +1,11 @@
 import { runInAction } from 'mobx';
+import { deepClone } from './utils';
 export class StoreSnapshotExtractor {
-    constructor(scanner) {
-        this.scanner = scanner;
-    }
     getSnapshot(store, shape) {
         const out = {};
-        // plain
+        // plain (clone for safety)
         for (const key of Object.keys(shape.plain)) {
-            out[key] = store[key];
+            out[key] = deepClone(store[key]);
         }
         // single collections
         for (const key of shape.single) {
@@ -40,13 +38,13 @@ export class StoreSnapshotExtractor {
                     catch { }
                 }
             }
-            // single
+            // single collections
             for (const key of shape.single) {
                 if (snap[key]) {
                     store[key]?.applySnapshot?.(snap[key], { silent: true });
                 }
             }
-            // multi
+            // multi collections
             for (const key of shape.multi) {
                 if (snap[key]) {
                     store[key]?.applyMultiSnapshot?.(snap[key]);

package/dist/create/extractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../src/create/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAMnC,MAAM,OAAO,sBAAsB;IACjC,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC,WAAW,CAAC,KAAU,EAAE,KAAiB;QACvC,MAAM,GAAG,GAAwB,EAAE,CAAC;QAEpC,QAAQ;QACR,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,qBAAqB;QACrB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;QACzC,CAAC;QAED,oBAAoB;QACpB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,EAAE,EAAE,gBAAgB,EAAE,CAAC;gBACzB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;YACnC,CAAC;QACH,CAAC;QAED,UAAU;QACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,aAAa,CAAC,KAAU,EAAE,IAAS,EAAE,KAAiB;QACpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,WAAW,CAAC,GAAG,EAAE;YACf,QAAQ;YACR,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC;wBACH,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;oBACzB,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBACZ,CAAC;YACH,CAAC;YAED,SAAS;YACT,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACd,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YAED,QAAQ;YACR,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACd,KAAK,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,UAAU;YACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACd,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"extractor.js","sourceRoot":"","sources":["../../src/create/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,MAAM,OAAO,sBAAsB;IACjC,WAAW,CAAC,KAAU,EAAE,KAAiB;QACvC,MAAM,GAAG,GAAwB,EAAE,CAAC;QAEpC,2BAA2B;QAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,qBAAqB;QACrB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;QACzC,CAAC;QAED,oBAAoB;QACpB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,EAAE,EAAE,gBAAgB,EAAE,CAAC;gBACzB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC;YACnC,CAAC;QACH,CAAC;QAED,UAAU;QACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,aAAa,CAAC,KAAU,EAAE,IAAS,EAAE,KAAiB;QACpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,WAAW,CAAC,GAAG,EAAE;YACf,QAAQ;YACR,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC;wBACH,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;oBACzB,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBACZ,CAAC;YACH,CAAC;YAED,qBAAqB;YACrB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACd,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YAED,oBAAoB;YACpB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACd,KAAK,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,UAAU;YACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACd,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/create/manager.js

@@ -2,20 +2,13 @@ import { Cleaner } from './cleaner';
 import { StoreSnapshotExtractor } from './extractor';
 import { StoreProxy } from './proxy';
 import { Scanner } from './scanner';
-import { defineHiddenProp } from './utils';
-const SUPPRESS_KEY = '__suppressPersistNotify';
-function incSuppress(store) {
-    store[SUPPRESS_KEY] = (store[SUPPRESS_KEY] ?? 0) + 1;
-}
-function decSuppress(store) {
-    store[SUPPRESS_KEY] = Math.max(0, (store[SUPPRESS_KEY] ?? 0) - 1);
-}
+import { defineHiddenProp, incSuppress, decSuppress } from './utils';
 export class StoreManager {
     constructor(deps) {
         this.deps = deps;
         this.scanner = new Scanner();
         this.cleaner = new Cleaner(deps.system);
-        this.extractor = new StoreSnapshotExtractor(this.scanner);
+        this.extractor = new StoreSnapshotExtractor();
     }
     create(StoreClass) {
         const instance = new StoreClass(this.deps.domain);
@@ -27,8 +20,12 @@ export class StoreManager {
         defineHiddenProp(instance, '__applySnapshot', (snap) => {
             // suppress persist spam while mutating many fields
             incSuppress(instance);
-            this.extractor.applySnapshot(instance, snap, shape);
-            decSuppress(instance);
+            try {
+                this.extractor.applySnapshot(instance, snap, shape);
+            }
+            finally {
+                decSuppress(instance);
+            }
             // one notify after restore
             queueMicrotask(() => this.deps.system?.getPersistence?.()?.onStoreStateChanged?.());
         });

package/dist/create/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/create/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAmB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI3C,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C,SAAS,WAAW,CAAC,KAAU;IAC7B,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AACD,SAAS,WAAW,CAAC,KAAU;IAC7B,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,OAAO,YAAY;IAKvB,YAAoB,IAAuB;QAAvB,SAAI,GAAJ,IAAI,CAAmB;QAJnC,YAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAK9B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAS,UAA4C;QACzD,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,KAAK,GAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEtD,QAAQ;QACR,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAEzC,wBAAwB;QACxB,gBAAgB,CAAC,QAAe,EAAE,eAAe,EAAE,GAAG,EAAE,CACtD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAC5C,CAAC;QAEF,gBAAgB,CAAC,QAAe,EAAE,iBAAiB,EAAE,CAAC,IAAS,EAAE,EAAE;YACjE,mDAAmD;YACnD,WAAW,CAAC,QAAQ,CAAC,CAAC;YACtB,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,WAAW,CAAC,QAAQ,CAAC,CAAC;YAEtB,2BAA2B;YAC3B,cAAc,CAAC,GAAG,EAAE,CAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,CAC9D,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,+CAA+C;QAC/C,OAAO,IAAI,UAAU,CACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAChB,QAAQ,EACR,KAAK,CAAC,OAAO,CACd,CAAC,KAAK,EAAY,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/create/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAmB,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAIrE,MAAM,OAAO,YAAY;IAKvB,YAAoB,IAAuB;QAAvB,SAAI,GAAJ,IAAI,CAAmB;QAJnC,YAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAK9B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,CAAS,UAA4C;QACzD,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,KAAK,GAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEtD,QAAQ;QACR,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAEzC,wBAAwB;QACxB,gBAAgB,CAAC,QAAe,EAAE,eAAe,EAAE,GAAG,EAAE,CACtD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAC5C,CAAC;QAEF,gBAAgB,CAAC,QAAe,EAAE,iBAAiB,EAAE,CAAC,IAAS,EAAE,EAAE;YACjE,mDAAmD;YACnD,WAAW,CAAC,QAAQ,CAAC,CAAC;YACtB,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC;oBAAS,CAAC;gBACT,WAAW,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;YAED,2BAA2B;YAC3B,cAAc,CAAC,GAAG,EAAE,CAClB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,CAC9D,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,+CAA+C;QAC/C,OAAO,IAAI,UAAU,CACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAChB,QAAQ,EACR,KAAK,CAAC,OAAO,CACd,CAAC,KAAK,EAAY,CAAC;IACtB,CAAC;CACF"}

package/dist/create/proxy.d.ts

@@ -4,6 +4,8 @@ export declare class StoreProxy {
     private target;
     private actions;
     private notifyQueued;
+    private pendingNotify;
+    private wrapped;
     constructor(deps: SystemDeps, target: any, actions: string[]);
     build(): any;
     private scheduleNotify;