@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 +60 -0
- package/dist/index.d.mts +11 -5
- package/dist/index.mjs +1 -1
- package/dist/rpc-CNYewB1t.mjs +1 -0
- package/dist/{rpc-transport-BY1E1-G-.d.mts → rpc-transport-BdaNSxJh.d.mts} +34 -117
- package/dist/testing.d.mts +80 -21
- package/dist/testing.mjs +1 -1
- package/package.json +1 -1
- package/skills/core/SKILL.md +1 -1
- package/skills/core/capsule/SKILL.md +1 -1
- package/skills/core/data/SKILL.md +1 -1
- package/skills/core/operation/SKILL.md +1 -1
- package/skills/core/rpc/SKILL.md +6 -1
- package/skills/core/testing/SKILL.md +1 -1
- package/dist/rpc-BS1Kd6Fl.mjs +0 -1
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
|
|
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
|
|
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
|
|
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
|
|
83
|
-
* `
|
|
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-
|
|
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
|
|
1313
|
-
* side said no one serves the address; `link` when the path failed, `sent: false` when
|
|
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
|
-
*
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
1673
|
-
|
|
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
|
|
1683
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
1723
|
-
|
|
1724
|
-
|
|
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,
|
|
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 {
|
|
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 };
|
package/dist/testing.d.mts
CHANGED
|
@@ -1,13 +1,72 @@
|
|
|
1
|
-
import { C as
|
|
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
|
|
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:
|
|
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
|
|
49
|
-
readonly serveStream: TextStream
|
|
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:
|
|
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
|
|
63
|
-
readonly serveStream: TextStream
|
|
121
|
+
readonly serve: TextServe;
|
|
122
|
+
readonly serveStream: TextStream;
|
|
64
123
|
}, void>>;
|
|
65
124
|
};
|
|
66
125
|
};
|
|
67
|
-
/** The default memory
|
|
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:
|
|
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
|
|
98
|
-
readonly serveStream: TextStream
|
|
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:
|
|
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
|
|
112
|
-
readonly serveStream: TextStream
|
|
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-
|
|
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
package/skills/core/SKILL.md
CHANGED
package/skills/core/rpc/SKILL.md
CHANGED
|
@@ -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.
|
|
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.
|
package/dist/rpc-BS1Kd6Fl.mjs
DELETED
|
@@ -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};
|