stroid 0.0.4 → 0.1.0

package/dist/testing.js

@@ -1 +1,20 @@
-import {d,i as i$1,e,k}from'./chunk-5F2FD6DX.js';var l=(e$1="mock",o={})=>(d(e$1,o),{set:r=>e(e$1,r),reset:()=>i$1(e$1),use:()=>({name:e$1})}),u=(e,o)=>{let r=Date.now;Date.now=()=>e;try{return o()}finally{Date.now=r;}},i=()=>k(),m=(e$1,o=1e3,r=t=>({value:t}))=>{let t=typeof performance<"u"&&performance.now?performance.now():Date.now();for(let n=0;n<o;n++)e(e$1,r(n));let s=(typeof performance<"u"&&performance.now?performance.now():Date.now())-t;return {iterations:o,totalMs:s,avgMs:s/o}};export{m as benchmarkStoreSet,l as createMockStore,i as resetAllStoresForTest,u as withMockedTime};
+var tn={log:(e,t)=>{typeof console<"u"&&typeof console.log=="function"&&(t?console.log(`[stroid] ${e}`,t):console.log(`[stroid] ${e}`));},warn:(e,t)=>{typeof console<"u"&&typeof console.warn=="function"&&(t?console.warn(`[stroid] ${e}`,t):console.warn(`[stroid] ${e}`));},critical:(e,t)=>{typeof console<"u"&&typeof console.error=="function"&&(t?console.error(`[stroid] ${e}`,t):console.error(`[stroid] ${e}`));}},_t={logSink:tn,flush:{chunkSize:Number.POSITIVE_INFINITY,chunkDelayMs:0,priorityStores:[]},revalidateOnFocus:{debounceMs:0,maxConcurrent:3,staggerMs:100},namespace:"",strictMissingFeatures:true,assertRuntime:false,strictMutatorReturns:true,asyncAutoCreate:false,asyncCloneResult:"none",defaultSnapshotMode:"deep",middleware:[],allowUntrustedHydration:false,mutatorProduce:void 0},Je={..._t},M=()=>Je;var It=()=>{Je={..._t};};var Wt=()=>Je.namespace;var rn=typeof process<"u"&&typeof process.env?.NODE_ENV=="string"?process.env.NODE_ENV:void 0,nn=typeof import.meta<"u"&&import.meta?.env?.MODE?import.meta.env.MODE:void 0,zt=typeof globalThis<"u"&&typeof globalThis.__STROID_DEV__=="boolean"?globalThis.__STROID_DEV__:void 0,on="production",sn=rn??nn??on,we=typeof zt=="boolean"?zt:sn!=="production",R=()=>we,Qe=(e,t)=>{typeof console<"u"&&typeof console.warn=="function"&&(t?console.warn(`[stroid] ${e}`,t):console.warn(`[stroid] ${e}`));},an=(e,t)=>{typeof console<"u"&&typeof console.error=="function"&&(t?console.error(`[stroid] ${e}`,t):console.error(`[stroid] ${e}`));},cn=(e,t)=>{typeof console<"u"&&typeof console.log=="function"&&(t?console.log(`[stroid] ${e}`,t):console.log(`[stroid] ${e}`));},O=(e,t)=>{if((M().logSink.critical??an)(e,t),M().assertRuntime)throw new Error(e)},w=(e,t)=>{if(!we)return;if((M().logSink.warn??Qe)(e,t),M().assertRuntime)throw new Error(e)},K=(e,t)=>{if((M().logSink.warn??Qe)(e,t),M().assertRuntime)throw new Error(e)},j=(e,t)=>{if(we&&(M().logSink.warn??Qe)(e,t),O(e,t),M().assertRuntime)throw new Error(e)},$=(e,t)=>{if(!we)return;(M().logSink.log??cn)(e,t);},Ht=()=>`Functions cannot be stored in stroid.
+Store data only - handle functions outside the store.`,Bt=()=>`Map/Set detected. stroid converts these to plain objects.
+Use arrays or plain objects for best results.`,Lt=()=>`Date object detected. stroid stores it as ISO string.
+Use new Date(value) to convert back when reading.`,qt=()=>"Date detected; stored as ISO string. Use new Date(value) when reading.",Kt=()=>"Map detected; converting to plain object.",Ut=()=>"Set detected; converting to array.",Gt=(e,t,r)=>`Path depth of ${e} exceeded maximum of ${t}.
+"${r.join(".")}"
+This is a data design issue. Split into separate stores:
+createStore("${r[0]}", ...) and createStore("${r[1]}", ...)`,Yt=(e,t)=>`Deep nesting detected (${e} levels): "${t.join(".")}"
+Consider splitting into separate stores for better readability.`;var Xt=e=>`Store name must be a non-empty string. Got: ${JSON.stringify(e)}`,Jt=e=>`Store name "${e}" contains spaces.
+Use camelCase or kebab-case: "userName" or "user-name"`,Qt=e=>`Store name "${e}" is not allowed.
+Reserved names: "__proto__", "constructor", "prototype".`,un=128,ln=(e,t)=>Math.abs(e.length-t.length)>2?false:Math.max(e.length,t.length)<=un,dn=(e,t)=>{if(e===t)return 0;if(e.length===0)return t.length;if(t.length===0)return e.length;let r=Array.from({length:e.length+1},(s,o)=>o),n=new Array(e.length+1);for(let s=1;s<=t.length;s++){n[0]=s;for(let o=1;o<=e.length;o++)n[o]=t[s-1]===e[o-1]?r[o-1]:Math.min(r[o-1],n[o-1],r[o])+1;[r,n]=[n,r];}return r[e.length]},Ze=(e,t)=>{let r=t.find(n=>{let s=n.toLowerCase(),o=e.toLowerCase();return s.includes(o)||o.includes(s)||ln(s,o)&&dn(s,o)<=2});if(r){w(`Store "${e}" not found. Did you mean "${r}"?`);return}j(`Store "${e}" not found.
+Available stores: [${t.join(", ")}]
+Call createStore("${e}", data) first.`);};var H=new Set(["__proto__","constructor","prototype"]),tt=(e,t)=>{if(!e)return {ok:true};try{if(typeof e.safeParse=="function"){let r=e.safeParse(t);return r.success?{ok:!0,data:r.data}:{ok:!1,error:r.error}}if(typeof e.parse=="function")return e.parse(t),{ok:!0,data:t};if(typeof e.validateSync=="function")return e.validateSync(t),{ok:!0,data:t};if(typeof e.isValidSync=="function")return e.isValidSync(t)?{ok:!0,data:t}:{ok:!1,error:"Schema validation failed"};if(typeof e.validate=="function"){let r=e.validate(t);if(r===!0)return {ok:!0,data:t};if(r===!1)return {ok:!1,error:e.errors||"Schema validation failed"};if(r&&typeof r=="object"){let s=r.error,o=s?.details?.[0]?.message||s?.message||r.message||e.errors;if(o)return {ok:!1,error:o};if(s)return {ok:!1,error:s}}return {ok:!1,error:e.errors||"Schema validation failed"}}if(typeof e=="function"){let r=e(t);return r===!1?{ok:!1,error:"Schema validation failed"}:{ok:!0,data:r===!0?t:r}}return {ok:!0,data:t}}catch(r){return {ok:false,error:r?.message??r}}};var J=e=>e===null?"null":Array.isArray(e)?"array":e instanceof Map?"map":e instanceof Set?"set":e instanceof Date?"date":typeof e=="function"?"function":typeof e,Zt=e=>{if(!e||typeof e!="object")return null;let t=globalThis?.WeakRef;return t&&e instanceof t?"WeakRef":typeof WeakMap<"u"&&e instanceof WeakMap?"WeakMap":typeof WeakSet<"u"&&e instanceof WeakSet?"WeakSet":typeof EventTarget<"u"&&e instanceof EventTarget?"EventTarget":typeof ReadableStream<"u"&&e instanceof ReadableStream?"ReadableStream":typeof WritableStream<"u"&&e instanceof WritableStream?"WritableStream":typeof Request<"u"&&e instanceof Request?"Request":typeof Response<"u"&&e instanceof Response?"Response":typeof Headers<"u"&&e instanceof Headers?"Headers":typeof FormData<"u"&&e instanceof FormData?"FormData":null},xe=e=>{let t=J(e);return t==="function"?(j(Ht()),false):t==="map"||t==="set"?(w(Bt()),true):(t==="date"&&w(Lt()),true)},et=(e,t)=>{let r=Zt(e);if(r)throw new Error(`${r} values are not supported`);let n=J(e);if(n==="number"){if(!Number.isFinite(e))throw new Error("Non-finite numbers are not supported");return  true}if(n==="bigint")throw new Error("BigInt values are not supported");if(n==="symbol")throw new Error("Symbol values are not supported");if(n==="date"||n==="map"||n==="set")return  false;if(n==="array"){if(t.has(e))throw new Error("Circular reference detected during sanitize");t.add(e);let s=Object.keys(e);for(let o of s){let a=Number(o);if(!Number.isInteger(a))return  false}for(let o=0;o<e.length;o+=1)if(o in e&&!et(e[o],t))return  false;return  true}if(n==="object"){if(t.has(e))throw new Error("Circular reference detected during sanitize");if(t.add(e),Object.getOwnPropertySymbols(e).length>0)return  false;let s=Object.getOwnPropertyDescriptors(e);for(let[o,a]of Object.entries(s)){if(!a.enumerable||H.has(o))return  false;if("get"in a||"set"in a)throw new Error(`Accessor properties are not supported during sanitize ("${o}")`);if(!et(a.value,t))return  false}return  true}return  true},rt=e=>et(e,new WeakSet),ve=(e,t)=>{let r=Zt(e);if(r)throw new Error(`${r} values are not supported`);let n=J(e);if(n==="number"){if(!Number.isFinite(e))throw new Error("Non-finite numbers are not supported");return e}if(n==="bigint")throw new Error("BigInt values are not supported");if(n==="symbol")throw new Error("Symbol values are not supported");if(n==="date")return R()&&w(qt()),e.toISOString();if(n==="map"){if(t.has(e))throw new Error("Circular reference detected during sanitize");t.add(e),R()&&w(Kt());let s={};for(let[o,a]of e){if(typeof o!="string")throw new Error("Map keys must be strings to remain JSON-safe");s[String(o)]=ve(a,t);}return s}if(n==="set"){if(t.has(e))throw new Error("Circular reference detected during sanitize");return t.add(e),R()&&w(Ut()),Array.from(e,s=>ve(s,t))}if(n==="object"){if(t.has(e))throw new Error("Circular reference detected during sanitize");t.add(e);let s={},o=Object.getOwnPropertyDescriptors(e);for(let[a,u]of Object.entries(o))if(u.enumerable&&!H.has(a)){if("get"in u||"set"in u)throw new Error(`Accessor properties are not supported during sanitize ("${a}")`);s[a]=ve(u.value,t);}return s}if(n==="array"){if(t.has(e))throw new Error("Circular reference detected during sanitize");return t.add(e),e.map(s=>ve(s,t))}return e},ee=e=>ve(e,new WeakSet),nt=e=>typeof e!="string"||e.trim()===""?(j(Xt(e)),false):H.has(e)?(j(Qt(e)),false):e.includes(" ")?(j(Jt(e)),false):true;var ot=null,fn=()=>{if(ot)return ot;let e,t=[];for(let r=0;r<256;r++){e=r;for(let n=0;n<8;n++)e=e&1?3988292384^e>>>1:e>>>1;t[r]=e>>>0;}return ot=t,t},tr=e=>{let t=fn(),r=-1;for(let n=0;n<e.length;n++)r=r>>>0,r=r>>>8^t[(r^e.charCodeAt(n))&255];return (r^-1)>>>0},pn=2166136261,gn=2654435761,Sn=1e5,Q=(e,t)=>{let r=t>>>0;e.h1=Math.imul(e.h1^r,2246822507),e.h2=Math.imul(e.h2^r,3266489909);},te=(e,t)=>{Q(e,t.length);for(let r=0;r<t.length;r++)Q(e,t.charCodeAt(r));},F=(e,t)=>{te(e,t);},er=(e,t)=>{if(Number.isNaN(t)){F(e,"NaN");return}if(!Number.isFinite(t)){F(e,t>0?"Infinity":"-Infinity");return}if(Object.is(t,-0)){F(e,"-0");return}let r=t|0;if(t===r){F(e,"int"),Q(e,r);return}F(e,"num"),te(e,String(t));},de=(e,t)=>{if(e.nodes++>Sn){F(e,"[max]");return}if(t===null){F(e,"null");return}let r=typeof t;if(r==="string"){F(e,"string"),te(e,t);return}if(r==="number"){F(e,"number"),er(e,t);return}if(r==="boolean"){F(e,t?"true":"false");return}if(r==="undefined"){F(e,"undefined");return}if(r==="bigint"){F(e,"bigint"),te(e,t.toString());return}if(r==="symbol"){F(e,"symbol");let l=t;te(e,Symbol.keyFor(l)??l.description??String(l));return}if(r==="function"){F(e,"function"),te(e,t.name||"anonymous");return}let n=t,s=e.seen.get(n);if(s!==void 0){F(e,"ref"),Q(e,s);return}let o=e.nextId++;if(e.seen.set(n,o),Array.isArray(n)){F(e,"array"),Q(e,n.length);for(let l=0;l<n.length;l++)Object.prototype.hasOwnProperty.call(n,l)?de(e,n[l]):F(e,"hole");return}if(n instanceof Date){F(e,"date"),er(e,n.getTime());return}if(n instanceof Map){F(e,"map"),Q(e,n.size),n.forEach((l,p)=>{de(e,p),de(e,l);});return}if(n instanceof Set){F(e,"set"),Q(e,n.size),n.forEach(l=>{de(e,l);});return}F(e,"object");let a=Object.getOwnPropertyDescriptors(n),u=[];Object.entries(a).forEach(([l,p])=>{p?.enumerable&&(H.has(l)||"get"in p||"set"in p||u.push([l,p]));}),Q(e,u.length);for(let[l,p]of u)te(e,l),de(e,p.value);},ke=e=>{if(typeof e=="string")return tr(JSON.stringify(e));let t={h1:pn,h2:gn,seen:new WeakMap,nextId:1,nodes:0};de(t,e);let r=t.h1>>>0,n=t.h2>>>0;return r^=r>>>16,r=Math.imul(r,2246822507),r^=r>>>13,r=Math.imul(r,3266489909),r^=r>>>16,n^=n>>>16,n=Math.imul(n,668265261),n^=n>>>15,n=Math.imul(n,374761393),n^=n>>>16,(r&2097151)*4294967296+(n>>>0)};var yn=typeof globalThis<"u"&&typeof globalThis.structuredClone=="function",st=e=>{if(e===null||typeof e!="object")return e;if(e instanceof Date)return new Date(e.getTime());if(e instanceof Map)return new Map(e);if(e instanceof Set)return new Set(e);if(Array.isArray(e))return e.slice();let t={},r=Object.getOwnPropertyDescriptors(e);return Object.entries(r).forEach(([n,s])=>{s.enumerable&&(H.has(n)||"get"in s||"set"in s||(t[n]=s.value));}),t},fe=(e,t=new WeakMap)=>{if(e===null||typeof e!="object")return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof Map){let o=new Map;return t.set(e,o),e.forEach((a,u)=>{o.set(fe(u,t),fe(a,t));}),o}if(e instanceof Set){let o=new Set;return t.set(e,o),e.forEach(a=>{o.add(fe(a,t));}),o}if(Array.isArray(e)){let o=[];return t.set(e,o),e.forEach((a,u)=>{o[u]=fe(a,t);}),o}let r=globalThis?.WeakRef;if(r&&e instanceof r)return K("WeakRef values cannot be deep-cloned. Returning the original reference."),e;let n={};t.set(e,n);let s;try{s=Object.getOwnPropertyDescriptors(e);}catch{return K("deepClone failed to read object descriptors (possible Proxy or host object). Returning the original reference."),e}return Object.entries(s).forEach(([o,a])=>{!a.enumerable||H.has(o)||"get"in a||"set"in a||(n[o]=fe(a.value,t));}),n},P=e=>{try{if(yn)return structuredClone(e)}catch{}return fe(e)};var rr=10,mn=5,hn=e=>{let t=[],r="",n=false;for(let s of e){if(n){r+=s,n=false;continue}if(s==="\\"){n=true;continue}if(s==="."){t.push(r),r="";continue}r+=s;}return n&&(r+="\\"),t.push(r),t},Re=e=>Array.isArray(e)?[...e]:typeof e=="string"&&!e.includes(".")?[e]:typeof e=="string"?hn(e):[String(e)],at=e=>{let t=Re(e),r=t.length;return r>rr?(j(Gt(r,rr,t)),false):(r>mn&&w(Yt(r,t)),true)};var it=(e,t,r)=>{let n=Re(t);if(n.length===0)return e;for(let o of n)if(H.has(o))return O(`Blocked forbidden path segment "${String(o)}" in setStore path "${n.join(".")}".`),e;let s=(o,a)=>{let u=n[a],l=a===n.length-1;if(Array.isArray(o)){let p=Number(u);if(!Number.isInteger(p))return o;let g=[...o];return l?(g[p]=r,g):(g[p]=s(g[p],a+1),g)}if(o&&typeof o=="object"){if(H.has(u))return O(`Blocked unsafe path segment "${String(u)}" while setting "${n.join(".")}".`),o;let p={...o};return l?(p[u]=r,p):(p[u]=s(p[u],a+1),p)}if(o==null&&!l){let p=Number.isInteger(Number(u)),g=p?[]:{};if(p){let f=g,c=Number(u);return f[c]=s(void 0,a+1),f}return g[u]=s(void 0,a+1),g}return l?r:o};return s(e,0)};var ut=new Set,or=()=>{ut.clear();},$e=(()=>{let e=new Map;return {getItem:t=>e.has(t)?e.get(t):null,setItem:(t,r)=>{e.set(t,r);},removeItem:t=>{e.delete(t);},type:"memory"}})(),ct=e=>{try{return typeof window>"u"?$e:e==="session"||e==="sessionStorage"?window.sessionStorage??$e:window.localStorage??$e}catch{return $e}},_e=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),pe=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),sr=e=>{try{let t=`__stroid_plaintext_probe_${Math.random().toString(36).slice(2)}__`,r=`__stroid_plaintext_probe_${Math.random().toString(36).slice(2)}__`;return e(t)!==t?!1:e(r)===r}catch{return  false}},bn=typeof Symbol=="function"?Symbol.for("stroid.persist.defaultCrypto"):"__stroid_persist_defaultCrypto__",nr=e=>{try{e[bn]=!0;}catch{}return e},wn={allowSSRGlobalStore:'scope: "global"',schema:"validate",validator:"validate",version:"persist.version",migrations:"persist.migrations",historyLimit:"devtools.historyLimit",redactor:"devtools.redactor",middleware:"lifecycle.middleware",onCreate:"lifecycle.onCreate",onSet:"lifecycle.onSet",onReset:"lifecycle.onReset",onDelete:"lifecycle.onDelete"},vn=(e,t)=>{if(!e)return null;let r={key:`stroid_${t}`,serialize:JSON.stringify,deserialize:JSON.parse,encrypt:nr(g=>g),decrypt:nr(g=>g),allowPlaintext:false,sensitiveData:false,onMigrationFail:"reset",checksum:"hash"};if(e===true)return {driver:ct("localStorage"),...r};if(typeof e=="string")return {driver:ct(e),...r};let n=e.encrypt||r.encrypt,s=e.decrypt||r.decrypt,o=e.encryptAsync,a=e.decryptAsync,u=e.sensitiveData===true,l=e.allowPlaintext===true,p=e.checksum==="sha256"?"sha256":e.checksum==="none"?"none":"hash";if(o&&!a||!o&&a)throw new Error(`[stroid/persist] Store "${t}" must provide both encryptAsync and decryptAsync when using async crypto.`);if(u&&sr(n)&&!o)throw new Error(`[stroid/persist] Store "${t}" is marked sensitiveData but is configured to persist in plaintext. Provide encrypt/decrypt hooks to protect sensitive data.`);return {driver:e.driver||e.storage||ct("localStorage"),key:e.key||r.key,serialize:e.serialize||r.serialize,deserialize:e.deserialize||r.deserialize,encrypt:n,decrypt:s,encryptAsync:o,decryptAsync:a,allowPlaintext:l,sensitiveData:u,checksum:p,onMigrationFail:e.onMigrationFail||"reset",onStorageCleared:e.onStorageCleared}},ar=e=>{if(!_e(e))return [];let t=[];return Object.entries(wn).forEach(([r,n])=>{pe(e,r)&&(ut.has(r)||(ut.add(r),t.push(`createStore option "${r}" is deprecated. Use "${n}" instead.`)));}),t},ir=(e={},t)=>{let r=e.scope??"request",n=e.lazy===true,s=e.pathCreate===true,o=_e(e.lifecycle)?e.lifecycle:void 0,a=_e(e.persist)?e.persist:void 0,u=_e(e.devtools)?e.devtools:void 0,l=e.validate??e.validator??e.schema,p=e.snapshot==="shallow"||e.snapshot==="ref"?e.snapshot:"deep",g=pe(e,"persist"),f=pe(e,"sync"),c=pe(e,"devtools")||pe(e,"historyLimit")||pe(e,"redactor"),y=r==="global"?true:e.allowSSRGlobalStore??false,{persist:S=false,devtools:i=false,onError:h,sync:x}=e;if(a?.sensitiveData===true){let m=a.encrypt,v=a.encryptAsync;if((!m||sr(m))&&!v)throw new Error(`[stroid/persist] Store "${t}" is marked sensitiveData but is configured to persist in plaintext. Provide encrypt/decrypt hooks to protect sensitive data.`)}return {scope:r,lazy:n,pathCreate:s,persist:r==="temp"&&!g?null:vn(S,t),devtools:r==="temp"&&!c?false:typeof i=="boolean"?i:u?.enabled??true,middleware:o?.middleware??e.middleware??[],onSet:o?.onSet??e.onSet,onReset:o?.onReset??e.onReset,onDelete:o?.onDelete??e.onDelete,onCreate:o?.onCreate??e.onCreate,onError:h,validate:l,migrations:a?.migrations??e.migrations??{},version:a?.version??e.version??1,redactor:r==="temp"&&!c?void 0:u?.redactor??e.redactor,historyLimit:r==="temp"&&!c?0:u?.historyLimit??e.historyLimit??50,sync:r==="temp"&&!f?false:x??false,allowSSRGlobalStore:y,snapshot:p,explicitPersist:g,explicitSync:f,explicitDevtools:c}};var cr=e=>{if(typeof e!="object"||e===null||e.$$typeof||typeof window<"u"&&e instanceof Element||e.constructor&&e.constructor.name!=="Object"&&e.constructor.name!=="Array")return e;let t=[e],r=new WeakSet;for(;t.length>0;){let n=t.pop();if(!r.has(n)){r.add(n),Object.isFrozen(n)||Object.freeze(n);for(let s of Object.keys(n)){let o=n[s];typeof o=="object"&&o!==null&&!r.has(o)&&t.push(o);}}}return e};var ur=()=>({fetchRegistry:Object.create(null),inflight:Object.create(null),requestVersion:Object.create(null),cacheMeta:Object.create(null),rateWindowStart:Object.create(null),rateCount:Object.create(null),ratePruneState:{lastAt:0},ratePruneTimer:null,noSignalWarned:new Set,shapeWarned:new Set,autoCreateWarned:new Set,cleanupSubs:Object.create(null),storeCleanupFns:Object.create(null),revalidateKeys:new Set,revalidateHandlers:Object.create(null),asyncMetrics:{cacheHits:0,cacheMisses:0,dedupes:0,requests:0,failures:0,avgMs:0,lastMs:0}}),Ie=e=>{Object.values(e.revalidateHandlers).forEach(t=>{try{t();}catch{}}),Object.values(e.cleanupSubs).forEach(t=>{try{t();}catch{}}),Object.values(e.storeCleanupFns).forEach(t=>{t.forEach(r=>{try{r();}catch{}});}),Object.keys(e.fetchRegistry).forEach(t=>delete e.fetchRegistry[t]),Object.keys(e.inflight).forEach(t=>delete e.inflight[t]),Object.keys(e.requestVersion).forEach(t=>delete e.requestVersion[t]),Object.keys(e.cacheMeta).forEach(t=>delete e.cacheMeta[t]),Object.keys(e.rateWindowStart).forEach(t=>delete e.rateWindowStart[t]),Object.keys(e.rateCount).forEach(t=>delete e.rateCount[t]),Object.keys(e.cleanupSubs).forEach(t=>delete e.cleanupSubs[t]),Object.keys(e.storeCleanupFns).forEach(t=>delete e.storeCleanupFns[t]),Object.keys(e.revalidateHandlers).forEach(t=>delete e.revalidateHandlers[t]),e.revalidateKeys.clear(),e.noSignalWarned.clear(),e.shapeWarned.clear(),e.autoCreateWarned.clear(),e.ratePruneState.lastAt=0,e.ratePruneTimer&&(clearTimeout(e.ratePruneTimer),e.ratePruneTimer=null),e.asyncMetrics.cacheHits=0,e.asyncMetrics.cacheMisses=0,e.asyncMetrics.dedupes=0,e.asyncMetrics.requests=0,e.asyncMetrics.failures=0,e.asyncMetrics.avgMs=0,e.asyncMetrics.lastMs=0;};var lt=new Map,xn=typeof __STROID_REGISTRY_ID__<"u"&&__STROID_REGISTRY_ID__||typeof process<"u"&&process.env?.STROID_REGISTRY_ID||void 0,lr,We=e=>(lr||xn||e).replace(/\.ts(\?|$)/,".js$1"),U=We(new URL("./store.js",import.meta.url).href);var dr=()=>{lr=void 0,lt.clear();},kn=()=>({stores:Object.create(null),subscribers:Object.create(null),initialStates:Object.create(null),initialFactories:Object.create(null),metaEntries:Object.create(null),snapshotCache:Object.create(null),featureRuntimes:new Map,deletingStores:new Set,computedEntries:Object.create(null),computedDependents:Object.create(null),computedCleanups:new Map,transaction:{depth:0,pending:[],stagedValues:new Map,failed:false,error:void 0},async:ur()}),re=e=>{let t=We(e),r=lt.get(t);if(r)return r;let n=kn();return lt.set(t,n),n},ge=(e,t)=>Object.prototype.hasOwnProperty.call(e.stores,t),fr=(e,t)=>e.deletingStores.has(t),pr=e=>{e.computedCleanups.forEach(t=>{try{t();}catch{}}),e.computedCleanups.clear(),[e.stores,e.subscribers,e.initialStates,e.initialFactories,e.metaEntries,e.snapshotCache,e.computedEntries,e.computedDependents].forEach(t=>{Object.keys(t).forEach(r=>{delete t[r];});}),e.deletingStores.clear(),e.transaction.depth=0,e.transaction.pending=[],e.transaction.stagedValues.clear(),e.transaction.failed=false,e.transaction.error=void 0,Ie(e.async);};var dt=()=>null;var gr=(e,t)=>t(),ne=e=>e||re(U);var ft=new Map;var ze=e=>ft.has(e),pt=e=>ft.get(e),Me=()=>Array.from(ft.keys());var He=Symbol("stroid.middleware.abort"),mr=({name:e,payload:t,middlewares:r,reportIssue:n,warn:s})=>{if(!Array.isArray(r)||r.length===0)return t.next;let o=new WeakSet,a=P(t.next);for(let u of r){if(typeof u!="function")continue;let l,p=a;try{l=u({action:t.action,name:e,prev:t.prev,next:p,path:t.path});}catch(g){let f=`Middleware for "${e}" failed: ${g?.message??g}`;return n(f,"dev"),He}if(l&&typeof l.then=="function"){let g=`Middleware for "${e}" must be synchronous. Promise-returning middleware is not supported.`;return n(g,"dev"),He}l===void 0?(R()&&!o.has(u)&&(o.add(u),s(`Middleware for "${e}" returned undefined; treating as pass-through. Return the new state to override.`)),a=p):a=l;}return a},Be=({name:e,label:t,fn:r,args:n,reportIssue:s})=>{if(typeof r=="function")try{r(...n);}catch(o){let a=`${t} for "${e}" failed: ${o?.message??o}`;s(a,"always");}};var oe=(e,t={})=>{let{severity:r="warn",visibility:n="dev",onError:s}=t;if(s?.(e),r==="critical"){n==="dev"&&w(e),O(e);return}if(n==="always"){K(e);return}w(e);};var hr=()=>ne(re(U)),br=()=>hr().computedEntries,Mn=()=>hr().computedDependents;var wr=e=>Object.prototype.hasOwnProperty.call(br(),e);var vr=e=>{let t=br(),r=Mn(),n=new Set,s=[...e];for(;s.length>0;){let g=s.shift(),f=r[g];if(f)for(let c of f)n.has(c)||(n.add(c),s.push(c));}if(n.size===0)return [];let o=g=>{let f=t[g];if(f)for(let c of f.deps)t[c]&&(n.has(c)||(n.add(c),o(c)));};Array.from(n).forEach(g=>o(g));let a=new Map,u=new Map;for(let g of n){let f=t[g];if(!f)continue;let c=0;for(let y of f.deps)n.has(y)&&(c++,u.has(y)||u.set(y,[]),u.get(y).push(g));a.set(g,c);}let l=[];for(let[g,f]of a)f===0&&l.push(g);l.sort();let p=[];for(;l.length>0;){let g=l.shift();p.push(g);let f=u.get(g)??[];for(let c of f){let y=(a.get(c)??1)-1;if(a.set(c,y),y===0){let S=l.findIndex(i=>i>c);S===-1?l.push(c):l.splice(S,0,c);}}}return p};var gt=e=>({name:e});var Fe=e=>(e??ne()).transaction,Fn=e=>e instanceof Error?e:typeof e=="string"?new Error(e):e&&typeof e?.message=="string"?new Error(e.message):new Error("setStoreBatch aborted");var k=()=>Fe().depth>0,V=(e,t)=>{let r=Fe(t);r.failed=true,r.error||(r.error=Fn(e));},Ee=e=>{let t=ne();Fe(t).pending.push(()=>gr(t,e));},Ae=(e,t)=>{Fe().stagedValues.set(e,t);},se=e=>{let t=Fe();return t.stagedValues.has(e)?{has:true,value:t.stagedValues.get(e)}:{has:false,value:void 0}};var ae=new Set,De=[],Le=false,Cr=0,xr=e=>{let t=d[e]?.options?.snapshot??M().defaultSnapshotMode;return t==="shallow"||t==="ref"?t:"deep"},kr=(e,t)=>t==="ref"?e:t==="shallow"?st(e):P(e);var St=(e,t)=>{if(t>0&&typeof setTimeout=="function"){setTimeout(e,t);return}if(typeof queueMicrotask=="function"){queueMicrotask(e);return}Promise.resolve().then(e);},En=()=>{De.length=0;for(let f of ae)De.push(f);ae.clear();let e=M().flush,t=e.priorityStores||[],r=new Set(De),n=t.length?new Set(t):null,s=[];if(n){for(let f of t)r.has(f)&&s.push(f);for(let f of De)n.has(f)||s.push(f);}else s.push(...De);let o=vr(s),a=new Set(s);for(let f of o)r.has(f)&&!a.has(f)&&(s.push(f),a.add(f));let u=Number.isFinite(e.chunkSize)&&e.chunkSize>0?e.chunkSize:Number.POSITIVE_INFINITY,l=e.chunkDelayMs,p=u===Number.POSITIVE_INFINITY&&l===0;return {names:s.slice(),sliceSize:u,chunkDelayMs:l,runInline:p,prioritySet:n}},Rr=()=>{let{names:e,sliceSize:t,chunkDelayMs:r,runInline:n,prioritySet:s}=En(),o=()=>typeof performance<"u"&&performance.now?performance.now():Date.now(),a=()=>{Le=false,ae.size>0&&Mr();};if(n){for(let c of e){let y=Z[c];if(!y||y.size===0)continue;let S=d[c]?.updateCount??0,i=xr(c),h=Se[c],x=h&&h.version===S?h.snapshot:(()=>{let b=kr(D[c],i);return Se[c]={version:S,snapshot:b},b})(),m=o();for(let b of y)try{b(x);}catch(A){w(`Subscriber for "${c}" threw: ${A?.message??A}`);}let v=o()-m,C=d[c]?.metrics||{notifyCount:0,totalNotifyMs:0,lastNotifyMs:0};C.notifyCount+=1,C.totalNotifyMs+=v,C.lastNotifyMs=v,d[c]&&(d[c].metrics=C),(d[c]?.updateCount??S)!==S&&ae.add(c);}a();return}let u=c=>{let y=[];for(let S of e){if(c&&!c(S))continue;let i=Z[S];if(!i||i.size===0)continue;let h=d[S]?.updateCount??0,x=xr(S),m=Se[S],v=m&&m.version===h?m.snapshot:(()=>{let C=kr(D[S],x);return Se[S]={version:h,snapshot:C},C})();y.push({name:S,subsArray:Array.from(i),index:0,snapshot:v,version:h,notified:new Set,metrics:d[S]?.metrics?{...d[S].metrics}:{notifyCount:0,totalNotifyMs:0,lastNotifyMs:0},totalMs:0});}return y},l=s?u(c=>s.has(c)):[],p=u(c=>!s||!s.has(c)),g=c=>{let y=Z[c.name];if(!y||y.size===0){c.subsArray=[],c.index=0;return}c.subsArray=Array.from(y),c.index=0;},f=(c,y)=>{let S=()=>{if(c.length===0){y();return}let i=c.shift();if((d[i.name]?.updateCount??i.version)!==i.version){if(ae.add(i.name),c.length===0){y();return}n?S():St(S,r);return}if(g(i),i.subsArray.length===0){if(c.length===0){y();return}n?S():St(S,r);return}let x=o(),m=0;for(;i.index<i.subsArray.length&&m<t;){let E=i.subsArray[i.index++];if(!i.notified.has(E)){i.notified.add(E);try{E(i.snapshot);}catch(b){w(`Subscriber for "${i.name}" threw: ${b?.message??b}`);}m+=1;}}i.totalMs+=o()-x;let v=Z[i.name],C=v?Array.from(v).some(E=>!i.notified.has(E)):false;if(i.index<i.subsArray.length||C?c.push(i):(i.metrics.notifyCount+=1,i.metrics.totalNotifyMs+=i.totalMs,i.metrics.lastNotifyMs=i.totalMs,d[i.name]&&(d[i.name].metrics=i.metrics)),c.length===0){y();return}n?S():St(S,r);};S();};l.length>0?f(l,()=>f(p,a)):f(p,a);},Mr=()=>{Le||(Le=true,typeof queueMicrotask=="function"?queueMicrotask(Rr):Promise.resolve().then(Rr));},B=e=>{ae.add(e),Cr===0&&Mr();};var Fr=()=>{ae.clear(),Le=false,Cr=0;};var An=()=>N().computedCleanups;var Er=e=>{let t=An(),r=t.get(e);if(!r){R()&&w(`deleteComputed("${e}") -- not found`);return}r(),t.delete(e);};var Ar=e=>{let t=e.stores,r=e.subscribers,n=e.initialStates,s=e.initialFactories,o=e.metaEntries,a=e.snapshotCache,u=e.featureRuntimes,l=e.deletingStores,p=(i,h)=>{oe(h,{onError:o[i]?.options?.onError,severity:"warn",visibility:"dev"});},g=({name:i,prev:h,options:x,initialState:m,getMeta:v,getStoreValue:C,hasStore:E})=>({name:i,options:x,prev:h,getMeta:v,getStoreValue:C,getAllStores:()=>t,getInitialState:()=>m,hasStore:E,setStoreValue:()=>{},applyFeatureState:()=>{},notify:()=>{},reportStoreError:b=>{oe(b,{onError:x.onError,severity:"warn",visibility:"dev"});},warn:w,log:$,hashState:ke,deepClone:P,sanitize:ee,validate:()=>({ok:true,value:h}),isDev:R}),f=({name:i,prev:h,options:x,initialState:m,phase:v})=>{let C=g({name:i,prev:h,options:x,initialState:m,getMeta:()=>o[i],getStoreValue:()=>t[i],hasStore:()=>ge(e,i)}),E=g({name:i,prev:h,options:x,initialState:m,getMeta:()=>{},getStoreValue:()=>h,hasStore:()=>false});Me().forEach(b=>{let A=u.get(b);v==="before"?A?.beforeStoreDelete?.(C):A?.afterStoreDelete?.(E);});},c=i=>{if(!ge(e,i))return;let h=t[i],x=o[i].options,m=n[i],v=r[i];l.add(i);try{v?.forEach(b=>{try{b(null);}catch(A){w(`Subscriber for "${i}" threw during delete: ${A?.message??A}`);}}),Be({name:i,label:"onDelete",fn:x.onDelete,args:[h],reportIssue:(b,A)=>{oe(b,{onError:x.onError,severity:"warn",visibility:A});}}),f({name:i,prev:h,options:x,initialState:m,phase:"before"}),delete t[i],delete r[i],delete n[i],delete s[i],delete o[i],delete a[i],wr(i)&&Er(i);let E=e.computedDependents[i];if(E)for(let b of E)w(`[stroid] source store "${i}" was deleted. Computed store "${b}" depends on it and will return stale data. Call deleteComputed("${b}") to clean up.`);f({name:i,prev:h,options:x,initialState:m,phase:"after"}),$(`Store "${i}" deleted`);}finally{l.delete(i);}};return {deleteExistingStore:c,clearAllStores:()=>{let i=[],x=0,m=Number.POSITIVE_INFINITY;for(;x<20;){let C=Object.keys(t);if(C.length===0)break;C.forEach(b=>{ge(e,b)&&(c(b),i.push(b));}),x+=1;let E=Object.keys(t).length;if(E===0||E>=m)break;m=E;}let v=Object.keys(t).length;return v>0?w(`clearAllStores stopped after ${x} pass${x===1?"":"es"}; ${v} store(s) still registered (likely recreated during deletion).`):w(`All stores cleared (${i.length} stores removed)`),i},clearStores:i=>{let h=Object.keys(t).filter(x=>i?i.endsWith("*")?x.startsWith(i.slice(0,-1)):x===i:true);return h.forEach(x=>c(x)),h},reportStoreError:p}};var Ke=U,Pr=re(Ke),Vr=null,Dr=new WeakSet,Dn=e=>{Dr.has(e)||(Dr.add(e),Me().forEach(t=>{if(!e.featureRuntimes.get(t)){let r=pt(t);r&&e.featureRuntimes.set(t,r());}}));},W=()=>{let e=ne(Pr);return Dn(e),e},Tr=(e,t)=>{Ke=e,Pr=t;},N=()=>W(),Nr=e=>{Vr=e;},ye=e=>new Proxy(Object.create(null),{get:(t,r)=>e()[r],set:(t,r,n)=>(e()[r]=n,true),deleteProperty:(t,r)=>(delete e()[r],true),has:(t,r)=>r in e(),ownKeys:()=>Reflect.ownKeys(e()),getOwnPropertyDescriptor:(t,r)=>{let n=Object.getOwnPropertyDescriptor(e(),r);if(n)return {...n,configurable:true}}}),On=e=>new Proxy(new Map,{get:(t,r)=>{let n=e();if(r==="size")return n.size;if(r===Symbol.iterator)return n[Symbol.iterator].bind(n);let s=n[r];return typeof s=="function"?s.bind(n):s},set:(t,r,n)=>(e()[r]=n,true)}),Pn=e=>new Proxy({},{get:(t,r)=>{let n=e(),s=n[r];return typeof s=="function"?s.bind(n):s},set:(t,r,n)=>(e()[r]=n,true)}),D=ye(()=>W().stores),Z=ye(()=>W().subscribers),q=ye(()=>W().initialStates),ie=ye(()=>W().initialFactories),d=ye(()=>W().metaEntries),Se=ye(()=>W().snapshotCache),L=On(()=>W().featureRuntimes),Or=new WeakMap,Vn=e=>{let t=Or.get(e);return t||(t=Ar(e),Or.set(e,t)),t};Pn(()=>Vn(W()));var $r=e=>{let t=L.get(e);if(t)return t;let r=pt(e);if(!r)return;let n=r();return L.set(e,n),n},yt=()=>{Me().forEach(e=>{$r(e);});};yt();var G=e=>ge(W(),e),qe=e=>{if(k()){let r=se(e);if(r.has)return r.value}let t=dt();return t&&Object.prototype.hasOwnProperty.call(t,e)?t[e]:D[e]},_=(e,t)=>{let n=R()?cr(t):t;D[e]=n;},mt=(e,t,r=Date.now())=>{_(e,t),d[e]&&(d[e].updatedAt=new Date(r).toISOString(),d[e].updatedAtMs=r,d[e].updateCount++,Vr?.(e));},ht=()=>{pr(W());},bt=()=>{L.forEach(e=>{try{e.resetAll?.();}catch{}}),L.clear();};var _r=e=>fr(W(),e),Ir=e=>{let t=typeof e=="string"?We(e):Ke,r=typeof e=="string"?re(t):e??re(Ke);return {scope:t,registry:r}};var Ue=new Set,wt=e=>e?Ue.has(e):Ue.size>0,vt=e=>{e&&Ue.add(e);},Oe=()=>{Ue.clear();},Wr=new Set,zr=e=>{let t=Wt();return !t||e.includes("::")?e:(R()&&!Wr.has(e)&&(Wr.add(e),w(`Namespace "${t}" is active; treating store "${e}" as "${t}::${e}". Consider using namespace("${t}").create("...") to be explicit.`)),`${t}::${e}`)},Ge=e=>zr(typeof e=="string"?e:e.name),xt=e=>G(e)&&!_r(e)?true:(Ze(e,Object.keys(D)),false),Hr=(e,t,r={})=>{oe(t,{...r,onError:d[e]?.options?.onError});},Br=(e,t,r={})=>{oe(e,{...r,onError:t});},ce=(e,t,r="dev")=>{Hr(e,t,{severity:"warn",visibility:r});},Lr=(e,t,r="dev")=>{Br(e,t,{severity:"warn",visibility:r});},Y=(e,t)=>Hr(e,t,{severity:"critical",visibility:"always"}),me=(e,t)=>Br(e,t,{severity:"critical",visibility:"always"}),Pe=(e,t,r)=>{let n=`Store "${e}" requested ${t} support, but "${t}" is not registered.
+Import "stroid/${t}" before calling createStore("${e}", ...).`;if(Lr(n,r,"always"),M().strictMissingFeatures)throw new Error(n)};var kt=new WeakMap,Rt=new WeakMap,Tn=500,Nn="",Ve=e=>{let t=kt.get(e);return t||(t=new Map,kt.set(e,t)),t},Ct=e=>{let t=Rt.get(e);return t||(t=new Map,Rt.set(e,t)),t},jn=(e,t)=>{let r=Ct(e),n=r.get(t);return n||(n=new Map,r.set(t,n)),n},qr=(e,t,r)=>{for(e.has(t)&&e.delete(t),e.set(t,r);e.size>Tn;){let n=e.keys().next().value;if(!n)break;let s=e.get(n);e.delete(n),s?.node.verdicts&&(s.node.verdicts.delete(s.type),s.node.verdicts.size===0&&delete s.node.verdicts);}};new Proxy(new Map,{get:(e,t)=>{let r=Ve(N());if(t==="size")return r.size;if(t===Symbol.iterator)return r[Symbol.iterator].bind(r);let n=r[t];return typeof n=="function"?n.bind(r):n},set:(e,t,r)=>(Ve(N())[t]=r,true)});var Kr=e=>{kt.set(e,new Map),Rt.set(e,new Map);},Mt=(e,t,r,n)=>{let s=d[e];if(!s)return {ok:true};let o=Re(r);if(o.length===0)return {ok:true};let a=J(n),u=N(),l=Ve(u),p=jn(u,e),g=o.join(Nn),f=l.get(e);f||(f={children:new Map},l.set(e,f));let c=f;for(let m of o){let v=c.children.get(m);v||(v={children:new Map},c.children.set(m,v)),c=v;}let y=c.verdicts?.get(a);if(y){let m=`${g}|${a}`;return qr(p,m,{node:c,type:a}),y}let S=s.options?.pathCreate===true,i=t,h={ok:true};for(let m=0;m<o.length;m++){let v=o[m],C=m===o.length-1;if(i==null){let b=`Path "${o.join(".")}" is invalid for "${e}" - "${o.slice(0,m).join(".")||"root"}" is ${i===null?"null":"undefined"}.`;O(b),h={ok:false,reason:b};break}if(typeof i!="object"){let b=`Path "${o.join(".")}" is invalid for "${e}" - "${o.slice(0,m).join(".")||"root"}" is not an object.`;O(b),h={ok:false,reason:b};break}if(Array.isArray(i)){let b=Number(v);if(!Number.isInteger(b)||b<0){let I=`Path "${o.join(".")}" targets non-numeric index "${v}" on an array in "${e}".`;O(I),h={ok:false,reason:I};break}let A=i;if(b>=A.length){let I=`Path "${o.join(".")}" is invalid for "${e}" - index ${b} is out of bounds (length ${A.length}).`;O(I),h={ok:false,reason:I};break}if(C){let I=A[b];if(I!=null){let jt=J(I);if(jt!==a){let $t=`Type mismatch setting "${o.join(".")}" on "${e}": expected ${jt}, received ${a}.`;O($t),h={ok:false,reason:$t};break}}h={ok:true};break}i=A[b];continue}if(!Object.prototype.hasOwnProperty.call(i,v)){if(S&&C){h={ok:true};break}let b=`Path "${o.join(".")}" is invalid for "${e}" - unknown key "${v}" at "${o.slice(0,m).join(".")||"root"}".`;O(b),h={ok:false,reason:b};break}if(C){let b=i[v];if(b!=null){let A=J(b);if(A!==a){let I=`Type mismatch setting "${o.join(".")}" on "${e}": expected ${A}, received ${a}.`;O(I),h={ok:false,reason:I};break}}h={ok:true};break}i=i[v];}c.verdicts||(c.verdicts=new Map);let x=c.verdicts.has(a);if(c.verdicts.set(a,h),!x){let m=`${g}|${a}`;qr(p,m,{node:c,type:a});}return h},ue=(e,t,r,n)=>{try{return n?.reuseInput&&rt(t)?{ok:!0,value:t}:{ok:!0,value:ee(t)}}catch(s){let o=`Sanitize failed for "${e}": ${s?.message??s}`;return d[e]?.options?.onError?.(o),r?.(o),w(o),{ok:false}}},_n=(e,t)=>{let r=new Set,n=d[e]?.options?.onError;return typeof n=="function"&&r.add(n),typeof t=="function"&&r.add(t),r},Ye=(e,t,r,n)=>{if(!r)return {ok:true,value:t};let s=_n(e,n),o=(u,l)=>{s.forEach(p=>p(u)),l==="critical"?O(u):w(u);};if(typeof r=="function")try{let u=r(t);return u===!1?(o(`Validation blocked update for "${e}"`,"warn"),{ok:!1}):{ok:!0,value:u===!0?t:u}}catch(u){return o(`Validation for "${e}" failed: ${u?.message??u}`,"critical"),{ok:false}}let a=tt(r,t);return a.ok?{ok:true,value:a.data??t}:(o(`Validation failed for "${e}": ${a.error}`,"critical"),{ok:false})},Te=(e,t,r,n,s)=>{let o=ue(e,t,n,s);if(!o.ok)return {ok:false};let a=Ye(e,o.value,r,n);return a.ok?{ok:true,value:a.value}:{ok:false}},z=e=>{let t=N();Ve(t).delete(e),Ct(t).delete(e);},Ft=()=>{let e=N();Ve(e).clear(),Ct(e).clear();};Nr(z);var Xe=e=>{if((k()?se(e):{has:false}).has||D[e]!==void 0)return  true;let r=ie[e];if(!r)return  true;try{let n=r(),s=ue(e,n,d[e]?.options?.onError);if(!s.ok)return !1;let o=d[e]?.options?.validate,a=Te(e,s.value,o,d[e]?.options?.onError);if(!a.ok)return !1;if(k()){let u=a.value;Ae(e,u),Ee(()=>{_(e,u),q[e]=P(u),delete ie[e],z(e);});}else _(e,a.value),q[e]=P(a.value),delete ie[e],z(e);return !0}catch(n){return Y(e,`Lazy initializer for "${e}" failed: ${n?.message??n}`),false}};var Ur=new WeakMap,Gr=e=>{let t=Ur.get(e);return t||(t=new Map,Ur.set(e,t)),t},Ne=()=>{Gr(N()).clear();},Et=e=>{let t=N(),r=Gr(t),n=r.get(e);if(n)return n;let s=d[e];if(!s)return w(`Internal feature context requested for "${e}" after metadata was cleared.`),null;let o={name:e,options:s.options,getMeta:()=>d[e],getStoreValue:()=>D[e],getAllStores:()=>D,getInitialState:()=>q[e],hasStore:()=>G(e),setStoreValue:a=>{_(e,a);},applyFeatureState:(a,u)=>{mt(e,a,u),z(e);},notify:()=>{},reportStoreError:a=>{Y(e,a);},warn:w,log:$,hashState:ke,deepClone:P,sanitize:ee,validate:a=>Ye(e,a,d[e]?.options?.validate),isDev:R};return r.set(e,o),o},At=(e,t)=>{let r=Et(e);r&&(r.notify=()=>t(e),L.forEach(n=>{n.onStoreCreate?.(r);}));},he=(e,t,r,n,s)=>{let o=Et(e);if(!o)return;o.notify=()=>s(e);let a=Object.assign(Object.create(o),{action:t,prev:r,next:n});L.forEach(u=>{u.onStoreWrite?.(a);});};var Dt=(e,t)=>mr({name:e,payload:t,middlewares:(()=>{let r=d[e]?.options?.middleware||[],n=M().middleware||[];return r.length===0?n:n.length===0?r:[...r,...n]})(),reportIssue:(r,n)=>{ce(e,r,n);},warn:w}),le=(e,t,r,n)=>Be({name:e,label:t,fn:r,args:n,reportIssue:(s,o)=>{ce(e,s,o);}}),Ot=(e,t)=>{let r={...t};return r.persist&&!ze("persist")&&(r.explicitPersist&&Pe(e,"persist",r.onError),r.persist=null),r.sync&&!ze("sync")&&(r.explicitSync&&Pe(e,"sync",r.onError),r.sync=false),ze("devtools")||(r.explicitDevtools&&Pe(e,"devtools",r.onError),r.devtools=false,r.historyLimit=0,r.redactor=void 0),r};var Pt=e=>{let{scope:t,registry:r}=Ir(e);Tr(t,r),Kr(r),Ne(),Oe(),yt();};var Wn=new Set,zn=new Set;var Yr=()=>{Wn.clear();},Xr=()=>{zn.clear();};var Hn=32,Jr=new Set,Bn=(e,t)=>{R()&&(t<Hn||Jr.has(e)||(Jr.add(e),w(`setStore("${e}", mutator) took ${t}ms. Mutator writes clone the entire store; consider path writes or smaller stores for hot paths.`)));},Vt=(e,t,r={})=>{if(k()){let i=`createStore("${String(e)}") cannot be called inside setStoreBatch. Move createStore outside the batch to preserve transaction semantics.`;me(i,r.onError),V(i);return}if(!nt(e)){me(`createStore("${String(e)}") is not a valid store name.`,r.onError);return}if(!(r.lazy===true&&typeof t=="function")&&!xe(t)){me(`createStore("${e}") received invalid initial data.`,r.onError);return}t===void 0&&R()&&w(`createStore("${e}") received an undefined initial value. This can be indistinguishable from a missing store in some consumers; consider null or an explicit shape if that is intentional.`),ar(r).forEach(i=>{w(i);});let s=Ot(e,ir(r,e));if(s.scope==="temp"&&r.persist){let i=`Store "${e}" has scope: "temp" but persist is enabled. Temp stores are intended to be ephemeral.`;s.onError?.(i),R()||K(i),j(i);}let o=typeof window>"u",a=typeof process<"u"?process.env?.NODE_ENV:void 0,u=o&&a==="production",l=s.allowSSRGlobalStore??false;if(u&&!l){let i=`createStore("${e}") is blocked on the server in production to prevent cross-request memory leaks.
+Call createStoreForRequest(...) inside each request scope or pass { scope: "global" } to opt in.`;me(i,r.onError);return}if(G(e)){let i=`Store "${e}" already exists. Call setStore("${e}", data) to update instead.`;return ce(e,i),{name:e}}o&&!l&&!wt(e)&&R()&&(vt(e),w(`createStore("${e}") called in a server environment. Use createStoreForRequest(...) per request to avoid cross-request leaks or pass { allowSSRGlobalStore: true } if you really want a global store on the server.`));let p=ue(e,t,s.onError);if(!p.ok)return;let g=p.value,f=s.lazy===true&&typeof t=="function",c=(Z[e]?.size??0)>0;if(f)D[e]=void 0,ie[e]=t;else {let i=Te(e,g,s.validate,s.onError);if(!i.ok)return;_(e,i.value),q[e]=P(i.value);}let y=Date.now(),S=new Date(y).toISOString();return d[e]={createdAt:S,updatedAt:S,updatedAtMs:y,updateCount:0,version:s.version,metrics:{notifyCount:0,totalNotifyMs:0,lastNotifyMs:0},options:s},z(e),At(e,B),le(e,"onCreate",d[e].options.onCreate,[g]),c&&B(e),$(`Store "${e}" created -> ${JSON.stringify(g)}`),{name:e}};function je(e,t,r){let n=Ge(e);if(!Xe(n))return {ok:false,reason:"validate"};if(!G(n)){let c=`setStore("${n}") called before createStore(). Create the store first or pass a valid StoreDefinition.`;return Y(n,c),k()&&V(c),{ok:false,reason:"not-found"}}let s,o=k()?se(n):{has:false,value:void 0},a=o.has?o.value:qe(n),u=typeof t=="function"&&r===void 0;if(u){let c=R()?Date.now():0;try{let y=M().mutatorProduce,S=!1,i,h=m=>{let v=t(m);return v!==void 0&&(S=!0,i=v),v},x=y?y(a,h):(()=>{let m=P(a);return h(m),m})();if(S&&M().strictMutatorReturns){let m=`setStore("${n}", mutator) returned a value. Strict mutator mode forbids return values; mutate the draft instead.`;return Y(n,m),k()&&V(m),{ok:!1,reason:"validate"}}S&&R()&&!M().strictMutatorReturns&&w(`setStore("${n}", mutator) returned a value. Return values replace the entire store; return void to apply draft mutations instead.`),s=S&&!M().strictMutatorReturns?i:x;}catch(y){return Y(n,`Mutator for "${n}" failed: ${y?.message??y}`),k()&&V(y),{ok:false,reason:"validate"}}finally{c&&Bn(n,Date.now()-c);}}else if(typeof t=="object"&&!Array.isArray(t)&&r===void 0){if(!xe(t))return k()&&V(`setStore("${n}") received invalid data`),{ok:false,reason:"invalid-args"};if(typeof a!="object"||a===null||Array.isArray(a))return j(`setStore("${n}", data) only merges into object stores.
+Use setStore("${n}", "path", value) or recreate the store with an object shape.`),k()&&V(`setStore("${n}") attempted object merge on non-object store`),{ok:false,reason:"validate"};let c=ue(n,t);if(!c.ok)return k()&&V(`setStore("${n}") failed sanitize`),{ok:false,reason:"validate"};s={...a,...c.value};}else if(typeof t=="string"||Array.isArray(t)){if(!at(t))return k()&&V(`setStore("${n}") received invalid path`),{ok:false,reason:"invalid-args"};let c=ue(n,r);if(!c.ok)return k()&&V(`setStore("${n}") failed sanitize`),{ok:false,reason:"validate"};let y=c.value,S=Mt(n,a,t,y);if(!S.ok)return d[n]?.options?.onError?.(S.reason??`Invalid path for "${n}".`),k()&&V(S.reason),{ok:false,reason:"path"};s=it(a,t,y);}else {let c=`setStore("${n}") - invalid arguments.
+Usage:
+  setStore("${n}", "field", value)
+  setStore("${n}", "nested.field", value)
+  setStore("${n}", { field: value })
+  setStore(storeDef, draft => { draft.field = value })`;return j(c),d[n]?.options?.onError?.(c),k()&&V(c),{ok:false,reason:"invalid-args"}}if(!xe(s))return k()&&V(`setStore("${n}") produced invalid data`),{ok:false,reason:"validate"};let l=d[n]?.options?.validate,p=Dt(n,{action:"set",prev:a,next:s,path:t});if(p===He)return k()&&V(`setStore("${n}") aborted by middleware`),{ok:false,reason:"middleware"};let f=Te(n,p,l,void 0,u&&p===s?{reuseInput:true}:void 0);if(!f.ok)return k()&&V(`setStore("${n}") failed validation`),{ok:false,reason:"validate"};if(k()){let c=f.value,y=a;Ae(n,c),Ee(()=>{_(n,c),z(n);let S=Date.now();d[n].updatedAt=new Date(S).toISOString(),d[n].updatedAtMs=S,d[n].updateCount++,he(n,"set",y,c,B),le(n,"onSet",d[n].options.onSet,[y,c]),B(n),$(`Store "${n}" updated`);});}else {_(n,f.value),z(n);let c=Date.now();d[n].updatedAt=new Date(c).toISOString(),d[n].updatedAtMs=c,d[n].updateCount++,he(n,"set",a,f.value,B),le(n,"onSet",d[n].options.onSet,[a,f.value]),B(n);}return k()||$(`Store "${n}" updated`),{ok:true}}function Tt(e){let t=Ge(e);if(!xt(t))return {ok:false,reason:"not-found"};if(!Xe(t))return {ok:false,reason:"validate"};if(!q[t]){let a=`resetStore("${t}") has no initial state to reset to. If this is a lazy store, ensure it has been initialized before calling resetStore.`;return ce(t,a),k()&&V(a),{ok:false,reason:"not-found"}}let r=k()?se(t):{has:false,value:void 0},n=r.has?r.value:D[t],s=P(q[t]);if(k())return Ae(t,s),Ee(()=>{_(t,s),z(t);let a=Date.now();d[t].updatedAt=new Date(a).toISOString(),d[t].updatedAtMs=a,d[t].updateCount++,he(t,"reset",n,s,B),le(t,"onReset",d[t].options.onReset,[n,s]),B(t),$(`Store "${t}" reset to initial state/value`);}),{ok:true};_(t,s),z(t);let o=Date.now();return d[t].updatedAt=new Date(o).toISOString(),d[t].updatedAtMs=o,d[t].updateCount++,he(t,"reset",n,s,B),le(t,"onReset",d[t].options.onReset,[n,s]),B(t),$(`Store "${t}" reset to initial state/value`),{ok:true}}var Qr=()=>{bt(),ht(),or(),Fr(),Ft(),Oe(),Yr(),Xr(),It(),Ne(),dr(),Pt(U);};var T=()=>N().async,X=e=>new Proxy(Object.create(null),{get:(t,r)=>e()[r],set:(t,r,n)=>(e()[r]=n,true),deleteProperty:(t,r)=>(delete e()[r],true),has:(t,r)=>r in e(),ownKeys:()=>Reflect.ownKeys(e()),getOwnPropertyDescriptor:(t,r)=>{let n=Object.getOwnPropertyDescriptor(e(),r);if(n)return {...n,configurable:true}}}),be=e=>new Proxy({},{get:(t,r)=>{let n=e(),s=n[r];return typeof s=="function"?s.bind(n):s},set:(t,r,n)=>(e()[r]=n,true),has:(t,r)=>r in e(),ownKeys:()=>Reflect.ownKeys(e()),getOwnPropertyDescriptor:(t,r)=>{let n=Object.getOwnPropertyDescriptor(e(),r);if(n)return {...n,configurable:true}}});X(()=>T().fetchRegistry);X(()=>T().inflight);X(()=>T().requestVersion);X(()=>T().cacheMeta);X(()=>T().rateWindowStart);X(()=>T().rateCount);be(()=>T().ratePruneState);X(()=>T().cleanupSubs);X(()=>T().storeCleanupFns);X(()=>T().revalidateHandlers);be(()=>T().noSignalWarned);be(()=>T().shapeWarned);be(()=>T().autoCreateWarned);be(()=>T().revalidateKeys);be(()=>T().asyncMetrics);var Zr=()=>{Ie(T());};var en=[];var Nt=()=>{Ln(),Zr();},Ln=()=>{en.forEach(e=>e()),en.length=0;};var Ta=(e="mock",t={})=>{let r=gt(e);return Vt(e,t),{set:n=>typeof n=="function"?je(r,n):je(r,n),reset:()=>Tt(r),use:()=>r}},Na=(e,t)=>{let r=Date.now;Date.now=()=>e;try{return t()}finally{Date.now=r;}},ja=()=>{Qr(),Nt();},$a=(e,t=1e3,r=n=>({value:n}))=>{let n=typeof performance<"u"&&performance.now?performance.now():Date.now();for(let a=0;a<t;a++)je(e,r(a));let o=(typeof performance<"u"&&performance.now?performance.now():Date.now())-n;return {iterations:t,totalMs:o,avgMs:o/t}};export{$a as benchmarkStoreSet,Ta as createMockStore,ja as resetAllStoresForTest,Na as withMockedTime};

package/dist/types/adapters/options.d.ts

@@ -0,0 +1,247 @@
+export type StoreValue = unknown;
+export interface PersistDriver {
+    getItem?: (k: string) => string | null | Promise<string | null>;
+    setItem?: (k: string, v: string) => void | Promise<void>;
+    removeItem?: (k: string) => void | Promise<void>;
+    [key: string]: unknown;
+}
+export type StoreScope = "request" | "global" | "temp";
+export type SnapshotMode = "deep" | "shallow" | "ref";
+export type ValidateFn<State = StoreValue> = (next: State) => boolean | State;
+export type SchemaValidateOption = {
+    safeParse: (value: unknown) => {
+        success: true;
+        data: unknown;
+    } | {
+        success: false;
+        error?: unknown;
+    };
+} | {
+    parse: (value: unknown) => unknown;
+} | {
+    validateSync: (value: unknown) => unknown;
+} | {
+    isValidSync: (value: unknown) => boolean;
+} | {
+    validate: (value: unknown) => unknown;
+};
+export type ValidateOption<State = StoreValue> = ValidateFn<State> | SchemaValidateOption;
+export interface PersistOptions<State = StoreValue> {
+    driver?: PersistDriver;
+    storage?: PersistDriver;
+    key?: string;
+    serialize?: (v: unknown) => string;
+    deserialize?: (v: string) => unknown;
+    /**
+     * Optional encryption hook for persisted payloads.
+     *
+     * Default is identity (no encryption). Data is stored in plaintext.
+     */
+    encrypt?: (v: string) => string;
+    /**
+     * Optional async encryption hook for persisted payloads.
+     *
+     * When provided, persistence will encrypt in the background and hydrate asynchronously.
+     */
+    encryptAsync?: (v: string) => Promise<string>;
+    /**
+     * Optional decryption hook for persisted payloads.
+     *
+     * Default is identity (no encryption). Data is stored in plaintext.
+     */
+    decrypt?: (v: string) => string;
+    /**
+     * Optional async decryption hook for persisted payloads.
+     *
+     * When provided, persistence will hydrate asynchronously after store creation.
+     */
+    decryptAsync?: (v: string) => Promise<string>;
+    /**
+     * Explicitly allow plaintext persistence when encrypt/decrypt are identity.
+     *
+     * In production builds, plaintext persistence is blocked unless this is true.
+     */
+    allowPlaintext?: boolean;
+    /**
+     * Marks this store's persisted data as sensitive (secrets/PII).
+     *
+     * When `true`, stroid throws at store creation time unless a non-identity
+     * `encrypt` hook is provided.
+     */
+    sensitiveData?: boolean;
+    /**
+     * Integrity check mode for persisted payloads.
+     * - "hash" (default): store and validate a checksum.
+     * - "none": skip checksum generation/validation.
+     * - "sha256": store a SHA-256 hash for stronger tamper detection (may be async in browsers).
+     */
+    checksum?: "hash" | "none" | "sha256";
+    version?: number;
+    migrations?: Record<number, (state: State) => State>;
+    onMigrationFail?: "reset" | "keep" | ((state: unknown) => unknown);
+    onStorageCleared?: (info: {
+        name: string;
+        key: string;
+        reason: "clear" | "remove" | "missing";
+    }) => void;
+}
+export interface PersistConfig {
+    driver: PersistDriver;
+    key: string;
+    serialize: (v: unknown) => string;
+    deserialize: (v: string) => unknown;
+    encrypt: (v: string) => string;
+    decrypt: (v: string) => string;
+    encryptAsync?: (v: string) => Promise<string>;
+    decryptAsync?: (v: string) => Promise<string>;
+    allowPlaintext?: boolean;
+    sensitiveData?: boolean;
+    checksum: "hash" | "none" | "sha256";
+    onMigrationFail?: "reset" | "keep" | ((state: unknown) => unknown);
+    onStorageCleared?: (info: {
+        name: string;
+        key: string;
+        reason: "clear" | "remove" | "missing";
+    }) => void;
+}
+export interface MiddlewareCtx {
+    action: string;
+    name: string;
+    prev: StoreValue;
+    next: StoreValue;
+    path: unknown;
+}
+export interface SyncOptions {
+    channel?: string;
+    maxPayloadBytes?: number;
+    /**
+     * Optional shared token for lightweight cross-tab authentication.
+     * When set, incoming sync messages without a matching token are rejected.
+     */
+    authToken?: string;
+    conflictResolver?: (args: {
+        local: StoreValue;
+        incoming: StoreValue;
+        localUpdated: number;
+        incomingUpdated: number;
+    }) => StoreValue | void;
+    /**
+     * Optional checksum mode for sync payloads.
+     * - "hash" (default): include a checksum of the payload.
+     * - "none": skip checksum generation.
+     */
+    checksum?: "hash" | "none";
+    /**
+     * Optional signer for sync payloads. The returned value is attached to the message as `auth`.
+     */
+    sign?: (payload: SyncMessage) => unknown;
+    /**
+     * Optional verifier for incoming sync payloads.
+     * Return true to accept the message, false to reject it.
+     */
+    verify?: (payload: SyncMessage) => boolean;
+    /**
+     * Optional resolver for updatedAt timestamps when conflicts are resolved.
+     */
+    resolveUpdatedAt?: (args: {
+        localUpdated: number;
+        incomingUpdated: number | undefined;
+        now: number;
+    }) => number;
+}
+export type SyncMessage = {
+    v: number;
+    protocol: number;
+    type: "sync-request" | "sync-state";
+    name: string;
+    clock: number;
+    source: string;
+    updatedAt?: number;
+    data?: StoreValue;
+    checksum?: number | null;
+    auth?: unknown;
+    token?: string;
+    requestedAt?: number;
+};
+export interface DevtoolsOptions<State = StoreValue> {
+    enabled?: boolean;
+    historyLimit?: number;
+    redactor?: (state: State) => State;
+}
+export interface LifecycleOptions<State = StoreValue> {
+    middleware?: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
+    onSet?: (prev: State, next: State) => void;
+    onReset?: (prev: State, next: State) => void;
+    onDelete?: (prev: State) => void;
+    onCreate?: (initial: State) => void;
+}
+export interface StoreOptions<State = StoreValue> {
+    scope?: StoreScope;
+    lazy?: boolean;
+    /**
+     * Allow `setStore(name, path, value)` to create missing **leaf** keys on object nodes.
+     *
+     * Default: `false` (strict path writes).
+     *
+     * Notes:
+     * - Does not expand arrays (out-of-bounds indices are still rejected).
+     * - Does not create missing intermediate objects for deep paths; define the shape up-front.
+     */
+    pathCreate?: boolean;
+    validate?: ValidateOption<State>;
+    persist?: boolean | string | PersistOptions<State>;
+    devtools?: boolean | DevtoolsOptions<State>;
+    lifecycle?: LifecycleOptions<State>;
+    middleware?: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
+    onSet?: (prev: State, next: State) => void;
+    onReset?: (prev: State, next: State) => void;
+    onDelete?: (prev: State) => void;
+    onCreate?: (initial: State) => void;
+    onError?: (err: string) => void;
+    /** @deprecated use validate instead */
+    validator?: (next: State) => boolean;
+    /** @deprecated use validate instead */
+    schema?: unknown;
+    migrations?: Record<number, (state: State) => State>;
+    version?: number;
+    redactor?: (state: State) => State;
+    historyLimit?: number;
+    allowSSRGlobalStore?: boolean;
+    sync?: boolean | SyncOptions;
+    /**
+     * Snapshot cloning strategy used by subscriptions and selector snapshots.
+     *
+     * - "deep" (default): deep clone and dev-freeze snapshot values.
+     * - "shallow": shallow clone (top-level) only; nested references are shared.
+     * - "ref": return the live store reference (no cloning).
+     */
+    snapshot?: SnapshotMode;
+}
+export interface NormalizedOptions {
+    scope: StoreScope;
+    lazy: boolean;
+    pathCreate: boolean;
+    persist: PersistConfig | null;
+    devtools: boolean;
+    middleware: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
+    onSet?: (prev: StoreValue, next: StoreValue) => void;
+    onReset?: (prev: StoreValue, next: StoreValue) => void;
+    onDelete?: (prev: StoreValue) => void;
+    onCreate?: (initial: StoreValue) => void;
+    onError?: (err: string) => void;
+    validate?: ValidateOption;
+    migrations: Record<number, (state: any) => any>;
+    version: number;
+    redactor?: (state: StoreValue) => StoreValue;
+    historyLimit: number;
+    allowSSRGlobalStore?: boolean;
+    sync?: boolean | SyncOptions;
+    snapshot: SnapshotMode;
+    explicitPersist: boolean;
+    explicitSync: boolean;
+    explicitDevtools: boolean;
+}
+export declare const resetLegacyOptionDeprecationWarningsForTests: () => void;
+export declare const normalizePersistOptions: <State>(persist: StoreOptions<State>["persist"], name: string) => PersistConfig | null;
+export declare const collectLegacyOptionDeprecationWarnings: <State>(option: StoreOptions<State>) => string[];
+export declare const normalizeStoreOptions: <State>(option: StoreOptions<State> | undefined, name: string) => NormalizedOptions;

package/dist/types/async/clone.d.ts

@@ -0,0 +1,2 @@
+import type { FetchOptions } from "../async-cache.js";
+export declare const cloneAsyncResult: (value: unknown, mode: FetchOptions["cloneResult"]) => unknown;

package/dist/types/async/errors.d.ts

@@ -0,0 +1,3 @@
+export declare const runAsyncHook: (name: string, label: "onSuccess" | "onError", fn: ((value: any) => void) | undefined, value: unknown) => void;
+export declare const reportAsyncUsageError: (name: string, message: string, onError?: (message: string) => void) => null;
+export declare const throwAsyncUsageError: (name: string, message: string, onError?: (message: string) => void) => never;

package/dist/types/async/inflight.d.ts

@@ -0,0 +1,13 @@
+import type { FetchOptions } from "../async-cache.js";
+export type InflightEntry = {
+    promise: Promise<unknown>;
+    raw: Promise<unknown>;
+    transform?: FetchOptions["transform"];
+};
+export declare const isCurrentRequest: (cacheSlot: string, version: number) => boolean;
+export declare const reserveRequestVersion: (cacheSlot: string) => number;
+export declare const clearRequestVersion: (cacheSlot: string, version: number) => void;
+export declare const setInflightEntry: (cacheSlot: string, entry: InflightEntry) => void;
+export declare const clearInflightEntry: (cacheSlot: string) => void;
+export declare const hasInflightEntry: (cacheSlot: string) => boolean;
+export declare const tryDedupeRequest: (name: string, cacheSlot: string, transform: FetchOptions["transform"] | undefined, onError?: (message: string) => void) => Promise<unknown> | null | undefined;

package/dist/types/async/rate.d.ts

@@ -0,0 +1,5 @@
+export declare const RATE_WINDOW_MS = 1000;
+export declare const RATE_MAX = 100;
+export declare const pruneRateCounters: (nowTs: number) => void;
+export declare const scheduleRatePrune: (delayMs?: number) => void;
+export declare const registerRateHit: (cacheSlot: string, nowTs: number) => boolean;

package/dist/types/async/request.d.ts

@@ -0,0 +1,3 @@
+import type { FetchOptions } from "../async-cache.js";
+export declare const buildFetchOptions: (options: FetchOptions) => RequestInit;
+export declare const parseResponseBody: (response: Response, responseType: FetchOptions["responseType"]) => Promise<unknown>;

package/dist/types/async-cache.d.ts

@@ -0,0 +1,57 @@
+import type { FetchOptions } from "./async-registry.js";
+export type { FetchOptions, AsyncStateSnapshot, AsyncStateAdapter } from "./async-registry.js";
+export type FetchInput = string | Promise<unknown> | (() => string | Promise<unknown>);
+export declare const MAX_CACHE_SLOTS_PER_STORE = 100;
+export declare const MAX_INFLIGHT_SLOTS_PER_STORE = 100;
+export declare const MAX_WARNED_ENTRIES = 1000;
+export declare const getActiveAsyncRegistry: () => import("./async-registry.js").AsyncRegistry;
+export declare const fetchRegistry: Record<string, {
+    kind: "url";
+    url: string;
+    options: FetchOptions;
+} | {
+    kind: "factory";
+    factory: () => string | Promise<unknown>;
+    options: FetchOptions;
+}>;
+export declare const inflight: Partial<Record<string, {
+    promise: Promise<unknown>;
+    raw: Promise<unknown>;
+    transform?: FetchOptions["transform"];
+}>>;
+export declare const requestVersion: Record<string, number>;
+export declare const cacheMeta: Record<string, {
+    timestamp: number;
+    expiresAt: number | null;
+    data: unknown;
+}>;
+export declare const rateWindowStart: Record<string, number>;
+export declare const rateCount: Record<string, number>;
+export declare const ratePruneState: {
+    lastAt: number;
+};
+export declare const cleanupSubs: Record<string, () => void>;
+export declare const storeCleanupFns: Record<string, Set<() => void>>;
+export declare const revalidateHandlers: Record<string, () => void>;
+export declare const noSignalWarned: Set<string>;
+export declare const shapeWarned: Set<string>;
+export declare const autoCreateWarned: Set<string>;
+export declare const revalidateKeys: Set<string>;
+export declare const asyncMetrics: {
+    cacheHits: number;
+    cacheMisses: number;
+    dedupes: number;
+    requests: number;
+    failures: number;
+    avgMs: number;
+    lastMs: number;
+};
+export declare const markWarned: (set: Set<string>, key: string) => void;
+export declare const resetAsyncState: () => void;
+export declare const shouldUseCache: (cacheSlot: string, ttl?: number) => boolean;
+export declare const clearAsyncMeta: (name: string) => void;
+export declare const pruneAsyncCache: (name: string) => void;
+export declare const countInflightSlots: (name: string) => number;
+export declare const registerStoreCleanup: (name: string, fn: () => void) => void;
+export declare const unregisterStoreCleanup: (name: string, fn: () => void) => void;
+export declare const ensureCleanupSubscription: (name: string) => void;

package/dist/types/async-fetch.d.ts

@@ -0,0 +1,37 @@
+import { type StoreDefinition, type StoreKey, type StoreName } from "./store-lifecycle.js";
+import { type FetchInput, type FetchOptions } from "./async-cache.js";
+export declare function fetchStore<Name extends string, State>(name: StoreDefinition<Name, State>, urlOrRequest: FetchInput, options?: FetchOptions): Promise<unknown>;
+export declare function fetchStore<Name extends string, State>(name: StoreKey<Name, State>, urlOrRequest: FetchInput, options?: FetchOptions): Promise<unknown>;
+export declare function fetchStore<Name extends StoreName>(name: Name, urlOrRequest: FetchInput, options?: FetchOptions): Promise<unknown>;
+export declare function refetchStore<Name extends string, State>(name: StoreDefinition<Name, State>): Promise<unknown>;
+export declare function refetchStore<Name extends string, State>(name: StoreKey<Name, State>): Promise<unknown>;
+export declare function refetchStore<Name extends StoreName>(name: Name): Promise<unknown>;
+export declare function enableRevalidateOnFocus<Name extends string, State>(name: StoreDefinition<Name, State>, overrides?: Partial<FetchOptions> & {
+    debounceMs?: number;
+    maxConcurrent?: number;
+    staggerMs?: number;
+    priority?: "high" | "normal";
+}): (() => void);
+export declare function enableRevalidateOnFocus<Name extends string, State>(name: StoreKey<Name, State>, overrides?: Partial<FetchOptions> & {
+    debounceMs?: number;
+    maxConcurrent?: number;
+    staggerMs?: number;
+    priority?: "high" | "normal";
+}): (() => void);
+export declare function enableRevalidateOnFocus<Name extends StoreName>(name?: Name | "*", overrides?: Partial<FetchOptions> & {
+    debounceMs?: number;
+    maxConcurrent?: number;
+    staggerMs?: number;
+    priority?: "high" | "normal";
+}): (() => void);
+export declare const getAsyncMetrics: () => {
+    cacheHits: number;
+    cacheMisses: number;
+    dedupes: number;
+    requests: number;
+    failures: number;
+    avgMs: number;
+    lastMs: number;
+};
+export declare const _resetAsyncStateForTests: () => void;
+export declare const cleanupAllRevalidateHandlers: () => void;

package/dist/types/async-registry.d.ts

@@ -0,0 +1,96 @@
+export type AsyncStateSnapshot = {
+    data?: unknown;
+    loading: boolean;
+    error: string | null;
+    status: "idle" | "loading" | "success" | "error" | "aborted";
+    cached?: boolean;
+    revalidating?: boolean;
+};
+export type AsyncStateAdapter = (ctx: {
+    name: string;
+    prev: unknown;
+    next: AsyncStateSnapshot;
+    set: (value: unknown | ((draft: any) => void)) => void;
+}) => void;
+export interface FetchOptions {
+    transform?: (result: unknown) => unknown;
+    onSuccess?: (data: unknown) => void;
+    onError?: (message: string) => void;
+    /**
+     * Optional adapter to write async state into a custom store shape.
+     * When provided, default AsyncState writes are skipped.
+     */
+    stateAdapter?: AsyncStateAdapter;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    ttl?: number;
+    staleWhileRevalidate?: boolean;
+    dedupe?: boolean;
+    retry?: number;
+    retryDelay?: number;
+    retryBackoff?: number;
+    signal?: AbortSignal;
+    cacheKey?: string;
+    responseType?: "auto" | "json" | "text" | "arrayBuffer" | "blob" | "formData";
+    /**
+     * Auto-create the backing store if missing.
+     * Defaults to the global config setting (true by default).
+     */
+    autoCreate?: boolean;
+    /**
+     * Clone strategy for transformed results.
+     * - "none" (default): store by reference.
+     * - "shallow": shallow clone objects/arrays.
+     * - "deep": deep clone objects/arrays.
+     */
+    cloneResult?: "none" | "shallow" | "deep";
+}
+type InflightEntry = {
+    promise: Promise<unknown>;
+    raw: Promise<unknown>;
+    transform?: FetchOptions["transform"];
+};
+export type AsyncRegistry = {
+    fetchRegistry: Record<string, {
+        kind: "url";
+        url: string;
+        options: FetchOptions;
+    } | {
+        kind: "factory";
+        factory: () => string | Promise<unknown>;
+        options: FetchOptions;
+    }>;
+    inflight: Partial<Record<string, InflightEntry>>;
+    requestVersion: Record<string, number>;
+    cacheMeta: Record<string, {
+        timestamp: number;
+        expiresAt: number | null;
+        data: unknown;
+    }>;
+    rateWindowStart: Record<string, number>;
+    rateCount: Record<string, number>;
+    ratePruneState: {
+        lastAt: number;
+    };
+    ratePruneTimer: ReturnType<typeof setTimeout> | null;
+    noSignalWarned: Set<string>;
+    shapeWarned: Set<string>;
+    autoCreateWarned: Set<string>;
+    cleanupSubs: Record<string, () => void>;
+    storeCleanupFns: Record<string, Set<() => void>>;
+    revalidateKeys: Set<string>;
+    revalidateHandlers: Record<string, () => void>;
+    asyncMetrics: {
+        cacheHits: number;
+        cacheMisses: number;
+        dedupes: number;
+        requests: number;
+        failures: number;
+        avgMs: number;
+        lastMs: number;
+    };
+};
+export declare const createAsyncRegistry: () => AsyncRegistry;
+export declare const resetAsyncRegistry: (registry: AsyncRegistry) => void;
+export {};

package/dist/types/async-retry.d.ts

@@ -0,0 +1,10 @@
+export declare const MAX_RETRY_ATTEMPTS = 10;
+export declare const MIN_RETRY_DELAY_MS = 10;
+export declare const MAX_RETRY_DELAY_MS = 30000;
+export declare const MAX_RETRY_BACKOFF = 8;
+export declare const delay: (ms: number, signal?: AbortSignal) => Promise<void>;
+export declare const normalizeRetryOptions: (name: string, retry: number, retryDelay: number, retryBackoff: number) => {
+    retry: number;
+    retryDelay: number;
+    retryBackoff: number;
+};

package/dist/types/async.d.ts

@@ -0,0 +1,2 @@
+export type { FetchOptions, FetchInput, AsyncStateSnapshot, AsyncStateAdapter } from "./async-cache.js";
+export { fetchStore, refetchStore, enableRevalidateOnFocus, getAsyncMetrics, _resetAsyncStateForTests, } from "./async-fetch.js";