@tinkered/core 0.23.1 → 0.24.0

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/README.md CHANGED
@@ -935,6 +935,62 @@ of a part asks for it, and the guard runs at each ask. `board.invalidate`
935
935
  marks parts dirty on either side. With `load`, the server reads each part
936
936
  from a store and keeps no member (`docs/keyed-projector.md`).
937
937
 
938
+ ### A window: order and limit
939
+
940
+ A `where` read takes a window as its second argument (ADR 0139
941
+ decision 2). The store sorts and cuts. Core does not.
942
+
943
+ ```ts
944
+ import {
945
+ data,
946
+ operation,
947
+ remoteData,
948
+ } from "@tinkered/core";
949
+ import { z } from "zod";
950
+
951
+ type Task = {
952
+ project: string;
953
+ id: string;
954
+ created: number;
955
+ };
956
+
957
+ const tasks = data({
958
+ label: "tasks",
959
+ mode: "keyed",
960
+ key: (t: Task) => ({ project: t.project, id: t.id }),
961
+ });
962
+ const board = remoteData({ tasks });
963
+
964
+ const loadTasks = operation({
965
+ label: "tasks.load",
966
+ input: z.object({
967
+ project: z.string(),
968
+ order: z.enum(["-created"]).optional(),
969
+ limit: z.number().max(50).optional(),
970
+ }),
971
+ // The store sorts by input.order, cuts at input.limit.
972
+ run: async (_, { input }): Promise<Task[]> => [],
973
+ });
974
+
975
+ board({ serve: true, load: { tasks: loadTasks } });
976
+
977
+ const newest = tasks.where(
978
+ { project: "p1" },
979
+ { order: "-created", limit: 50 },
980
+ );
981
+ ```
982
+
983
+ - The board's `load` gets the part and the window as one input. A
984
+ window its input does not take is `refused`.
985
+ - A window keeps the store's order. Its members go in the one cell,
986
+ so `of(key)` sees them.
987
+ - A signal in the part, or an `invalidate` of the part, asks each
988
+ window of it again.
989
+ - A window does not ride its whole part, and the whole part does not
990
+ ride a window.
991
+ - A new window starts `pending`, with no rows.
992
+ - A board with no `load` fails a window (`failed`): nothing sorts.
993
+
938
994
  ## Derived
939
995
 
940
996
  A derived computes a value from its sources (ADR 0150). It is declared
@@ -1268,6 +1324,10 @@ Titles that name no user-facing guarantee (type checks, budgets, past-bug regres
1268
1324
  - With a load, the server keeps no member.
1269
1325
  - `board.part(call)` gives a guard the part of a keyed join or ask, typed;
1270
1326
  any other call gives `undefined`.
1327
+ - A window read is one more read of its part: the store's order and
1328
+ limit, in its own list. Two windows of one part keep two lists.
1329
+ - A member that leaves a window stays for a reader of its key.
1330
+ - An empty window answer empties its part in the cell.
1271
1331
  - `board.status(read)` gives a part's state: `pending` until its first
1272
1332
  answer, then `ready` or `fault`; `undefined` when no reader holds it.
1273
1333
  - A part that rides a ready part is `ready` at once.
package/dist/index.d.mts CHANGED
@@ -152,6 +152,7 @@ type Job<D = Cells> = {
152
152
  readonly read?: never;
153
153
  } | {
154
154
  readonly read: Read;
155
+ readonly refetchInterval?: Intervals<D>;
155
156
  readonly serve?: never;
156
157
  };
157
158
  /** The lifecycle hooks go to the wire: rpc runs them, on each side, per key. */
@@ -161,6 +162,9 @@ type Config<D = Cells> = Job<D> & Hooks;
161
162
  * input says which fields a part must have. With a load, the server keeps no member.
162
163
  */
163
164
  type Loads<D> = { readonly [K in keyof D as D[K] extends Data.Keyed<any, any> ? K : never]?: Operation.Handle<D[K] extends Data.Cell<infer L> ? L | PromiseLike<L> : never, any>; };
165
+ /** By keyed key: how often, in ms, a part in use asks again (ADR 0139 3). With none, it never
166
+ * does by time: TanStack's `refetchInterval` is off by default too. */
167
+ type Intervals<D> = { readonly [K in keyof D as D[K] extends Data.Keyed<any, any> ? K : never]?: number; };
164
168
  /**
165
169
  * A keyed definition's first value for one parameter, per key: an op the server runs in a call
166
170
  * tagged with the parameter, when a client asks for a parameter no write has given yet. With no
@@ -201,6 +205,7 @@ export declare function remoteData<const D extends Cells, const P extends Readon
201
205
  readonly fill: Edge<"optional", Tag.Handle<Readonly<Record<string, Operation.Handle<unknown, void>>>>>;
202
206
  readonly load: Edge<"optional", Tag.Handle<Readonly<Record<string, Operation.Handle<unknown, any> | undefined>>>>;
203
207
  readonly read: Edge<"optional", Tag.Handle<Read>>;
208
+ readonly refetchInterval: Edge<"optional", Tag.Handle<Readonly<Record<string, number | undefined>>>>;
204
209
  }, {
205
210
  drop: Operation.Handle<void, void>;
206
211
  invalidate: Operation.Handle<Promise<void>, Dirty<D>>;
package/dist/index.mjs CHANGED
@@ -1 +1 @@
1
- import{a as e,c as t,d as n,f as r,g as i,h as a,i as o,l as s,n as c,o as l,r as u,s as d,t as f,u as p}from"./src-Cw-s8dYD.mjs";import{a as m,i as h,n as g,o as _,r as v,t as y}from"./rpc-BS1Kd6Fl.mjs";export{f as LEVELS,g as bytes,c as capsule,v as channel,u as createScope,o as data,e as derived,h as execution,a as isError,l as isStarting,d as namespace,t as operation,i as originOf,s as parse,p as readMany,y as remoteData,n as resource,m as rpc,r as tag,_ as transport};
1
+ import{a as e,c as t,d as n,f as r,g as i,h as a,i as o,l as s,n as c,o as l,r as u,s as d,t as f,u as p}from"./src-Cw-s8dYD.mjs";import{a as m,i as h,n as g,o as _,r as v,t as y}from"./rpc-DrJH8icM.mjs";export{f as LEVELS,g as bytes,c as capsule,v as channel,u as createScope,o as data,e as derived,h as execution,a as isError,l as isStarting,d as namespace,t as operation,i as originOf,s as parse,p as readMany,y as remoteData,n as resource,m as rpc,r as tag,_ as transport};
@@ -0,0 +1 @@
1
+ import{t as e}from"./rolldown-runtime-DK3Fl9T5.mjs";import{_ as t,c as n,d as r,f as i,i as a,l as o,n as s}from"./src-Cw-s8dYD.mjs";function c(e){return{"~standard":{version:1,vendor:`tinker`,validate:e},check:e,optional:()=>Object.assign(c(t=>t===void 0?{value:void 0}:e(t)),{isOptional:!0})}}const l=e=>({issues:[{message:e}]});function u(e,t){let n=e[`~standard`].validate(t);return n instanceof Promise?l(`an async schema cannot check a protocol value`):n.issues?{issues:n.issues}:{value:n.value}}const d=()=>{let e=e=>c(t=>typeof t==`string`?e&&!e.test(t)?l(`expected ${String(e)}`):{value:t}:l(`expected a string`));return Object.assign(e(),{regex:t=>e(t)})},f=()=>c(e=>({value:e})),p=()=>c(e=>e===null?{value:null}:l(`expected null`)),m=(e,t=`unexpected value`)=>c(n=>e(n)?{value:n}:l(t));function h(e,t){return c(n=>{if(typeof n!=`object`||!n||Array.isArray(n))return l(`expected an object`);let r={};for(let[i,a]of Object.entries(n)){if(u(e,i).issues)return l(`bad key "${i}"`);let n=u(t,a);if(n.issues)return{issues:n.issues};r[i]=n.value}return{value:r}})}function g(e){return c(t=>{if(!Array.isArray(t))return l(`expected an array`);let n=[];for(let r of t){let t=u(e,r);if(t.issues)return{issues:t.issues};n.push(t.value)}return{value:n}})}function _(e){return Object.assign(c(t=>{if(typeof t!=`object`||!t)return l(`expected an object`);let n={};for(let[r,i]of Object.entries(e)){let e=u(i,t[r]);if(e.issues)return{issues:e.issues.map(e=>({...e,path:[r,...e.path??[]]}))};(e.value!==void 0||r in t)&&(n[r]=e.value)}return{value:n}}),{shape:e,extend:t=>_({...e,...t})})}const v=Symbol(`refused`),y=m(e=>typeof e==`function`),b=m(e=>[`output`,`refused`,`error`].includes(String(Object(e).kind))),x={start:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),refuse:y}),success:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),output:f()}),error:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),error:f(),refuse:y}),finish:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),outcome:b})},S={role:`handler`,explain:`A lifecycle hook`},C=r({label:`protocol.lifecycle`,target:`scope`,factory:()=>{let e=e=>({[v]:!0,payload:e}),t=e=>typeof e==`object`&&!!e&&v in e,n=e=>typeof Object(e).run==`object`,r=e=>n(e)?e.run:e,i=(e,t)=>[...e??[],...t??[]],a=(e,t)=>({onStart:i(e.onStart,t.onStart),onSuccess:i(e.onSuccess,t.onSuccess),onError:i(e.onError,t.onError),onFinish:i(e.onFinish,t.onFinish)}),s=(e,t)=>n(t)?t.inherit===!1?{...a({},t),retry:t.retry??{}}:{...a(e,t),retry:t.retry??e.retry}:e,c=(e,t,n,r)=>Promise.resolve(e.run(t,{input:{key:e.key,input:e.input,meta:n.meta,context:n.context,...r},...n.tags.length?{tags:n.tags}:{}},S)),l=(e,t)=>{let n=t;e.meta={...e.meta,...n.meta},e.context={...e.context,...n.context},e.tags=[...e.tags,...n.tags??[]]},u=async(n,r,i)=>{for(let a of r.onStart??[]){let r=await c(n,a,i,{refuse:e});if(r!==void 0){if(t(r))return r;l(i,r)}}},d=(e,t,n)=>{let r=typeof e.kind==`function`?e.kind(t):e.kind,i=e.reply?r:void 0;return{kind:i,runs:i?n[i]??0:0}},f=(e,t)=>e.reply&&e.shape?o(e.shape,t):t,p=async(e,t,n)=>{let r={...t.retry};for(;;){let t;try{t=await e.last(n.meta,n.tags)}catch(t){let{kind:n,runs:i}=d(e,t,r);if(!n||i<1||e.signal?.aborted)throw t;r[n]=i-1;continue}n.output=f(e,t);return}},m=async(e,t,n)=>{for(let r of t.onSuccess??[]){let t=await c(e,r,n,{output:n.output});t!==void 0&&(n.output=t)}},h=async(n,r,i,a)=>{let o=a;for(let a of r.onError??[]){let r;try{r=await c(n,a,i,{error:o,refuse:e})}catch(e){o=e;continue}if(r!==void 0){if(t(r))return{kind:`refused`,value:r};if(!n.reply)throw TypeError(`onError cannot recover a stream`);return{kind:`output`,output:r}}}return{kind:`error`,error:o}},g=async(e,t,n)=>{try{let r=await u(e,t,n);return r?{kind:`refused`,value:r}:(await p(e,t,n),e.reply&&await m(e,t,n),{kind:`output`,output:n.output})}catch(r){return h(e,t,n,r)}},_=(e,t)=>{if(t.kind!==`output`||!e.reply||!e.shape)return t;try{return{kind:`output`,output:o(e.shape,t.output)}}catch(e){return{kind:`error`,error:e}}},y=async(e,t,n)=>{try{return _(e,await g(e,t,n))}catch(e){return{kind:`error`,error:e}}},b=e=>e.kind===`output`?{kind:`output`,output:e.output}:e.kind===`refused`?{kind:`refused`,payload:e.value.payload}:{kind:`error`,error:e.error},x=e=>{if(e.kind===`refused`)return e.value;if(e.kind===`error`)throw e.error;return e.output};return{refuse:e,isRefused:t,isOwn:n,runOf:r,hooksOf:s,runHooks:async(e,t,n,r,i,a,o={})=>{let s={run:e,key:n,input:r,reply:o.reply??!0,signal:o.signal,shape:o.shape,kind:o.kind,last:a},l={meta:i,tags:o.tags??[],context:{},output:void 0},u=await y(s,t,l),d=b(u);for(let e of t.onFinish??[])await c(s,e,l,{outcome:d});return x(u)},parts:{both:i,listsOf:a,hookOf:c,moreOf:l,startOf:u,againOf:d,checkedOf:f,workOf:p,successOf:m,errorsOf:h,onceOf:g,shapeOf:_,settleOf:y,outcomeOf:b,endOf:x}}}}),w=h(d().regex(/^[a-z0-9-]+$/),d()),T=m(e=>e instanceof AbortSignal).optional(),E=m(e=>typeof Object(e).stream==`function`&&typeof Object(e).type==`string`),D=E.optional(),O=_({address:d(),text:d(),meta:w,body:D}),k=O.extend({push:m(e=>typeof e==`function`),left:T}),A=e=>({ok:!1,kind:e.kind,payload:{sent:Object(e).sent}}),j=_({address:d(),value:f(),meta:w,body:D}),ee=j.extend({push:m(e=>typeof e==`function`),left:T}),M={role:`state`,explain:`The transport's own side`},N=new WeakMap,P={role:`handler`,explain:`One layer down`},te=r({label:`protocol`,target:`scope`,factory:()=>{let e=(e,t,n)=>Promise.resolve(e.run(t,n,P)),t={serialize:e=>JSON.stringify(e??null),deserialize:e=>JSON.parse(e)},n=e=>e?{traceparent:`00-${e.traceId}-${e.spanId}-${e.sampled?`01`:`00`}`}:{},r=e=>e.present?e.value:void 0,i=(e,t)=>String(e.names?.(t)||e.label),a=(e,t,n,r)=>{let a=new Map;for(let o of e)for(let e of o.addresses){let s=a.get(e);if(!s){a.set(e,o);continue}let c=i(o,e),l={address:e,services:[i(s,e),c]};r&&t(`DuplicateAddress`,l),n.warn(`protocol duplicate address`,{address:e,winner:l.services[0],shadowed:c})}return a},o=(e,t,n)=>{let r=(e,r,i)=>(n.log.error(`protocol ${e} failed`,{address:r,side:t,cause:String(i),stack:String(Object(i).stack??``)}),{ok:!1,kind:e,payload:{side:t}}),i=(t,n)=>{try{return{ok:!0,value:e.serialize(n)}}catch(e){return r(`encode`,t,e)}},a=(t,n)=>{try{return{ok:!0,value:e.deserialize(n)}}catch(e){return r(`decode`,t,e)}};return{fault:r,encode:i,decode:a,answerText:(t,n)=>{let r=i(t,n);return r.ok?r.value:e.serialize(r)},replyOf:(e,t)=>{let n=a(e,t);return n.ok?n.value:n}}},s=async(t,n,r)=>{let i=async()=>t.meta?{...r,...await e(n,t.meta,{})}:r;return{meta:await i(),metaNow:i,renewed:(r,i)=>{let a=t.renew;if(!a)return Promise.resolve(!1);let o=N.get(t);if(o)return o;let s=e(n,a,{input:{payload:r,sent:i}}).catch(()=>!1).finally(()=>N.delete(t));return N.set(t,s),s}}},c=async(t,n,r)=>{let{encode:i,replyOf:a}=o(t.codec,`client`,n),{address:c,body:l}=r,{meta:u,metaNow:f,renewed:p}=await s(t,n,r.meta),m=i(c,r.value);if(!m.ok)return m;let h=r=>e(n,t.send,{input:{address:c,text:m.value,meta:r,...l?{body:l}:{}},signal:n.signal}).then(e=>e.ok?a(c,e.text):A(e),d(n,c)),g=await h(u);return g.ok||g.kind!==`refused`||!await p(g.payload,u)?g:f().then(h)},l=async(t,n,r)=>{let{encode:i,replyOf:a}=o(t.codec,`client`,n),{address:c,push:l}=r,{signal:u}=n,{meta:f,renewed:p}=await s(t,n,r.meta),m=i(c,r.value);if(!m.ok)return l(m);let h=await e(n,t.open,{input:{address:c,text:m.value,meta:f,push:e=>{let t=a(c,e);!t.ok&&t.kind===`refused`&&p(t.payload,f),l(t)}},signal:u}).then(e=>e.ok?e:A(e),d(n,c));!h.ok&&!u?.aborted&&l(h)},u=(e,t,n)=>r=>(e.log.error(`protocol service failed`,{address:t,cause:String(r),stack:String(Object(r).stack??``)}),{ok:!1,kind:`failed`,payload:n?{side:n}:{}}),d=(e,t)=>n=>e.signal?.aborted?A({ok:!1,kind:`link`,sent:!0}):u(e,t,`client`)(n);return{run:e,json:t,traceparent:n,given:r,routesOf:a,coding:o,asking:s,callOver:c,watchOver:l,broke:u,serveText:async(t,n,r)=>{let{codec:i,routes:a}=t,{decode:s,answerText:c}=o(i,`server`,n),{address:l,meta:d,body:f}=r,p=s(l,r.text);if(!p.ok)return i.serialize(p);let m=a.get(l);if(!m)return null;let h=await e(n,m.answer,{input:{address:l,value:p.value,meta:d,...f?{body:f}:{}},signal:n.signal}).catch(u(n,l));return h===null?null:c(l,h)},streamText:async(t,n,r)=>{let{codec:i,routes:a}=t,{decode:s,answerText:c}=o(i,`server`,n),{address:l,meta:d,push:f,left:p}=r,m=s(l,r.text);if(!m.ok)return f(i.serialize(m)),!0;let h=e=>f(c(l,e)),g=a.get(l);return g?e(n,g.stream,{input:{address:l,value:m.value,meta:d,left:p,push:h}}).catch(e=>(h(u(n,l)(e)),!0)):!1}}}}),F=i({label:`request`}),ne=i({label:`request.stop`}),re=/^00-(?!0{32})[0-9a-f]{32}-(?!0{16})[0-9a-f]{16}-[0-9a-f]{2}$/;function I(e){if(typeof e!=`string`||!re.test(e))return null;let[,t=``,n=``,r=``]=e.split(`-`);return{traceId:t,parentSpanId:n,sampled:(Number.parseInt(r,16)&1)==1}}var ie=e({bodyShape:()=>E,callInput:()=>j,hook:()=>x,kept:()=>M,lifecycle:()=>C,lost:()=>A,openInput:()=>k,protocol:()=>te,request:()=>F,requestStop:()=>ne,sendInput:()=>O,traceparentOf:()=>I,watchInput:()=>ee});const L=i({label:`rpc.channel`}),R=Symbol(`rpc.bytes`),z=(e,{max:t,types:n=[`application/octet-stream`]})=>{if(!Number.isSafeInteger(t)||t<=0||n.length===0)throw TypeError(`bytes: max is a positive whole number, and types lists one at least`);return Object.assign(e,{[R]:{max:t,types:n}})},B={role:`handler`,explain:`Sends through the protocol`},V={role:`handler`,explain:`Runs the implementation`},H={role:`state`,explain:`The rpc steps of this root`},ae=[`answer`,`stream`,`fault`],U=Symbol(`rpc.fault`),oe=i({label:`execution`}),se=r({label:`rpc.steps`,target:`scope`,depends:{flow:C},factory:({flow:e})=>{let t=e=>({retry:e.retry,onStart:e.onStart,onSuccess:e.onSuccess,onError:e.onError,onFinish:e.onFinish}),n=e=>t=>e.fault.is(t)?t.fault:void 0,r=(e,t,n,r,i,a)=>e.fault.make(t,n,r,i,a),i=(e,t,n,r)=>{let i=[],a=()=>{},o=!1,s,c=!1,l=e(e=>(i.push(e),a())).finally(()=>(o=!0,a()));return{get meta(){return s},stop(e){c=!0,l.catch(()=>void 0),r?.(e),a()},async*[Symbol.asyncIterator](){try{for(;;){if(c)return;let e=i.shift();if(e?.ok)s=e.meta,yield t(e.value);else if(e)throw n(e);else if(o)return void await l;else await new Promise(e=>a=e)}}finally{l.catch(()=>void 0),r?.()}}}},a=(e,t,n)=>{let r=e.bytesOf[t];if(!r)return{address:t,value:n};let{[r.field]:i,...a}=n,o=i.type.split(`;`)[0].trim().toLowerCase(),s=r.types.includes(o)?o:r.types[0];return{address:t,value:a,body:i.type===s?i:new Blob([i],{type:s})}},s=(e,t)=>{let n=e.bytesOf[t.address];return n?{...Object(t.value),[n.field]:t.body}:t.value},c=(t,n,r)=>{n.remote.present===n.implement.present&&r(`MissingConfig`,{label:t.name,key:`implement | remote`});let i=n.implement.present?n.implement.value:{},a=n.implement.present?t.keys.find(t=>!i[t]||!e.runOf(i[t])):void 0;a&&r(`MissingConfig`,{label:t.name,key:`implement.${a}`})},l=(e,t,n)=>{let r=u(e.contracts[t].input,n),i=e.bytesOf[t]?.field;return r.issues||i===void 0?r:E.check(Object(r.value)[i]).issues?{issues:[{message:`expected bytes`,path:[i]}]}:r},d=(e,{call:t,raise:n},r)=>{let i=t&&`input`in t?t.input:t?.rawInput,a=l(e,r,i);return a.issues?n(`DataValidationFailed`,{address:r,issues:a.issues}):a.value},f=(s,c,l)=>{let{call:u,run:f,config:p,raise:m,log:h,obs:g}=c,_=g.span?.traceId,v=s.contracts[l];if(!p.remote.present)return m(`MissingConfig`,{label:s.name,key:`remote`});let y=p.remote.value,b=d(s,c,l),x=(v.mode??`reply`)===`reply`;if(!x&&!y.watch)return m(`MissingConfig`,{label:s.name,key:`remote.watch`});let S=y.watch,C=(e,t)=>(e.kind!==`refused`&&h.warn(`${s.name} fault`,{address:l,fault:e.kind,execution:t}),r(s,l,e.kind,e.payload,_,t));return e.runHooks(f,e.hooksOf(t(p),void 0),l,b,{},async(e,t)=>{let n=t.length?{tags:t}:{},r=u?.signal;if(x){let t=c.random.uuid(),i={...a(s,l,b),meta:{...e,execution:t}},o=await f(y.call,{input:i,signal:r,...n},B);if(!o.ok)throw C(o,t);return o.value}let d=new AbortController;return i(t=>Promise.resolve(f(S,{input:{address:l,value:b,meta:e,push:t},signal:d.signal,...n},B)).catch(e=>{if(s.fault.is(e))throw e;if(!d.signal.aborted)throw h.error(`${s.name} bug`,{address:l,cause:String(e)}),C({ok:!1,kind:`failed`,payload:{side:`client`}})}),e=>o(v.output,e),C,e=>d.abort(e))},{reply:x,signal:u?.signal,shape:v.output,kind:n(s)}).then(t=>{if(e.isRefused(t))throw r(s,l,`refused`,t.payload,_);return t})},p=(n,a,s)=>{let{call:c,run:l,config:u,raise:f,obs:p}=a,m=p.span?.traceId,h=n.contracts[s],g=d(n,a,s);if(!u.implement.present)return f(`MissingConfig`,{label:n.name,key:`implement`});let _=u.implement.value[s],v=e.runOf(_),y=(h.mode??`reply`)===`reply`;return e.runHooks(l,e.hooksOf(t(u),_),s,g,{},async(e,t)=>{if(y){let e={input:g,signal:a.signal,...t.length?{tags:t}:{}};return l(v,e,V)}let u=new AbortController;return c?.signal?.addEventListener(`abort`,()=>u.abort(),{once:!0}),i(e=>{let n=L({send:(t,n)=>e({ok:!0,value:o(h.output,t),...n?{meta:n}:{}}),closed:u.signal});return Promise.resolve(l(v,{input:g,tags:[...t,n]},V))},e=>e,e=>r(n,s,e.kind,e.payload,m),()=>u.abort())},{reply:y,signal:a.signal,shape:h.output,kind:`failed`}).then(t=>{if(e.isRefused(t))throw r(n,s,`refused`,t.payload,m);return t})},m=(e,t,n,r)=>i=>(t.obs.event(`${e.name}.failed`,{address:n}),t.log.error(`${e.name} call failed`,{address:n,execution:r,cause:String(i),stack:String(Object(i).stack??``)}),{ok:!1,kind:`failed`,payload:{}}),h=t=>e.isRefused(t)?{ok:!1,kind:`refused`,payload:t.payload}:{ok:!0,value:t},g=(e,t)=>{let n={ok:!1,kind:`invalid`,payload:{}};return e?Promise.resolve(n):Promise.resolve(t(n)).then(()=>!0)},_=(e,t)=>{let{op:n,config:r}=t,{input:i,rawInput:a}=t.call??{},o=i??a,c=n===e.answer;if(!r.implement.present||!Object.hasOwn(e.contracts,o.address))return Promise.resolve(c?null:!1);let u=l(e,o.address,s(e,o)),d=c?y:b;return u.issues?g(c,o.push):d(e,t,o,u.value)},v=({execution:e})=>e&&/^[\w-]{1,64}$/.test(e)?[oe(e)]:[],y=(n,r,{address:i,meta:a},o)=>{if(n.contracts[i].mode===`stream`)return Promise.resolve(null);let{run:s,config:c}=r,l=c.implement.present?c.implement.value[i]:void 0,u=e.runOf(l),d=n.contracts[i];return e.runHooks(s,e.hooksOf(t(c),l),i,o,a,(e,t)=>{let n=[...t,...v(a)];return Promise.resolve(s(u,{input:o,signal:r.signal,...n.length?{tags:n}:{}},V))},{reply:!0,signal:r.signal,shape:d.output,kind:`failed`}).then(h).catch(m(n,r,i,a.execution))},b=(n,r,{address:i,meta:a,push:s,left:c},l)=>{let{run:u,config:d}=r,f=n.contracts[i];if(f.mode!==`stream`)return Promise.resolve(!1);let p=d.implement.present?d.implement.value[i]:void 0,g=e.runOf(p),_=L({send:(e,t)=>s({ok:!0,value:o(f.output,e),...t?{meta:t}:{}}),closed:c??r.signal??new AbortController().signal});return e.runHooks(u,e.hooksOf(t(d),p),i,l,a,(e,t)=>Promise.resolve(u(g,{input:l,tags:[...t,_]},V)),{reply:!1,kind:`failed`}).then(t=>(e.isRefused(t)&&s(h(t)),!0),e=>(s(m(n,r,i)(e)),!0))};return{split:a,joined:s,faultOf:r,kindOf:n,hooksIn:t,pull:i,check:c,inputOf:d,sendKey:f,runHere:p,failedAt:m,answeredAs:h,invalid:g,serve:_,answerHere:y,streamHere:b}}});function ce(e,{label:t=`rpc`}={}){let r=Object.keys(e),o=r.find(e=>ae.includes(e));if(o)throw Error(`${t}: "${o}" is a reserved key`);let c=Object.fromEntries(r.flatMap(n=>{let r=Object(Object(e[n].input).shape),i=Object.keys(r).filter(e=>Object(r[e])[R]);if(i.length>1||i.length&&e[n].mode===`stream`)throw Error(`${t}: "${n}" takes bytes in one field at most, and only as a reply key`);let a=i[0];return a?[[n,{field:a,...Object(r[a])[R]}]]:[]})),l=Object.fromEntries(Object.entries(c).map(([e,{max:t,types:n}])=>[e,{max:t,types:n}])),u={},f={is:e=>Object(e)[U]===u,make:(e,t,n,r,i)=>{let{side:a,sent:o}=Object(n),s=t===`link`||a===`client`;return Object.assign(Error(`${e}: ${t}${r?` (trace ${r})`:``}`),{[U]:u,address:e,fault:t,from:s?`local`:`server`,...s&&{sent:o??(t!==`encode`&&t!==`invalid`)},payload:n,traceId:r,...i&&{execution:i}})}},p=Object.fromEntries(r.map(t=>[t,n({label:t,input:e[t].input,run:()=>{throw Error(`${t}: no rpc capsule`)}})])),m=new Map(r.map(e=>[p[e],e])),g=i({label:`${t}.retry`,default:{}}),v=i({label:`${t}.onStart`,default:[]}),y=i({label:`${t}.onSuccess`,default:[]}),b=i({label:`${t}.onError`,default:[]}),x=i({label:`${t}.onFinish`,default:[]}),S=i({label:`${t}.remote`}),C=i({label:`${t}.implement`}),w=n({label:`${t}.answer`,input:j,run:()=>{throw Error(`${t} does not serve here`)}}),T=n({label:`${t}.stream`,input:ee,run:()=>{throw Error(`${t} does not serve here`)}}),E=n({label:`${t}.receive`,input:_({key:d(),meta:h(d(),d()).optional()}),run:(e,{input:t,obs:n})=>{n.span&&Object.assign(n.span.attributes,{"messaging.operation.type":`process`,"messaging.destination.name":t.key});let r=t.meta?.traceparent;return r&&n.event(`link`,{traceparent:r}),n.span?.traceId}}),D={name:t,contracts:e,keys:r,bytesOf:c,fault:f,answer:w,stream:T,receive:E},O=a({label:`${t}.steps`,initial:null}),k={remote:S.optional,implement:C.optional,retry:g,onStart:v,onSuccess:y,onError:b,onFinish:x},A=s({label:t,config:k,exports:{...p,answer:w,stream:T},hooks:{async start({config:e,load:t,next:n,raise:r}){let i=await t(se,H);return i.check(D,e,r),t(O,H).set(i),n()},run(e){let t=m.get(e.op),n=e.op===w||e.op===T;if(t===void 0&&!n)return e.next();let r=e.load(O,H).get();return t===void 0?r.serve(D,e):(e.config.remote.present?r.sendKey:r.runHere)(D,e,t)}}});return Object.assign(A,{fault:f,receive:E,addresses:r,uploads:l})}const W=e=>JSON.stringify(typeof e==`string`?e:Object.keys(e).sort().map(t=>[t,e[t]])),G=(e,t)=>`${e}\u0000${t.read===`of`?`o`:`w`}${W(t.part)}${t.window?W(t.window):``}`,K=(e,t)=>e.read===`of`?W(e.part)===W(t):Object.keys(e.part).every(n=>Object(t)[n]===Object(e.part)[n]),le=e=>typeof e==`string`||typeof e==`object`&&!!e&&!Array.isArray(e)&&Object.values(e).every(e=>typeof e==`string`||typeof e==`number`&&Number.isFinite(e)),q=c(e=>{let{read:t,part:n,window:r}=Object(e);return t!==`of`&&t!==`where`||!le(n)||r!=null&&(typeof r!=`object`||!le(r))?l(`expected an ask`):{value:{read:t,part:n,window:r}}}),J=(e,t)=>{let n=e.part;if(typeof t==`string`||typeof n==`string`)return W(n)===W(t)?e:void 0;let r={...n,...t};if(W(r)===W(n))return e;if(!(e.read===`of`||Object.keys(n).some(e=>n[e]!==r[e])))return e.window?e:{read:`where`,part:r}},ue=(e,t)=>e.window||t.window?G(``,e)===G(``,t):!!J(e,t.part),de=e=>Object(e).keyed.key,fe=(e,t)=>{let n=[G(e,{read:`of`,part:t})];if(typeof t==`string`)return n;let r=t,i=Object.keys(r);for(let t=0;t<1<<i.length;t++){let a=Object.fromEntries(i.filter((e,n)=>t&1<<n).map(e=>[e,r[e]]));n.push(G(e,{read:`where`,part:a}))}return n},Y={role:`state`,explain:`Remote data of this root`},X={role:`handler`,explain:`Sends one write to its watchers`},Z={role:`handler`,explain:`Reads one key's stream`},Q=`remoteData`,pe=`answer stream drop invalidate fault faults part status states`.split(` `),me=(e,t,n)=>{let r=Object.keys(t),i=r.filter(t=>t in e||pe.includes(t));if(i.length)throw Error(`remoteData: config ${i.join(`, `)} is a cell or reserved key`);let a=Object.keys(e).filter(e=>pe.includes(e));if(a.length)throw Error(`remoteData: ${a.join(`, `)} is a reserved key`);if(!r.length)return null;if(n.size)throw Error(`remoteData: a keyed cell takes no config`);return t},he=e=>{if(e.mode===`single`)return a({initial:e.initial,parse:e.parse,eq:(t,n)=>e.eq(t,n)});let t=Object(e).keyed;return a({mode:`keyed`,key:t.key,parse:t.parse,eq:t.eq})},ge=(e,t,n,r)=>e.wire.fault.is(n)?n:(r.error(`remoteData bug`,{address:t,cause:String(n)}),e.wire.fault.make(t,`failed`,{side:`client`})),$=r({label:`remoteData.steps`,target:`scope`,factory:()=>{let e=e=>JSON.stringify(Object.keys(e).sort().map(t=>[t,e[t]])),n=(t,n)=>n===null?t:`${t}\u0000${e(n)}`,r=(e,t,n)=>{let r=e.cells[t].parse;if(!r)return{ok:!0,value:n};try{return{ok:!0,value:o(r,n)}}catch(e){return{ok:!1,why:String(Object(e).kind??e)}}},i=(e,{load:t,next:n,config:r,run:i})=>{let a=new Map(e.keys.map(n=>[n,t(e.cells[n],Y)])),o=new Map(e.keys.map(n=>[n,t(e.made[n],Y)]));for(let t of e.keys){let n=a.get(t).get();e.keyed.has(t)?o.get(t).adopt(n):o.get(t).set(n)}let s=(t,n)=>{let a=r.fill.present?r.fill.value[t]:void 0;if(!a)return;let o=Object.entries(e.by).map(([e,t])=>t(n[e]));return Promise.resolve(i(a,{tags:o},X))},c=r.load.present?r.load.value:{};return t(e.state,Y).set({roots:a,copies:o,watchers:new Map,held:new Map,fill:s,parts:new Map,pass:new Map,loads:c,load:(e,t,n)=>{let r=c[e];return r&&Promise.resolve(i(r,{rawInput:t,signal:n},X))}}),n()},a=async(e,t,r,i)=>{if(i===null)return t.roots.get(r).get();let a=n(r,i);return t.held.has(a)?t.held.get(a):await t.fill(r,i)??e.cells[r].initial},s=async(e,t,r,i,o)=>{let s=n(r,i),c=t.watchers.get(s)??new Map;t.watchers.set(s,c);let l=new Promise(e=>{let n=()=>{if(!c.delete(o.send))return e();c.size===0&&(t.watchers.delete(s),i!==null&&t.held.delete(s)),e()};c.set(o.send,n),o.closed.aborted?n():o.closed.addEventListener(`abort`,n,{once:!0})}),u=await a(e,t,r,i);return i!==null&&c.size>0&&!t.held.has(s)&&t.held.set(s,u),o.send(i===null?u:t.held.get(s)??u),l},c=(e,t,n,r)=>{let i=G(t,n),a=e.watchers.get(i)??new Map;e.watchers.set(i,a);let o=new Promise(t=>{let o=()=>{a.delete(r.send)&&a.size===0&&(e.watchers.delete(i),e.parts.delete(i)),t()};e.parts.set(i,n),a.set(r.send,o),r.closed.aborted?o():r.closed.addEventListener(`abort`,o,{once:!0})});return r.send(n),o},l=(e,n,r,i,a)=>{let o=n.load(r,i.window?{...Object(i.part),...i.window}:i.part,a);if(o){let t=de(e.cells[r]);return o.then(e=>e.filter(e=>K(i,t(e))))}i.window&&t(`MissingConfig`,{label:Q,key:`load`});let s=n.roots.get(r);if(i.read===`where`)return s.where(i.part).get();let c=s.of(i.part).get();return c===void 0?[]:[c]},u=e=>{let t=[...e.pass],n=e.sent;e.pass.clear(),e.sent=void 0;for(let[r,{at:i,dirty:a}]of t)e.watchers.get(i)?.has(r)&&r(a.size===1?[...a.values()][0]:e.parts.get(i),n)},d=(e,t,n,r)=>{e.pass.size===0&&queueMicrotask(()=>u(e));let i=e.pass.get(n)??{at:t,dirty:new Map};e.pass.set(n,i),i.dirty.set(G(``,r),r)},f=(e,t,n)=>{let r=n===void 0?[...e.parts.keys()].filter(e=>e.startsWith(`${t}\u0000`)):fe(t,n);for(let t of r){let r=e.parts.get(t);for(let i of e.watchers.get(t)?.keys()??[])d(e,t,i,n===void 0?r:{read:`of`,part:n})}},p=(e,t,n)=>{for(let[r,i]of e.parts){let a=r.startsWith(`${t}\u0000`)?J(i,n):void 0;if(a!==void 0)for(let t of e.watchers.get(r).keys())d(e,r,t,a)}},m=new Map,h=(e,t)=>t.entry?t.entry.faults:t.load(e.faults,Y).get(),g=(e,t,n,i,a)=>{let{run:o,clock:s,log:c}=t,l=(t,r)=>{if(a.aborted)return;let i=h(e,n);if(!r&&!Object.hasOwn(i,t))return;let o={...i};r?o[t]=r:delete o[t],n.entry?(n.entry.faults=o,n.entry.listeners.forEach(e=>e())):n.load(e.faults,Y).set(o)},u=(t,i,a)=>{let o=r(e,t,i);if(!o.ok)return c.error(`remoteData value refused`,{address:t,why:o.why}),l(t,e.wire.fault.make(t,`invalid`,{side:`client`},a));n.entry?(n.entry.values.set(t,o.value),n.entry.listeners.forEach(e=>e())):n.load(e.made[t],Y).set(o.value),l(t,null)},d=async(t,n)=>{let r=new AbortController;try{let s=await o(e.wire[t],{input:i},Z);a.addEventListener(`abort`,()=>s.stop(a.reason),{once:!0,signal:r.signal}),a.aborted&&s.stop(a.reason);for await(let r of s){let i=await o(e.wire.receive,{input:{key:t,meta:s.meta}},Z);u(t,r,i),n()}return null}catch(n){return ge(e,t,n,c)}finally{r.abort()}};return{mark:l,set:u,round:d,loop:async(t,r)=>{for(let i=50;!a.aborted;){let o=await d(t,r);if(!a.aborted&&o&&l(t,o),r(),a.aborted)break;i=Object.hasOwn(h(e,n),t)?Math.min(i*2,5e3):50,await s.sleep(i,a).catch(()=>void 0)}}}},_=new Map,v=(e,t)=>Promise.all(e.keys.filter(t=>!e.keyed.has(t)).map(e=>new Promise(n=>{t.loop(e,n)}))),y=(t,n,r,i)=>{let a=_.get(t),o=e(n),s=a.entries.get(o);if(!s){let e={refs:0,values:new Map,faults:{},listeners:new Set,stop:new AbortController};s=e,a.entries.set(o,e);let r={entry:e,load:a.event.load};a.event.signal.addEventListener(`abort`,()=>e.stop.abort(a.event.signal.reason),{once:!0,signal:e.stop.signal}),v(t,g(t,a.event,r,n,e.stop.signal))}let c=s,l=()=>{if(!i?.aborted){for(let[e,n]of c.values){let i=t.made[e];(r?r.controller(i):a.event.load(i,Y)).set(n)}(r?r.controller(t.faults):a.event.load(t.faults,Y)).set(c.faults)}};return c.refs++,c.listeners.add(l),l(),()=>{c.listeners.delete(l),!(--c.refs>0)&&(c.stop.abort(),a.entries.delete(o))}},b=(e,t,n,r)=>{let{run:i,clock:a,signal:o,log:s,config:c}=t,l=c.refetchInterval.value?.[n],u=t.load(e.made[n],Y),d=new Map,f=t.load(e.states,Y),p=(e,t)=>{if(!o.aborted)for(let r of d.values())ue(e,r.ask)&&(e.window||K(e,r.ask.part))&&f.set({...t,at:G(n,r.ask)})},h=e=>[...d.values()].some(t=>K(t.ask,e)),g=new Set,_=e=>!o.aborted&&[...d.values()].some(t=>J(t.ask,e.part)),v=de(e.made[n]),y=(e,t)=>{let n={ask:e,later:[],signalled:t};for(let t of g)ue(t.ask,e)&&t.later.push(n);return g.add(n),n.done=b(n),n.done},b=async t=>{let{read:r,part:a}=t.ask,o=e=>t.later.some(t=>K(t.ask,e)),s=t.signalled&&{ask:t.ask,meta:t.signalled.meta},c=await Promise.resolve().then(()=>s?i(e.takes[n],{input:s},Z):i(e.wire[`${n}.ask`],{input:t.ask},Z)).then(e=>()=>{let n=e.filter(e=>!o(v(e)));u.answer(r,a,n,o,t.ask.window)},e=>()=>{throw e});g.delete(t),!o(a)&&_(t.ask)&&x(t.ask,c),await Promise.all(t.later.map(e=>e.done))},x=(t,i)=>{try{i(),r(n,null),p(t,{status:`ready`})}catch(i){let a=G(n,t),o=e.wire.fault.is(i)?i:e.wire.fault.make(a,`invalid`,{side:`client`},void 0);r(n,o),p(t,{status:`fault`,fault:o})}},S=async e=>{let t=new Map;for(let r of d.values()){let i=r.rides?void 0:J(r.ask,e);i&&r.wake?r.wake():i&&t.set(G(n,i),i)}await Promise.all([...t.values()].map(e=>y(e)))},C=m.get(e)??new Map;m.set(e,C.set(n,S));let w=async e=>{await new Promise(t=>{e.wake=t,e.stop.signal.addEventListener(`abort`,()=>t(),{once:!0})}),e.wake=void 0},T=async t=>{for(let o=50;!t.stop.signal.aborted;){try{let r=await i(e.wire[n],{input:t.ask},Z);t.stop.signal.addEventListener(`abort`,()=>r.stop(),{once:!0});for await(let e of r)y(e,{meta:r.meta});o=50}catch(i){if(t.stop.signal.aborted)return;let a=ge(e,n,i,s);if(r(n,a),p(t.ask,{status:`fault`,fault:a}),a.fault!==`link`){await w(t),o=50;continue}o=Math.min(o*2,5e3)}await a.sleep(o,t.stop.signal).catch(()=>void 0)}},E=e=>[...d.values()].find(t=>t.ask!==e&&!t.ask.window&&!e.window&&K(t.ask,e.part)),D=async(e,t)=>{for(;;)await a.sleep(t,e.stop.signal),e.wake?e.wake():y(e.ask)},O=e=>{o.addEventListener(`abort`,()=>e.stop.abort(),{once:!0,signal:e.stop.signal}),T(e),l&&D(e,l).catch(()=>void 0)};u.listen((e,t,r)=>{let i=r?{read:e,part:t,window:r}:{read:e,part:t},a=G(n,i),s=d.get(a)??{refs:0,ask:i,stop:new AbortController};if(s.refs++===0){s.rides=E(i),d.set(a,s);let e=s.rides&&f.of({at:G(n,s.rides.ask)}).get();o.aborted||f.set({...e??{status:`pending`},at:a}),s.rides||O(s)}return()=>{if(!(--s.refs>0)){s.stop.abort(),d.delete(a),o.aborted||f.delete({at:a});for(let e of d.values())e.rides===s&&(e.rides=E(e.ask),e.rides||O(e));o.aborted||u.answer(e,t,[],h,r)}}})};return{named:e,keep:v,reader:g,valueOf:a,faultsIn:h,slot:n,fits:r,serveStart:i,watch:s,watchPart:c,answerPart:l,changed:f,invalidate:async(e,t,n,r)=>{if(t)return p(t,n,r);await m.get(e)?.get(n)?.(r)},readStart:async(t,n)=>{let{config:r,raise:i,next:a,load:o,signal:s}=n;if(!r.read.present)return i(`MissingConfig`,{label:Q,key:`read`});if(t.by){_.set(t,{event:n,entries:new Map,root:null});let r=await o(t.paramOf,Y);return r!==null&&(_.get(t).root=e(r),y(t,r,null)),a()}let c=g(t,n,{entry:null,load:o},null,s);for(let e of t.keyed)b(t,n,e,c.mark);return await v(t,c),a()},join:y,guardKeyed:(e,t)=>{let n=Object.values(e.cells);return Object.values(Object(Object(t.op).depends)).some(e=>Object(e).kind===`controller`&&n.includes(Object(e).target))?t.load(e.missingOf,Y).then(e=>e===null?t.next():t.raise(`MissingTag`,{label:e})):t.next()},isReading:e=>_.has(e),rootParam:e=>_.get(e)?.root??null}}});function _e(e,{config:t={}}={}){let u=Object.keys(e),h=new Set(u.filter(t=>e[t].mode===`keyed`)),v=me(e,t,h),y=Object.keys(t),b=new Map(u.map(t=>[e[t],t])),S=Object.fromEntries(u.map(t=>[t,he(e[t])])),C=v===null?p():c(e=>{if(typeof e!=`object`||!e)return l(`expected the parameter`);try{return{value:Object.fromEntries(Object.entries(v).map(([t,n])=>[t,n(Object(e)[t]).value]))}}catch{return l(`the parameter does not fit its tags`)}}),w=ce(Object.fromEntries(u.flatMap(e=>h.has(e)?[[e,{mode:`stream`,input:q,output:f()}],[`${e}.ask`,{mode:`reply`,input:q,output:f()}]]:[[e,{mode:`stream`,input:C,output:f()}]])),{label:Q}),T=i({label:`${Q}.serve`}),E=i({label:`${Q}.fill`}),D=i({label:`${Q}.load`}),O=i({label:`${Q}.read`}),k=i({label:`${Q}.refetchInterval`}),A=Object.fromEntries(Object.entries(t).map(([e,t])=>[e,t.optional])),j=r({label:`${Q}.param`,target:`session`,depends:A,factory:e=>{if(!v)return null;let t={};for(let n of y){if(!e[n]?.present)return null;t[n]=e[n].value}return t}}),ee=r({label:`${Q}.missing`,target:`session`,depends:A,factory:e=>{let n=y.find(t=>!e[t]?.present);return n===void 0?null:t[n].label}}),M=a({label:`${Q}.state`,initial:null}),N=a({label:`${Q}.faults`,initial:{}}),P=a({label:`${Q}.states`,mode:`keyed`,key:e=>({at:e.at})}),F={cells:e,made:S,keys:u,wire:w,state:M,faults:N,states:P,by:v,paramOf:j,missingOf:ee,keyed:h,takes:Object.fromEntries([...h].map(e=>[e,n({label:`${Q}.receive`,depends:{answer:w[`${e}.ask`].controller},run:({answer:t},{input:n,obs:r})=>{r.span&&Object.assign(r.span.attributes,{"messaging.operation.type":`process`,"messaging.destination.name":e});let i=n.meta?.traceparent;return i&&r.event(`link`,{traceparent:i}),t.run({input:n.ask})}})]))},ne=Object.fromEntries(u.flatMap(e=>h.has(e)?[[e,n({label:`${Q}.watch`,input:q,depends:{out:L,own:M,s:$},run:({out:t,own:n,s:r},{input:i})=>r.watchPart(n,e,i,t)})],[`${e}.ask`,n({label:`${Q}.ask`,input:q,depends:{own:M,s:$},run:({own:t,s:n},{input:r,signal:i})=>n.answerPart(F,t,e,r,i)})]]:[[e,n({label:`${Q}.watch`,input:C,depends:{out:L,own:M,s:$},run:({out:t,own:n,s:r},{input:i})=>r.watch(F,n,e,i??null,t)})]])),re=n({label:`${Q}.drop`,depends:{own:M},run:({own:e})=>{for(let t of e?.watchers.values()??[])for(let e of Array.from(t.values()))e()}}),I=n({label:`${Q}.send`,input:_({key:d()}),depends:{served:M,protocol:te},run:({served:e,protocol:t},{input:n,obs:r})=>{e?.pass.size&&!e.sent&&(r.span&&Object.assign(r.span.attributes,{"messaging.operation.type":`send`,"messaging.destination.name":n.key}),e.sent=t.traceparent(r.span))}}),ie=n({label:`${Q}.invalidate`,input:c(e=>Object.entries(Object(e)).every(([e,t])=>h.has(e)&&le(t))?{value:e}:l(`expected keyed keys and their parts`)),depends:{own:M,s:$,send:I.controller},run:async({own:e,s:t,send:n},{input:r})=>{let i=Object.entries(r).map(([n,r])=>t.invalidate(F,e,n,r));for(let e of Object.keys(r))n.run({input:{key:e}});await Promise.all(i)}}),R=n({label:`${Q}.fits`,input:x.start,depends:{own:M},run:({own:e},{input:t})=>{let n=e.loads[t.key.replace(/\.ask$/,``)]?.input,{part:r,window:i}=Object(t.input);try{n&&o(n,i?{...Object(r),...i}:r);return}catch{return t.refuse({part:r})}}}),z=new Set,B=(e,t,n,r)=>{if(!h.has(t)){e.roots.get(t).set(n),e.copies.get(t).set(n);return}let i=n,a=e.roots.get(t);if(e.loads[t])return r.changed(e,t,a.step(i));r.changed(e,t,a.adopt(i)),e.copies.get(t).adopt(i)},V=n({label:`${Q}.send`,input:_({key:d(),value:f(),watchers:g(m(e=>typeof e==`function`))}),depends:{protocol:te},run:({protocol:e},{input:t,obs:n,log:r})=>{n.span&&Object.assign(n.span.attributes,{"messaging.operation.type":`send`,"messaging.destination.name":t.key,"messaging.batch.message_count":t.watchers.length});let i=e.traceparent(n.span);for(let e of t.watchers)try{e(t.value,i)}catch(e){r.error(`remoteData push failed`,{address:t.key,cause:String(e)})}}}),H=a({label:`${Q}.steps`,initial:null}),ae=s({label:Q,config:{serve:T.optional,fill:E.optional,load:D.optional,read:O.optional,refetchInterval:k.optional},exports:{...S,faults:N,states:P,drop:re,invalidate:ie},hooks:{async start(e){let{config:t,load:n,raise:r}=e;t.serve.present===t.read.present&&r(`MissingConfig`,{label:Q,key:`serve | read`});let i=await n($,Y);n(H,Y).set(i);let a=e;return t.serve.present?i.serveStart(F,a):i.readStart(F,a)},run(e){return!v||!e.load(M,Y).get()?e.next():e.load(H,Y).get().guardKeyed(F,e)},async session({handle:e,next:t,load:n}){if(!v)return t();let r=n(H,Y).get();if(!r||!r.isReading(F))return t();let i=e.resolve(j);if(i===null||r.rootParam(F)===r.named(i))return t();let a=new AbortController,o=r.join(F,i,e,a.signal);try{return await t()}finally{a.abort(),o()}},write({cell:e,value:t,next:n,load:r,run:i,log:a}){let o=b.get(e);if(o===void 0)return n();let s=r(M,Y).get();if(!s)return n();if(v){n(),r(j,Y).then(e=>{if(e===null){a.error(`remoteData keyed write with no parameter`,{address:o});return}let n=`${o}\u0000${r(H,Y).get().named(e)}`,c=[...s.watchers.get(n)?.keys()??[]];if(c.length)return s.held.set(n,t),i(V,{input:{key:o,value:t,watchers:c}},X)}).catch(e=>a.error(`remoteData send failed`,{address:o,cause:String(e)}));return}if(z.has(e))return n();z.add(e);try{B(s,o,t,r(H,Y).get())}finally{z.delete(e)}if(h.has(o))return void i(I,{input:{key:o}},X);let c=[...s.watchers.get(o)?.keys()??[]];i(V,{input:{key:o,value:t,watchers:c}},X).catch(e=>a.error(`remoteData send failed`,{address:o,cause:String(e)}))}}}),U=({retry:e,onStart:t,onSuccess:n,onError:r,onFinish:i,...a})=>{let o=`load`in a&&a.load?[R,...t??[]]:t,s=Object.fromEntries(Object.entries({retry:e,onStart:o,onSuccess:n,onError:r,onFinish:i}).filter(([,e])=>e));return[w(`serve`in a&&a.serve?{implement:ne,...s}:{remote:a.read,...s}),ae(a)]};return Object.defineProperties(U,Object.getOwnPropertyDescriptors(ae)),Object.assign(U,{fault:{is:e=>w.fault.is(e)},part:e=>h.has(e.key.replace(/\.ask$/,``))?Object(e.input).part:void 0,status:e=>{let t=Object.keys(S).find(t=>S[t]===e.cell);return P.of({at:G(t,e)})},addresses:u.flatMap(e=>h.has(e)?[e,`${e}.ask`]:[e]),names:t=>e[t.replace(/\.ask$/,``)]?.label.replace(/^anon$/,``),answer:w.answer,stream:w.stream,...t})}export{ce as a,oe as i,z as n,ie as o,L as r,_e as t};
package/dist/testing.mjs CHANGED
@@ -1 +1 @@
1
- import{c as e,f as t,i as n,m as r,n as i,p as a}from"./src-Cw-s8dYD.mjs";import{o}from"./rpc-BS1Kd6Fl.mjs";const s=Symbol(`preset`),{callInput:c,kept:l,openInput:u,protocol:d,request:f,requestStop:p,sendInput:m,traceparentOf:h,watchInput:g}=o,_={ok:!1,kind:`link`,sent:!1},v={ok:!1,kind:`missing`},y={ok:!1,kind:`link`,sent:!0},b=(e,t,n,r)=>{let i=new Request(`http://memory/${n.address}`,{headers:t});try{return e.createSession({trace:h({...n.meta,...r}.traceparent),tags:[f(i),p(i.signal)]})}catch{return null}},x=(e,t)=>({...e,left:AbortSignal.any([e.left??t,t]),push:n=>t.aborted||e.push(n)}),S=(e,t)=>t.then(t=>e.aborted?void 0:t),C=n({label:`memory.served`,initial:null});function w(){let r=e({label:`memory.serve`,input:m,run:()=>{throw Error(`memory: no server here`)}}),a=e({label:`memory.serveStream`,input:u,run:()=>{throw Error(`memory: no server here`)}}),o=t({label:`memory.peer`}),s=t({label:`memory.headers`,default:{}}),f={codec:t({label:`memory.codec`}).optional,meta:t({label:`memory.meta`}).optional,renew:t({label:`memory.renew`}).optional},p=e({label:`memory.send`,input:m,depends:{peer:o.required,headers:s,protocol:d},run:async({peer:e,headers:t,protocol:n},{input:r,obs:i})=>{let a=b(e,t,r,n.traceparent(i.span));if(!a)return _;let o=a.resolve(C);if(!o)return await a.close(),_;let s=await a.run(o.serve,{input:r}).finally(()=>a.close());return s===void 0?y:s===null?v:{ok:!0,text:s}}}),h=e({label:`memory.open`,input:u,depends:{peer:o.required,headers:s,protocol:d},run:async({peer:e,headers:t,protocol:n},{input:r,signal:i,obs:a})=>{let o=b(e,t,r,n.traceparent(a.span));if(!o)return _;let s=o.resolve(C);return s?o.run(s.serveStream,{input:{...r,left:i}}).then(e=>e===void 0?y:e?{ok:!0}:v).finally(()=>o.close()):(await o.close(),_)}}),w=e({label:`memory.call`,input:c,run:()=>{throw Error(`memory: no transport here`)}}),T=e({label:`memory.watch`,input:g,run:()=>{throw Error(`memory: no transport here`)}}),E=n({label:`transport.client`,initial:null}),D=i({label:`memory`,config:{peer:o.required,headers:s,...f},exports:{call:w,watch:T},hooks:{async start({config:e,load:t,next:n}){let r=await t(d,l),{codec:i,meta:a,renew:o}=e;return t(E,l).set({protocol:r,side:{send:p,open:h,codec:r.given(i)??r.json,meta:r.given(a),renew:r.given(o)}}),n()},run(e){let{op:t,call:n}=e;if(t!==w&&t!==T)return e.next();let{run:r,log:i,load:a}=e,{side:o,protocol:s}=a(E,l).get(),c={run:r,log:i,signal:n?.signal},u=n?.input??n?.rawInput;return t===w?s.callOver(o,c,u):s.watchOver(o,c,u)}}}),O=n({label:`transport.server`,initial:null});return{client:D,server:i({label:`memory.server`,config:{codec:t({label:`memory.codec`}).optional,services:t({label:`memory.services`}).required,strict:t({label:`memory.strict`,default:!0})},exports:{serve:r,serveStream:a},hooks:{async start({config:e,load:t,next:n,raise:i,log:o}){let s=await t(d,l),c=s.routesOf(e.services,i,o,e.strict),u={codec:s.given(e.codec)??s.json,routes:c};return t(O,l).set({side:u,protocol:s}),t(C,l).set({serve:r,serveStream:a}),n()},run(e){let{op:t,call:n}=e;if(t!==r&&t!==a)return e.next();let{run:i,log:o,load:s,closing:c}=e,{side:u,protocol:d}=s(O,l).get(),f={run:i,log:o,signal:n?.signal},p=Object(n?.input??n?.rawInput);return S(c,t===r?d.serveText(u,f,p):d.streamText(u,f,x(p,c)))}}})}}const T=w();function E(e){let t=Math.trunc(e);return BigInt(t)*1000000n+BigInt(Math.round((e-t)*1e6))}function D(e){let t=e?.now??0,n=new Set,r=()=>{for(let e of[...n].sort((e,t)=>e.at-t.at))e.at<=t&&(n.delete(e),e.wake())};return{currentTimeMillis:()=>Math.trunc(t),currentTimeNanos:()=>E(t),sleep:(e,r)=>new Promise((i,a)=>{if(r?.aborted)return a(r.reason);if(e<=0)return i();let o={at:t+e,wake:i};if(n.add(o),r){let e=()=>{n.delete(o),a(r.reason)};o.wake=()=>{r.removeEventListener(`abort`,e),i()},r.addEventListener(`abort`,e,{once:!0})}}),advance:e=>{t+=e,r()},setTime:e=>{t=e,r()}}}function O(e){let t=(e?.seed??0)>>>0,n=()=>{t=t+1831565813>>>0;let e=Math.imul(t^t>>>15,1|t);return e=e+Math.imul(e^e>>>7,61|e)^e,((e^e>>>14)>>>0)/4294967296},i={next:n,uuid:()=>{let e=``;for(let t=0;t<16;t++){let r=Math.trunc(n()*256)&255;t===6&&(r=r&15|64),t===8&&(r=r&63|128),e+=r.toString(16).padStart(2,`0`),(t===3||t===5||t===7||t===9)&&(e+=`-`)}return e}},o={a:(e?.seed??0)|0,b:362436069,c:521288629,d:88675123};for(let e=0;e<8;e++)a(o);return r.set(i,o),i}function k(e,t){return{[s]:!0,node:e,replacement:t}}export{w as createMemory,D as makeTestClock,O as makeTestRandom,T as memory,k as preset};
1
+ import{c as e,f as t,i as n,m as r,n as i,p as a}from"./src-Cw-s8dYD.mjs";import{o}from"./rpc-DrJH8icM.mjs";const s=Symbol(`preset`),{callInput:c,kept:l,openInput:u,protocol:d,request:f,requestStop:p,sendInput:m,traceparentOf:h,watchInput:g}=o,_={ok:!1,kind:`link`,sent:!1},v={ok:!1,kind:`missing`},y={ok:!1,kind:`link`,sent:!0},b=(e,t,n,r)=>{let i=new Request(`http://memory/${n.address}`,{headers:t});try{return e.createSession({trace:h({...n.meta,...r}.traceparent),tags:[f(i),p(i.signal)]})}catch{return null}},x=(e,t)=>({...e,left:AbortSignal.any([e.left??t,t]),push:n=>t.aborted||e.push(n)}),S=(e,t)=>t.then(t=>e.aborted?void 0:t),C=n({label:`memory.served`,initial:null});function w(){let r=e({label:`memory.serve`,input:m,run:()=>{throw Error(`memory: no server here`)}}),a=e({label:`memory.serveStream`,input:u,run:()=>{throw Error(`memory: no server here`)}}),o=t({label:`memory.peer`}),s=t({label:`memory.headers`,default:{}}),f={codec:t({label:`memory.codec`}).optional,meta:t({label:`memory.meta`}).optional,renew:t({label:`memory.renew`}).optional},p=e({label:`memory.send`,input:m,depends:{peer:o.required,headers:s,protocol:d},run:async({peer:e,headers:t,protocol:n},{input:r,obs:i})=>{let a=b(e,t,r,n.traceparent(i.span));if(!a)return _;let o=a.resolve(C);if(!o)return await a.close(),_;let s=await a.run(o.serve,{input:r}).finally(()=>a.close());return s===void 0?y:s===null?v:{ok:!0,text:s}}}),h=e({label:`memory.open`,input:u,depends:{peer:o.required,headers:s,protocol:d},run:async({peer:e,headers:t,protocol:n},{input:r,signal:i,obs:a})=>{let o=b(e,t,r,n.traceparent(a.span));if(!o)return _;let s=o.resolve(C);return s?o.run(s.serveStream,{input:{...r,left:i}}).then(e=>e===void 0?y:e?{ok:!0}:v).finally(()=>o.close()):(await o.close(),_)}}),w=e({label:`memory.call`,input:c,run:()=>{throw Error(`memory: no transport here`)}}),T=e({label:`memory.watch`,input:g,run:()=>{throw Error(`memory: no transport here`)}}),E=n({label:`transport.client`,initial:null}),D=i({label:`memory`,config:{peer:o.required,headers:s,...f},exports:{call:w,watch:T},hooks:{async start({config:e,load:t,next:n}){let r=await t(d,l),{codec:i,meta:a,renew:o}=e;return t(E,l).set({protocol:r,side:{send:p,open:h,codec:r.given(i)??r.json,meta:r.given(a),renew:r.given(o)}}),n()},run(e){let{op:t,call:n}=e;if(t!==w&&t!==T)return e.next();let{run:r,log:i,load:a}=e,{side:o,protocol:s}=a(E,l).get(),c={run:r,log:i,signal:n?.signal},u=n?.input??n?.rawInput;return t===w?s.callOver(o,c,u):s.watchOver(o,c,u)}}}),O=n({label:`transport.server`,initial:null});return{client:D,server:i({label:`memory.server`,config:{codec:t({label:`memory.codec`}).optional,services:t({label:`memory.services`}).required,strict:t({label:`memory.strict`,default:!0})},exports:{serve:r,serveStream:a},hooks:{async start({config:e,load:t,next:n,raise:i,log:o}){let s=await t(d,l),c=s.routesOf(e.services,i,o,e.strict),u={codec:s.given(e.codec)??s.json,routes:c};return t(O,l).set({side:u,protocol:s}),t(C,l).set({serve:r,serveStream:a}),n()},run(e){let{op:t,call:n}=e;if(t!==r&&t!==a)return e.next();let{run:i,log:o,load:s,closing:c}=e,{side:u,protocol:d}=s(O,l).get(),f={run:i,log:o,signal:n?.signal},p=Object(n?.input??n?.rawInput);return S(c,t===r?d.serveText(u,f,p):d.streamText(u,f,x(p,c)))}}})}}const T=w();function E(e){let t=Math.trunc(e);return BigInt(t)*1000000n+BigInt(Math.round((e-t)*1e6))}function D(e){let t=e?.now??0,n=new Set,r=()=>{for(let e of[...n].sort((e,t)=>e.at-t.at))e.at<=t&&(n.delete(e),e.wake())};return{currentTimeMillis:()=>Math.trunc(t),currentTimeNanos:()=>E(t),sleep:(e,r)=>new Promise((i,a)=>{if(r?.aborted)return a(r.reason);if(e<=0)return i();let o={at:t+e,wake:i};if(n.add(o),r){let e=()=>{n.delete(o),a(r.reason)};o.wake=()=>{r.removeEventListener(`abort`,e),i()},r.addEventListener(`abort`,e,{once:!0})}}),advance:e=>{t+=e,r()},setTime:e=>{t=e,r()}}}function O(e){let t=(e?.seed??0)>>>0,n=()=>{t=t+1831565813>>>0;let e=Math.imul(t^t>>>15,1|t);return e=e+Math.imul(e^e>>>7,61|e)^e,((e^e>>>14)>>>0)/4294967296},i={next:n,uuid:()=>{let e=``;for(let t=0;t<16;t++){let r=Math.trunc(n()*256)&255;t===6&&(r=r&15|64),t===8&&(r=r&63|128),e+=r.toString(16).padStart(2,`0`),(t===3||t===5||t===7||t===9)&&(e+=`-`)}return e}},o={a:(e?.seed??0)|0,b:362436069,c:521288629,d:88675123};for(let e=0;e<8;e++)a(o);return r.set(i,o),i}function k(e,t){return{[s]:!0,node:e,replacement:t}}export{w as createMemory,D as makeTestClock,O as makeTestRandom,T as memory,k as preset};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tinkered/core",
3
- "version": "0.23.1",
3
+ "version": "0.24.0",
4
4
  "description": "Tinkered core: a small, fast reactive/graph dependency engine.",
5
5
  "keywords": [
6
6
  "tanstack-intent"
@@ -13,7 +13,7 @@ metadata:
13
13
  task skill to load next.
14
14
  type: core
15
15
  library: '@tinkered/core'
16
- library_version: '0.23.1'
16
+ library_version: '0.24.0'
17
17
  sources:
18
18
  - 'lagz0ne/tinkered:packages/core/src/main.ts'
19
19
  - 'lagz0ne/tinkered:docs/best-practices.md'
@@ -13,7 +13,7 @@ metadata:
13
13
  binding only.
14
14
  type: sub-skill
15
15
  library: '@tinkered/core'
16
- library_version: '0.23.1'
16
+ library_version: '0.24.0'
17
17
  requires:
18
18
  - core
19
19
  sources:
@@ -13,7 +13,7 @@ metadata:
13
13
  cell read only.
14
14
  type: sub-skill
15
15
  library: '@tinkered/core'
16
- library_version: '0.23.1'
16
+ library_version: '0.24.0'
17
17
  requires:
18
18
  - core
19
19
  sources:
@@ -13,7 +13,7 @@ metadata:
13
13
  allowed in app code.
14
14
  type: sub-skill
15
15
  library: '@tinkered/core'
16
- library_version: '0.23.1'
16
+ library_version: '0.24.0'
17
17
  requires:
18
18
  - core
19
19
  sources:
@@ -13,7 +13,7 @@ metadata:
13
13
  on the client with remote data.
14
14
  type: sub-skill
15
15
  library: '@tinkered/core'
16
- library_version: '0.23.1'
16
+ library_version: '0.24.0'
17
17
  requires:
18
18
  - core
19
19
  - capsule
@@ -144,6 +144,9 @@ const list = useData(
144
144
  the list.
145
145
  - `board.invalidate` marks a part dirty, so its
146
146
  readers ask again.
147
+ - `sea.board({ read, refetchInterval: { waves:
148
+ 30_000 } })` makes each part in use ask again
149
+ every 30 s. With none, it never asks by time.
147
150
  - A call ends at its reply, as a TanStack Query
148
151
  mutation. To see your own write at once, run
149
152
  `board.invalidate` on its part after the call.
@@ -12,7 +12,7 @@ metadata:
12
12
  and join two scopes with the memory backend.
13
13
  type: sub-skill
14
14
  library: '@tinkered/core'
15
- library_version: '0.23.1'
15
+ library_version: '0.24.0'
16
16
  requires:
17
17
  - core
18
18
  sources:
@@ -1 +0,0 @@
1
- import{t as e}from"./rolldown-runtime-DK3Fl9T5.mjs";import{_ as t,c as n,d as r,f as i,i as a,l as o,n as s}from"./src-Cw-s8dYD.mjs";function c(e){return{"~standard":{version:1,vendor:`tinker`,validate:e},check:e,optional:()=>Object.assign(c(t=>t===void 0?{value:void 0}:e(t)),{isOptional:!0})}}const l=e=>({issues:[{message:e}]});function u(e,t){let n=e[`~standard`].validate(t);return n instanceof Promise?l(`an async schema cannot check a protocol value`):n.issues?{issues:n.issues}:{value:n.value}}const d=()=>{let e=e=>c(t=>typeof t==`string`?e&&!e.test(t)?l(`expected ${String(e)}`):{value:t}:l(`expected a string`));return Object.assign(e(),{regex:t=>e(t)})},f=()=>c(e=>({value:e})),p=()=>c(e=>e===null?{value:null}:l(`expected null`)),m=(e,t=`unexpected value`)=>c(n=>e(n)?{value:n}:l(t));function h(e,t){return c(n=>{if(typeof n!=`object`||!n||Array.isArray(n))return l(`expected an object`);let r={};for(let[i,a]of Object.entries(n)){if(u(e,i).issues)return l(`bad key "${i}"`);let n=u(t,a);if(n.issues)return{issues:n.issues};r[i]=n.value}return{value:r}})}function g(e){return c(t=>{if(!Array.isArray(t))return l(`expected an array`);let n=[];for(let r of t){let t=u(e,r);if(t.issues)return{issues:t.issues};n.push(t.value)}return{value:n}})}function _(e){return Object.assign(c(t=>{if(typeof t!=`object`||!t)return l(`expected an object`);let n={};for(let[r,i]of Object.entries(e)){let e=u(i,t[r]);if(e.issues)return{issues:e.issues.map(e=>({...e,path:[r,...e.path??[]]}))};(e.value!==void 0||r in t)&&(n[r]=e.value)}return{value:n}}),{shape:e,extend:t=>_({...e,...t})})}const v=Symbol(`refused`),y=m(e=>typeof e==`function`),b=m(e=>[`output`,`refused`,`error`].includes(String(Object(e).kind))),x={start:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),refuse:y}),success:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),output:f()}),error:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),error:f(),refuse:y}),finish:_({key:d(),input:f(),meta:h(d(),d()),context:h(d(),f()),outcome:b})},S={role:`handler`,explain:`A lifecycle hook`},C=r({label:`protocol.lifecycle`,target:`scope`,factory:()=>{let e=e=>({[v]:!0,payload:e}),t=e=>typeof e==`object`&&!!e&&v in e,n=e=>typeof Object(e).run==`object`,r=e=>n(e)?e.run:e,i=(e,t)=>[...e??[],...t??[]],a=(e,t)=>({onStart:i(e.onStart,t.onStart),onSuccess:i(e.onSuccess,t.onSuccess),onError:i(e.onError,t.onError),onFinish:i(e.onFinish,t.onFinish)}),s=(e,t)=>n(t)?t.inherit===!1?{...a({},t),retry:t.retry??{}}:{...a(e,t),retry:t.retry??e.retry}:e,c=(e,t,n,r)=>Promise.resolve(e.run(t,{input:{key:e.key,input:e.input,meta:n.meta,context:n.context,...r},...n.tags.length?{tags:n.tags}:{}},S)),l=(e,t)=>{let n=t;e.meta={...e.meta,...n.meta},e.context={...e.context,...n.context},e.tags=[...e.tags,...n.tags??[]]},u=async(n,r,i)=>{for(let a of r.onStart??[]){let r=await c(n,a,i,{refuse:e});if(r!==void 0){if(t(r))return r;l(i,r)}}},d=(e,t,n)=>{let r=typeof e.kind==`function`?e.kind(t):e.kind,i=e.reply?r:void 0;return{kind:i,runs:i?n[i]??0:0}},f=(e,t)=>e.reply&&e.shape?o(e.shape,t):t,p=async(e,t,n)=>{let r={...t.retry};for(;;){let t;try{t=await e.last(n.meta,n.tags)}catch(t){let{kind:n,runs:i}=d(e,t,r);if(!n||i<1||e.signal?.aborted)throw t;r[n]=i-1;continue}n.output=f(e,t);return}},m=async(e,t,n)=>{for(let r of t.onSuccess??[]){let t=await c(e,r,n,{output:n.output});t!==void 0&&(n.output=t)}},h=async(n,r,i,a)=>{let o=a;for(let a of r.onError??[]){let r;try{r=await c(n,a,i,{error:o,refuse:e})}catch(e){o=e;continue}if(r!==void 0){if(t(r))return{kind:`refused`,value:r};if(!n.reply)throw TypeError(`onError cannot recover a stream`);return{kind:`output`,output:r}}}return{kind:`error`,error:o}},g=async(e,t,n)=>{try{let r=await u(e,t,n);return r?{kind:`refused`,value:r}:(await p(e,t,n),e.reply&&await m(e,t,n),{kind:`output`,output:n.output})}catch(r){return h(e,t,n,r)}},_=(e,t)=>{if(t.kind!==`output`||!e.reply||!e.shape)return t;try{return{kind:`output`,output:o(e.shape,t.output)}}catch(e){return{kind:`error`,error:e}}},y=async(e,t,n)=>{try{return _(e,await g(e,t,n))}catch(e){return{kind:`error`,error:e}}},b=e=>e.kind===`output`?{kind:`output`,output:e.output}:e.kind===`refused`?{kind:`refused`,payload:e.value.payload}:{kind:`error`,error:e.error},x=e=>{if(e.kind===`refused`)return e.value;if(e.kind===`error`)throw e.error;return e.output};return{refuse:e,isRefused:t,isOwn:n,runOf:r,hooksOf:s,runHooks:async(e,t,n,r,i,a,o={})=>{let s={run:e,key:n,input:r,reply:o.reply??!0,signal:o.signal,shape:o.shape,kind:o.kind,last:a},l={meta:i,tags:o.tags??[],context:{},output:void 0},u=await y(s,t,l),d=b(u);for(let e of t.onFinish??[])await c(s,e,l,{outcome:d});return x(u)},parts:{both:i,listsOf:a,hookOf:c,moreOf:l,startOf:u,againOf:d,checkedOf:f,workOf:p,successOf:m,errorsOf:h,onceOf:g,shapeOf:_,settleOf:y,outcomeOf:b,endOf:x}}}}),w=h(d().regex(/^[a-z0-9-]+$/),d()),T=m(e=>e instanceof AbortSignal).optional(),E=m(e=>typeof Object(e).stream==`function`&&typeof Object(e).type==`string`),D=E.optional(),O=_({address:d(),text:d(),meta:w,body:D}),k=O.extend({push:m(e=>typeof e==`function`),left:T}),A=e=>({ok:!1,kind:e.kind,payload:{sent:Object(e).sent}}),j=_({address:d(),value:f(),meta:w,body:D}),M=j.extend({push:m(e=>typeof e==`function`),left:T}),N={role:`state`,explain:`The transport's own side`},P=new WeakMap,F={role:`handler`,explain:`One layer down`},ee=r({label:`protocol`,target:`scope`,factory:()=>{let e=(e,t,n)=>Promise.resolve(e.run(t,n,F)),t={serialize:e=>JSON.stringify(e??null),deserialize:e=>JSON.parse(e)},n=e=>e?{traceparent:`00-${e.traceId}-${e.spanId}-${e.sampled?`01`:`00`}`}:{},r=e=>e.present?e.value:void 0,i=(e,t)=>String(e.names?.(t)||e.label),a=(e,t,n,r)=>{let a=new Map;for(let o of e)for(let e of o.addresses){let s=a.get(e);if(!s){a.set(e,o);continue}let c=i(o,e),l={address:e,services:[i(s,e),c]};r&&t(`DuplicateAddress`,l),n.warn(`protocol duplicate address`,{address:e,winner:l.services[0],shadowed:c})}return a},o=(e,t,n)=>{let r=(e,r,i)=>(n.log.error(`protocol ${e} failed`,{address:r,side:t,cause:String(i),stack:String(Object(i).stack??``)}),{ok:!1,kind:e,payload:{side:t}}),i=(t,n)=>{try{return{ok:!0,value:e.serialize(n)}}catch(e){return r(`encode`,t,e)}},a=(t,n)=>{try{return{ok:!0,value:e.deserialize(n)}}catch(e){return r(`decode`,t,e)}};return{fault:r,encode:i,decode:a,answerText:(t,n)=>{let r=i(t,n);return r.ok?r.value:e.serialize(r)},replyOf:(e,t)=>{let n=a(e,t);return n.ok?n.value:n}}},s=async(t,n,r)=>{let i=async()=>t.meta?{...r,...await e(n,t.meta,{})}:r;return{meta:await i(),metaNow:i,renewed:(r,i)=>{let a=t.renew;if(!a)return Promise.resolve(!1);let o=P.get(t);if(o)return o;let s=e(n,a,{input:{payload:r,sent:i}}).catch(()=>!1).finally(()=>P.delete(t));return P.set(t,s),s}}},c=async(t,n,r)=>{let{encode:i,replyOf:a}=o(t.codec,`client`,n),{address:c,body:l}=r,{meta:u,metaNow:f,renewed:p}=await s(t,n,r.meta),m=i(c,r.value);if(!m.ok)return m;let h=r=>e(n,t.send,{input:{address:c,text:m.value,meta:r,...l?{body:l}:{}},signal:n.signal}).then(e=>e.ok?a(c,e.text):A(e),d(n,c)),g=await h(u);return g.ok||g.kind!==`refused`||!await p(g.payload,u)?g:f().then(h)},l=async(t,n,r)=>{let{encode:i,replyOf:a}=o(t.codec,`client`,n),{address:c,push:l}=r,{signal:u}=n,{meta:f,renewed:p}=await s(t,n,r.meta),m=i(c,r.value);if(!m.ok)return l(m);let h=await e(n,t.open,{input:{address:c,text:m.value,meta:f,push:e=>{let t=a(c,e);!t.ok&&t.kind===`refused`&&p(t.payload,f),l(t)}},signal:u}).then(e=>e.ok?e:A(e),d(n,c));!h.ok&&!u?.aborted&&l(h)},u=(e,t,n)=>r=>(e.log.error(`protocol service failed`,{address:t,cause:String(r),stack:String(Object(r).stack??``)}),{ok:!1,kind:`failed`,payload:n?{side:n}:{}}),d=(e,t)=>n=>e.signal?.aborted?A({ok:!1,kind:`link`,sent:!0}):u(e,t,`client`)(n);return{run:e,json:t,traceparent:n,given:r,routesOf:a,coding:o,asking:s,callOver:c,watchOver:l,broke:u,serveText:async(t,n,r)=>{let{codec:i,routes:a}=t,{decode:s,answerText:c}=o(i,`server`,n),{address:l,meta:d,body:f}=r,p=s(l,r.text);if(!p.ok)return i.serialize(p);let m=a.get(l);if(!m)return null;let h=await e(n,m.answer,{input:{address:l,value:p.value,meta:d,...f?{body:f}:{}},signal:n.signal}).catch(u(n,l));return h===null?null:c(l,h)},streamText:async(t,n,r)=>{let{codec:i,routes:a}=t,{decode:s,answerText:c}=o(i,`server`,n),{address:l,meta:d,push:f,left:p}=r,m=s(l,r.text);if(!m.ok)return f(i.serialize(m)),!0;let h=e=>f(c(l,e)),g=a.get(l);return g?e(n,g.stream,{input:{address:l,value:m.value,meta:d,left:p,push:h}}).catch(e=>(h(u(n,l)(e)),!0)):!1}}}}),te=i({label:`request`}),ne=i({label:`request.stop`}),I=/^00-(?!0{32})[0-9a-f]{32}-(?!0{16})[0-9a-f]{16}-[0-9a-f]{2}$/;function re(e){if(typeof e!=`string`||!I.test(e))return null;let[,t=``,n=``,r=``]=e.split(`-`);return{traceId:t,parentSpanId:n,sampled:(Number.parseInt(r,16)&1)==1}}var ie=e({bodyShape:()=>E,callInput:()=>j,hook:()=>x,kept:()=>N,lifecycle:()=>C,lost:()=>A,openInput:()=>k,protocol:()=>ee,request:()=>te,requestStop:()=>ne,sendInput:()=>O,traceparentOf:()=>re,watchInput:()=>M});const L=i({label:`rpc.channel`}),R=Symbol(`rpc.bytes`),ae=(e,{max:t,types:n=[`application/octet-stream`]})=>{if(!Number.isSafeInteger(t)||t<=0||n.length===0)throw TypeError(`bytes: max is a positive whole number, and types lists one at least`);return Object.assign(e,{[R]:{max:t,types:n}})},z={role:`handler`,explain:`Sends through the protocol`},B={role:`handler`,explain:`Runs the implementation`},V={role:`state`,explain:`The rpc steps of this root`},H=[`answer`,`stream`,`fault`],oe=Symbol(`rpc.fault`),se=i({label:`execution`}),ce=r({label:`rpc.steps`,target:`scope`,depends:{flow:C},factory:({flow:e})=>{let t=e=>({retry:e.retry,onStart:e.onStart,onSuccess:e.onSuccess,onError:e.onError,onFinish:e.onFinish}),n=e=>t=>e.fault.is(t)?t.fault:void 0,r=(e,t,n,r,i,a)=>e.fault.make(t,n,r,i,a),i=(e,t,n,r)=>{let i=[],a=()=>{},o=!1,s,c=!1,l=e(e=>(i.push(e),a())).finally(()=>(o=!0,a()));return{get meta(){return s},stop(e){c=!0,l.catch(()=>void 0),r?.(e),a()},async*[Symbol.asyncIterator](){try{for(;;){if(c)return;let e=i.shift();if(e?.ok)s=e.meta,yield t(e.value);else if(e)throw n(e);else if(o)return void await l;else await new Promise(e=>a=e)}}finally{l.catch(()=>void 0),r?.()}}}},a=(e,t,n)=>{let r=e.bytesOf[t];if(!r)return{address:t,value:n};let{[r.field]:i,...a}=n,o=i.type.split(`;`)[0].trim().toLowerCase(),s=r.types.includes(o)?o:r.types[0];return{address:t,value:a,body:i.type===s?i:new Blob([i],{type:s})}},s=(e,t)=>{let n=e.bytesOf[t.address];return n?{...Object(t.value),[n.field]:t.body}:t.value},c=(t,n,r)=>{n.remote.present===n.implement.present&&r(`MissingConfig`,{label:t.name,key:`implement | remote`});let i=n.implement.present?n.implement.value:{},a=n.implement.present?t.keys.find(t=>!i[t]||!e.runOf(i[t])):void 0;a&&r(`MissingConfig`,{label:t.name,key:`implement.${a}`})},l=(e,t,n)=>{let r=u(e.contracts[t].input,n),i=e.bytesOf[t]?.field;return r.issues||i===void 0?r:E.check(Object(r.value)[i]).issues?{issues:[{message:`expected bytes`,path:[i]}]}:r},d=(e,{call:t,raise:n},r)=>{let i=t&&`input`in t?t.input:t?.rawInput,a=l(e,r,i);return a.issues?n(`DataValidationFailed`,{address:r,issues:a.issues}):a.value},f=(s,c,l)=>{let{call:u,run:f,config:p,raise:m,log:h,obs:g}=c,_=g.span?.traceId,v=s.contracts[l];if(!p.remote.present)return m(`MissingConfig`,{label:s.name,key:`remote`});let y=p.remote.value,b=d(s,c,l),x=(v.mode??`reply`)===`reply`;if(!x&&!y.watch)return m(`MissingConfig`,{label:s.name,key:`remote.watch`});let S=y.watch,C=(e,t)=>(e.kind!==`refused`&&h.warn(`${s.name} fault`,{address:l,fault:e.kind,execution:t}),r(s,l,e.kind,e.payload,_,t));return e.runHooks(f,e.hooksOf(t(p),void 0),l,b,{},async(e,t)=>{let n=t.length?{tags:t}:{},r=u?.signal;if(x){let t=c.random.uuid(),i={...a(s,l,b),meta:{...e,execution:t}},o=await f(y.call,{input:i,signal:r,...n},z);if(!o.ok)throw C(o,t);return o.value}let d=new AbortController;return i(t=>Promise.resolve(f(S,{input:{address:l,value:b,meta:e,push:t},signal:d.signal,...n},z)).catch(e=>{if(s.fault.is(e))throw e;if(!d.signal.aborted)throw h.error(`${s.name} bug`,{address:l,cause:String(e)}),C({ok:!1,kind:`failed`,payload:{side:`client`}})}),e=>o(v.output,e),C,e=>d.abort(e))},{reply:x,signal:u?.signal,shape:v.output,kind:n(s)}).then(t=>{if(e.isRefused(t))throw r(s,l,`refused`,t.payload,_);return t})},p=(n,a,s)=>{let{call:c,run:l,config:u,raise:f,obs:p}=a,m=p.span?.traceId,h=n.contracts[s],g=d(n,a,s);if(!u.implement.present)return f(`MissingConfig`,{label:n.name,key:`implement`});let _=u.implement.value[s],v=e.runOf(_),y=(h.mode??`reply`)===`reply`;return e.runHooks(l,e.hooksOf(t(u),_),s,g,{},async(e,t)=>{if(y){let e={input:g,signal:a.signal,...t.length?{tags:t}:{}};return l(v,e,B)}let u=new AbortController;return c?.signal?.addEventListener(`abort`,()=>u.abort(),{once:!0}),i(e=>{let n=L({send:(t,n)=>e({ok:!0,value:o(h.output,t),...n?{meta:n}:{}}),closed:u.signal});return Promise.resolve(l(v,{input:g,tags:[...t,n]},B))},e=>e,e=>r(n,s,e.kind,e.payload,m),()=>u.abort())},{reply:y,signal:a.signal,shape:h.output,kind:`failed`}).then(t=>{if(e.isRefused(t))throw r(n,s,`refused`,t.payload,m);return t})},m=(e,t,n,r)=>i=>(t.obs.event(`${e.name}.failed`,{address:n}),t.log.error(`${e.name} call failed`,{address:n,execution:r,cause:String(i),stack:String(Object(i).stack??``)}),{ok:!1,kind:`failed`,payload:{}}),h=t=>e.isRefused(t)?{ok:!1,kind:`refused`,payload:t.payload}:{ok:!0,value:t},g=(e,t)=>{let n={ok:!1,kind:`invalid`,payload:{}};return e?Promise.resolve(n):Promise.resolve(t(n)).then(()=>!0)},_=(e,t)=>{let{op:n,config:r}=t,{input:i,rawInput:a}=t.call??{},o=i??a,c=n===e.answer;if(!r.implement.present||!Object.hasOwn(e.contracts,o.address))return Promise.resolve(c?null:!1);let u=l(e,o.address,s(e,o)),d=c?y:b;return u.issues?g(c,o.push):d(e,t,o,u.value)},v=({execution:e})=>e&&/^[\w-]{1,64}$/.test(e)?[se(e)]:[],y=(n,r,{address:i,meta:a},o)=>{if(n.contracts[i].mode===`stream`)return Promise.resolve(null);let{run:s,config:c}=r,l=c.implement.present?c.implement.value[i]:void 0,u=e.runOf(l),d=n.contracts[i];return e.runHooks(s,e.hooksOf(t(c),l),i,o,a,(e,t)=>{let n=[...t,...v(a)];return Promise.resolve(s(u,{input:o,signal:r.signal,...n.length?{tags:n}:{}},B))},{reply:!0,signal:r.signal,shape:d.output,kind:`failed`}).then(h).catch(m(n,r,i,a.execution))},b=(n,r,{address:i,meta:a,push:s,left:c},l)=>{let{run:u,config:d}=r,f=n.contracts[i];if(f.mode!==`stream`)return Promise.resolve(!1);let p=d.implement.present?d.implement.value[i]:void 0,g=e.runOf(p),_=L({send:(e,t)=>s({ok:!0,value:o(f.output,e),...t?{meta:t}:{}}),closed:c??r.signal??new AbortController().signal});return e.runHooks(u,e.hooksOf(t(d),p),i,l,a,(e,t)=>Promise.resolve(u(g,{input:l,tags:[...t,_]},B)),{reply:!1,kind:`failed`}).then(t=>(e.isRefused(t)&&s(h(t)),!0),e=>(s(m(n,r,i)(e)),!0))};return{split:a,joined:s,faultOf:r,kindOf:n,hooksIn:t,pull:i,check:c,inputOf:d,sendKey:f,runHere:p,failedAt:m,answeredAs:h,invalid:g,serve:_,answerHere:y,streamHere:b}}});function le(e,{label:t=`rpc`}={}){let r=Object.keys(e),o=r.find(e=>H.includes(e));if(o)throw Error(`${t}: "${o}" is a reserved key`);let c=Object.fromEntries(r.flatMap(n=>{let r=Object(Object(e[n].input).shape),i=Object.keys(r).filter(e=>Object(r[e])[R]);if(i.length>1||i.length&&e[n].mode===`stream`)throw Error(`${t}: "${n}" takes bytes in one field at most, and only as a reply key`);let a=i[0];return a?[[n,{field:a,...Object(r[a])[R]}]]:[]})),l=Object.fromEntries(Object.entries(c).map(([e,{max:t,types:n}])=>[e,{max:t,types:n}])),u={},f={is:e=>Object(e)[oe]===u,make:(e,t,n,r,i)=>{let{side:a,sent:o}=Object(n),s=t===`link`||a===`client`;return Object.assign(Error(`${e}: ${t}${r?` (trace ${r})`:``}`),{[oe]:u,address:e,fault:t,from:s?`local`:`server`,...s&&{sent:o??(t!==`encode`&&t!==`invalid`)},payload:n,traceId:r,...i&&{execution:i}})}},p=Object.fromEntries(r.map(t=>[t,n({label:t,input:e[t].input,run:()=>{throw Error(`${t}: no rpc capsule`)}})])),m=new Map(r.map(e=>[p[e],e])),g=i({label:`${t}.retry`,default:{}}),v=i({label:`${t}.onStart`,default:[]}),y=i({label:`${t}.onSuccess`,default:[]}),b=i({label:`${t}.onError`,default:[]}),x=i({label:`${t}.onFinish`,default:[]}),S=i({label:`${t}.remote`}),C=i({label:`${t}.implement`}),w=n({label:`${t}.answer`,input:j,run:()=>{throw Error(`${t} does not serve here`)}}),T=n({label:`${t}.stream`,input:M,run:()=>{throw Error(`${t} does not serve here`)}}),E=n({label:`${t}.receive`,input:_({key:d(),meta:h(d(),d()).optional()}),run:(e,{input:t,obs:n})=>{n.span&&Object.assign(n.span.attributes,{"messaging.operation.type":`process`,"messaging.destination.name":t.key});let r=t.meta?.traceparent;return r&&n.event(`link`,{traceparent:r}),n.span?.traceId}}),D={name:t,contracts:e,keys:r,bytesOf:c,fault:f,answer:w,stream:T,receive:E},O=a({label:`${t}.steps`,initial:null}),k={remote:S.optional,implement:C.optional,retry:g,onStart:v,onSuccess:y,onError:b,onFinish:x},A=s({label:t,config:k,exports:{...p,answer:w,stream:T},hooks:{async start({config:e,load:t,next:n,raise:r}){let i=await t(ce,V);return i.check(D,e,r),t(O,V).set(i),n()},run(e){let t=m.get(e.op),n=e.op===w||e.op===T;if(t===void 0&&!n)return e.next();let r=e.load(O,V).get();return t===void 0?r.serve(D,e):(e.config.remote.present?r.sendKey:r.runHere)(D,e,t)}}});return Object.assign(A,{fault:f,receive:E,addresses:r,uploads:l})}const U=e=>JSON.stringify(typeof e==`string`?e:Object.keys(e).sort().map(t=>[t,e[t]])),W=(e,t)=>`${e}\u0000${t.read===`of`?`o`:`w`}${U(t.part)}${t.window?U(t.window):``}`,G=(e,t)=>e.read===`of`?U(e.part)===U(t):Object.keys(e.part).every(n=>Object(t)[n]===Object(e.part)[n]),K=e=>typeof e==`string`||typeof e==`object`&&!!e&&!Array.isArray(e)&&Object.values(e).every(e=>typeof e==`string`||typeof e==`number`&&Number.isFinite(e)),q=c(e=>{let{read:t,part:n,window:r}=Object(e);return t!==`of`&&t!==`where`||!K(n)||r!=null&&(typeof r!=`object`||!K(r))?l(`expected an ask`):{value:{read:t,part:n,window:r}}}),J=(e,t)=>{let n=e.part;if(typeof t==`string`||typeof n==`string`)return U(n)===U(t)?e:void 0;let r={...n,...t};if(U(r)===U(n))return e;if(!(e.read===`of`||Object.keys(n).some(e=>n[e]!==r[e])))return e.window?e:{read:`where`,part:r}},ue=(e,t)=>e.window||t.window?W(``,e)===W(``,t):!!J(e,t.part),de=e=>Object(e).keyed.key,fe=(e,t)=>{let n=[W(e,{read:`of`,part:t})];if(typeof t==`string`)return n;let r=t,i=Object.keys(r);for(let t=0;t<1<<i.length;t++){let a=Object.fromEntries(i.filter((e,n)=>t&1<<n).map(e=>[e,r[e]]));n.push(W(e,{read:`where`,part:a}))}return n},Y={role:`state`,explain:`Remote data of this root`},X={role:`handler`,explain:`Sends one write to its watchers`},Z={role:`handler`,explain:`Reads one key's stream`},Q=`remoteData`,pe=`answer stream drop invalidate fault faults part status states`.split(` `),me=(e,t,n)=>{let r=Object.keys(t),i=r.filter(t=>t in e||pe.includes(t));if(i.length)throw Error(`remoteData: config ${i.join(`, `)} is a cell or reserved key`);let a=Object.keys(e).filter(e=>pe.includes(e));if(a.length)throw Error(`remoteData: ${a.join(`, `)} is a reserved key`);if(!r.length)return null;if(n.size)throw Error(`remoteData: a keyed cell takes no config`);return t},he=e=>{if(e.mode===`single`)return a({initial:e.initial,parse:e.parse,eq:(t,n)=>e.eq(t,n)});let t=Object(e).keyed;return a({mode:`keyed`,key:t.key,parse:t.parse,eq:t.eq})},ge=(e,t,n,r)=>e.wire.fault.is(n)?n:(r.error(`remoteData bug`,{address:t,cause:String(n)}),e.wire.fault.make(t,`failed`,{side:`client`})),$=r({label:`remoteData.steps`,target:`scope`,factory:()=>{let e=e=>JSON.stringify(Object.keys(e).sort().map(t=>[t,e[t]])),n=(t,n)=>n===null?t:`${t}\u0000${e(n)}`,r=(e,t,n)=>{let r=e.cells[t].parse;if(!r)return{ok:!0,value:n};try{return{ok:!0,value:o(r,n)}}catch(e){return{ok:!1,why:String(Object(e).kind??e)}}},i=(e,{load:t,next:n,config:r,run:i})=>{let a=new Map(e.keys.map(n=>[n,t(e.cells[n],Y)])),o=new Map(e.keys.map(n=>[n,t(e.made[n],Y)]));for(let t of e.keys){let n=a.get(t).get();e.keyed.has(t)?o.get(t).adopt(n):o.get(t).set(n)}let s=(t,n)=>{let a=r.fill.present?r.fill.value[t]:void 0;if(!a)return;let o=Object.entries(e.by).map(([e,t])=>t(n[e]));return Promise.resolve(i(a,{tags:o},X))},c=r.load.present?r.load.value:{};return t(e.state,Y).set({roots:a,copies:o,watchers:new Map,held:new Map,fill:s,parts:new Map,pass:new Map,loads:c,load:(e,t,n)=>{let r=c[e];return r&&Promise.resolve(i(r,{rawInput:t,signal:n},X))}}),n()},a=async(e,t,r,i)=>{if(i===null)return t.roots.get(r).get();let a=n(r,i);return t.held.has(a)?t.held.get(a):await t.fill(r,i)??e.cells[r].initial},s=async(e,t,r,i,o)=>{let s=n(r,i),c=t.watchers.get(s)??new Map;t.watchers.set(s,c);let l=new Promise(e=>{let n=()=>{if(!c.delete(o.send))return e();c.size===0&&(t.watchers.delete(s),i!==null&&t.held.delete(s)),e()};c.set(o.send,n),o.closed.aborted?n():o.closed.addEventListener(`abort`,n,{once:!0})}),u=await a(e,t,r,i);return i!==null&&c.size>0&&!t.held.has(s)&&t.held.set(s,u),o.send(i===null?u:t.held.get(s)??u),l},c=(e,t,n,r)=>{let i=W(t,n),a=e.watchers.get(i)??new Map;e.watchers.set(i,a);let o=new Promise(t=>{let o=()=>{a.delete(r.send)&&a.size===0&&(e.watchers.delete(i),e.parts.delete(i)),t()};e.parts.set(i,n),a.set(r.send,o),r.closed.aborted?o():r.closed.addEventListener(`abort`,o,{once:!0})});return r.send(n),o},l=(e,n,r,i,a)=>{let o=n.load(r,i.window?{...Object(i.part),...i.window}:i.part,a);if(o){let t=de(e.cells[r]);return o.then(e=>e.filter(e=>G(i,t(e))))}i.window&&t(`MissingConfig`,{label:Q,key:`load`});let s=n.roots.get(r);if(i.read===`where`)return s.where(i.part).get();let c=s.of(i.part).get();return c===void 0?[]:[c]},u=e=>{let t=[...e.pass],n=e.sent;e.pass.clear(),e.sent=void 0;for(let[r,{at:i,dirty:a}]of t)e.watchers.get(i)?.has(r)&&r(a.size===1?[...a.values()][0]:e.parts.get(i),n)},d=(e,t,n,r)=>{e.pass.size===0&&queueMicrotask(()=>u(e));let i=e.pass.get(n)??{at:t,dirty:new Map};e.pass.set(n,i),i.dirty.set(W(``,r),r)},f=(e,t,n)=>{let r=n===void 0?[...e.parts.keys()].filter(e=>e.startsWith(`${t}\u0000`)):fe(t,n);for(let t of r){let r=e.parts.get(t);for(let i of e.watchers.get(t)?.keys()??[])d(e,t,i,n===void 0?r:{read:`of`,part:n})}},p=(e,t,n)=>{for(let[r,i]of e.parts){let a=r.startsWith(`${t}\u0000`)?J(i,n):void 0;if(a!==void 0)for(let t of e.watchers.get(r).keys())d(e,r,t,a)}},m=new Map,h=(e,t)=>t.entry?t.entry.faults:t.load(e.faults,Y).get(),g=(e,t,n,i,a)=>{let{run:o,clock:s,log:c}=t,l=(t,r)=>{if(a.aborted)return;let i=h(e,n);if(!r&&!Object.hasOwn(i,t))return;let o={...i};r?o[t]=r:delete o[t],n.entry?(n.entry.faults=o,n.entry.listeners.forEach(e=>e())):n.load(e.faults,Y).set(o)},u=(t,i,a)=>{let o=r(e,t,i);if(!o.ok)return c.error(`remoteData value refused`,{address:t,why:o.why}),l(t,e.wire.fault.make(t,`invalid`,{side:`client`},a));n.entry?(n.entry.values.set(t,o.value),n.entry.listeners.forEach(e=>e())):n.load(e.made[t],Y).set(o.value),l(t,null)},d=async(t,n)=>{let r=new AbortController;try{let s=await o(e.wire[t],{input:i},Z);a.addEventListener(`abort`,()=>s.stop(a.reason),{once:!0,signal:r.signal}),a.aborted&&s.stop(a.reason);for await(let r of s){let i=await o(e.wire.receive,{input:{key:t,meta:s.meta}},Z);u(t,r,i),n()}return null}catch(n){return ge(e,t,n,c)}finally{r.abort()}};return{mark:l,set:u,round:d,loop:async(t,r)=>{for(let i=50;!a.aborted;){let o=await d(t,r);if(!a.aborted&&o&&l(t,o),r(),a.aborted)break;i=Object.hasOwn(h(e,n),t)?Math.min(i*2,5e3):50,await s.sleep(i,a).catch(()=>void 0)}}}},_=new Map,v=(e,t)=>Promise.all(e.keys.filter(t=>!e.keyed.has(t)).map(e=>new Promise(n=>{t.loop(e,n)}))),y=(t,n,r,i)=>{let a=_.get(t),o=e(n),s=a.entries.get(o);if(!s){let e={refs:0,values:new Map,faults:{},listeners:new Set,stop:new AbortController};s=e,a.entries.set(o,e);let r={entry:e,load:a.event.load};a.event.signal.addEventListener(`abort`,()=>e.stop.abort(a.event.signal.reason),{once:!0,signal:e.stop.signal}),v(t,g(t,a.event,r,n,e.stop.signal))}let c=s,l=()=>{if(!i?.aborted){for(let[e,n]of c.values){let i=t.made[e];(r?r.controller(i):a.event.load(i,Y)).set(n)}(r?r.controller(t.faults):a.event.load(t.faults,Y)).set(c.faults)}};return c.refs++,c.listeners.add(l),l(),()=>{c.listeners.delete(l),!(--c.refs>0)&&(c.stop.abort(),a.entries.delete(o))}},b=(e,t,n,r)=>{let{run:i,clock:a,signal:o,log:s}=t,c=t.load(e.made[n],Y),l=new Map,u=t.load(e.states,Y),d=(e,t)=>{if(!o.aborted)for(let r of l.values())ue(e,r.ask)&&(e.window||G(e,r.ask.part))&&u.set({...t,at:W(n,r.ask)})},f=e=>[...l.values()].some(t=>G(t.ask,e)),p=new Set,h=e=>!o.aborted&&[...l.values()].some(t=>J(t.ask,e.part)),g=de(e.made[n]),_=(e,t)=>{let n={ask:e,later:[],signalled:t};for(let t of p)ue(t.ask,e)&&t.later.push(n);return p.add(n),n.done=v(n),n.done},v=async t=>{let{read:r,part:a}=t.ask,o=e=>t.later.some(t=>G(t.ask,e)),s=t.signalled&&{ask:t.ask,meta:t.signalled.meta},l=await Promise.resolve().then(()=>s?i(e.takes[n],{input:s},Z):i(e.wire[`${n}.ask`],{input:t.ask},Z)).then(e=>()=>{let n=e.filter(e=>!o(g(e)));c.answer(r,a,n,o,t.ask.window)},e=>()=>{throw e});p.delete(t),!o(a)&&h(t.ask)&&y(t.ask,l),await Promise.all(t.later.map(e=>e.done))},y=(t,i)=>{try{i(),r(n,null),d(t,{status:`ready`})}catch(i){let a=W(n,t),o=e.wire.fault.is(i)?i:e.wire.fault.make(a,`invalid`,{side:`client`},void 0);r(n,o),d(t,{status:`fault`,fault:o})}},b=async e=>{let t=new Map;for(let r of l.values()){let i=r.rides?void 0:J(r.ask,e);i&&r.wake?r.wake():i&&t.set(W(n,i),i)}await Promise.all([...t.values()].map(e=>_(e)))},x=m.get(e)??new Map;m.set(e,x.set(n,b));let S=async e=>{await new Promise(t=>{e.wake=t,e.stop.signal.addEventListener(`abort`,()=>t(),{once:!0})}),e.wake=void 0},C=async t=>{for(let o=50;!t.stop.signal.aborted;){try{let r=await i(e.wire[n],{input:t.ask},Z);t.stop.signal.addEventListener(`abort`,()=>r.stop(),{once:!0});for await(let e of r)_(e,{meta:r.meta});o=50}catch(i){if(t.stop.signal.aborted)return;let a=ge(e,n,i,s);if(r(n,a),d(t.ask,{status:`fault`,fault:a}),a.fault!==`link`){await S(t),o=50;continue}o=Math.min(o*2,5e3)}await a.sleep(o,t.stop.signal).catch(()=>void 0)}},w=e=>[...l.values()].find(t=>t.ask!==e&&!t.ask.window&&!e.window&&G(t.ask,e.part)),T=e=>{o.addEventListener(`abort`,()=>e.stop.abort(),{once:!0,signal:e.stop.signal}),C(e)};c.listen((e,t,r)=>{let i=r?{read:e,part:t,window:r}:{read:e,part:t},a=W(n,i),s=l.get(a)??{refs:0,ask:i,stop:new AbortController};if(s.refs++===0){s.rides=w(i),l.set(a,s);let e=s.rides&&u.of({at:W(n,s.rides.ask)}).get();o.aborted||u.set({...e??{status:`pending`},at:a}),s.rides||T(s)}return()=>{if(!(--s.refs>0)){s.stop.abort(),l.delete(a),o.aborted||u.delete({at:a});for(let e of l.values())e.rides===s&&(e.rides=w(e.ask),e.rides||T(e));o.aborted||c.answer(e,t,[],f,r)}}})};return{named:e,keep:v,reader:g,valueOf:a,faultsIn:h,slot:n,fits:r,serveStart:i,watch:s,watchPart:c,answerPart:l,changed:f,invalidate:async(e,t,n,r)=>{if(t)return p(t,n,r);await m.get(e)?.get(n)?.(r)},readStart:async(t,n)=>{let{config:r,raise:i,next:a,load:o,signal:s}=n;if(!r.read.present)return i(`MissingConfig`,{label:Q,key:`read`});if(t.by){_.set(t,{event:n,entries:new Map,root:null});let r=await o(t.paramOf,Y);return r!==null&&(_.get(t).root=e(r),y(t,r,null)),a()}let c=g(t,n,{entry:null,load:o},null,s);for(let e of t.keyed)b(t,n,e,c.mark);return await v(t,c),a()},join:y,guardKeyed:(e,t)=>{let n=Object.values(e.cells);return Object.values(Object(Object(t.op).depends)).some(e=>Object(e).kind===`controller`&&n.includes(Object(e).target))?t.load(e.missingOf,Y).then(e=>e===null?t.next():t.raise(`MissingTag`,{label:e})):t.next()},isReading:e=>_.has(e),rootParam:e=>_.get(e)?.root??null}}});function _e(e,{config:t={}}={}){let u=Object.keys(e),h=new Set(u.filter(t=>e[t].mode===`keyed`)),v=me(e,t,h),y=Object.keys(t),b=new Map(u.map(t=>[e[t],t])),S=Object.fromEntries(u.map(t=>[t,he(e[t])])),C=v===null?p():c(e=>{if(typeof e!=`object`||!e)return l(`expected the parameter`);try{return{value:Object.fromEntries(Object.entries(v).map(([t,n])=>[t,n(Object(e)[t]).value]))}}catch{return l(`the parameter does not fit its tags`)}}),w=le(Object.fromEntries(u.flatMap(e=>h.has(e)?[[e,{mode:`stream`,input:q,output:f()}],[`${e}.ask`,{mode:`reply`,input:q,output:f()}]]:[[e,{mode:`stream`,input:C,output:f()}]])),{label:Q}),T=i({label:`${Q}.serve`}),E=i({label:`${Q}.fill`}),D=i({label:`${Q}.load`}),O=i({label:`${Q}.read`}),k=Object.fromEntries(Object.entries(t).map(([e,t])=>[e,t.optional])),A=r({label:`${Q}.param`,target:`session`,depends:k,factory:e=>{if(!v)return null;let t={};for(let n of y){if(!e[n]?.present)return null;t[n]=e[n].value}return t}}),j=r({label:`${Q}.missing`,target:`session`,depends:k,factory:e=>{let n=y.find(t=>!e[t]?.present);return n===void 0?null:t[n].label}}),M=a({label:`${Q}.state`,initial:null}),N=a({label:`${Q}.faults`,initial:{}}),P=a({label:`${Q}.states`,mode:`keyed`,key:e=>({at:e.at})}),F={cells:e,made:S,keys:u,wire:w,state:M,faults:N,states:P,by:v,paramOf:A,missingOf:j,keyed:h,takes:Object.fromEntries([...h].map(e=>[e,n({label:`${Q}.receive`,depends:{answer:w[`${e}.ask`].controller},run:({answer:t},{input:n,obs:r})=>{r.span&&Object.assign(r.span.attributes,{"messaging.operation.type":`process`,"messaging.destination.name":e});let i=n.meta?.traceparent;return i&&r.event(`link`,{traceparent:i}),t.run({input:n.ask})}})]))},te=Object.fromEntries(u.flatMap(e=>h.has(e)?[[e,n({label:`${Q}.watch`,input:q,depends:{out:L,own:M,s:$},run:({out:t,own:n,s:r},{input:i})=>r.watchPart(n,e,i,t)})],[`${e}.ask`,n({label:`${Q}.ask`,input:q,depends:{own:M,s:$},run:({own:t,s:n},{input:r,signal:i})=>n.answerPart(F,t,e,r,i)})]]:[[e,n({label:`${Q}.watch`,input:C,depends:{out:L,own:M,s:$},run:({out:t,own:n,s:r},{input:i})=>r.watch(F,n,e,i??null,t)})]])),ne=n({label:`${Q}.drop`,depends:{own:M},run:({own:e})=>{for(let t of e?.watchers.values()??[])for(let e of Array.from(t.values()))e()}}),I=n({label:`${Q}.send`,input:_({key:d()}),depends:{served:M,protocol:ee},run:({served:e,protocol:t},{input:n,obs:r})=>{e?.pass.size&&!e.sent&&(r.span&&Object.assign(r.span.attributes,{"messaging.operation.type":`send`,"messaging.destination.name":n.key}),e.sent=t.traceparent(r.span))}}),re=n({label:`${Q}.invalidate`,input:c(e=>Object.entries(Object(e)).every(([e,t])=>h.has(e)&&K(t))?{value:e}:l(`expected keyed keys and their parts`)),depends:{own:M,s:$,send:I.controller},run:async({own:e,s:t,send:n},{input:r})=>{let i=Object.entries(r).map(([n,r])=>t.invalidate(F,e,n,r));for(let e of Object.keys(r))n.run({input:{key:e}});await Promise.all(i)}}),ie=n({label:`${Q}.fits`,input:x.start,depends:{own:M},run:({own:e},{input:t})=>{let n=e.loads[t.key.replace(/\.ask$/,``)]?.input,{part:r,window:i}=Object(t.input);try{n&&o(n,i?{...Object(r),...i}:r);return}catch{return t.refuse({part:r})}}}),R=new Set,ae=(e,t,n,r)=>{if(!h.has(t)){e.roots.get(t).set(n),e.copies.get(t).set(n);return}let i=n,a=e.roots.get(t);if(e.loads[t])return r.changed(e,t,a.step(i));r.changed(e,t,a.adopt(i)),e.copies.get(t).adopt(i)},z=n({label:`${Q}.send`,input:_({key:d(),value:f(),watchers:g(m(e=>typeof e==`function`))}),depends:{protocol:ee},run:({protocol:e},{input:t,obs:n,log:r})=>{n.span&&Object.assign(n.span.attributes,{"messaging.operation.type":`send`,"messaging.destination.name":t.key,"messaging.batch.message_count":t.watchers.length});let i=e.traceparent(n.span);for(let e of t.watchers)try{e(t.value,i)}catch(e){r.error(`remoteData push failed`,{address:t.key,cause:String(e)})}}}),B=a({label:`${Q}.steps`,initial:null}),V=s({label:Q,config:{serve:T.optional,fill:E.optional,load:D.optional,read:O.optional},exports:{...S,faults:N,states:P,drop:ne,invalidate:re},hooks:{async start(e){let{config:t,load:n,raise:r}=e;t.serve.present===t.read.present&&r(`MissingConfig`,{label:Q,key:`serve | read`});let i=await n($,Y);n(B,Y).set(i);let a=e;return t.serve.present?i.serveStart(F,a):i.readStart(F,a)},run(e){return!v||!e.load(M,Y).get()?e.next():e.load(B,Y).get().guardKeyed(F,e)},async session({handle:e,next:t,load:n}){if(!v)return t();let r=n(B,Y).get();if(!r||!r.isReading(F))return t();let i=e.resolve(A);if(i===null||r.rootParam(F)===r.named(i))return t();let a=new AbortController,o=r.join(F,i,e,a.signal);try{return await t()}finally{a.abort(),o()}},write({cell:e,value:t,next:n,load:r,run:i,log:a}){let o=b.get(e);if(o===void 0)return n();let s=r(M,Y).get();if(!s)return n();if(v){n(),r(A,Y).then(e=>{if(e===null){a.error(`remoteData keyed write with no parameter`,{address:o});return}let n=`${o}\u0000${r(B,Y).get().named(e)}`,c=[...s.watchers.get(n)?.keys()??[]];if(c.length)return s.held.set(n,t),i(z,{input:{key:o,value:t,watchers:c}},X)}).catch(e=>a.error(`remoteData send failed`,{address:o,cause:String(e)}));return}if(R.has(e))return n();R.add(e);try{ae(s,o,t,r(B,Y).get())}finally{R.delete(e)}if(h.has(o))return void i(I,{input:{key:o}},X);let c=[...s.watchers.get(o)?.keys()??[]];i(z,{input:{key:o,value:t,watchers:c}},X).catch(e=>a.error(`remoteData send failed`,{address:o,cause:String(e)}))}}}),H=({retry:e,onStart:t,onSuccess:n,onError:r,onFinish:i,...a})=>{let o=`load`in a&&a.load?[ie,...t??[]]:t,s=Object.fromEntries(Object.entries({retry:e,onStart:o,onSuccess:n,onError:r,onFinish:i}).filter(([,e])=>e));return[w(`serve`in a&&a.serve?{implement:te,...s}:{remote:a.read,...s}),V(a)]};return Object.defineProperties(H,Object.getOwnPropertyDescriptors(V)),Object.assign(H,{fault:{is:e=>w.fault.is(e)},part:e=>h.has(e.key.replace(/\.ask$/,``))?Object(e.input).part:void 0,status:e=>{let t=Object.keys(S).find(t=>S[t]===e.cell);return P.of({at:W(t,e)})},addresses:u.flatMap(e=>h.has(e)?[e,`${e}.ask`]:[e]),names:t=>e[t.replace(/\.ask$/,``)]?.label.replace(/^anon$/,``),answer:w.answer,stream:w.stream,...t})}export{le as a,se as i,ae as n,ie as o,L as r,_e as t};