@tinkered/core 0.23.1 → 0.25.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
@@ -1,4 +1,4 @@
1
- import { $ as originOf, A as Namespace, B as data, C as Capsule, D as Edge, E as Derived, F as Resource, G as parse, H as isStarting, I as Scope, J as tag, K as readMany, L as Tag, M as Observe, N as Operation, O as LEVELS, P as Random, Q as isError, R as capsule, S as rpc_shape_d_exports, T as Data, U as namespace, V as derived, W as operation, X as Origin, Y as Errors, Z as RunResult, _ as Stream, a as Hooks, b as Watch, c as OnStart, d as Body, f as BytesLimit, h as Fault, i as Entry, j as Ns, k as Many, l as OnSuccess, o as OnError, p as Call, q as resource, s as OnFinish, t as rpc_transport_d_exports, u as Answer, w as Clock, x as Infer, z as createScope } from "./rpc-transport-BY1E1-G-.mjs";
1
+ import { $ as isError, A as Many, B as createScope, C as rpc_shape_d_exports, D as Derived, E as Data, F as Random, G as operation, H as derived, I as Resource, J as resource, K as parse, L as Scope, M as Ns, N as Observe, O as Edge, P as Operation, Q as RunResult, R as Tag, T as Clock, U as isStarting, V as data, W as namespace, X as Errors, Y as tag, Z as Origin, _ as Stream, a as Hooks, c as OnStart, d as Body, et as originOf, f as BytesLimit, h as Fault, i as Entry, j as Namespace, k as LEVELS, l as OnSuccess, o as OnError, p as Call, q as readMany, s as OnFinish, t as rpc_transport_d_exports, u as Answer, v as Watch, w as Capsule, y as Infer, z as capsule } from "./rpc-transport-BdaNSxJh.mjs";
2
2
  //#region src/rpc.d.ts
3
3
  /**
4
4
  * A key's contract: input and output shapes, no error list. A domain outcome (a todo that is gone)
@@ -56,7 +56,7 @@ type Job$1<C extends Contracts> = {
56
56
  } | {
57
57
  readonly remote: {
58
58
  readonly call: Call;
59
- readonly watch?: Watch;
59
+ readonly watch: Watch;
60
60
  };
61
61
  readonly implement?: never;
62
62
  };
@@ -74,13 +74,14 @@ type RpcFault<K extends string = string> = Error & {
74
74
  /** The call's execution id (ADR 0147), as the ref a person quotes: set with tracing off too. */
75
75
  readonly execution?: string;
76
76
  };
77
+ /** A backend's client: `watch` is required (ADR 0140); how soon it tells is the backend's. */
77
78
  type Remote = {
78
79
  readonly call: Call;
79
- readonly watch?: Watch;
80
+ readonly watch: Watch;
80
81
  };
81
82
  /**
82
- * A call's execution id (ADR 0147): the client makes one per call and sends it as
83
- * `meta.execution`; the server binds it here for the run. It is the fault's ref and a log field
83
+ * A call's execution id (ADR 0147): the client makes one per call and sends it in the call's
84
+ * `execution` field (ADR 0154); the server binds it here for the run. It is the fault's ref and a log field
84
85
  * on both sides, with tracing off too.
85
86
  */
86
87
  export declare const execution: Tag.Handle<string>;
@@ -152,6 +153,7 @@ type Job<D = Cells> = {
152
153
  readonly read?: never;
153
154
  } | {
154
155
  readonly read: Read;
156
+ readonly refetchInterval?: Intervals<D>;
155
157
  readonly serve?: never;
156
158
  };
157
159
  /** The lifecycle hooks go to the wire: rpc runs them, on each side, per key. */
@@ -161,6 +163,9 @@ type Config<D = Cells> = Job<D> & Hooks;
161
163
  * input says which fields a part must have. With a load, the server keeps no member.
162
164
  */
163
165
  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>; };
166
+ /** By keyed key: how often, in ms, a part in use asks again (ADR 0139 3). With none, it never
167
+ * does by time: TanStack's `refetchInterval` is off by default too. */
168
+ type Intervals<D> = { readonly [K in keyof D as D[K] extends Data.Keyed<any, any> ? K : never]?: number; };
164
169
  /**
165
170
  * A keyed definition's first value for one parameter, per key: an op the server runs in a call
166
171
  * tagged with the parameter, when a client asks for a parameter no write has given yet. With no
@@ -201,6 +206,7 @@ export declare function remoteData<const D extends Cells, const P extends Readon
201
206
  readonly fill: Edge<"optional", Tag.Handle<Readonly<Record<string, Operation.Handle<unknown, void>>>>>;
202
207
  readonly load: Edge<"optional", Tag.Handle<Readonly<Record<string, Operation.Handle<unknown, any> | undefined>>>>;
203
208
  readonly read: Edge<"optional", Tag.Handle<Read>>;
209
+ readonly refetchInterval: Edge<"optional", Tag.Handle<Readonly<Record<string, number | undefined>>>>;
204
210
  }, {
205
211
  drop: Operation.Handle<void, void>;
206
212
  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-CNYewB1t.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=e=>({ok:!1,kind:e.kind,payload:{sent:Object(e).sent}}),k=_({address:d(),value:f(),meta:w,body:D,execution:d().optional()}),A=k.extend({push:m(e=>typeof e==`function`),left:T}),j={role:`state`,explain:`The transport's own side`},M=new WeakMap,N={role:`handler`,explain:`One layer down`},ee=r({label:`protocol`,target:`scope`,factory:()=>{let e=(e,t,n)=>Promise.resolve(e.run(t,n,N)),t=e=>e?{traceparent:`00-${e.traceId}-${e.spanId}-${e.sampled?`01`:`00`}`}:{},n=e=>e.present?e.value:void 0,r=(e,t)=>String(e.names?.(t)||e.label),i=(e,t,n,i)=>{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=r(o,e),l={address:e,services:[r(s,e),c]};i&&t(`DuplicateAddress`,l),n.warn(`protocol duplicate address`,{address:e,winner:l.services[0],shadowed:c})}return a},a=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=M.get(t);if(o)return o;let s=e(n,a,{input:{payload:r,sent:i}}).catch(()=>!1).finally(()=>M.delete(t));return M.set(t,s),s}}},o=async(t,n,r)=>{let{meta:i,metaNow:o,renewed:s}=await a(t,n,r.meta),c=i=>e(n,t.send,{input:{...r,meta:i},signal:n.signal}).catch(l(n,r.address)),u=await c(i);return u.ok||u.kind!==`refused`||!await s(u.payload,i)?u:o().then(c)},s=async(t,n,r)=>{let{signal:i}=n,{meta:o,renewed:s}=await a(t,n,r.meta),c=e=>{!e.ok&&e.kind===`refused`&&s(e.payload,o),r.push(e)},u=await e(n,t.open,{input:{...r,meta:o,push:c},signal:i}).catch(l(n,r.address));!u.ok&&!i?.aborted&&r.push(u)},c=(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}:{}}),l=(e,t)=>n=>e.signal?.aborted?O({ok:!1,kind:`link`,sent:!0}):c(e,t,`client`)(n);return{run:e,traceparent:t,given:n,routesOf:i,asking:a,callOver:o,watchOver:s,broke:c,answer:async(t,n,r)=>{let i=t.routes.get(r.address);return i?e(n,i.answer,{input:r,signal:n.signal}).catch(c(n,r.address)):null},stream:async(t,n,r)=>{let i=t.routes.get(r.address);return i?e(n,i.stream,{input:r}).catch(e=>(r.push(c(n,r.address)(e)),!0)):!1}}}}),te=i({label:`request`}),P=i({label:`request.stop`}),F=/^00-(?!0{32})[0-9a-f]{32}-(?!0{16})[0-9a-f]{16}-[0-9a-f]{2}$/;function ne(e){if(typeof e!=`string`||!F.test(e))return null;let[,t=``,n=``,r=``]=e.split(`-`);return{traceId:t,parentSpanId:n,sampled:(Number.parseInt(r,16)&1)==1}}var re=e({bodyShape:()=>E,callInput:()=>k,hook:()=>x,kept:()=>j,lifecycle:()=>C,lost:()=>O,protocol:()=>ee,request:()=>te,requestStop:()=>P,traceparentOf:()=>ne,watchInput:()=>A});const I=i({label:`rpc.channel`}),L=Symbol(`rpc.bytes`),ie=(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,{[L]:{max:t,types:n}})},R={role:`handler`,explain:`Sends through the protocol`},z={role:`handler`,explain:`Runs the implementation`},B={role:`state`,explain:`The rpc steps of this root`},V=[`answer`,`stream`,`fault`],H=Symbol(`rpc.fault`),U=i({label:`execution`}),ae=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}`}),n.remote.present&&!n.remote.value.watch&&r(`MissingConfig`,{label:t.name,key:`remote.watch`})},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`,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},R);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},R)).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,z)}let u=new AbortController;return c?.signal?.addEventListener(`abort`,()=>u.abort(),{once:!0}),i(e=>{let n=I({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]},z))},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=e=>e&&/^[\w-]{1,64}$/.test(e)?[U(e)]:[],y=(n,r,{address:i,meta:a,execution:o},s)=>{if(n.contracts[i].mode===`stream`)return Promise.resolve(null);let{run:c,config:l}=r,u=l.implement.present?l.implement.value[i]:void 0,d=e.runOf(u),f=n.contracts[i];return e.runHooks(c,e.hooksOf(t(l),u),i,s,a,(e,t)=>{let n=[...t,...v(o)];return Promise.resolve(c(d,{input:s,signal:r.signal,...n.length?{tags:n}:{}},z))},{reply:!0,signal:r.signal,shape:f.output,kind:`failed`}).then(h).catch(m(n,r,i,o))},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),_=I({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,_]},z)),{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 oe(e,{label:t=`rpc`}={}){let r=Object.keys(e),o=r.find(e=>V.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])[L]);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])[L]}]]:[]})),l=Object.fromEntries(Object.entries(c).map(([e,{max:t,types:n}])=>[e,{max:t,types:n}])),u={},f={is:e=>Object(e)[H]===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})`:``}`),{[H]: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:k,run:()=>{throw Error(`${t} does not serve here`)}}),T=n({label:`${t}.stream`,input:A,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}),j={remote:S.optional,implement:C.optional,retry:g,onStart:v,onSuccess:y,onError:b,onFinish:x},M=s({label:t,config:j,exports:{...p,answer:w,stream:T},hooks:{async start({config:e,load:t,next:n,raise:r}){let i=await t(ae,B);return i.check(D,e,r),t(O,B).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,B).get();return t===void 0?r.serve(D,e):(e.config.remote.present?r.sendKey:r.runHere)(D,e,t)}}});return Object.assign(M,{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]),se=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`||!se(n)||r!=null&&(typeof r!=`object`||!se(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}},ce=(e,t)=>e.window||t.window?G(``,e)===G(``,t):!!J(e,t.part),le=e=>Object(e).keyed.key,ue=(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`,de=`answer stream drop invalidate fault faults part status states`.split(` `),fe=(e,t,n)=>{let r=Object.keys(t),i=r.filter(t=>t in e||de.includes(t));if(i.length)throw Error(`remoteData: config ${i.join(`, `)} is a cell or reserved key`);let a=Object.keys(e).filter(e=>de.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},pe=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})},me=(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=le(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`)):ue(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 me(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())ce(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=le(e.made[n]),y=(e,t)=>{let n={ask:e,later:[],signalled:t};for(let t of g)ce(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=me(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 he(e,{config:t={}}={}){let u=Object.keys(e),h=new Set(u.filter(t=>e[t].mode===`keyed`)),v=fe(e,t,h),y=Object.keys(t),b=new Map(u.map(t=>[e[t],t])),S=Object.fromEntries(u.map(t=>[t,pe(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=oe(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}}),M=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}}),N=a({label:`${Q}.state`,initial:null}),te=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:N,faults:te,states:P,by:v,paramOf:j,missingOf:M,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:I,own:N,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:N,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:I,own:N,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:N},run:({own:e})=>{for(let t of e?.watchers.values()??[])for(let e of Array.from(t.values()))e()}}),L=n({label:`${Q}.send`,input:_({key:d()}),depends:{served:N,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))}}),ie=n({label:`${Q}.invalidate`,input:c(e=>Object.entries(Object(e)).every(([e,t])=>h.has(e)&&se(t))?{value:e}:l(`expected keyed keys and their parts`)),depends:{own:N,s:$,send:L.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:N},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: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)})}}}),H=a({label:`${Q}.steps`,initial:null}),U=s({label:Q,config:{serve:T.optional,fill:E.optional,load:D.optional,read:O.optional,refetchInterval:k.optional},exports:{...S,faults:te,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(N,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(N,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(L,{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)}))}}}),ae=({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}),U(a)]};return Object.defineProperties(ae,Object.getOwnPropertyDescriptors(U)),Object.assign(ae,{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{oe as a,d as c,U as i,f as l,ie as n,re as o,I as r,m as s,he as t};
@@ -1254,64 +1254,10 @@ type BytesLimit = {
1254
1254
  readonly max: number;
1255
1255
  readonly types: readonly string[];
1256
1256
  };
1257
- declare const sendInput: ObjectShape<{
1258
- address: Data.Schema<string> & {
1259
- readonly check: (value: unknown) => {
1260
- readonly value: string;
1261
- readonly issues?: undefined;
1262
- } | {
1263
- readonly issues: readonly Data.SchemaIssue[];
1264
- };
1265
- readonly optional: () => OptionalShape<string>;
1266
- } & {
1267
- regex: (re: RegExp) => Shape<string>;
1268
- };
1269
- text: Data.Schema<string> & {
1270
- readonly check: (value: unknown) => {
1271
- readonly value: string;
1272
- readonly issues?: undefined;
1273
- } | {
1274
- readonly issues: readonly Data.SchemaIssue[];
1275
- };
1276
- readonly optional: () => OptionalShape<string>;
1277
- } & {
1278
- regex: (re: RegExp) => Shape<string>;
1279
- };
1280
- meta: Shape<Record<string, string>>;
1281
- body: OptionalShape<Body>;
1282
- }>;
1283
- declare const openInput: ObjectShape<{
1284
- address: Data.Schema<string> & {
1285
- readonly check: (value: unknown) => {
1286
- readonly value: string;
1287
- readonly issues?: undefined;
1288
- } | {
1289
- readonly issues: readonly Data.SchemaIssue[];
1290
- };
1291
- readonly optional: () => OptionalShape<string>;
1292
- } & {
1293
- regex: (re: RegExp) => Shape<string>;
1294
- };
1295
- text: Data.Schema<string> & {
1296
- readonly check: (value: unknown) => {
1297
- readonly value: string;
1298
- readonly issues?: undefined;
1299
- } | {
1300
- readonly issues: readonly Data.SchemaIssue[];
1301
- };
1302
- readonly optional: () => OptionalShape<string>;
1303
- } & {
1304
- regex: (re: RegExp) => Shape<string>;
1305
- };
1306
- meta: Shape<Record<string, string>>;
1307
- body: OptionalShape<Body>;
1308
- push: Shape<(text: string) => void>;
1309
- left: OptionalShape<AbortSignal>;
1310
- }>;
1311
1257
  /**
1312
- * How a transport's send or open ends (ADR 0141): every exit is a value. `missing` when the other
1313
- * side said no one serves the address; `link` when the path failed, `sent: false` when nothing
1314
- * left this side. A throw is a bug: the protocol logs it and gives `failed` on this side.
1258
+ * How a backend's send or open ends with no reply (ADR 0141): every exit is a value. `missing` when
1259
+ * the other side said no one serves the address; `link` when the path failed, `sent: false` when
1260
+ * nothing left this side. A throw is a bug: the protocol logs it and gives `failed` on this side.
1315
1261
  */
1316
1262
  type Exit = {
1317
1263
  ok: false;
@@ -1321,19 +1267,6 @@ type Exit = {
1321
1267
  kind: "link";
1322
1268
  sent: boolean;
1323
1269
  };
1324
- /** Client: one text out, one text back, or its exit. */
1325
- type Send = Operation.Handle<Promise<{
1326
- ok: true;
1327
- text: string;
1328
- } | Exit>, Infer<typeof sendInput>>;
1329
- /** Client: one text out, texts pushed until the signal aborts (`ok`) or another exit. */
1330
- type Open = Operation.Handle<Promise<{
1331
- ok: true;
1332
- } | Exit>, Infer<typeof openInput>>;
1333
- /** Server: the text reply, or null when no one answers the address. */
1334
- type TextServe = Operation.Handle<Promise<string | null>, Infer<typeof sendInput>>;
1335
- /** Server: pushes texts; false when no one answers the address. */
1336
- type TextStream = Operation.Handle<Promise<boolean>, Infer<typeof openInput>>;
1337
1270
  /**
1338
1271
  * The envelope. A domain outcome (a todo that is gone) is a value: it rides in `value`, as the
1339
1272
  * contract's output shape says. A fault is the call's own, from a fixed set, as HTTP statuses:
@@ -1363,6 +1296,10 @@ type Reply = {
1363
1296
  declare const lost: (exit: Exit) => Extract<Reply, {
1364
1297
  ok: false;
1365
1298
  }>;
1299
+ /**
1300
+ * `execution`: the call's id (ADR 0147), its own field (ADR 0154): each backend carries it its own
1301
+ * way. Only a call has one.
1302
+ */
1366
1303
  declare const callInput: ObjectShape<{
1367
1304
  address: Data.Schema<string> & {
1368
1305
  readonly check: (value: unknown) => {
@@ -1378,6 +1315,7 @@ declare const callInput: ObjectShape<{
1378
1315
  value: Shape<unknown>;
1379
1316
  meta: Shape<Record<string, string>>;
1380
1317
  body: OptionalShape<Body>;
1318
+ execution: OptionalShape<string>;
1381
1319
  }>;
1382
1320
  declare const watchInput: ObjectShape<{
1383
1321
  address: Data.Schema<string> & {
@@ -1394,6 +1332,7 @@ declare const watchInput: ObjectShape<{
1394
1332
  value: Shape<unknown>;
1395
1333
  meta: Shape<Record<string, string>>;
1396
1334
  body: OptionalShape<Body>;
1335
+ execution: OptionalShape<string>;
1397
1336
  push: Shape<(reply: Reply) => void>;
1398
1337
  left: OptionalShape<AbortSignal>;
1399
1338
  }>;
@@ -1401,6 +1340,15 @@ declare const watchInput: ObjectShape<{
1401
1340
  type Call = Operation.Handle<Promise<Reply>, Infer<typeof callInput>>;
1402
1341
  /** Client: a value out; replies pushed until the signal aborts or the link ends. */
1403
1342
  type Watch = Operation.Handle<Promise<void>, Infer<typeof watchInput>>;
1343
+ type Failed$1 = Extract<Reply, {
1344
+ ok: false;
1345
+ }>;
1346
+ /** A backend's client: a value out, the reply back. An exit is a fault made with `lost`. */
1347
+ type Send = Operation.Handle<Promise<Reply>, Infer<typeof callInput>>;
1348
+ /** A backend's client: replies pushed until the signal aborts (`ok`), or the fault that ended it. */
1349
+ type Open = Operation.Handle<Promise<{
1350
+ ok: true;
1351
+ } | Failed$1>, Infer<typeof watchInput>>;
1404
1352
  /**
1405
1353
  * A definition the server protocol routes to: the addresses it has (its keys), and how it
1406
1354
  * answers. rpc and remoteData definitions are services as they are.
@@ -1631,61 +1579,54 @@ declare const lifecycle: Resource.Handle<{
1631
1579
  * body (headers). As tRPC's `headers()` or a gRPC call credential.
1632
1580
  * `renew`: runs when a call or a push is `refused`, as OkHttp's Authenticator runs on a 401.
1633
1581
  * True means "try once more" (the next `meta` has fresh credentials). One renew at a time per
1634
- * transport: calls refused together wait for the same one (single flight).
1582
+ * backend: calls refused together wait for the same one (single flight).
1635
1583
  */
1636
1584
  type MetaOp = Operation.Handle<Promise<Record<string, string>>, void>;
1637
1585
  type RenewOp = Operation.Handle<Promise<boolean>, {
1638
1586
  payload: unknown;
1639
1587
  sent: Record<string, string>;
1640
1588
  }>;
1641
- /** What a client transport holds once started: its text ops and the options it was given. */
1589
+ /** What a backend's client holds once started: its value ops and the options it was given. */
1642
1590
  type ClientSide = {
1643
1591
  readonly send: Send;
1644
1592
  readonly open: Open;
1645
- readonly codec: Codec;
1646
1593
  readonly meta?: MetaOp;
1647
1594
  readonly renew?: RenewOp;
1648
1595
  };
1649
- /** What a server transport holds once started: its codec and its route table. */
1596
+ /** What a backend's server holds once started: its route table. */
1650
1597
  type ServerSide = {
1651
- readonly codec: Codec;
1652
1598
  readonly routes: ReadonlyMap<string, Service>;
1653
1599
  };
1654
1600
  /**
1655
1601
  * The hook's own tools: run (with a handler note), log, and the call's signal. The protocol reads
1656
- * `log` only when it logs a fault, so a transport can make it on that read.
1602
+ * `log` only when it logs a fault, so a backend can make it on that read.
1657
1603
  */
1658
1604
  type Hook = {
1659
1605
  readonly run: (op: never, options: never, why: never) => unknown;
1660
1606
  readonly log: Observe.Logger;
1661
1607
  readonly signal: AbortSignal | undefined;
1662
1608
  };
1663
- /** Where a started transport keeps its side. */
1609
+ /** Where a started backend keeps its side. */
1664
1610
  declare const kept: {
1665
1611
  readonly role: "state";
1666
1612
  readonly explain: "The transport's own side";
1667
1613
  };
1668
- /** A fault from the codec: `encode` or `decode`, saying only the side. */
1669
1614
  type Failed = Extract<Reply, {
1670
1615
  ok: false;
1671
1616
  }>;
1672
- type Coded<T> = {
1673
- ok: true;
1674
- value: T;
1675
- } | Failed;
1617
+ /** One value out, as rpc and remoteData give it. */
1618
+ type Asked = Infer<typeof callInput>;
1676
1619
  /** Optional config, read as plain values. */
1677
1620
  type Maybe<T> = {
1678
1621
  readonly present: boolean;
1679
1622
  readonly value?: T;
1680
1623
  };
1681
1624
  /**
1682
- * The protocol's steps, for each transport's capsules: the client's `callOver` and `watchOver`,
1683
- * the server's `serveText` and `streamText`, the route table, the codec use, and the default
1684
- * codec (`json`). One per root; it holds nothing of its own.
1625
+ * The protocol's steps, for each backend's capsules: the client's `callOver` and `watchOver`, the
1626
+ * server's `answer` and `stream`, and the route table. One per root; it holds nothing of its own.
1685
1627
  */
1686
1628
  declare const protocol: Resource.Handle<{
1687
1629
  run: <T>(hook: Hook, op: unknown, options: unknown) => Promise<Awaited<T>>;
1688
- json: Codec;
1689
1630
  traceparent: (span: {
1690
1631
  traceId: string;
1691
1632
  spanId: string;
@@ -1693,43 +1634,19 @@ declare const protocol: Resource.Handle<{
1693
1634
  } | undefined) => Record<string, string>;
1694
1635
  given: <T>(slot: Maybe<T>) => T | undefined;
1695
1636
  routesOf: (services: readonly Service[], raise: (kind: string, payload: unknown) => never, log: Observe.Logger, strict: boolean) => Map<string, Service>;
1696
- coding: (codec: Codec, side: "client" | "server", hook: Hook) => {
1697
- fault: (kind: "encode" | "decode", address: string, error: unknown) => Failed;
1698
- encode: (address: string, value: unknown) => Coded<string>;
1699
- decode: (address: string, text: string) => Coded<unknown>;
1700
- /** A reply as text. A reply the codec cannot carry goes out as the encode fault instead. */
1701
- answerText: (address: string, reply: Reply) => string;
1702
- replyOf: (address: string, text: string) => Reply;
1703
- };
1704
1637
  asking: (own: ClientSide, hook: Hook, given: Record<string, string>) => Promise<{
1705
1638
  meta: Record<string, string>;
1706
1639
  metaNow: () => Promise<Record<string, string>>;
1707
1640
  renewed: (payload: unknown, sent: Record<string, string>) => Promise<boolean>;
1708
1641
  }>;
1709
- callOver: (own: ClientSide, hook: Hook, input: {
1710
- address: string;
1711
- value: unknown;
1712
- meta: Record<string, string>;
1713
- body?: Body;
1714
- }) => Promise<Reply>;
1715
- watchOver: (own: ClientSide, hook: Hook, input: {
1716
- address: string;
1717
- value: unknown;
1718
- meta: Record<string, string>;
1642
+ callOver: (own: ClientSide, hook: Hook, input: Asked) => Promise<Reply>;
1643
+ watchOver: (own: ClientSide, hook: Hook, input: Asked & {
1719
1644
  push: (reply: Reply) => void;
1720
1645
  }) => Promise<void>;
1721
1646
  broke: (hook: Hook, address: string, side?: "client") => (error: unknown) => Failed;
1722
- serveText: (own: ServerSide, hook: Hook, input: {
1723
- address: string;
1724
- text: string;
1725
- meta: Record<string, string>;
1726
- body?: Body;
1727
- }) => Promise<string | null>;
1728
- streamText: (own: ServerSide, hook: Hook, input: {
1729
- address: string;
1730
- text: string;
1731
- meta: Record<string, string>;
1732
- push: (text: string) => void;
1647
+ answer: (own: ServerSide, hook: Hook, input: Asked) => Promise<Reply | null>;
1648
+ stream: (own: ServerSide, hook: Hook, input: Asked & {
1649
+ push: (reply: Reply) => void;
1733
1650
  left?: AbortSignal;
1734
1651
  }) => Promise<boolean>;
1735
1652
  }>;
@@ -1748,7 +1665,7 @@ declare const requestStop: Tag.Handle<AbortSignal>;
1748
1665
  */
1749
1666
  declare function traceparentOf(value: unknown): Observe.Trace | null;
1750
1667
  declare namespace rpc_transport_d_exports {
1751
- export { Answer, Body, BytesLimit, Call, ClientSide, Codec, Context, Entry, Exit, Fault, Hook, Hooks$1 as Hooks, MetaOp, OnError, OnFinish, OnStart, OnSuccess, Open, Outcome$1 as Outcome, Protocol, RenewOp, Reply, RunOptions$1 as RunOptions, Send, ServerSide, Service, Stream, TextServe, TextStream, Watch, bodyShape, callInput, hook, kept, lifecycle, lost, openInput, protocol, request, requestStop, sendInput, traceparentOf, watchInput };
1668
+ export { Answer, Body, BytesLimit, Call, ClientSide, Codec, Context, Entry, Exit, Fault, Hook, Hooks$1 as Hooks, MetaOp, OnError, OnFinish, OnStart, OnSuccess, Open, Outcome$1 as Outcome, Protocol, RenewOp, Reply, RunOptions$1 as RunOptions, Send, ServerSide, Service, Stream, Watch, bodyShape, callInput, hook, kept, lifecycle, lost, protocol, request, requestStop, traceparentOf, watchInput };
1752
1669
  }
1753
1670
  //#endregion
1754
- export { originOf as $, Namespace as A, data as B, Capsule as C, Edge as D, Derived as E, Resource as F, parse as G, isStarting as H, Scope as I, tag as J, readMany as K, Tag as L, Observe as M, Operation as N, LEVELS as O, Random as P, isError as Q, capsule as R, rpc_shape_d_exports as S, Data as T, namespace as U, derived as V, operation as W, Origin as X, Errors as Y, RunResult as Z, Stream as _, Hooks$1 as a, Watch as b, OnStart as c, Body as d, BytesLimit as f, Service as g, Fault as h, Entry as i, Ns as j, Many as k, OnSuccess as l, Codec as m, MetaOp as n, OnError as o, Call as p, resource as q, RenewOp as r, OnFinish as s, rpc_transport_d_exports as t, Answer as u, TextServe as v, Clock as w, Infer as x, TextStream as y, createScope as z };
1671
+ export { isError as $, Many as A, createScope as B, rpc_shape_d_exports as C, Derived as D, Data as E, Random as F, operation as G, derived as H, Resource as I, resource as J, parse as K, Scope as L, Ns as M, Observe as N, Edge as O, Operation as P, RunResult as Q, Tag as R, Shape as S, Clock as T, isStarting as U, data as V, namespace as W, Errors as X, tag as Y, Origin as Z, Stream as _, Hooks$1 as a, ObjectShape as b, OnStart as c, Body as d, originOf as et, BytesLimit as f, Service as g, Fault as h, Entry as i, Namespace as j, LEVELS as k, OnSuccess as l, Codec as m, MetaOp as n, OnError as o, Call as p, readMany as q, RenewOp as r, OnFinish as s, rpc_transport_d_exports as t, Answer as u, Watch as v, Capsule as w, OptionalShape as x, Infer as y, capsule as z };
@@ -1,13 +1,72 @@
1
- import { C as Capsule, D as Edge, F as Resource, I as Scope, L as Tag, N as Operation, P as Random$1, T as Data, b as Watch$1, g as Service$1, m as Codec$1, n as MetaOp$1, p as Call$1, r as RenewOp$1, t as rpc_transport_d_exports, v as TextServe$1, w as Clock$1, y as TextStream$1 } from "./rpc-transport-BY1E1-G-.mjs";
1
+ import { C as rpc_shape_d_exports, E as Data, F as Random$1, I as Resource, L as Scope, O as Edge, P as Operation, R as Tag, S as Shape, T as Clock$1, b as ObjectShape, d as Body, g as Service$1, m as Codec$1, n as MetaOp$1, p as Call$1, r as RenewOp$1, t as rpc_transport_d_exports, v as Watch$1, w as Capsule, x as OptionalShape, y as Infer } from "./rpc-transport-BdaNSxJh.mjs";
2
2
  //#region src/memory.d.ts
3
3
  type Call = Call$1;
4
4
  type Codec = Codec$1;
5
5
  type MetaOp = MetaOp$1;
6
6
  type RenewOp = RenewOp$1;
7
7
  type Service = Service$1;
8
- type TextServe = TextServe$1;
9
- type TextStream = TextStream$1;
10
8
  type Watch = Watch$1;
9
+ /** The text a memory client hands its server: the value as text, and the call's id. */
10
+ declare const textInput: ObjectShape<{
11
+ address: Data.Schema<string> & {
12
+ readonly check: (value: unknown) => {
13
+ readonly value: string;
14
+ readonly issues?: undefined;
15
+ } | {
16
+ readonly issues: readonly Data.SchemaIssue[];
17
+ };
18
+ readonly optional: () => OptionalShape<string>;
19
+ } & {
20
+ regex: (re: RegExp) => Shape<string>;
21
+ };
22
+ meta: Shape<Record<string, string>>;
23
+ body: OptionalShape<Body>;
24
+ execution: OptionalShape<string>;
25
+ value: OptionalShape<unknown>;
26
+ text: Data.Schema<string> & {
27
+ readonly check: (value: unknown) => {
28
+ readonly value: string;
29
+ readonly issues?: undefined;
30
+ } | {
31
+ readonly issues: readonly Data.SchemaIssue[];
32
+ };
33
+ readonly optional: () => OptionalShape<string>;
34
+ } & {
35
+ regex: (re: RegExp) => Shape<string>;
36
+ };
37
+ }>;
38
+ declare const streamInput: ObjectShape<{
39
+ address: Data.Schema<string> & {
40
+ readonly check: (value: unknown) => {
41
+ readonly value: string;
42
+ readonly issues?: undefined;
43
+ } | {
44
+ readonly issues: readonly Data.SchemaIssue[];
45
+ };
46
+ readonly optional: () => OptionalShape<string>;
47
+ } & {
48
+ regex: (re: RegExp) => Shape<string>;
49
+ };
50
+ meta: Shape<Record<string, string>>;
51
+ body: OptionalShape<Body>;
52
+ execution: OptionalShape<string>;
53
+ value: OptionalShape<unknown>;
54
+ text: Data.Schema<string> & {
55
+ readonly check: (value: unknown) => {
56
+ readonly value: string;
57
+ readonly issues?: undefined;
58
+ } | {
59
+ readonly issues: readonly Data.SchemaIssue[];
60
+ };
61
+ readonly optional: () => OptionalShape<string>;
62
+ } & {
63
+ regex: (re: RegExp) => Shape<string>;
64
+ };
65
+ push: Shape<(text: string) => void>;
66
+ left: OptionalShape<AbortSignal>;
67
+ }>;
68
+ type TextServe = Operation.Handle<Promise<string | null>, Infer<typeof textInput>>;
69
+ type TextStream = Operation.Handle<Promise<boolean>, Infer<typeof streamInput>>;
11
70
  type ClientConfig = {
12
71
  peer: Scope.Handle;
13
72
  headers?: Readonly<Record<string, string>>;
@@ -15,14 +74,14 @@ type ClientConfig = {
15
74
  meta?: MetaOp;
16
75
  renew?: RenewOp;
17
76
  };
18
- /** Makes one memory transport. A scope can hold two clients (a public one and a signed one). */
77
+ /** Makes one memory backend. A scope can hold two clients (a public one and a signed one). */
19
78
  export declare function createMemory(): {
20
79
  client: Omit<Capsule.Handle<{
21
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
22
80
  readonly meta: Edge<"optional", Tag.Handle<MetaOp$1>>;
23
81
  readonly renew: Edge<"optional", Tag.Handle<RenewOp$1>>;
24
82
  readonly peer: Edge<"required", Tag.Handle<Scope.Handle>>;
25
83
  readonly headers: Tag.Defaulted<Readonly<Record<string, string>>>;
84
+ readonly codec: Tag.Defaulted<Codec$1>;
26
85
  }, {
27
86
  readonly call: Call$1;
28
87
  readonly watch: Watch$1;
@@ -30,23 +89,23 @@ export declare function createMemory(): {
30
89
  readonly call: Call;
31
90
  readonly watch: Watch;
32
91
  (values: ClientConfig): ReturnType<Capsule.Handle<{
33
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
34
92
  readonly meta: Edge<"optional", Tag.Handle<MetaOp$1>>;
35
93
  readonly renew: Edge<"optional", Tag.Handle<RenewOp$1>>;
36
94
  readonly peer: Edge<"required", Tag.Handle<Scope.Handle>>;
37
95
  readonly headers: Tag.Defaulted<Readonly<Record<string, string>>>;
96
+ readonly codec: Tag.Defaulted<Codec$1>;
38
97
  }, {
39
98
  readonly call: Call$1;
40
99
  readonly watch: Watch$1;
41
100
  }, void>>;
42
101
  };
43
102
  server: Omit<Capsule.Handle<{
44
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
103
+ readonly codec: Tag.Defaulted<Codec$1>;
45
104
  readonly services: Edge<"required", Tag.Handle<readonly Service$1[]>>;
46
105
  readonly strict: Tag.Defaulted<boolean>;
47
106
  }, {
48
- readonly serve: TextServe$1;
49
- readonly serveStream: TextStream$1;
107
+ readonly serve: TextServe;
108
+ readonly serveStream: TextStream;
50
109
  }, void>, never> & {
51
110
  readonly serve: TextServe;
52
111
  readonly serveStream: TextStream;
@@ -55,23 +114,23 @@ export declare function createMemory(): {
55
114
  services: readonly Service[];
56
115
  strict?: boolean;
57
116
  }): ReturnType<Capsule.Handle<{
58
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
117
+ readonly codec: Tag.Defaulted<Codec$1>;
59
118
  readonly services: Edge<"required", Tag.Handle<readonly Service$1[]>>;
60
119
  readonly strict: Tag.Defaulted<boolean>;
61
120
  }, {
62
- readonly serve: TextServe$1;
63
- readonly serveStream: TextStream$1;
121
+ readonly serve: TextServe;
122
+ readonly serveStream: TextStream;
64
123
  }, void>>;
65
124
  };
66
125
  };
67
- /** The default memory transport. */
126
+ /** The default memory backend. */
68
127
  export declare const memory: {
69
128
  client: Omit<Capsule.Handle<{
70
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
71
129
  readonly meta: Edge<"optional", Tag.Handle<MetaOp$1>>;
72
130
  readonly renew: Edge<"optional", Tag.Handle<RenewOp$1>>;
73
131
  readonly peer: Edge<"required", Tag.Handle<Scope.Handle>>;
74
132
  readonly headers: Tag.Defaulted<Readonly<Record<string, string>>>;
133
+ readonly codec: Tag.Defaulted<Codec$1>;
75
134
  }, {
76
135
  readonly call: Call$1;
77
136
  readonly watch: Watch$1;
@@ -79,23 +138,23 @@ export declare const memory: {
79
138
  readonly call: Call;
80
139
  readonly watch: Watch;
81
140
  (values: ClientConfig): ReturnType<Capsule.Handle<{
82
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
83
141
  readonly meta: Edge<"optional", Tag.Handle<MetaOp$1>>;
84
142
  readonly renew: Edge<"optional", Tag.Handle<RenewOp$1>>;
85
143
  readonly peer: Edge<"required", Tag.Handle<Scope.Handle>>;
86
144
  readonly headers: Tag.Defaulted<Readonly<Record<string, string>>>;
145
+ readonly codec: Tag.Defaulted<Codec$1>;
87
146
  }, {
88
147
  readonly call: Call$1;
89
148
  readonly watch: Watch$1;
90
149
  }, void>>;
91
150
  };
92
151
  server: Omit<Capsule.Handle<{
93
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
152
+ readonly codec: Tag.Defaulted<Codec$1>;
94
153
  readonly services: Edge<"required", Tag.Handle<readonly Service$1[]>>;
95
154
  readonly strict: Tag.Defaulted<boolean>;
96
155
  }, {
97
- readonly serve: TextServe$1;
98
- readonly serveStream: TextStream$1;
156
+ readonly serve: TextServe;
157
+ readonly serveStream: TextStream;
99
158
  }, void>, never> & {
100
159
  readonly serve: TextServe;
101
160
  readonly serveStream: TextStream;
@@ -104,12 +163,12 @@ export declare const memory: {
104
163
  services: readonly Service[];
105
164
  strict?: boolean;
106
165
  }): ReturnType<Capsule.Handle<{
107
- readonly codec: Edge<"optional", Tag.Handle<Codec$1>>;
166
+ readonly codec: Tag.Defaulted<Codec$1>;
108
167
  readonly services: Edge<"required", Tag.Handle<readonly Service$1[]>>;
109
168
  readonly strict: Tag.Defaulted<boolean>;
110
169
  }, {
111
- readonly serve: TextServe$1;
112
- readonly serveStream: TextStream$1;
170
+ readonly serve: TextServe;
171
+ readonly serveStream: TextStream;
113
172
  }, void>>;
114
173
  };
115
174
  };
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{c as o,l as s,o as c,s as l}from"./rpc-CNYewB1t.mjs";const u=Symbol(`preset`),{callInput:d,kept:f,lost:p,protocol:m,request:h,requestStop:g,traceparentOf:_,watchInput:v}=c,y=d.extend({value:s().optional(),text:o()}),b=y.extend({push:l(e=>typeof e==`function`),left:l(e=>e instanceof AbortSignal).optional()}),x={serialize:e=>JSON.stringify(e??null),deserialize:e=>JSON.parse(e)},S=(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=(e,t)=>(n,i)=>{try{return{ok:!0,value:t(i)}}catch(t){return r(e,n,t)}},a=i(`encode`,t=>e.serialize(t)),o=i(`decode`,t=>e.deserialize(t));return{encode:a,decode:o,answerText:(t,n)=>{let r=a(t,n);return r.ok?r.value:e.serialize(r)},replyOf:(e,t)=>{let n=o(e,t);return n.ok?n.value:n}}},C=p({ok:!1,kind:`link`,sent:!1}),w=p({ok:!1,kind:`missing`}),T=p({ok:!1,kind:`link`,sent:!0}),E=(e,t,n,r)=>{let i=new Request(`http://memory/${n.address}`,{headers:t});try{return e.createSession({trace:_({...n.meta,...r}.traceparent),tags:[h(i),g(i.signal)]})}catch{return null}},D=(e,t)=>({...e,left:AbortSignal.any([e.left??t,t]),push:n=>t.aborted||e.push(n)}),O=(e,t)=>t.then(t=>e.aborted?void 0:t),k=n({label:`memory.served`,initial:null}),A=({side:e,codec:t,protocol:n},r,i,{text:a,...o})=>{let{decode:s,answerText:c}=S(t,`server`,r),l=async e=>e&&c(o.address,e),u=e=>o.push(c(o.address,e)),d=s(o.address,a);if(!d.ok)return i?l(d):Promise.resolve().then(()=>(u(d),!0));let f={...o,value:d.value};return i?n.answer(e,r,f).then(l):n.stream(e,r,{...f,push:u})};function j(){let r=e({label:`memory.serve`,input:y,run:()=>{throw Error(`memory: no server here`)}}),a=e({label:`memory.serveStream`,input:b,run:()=>{throw Error(`memory: no server here`)}}),o=t({label:`memory.peer`}),s=t({label:`memory.headers`,default:{}}),c=t({label:`memory.codec`,default:x}),l={meta:t({label:`memory.meta`}).optional,renew:t({label:`memory.renew`}).optional},u={peer:o.required,headers:s,codec:c,protocol:m},p=({peer:e,headers:t,codec:n,protocol:r},i,a,o)=>{let s=S(n,`client`,o),c=s.encode(i.address,i.value);if(!c.ok)return{fault:c};let l=E(e,t,i,r.traceparent(a)),u=l?.resolve(k);if(!l||!u)return{fault:C,session:l};let{value:d,...f}=i;return{session:l,ops:u,code:s,sent:{...f,text:c.value}}},h=e({label:`memory.send`,input:d,depends:u,run:async(e,t)=>{let{input:n}=t,r=p(e,n,t.obs.span,t);if(!r.ops)return await r.session?.close(),r.fault;let{session:i,ops:a,code:o,sent:s}=r,c=await i.run(a.serve,{input:s}).finally(()=>i.close());return c===void 0?T:c===null?w:o.replyOf(n.address,c)}}),g=e({label:`memory.open`,input:v,depends:u,run:async(e,t)=>{let{input:n,signal:r}=t,i=p(e,n,t.obs.span,t);if(!i.ops)return await i.session?.close(),i.fault;let{session:a,ops:o,code:s,sent:c}=i,l=e=>n.push(s.replyOf(n.address,e));return a.run(o.serveStream,{input:{...c,push:l,left:r}}).then(e=>e===void 0?T:e?{ok:!0}:w).finally(()=>a.close())}}),_=e({label:`memory.call`,input:d,run:()=>{throw Error(`memory: no transport here`)}}),j=e({label:`memory.watch`,input:v,run:()=>{throw Error(`memory: no transport here`)}}),M=n({label:`transport.client`,initial:null}),N=i({label:`memory`,config:{peer:o.required,headers:s,codec:c,...l},exports:{call:_,watch:j},hooks:{async start({config:e,load:t,next:n}){let r=await t(m,f),{meta:i,renew:a}=e;return t(M,f).set({protocol:r,side:{send:h,open:g,meta:r.given(i),renew:r.given(a)}}),n()},run(e){let{op:t,call:n}=e;if(t!==_&&t!==j)return e.next();let{run:r,log:i,load:a}=e,{side:o,protocol:s}=a(M,f).get(),c={run:r,log:i,signal:n?.signal},l=n?.input??n?.rawInput;return t===_?s.callOver(o,c,l):s.watchOver(o,c,l)}}}),P=n({label:`transport.server`,initial:null});return{client:N,server:i({label:`memory.server`,config:{codec:t({label:`memory.server.codec`,default:x}),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(m,f),c=s.routesOf(e.services,i,o,e.strict);return t(P,f).set({side:{routes:c},codec:e.codec,protocol:s}),t(k,f).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,load:o,closing:s}=e,c={run:i,log:e.log,signal:n?.signal},l=Object(n?.input??n?.rawInput),u=t===r,d=u?l:D(l,s);return O(s,A(o(P,f).get(),c,u,d))}}})}}const M=j();function N(e){let t=Math.trunc(e);return BigInt(t)*1000000n+BigInt(Math.round((e-t)*1e6))}function P(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:()=>N(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 F(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 I(e,t){return{[u]:!0,node:e,replacement:t}}export{j as createMemory,P as makeTestClock,F as makeTestRandom,M as memory,I 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.25.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.25.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.25.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.25.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.25.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.25.0'
17
17
  requires:
18
18
  - core
19
19
  - capsule
@@ -123,6 +123,8 @@ capsules: [
123
123
  Two services with one address fail the start
124
124
  with `DuplicateAddress`. So two boards cannot
125
125
  both have a cell named `flows`: rename one.
126
+ - A keyed cell `tasks` serves `tasks` and its ask,
127
+ `tasks.ask`. An rpc op must not use either name.
126
128
 
127
129
  ### Call and read on the client
128
130
 
@@ -144,6 +146,9 @@ const list = useData(
144
146
  the list.
145
147
  - `board.invalidate` marks a part dirty, so its
146
148
  readers ask again.
149
+ - `sea.board({ read, refetchInterval: { waves:
150
+ 30_000 } })` makes each part in use ask again
151
+ every 30 s. With none, it never asks by time.
147
152
  - A call ends at its reply, as a TanStack Query
148
153
  mutation. To see your own write at once, run
149
154
  `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.25.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};