stroid 0.1.4-beta.0 → 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +427 -288
- package/README.md +1125 -118
- package/dist/async-internal.d.ts +30 -0
- package/dist/async.d.ts +7 -12
- package/dist/async.js +1 -33
- package/dist/chunk-4C666HHU.js +2 -0
- package/dist/chunk-4D6OA3DD.js +2 -0
- package/dist/chunk-6IBJ7CIK.js +14 -0
- package/dist/chunk-BWNLQKTY.js +2 -0
- package/dist/chunk-E33L4MII.js +2 -0
- package/dist/chunk-FSNVSMAV.js +2 -0
- package/dist/chunk-GZQGU64H.js +2 -0
- package/dist/chunk-LWUT37FW.js +13 -0
- package/dist/chunk-NFT6AZXY.js +2 -0
- package/dist/chunk-PHE2BCFG.js +2 -0
- package/dist/chunk-SF6EP56S.js +2 -0
- package/dist/chunk-WE3ZR6OG.js +2 -0
- package/dist/chunk-WXJ3IREA.js +2 -0
- package/dist/chunk-X2MKRN7O.js +14 -0
- package/dist/chunk-Y54SMROI.js +2 -0
- package/dist/chunk-YU5GMPCC.js +2 -0
- package/dist/computed.d.ts +6 -5
- package/dist/computed.js +1 -12
- package/dist/core-internal.d.ts +23 -0
- package/dist/core.d.ts +3 -2
- package/dist/core.js +1 -22
- package/dist/devtools-internal.d.ts +26 -0
- package/dist/devtools.d.ts +4 -25
- package/dist/devtools.js +1 -1
- package/dist/feature.d.ts +9 -2
- package/dist/feature.js +1 -1
- package/dist/fetch-4RH6MPY3.js +2 -0
- package/dist/graph-D28.d.ts +20 -0
- package/dist/helpers.d.ts +2 -1
- package/dist/helpers.js +1 -22
- package/dist/index-internal.d.ts +19 -19
- package/dist/index.d.cts +40 -22
- package/dist/index.d.ts +40 -22
- package/dist/index.js +1 -35
- package/dist/install.d.ts +16 -4
- package/dist/install.js +1 -1
- package/dist/metrics.d.ts +13 -0
- package/dist/persist.d.ts +3 -1
- package/dist/persist.js +1 -1
- package/dist/psr.d.ts +20 -11
- package/dist/psr.js +1 -18
- package/dist/query.d.ts +17 -0
- package/dist/query.js +2 -0
- package/dist/react/index.d.ts +10 -3
- package/dist/react/index.js +5 -36
- package/dist/registry.d.ts +23 -14
- package/dist/runtime-admin.js +1 -1
- package/dist/runtime-tools.d.ts +38 -65
- package/dist/runtime-tools.js +1 -3
- package/dist/selectors.d.ts +1 -1
- package/dist/selectors.js +1 -1
- package/dist/server/portable.d.ts +27 -0
- package/dist/server/portable.js +2 -0
- package/dist/server.d.ts +9 -19
- package/dist/server.js +1 -12
- package/dist/shared.d.ts +36 -0
- package/dist/store-registry.d.ts +5 -1
- package/dist/sync.d.ts +10 -1
- package/dist/sync.js +1 -1
- package/dist/testing.d.ts +1 -0
- package/dist/testing.js +1 -22
- package/dist/tsdoc-metadata.json +1 -1
- package/dist/types-internal-2.d.ts +168 -0
- package/dist/{computed-types.d.ts → types-internal-3.d.ts} +1 -1
- package/dist/{options.d.ts → types-internal.d.ts} +26 -10
- package/dist/types.d.ts +12 -2
- package/package.json +111 -44
- package/dist/computed-types.js +0 -2
package/dist/testing.js
CHANGED
|
@@ -1,23 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
Store data only - handle functions outside the store.`,Er=()=>`Map/Set detected. stroid converts these to plain objects.
|
|
3
|
-
Use arrays or plain objects for best results.`,Fr=()=>`Date object detected. stroid stores it as ISO string.
|
|
4
|
-
Use new Date(value) to convert back when reading.`,Ar=()=>"Date detected; stored as ISO string. Use new Date(value) when reading.",Pr=()=>"Map detected; converting to plain object.",Or=()=>"Set detected; converting to array.",Nr=(e,t,r)=>`Path depth of ${e} exceeded maximum of ${t}.
|
|
5
|
-
"${r.join(".")}"
|
|
6
|
-
This is a data design issue. Split into separate stores:
|
|
7
|
-
createStore("${r[0]}", ...) and createStore("${r[1]}", ...)`,Dr=(e,t)=>`Deep nesting detected (${e} levels): "${t.join(".")}"
|
|
8
|
-
Consider splitting into separate stores for better readability.`;var Vr=e=>`Store name must be a non-empty string. Got: ${JSON.stringify(e)}`,Ir=e=>`Store name "${e}" contains spaces.
|
|
9
|
-
Use camelCase or kebab-case: "userName" or "user-name"`,jr=e=>`Store name "${e}" is not allowed.
|
|
10
|
-
Reserved names: "__proto__", "constructor", "prototype".`,So=128,ho=(e,t)=>Math.abs(e.length-t.length)>2?false:Math.max(e.length,t.length)<=So,bo=(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},(o,s)=>s),n=new Array(e.length+1);for(let o=1;o<=t.length;o++){n[0]=o;for(let s=1;s<=e.length;s++)n[s]=t[o-1]===e[s-1]?r[s-1]:Math.min(r[s-1],n[s-1],r[s])+1;[r,n]=[n,r];}return r[e.length]},Pt=(e,t)=>{let r=t.find(n=>{let o=n.toLowerCase(),s=e.toLowerCase();return o.includes(s)||s.includes(o)||ho(o,s)&&bo(o,s)<=2});if(r){p(`Store "${e}" not found. Did you mean "${r}"?`);return}L(`Store "${e}" not found.
|
|
11
|
-
Available stores: [${t.join(", ")}]
|
|
12
|
-
Call createStore("${e}", data) first.`);};var Y=new Set(["__proto__","constructor","prototype"]),Nt=(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 o=r.error,s=o?.details?.[0]?.message||o?.message||r.message||e.errors;if(s)return {ok:!1,error:s};if(o)return {ok:!1,error:o}}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 ce=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,$r=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},Ce=e=>{let t=ce(e);return t==="function"?(L(Tr()),false):t==="map"||t==="set"?(p(Er()),true):(t==="date"&&p(Fr()),true)},Ot=(e,t)=>{let r=$r(e);if(r)throw new Error(`${r} values are not supported`);let n=ce(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 o=Object.keys(e);for(let s of o){let i=Number(s);if(!Number.isInteger(i))return false}for(let s=0;s<e.length;s+=1)if(s in e&&!Ot(e[s],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 o=Object.getOwnPropertyDescriptors(e);for(let[s,i]of Object.entries(o)){if(!i.enumerable||Y.has(s))return false;if("get"in i||"set"in i)throw new Error(`Accessor properties are not supported during sanitize ("${s}")`);if(!Ot(i.value,t))return false}return true}return true},Dt=e=>Ot(e,new WeakSet),_e=(e,t)=>{let r=$r(e);if(r)throw new Error(`${r} values are not supported`);let n=ce(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 M()&&p(Ar()),e.toISOString();if(n==="map"){if(t.has(e))throw new Error("Circular reference detected during sanitize");t.add(e),M()&&p(Pr());let o={};for(let[s,i]of e){if(typeof s!="string")throw new Error("Map keys must be strings to remain JSON-safe");o[String(s)]=_e(i,t);}return o}if(n==="set"){if(t.has(e))throw new Error("Circular reference detected during sanitize");return t.add(e),M()&&p(Or()),Array.from(e,o=>_e(o,t))}if(n==="object"){if(t.has(e))throw new Error("Circular reference detected during sanitize");t.add(e);let o={},s=Object.getOwnPropertyDescriptors(e);for(let[i,a]of Object.entries(s))if(a.enumerable&&!Y.has(i)){if("get"in a||"set"in a)throw new Error(`Accessor properties are not supported during sanitize ("${i}")`);o[i]=_e(a.value,t);}return o}if(n==="array"){if(t.has(e))throw new Error("Circular reference detected during sanitize");return t.add(e),e.map(o=>_e(o,t))}return e},ge=e=>_e(e,new WeakSet),Vt=e=>typeof e!="string"||e.trim()===""?(L(Vr(e)),false):Y.has(e)?(L(jr(e)),false):e.includes(" ")?(L(Ir(e)),false):true;var It=null,wo=()=>{if(It)return It;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 It=t,t},zr=e=>{let t=wo(),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},vo=2166136261,Ro=2654435761,xo=1e5,ue=(e,t)=>{let r=t>>>0;e.h1=Math.imul(e.h1^r,2246822507),e.h2=Math.imul(e.h2^r,3266489909);},ye=(e,t)=>{ue(e,t.length);for(let r=0;r<t.length;r++)ue(e,t.charCodeAt(r));},D=(e,t)=>{ye(e,t);},_r=(e,t)=>{if(Number.isNaN(t)){D(e,"NaN");return}if(!Number.isFinite(t)){D(e,t>0?"Infinity":"-Infinity");return}if(Object.is(t,-0)){D(e,"-0");return}let r=t|0;if(t===r){D(e,"int"),ue(e,r);return}D(e,"num"),ye(e,String(t));},ke=(e,t)=>{if(e.nodes++>xo){D(e,"[max]");return}if(t===null){D(e,"null");return}let r=typeof t;if(r==="string"){D(e,"string"),ye(e,t);return}if(r==="number"){D(e,"number"),_r(e,t);return}if(r==="boolean"){D(e,t?"true":"false");return}if(r==="undefined"){D(e,"undefined");return}if(r==="bigint"){D(e,"bigint"),ye(e,t.toString());return}if(r==="symbol"){D(e,"symbol");let u=t;ye(e,Symbol.keyFor(u)??u.description??String(u));return}if(r==="function"){D(e,"function"),ye(e,t.name||"anonymous");return}let n=t,o=e.seen.get(n);if(o!==void 0){D(e,"ref"),ue(e,o);return}let s=e.nextId++;if(e.seen.set(n,s),Array.isArray(n)){D(e,"array"),ue(e,n.length);for(let u=0;u<n.length;u++)Object.prototype.hasOwnProperty.call(n,u)?ke(e,n[u]):D(e,"hole");return}if(n instanceof Date){D(e,"date"),_r(e,n.getTime());return}if(n instanceof Map){D(e,"map"),ue(e,n.size),n.forEach((u,c)=>{ke(e,c),ke(e,u);});return}if(n instanceof Set){D(e,"set"),ue(e,n.size),n.forEach(u=>{ke(e,u);});return}D(e,"object");let i=Object.getOwnPropertyDescriptors(n),a=[];Object.entries(i).forEach(([u,c])=>{c?.enumerable&&(Y.has(u)||"get"in c||"set"in c||a.push([u,c]));}),ue(e,a.length);for(let[u,c]of a)ye(e,u),ke(e,c.value);},ze=e=>{if(typeof e=="string")return zr(JSON.stringify(e));let t={h1:vo,h2:Ro,seen:new WeakMap,nextId:1,nodes:0};ke(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 Co=typeof globalThis<"u"&&typeof globalThis.structuredClone=="function",jt=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,o])=>{o.enumerable&&(Y.has(n)||"get"in o||"set"in o||(t[n]=o.value));}),t},$t=e=>{if(typeof e=="function")return "function";if(typeof e=="symbol")return "symbol";if(e===null||typeof e!="object")return null;let t=[["WeakMap",globalThis.WeakMap],["WeakSet",globalThis.WeakSet],["WeakRef",globalThis.WeakRef],["Promise",globalThis.Promise],["ReadableStream",globalThis.ReadableStream],["WritableStream",globalThis.WritableStream],["TransformStream",globalThis.TransformStream],["EventTarget",globalThis.EventTarget]];for(let[n,o]of t)if(typeof o=="function"&&e instanceof o)return n;let r=globalThis.Node;return typeof r=="function"&&e instanceof r?"DOM Node":null},ko=e=>$t(e)===null,Mo=e=>{let t=$t(e);if(t)throw new Error(`deepClone failed: value is not structured-cloneable (${t}). Avoid storing this type in stroid state.`)},me=(e,t=new WeakMap)=>{if(Mo(e),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((s,i)=>{o.set(me(i,t),me(s,t));}),o}if(e instanceof Set){let o=new Set;return t.set(e,o),e.forEach(s=>{o.add(me(s,t));}),o}if(Array.isArray(e)){let o=[];return t.set(e,o),e.forEach((s,i)=>{o[i]=me(s,t);}),o}let r={};t.set(e,r);let n;try{n=Object.getOwnPropertyDescriptors(e);}catch(o){throw new Error(`deepClone failed to read object descriptors (possible Proxy or host object): ${o?.message??o}`)}return Object.entries(n).forEach(([o,s])=>{!s.enumerable||Y.has(o)||"get"in s||"set"in s||(r[o]=me(s.value,t));}),r},V=e=>{if(Co)try{return structuredClone(e)}catch(t){if(!ko(e)){let r=$t(e)??"unknown";throw new Error(`deepClone failed: value is not structured-cloneable (${r}). Avoid storing this type in stroid state.`)}return p(`deepClone fell back to manual clone after structuredClone failed: ${t?.message??t}`),me(e)}return me(e)},_t=(e,t)=>{if(Object.is(e,t))return true;if(!e||!t||typeof e!="object"||typeof t!="object")return false;let r=e,n=t,o=Object.keys(r),s=Object.keys(n);if(o.length!==s.length)return false;for(let i of o)if(!Object.prototype.hasOwnProperty.call(n,i)||!Object.is(r[i],n[i]))return false;return true};var Wr=10,To=5,Eo=e=>{let t=[],r="",n=false;for(let o of e){if(n){r+=o,n=false;continue}if(o==="\\"){n=true;continue}if(o==="."){t.push(r),r="";continue}r+=o;}return n&&(r+="\\"),t.push(r),t},Se=e=>Array.isArray(e)?[...e]:typeof e=="string"&&!e.includes(".")?[e]:typeof e=="string"?Eo(e):[String(e)],zt=e=>{let t=Se(e),r=t.length;return r>Wr?(L(Nr(r,Wr,t)),false):(r>To&&p(Dr(r,t)),true)};var Wt=(e,t,r)=>{let n=Se(t);if(n.length===0)return e;for(let s of n)if(Y.has(s))return z(`Blocked forbidden path segment "${String(s)}" in setStore path "${n.join(".")}".`),e;let o=(s,i)=>{let a=n[i],u=i===n.length-1;if(Array.isArray(s)){let c=Number(a);if(!Number.isInteger(c))return s;let l=[...s];return u?(l[c]=r,l):(l[c]=o(l[c],i+1),l)}if(s&&typeof s=="object"){if(Y.has(a))return z(`Blocked unsafe path segment "${String(a)}" while setting "${n.join(".")}".`),s;let c={...s};return u?(c[a]=r,c):(c[a]=o(c[a],i+1),c)}if(s==null&&!u){let c=Number.isInteger(Number(a)),l=c?[]:{};if(c){let h=l,w=Number(a);return h[w]=o(void 0,i+1),h}return l[a]=o(void 0,i+1),l}return u?r:s};return o(e,0)};var Lt=new Set,Fo=()=>{Lt.clear();};T("options.legacy-warnings",Fo,30);var tt=(()=>{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"}})(),Ht=e=>{try{return typeof window>"u"?tt:e==="session"||e==="sessionStorage"?window.sessionStorage??tt:window.localStorage??tt}catch{return tt}},We=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),Me=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),Lr=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}},Ao=typeof Symbol=="function"?Symbol.for("stroid.persist.defaultCrypto"):"__stroid_persist_defaultCrypto__",Hr=e=>{try{e[Ao]=!0;}catch{}return e},Po={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"},Oo=(e,t)=>{if(!e)return null;let r={key:`stroid_${t}`,serialize:JSON.stringify,deserialize:JSON.parse,encrypt:Hr(h=>h),decrypt:Hr(h=>h),allowPlaintext:false,sensitiveData:false,onMigrationFail:"reset",checksum:"hash"};if(e===true)return {driver:Ht("localStorage"),...r};if(typeof e=="string")return {driver:Ht(e),...r};let n=e.encrypt||r.encrypt,o=e.decrypt||r.decrypt,s=e.encryptAsync,i=e.decryptAsync,a=e.sensitiveData===true,u=e.allowPlaintext===true,c=typeof e.maxSize=="number"&&Number.isFinite(e.maxSize)&&e.maxSize>0?e.maxSize:void 0,l=e.checksum==="sha256"?"sha256":e.checksum==="none"?"none":"hash";if(s&&!i||!s&&i)throw new Error(`[stroid/persist] Store "${t}" must provide both encryptAsync and decryptAsync when using async crypto.`);if(a&&Lr(n)&&!s)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||Ht("localStorage"),key:e.key||r.key,serialize:e.serialize||r.serialize,deserialize:e.deserialize||r.deserialize,encrypt:n,decrypt:o,encryptAsync:s,decryptAsync:i,allowPlaintext:u,sensitiveData:a,maxSize:c,checksum:l,onMigrationFail:e.onMigrationFail||"reset",onStorageCleared:e.onStorageCleared}},Br=e=>{if(!We(e))return [];let t=[];return Object.entries(Po).forEach(([r,n])=>{Me(e,r)&&(Lt.has(r)||(Lt.add(r),t.push(`createStore option "${r}" is deprecated. Use "${n}" instead.`)));}),t},qr=(e={},t,r="deep")=>{let n=e.scope??"request",o=e.lazy===true,s=e.pathCreate===true,i=We(e.lifecycle)?e.lifecycle:void 0,a=We(e.persist)?e.persist:void 0,u=We(e.devtools)?e.devtools:void 0,c=e.validate??e.validator??e.schema,l=e.snapshot==="shallow"||e.snapshot==="ref"||e.snapshot==="deep"?e.snapshot:r==="shallow"||r==="ref"||r==="deep"?r:"deep",h=e.snapshotSafety==="warn"||e.snapshotSafety==="throw"||e.snapshotSafety==="auto-clone"?e.snapshotSafety:void 0,w=We(e.features)?{...e.features}:void 0,g=Me(e,"persist"),v=Me(e,"sync"),d=Me(e,"devtools")||Me(e,"historyLimit")||Me(e,"redactor"),m=n==="global"?true:e.allowSSRGlobalStore??false,{persist:S=false,devtools:R=false,onError:x,sync:k}=e;if(a?.sensitiveData===true){let A=a.encrypt,b=a.encryptAsync;if((!A||Lr(A))&&!b)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:n,lazy:o,pathCreate:s,persist:n==="temp"&&!g?null:Oo(S,t),devtools:n==="temp"&&!d?false:typeof R=="boolean"?R:u?.enabled??true,middleware:i?.middleware??e.middleware??[],onSet:i?.onSet??e.onSet,onReset:i?.onReset??e.onReset,onDelete:i?.onDelete??e.onDelete,onCreate:i?.onCreate??e.onCreate,onError:x,validate:c,migrations:a?.migrations??e.migrations??{},version:a?.version??e.version??1,redactor:n==="temp"&&!d?void 0:u?.redactor??e.redactor,historyLimit:n==="temp"&&!d?0:u?.historyLimit??e.historyLimit??50,sync:n==="temp"&&!v?false:k??false,features:w,allowSSRGlobalStore:m,snapshot:l,snapshotSafety:h,explicitPersist:g,explicitSync:v,explicitDevtools:d}};var rt=Symbol("stroid.middleware.abort"),Ur=({name:e,payload:t,middlewares:r,reportIssue:n,warn:o})=>{if(!Array.isArray(r)||r.length===0)return t.next;let s=new WeakSet,i=V(t.next);for(let a of r){if(typeof a!="function")continue;let u,c=i;try{u=a({action:t.action,name:e,prev:t.prev,next:c,path:t.path,correlationId:t.correlationId,traceContext:t.traceContext});}catch(l){let h=`Middleware for "${e}" failed: ${l?.message??l}`;return n(h,"dev"),rt}if(u&&typeof u.then=="function"){let l=`Middleware for "${e}" must be synchronous. Promise-returning middleware is not supported.`;return n(l,"dev"),rt}u===void 0?(M()&&!s.has(a)&&(s.add(a),o(`Middleware for "${e}" returned undefined; treating as pass-through. Return the new state to override.`)),i=c):i=u;}return i},nt=({name:e,label:t,fn:r,args:n,reportIssue:o})=>{if(typeof r=="function")try{r(...n);}catch(s){let i=`${t} for "${e}" failed: ${s?.message??s}`;o(i,"always");}};var J=(e,t,...r)=>{if(typeof e=="function")try{e(...r);}catch(n){let o=n?.message??n;G(`${t} callback threw: ${String(o)}`);}},he=(e,t={})=>{let{severity:r="warn",visibility:n="dev",onError:o}=t;if(J(o,"onError",e),r==="critical"){n==="dev"&&p(e),z(e);return}if(n==="always"){G(e);return}p(e);};var ot=null,Kr=e=>{ot=e;},Gr=e=>ot?ot(e):[];T("computed.order-resolver",()=>{ot=null;},105);var Yr=()=>K(xe(Re));var Bt=()=>Yr().computedEntries,Xr=()=>Yr().computedDependents;var Jr=e=>Object.prototype.hasOwnProperty.call(Bt(),e);var No=e=>{let t=Bt(),r=Xr(),n=new Set,o=[...e];for(;o.length>0;){let l=o.shift(),h=r[l];if(h)for(let w of h)n.has(w)||(n.add(w),o.push(w));}if(n.size===0)return [];let s=l=>{let h=t[l];if(h)for(let w of h.deps)t[w]&&(n.has(w)||(n.add(w),s(w)));};Array.from(n).forEach(l=>s(l));let i=new Map,a=new Map;for(let l of n){let h=t[l];if(!h)continue;let w=0;for(let g of h.deps)n.has(g)&&(w++,a.has(g)||a.set(g,[]),a.get(g).push(l));i.set(l,w);}let u=[];for(let[l,h]of i)h===0&&u.push(l);u.sort();let c=[];for(;u.length>0;){let l=u.shift();c.push(l);let h=a.get(l)??[];for(let w of h){let g=(i.get(w)??1)-1;if(i.set(w,g),g===0){let v=u.findIndex(d=>d>w);v===-1?u.push(w):u.splice(v,0,w);}}}return c};Kr(No);var qt=e=>{let t=Bt()[e];if(!t)return null;let r=Xr()[e];return {deps:[...t.deps],dependents:r?[...r]:[]}};var Qr=e=>{if(typeof e!="object"||e===null)return false;let t=e;if(t.$$typeof||typeof window<"u"&&e instanceof Element)return false;let r=t.constructor?.name;return !(r&&r!=="Object"&&r!=="Array")},Ut=e=>(Qr(e)&&(Object.isFrozen(e)||Object.freeze(e)),e),Zr=e=>{if(!Qr(e))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 o of Object.keys(n)){let s=n[o];typeof s=="object"&&s!==null&&!r.has(s)&&t.push(s);}}}return e};var He=0,Do=(e,t)=>(He>=Number.MAX_SAFE_INTEGER&&(He=0),He+=1,`${e}:${t}:${He}`),Vo=e=>{let t=[e?.correlationId,e?.traceContext?.traceId,e?.traceContext?.spanId].filter(r=>typeof r=="string"&&r.length>0);return t.length>0?t:void 0},Io=e=>({...e,path:[...e.path],meta:{...e.meta,causedBy:e.meta.causedBy?[...e.meta.causedBy]:void 0}}),jo=e=>e?Array.isArray(e)?e.map(t=>typeof t=="number"?t:String(t)):Se(e):[],Kt=e=>{let t=e.timestamp??Date.now();return {id:Do(e.source,t),store:e.store,path:jo(e.path),op:e.op,...e.value!==void 0?{value:e.value}:{},meta:{timestamp:t,source:e.source,causedBy:Vo(e.context),...e.isUnsafe===true?{isUnsafe:true}:{},...e.asyncBoundary===true?{asyncBoundary:true}:{}}}},Gt=e=>Kt({store:e.store,op:"set",path:[],value:e.value,source:e.source,context:e.context}),en=e=>e.intent.kind==="root"||!e.preserveIntent?[Gt({store:e.store,value:e.committedValue,source:"setStore",context:e.context})]:e.intent.kind==="merge"?[Kt({store:e.store,op:"merge",path:[],value:e.intent.value,source:"setStore",context:e.context})]:[Kt({store:e.store,op:"set",path:e.intent.path,value:e.intent.value,source:"setStore",context:e.context})],tn=(e,t=P())=>{t.lastRuntimePatches=e.map(Io);};T("runtime-patch.sequence",()=>{He=0;},126);var st=null;var $o=()=>{st=null;};T("transaction.runner",$o,120);var Te=e=>{let t=st?.get();return t||(e??K()).transaction},_o=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 F=()=>st?(st.get()?.depth??0)>0:Te().depth>0,$=(e,t)=>{let r=Te(t);r.failed=true,r.error||(r.error=_o(e));},it=e=>{let t=K();Te(t).pending.push(()=>et(t,e));},at=(e,t)=>{let r=Te();r.stagedValues.set(e,t),r.snapshotCache.delete(e);},rn=e=>{if(e.length===0)return;Te().runtimePatches.push(...e);},le=e=>{let t=Te();return t.stagedValues.has(e)?{has:true,value:t.stagedValues.get(e)}:{has:false,value:void 0}};var nn=(e,t)=>{let r=e?.options?.snapshot??t;return r==="shallow"||r==="ref"?r:"deep"},Yt=(e,t)=>{if(t==="ref"){if(!M())return e;try{return Ut(e)}catch{return e}}if(t==="shallow"){let n=jt(e);if(!M())return n;try{return Ut(n)}catch{return n}}let r=V(e);if(!M())return r;try{return Zr(r)}catch{return r}};var on=e=>{let{pendingNotifications:t,pendingBuffer:r,orderedNames:n}=e,o=E().flush,s=o.priorityStores||[],i=s.length?new Set(s):null;n.length=0,r.length=0;let a=new Set;if(i){for(let v of t)r.push(v),a.add(v);for(let v of s)a.has(v)&&n.push(v);for(let v of r)i.has(v)||n.push(v);}else for(let v of t)r.push(v),a.add(v),n.push(v);t.clear();let u=Gr(n),c=new Set(n);for(let v of u)c.has(v)||(n.push(v),c.add(v));let l=Number.isFinite(o.chunkSize)&&o.chunkSize>0?o.chunkSize:Number.POSITIVE_INFINITY,h=o.chunkDelayMs,w=l===Number.POSITIVE_INFINITY&&h===0;return {names:n,sliceSize:l,chunkDelayMs:h,runInline:w,prioritySet:i}};var Xt=e=>({notifyCount:e?.notifyCount??0,totalNotifyMs:e?.totalNotifyMs??0,lastNotifyMs:e?.lastNotifyMs??0,resetCount:e?.resetCount??0,totalResetMs:e?.totalResetMs??0,lastResetMs:e?.lastResetMs??0}),Jt=(e,t)=>(e.notifyCount+=1,e.totalNotifyMs+=t,e.lastNotifyMs=t,e),Qt=(e,t)=>{e&&(e.metrics=t);};var Le=(e,t)=>{if(t>0&&typeof setTimeout=="function"){setTimeout(e,t);return}if(typeof queueMicrotask=="function"){queueMicrotask(e);return}Promise.resolve().then(e);},sn=(e,t)=>{let r=e.notify;if(r.notifyScheduled)return;r.notifyScheduled=true;let n=()=>et(e,()=>t(e));typeof queueMicrotask=="function"?queueMicrotask(n):Promise.resolve().then(n);};var an=new Map;var Zt=e=>{let t=an.get(e);return !!t&&t.size>0},Be=(e,t,r)=>{let n=an.get(e);!n||n.size===0||n.forEach(o=>{try{o(t,r);}catch(s){typeof console<"u"&&console.warn&&console.warn(`[stroid] lifecycle hook "${e}" failed:`,s);}});};var qe=null,ct=null;var zo=()=>{qe=null,ct=null;};T("write-context.runner",zo,121);var ut=()=>ct?.get()??qe,er=(e,t)=>{if(!e||!e.correlationId&&!e.traceContext)return t();if(ct)return ct.run(e,t);let r=qe;qe=e;try{return t()}finally{qe=r;}};var cn=e=>{if(!(e instanceof TypeError))return false;let t=e?.message??String(e);return /read only|readonly|cannot assign|cannot add property|cannot delete property/i.test(t)},un=(e,t,r,n)=>{let o=e.notify,{names:s,sliceSize:i,chunkDelayMs:a,runInline:u,prioritySet:c}=t,h=e.stores,w=e.subscribers,g=e.metaEntries,v=e.snapshotCache,d=E().defaultSnapshotMode,m=y=>nn(g[y],d),S=y=>h[y],R=()=>typeof performance<"u"&&performance.now?performance.now():Date.now(),x=Zt("beforeFlush"),k=Zt("afterFlush"),A=y=>{x&&Be("beforeFlush",y,{type:"beforeFlush"});},b=(y,_)=>{k&&Be("afterFlush",y,{type:"afterFlush",elapsedMs:_});},C=y=>{let _=g[y];if(!_)return null;let N=_.lastCorrelationId??void 0,f=_.lastTraceContext??void 0;return !N&&!f?null:{correlationId:N,traceContext:f}},O=()=>{n();};if(u){for(let y of s){let _=w[y];if(!_||_.size===0)continue;let N=g[y]?.updateCount??0,f=m(y),we=S(y),q=v[y],U=q&&q.source===we&&q.mode===f?q.snapshot:(()=>{let W=Yt(we,f);return v[y]={version:r,snapshot:W,source:we,mode:f},W})(),re=Xt(g[y]?.metrics);A(y);let de=R(),ae=Array.from(_),Ne=C(y),De=()=>{for(let W of ae)try{W(U);}catch(fe){let ne=g[y]?.options?.snapshotSafety??"warn";if(M()&&(f==="ref"||f==="shallow")&&cn(fe)){if(ne==="throw")throw fe;if(ne==="auto-clone")try{let Ie=V(U);p(`Snapshot mutation detected for "${y}". Delivered a cloned snapshot to the subscriber.`);try{W(Ie);}catch(xt){p(`Subscriber for "${y}" threw on cloned snapshot: ${xt?.message??xt}`);}continue}catch{}p(`Snapshot mutation detected for "${y}": ${fe?.message??fe}`);continue}p(`Subscriber for "${y}" threw: ${fe?.message??fe}`);}};Ne?er(Ne,De):De();let Ve=R()-de;b(y,Ve),Jt(re,Ve),Qt(g[y],re),(g[y]?.updateCount??N)!==N&&o.pendingNotifications.add(y);}O();return}let j=y=>{let _=[];for(let N of s){if(y&&!y(N))continue;let f=w[N];if(!f||f.size===0)continue;let we=g[N]?.updateCount??0,q=m(N),U=S(N),re=v[N],de=re&&re.source===U&&re.mode===q?re.snapshot:(()=>{let ae=Yt(U,q);return v[N]={version:r,snapshot:ae,source:U,mode:q},ae})();_.push({name:N,snapshot:de,version:we,subscribers:Array.from(f),subscriberSet:new Set(f),notified:new Set,metrics:Xt(g[N]?.metrics),totalMs:0,beforeHooked:false});}return _},Pe=c?j(y=>c.has(y)):[],Oe=j(y=>!c||!c.has(y)),vt=(y,_)=>{let N=()=>{if(y.length===0){_();return}let f=y.shift();if((g[f.name]?.updateCount??f.version)!==f.version){if(o.pendingNotifications.add(f.name),y.length===0){_();return}Le(N,a);return}let q=()=>{let X=w[f.name];if(!(!X||X.size===0))for(let W of X)f.subscriberSet.has(W)||(f.subscriberSet.add(W),f.subscribers.push(W));};q();let U=f.subscribers;if(U.length===0){if(y.length===0){_();return}Le(N,a);return}f.beforeHooked||(f.beforeHooked=true,A(f.name));let re=R(),de=0,ae=false,Ne=C(f.name),De=()=>{for(let X=0;X<U.length&&de<i;X+=1){let W=U[X];if(f.notified.has(W))continue;f.notified.add(W);try{W(f.snapshot);}catch(ne){let Rt=g[f.name]?.options?.snapshotSafety??"warn",Ie=m(f.name);if(M()&&(Ie==="ref"||Ie==="shallow")&&cn(ne)){if(Rt==="throw")throw ne;if(Rt==="auto-clone")try{let ur=V(f.snapshot);p(`Snapshot mutation detected for "${f.name}". Delivered a cloned snapshot to the subscriber.`);try{W(ur);}catch(lr){p(`Subscriber for "${f.name}" threw on cloned snapshot: ${lr?.message??lr}`);}if(f.notified.add(W),de+=1,(g[f.name]?.updateCount??f.version)!==f.version){ae=!0,o.pendingNotifications.add(f.name);break}continue}catch{}p(`Snapshot mutation detected for "${f.name}": ${ne?.message??ne}`);continue}p(`Subscriber for "${f.name}" threw: ${ne?.message??ne}`);}if(de+=1,(g[f.name]?.updateCount??f.version)!==f.version){ae=true,o.pendingNotifications.add(f.name);break}}};if(Ne?er(Ne,De):De(),f.totalMs+=R()-re,ae){if(y.length===0){_();return}Le(N,a);return}q();let Ve=false;for(let X of U)if(!f.notified.has(X)){Ve=true;break}if(Ve?y.push(f):(Jt(f.metrics,f.totalMs),Qt(g[f.name],f.metrics),b(f.name,f.totalMs)),y.length===0){_();return}Le(N,a);};N();};Pe.length>0?vt(Pe,()=>vt(Oe,O)):vt(Oe,O);};var Wo=e=>{let t=e.notify;t.isFlushing=true,t.flushId=t.flushId+1>>>0;let r=t.flushId,n=on(t);un(e,n,r,()=>{t.isFlushing=false,t.notifyScheduled=false,t.pendingNotifications.size>0&&tr(e);});},tr=e=>{sn(e,Wo);};var lt=null,ln=e=>(lt=e,()=>{lt===e&&(lt=null);}),Ee=e=>{lt?.(e);};var Ho=e=>{let t=P(),r=t.notify;r.pendingNotifications.add(e),r.batchDepth===0&&tr(t);};ln(Ho);var Lo=()=>{let e=P().notify;e.pendingNotifications.clear(),e.pendingBuffer.length=0,e.orderedNames.length=0,e.notifyScheduled=false,e.batchDepth=0;};T("notify.reset",Lo,40);var dt=new Set,pn=e=>e?dt.has(e):dt.size>0,gn=e=>{e&&dt.add(e);},Bo=()=>{dt.clear();};T("ssr.warnings",Bo,60);var fn=new Set,qo=e=>{let t=kr();return !t||e.includes("::")?e:(M()&&!fn.has(e)&&(fn.add(e),p(`Namespace "${t}" is active; treating store "${e}" as "${t}::${e}". Consider using namespace("${t}").create("...") to be explicit.`)),`${t}::${e}`)},ft=e=>qo(typeof e=="string"?e:e.name),yn=e=>se(e)&&!hn(e)?true:(Pt(e,Object.keys(Ke)),false),mn=(e,t,r={})=>{he(t,{...r,onError:I[e]?.options?.onError});},Sn=(e,t,r={})=>{he(e,{...r,onError:t});},Q=(e,t,r="dev")=>{mn(e,t,{severity:"warn",visibility:r});},Uo=(e,t,r="dev")=>{Sn(e,t,{severity:"warn",visibility:r});},ie=(e,t)=>mn(e,t,{severity:"critical",visibility:"always"}),Ue=(e,t)=>Sn(e,t,{severity:"critical",visibility:"always"}),pt=(e,t,r)=>{let n=`Store "${e}" requested ${t} support, but "${t}" is not registered.
|
|
13
|
-
Import "stroid/${t}" before calling createStore("${e}", ...).`;if(Uo(n,r,"always"),E().strictMissingFeatures)throw new Error(n)};var bn=new WeakMap,wn=new WeakMap,Ko=500,Go="",Ge=e=>{let t=bn.get(e);return t||(t=new Map,bn.set(e,t)),t},nr=e=>{let t=wn.get(e);return t||(t=new Map,wn.set(e,t)),t},Yo=(e,t)=>{let r=nr(e),n=r.get(t);return n||(n=new Map,r.set(t,n)),n},Xo=()=>{let e=E().pathCacheSize;return typeof e!="number"||!Number.isFinite(e)?Ko:Math.max(0,Math.floor(e))},vn=(e,t,r,n)=>{if(n<=0){e.has(t)&&e.delete(t);return}for(e.has(t)&&e.delete(t),e.set(t,r);e.size>n;){let o=e.keys().next().value;if(!o)break;let s=e.get(o);e.delete(o),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=Ge(P());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)=>(Ge(P())[t]=r,true)});var Rn=(e,t,r,n)=>{let o=I[e];if(!o)return {ok:true};let s=Se(r);if(s.length===0)return {ok:true};let i=ce(n),a=Xo(),u=P(),c=Ge(u),l=Yo(u,e),h=s.join(Go),w=c.get(e);w||(w={children:new Map},c.set(e,w));let g=w;for(let x of s){let k=g.children.get(x);k||(k={children:new Map},g.children.set(x,k)),g=k;}let v=g.verdicts?.get(i);if(v){let x=`${h}|${i}`;return vn(l,x,{node:g,type:i},a),v}let d=o.options?.pathCreate===true,m=t,S={ok:true};for(let x=0;x<s.length;x++){let k=s[x],A=x===s.length-1;if(m==null){let C=`Path "${s.join(".")}" is invalid for "${e}" - "${s.slice(0,x).join(".")||"root"}" is ${m===null?"null":"undefined"}.`;z(C),S={ok:false,reason:C};break}if(typeof m!="object"){let C=`Path "${s.join(".")}" is invalid for "${e}" - "${s.slice(0,x).join(".")||"root"}" is not an object.`;z(C),S={ok:false,reason:C};break}if(Array.isArray(m)){let C=Number(k);if(!Number.isInteger(C)||C<0){let j=`Path "${s.join(".")}" targets non-numeric index "${k}" on an array in "${e}".`;z(j),S={ok:false,reason:j};break}let O=m;if(C>=O.length){let j=`Path "${s.join(".")}" is invalid for "${e}" - index ${C} is out of bounds (length ${O.length}).`;z(j),S={ok:false,reason:j};break}if(A){let j=O[C];if(j!=null){let Pe=ce(j);if(Pe!==i){let Oe=`Type mismatch setting "${s.join(".")}" on "${e}": expected ${Pe}, received ${i}.`;z(Oe),S={ok:false,reason:Oe};break}}S={ok:true};break}m=O[C];continue}if(!Object.prototype.hasOwnProperty.call(m,k)){if(d&&A){S={ok:true};break}let C=`Path "${s.join(".")}" is invalid for "${e}" - unknown key "${k}" at "${s.slice(0,x).join(".")||"root"}".`;z(C),S={ok:false,reason:C};break}if(A){let C=m[k];if(C!=null){let O=ce(C);if(O!==i){let j=`Type mismatch setting "${s.join(".")}" on "${e}": expected ${O}, received ${i}.`;z(j),S={ok:false,reason:j};break}}S={ok:true};break}m=m[k];}g.verdicts||(g.verdicts=new Map);let R=g.verdicts.has(i);if(g.verdicts.set(i,S),!R){let x=`${h}|${i}`;vn(l,x,{node:g,type:i},a);}return S},be=(e,t,r,n)=>{try{return n?.reuseInput&&Dt(t)?{ok:!0,value:t}:{ok:!0,value:ge(t)}}catch(o){let s=`Sanitize failed for "${e}": ${o?.message??o}`;return J(I[e]?.options?.onError,`onError(${e})`,s),J(r,`onError(${e})`,s),p(s),{ok:false}}},Jo=(e,t)=>{let r=new Set,n=I[e]?.options?.onError;return typeof n=="function"&&r.add(n),typeof t=="function"&&r.add(t),r},or=(e,t,r,n)=>{if(!r)return {ok:true,value:t};let o=Jo(e,n),s=(a,u)=>{o.forEach(c=>J(c,`onError(${e})`,a)),u==="critical"?z(a):p(a);};if(typeof r=="function")try{let a=r(t);return a===!1?(s(`Validation blocked update for "${e}"`,"warn"),{ok:!1}):{ok:!0,value:a===!0?t:a}}catch(a){return s(`Validation for "${e}" failed: ${a?.message??a}`,"critical"),{ok:false}}let i=Nt(r,t);return i.ok?{ok:true,value:i.data??t}:(s(`Validation failed for "${e}": ${i.error}`,"critical"),{ok:false})},Ye=(e,t,r,n,o)=>{let s=be(e,t,n,o);if(!s.ok)return {ok:false};let i=or(e,s.value,r,n);return i.ok?{ok:true,value:i.value}:{ok:false}},ee=e=>{let t=P();Ge(t).delete(e),nr(t).delete(e);},Qo=()=>{let e=P();Ge(e).clear(),nr(e).clear();};T("validation.path-cache",Qo,50);xn(ee);var gt=(e,t=P())=>{if((F()?le(e):{has:false}).has||t.stores[e]!==void 0)return true;let n=t.initialFactories[e];if(!n)return true;try{let o=n(),s=be(e,o,t.metaEntries[e]?.options?.onError);if(!s.ok)return !1;let i=t.metaEntries[e]?.options?.validate,a=Ye(e,s.value,i,t.metaEntries[e]?.options?.onError);if(!a.ok)return !1;if(F()){let u=a.value;at(e,u),it(()=>{te(e,u,t),t.initialStates[e]=V(u),delete t.initialFactories[e],ee(e);});}else te(e,a.value,t),t.initialStates[e]=V(a.value),delete t.initialFactories[e],ee(e);return !0}catch(o){return ie(e,`Lazy initializer for "${e}" failed: ${o?.message??o}`),false}};var Cn=new WeakMap,kn=e=>{let t=Cn.get(e);return t||(t=new Map,Cn.set(e,t)),t},Zo=()=>{kn(P()).clear();};T("features.contexts",Zo,100);var Mn=e=>{let t=P(),r=kn(t),n=r.get(e);if(n)return n;let o=I[e];if(!o)return p(`Internal feature context requested for "${e}" after metadata was cleared.`),null;let s={name:e,options:o.options,getMeta:()=>I[e],getStoreValue:()=>Ke[e],getAllStores:()=>Ke,getInitialState:()=>On[e],hasStore:()=>se(e),setStoreValue:i=>{te(e,i);},applyFeatureState:(i,a)=>{Nn(e,i,a),ee(e);},notify:()=>{},reportStoreError:i=>{ie(e,i);},warn:p,warnAlways:G,log:B,hashState:ze,deepClone:V,sanitize:ge,validate:i=>or(e,i,I[e]?.options?.validate),isDev:M};return r.set(e,s),s},Tn=(e,t)=>{let r=E();if(!r.strictMissingFeatures&&!r.assertRuntime)return;let n=[];if(typeof t.getMeta!="function"&&n.push("getMeta"),typeof t.getStoreValue!="function"&&n.push("getStoreValue"),typeof t.getAllStores!="function"&&n.push("getAllStores"),typeof t.getInitialState!="function"&&n.push("getInitialState"),typeof t.hasStore!="function"&&n.push("hasStore"),typeof t.setStoreValue!="function"&&n.push("setStoreValue"),typeof t.applyFeatureState!="function"&&n.push("applyFeatureState"),typeof t.notify!="function"&&n.push("notify"),typeof t.reportStoreError!="function"&&n.push("reportStoreError"),typeof t.warn!="function"&&n.push("warn"),typeof t.warnAlways!="function"&&n.push("warnAlways"),typeof t.log!="function"&&n.push("log"),typeof t.hashState!="function"&&n.push("hashState"),typeof t.deepClone!="function"&&n.push("deepClone"),typeof t.sanitize!="function"&&n.push("sanitize"),typeof t.validate!="function"&&n.push("validate"),typeof t.isDev!="function"&&n.push("isDev"),n.length===0)return;let o=`Feature hook context missing fields for "${e}": ${n.join(", ")}.`;if(ie(e,o),r.assertRuntime)throw new Error(o)},En=(e,t)=>{mt();let r=Mn(e);r&&(r.notify=()=>t(e),Tn(e,r),Z.forEach((n,o)=>{try{n.onStoreCreate?.(r);}catch(s){Q(e,`Feature "${String(o)}" onStoreCreate for "${e}" failed: ${s?.message??s}`,"always");}}));},Fn=(e,t,r,n,o)=>{mt();let s=Mn(e);if(!s)return;s.notify=()=>o(e);let i=Object.assign(Object.create(s),{action:t,prev:r,next:n});Tn(e,i),Z.forEach((a,u)=>{try{a.onStoreWrite?.(i);}catch(c){Q(e,`Feature "${String(u)}" onStoreWrite for "${e}" failed: ${c?.message??c}`,"always");}});};var An=(e,t)=>Ur({name:e,payload:t,middlewares:(()=>{let r=I[e]?.options?.middleware||[],n=E().middleware||[];return r.length===0?n:n.length===0?r:[...r,...n]})(),reportIssue:(r,n)=>{Q(e,r,n);},warn:p}),yt=(e,t,r,n)=>nt({name:e,label:t,fn:r,args:n,reportIssue:(o,s)=>{Q(e,o,s);}}),Pn=(e,t)=>{let r={...t};return r.persist&&!Xe("persist")&&(r.explicitPersist&&pt(e,"persist",r.onError),r.persist=null),r.sync&&!Xe("sync")&&(r.explicitSync&&pt(e,"sync",r.onError),r.sync=false),Xe("devtools")||(r.explicitDevtools&&pt(e,"devtools",r.onError),r.devtools=false,r.historyLimit=0,r.redactor=void 0),r};var es=32,sr=new Set;T("store-write.slow-mutator-warned",()=>sr.clear(),65);var ts=e=>{if(e.updateCount>=Number.MAX_SAFE_INTEGER){e.updateCount=0;return}e.updateCount+=1;};var Vn=(e,t)=>{M()&&(t<es||sr.has(e)||(sr.add(e),p(`setStore("${e}", mutator) took ${t}ms. Mutator writes clone the entire store; consider path writes or smaller stores for hot paths.`)));},In=e=>ut(),rs=(e,t)=>{if(!e||!t)return;let r=t.resetElapsedMs;typeof r=="number"&&(e.metrics.resetCount=(e.metrics.resetCount??0)+1,e.metrics.totalResetMs=(e.metrics.totalResetMs??0)+r,e.metrics.lastResetMs=r);},Dn=(e,{name:t,prev:r,next:n,action:o,hookLabel:s,logMessage:i,context:a,metricsUpdate:u})=>{let c=e.metaEntries;te(t,n,e),ee(t);let l=Date.now();c[t].updatedAt=new Date(l).toISOString(),c[t].updatedAtMs=l;let h=a??ut();h&&(h.correlationId||h.traceContext)?(c[t].lastCorrelationId=h.correlationId??null,c[t].lastCorrelationAt=new Date(l).toISOString(),c[t].lastCorrelationAtMs=l,c[t].lastTraceContext=h.traceContext??null):(c[t].lastCorrelationId=null,c[t].lastCorrelationAt=null,c[t].lastCorrelationAtMs=null,c[t].lastTraceContext=null),ts(c[t]),rs(c[t],u),Fn(t,o,r,n,Ee),yt(t,s,c[t].options[s],[r,n]),Ee(t),B(i);},St=(e,t)=>{let r=t.context??ut();if(F()){at(t.name,t.next),rn(t.runtimePatches??[]),it(()=>Dn(e,{...t,context:r}));return}Dn(e,{...t,context:r}),t.runtimePatches&&t.runtimePatches.length>0&&tn(t.runtimePatches,e);};function Fe(e,t,r){return ns(e,t,r)}var ns=(e,t,r,n)=>{let o=ft(e),s=P(),i=s.metaEntries;if(!gt(o,s))return {ok:false,reason:"validate"};if(!se(o,s)){let R=`setStore("${o}") called before createStore(). Create the store first or pass a valid StoreDefinition.`;return ie(o,R),F()&&$(R),{ok:false,reason:"not-found"}}let a,u={kind:"root"},c=F()?le(o):{has:false,value:void 0},l=c.has?c.value:rr(o,s);if(typeof t=="function"&&r===void 0){let R=M()?Date.now():0;try{let x=E().mutatorProduce,k=!1,A,b=O=>{let j=t(O);return j!==void 0&&(k=!0,A=j),j},C=x?x(l,b):(()=>{let O=V(l);return b(O),O})();if(k&&E().strictMutatorReturns){let O=`setStore("${o}", mutator) returned a value. Strict mutator mode forbids return values; mutate the draft instead.`;return ie(o,O),F()&&$(O),{ok:!1,reason:"validate"}}k&&M()&&!E().strictMutatorReturns&&p(`setStore("${o}", mutator) returned a value. Return values replace the entire store; return void to apply draft mutations instead.`),a=k&&!E().strictMutatorReturns?A:C,u={kind:"root"};}catch(x){return ie(o,`Mutator for "${o}" failed: ${x?.message??x}`),F()&&$(x),{ok:false,reason:"validate"}}finally{R&&Vn(o,Date.now()-R);}}else if(typeof t=="object"&&!Array.isArray(t)&&r===void 0){if(!Ce(t))return F()&&$(`setStore("${o}") received invalid data`),{ok:false,reason:"invalid-args"};if(typeof l!="object"||l===null||Array.isArray(l))return L(`setStore("${o}", data) only merges into object stores.
|
|
14
|
-
Use setStore("${o}", "path", value) or recreate the store with an object shape.`),F()&&$(`setStore("${o}") attempted object merge on non-object store`),{ok:false,reason:"validate"};let R=be(o,t);if(!R.ok)return F()&&$(`setStore("${o}") failed sanitize`),{ok:false,reason:"validate"};a={...l,...R.value},u={kind:"merge",value:R.value};}else if(typeof t=="string"||Array.isArray(t)){if(!zt(t))return F()&&$(`setStore("${o}") received invalid path`),{ok:false,reason:"invalid-args"};let R=be(o,r);if(!R.ok)return F()&&$(`setStore("${o}") failed sanitize`),{ok:false,reason:"validate"};let x=R.value,k=Rn(o,l,t,x);if(!k.ok)return J(i[o]?.options?.onError,`onError(${o})`,k.reason??`Invalid path for "${o}".`),F()&&$(k.reason),{ok:false,reason:"path"};a=Wt(l,t,x),u={kind:"path",path:t,value:x};}else {let R=`setStore("${o}") - invalid arguments.
|
|
15
|
-
Usage:
|
|
16
|
-
setStore("${o}", "field", value)
|
|
17
|
-
setStore("${o}", "nested.field", value)
|
|
18
|
-
setStore("${o}", { field: value })
|
|
19
|
-
setStore(storeDef, draft => { draft.field = value })
|
|
20
|
-
replaceStore("${o}", value) // full-store replace`;return L(R),J(i[o]?.options?.onError,`onError(${o})`,R),F()&&$(R),{ok:false,reason:"invalid-args"}}if(!Ce(a))return F()&&$(`setStore("${o}") produced invalid data`),{ok:false,reason:"validate"};let w=i[o]?.options?.validate,g=In(),v=An(o,{action:"set",prev:l,next:a,path:t,correlationId:g?.correlationId,traceContext:g?.traceContext});if(v===rt)return F()&&$(`setStore("${o}") aborted by middleware`),{ok:false,reason:"middleware"};let d=Object.is(v,a),m=Ye(o,v,w,void 0,d?{reuseInput:true}:void 0);if(!m.ok)return F()&&$(`setStore("${o}") failed validation`),{ok:false,reason:"validate"};let S=en({store:o,intent:u,committedValue:m.value,preserveIntent:u.kind!=="root"&&Object.is(v,a)&&Object.is(m.value,v),context:g});try{if(_t(l,m.value))return {ok:!0}}catch{}return St(s,{name:o,prev:l,next:m.value,action:"set",hookLabel:"onSet",logMessage:`Store "${o}" updated`,context:g,runtimePatches:S}),{ok:true}};function ht(e){let t=ft(e);if(!yn(t))return {ok:false,reason:"not-found"};let r=P();if(r.metaEntries[t]?.options?.lazy===true&&!!r.initialFactories[t]){let c=`resetStore("${t}") cannot run on a lazy store before it is initialized. Read the store once (getStore) to materialize it before resetting.`;return Q(t,c),F()&&$(c),{ok:false,reason:"lazy-uninitialized"}}if(!gt(t,r))return {ok:false,reason:"validate"};if(!Object.prototype.hasOwnProperty.call(r.initialStates,t)){let c=`resetStore("${t}") has no initial state to reset to. If this is a lazy store, ensure it has been initialized before calling resetStore.`;return Q(t,c),F()&&$(c),{ok:false,reason:"not-found"}}let o=F()?le(t):{has:false,value:void 0},s=o.has?o.value:r.stores[t],i=typeof performance<"u"&&performance.now?performance.now():Date.now(),a=V(r.initialStates[t]),u=(typeof performance<"u"&&performance.now?performance.now():Date.now())-i;return St(r,{name:t,prev:s,next:a,action:"reset",hookLabel:"onReset",logMessage:`Store "${t}" reset to initial state/value`,metricsUpdate:{resetElapsedMs:u},runtimePatches:[Gt({store:t,value:a,source:"resetStore"})]}),{ok:true}}var bt=()=>{fr();};var jn=e=>({name:e});var as=()=>P().computedCleanups,$n=new WeakMap;var cs=e=>{let t=$n.get(e);return t||(t=new Map,$n.set(e,t)),t};var _n=e=>{let t=as(),r=t.get(e);if(!r){M()&&p(`deleteComputed("${e}") -- not found`);return}r(),t.delete(e);};var zn=(e,t=P())=>cs(t).get(e)?.autoDispose===true;var Wn=e=>{let t=e.stores,r=e.subscribers,n=e.initialStates,o=e.initialFactories,s=e.metaEntries,i=e.snapshotCache,a=e.featureRuntimes,u=e.deletingStores,c=(d,m)=>{he(m,{onError:s[d]?.options?.onError,severity:"warn",visibility:"dev"});},l=({name:d,prev:m,options:S,initialState:R,getMeta:x,getStoreValue:k,hasStore:A})=>({name:d,options:S,prev:m,getMeta:x,getStoreValue:k,getAllStores:()=>t,getInitialState:()=>R,hasStore:A,setStoreValue:()=>{},applyFeatureState:()=>{},notify:()=>{},reportStoreError:b=>{he(b,{onError:S.onError,severity:"warn",visibility:"dev"});},warn:p,warnAlways:G,log:B,hashState:ze,deepClone:V,sanitize:ge,validate:()=>({ok:true,value:m}),isDev:M}),h=({name:d,prev:m,options:S,initialState:R,phase:x})=>{let k=l({name:d,prev:m,options:S,initialState:R,getMeta:()=>s[d],getStoreValue:()=>t[d],hasStore:()=>pe(e,d)}),A=l({name:d,prev:m,options:S,initialState:R,getMeta:()=>{},getStoreValue:()=>m,hasStore:()=>false});ve().forEach(b=>{let C=a.get(b);x==="before"?C?.beforeStoreDelete?.(k):C?.afterStoreDelete?.(A);});},w=d=>{if(!pe(e,d))return;let m=t[d],S=s[d].options,R=n[d],x=r[d];u.add(d);try{x?.forEach(b=>{try{b(null);}catch(C){p(`Subscriber for "${d}" threw during delete: ${C?.message??C}`);}}),nt({name:d,label:"onDelete",fn:S.onDelete,args:[m],reportIssue:(b,C)=>{he(b,{onError:S.onError,severity:"warn",visibility:C});}}),h({name:d,prev:m,options:S,initialState:R,phase:"before"}),delete t[d],delete r[d],delete n[d],delete o[d],delete s[d],delete i[d],Jr(d)&&_n(d);let A=e.computedDependents[d];if(A)for(let b of [...A]){let C=qt(b);if(C&&zn(b,e)&&C.deps.every(O=>!pe(e,O))){w(b);continue}p(`[stroid] source store "${d}" was deleted. Computed store "${b}" depends on it and will return stale data. Call deleteComputed("${b}") to clean up.`);}h({name:d,prev:m,options:S,initialState:R,phase:"after"}),Be("afterStoreDelete",d,{type:"afterStoreDelete",prev:m}),Ze(e,{type:"deleted",name:d}),B(`Store "${d}" deleted`);}finally{u.delete(d);}};return {deleteExistingStore:w,clearAllStores:()=>{let d=[],S=0,R=Number.POSITIVE_INFINITY;for(;S<20;){let k=Object.keys(t);if(k.length===0)break;k.forEach(b=>{pe(e,b)&&(w(b),d.push(b));}),S+=1;let A=Object.keys(t).length;if(A===0||A>=R)break;R=A;}let x=Object.keys(t).length;return x>0?p(`clearAllStores stopped after ${S} pass${S===1?"":"es"}; ${x} store(s) still registered (likely recreated during deletion).`):B(`All stores cleared (${d.length} stores removed)`),d},clearStores:d=>{let m=Object.keys(t).filter(S=>d?d.endsWith("*")?S.startsWith(d.slice(0,-1)):S===d:true);return m.forEach(S=>w(S)),m},reportStoreError:c}};var ir=Re,Ln=xe(ir),Bn=null,H=()=>{let e=K(Ln);return Mt(e),e};var P=()=>H();var qn=(e,t)=>{Ze(e,t);};function xn(e){Bn=e;}var Ae=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}}}),us=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 o=n[r];return typeof o=="function"?o.bind(n):o},set:(t,r,n)=>(e()[r]=n,true)}),ls=e=>new Proxy({},{get:(t,r)=>{let n=e(),o=n[r];return typeof o=="function"?o.bind(n):o},set:(t,r,n)=>(e()[r]=n,true)}),Ke=Ae(()=>H().stores);Ae(()=>H().subscribers);var On=Ae(()=>H().initialStates);Ae(()=>H().initialFactories);var I=Ae(()=>H().metaEntries);Ae(()=>H().snapshotCache);var Z=us(()=>H().featureRuntimes),Hn=new WeakMap,ds=e=>{let t=Hn.get(e);return t||(t=Wn(e),Hn.set(e,t)),t};ls(()=>ds(H()));var fs=e=>{let t=Z.get(e);if(t)return t;let r=Je(e);if(!r)return;let n=r();return Z.set(e,n),n},mt=()=>{ve().forEach(e=>{fs(e);});};mt();var se=(e,t)=>pe(t??H(),e),rr=(e,t=H())=>{if(F()){let r=le(e);if(r.has)return r.value}return dn(e,t)},dn=(e,t=H())=>{let r=je();return r&&Object.prototype.hasOwnProperty.call(r,e)?r[e]:t.stores[e]},te=(e,t,r=H())=>{r.stores[e]=t;},Nn=(e,t,r=Date.now())=>{te(e,t),I[e]&&(I[e].updatedAt=new Date(r).toISOString(),I[e].updatedAtMs=r,I[e].lastCorrelationId=null,I[e].lastCorrelationAt=null,I[e].lastCorrelationAtMs=null,I[e].lastTraceContext=null,I[e].updateCount>=Number.MAX_SAFE_INTEGER?I[e].updateCount=0:I[e].updateCount+=1,Bn?.(e));};var ps=()=>{wr(H());},gs=()=>{Z.forEach(e=>{try{e.resetAll?.();}catch{}}),Z.clear();};T("features.reset",gs,10);T("registries.clear",ps,20);T("registry.default",()=>{ir=Re,Ln=xe(ir);},115);var hn=e=>br(H(),e);var wt=new Set,ys=e=>{wt.clear();};T("store-create.ssr-global-warned",()=>ys(),65);function Un(e,t,r={}){if(F()){let b=`createStore("${String(e)}") cannot be called inside setStoreBatch. Move createStore outside the batch to preserve transaction semantics.`;Ue(b,r.onError),$(b);return}if(!Vt(e)){Ue(`createStore("${String(e)}") is not a valid store name.`,r.onError);return}if(!(r.lazy===true&&typeof t=="function")&&!Ce(t)){Ue(`createStore("${e}") received invalid initial data.`,r.onError);return}t===void 0&&M()&&p(`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.`),Br(r).forEach(b=>{p(b);});let o=Pn(e,qr(r,e,E().defaultSnapshotMode));if(o.scope==="temp"&&r.persist){let b=`Store "${e}" has scope: "temp" but persist is enabled. Temp stores are intended to be ephemeral.`;J(o.onError,`onError(${e})`,b),M()||G(b),L(b);}let s=typeof window>"u",i=typeof process<"u"?process.env?.NODE_ENV:void 0,a=s&&i==="production",u=o.allowSSRGlobalStore??false,c=P(),l=c.stores,h=c.subscribers,w=c.initialStates,g=c.initialFactories,v=c.metaEntries,d=c.scope==="request";if(a&&!u&&!d){let b=`createStore("${e}") is blocked on the server in production to prevent cross-request memory leaks.
|
|
21
|
-
Call createStoreForRequest(...) inside each request scope or pass { scope: "global" } to opt in.`;Ue(b,r.onError);return}if(a&&u&&!d&&!wt.has(e)&&(wt.add(e),G(`createStore("${e}") is allowed on the server in production because allowSSRGlobalStore is true.
|
|
22
|
-
This can leak data across concurrent requests. Prefer createStoreForRequest(...) or scope: "request" unless you truly need a global SSR store.`)),se(e,c)){let b=`Store "${e}" already exists. Call setStore("${e}", data) to update instead.`;return Q(e,b),{name:e}}s&&!u&&!d&&!pn(e)&&M()&&(gn(e),p(`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 m=be(e,t,o.onError);if(!m.ok)return;let S=m.value,R=o.lazy===true&&typeof t=="function",x=(h[e]?.size??0)>0;if(R)l[e]=void 0,g[e]=t;else {let b=Ye(e,S,o.validate,o.onError);if(!b.ok)return;te(e,b.value,c),w[e]=V(b.value);}let k=Date.now(),A=new Date(k).toISOString();return v[e]={createdAt:A,updatedAt:A,updatedAtMs:k,updateCount:0,version:o.version,metrics:{notifyCount:0,totalNotifyMs:0,lastNotifyMs:0,resetCount:0,totalResetMs:0,lastResetMs:0},options:o,readCount:0,lastReadAt:null,lastReadAtMs:null,lastCorrelationId:null,lastCorrelationAt:null,lastCorrelationAtMs:null,lastTraceContext:null},ee(e),En(e,Ee),yt(e,"onCreate",v[e].options.onCreate,[S]),qn(c,{type:"created",name:e,isGlobal:o.scope==="global",isTemp:o.scope==="temp"}),x&&Ee(e),B(`Store "${e}" created -> ${JSON.stringify(S)}`),{name:e}}var ar=()=>K().async;var Gn=()=>ar().storeCleanups;var Kn=e=>{e&&Array.from(e).forEach(t=>{try{t();}catch{}});};var ms=(e,t)=>{Object.keys(t).length===0&&delete Gn()[e];},Ss=(e,t)=>{{Kn(e[t]),delete e[t];return}};var Yn=e=>{let t=Gn();Object.entries(t).forEach(([r,n])=>{n[e]&&(Ss(n,e),ms(r,n));});};var Xn=()=>{Qe(ar());};var cr=()=>{hs(),Xn();},hs=()=>{Yn("revalidate");};var $u=(e="mock",t={})=>{let r=jn(e);return Un(e,t),{set:n=>typeof n=="function"?Fe(r,n):Fe(r,n),reset:()=>ht(r),use:()=>r}},_u=(e,t)=>{let r=Date.now;Object.defineProperty(Date,"now",{value:()=>e,configurable:true});try{return t()}finally{Object.defineProperty(Date,"now",{value:r,configurable:true});}},zu=()=>{bt(),cr();},Wu=(e,t=1e3,r=n=>({value:n}))=>{let n=typeof performance<"u"&&performance.now?performance.now():Date.now();for(let i=0;i<t;i++)Fe(e,r(i));let s=(typeof performance<"u"&&performance.now?performance.now():Date.now())-n;return {iterations:t,totalMs:s,avgMs:s/t}};export{Wu as benchmarkStoreSet,$u as createMockStore,zu as resetAllStoresForTest,_u as withMockedTime};//# sourceMappingURL=testing.js.map
|
|
1
|
+
import'./chunk-YU5GMPCC.js';import {f}from'./chunk-LWUT37FW.js';import'./chunk-E33L4MII.js';import {q,l,Y,w,_}from'./chunk-X2MKRN7O.js';import'./chunk-6IBJ7CIK.js';import'./chunk-PHE2BCFG.js';import'./chunk-4C666HHU.js';var D=(o="mock",t={})=>{let e=q(o);return l(o,t),{set:r=>typeof r=="function"?w(e,r):w(e,r),reset:()=>Y(e),use:()=>e}},N=(o,t)=>{let e=Date.now;Object.defineProperty(Date,"now",{value:()=>o,configurable:true});try{return t()}finally{Object.defineProperty(Date,"now",{value:e,configurable:true});}},g=()=>{_(),f();},x=(o,t=1e3,e=r=>({value:r}))=>{let r=typeof performance<"u"&&performance.now?performance.now():Date.now();for(let a=0;a<t;a++)w(o,e(a));let s=(typeof performance<"u"&&performance.now?performance.now():Date.now())-r;return {iterations:t,totalMs:s,avgMs:s/t}};export{x as benchmarkStoreSet,D as createMockStore,g as resetAllStoresForTest,N as withMockedTime};//# sourceMappingURL=testing.js.map
|
|
23
2
|
//# sourceMappingURL=testing.js.map
|
package/dist/tsdoc-metadata.json
CHANGED
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module hydration-consistency/types
|
|
3
|
+
*
|
|
4
|
+
* LAYER: Store runtime
|
|
5
|
+
* OWNS: Public and internal types for post-hydration consistency handling.
|
|
6
|
+
*
|
|
7
|
+
* Consumers: hydration-consistency runtime modules and public barrels.
|
|
8
|
+
*/
|
|
9
|
+
type HydrationConsistencySource = "effect" | "storage" | "network" | "sync" | "hydrate" | "unknown";
|
|
10
|
+
type HydrationConsistencyAuthority = "server-authoritative" | "client-authoritative" | "mergeable";
|
|
11
|
+
/**
|
|
12
|
+
* How the post-hydration boot window is controlled.
|
|
13
|
+
* - `timer`: closes automatically after a configured duration.
|
|
14
|
+
* - `manual`: stays open until `close()` is called, optionally with a fallback timer.
|
|
15
|
+
*/
|
|
16
|
+
type HydrationBootWindowMode = "timer" | "manual";
|
|
17
|
+
/**
|
|
18
|
+
* Boot-window configuration for post-hydration write deferral.
|
|
19
|
+
*
|
|
20
|
+
* `timer` mode uses `ms` to guess when hydration should be considered settled.
|
|
21
|
+
* `manual` mode returns a `HydrationBootWindowControl` so the app can close the window explicitly.
|
|
22
|
+
* `fallbackMs` can be used as a safety timer while still preferring manual close.
|
|
23
|
+
*/
|
|
24
|
+
type HydrationBootWindowOptions = HydrationBootWindowMode | {
|
|
25
|
+
mode: HydrationBootWindowMode;
|
|
26
|
+
ms?: number;
|
|
27
|
+
fallbackMs?: number;
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Runtime control returned from `hydrateStores(...)` when a boot window is active.
|
|
31
|
+
*/
|
|
32
|
+
type HydrationBootWindowControl = {
|
|
33
|
+
mode: HydrationBootWindowMode;
|
|
34
|
+
startedAtMs: number | null;
|
|
35
|
+
endsAtMs: number | null;
|
|
36
|
+
close: () => void;
|
|
37
|
+
isActive: () => boolean;
|
|
38
|
+
};
|
|
39
|
+
type HydrationConsistencyPolicy = "server_wins" | "client_wins" | "merge" | "invalidate_and_refetch";
|
|
40
|
+
type HydrationConsistencyResolution = "stable" | "server_reverted" | "client_kept" | "merged" | "invalidated";
|
|
41
|
+
type HydrationSnapshotMetadata = {
|
|
42
|
+
snapshotVersion?: string | number;
|
|
43
|
+
timestamp?: number;
|
|
44
|
+
checksum?: string | number;
|
|
45
|
+
schemaSignature?: string;
|
|
46
|
+
};
|
|
47
|
+
type HydrationConsistencyStoreContract = HydrationSnapshotMetadata & {
|
|
48
|
+
authority?: HydrationConsistencyAuthority;
|
|
49
|
+
};
|
|
50
|
+
type HydrationConsistencyContract<Snapshot extends object = Record<string, unknown>> = HydrationSnapshotMetadata & {
|
|
51
|
+
authority?: HydrationConsistencyAuthority;
|
|
52
|
+
stores?: Partial<{
|
|
53
|
+
[K in keyof Snapshot & string]: HydrationConsistencyStoreContract;
|
|
54
|
+
}>;
|
|
55
|
+
};
|
|
56
|
+
type HydrationInvalidateArgs<State = unknown> = {
|
|
57
|
+
store: string;
|
|
58
|
+
baseline: State;
|
|
59
|
+
live: State;
|
|
60
|
+
source: HydrationConsistencySource;
|
|
61
|
+
};
|
|
62
|
+
type HydrationMergeArgs<State = unknown> = {
|
|
63
|
+
store: string;
|
|
64
|
+
baseline: State;
|
|
65
|
+
live: State;
|
|
66
|
+
source: HydrationConsistencySource;
|
|
67
|
+
};
|
|
68
|
+
type HydrationConsistencyStorePolicy<State = unknown> = HydrationConsistencyPolicy | {
|
|
69
|
+
policy: HydrationConsistencyPolicy;
|
|
70
|
+
merge?: (args: HydrationMergeArgs<State>) => State;
|
|
71
|
+
onInvalidate?: (args: HydrationInvalidateArgs<State>) => void;
|
|
72
|
+
};
|
|
73
|
+
type HydrationDriftEvent<Snapshot extends object = Record<string, unknown>> = {
|
|
74
|
+
id: string;
|
|
75
|
+
store: keyof Snapshot & string | string;
|
|
76
|
+
source: HydrationConsistencySource;
|
|
77
|
+
authority: HydrationConsistencyAuthority;
|
|
78
|
+
policy: HydrationConsistencyPolicy;
|
|
79
|
+
resolution: HydrationConsistencyResolution;
|
|
80
|
+
detectedAt: string;
|
|
81
|
+
detectedAtMs: number;
|
|
82
|
+
firstDivergedAt: string;
|
|
83
|
+
firstDivergedAtMs: number;
|
|
84
|
+
hydratedAt: string;
|
|
85
|
+
hydratedAtMs: number;
|
|
86
|
+
baselineHash: number;
|
|
87
|
+
liveHash: number;
|
|
88
|
+
resolvedHash: number;
|
|
89
|
+
invalidated: boolean;
|
|
90
|
+
metadata: HydrationSnapshotMetadata;
|
|
91
|
+
baseline: unknown;
|
|
92
|
+
live: unknown;
|
|
93
|
+
resolved: unknown;
|
|
94
|
+
};
|
|
95
|
+
type HydrationConsistencyOptions<Snapshot extends object = Record<string, unknown>> = {
|
|
96
|
+
contract?: HydrationConsistencyContract<Snapshot>;
|
|
97
|
+
policyMap?: Partial<{
|
|
98
|
+
[K in keyof Snapshot & string]: HydrationConsistencyStorePolicy<Snapshot[K]>;
|
|
99
|
+
}>;
|
|
100
|
+
onDrift?: (event: HydrationDriftEvent<Snapshot>) => void;
|
|
101
|
+
/**
|
|
102
|
+
* Legacy timer shorthand for the hydration boot window.
|
|
103
|
+
* Prefer `bootWindow` for explicit timer or manual mode.
|
|
104
|
+
*/
|
|
105
|
+
bootWindowMs?: number;
|
|
106
|
+
/**
|
|
107
|
+
* Preferred boot-window configuration for post-hydration write deferral.
|
|
108
|
+
*/
|
|
109
|
+
bootWindow?: HydrationBootWindowOptions;
|
|
110
|
+
deferSources?: readonly HydrationConsistencySource[];
|
|
111
|
+
maxEvents?: number;
|
|
112
|
+
};
|
|
113
|
+
type HydrationConsistencyStoreState = HydrationSnapshotMetadata & {
|
|
114
|
+
store: string;
|
|
115
|
+
authority: HydrationConsistencyAuthority;
|
|
116
|
+
policy: HydrationConsistencyPolicy;
|
|
117
|
+
baseline: unknown;
|
|
118
|
+
baselineHash: number;
|
|
119
|
+
hydratedAt: string;
|
|
120
|
+
hydratedAtMs: number;
|
|
121
|
+
firstDivergedAt: string | null;
|
|
122
|
+
firstDivergedAtMs: number | null;
|
|
123
|
+
lastDivergedAt: string | null;
|
|
124
|
+
lastDivergedAtMs: number | null;
|
|
125
|
+
lastResolution: HydrationConsistencyResolution | null;
|
|
126
|
+
lastSource: HydrationConsistencySource | null;
|
|
127
|
+
driftCount: number;
|
|
128
|
+
queuedWrites: number;
|
|
129
|
+
replayedWrites: number;
|
|
130
|
+
invalidatedAt: string | null;
|
|
131
|
+
invalidatedAtMs: number | null;
|
|
132
|
+
currentHash: number;
|
|
133
|
+
merge?: (args: HydrationMergeArgs) => unknown;
|
|
134
|
+
onInvalidate?: (args: HydrationInvalidateArgs) => void;
|
|
135
|
+
};
|
|
136
|
+
type HydrationConsistencyMetrics = {
|
|
137
|
+
driftEvents: number;
|
|
138
|
+
queuedWrites: number;
|
|
139
|
+
replayedWrites: number;
|
|
140
|
+
reconciliations: number;
|
|
141
|
+
invalidations: number;
|
|
142
|
+
};
|
|
143
|
+
type HydrationDeferredWrite = {
|
|
144
|
+
id: number;
|
|
145
|
+
store: string;
|
|
146
|
+
source: HydrationConsistencySource;
|
|
147
|
+
enqueuedAtMs: number;
|
|
148
|
+
apply: () => void;
|
|
149
|
+
};
|
|
150
|
+
type HydrationRuntimeState = {
|
|
151
|
+
stores: Record<string, HydrationConsistencyStoreState>;
|
|
152
|
+
events: HydrationDriftEvent[];
|
|
153
|
+
metrics: HydrationConsistencyMetrics;
|
|
154
|
+
queue: HydrationDeferredWrite[];
|
|
155
|
+
onDrift: ((event: HydrationDriftEvent) => void) | null;
|
|
156
|
+
maxEvents: number;
|
|
157
|
+
deferSources: Set<HydrationConsistencySource>;
|
|
158
|
+
bootWindowMode: HydrationBootWindowMode | null;
|
|
159
|
+
bootWindowActive: boolean;
|
|
160
|
+
bootWindowStartedAtMs: number | null;
|
|
161
|
+
bootWindowEndsAtMs: number | null;
|
|
162
|
+
bootWindowTimer: ReturnType<typeof setTimeout> | null;
|
|
163
|
+
bootWindowToken: number | null;
|
|
164
|
+
replaying: boolean;
|
|
165
|
+
sequence: number;
|
|
166
|
+
};
|
|
167
|
+
|
|
168
|
+
export type { HydrationSnapshotMetadata as H, HydrationConsistencyAuthority as a, HydrationConsistencyPolicy as b, HydrationConsistencyResolution as c, HydrationConsistencySource as d, HydrationConsistencyMetrics as e, HydrationBootWindowMode as f, HydrationDriftEvent as g, HydrationRuntimeState as h, HydrationBootWindowControl as i, HydrationConsistencyOptions as j, HydrationBootWindowOptions as k, HydrationConsistencyContract as l, HydrationConsistencyStoreContract as m, HydrationConsistencyStorePolicy as n, HydrationInvalidateArgs as o, HydrationMergeArgs as p };
|
|
@@ -39,4 +39,4 @@ interface ComputedDescriptor {
|
|
|
39
39
|
asyncBoundary?: boolean;
|
|
40
40
|
}
|
|
41
41
|
|
|
42
|
-
export type { ComputedClassification, ComputedDescriptor, RuntimeEdgeType
|
|
42
|
+
export type { ComputedClassification as C, RuntimeGraph as R, ComputedDescriptor as a, RuntimeEdgeType as b, RuntimeGraphEdge as c, RuntimeGraphGranularity as d, RuntimeGraphNode as e, RuntimeNodeId as f, RuntimeNodeType as g };
|
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
import { T as TraceContext } from './utility.js';
|
|
2
2
|
|
|
3
|
+
/**
|
|
4
|
+
* @module adapters/options/types
|
|
5
|
+
*
|
|
6
|
+
* LAYER: Module
|
|
7
|
+
* OWNS: Shared option and config types for store adapters.
|
|
8
|
+
*/
|
|
9
|
+
|
|
3
10
|
type StoreValue = unknown;
|
|
4
11
|
interface FeatureOptionsMap {
|
|
5
12
|
}
|
|
@@ -12,6 +19,7 @@ interface PersistDriver {
|
|
|
12
19
|
}
|
|
13
20
|
type StoreScope = "request" | "global" | "temp";
|
|
14
21
|
type SnapshotMode = "deep" | "shallow" | "ref";
|
|
22
|
+
type ResetCloneMode = "deep" | "shallow" | "none";
|
|
15
23
|
type ValidateFn<State = StoreValue> = (next: State) => boolean | State;
|
|
16
24
|
type SchemaValidateOption = {
|
|
17
25
|
safeParse: (value: unknown) => {
|
|
@@ -153,7 +161,7 @@ interface SyncOptions {
|
|
|
153
161
|
* Optional guard to prevent rapid feedback loops when sync updates trigger local reactions.
|
|
154
162
|
*
|
|
155
163
|
* - true: enable with a default window (100ms)
|
|
156
|
-
* -
|
|
164
|
+
* - `windowMs`: customize the guard window in milliseconds
|
|
157
165
|
* - false: disable (default is enabled when sync is truthy)
|
|
158
166
|
*/
|
|
159
167
|
loopGuard?: boolean | {
|
|
@@ -251,18 +259,25 @@ interface StoreOptions<State = StoreValue> {
|
|
|
251
259
|
* Snapshot cloning strategy used by subscriptions and selector snapshots.
|
|
252
260
|
*
|
|
253
261
|
* - "deep" (default): deep clone and dev-freeze snapshot values.
|
|
254
|
-
* - "shallow": shallow clone (top-level) only
|
|
255
|
-
* - "ref": return the live store reference
|
|
262
|
+
* - "shallow": shallow clone (top-level) only, then shallow-freeze the snapshot envelope.
|
|
263
|
+
* - "ref": return the live store reference with a shallow-frozen snapshot envelope.
|
|
256
264
|
*/
|
|
257
265
|
snapshot?: SnapshotMode;
|
|
266
|
+
/**
|
|
267
|
+
* Clone strategy used by resetStore(...) when restoring the initial snapshot.
|
|
268
|
+
* - "deep" (default): deep clone initial snapshot (safest).
|
|
269
|
+
* - "shallow": clone top-level container only.
|
|
270
|
+
* - "none": reuse initial snapshot reference.
|
|
271
|
+
*/
|
|
272
|
+
resetClone?: ResetCloneMode;
|
|
258
273
|
/**
|
|
259
274
|
* Safety policy for snapshot deliveries when using "ref" or "shallow" modes.
|
|
260
|
-
* - "warn": (default) log a warning
|
|
261
|
-
* - "throw": throw an error
|
|
262
|
-
* - "auto-clone":
|
|
275
|
+
* - "warn": (default) log a warning when mutation is detected.
|
|
276
|
+
* - "throw": throw an error when mutation is detected.
|
|
277
|
+
* - "auto-clone": if a subscriber mutates a frozen snapshot, deliver a cloned
|
|
263
278
|
* snapshot to that subscriber so the mutation does not affect other subscribers or the store.
|
|
264
279
|
*/
|
|
265
|
-
snapshotSafety?:
|
|
280
|
+
snapshotSafety?: "warn" | "throw" | "auto-clone";
|
|
266
281
|
}
|
|
267
282
|
interface NormalizedOptions {
|
|
268
283
|
scope: StoreScope;
|
|
@@ -277,7 +292,7 @@ interface NormalizedOptions {
|
|
|
277
292
|
onCreate?: (initial: StoreValue) => void;
|
|
278
293
|
onError?: (err: string) => void;
|
|
279
294
|
validate?: ValidateOption;
|
|
280
|
-
migrations: Record<number, (state:
|
|
295
|
+
migrations: Record<number, (state: StoreValue) => StoreValue>;
|
|
281
296
|
version: number;
|
|
282
297
|
redactor?: (state: StoreValue) => StoreValue;
|
|
283
298
|
historyLimit: number;
|
|
@@ -285,11 +300,12 @@ interface NormalizedOptions {
|
|
|
285
300
|
sync?: boolean | SyncOptions;
|
|
286
301
|
features?: FeatureOptions;
|
|
287
302
|
snapshot: SnapshotMode;
|
|
303
|
+
resetClone: ResetCloneMode;
|
|
288
304
|
/** normalized snapshotSafety value */
|
|
289
|
-
snapshotSafety?:
|
|
305
|
+
snapshotSafety?: "warn" | "throw" | "auto-clone";
|
|
290
306
|
explicitPersist: boolean;
|
|
291
307
|
explicitSync: boolean;
|
|
292
308
|
explicitDevtools: boolean;
|
|
293
309
|
}
|
|
294
310
|
|
|
295
|
-
export type { FeatureOptions as F, MiddlewareCtx as M, NormalizedOptions as N,
|
|
311
|
+
export type { DevtoolsOptions as D, FeatureOptions as F, LifecycleOptions as L, MiddlewareCtx as M, NormalizedOptions as N, PersistConfig as P, ResetCloneMode as R, StoreOptions as S, ValidateFn as V, StoreValue as a, SnapshotMode as b, FeatureOptionsMap as c, PersistDriver as d, PersistOptions as e, SchemaValidateOption as f, StoreScope as g, SyncMessage as h, SyncOptions as i, ValidateOption as j };
|
package/dist/types.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { i as HydrationBootWindowControl } from './types-internal-2.js';
|
|
2
|
+
|
|
1
3
|
/**
|
|
2
4
|
* @module store-lifecycle/types
|
|
3
5
|
*
|
|
@@ -6,11 +8,13 @@
|
|
|
6
8
|
*
|
|
7
9
|
* Consumers: Internal imports and public API.
|
|
8
10
|
*/
|
|
11
|
+
|
|
9
12
|
type Primitive = string | number | boolean | bigint | symbol | null | undefined;
|
|
10
13
|
type PrevDepth = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
|
|
11
14
|
type PathInternal<T, Depth extends number> = Depth extends 0 ? never : T extends Primitive ? never : {
|
|
12
15
|
[K in keyof T & (string | number)]: T[K] extends Primitive | Array<unknown> ? `${K}` : `${K}` | `${K}.${PathInternal<T[K], PrevDepth[Depth]>}`;
|
|
13
16
|
}[keyof T & (string | number)];
|
|
17
|
+
type PathDepth<T, Depth extends number> = PathInternal<T, Depth>;
|
|
14
18
|
type Path<T, Depth extends number = 10> = PathInternal<T, Depth>;
|
|
15
19
|
type PathValue<T, P extends Path<T>> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? Rest extends Path<T[K]> ? PathValue<T[K], Rest> : never : never : P extends keyof T ? T[P] : never;
|
|
16
20
|
type PartialDeep<T> = T extends Primitive ? T : unknown extends T ? T : {
|
|
@@ -36,7 +40,13 @@ type HydrationResult = {
|
|
|
36
40
|
reason: HydrationBlockReason;
|
|
37
41
|
cause?: unknown;
|
|
38
42
|
};
|
|
43
|
+
/**
|
|
44
|
+
* Present when post-hydration consistency enabled an active boot window.
|
|
45
|
+
* Use it to inspect or close timer/manual deferral after `hydrateStores(...)`.
|
|
46
|
+
*/
|
|
47
|
+
bootWindow?: HydrationBootWindowControl;
|
|
39
48
|
};
|
|
49
|
+
|
|
40
50
|
interface StoreStateMap {
|
|
41
51
|
}
|
|
42
52
|
interface StrictStoreMap {
|
|
@@ -59,7 +69,7 @@ type WriteResult = {
|
|
|
59
69
|
ok: true;
|
|
60
70
|
} | {
|
|
61
71
|
ok: false;
|
|
62
|
-
reason: "not-found" | "validate" | "path" | "middleware" | "ssr" | "invalid-args" | "lazy-uninitialized";
|
|
72
|
+
reason: "not-found" | "no-initial-state" | "validate" | "path" | "middleware" | "ssr" | "invalid-args" | "lazy-uninitialized" | "unsupported-op" | "unsupported-path-shape";
|
|
63
73
|
};
|
|
64
74
|
|
|
65
|
-
export type { HydrateSnapshotFor as H, PartialDeep as P, StoreValue as S, WriteResult as W, StoreDefinition as a, StoreKey as b, StoreStateMap as c, StoreName as d, StateFor as e, StrictStoreMap as f, HydrationResult as g,
|
|
75
|
+
export type { BrandedStoreName as B, HydrateSnapshotFor as H, PartialDeep as P, RegisteredStoreMap as R, StoreValue as S, WriteResult as W, StoreDefinition as a, StoreKey as b, StoreStateMap as c, StoreName as d, StateFor as e, StrictStoreMap as f, HydrationResult as g, HydrationBlockReason as h, HydrationFailure as i, HydrationFailureReason as j, Path as k, PathDepth as l, PathInternal as m, PathValue as n, PrevDepth as o, Primitive as p };
|