@earendil-works/chord 1.4.0 → 1.5.1

package/dist/remote/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/remote/provider.ts"],"names":[],"mappings":"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","sourcesContent":["// The provider side of one origin on a link (§3, §22, W1; decision \"Relay flow control per origin\"): the holds the\n// peer sent for that origin, served here or relayed, by their ids; the calls on them, at most this side's N at once;\n// and the window: at most K unacknowledged `bound` and `state` messages of this host's own, with what waits meanwhile\n// (a call's answer sends the waiting state first, past the window), and the sender of every message in flight, so each\n// `ack` reaches the host that sent its message. A served call's method runs under the call's carrier (slice 9).\n\nimport type { TelemetryContext } from \"@earendil-works/pi-telemetry\";\nimport { type Context, withAbortSignal } from \"../context/index.ts\";\nimport { ChordError, isChordError, type Principal } from \"../data/index.ts\";\nimport { asRemoteOldWork, type Caller } from \"../host/internal.ts\";\nimport {\n\ttype BoundEntry,\n\ttype ConsumerMessage,\n\tDeflatedPart,\n\ttype Message,\n\ttype OriginMessage,\n\toversized,\n\ttype ProviderMessage,\n\tparsePayload,\n\tpayloadPart,\n\ttype StateEntry,\n\twireError,\n} from \"../link/internal.ts\";\nimport { type OpenSpan, parentOf } from \"../telemetry.ts\";\nimport { Hold } from \"./hold.ts\";\nimport type { HostLink } from \"./host-link.ts\";\nimport { type RelayedHold, relayEnded } from \"./relay.ts\";\n\n/**\n * A call being handled: on a hold served here, with whether its result carries byte segments and the abort of its\n * handler's context; or relayed, its reply forwarded from upstream.\n */\ntype RunningCall =\n\t| { readonly kind: \"served\"; readonly hold: Hold; readonly bytes: boolean; readonly abort: AbortController }\n\t/** `span`: its `chord.relay` span while its reply is awaited, when this host records. */\n\t| { readonly kind: \"relayed\"; readonly hold: RelayedHold; span?: OpenSpan<\"chord.relay\"> };\n\n/** Who sent a `bound` or `state` message in flight: this host, or the upstream link a relay forwarded it from. */\ntype Sender = \"local\" | HostLink;\n\n/** A relaying origin: its number on upstream links, and the open upstream links it relayed holds to. */\ntype Relay = { readonly origin: number; readonly links: Set<HostLink> };\n\n/**\n * At most this many of this host's own `bound` and `state` messages unacknowledged per origin; past it only the waiting\n * state a call's answer sends first.\n */\nconst WINDOW = 2;\n\n/**\n * The provider side of one origin on a link. Ids are the origin's; a message naming an id this side does not know is\n * ignored (Q1), one reusing a live id is a protocol error, and so are more concurrent calls than this side announced.\n * This host's own `bound` and `state` messages go through the window: locally served holds wait while it is full\n * (their ops in their members' pending queues, their bindings for the next slot); a call's answer, its own or a\n * relayed one, sends the waiting state first. A relay forwards upstream messages at once (each upstream host keeps its\n * own window for the origin it sees), so a slow consumer stalls only its origin.\n */\nexport class ProviderSide {\n\treadonly link: HostLink;\n\t/** Whose work this side serves: 0 for the peer's own, a relay's number for one of its downstream links. */\n\treadonly origin: number;\n\treadonly #calls = new Map<number, RunningCall>();\n\treadonly #entries = new Map<number, Hold | RelayedHold>();\n\treadonly #limit: number;\n\t/** The sender of each `bound` and `state` message in flight, in order: the consumer acknowledges in order. */\n\treadonly #sent: Sender[] = [];\n\t/** This host's own messages in flight. */\n\t#inFlight = 0;\n\t/** How many of this host's own `bound` and `state` messages it sent, and how many its consumer acknowledged. */\n\t#ownSent = 0;\n\t#ownAcked = 0;\n\t/** The holds the current batch touched, in order; its flush sends or queues them. */\n\t#touched: Hold[] = [];\n\t/** Holds whose ops wait in their pending queues for a slot. */\n\treadonly #waiting = new Set<Hold>();\n\t/** Holds waiting for a slot to send their first binding. */\n\treadonly #binding = new Set<Hold>();\n\t/** The waiting bindings take the next slot: the last one went to waiting state while they waited. */\n\t#bindingTurn = false;\n\t/** Set once a hold of this origin is relayed. */\n\t#relay: Relay | undefined;\n\t/** When state began waiting for a slot (`performance.now()`), while some waits: `chord.backpressure.wait`. */\n\t#waitingSince: number | undefined;\n\n\tconstructor(link: HostLink, origin: number, limit: number) {\n\t\tthis.link = link;\n\t\tthis.origin = origin;\n\t\tthis.#limit = limit;\n\t}\n\n\t/** Handles one message of this origin; a call whose arguments wait for an asynchronous inflate returns its promise. */\n\tmessage(message: ProviderMessage): void | Promise<void> {\n\t\tswitch (message.kind) {\n\t\t\tcase \"hold\":\n\t\t\t\tthis.#hold(message);\n\t\t\t\tbreak;\n\t\t\tcase \"release\":\n\t\t\t\tthis.#release(message.hold);\n\t\t\t\tthis.#settle();\n\t\t\t\tbreak;\n\t\t\tcase \"call\":\n\t\t\t\treturn this.#call(message);\n\t\t\tcase \"abort\":\n\t\t\t\tthis.#abort(message.call);\n\t\t\t\tthis.#settle();\n\t\t\t\tbreak;\n\t\t\tcase \"retry\":\n\t\t\t\tthis.#entries.get(message.hold)?.retry(message);\n\t\t\t\tbreak;\n\t\t\tcase \"ack\":\n\t\t\t\tthis.#ack();\n\t\t\t\tthis.#settle();\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\t/**\n\t * The link closed, or the origin did (`closed`): every hold is released (relayed ones by one `closed` to each\n\t * upstream link) and every call aborted.\n\t */\n\tclosed(): void {\n\t\tconst closing = this.link.host.closing;\n\t\tconst entries = [...this.#entries.values()];\n\t\tthis.#entries.clear();\n\t\tconst closed = new ChordError({ code: \"unavailable\", message: \"the link closed\" });\n\t\tfor (const call of this.#calls.values()) {\n\t\t\tif (call.kind === \"served\") call.abort.abort(closed);\n\t\t\telse if (call.span !== undefined) relayEnded(call.span, undefined);\n\t\t}\n\t\tthis.#calls.clear();\n\t\t// While the host closes, it ends its objects itself.\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.kind === \"served\" && !closing) entry.release();\n\t\t\telse entry.drop();\n\t\t}\n\t\t// A batch flushing later finds nothing of this side.\n\t\tthis.#touched = [];\n\t\tconst relay = this.#relay;\n\t\tif (relay === undefined) return;\n\t\tthis.link.host.relays.delete(relay.origin);\n\t\tfor (const link of relay.links) link.send({ kind: \"closed\", origin: relay.origin });\n\t}\n\n\t/** Sends `message` on the link with this origin. */\n\tsend(message: OriginMessage): void {\n\t\tthis.link.send(this.origin === 0 ? message : { ...message, origin: this.origin });\n\t}\n\n\t/**\n\t * Ends with `error` every hold of this origin that acts for a principal `revoked` names and holds nothing: served\n\t * here but unbound (before the publication, refused), or relayed and waiting for its route's link.\n\t */\n\trevokeUnbound(revoked: (principal: Principal) => boolean, error: ChordError): void {\n\t\tfor (const hold of [...this.#entries.values()]) {\n\t\t\t// A hold arriving on a link acts for a principal: the link's, or one its parent named.\n\t\t\tif (!revoked(hold.caller.principal!)) continue;\n\t\t\tif (hold.kind === \"served\" && hold.unbound) hold.end(error);\n\t\t\telse if (hold.kind === \"relayed\" && hold.waiting) hold.revoked(error);\n\t\t}\n\t}\n\n\t/** A pending hold turned out to be relayed: it takes the hold's place in the table. */\n\trelayed(hold: RelayedHold): void {\n\t\tthis.#entries.set(hold.id, hold);\n\t}\n\n\t/** This origin's number on upstream links (one per host, never reused), with `link` as one it relays to. */\n\trelayTo(link: HostLink): number {\n\t\tlet relay = this.#relay;\n\t\tif (relay === undefined) {\n\t\t\trelay = { origin: this.link.host.relayOrigin(this), links: new Set() };\n\t\t\tthis.#relay = relay;\n\t\t}\n\t\trelay.links.add(link);\n\t\treturn relay.origin;\n\t}\n\n\t/**\n\t * A message from upstream link `from` for this origin's relayed holds, forwarded with this origin: `bound` and\n\t * `state` join the window's senders (their `ack` goes back to `from`), a reply ends its call (after this host's own\n\t * waiting state: `reply`), `gone` forgets its hold. A link answers only for what was relayed over it: an entry, a\n\t * notice or a reply naming a hold (or a call) this origin did not relay over `from` is dropped (Q1); a `bound` or\n\t * `state` left without entries is acknowledged to `from` at once. Parts travel unchecked and unparsed: the end that\n\t * parses a part checks it against its own link's limits.\n\t */\n\tforward(message: ConsumerMessage, from: HostLink): void {\n\t\tconst relay = this.#relay;\n\t\tif (relay === undefined || !relay.links.has(from)) return;\n\t\tconst { origin: _, ...forwarded } = message;\n\t\tswitch (forwarded.kind) {\n\t\t\tcase \"bound\":\n\t\t\tcase \"state\": {\n\t\t\t\tconst holds = this.#relayedOver<BoundEntry | StateEntry>(forwarded.holds, from);\n\t\t\t\tif (holds.length === 0) {\n\t\t\t\t\tfrom.send({ kind: \"ack\", origin: relay.origin });\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.#sent.push(from);\n\t\t\t\t// The entries of the message's own kind.\n\t\t\t\tthis.send(holds === forwarded.holds ? forwarded : ({ ...forwarded, holds } as typeof forwarded));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"result\":\n\t\t\tcase \"error\": {\n\t\t\t\tconst call = this.#calls.get(forwarded.call);\n\t\t\t\tif (call?.kind === \"relayed\" && call.hold.heldOn(from)) this.reply(forwarded.call, forwarded);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"gone\": {\n\t\t\t\tconst hold = this.#relayedHold(forwarded.hold, from);\n\t\t\t\tif (hold === undefined) return;\n\t\t\t\thold.lost();\n\t\t\t\tthis.send(forwarded);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tdefault:\n\t\t\t\tif (this.#relayedHold(forwarded.hold, from) !== undefined) this.send(forwarded);\n\t\t}\n\t}\n\n\t/** An upstream link closed: nothing more is relayed to it, nor accepted from it. */\n\tunlinked(link: HostLink): void {\n\t\tthis.#relay?.links.delete(link);\n\t}\n\n\t/**\n\t * The upstream link of relayed hold `hold` dropped with `error`: its calls in flight fail, the hold goes loading\n\t * downstream, and its path's next link holds it again.\n\t */\n\tupstreamDropped(hold: RelayedHold, error: ChordError): void {\n\t\tfor (const [id, call] of this.#calls) {\n\t\t\tif (call.hold === hold) this.reply(id, { kind: \"error\", call: id, error: wireError(error) });\n\t\t}\n\t\tthis.send({ kind: \"loading\", hold: hold.id });\n\t}\n\n\t/**\n\t * Forgets a hold (released, refused or gone) and every call on it; local calls are aborted with `error` (its\n\t * object's end for a gone hold, `released` otherwise).\n\t */\n\tforget(hold: Hold | RelayedHold, error?: ChordError): void {\n\t\tif (this.#entries.get(hold.id) === hold) this.#entries.delete(hold.id);\n\t\tconst reason = error ?? new ChordError({ code: \"released\", message: `hold ${hold.id}: released` });\n\t\tfor (const [id, call] of this.#calls) {\n\t\t\tif (call.hold !== hold) continue;\n\t\t\tthis.#calls.delete(id);\n\t\t\tif (call.kind === \"served\") call.abort.abort(reason);\n\t\t\telse if (call.span !== undefined) relayEnded(call.span, undefined);\n\t\t}\n\t\tif (hold.kind === \"served\") this.unbind(hold);\n\t\tthis.#settle();\n\t}\n\n\t/**\n\t * A call ended with `reply` (a result or an error, its own or forwarded from upstream): its slot is free; nothing is\n\t * sent for one already gone. The state waiting for a slot goes first, past the window if it is full (decision \"A\n\t * call's answer follows its state\"): when the call settles at the consumer, every change this host committed before\n\t * answering is applied there.\n\t */\n\treply(id: number, reply: Extract<OriginMessage, { readonly kind: \"result\" | \"error\" }>): void {\n\t\tconst call = this.#calls.get(id);\n\t\tif (call === undefined) return;\n\t\tthis.#calls.delete(id);\n\t\t// At most one extra message per answer, acknowledged before the call its answer frees a slot for (one direction keeps\n\t\t// its order): running calls and messages past the window stay within this side's N together.\n\t\tif (this.#waiting.size > 0) this.#sendWaiting(this.link.context);\n\t\tthis.send(reply);\n\t\tif (call.kind === \"relayed\" && call.span !== undefined) relayEnded(call.span, reply);\n\t\tthis.#settle();\n\t}\n\n\t/**\n\t * Drops this side from its link once it holds nothing: no holds, no calls, nothing in flight. Its origin's next hold\n\t * makes a new one (origins are never reused), so a long-lived link keeps records only for live work.\n\t */\n\t#settle(): void {\n\t\tif (this.#entries.size === 0 && this.#calls.size === 0 && this.#sent.length === 0) this.link.drop(this);\n\t}\n\n\t/** A hold's object is live: its `bound` goes now when a slot is free, else with the next free slot's bindings. */\n\tbind(hold: Hold, context: Context): void {\n\t\tif (this.#free) {\n\t\t\tthis.#sendOwn({ kind: \"bound\", holds: [hold.boundEntry(context)] });\n\t\t} else {\n\t\t\tthis.#binding.add(hold);\n\t\t}\n\t}\n\n\t/** A hold stopped waiting for a slot: it was forgotten. */\n\tunbind(hold: Hold): void {\n\t\tthis.#waiting.delete(hold);\n\t\tthis.#binding.delete(hold);\n\t\t// Nothing waits any more: no wait to record.\n\t\tif (this.#waiting.size === 0) this.#waitingSince = undefined;\n\t}\n\n\t/**\n\t * A served hold left its object's binding with `error` (a failure, a removal or a version no longer bound; slice 7b\n\t * §6, model §5): as `unbind`, and its calls in flight rejected with `error` (each slot freed once). A hold unbinding\n\t * with `loading` keeps them (`unbind` alone).\n\t */\n\tunbound(hold: Hold, error: ChordError): void {\n\t\tthis.unbind(hold);\n\t\tfor (const [id, call] of this.#calls) {\n\t\t\tif (call.hold !== hold) continue;\n\t\t\tif (call.kind === \"served\") call.abort.abort(error);\n\t\t\tthis.reply(id, { kind: \"error\", call: id, error: wireError(error) });\n\t\t}\n\t}\n\n\t/** A hold's members changed in the current batch; its flush sends or queues it. */\n\ttouched(hold: Hold): void {\n\t\tif (this.#touched.length === 0) this.link.host.batch.flushing((context) => this.#flush(context));\n\t\tthis.#touched.push(hold);\n\t}\n\n\t/**\n\t * `entries` whose holds this origin relayed over `from`, in one pass: the same array when all are, else a copy made\n\t * at the first one that is not.\n\t */\n\t#relayedOver<E extends { readonly hold: number }>(entries: readonly E[], from: HostLink): readonly E[] {\n\t\tlet kept: E[] | undefined;\n\t\tfor (let i = 0; i < entries.length; i++) {\n\t\t\tconst entry = entries[i]!;\n\t\t\tconst relayed = this.#relayedHold(entry.hold, from) !== undefined;\n\t\t\tif (kept !== undefined) {\n\t\t\t\tif (relayed) kept.push(entry);\n\t\t\t} else if (!relayed) {\n\t\t\t\tkept = entries.slice(0, i);\n\t\t\t}\n\t\t}\n\t\treturn kept ?? entries;\n\t}\n\n\t/** The hold `id` of this origin when it is relayed over `from`. */\n\t#relayedHold(id: number, from: HostLink): RelayedHold | undefined {\n\t\tconst hold = this.#entries.get(id);\n\t\treturn hold?.kind === \"relayed\" && hold.heldOn(from) ? hold : undefined;\n\t}\n\n\t/**\n\t * A hold message: a protocol error for a live id or compressed params (params are never compressed), otherwise\n\t * admitted (`Hold.start`, placed once the host published). Its activation chain is kept only from a trusted link (Q5); its\n\t * decoded limit is the link's, or the smaller one a parent stamped (Q2), and travels with it when it is relayed.\n\t */\n\t#hold(message: Extract<Message, { readonly kind: \"hold\" }>): void {\n\t\tif (this.#entries.has(message.hold)) throw new Error(`hold ${message.hold}: the id is in use`);\n\t\tif (message.params instanceof DeflatedPart) throw new Error(`hold ${message.hold}: compressed params`);\n\t\t// Whom it acts for is decided here once (`#caller`), never passed on: a relay names it only on a route link.\n\t\tconst {\n\t\t\tkind: _kind,\n\t\t\torigin: _origin,\n\t\t\thold: id,\n\t\t\tprincipal: _principal,\n\t\t\tincarnation: _incarnation,\n\t\t\tchain,\n\t\t\tlimit: stamped,\n\t\t\t...fields\n\t\t} = message;\n\t\tconst { link } = this;\n\t\tconst limit = Math.min(link.limits.decoded, (link.role === \"parent\" ? stamped : undefined) ?? Infinity);\n\t\tconst request = {\n\t\t\t...fields,\n\t\t\t...(chain !== undefined && link.trusted ? { chain } : {}),\n\t\t\t...(limit === Infinity ? {} : { limit }),\n\t\t};\n\t\tconst limits = limit === link.limits.decoded ? link.limits : { part: link.limits.part, decoded: limit };\n\t\tconst hold = new Hold(id, this, this.#caller(message), limits);\n\t\tthis.#entries.set(id, hold);\n\t\thold.start(request);\n\t}\n\n\t/**\n\t * Whom a hold acts for: on a parent link the hold's own principal and incarnation when it names them, everywhere\n\t * else the link's principal and the peer's incarnation (a child cannot claim to be someone else).\n\t */\n\t#caller(message: Extract<Message, { readonly kind: \"hold\" }>): Caller {\n\t\tconst { link } = this;\n\t\tif (link.role !== \"parent\") return { principal: link.principal, incarnation: link.peer };\n\t\t// The message schema checked a principal's shape on an untrusted link; a trusted parent is believed.\n\t\tconst principal = (message.principal as Caller[\"principal\"]) ?? link.principal;\n\t\treturn { principal, incarnation: message.incarnation ?? link.peer };\n\t}\n\n\t#release(id: number): void {\n\t\tconst hold = this.#entries.get(id);\n\t\tif (hold === undefined) return;\n\t\tthis.forget(hold);\n\t\thold.release();\n\t}\n\n\t/**\n\t * A call: one on a hold this side does not know is ignored (Q1), more than this side's N at once and compressed\n\t * arguments from a child (clients never compress) are protocol errors. On a relayed hold it is forwarded, its\n\t * arguments checked against this link's part limit first (the bytes are here). On a served hold that is not callable\n\t * (not bound yet, nor rebinding by the names its consumer still has after a `loading`) it is\n\t * refused `not_ready`; its method is an index into the bound variant (one outside it is a protocol error) and its\n\t * arguments are opened and parsed here within the hold's limits (past one the call fails `too_large/part`; a\n\t * malformed part is a protocol error), absent ones `null`. Arguments this host must inflate asynchronously are\n\t * inflated first, then the call is handled again.\n\t */\n\t#call(message: Extract<Message, { readonly kind: \"call\" }>): void | Promise<void> {\n\t\tif (this.#calls.has(message.call)) throw new Error(`call ${message.call}: the id is in use`);\n\t\tconst hold = this.#entries.get(message.hold);\n\t\tif (hold === undefined) return;\n\t\tif (this.#calls.size >= this.#limit) throw new Error(`call ${message.call}: more than ${this.#limit} calls`);\n\t\tconst { args: part, segments } = message;\n\t\tif (part instanceof DeflatedPart && this.link.role === \"child\") {\n\t\t\tthrow new Error(`call ${message.call}: compressed arguments from a child`);\n\t\t}\n\t\tif (hold.kind === \"relayed\") {\n\t\t\tconst error = part === undefined ? undefined : oversized(part, this.link.limits.part);\n\t\t\tif (error !== undefined) {\n\t\t\t\tthis.#refuse(message.call, error);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst relayed: RunningCall = { kind: \"relayed\", hold };\n\t\t\tthis.#calls.set(message.call, relayed);\n\t\t\t// Registered first: a hold without an upstream link answers at once.\n\t\t\trelayed.span = hold.call(message);\n\t\t\treturn;\n\t\t}\n\t\tif (!hold.callable) {\n\t\t\tthis.#refuse(message.call, hold.refusal);\n\t\t\treturn;\n\t\t}\n\t\tconst method = hold.method(message.method);\n\t\tif (this.link.inflates(part, hold.limits)) {\n\t\t\treturn this.link.inflate([[part, hold.limits.decoded]], () => this.#call(message));\n\t\t}\n\t\tlet json: string | Uint8Array | undefined;\n\t\ttry {\n\t\t\tjson = part === undefined ? undefined : this.link.openPart(part, hold.limits, this.link.context);\n\t\t} catch (error) {\n\t\t\tif (!isChordError(error, \"too_large\")) throw error;\n\t\t\tthis.#refuse(message.call, error);\n\t\t\treturn;\n\t\t}\n\t\tconst args = json === undefined ? null : parsePayload(json, segments);\n\t\tconst call = { kind: \"served\", hold, bytes: method.resultBytes, abort: new AbortController() } as const;\n\t\tthis.#calls.set(message.call, call);\n\t\t// The caller's span over the link: its carrier with this host's adapter (absent or unknown: the adapter's root).\n\t\tconst parent = parentOf(message.trace, this.link.host.telemetry);\n\t\t// Old work of another host's reload (`call.old`), honoured only from a trusted link (decision \"Reload restarts\n\t\t// every affected object\"): it runs on open old attempts here, and counts as this host's old work while it runs.\n\t\tif (message.old === true && this.link.trusted) {\n\t\t\tconst { oldWork } = this.link.host;\n\t\t\toldWork.open();\n\t\t\tconst close = (): void => oldWork.close();\n\t\t\tthis.#run(message.call, call, method.name, args, parent, asRemoteOldWork(this.link.context)).then(\n\t\t\t\tclose,\n\t\t\t\tclose,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\tthis.#run(message.call, call, method.name, args, parent, this.link.context);\n\t}\n\n\t/**\n\t * Runs a call under `scope` (the link's context, marked when it is another host's old work) and sends its result\n\t * (absent when `null`) or error, unless it was aborted, released or gone meanwhile. A result that cannot be encoded\n\t * is sent as its error. Returns the handler's settling.\n\t */\n\t#run(\n\t\tid: number,\n\t\tcall: Extract<RunningCall, { readonly kind: \"served\" }>,\n\t\tmethod: string,\n\t\targs: unknown,\n\t\tparent: TelemetryContext,\n\t\tscope: Context,\n\t): Promise<unknown> {\n\t\tconst context = withAbortSignal(call.abort.signal, scope);\n\t\tlet running: Promise<unknown>;\n\t\ttry {\n\t\t\trunning = call.hold.call(method, args, parent, context);\n\t\t} catch (error) {\n\t\t\trunning = Promise.reject(error);\n\t\t}\n\t\trunning.then(\n\t\t\t(result) => {\n\t\t\t\tlet reply: Extract<OriginMessage, { readonly kind: \"result\" | \"error\" }>;\n\t\t\t\ttry {\n\t\t\t\t\treply =\n\t\t\t\t\t\tresult === null || result === undefined\n\t\t\t\t\t\t\t? { kind: \"result\", call: id }\n\t\t\t\t\t\t\t: this.#result(id, result, call.bytes, this.link.context);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treply = { kind: \"error\", call: id, error: wireError(error) };\n\t\t\t\t}\n\t\t\t\tthis.reply(id, reply);\n\t\t\t},\n\t\t\t(error: unknown) => this.reply(id, { kind: \"error\", call: id, error: wireError(error) }),\n\t\t);\n\t\treturn running;\n\t}\n\n\t/** Answers call `id` with `error` before it was admitted: it took no slot. */\n\t#refuse(id: number, error: ChordError): void {\n\t\tthis.send({ kind: \"error\", call: id, error: wireError(error) });\n\t}\n\n\t#abort(id: number): void {\n\t\tconst call = this.#calls.get(id);\n\t\tif (call === undefined) return;\n\t\tthis.#calls.delete(id);\n\t\tif (call.kind === \"served\") {\n\t\t\tcall.abort.abort(new ChordError({ code: \"aborted\", message: `call ${id}: aborted by its caller` }));\n\t\t\treturn;\n\t\t}\n\t\tcall.hold.abort(id);\n\t\tif (call.span !== undefined) relayEnded(call.span, undefined);\n\t}\n\n\t/**\n\t * An `ack` answers the oldest message in flight: this host's own frees a slot, a relayed one is acknowledged to its\n\t * upstream link (closed meanwhile: nothing to do). An ack crossing nothing in flight is ignored.\n\t */\n\t#ack(): void {\n\t\tconst sender = this.#sent.shift();\n\t\tif (sender === undefined) return;\n\t\tif (sender !== \"local\") {\n\t\t\t// A relayed message implies the relay's number.\n\t\t\tsender.send({ kind: \"ack\", origin: this.#relay!.origin });\n\t\t\treturn;\n\t\t}\n\t\tthis.#inFlight--;\n\t\tthis.#ownAcked++;\n\t\tthis.#slotFreed();\n\t}\n\n\t/** The number the next of this host's own `bound` and `state` messages gets (counted from 1). */\n\tget nextOwn(): number {\n\t\treturn this.#ownSent + 1;\n\t}\n\n\t/**\n\t * Whether its consumer acknowledged this host's own message number `own`, so applied it: a call it sent after that\n\t * arrives after the `ack` (one direction keeps its order).\n\t */\n\tacknowledged(own: number): boolean {\n\t\treturn this.#ownAcked >= own;\n\t}\n\n\t/**\n\t * The end of a batch: while a slot is free and nothing waits, one `state` message with an entry per touched hold;\n\t * otherwise each touched hold's ops join its pending queues until a slot frees.\n\t */\n\t#flush(context: Context): void {\n\t\tconst holds = this.#touched;\n\t\t// The side closed during the batch: nothing is sent.\n\t\tif (holds.length === 0) return;\n\t\tthis.#touched = [];\n\t\t// A hold touched in this batch may have left its binding since (a reload unbound it).\n\t\tif (this.#free) {\n\t\t\tconst entries: StateEntry[] = [];\n\t\t\tfor (const hold of holds) if (hold.bound) entries.push(hold.entry(context));\n\t\t\tif (entries.length > 0) this.#sendOwn({ kind: \"state\", holds: entries });\n\t\t\treturn;\n\t\t}\n\t\t// A bound hold never waits for its binding.\n\t\tfor (const hold of holds) {\n\t\t\tif (!hold.bound) continue;\n\t\t\thold.queue();\n\t\t\tthis.#waiting.add(hold);\n\t\t\tthis.#waitingSince ??= performance.now();\n\t\t}\n\t}\n\n\t/** Whether this host's next message goes out now: a slot is free and nothing waits for one. */\n\tget #free(): boolean {\n\t\treturn this.#binding.size === 0 && this.#waiting.size === 0 && this.#inFlight < WINDOW;\n\t}\n\n\t/**\n\t * A slot may be free: while there is room, the waiting state goes out as one message and the waiting bindings as\n\t * one `bound`, taking turns when both wait (state first), so neither a hold that keeps changing nor a stream of new\n\t * holds starves the other.\n\t */\n\t#slotFreed(): void {\n\t\tconst context = this.link.context;\n\t\twhile (this.#inFlight < WINDOW) {\n\t\t\tif (this.#binding.size > 0 && (this.#waiting.size === 0 || this.#bindingTurn)) {\n\t\t\t\tconst holds = [...this.#binding];\n\t\t\t\tthis.#binding.clear();\n\t\t\t\tthis.#bindingTurn = false;\n\t\t\t\t// Every snapshot in one synchronous step: the binding shows all of them at one moment.\n\t\t\t\tthis.#sendOwn({ kind: \"bound\", holds: holds.map((hold) => hold.boundEntry(context)) });\n\t\t\t} else if (this.#waiting.size > 0) {\n\t\t\t\tthis.#sendWaiting(context);\n\t\t\t} else {\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * The waiting state as one `state` message, taking a slot: a freed one, or one past the window before an answer.\n\t * Waiting bindings take the next slot.\n\t */\n\t#sendWaiting(context: Context): void {\n\t\tconst holds = [...this.#waiting];\n\t\tthis.#waiting.clear();\n\t\tthis.#waited();\n\t\tthis.#bindingTurn = this.#binding.size > 0;\n\t\tthis.#sendOwn({ kind: \"state\", holds: holds.map((hold) => hold.pendingEntry(context)) });\n\t}\n\n\t/**\n\t * A call's result message, its part deflated above the threshold when this host compresses; with byte segments when\n\t * its method's result schema has a `bytes()` leaf.\n\t */\n\t#result(\n\t\tid: number,\n\t\tresult: unknown,\n\t\tbytes: boolean,\n\t\tcontext: Context,\n\t): Extract<OriginMessage, { readonly kind: \"result\" }> {\n\t\tconst { json, segments } = payloadPart(result, bytes);\n\t\tconst value = this.link.part(json, context);\n\t\treturn { kind: \"result\", call: id, value, ...(segments === undefined ? {} : { segments }) };\n\t}\n\n\t/** The waiting state went out (or its holds left): how long it waited for its slot is recorded. */\n\t#waited(): void {\n\t\tif (this.#waitingSince === undefined) return;\n\t\tthis.link.host.metrics.histogram(\"chord.backpressure.wait\").record(performance.now() - this.#waitingSince);\n\t\tthis.#waitingSince = undefined;\n\t}\n\n\t/** Sends one of this host's own `bound` or `state` messages, taking a slot. */\n\t#sendOwn(message: Extract<OriginMessage, { readonly kind: \"bound\" | \"state\" }>): void {\n\t\tthis.#inFlight++;\n\t\tthis.#ownSent++;\n\t\tthis.#sent.push(\"local\");\n\t\tif (message.kind === \"state\") this.link.host.metrics.counter(\"chord.link.state_messages\").add(1);\n\t\tthis.send(message);\n\t}\n}\n"]}

package/dist/remote/relay.d.ts

@@ -0,0 +1,69 @@
+import type { TelemetrySpan } from "@earendil-works/pi-telemetry";
+import { ChordError } from "../data/index.ts";
+import type { Caller } from "../host/internal.ts";
+import { type Message, type OriginMessage } from "../link/internal.ts";
+import { OpenSpan } from "../telemetry.ts";
+import { type HoldRequest } from "./hold.ts";
+import type { HostLink } from "./host-link.ts";
+import type { Path } from "./path.ts";
+import type { ProviderSide } from "./provider.ts";
+/**
+ * One relayed hold: `id` on its downstream origin, and the same id upstream on its path's current link (none while
+ * the path has no link). It keeps its `hold` message to hold again on the next link. Calls, `abort`, `retry` and
+ * `release` go upstream at once; what comes back is forwarded by its downstream origin (`ProviderSide.forward`). Two
+ * downstream holds are two upstream holds, each with its own encoders (R1).
+ */
+export declare class RelayedHold {
+    #private;
+    readonly kind = "relayed";
+    readonly id: number;
+    /** Whom the hold acts for, sent on route links. */
+    readonly caller: Caller;
+    constructor(id: number, downstream: ProviderSide, request: HoldRequest, caller: Caller, path: Path);
+    /** Its `chord.relay` span until it is held upstream (a route's resolve links to it); none when not recorded. */
+    get span(): TelemetrySpan | undefined;
+    /** Takes the pending hold's place downstream and holds upstream (now, or when the path has a link). */
+    start(): void;
+    /** Whether it is held on `link` now: only that link answers for it. */
+    heldOn(link: HostLink): boolean;
+    /** Holds on `link`, the path's link now: its kept `hold` message, with whom it acts for on a route link. */
+    attach(link: HostLink): void;
+    /** The upstream link dropped: downstream its calls fail and the hold goes loading until the path's next link. */
+    dropped(error: ChordError): void;
+    /** Its path's address cannot be reached for now: downstream it fails `waiting` with `error` until the next link. */
+    unreachable(error: ChordError): void;
+    /**
+     * Whether it waits for its path's link (a route still resolving, or a dropped link's next): a revocation ends it then,
+     * since the link it is held on next gets no past `revoke` (§4).
+     */
+    get waiting(): boolean;
+    /** Revoked while it waited for its path's link: forgotten, and `gone` with `error` downstream. */
+    revoked(error: ChordError): void;
+    /** `gone` from upstream: the hold is forgotten (the downstream origin forwards the message). */
+    lost(): void;
+    /**
+     * A call from downstream (registered there under its id), forwarded upstream at once; its reply comes back by the
+     * origin. Without an upstream link it is answered `unavailable` at once (it crossed the `loading` notice).
+     */
+    call(message: Extract<Message, {
+        readonly kind: "call";
+    }>): OpenSpan<"chord.relay"> | undefined;
+    /** A downstream `abort` of call `id`, forwarded. */
+    abort(id: number): void;
+    /** A downstream `retry`, forwarded with its hop budget as it is (a relay visits no object). */
+    retry(message: Extract<Message, {
+        readonly kind: "retry";
+    }>): void;
+    /** Released downstream: released upstream (its calls with it) and no later link holds it. */
+    release(): void;
+    /** No later link holds it (gone, or its downstream origin closed, which `closed` tells the upstream links). */
+    drop(): void;
+}
+/**
+ * A relayed call's `chord.relay` span ends with its `reply` forwarded downstream (`ok`, or the error's: `aborted` for
+ * a cancel), or `aborted` without one (an abort, a release, a closed link).
+ */
+export declare function relayEnded(span: OpenSpan<"chord.relay">, reply: Extract<OriginMessage, {
+    readonly kind: "result" | "error";
+}> | undefined): void;
+//# sourceMappingURL=relay.d.ts.map

package/dist/remote/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/remote/relay.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAA4B,QAAQ,EAAkC,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,WAAW;;IACvB,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAOpB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAcxB,YAAY,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAgBjG;IAED,gHAAgH;IAChH,IAAI,IAAI,IAAI,aAAa,GAAG,SAAS,CAEpC;IAED,uGAAuG;IACvG,KAAK,IAAI,IAAI,CAGZ;IAED,uEAAuE;IACvE,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE9B;IAED,4GAA4G;IAC5G,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAa3B;IAgCD,iHAAiH;IACjH,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAI/B;IAED,oHAAoH;IACpH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAGnC;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,kGAAkG;IAClG,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAI/B;IAED,gGAAgG;IAChG,IAAI,IAAI,IAAI,CAGX;IAED;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,SAAS,CAsB9F;IAED,oDAAoD;IACpD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGtB;IAED,+FAA+F;IAC/F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,IAAI,CAGjE;IAED,6FAA6F;IAC7F,OAAO,IAAI,IAAI,CAId;IAED,+GAA+G;IAC/G,IAAI,IAAI,IAAI,CAIX;CAWD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC,GAAG,SAAS,GAC9E,IAAI,CASN"}

package/dist/remote/relay.js

@@ -0,0 +1,219 @@
+// Relayed holds (§4, §22, R1; decision "Relay flow control per origin"): a hold that arrived on one link (downstream)
+// and that this host neither serves nor parses, held again on its path's link (upstream) with the same id under its
+// downstream origin's number there; messages are forwarded between the two with the origin rewritten and parts
+// untouched. Forwarding a hold or a call is a `chord.relay` span under the arriving carrier, whose own carrier goes
+// upstream (slice 9).
+import { ChordError } from "../data/index.js";
+import { errorFromWire, wireError } from "../link/internal.js";
+import { capped, carrierOf, ended, OpenSpan, parentOf, spanFailed, untraced } from "../telemetry.js";
+import { actingFor } from "./hold.js";
+/**
+ * One relayed hold: `id` on its downstream origin, and the same id upstream on its path's current link (none while
+ * the path has no link). It keeps its `hold` message to hold again on the next link. Calls, `abort`, `retry` and
+ * `release` go upstream at once; what comes back is forwarded by its downstream origin (`ProviderSide.forward`). Two
+ * downstream holds are two upstream holds, each with its own encoders (R1).
+ */
+export class RelayedHold {
+    kind = "relayed";
+    id;
+    #downstream;
+    /**
+     * What the upstream hold asks for, with the chain and decoded limit this host honoured; its params owned, not a view
+     * of the message they came in.
+     */
+    #request;
+    /** Whom the hold acts for, sent on route links. */
+    caller;
+    #path;
+    /** The upstream link while the path has one, and the downstream origin's number on it. */
+    #upstream;
+    /** Its `chord.relay` span until it is first held upstream (or dropped); none when this host records nothing. */
+    #relaying;
+    /**
+     * The carrier of its first upstream hold: the relay span's, or the arriving one as it came when this host records
+     * nothing; a re-hold's span links to it.
+     */
+    #trace;
+    /** How many times it was held upstream. */
+    #holds = 0;
+    constructor(id, downstream, request, caller, path) {
+        this.id = id;
+        this.#downstream = downstream;
+        const { params, trace, ...fields } = request;
+        // Params are never deflated: the provider side refused deflated ones.
+        const owned = typeof params === "string" ? params : params.slice();
+        this.#request = { ...fields, params: owned };
+        this.#trace = trace;
+        const adapter = downstream.link.host.telemetry;
+        if (!untraced(adapter)) {
+            this.#relaying = new OpenSpan(parentOf(trace, adapter), "chord.relay", this.#attributes("hold"));
+            // Upstream the hold carries the relay's span (a relay that records nothing passes the carrier on as it came).
+            this.#trace = carrierOf(this.#relaying.span) ?? trace;
+        }
+        this.caller = caller;
+        this.#path = path;
+    }
+    /** Its `chord.relay` span until it is held upstream (a route's resolve links to it); none when not recorded. */
+    get span() {
+        return this.#relaying?.span;
+    }
+    /** Takes the pending hold's place downstream and holds upstream (now, or when the path has a link). */
+    start() {
+        this.#downstream.relayed(this);
+        this.#path.attach(this);
+    }
+    /** Whether it is held on `link` now: only that link answers for it. */
+    heldOn(link) {
+        return this.#upstream?.link === link;
+    }
+    /** Holds on `link`, the path's link now: its kept `hold` message, with whom it acts for on a route link. */
+    attach(link) {
+        const origin = this.#downstream.relayTo(link);
+        this.#upstream = { link, origin };
+        const trace = this.#holdTrace(link);
+        link.send({
+            kind: "hold",
+            origin,
+            hold: this.id,
+            ...this.#request,
+            ...(trace === undefined ? {} : { trace }),
+            ...actingFor(link, this.caller),
+        });
+        this.#relayed("ok");
+    }
+    /**
+     * The carrier of this upstream hold: the first one's; a re-hold after an upstream drop is a fresh `chord.relay` root
+     * linked to the first (none when this host records nothing), never the first's again (review L1).
+     */
+    #holdTrace(link) {
+        if (this.#holds++ === 0)
+            return this.#trace;
+        const adapter = link.host.telemetry;
+        if (this.#trace === undefined || untraced(adapter))
+            return undefined;
+        const again = new OpenSpan(adapter, "chord.relay", this.#attributes("hold"));
+        again.span.addLink({ context: parentOf(this.#trace, adapter) });
+        const carrier = carrierOf(again.span);
+        again.span.setAttributes({ outcome: "ok" });
+        again.end();
+        return carrier;
+    }
+    /**
+     * A relay span's attributes: its host's `chord.host` (the downstream link's host), and names from the wire, bounded
+     * by the message schema (untrusted links) and capped here.
+     */
+    #attributes(member) {
+        const { type, address } = this.#request;
+        return {
+            "chord.host": this.#downstream.link.host.spanHost,
+            type: capped(type),
+            member,
+            "upstream.kind": capped(address.kind),
+        };
+    }
+    /** The upstream link dropped: downstream its calls fail and the hold goes loading until the path's next link. */
+    dropped(error) {
+        const upstream = this.#upstream;
+        this.#upstream = undefined;
+        if (upstream !== undefined)
+            this.#downstream.upstreamDropped(this, error);
+    }
+    /** Its path's address cannot be reached for now: downstream it fails `waiting` with `error` until the next link. */
+    unreachable(error) {
+        this.#relayed("error", error);
+        this.#downstream.send({ kind: "failed", hold: this.id, cause: { kind: "waiting", error: wireError(error) } });
+    }
+    /**
+     * Whether it waits for its path's link (a route still resolving, or a dropped link's next): a revocation ends it then,
+     * since the link it is held on next gets no past `revoke` (§4).
+     */
+    get waiting() {
+        return this.#upstream === undefined;
+    }
+    /** Revoked while it waited for its path's link: forgotten, and `gone` with `error` downstream. */
+    revoked(error) {
+        this.drop();
+        this.#downstream.forget(this);
+        this.#downstream.send({ kind: "gone", hold: this.id, error: wireError(error) });
+    }
+    /** `gone` from upstream: the hold is forgotten (the downstream origin forwards the message). */
+    lost() {
+        this.drop();
+        this.#downstream.forget(this);
+    }
+    /**
+     * A call from downstream (registered there under its id), forwarded upstream at once; its reply comes back by the
+     * origin. Without an upstream link it is answered `unavailable` at once (it crossed the `loading` notice).
+     */
+    call(message) {
+        const upstream = this.#upstream;
+        if (upstream === undefined) {
+            const error = new ChordError({ code: "unavailable", message: `hold ${this.id}: its upstream link is down` });
+            this.#downstream.reply(message.call, { kind: "error", call: message.call, error: wireError(error) });
+            return undefined;
+        }
+        // A downstream link that is not trusted (a page) cannot claim old work: its flag is dropped here.
+        const forwarded = message.old === true && !this.#downstream.link.trusted ? unmarked(message) : message;
+        const adapter = upstream.link.host.telemetry;
+        if (untraced(adapter)) {
+            upstream.link.send({ ...forwarded, origin: upstream.origin });
+            return undefined;
+        }
+        const span = new OpenSpan(parentOf(message.trace, adapter), "chord.relay", this.#attributes(`#${message.method}`));
+        const trace = carrierOf(span.span) ?? message.trace;
+        upstream.link.send({ ...forwarded, origin: upstream.origin, ...(trace === undefined ? {} : { trace }) });
+        return span;
+    }
+    /** A downstream `abort` of call `id`, forwarded. */
+    abort(id) {
+        const upstream = this.#upstream;
+        upstream?.link.send({ kind: "abort", origin: upstream.origin, call: id });
+    }
+    /** A downstream `retry`, forwarded with its hop budget as it is (a relay visits no object). */
+    retry(message) {
+        const upstream = this.#upstream;
+        upstream?.link.send({ ...message, origin: upstream.origin });
+    }
+    /** Released downstream: released upstream (its calls with it) and no later link holds it. */
+    release() {
+        const upstream = this.#upstream;
+        this.drop();
+        upstream?.link.send({ kind: "release", origin: upstream.origin, hold: this.id });
+    }
+    /** No later link holds it (gone, or its downstream origin closed, which `closed` tells the upstream links). */
+    drop() {
+        this.#relayed("aborted");
+        this.#upstream = undefined;
+        this.#path.detach(this);
+    }
+    /** It was held upstream, failed or dropped first: its `chord.relay` span ends with `outcome`. */
+    #relayed(outcome, error) {
+        const relaying = this.#relaying;
+        if (relaying === undefined)
+            return;
+        this.#relaying = undefined;
+        if (error !== undefined)
+            spanFailed(relaying.span, "relay_failed", error);
+        relaying.span.setAttributes({ outcome });
+        relaying.end();
+    }
+}
+/**
+ * A relayed call's `chord.relay` span ends with its `reply` forwarded downstream (`ok`, or the error's: `aborted` for
+ * a cancel), or `aborted` without one (an abort, a release, a closed link).
+ */
+export function relayEnded(span, reply) {
+    const outcome = reply === undefined
+        ? "aborted"
+        : reply.kind === "result"
+            ? "ok"
+            : ended(span.span, "relay_failed", errorFromWire(reply.error), undefined);
+    span.span.setAttributes({ outcome });
+    span.end();
+}
+/** `message` without its old-work flag (`call.old`), as a relay forwards it from a link that is not trusted. */
+function unmarked(message) {
+    const { old: _old, ...rest } = message;
+    return rest;
+}
+//# sourceMappingURL=relay.js.map

package/dist/remote/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../../src/remote/relay.ts"],"names":[],"mappings":"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","sourcesContent":["// Relayed holds (§4, §22, R1; decision \"Relay flow control per origin\"): a hold that arrived on one link (downstream)\n// and that this host neither serves nor parses, held again on its path's link (upstream) with the same id under its\n// downstream origin's number there; messages are forwarded between the two with the origin rewritten and parts\n// untouched. Forwarding a hold or a call is a `chord.relay` span under the arriving carrier, whose own carrier goes\n// upstream (slice 9).\n\nimport type { TelemetryCarrier, TelemetrySpan } from \"@earendil-works/pi-telemetry\";\nimport { ChordError } from \"../data/index.ts\";\nimport type { Caller } from \"../host/internal.ts\";\nimport { errorFromWire, type Message, type OriginMessage, wireError } from \"../link/internal.ts\";\nimport { capped, carrierOf, ended, OpenSpan, parentOf, spanFailed, untraced } from \"../telemetry.ts\";\nimport { actingFor, type HoldRequest } from \"./hold.ts\";\nimport type { HostLink } from \"./host-link.ts\";\nimport type { Path } from \"./path.ts\";\nimport type { ProviderSide } from \"./provider.ts\";\n\n/**\n * One relayed hold: `id` on its downstream origin, and the same id upstream on its path's current link (none while\n * the path has no link). It keeps its `hold` message to hold again on the next link. Calls, `abort`, `retry` and\n * `release` go upstream at once; what comes back is forwarded by its downstream origin (`ProviderSide.forward`). Two\n * downstream holds are two upstream holds, each with its own encoders (R1).\n */\nexport class RelayedHold {\n\treadonly kind = \"relayed\";\n\treadonly id: number;\n\treadonly #downstream: ProviderSide;\n\t/**\n\t * What the upstream hold asks for, with the chain and decoded limit this host honoured; its params owned, not a view\n\t * of the message they came in.\n\t */\n\treadonly #request: HoldRequest;\n\t/** Whom the hold acts for, sent on route links. */\n\treadonly caller: Caller;\n\treadonly #path: Path;\n\t/** The upstream link while the path has one, and the downstream origin's number on it. */\n\t#upstream: { readonly link: HostLink; readonly origin: number } | undefined;\n\t/** Its `chord.relay` span until it is first held upstream (or dropped); none when this host records nothing. */\n\t#relaying: OpenSpan<\"chord.relay\"> | undefined;\n\t/**\n\t * The carrier of its first upstream hold: the relay span's, or the arriving one as it came when this host records\n\t * nothing; a re-hold's span links to it.\n\t */\n\treadonly #trace: TelemetryCarrier | undefined;\n\t/** How many times it was held upstream. */\n\t#holds = 0;\n\n\tconstructor(id: number, downstream: ProviderSide, request: HoldRequest, caller: Caller, path: Path) {\n\t\tthis.id = id;\n\t\tthis.#downstream = downstream;\n\t\tconst { params, trace, ...fields } = request;\n\t\t// Params are never deflated: the provider side refused deflated ones.\n\t\tconst owned = typeof params === \"string\" ? params : (params as Uint8Array).slice();\n\t\tthis.#request = { ...fields, params: owned };\n\t\tthis.#trace = trace;\n\t\tconst adapter = downstream.link.host.telemetry;\n\t\tif (!untraced(adapter)) {\n\t\t\tthis.#relaying = new OpenSpan(parentOf(trace, adapter), \"chord.relay\", this.#attributes(\"hold\"));\n\t\t\t// Upstream the hold carries the relay's span (a relay that records nothing passes the carrier on as it came).\n\t\t\tthis.#trace = carrierOf(this.#relaying.span) ?? trace;\n\t\t}\n\t\tthis.caller = caller;\n\t\tthis.#path = path;\n\t}\n\n\t/** Its `chord.relay` span until it is held upstream (a route's resolve links to it); none when not recorded. */\n\tget span(): TelemetrySpan | undefined {\n\t\treturn this.#relaying?.span;\n\t}\n\n\t/** Takes the pending hold's place downstream and holds upstream (now, or when the path has a link). */\n\tstart(): void {\n\t\tthis.#downstream.relayed(this);\n\t\tthis.#path.attach(this);\n\t}\n\n\t/** Whether it is held on `link` now: only that link answers for it. */\n\theldOn(link: HostLink): boolean {\n\t\treturn this.#upstream?.link === link;\n\t}\n\n\t/** Holds on `link`, the path's link now: its kept `hold` message, with whom it acts for on a route link. */\n\tattach(link: HostLink): void {\n\t\tconst origin = this.#downstream.relayTo(link);\n\t\tthis.#upstream = { link, origin };\n\t\tconst trace = this.#holdTrace(link);\n\t\tlink.send({\n\t\t\tkind: \"hold\",\n\t\t\torigin,\n\t\t\thold: this.id,\n\t\t\t...this.#request,\n\t\t\t...(trace === undefined ? {} : { trace }),\n\t\t\t...actingFor(link, this.caller),\n\t\t});\n\t\tthis.#relayed(\"ok\");\n\t}\n\n\t/**\n\t * The carrier of this upstream hold: the first one's; a re-hold after an upstream drop is a fresh `chord.relay` root\n\t * linked to the first (none when this host records nothing), never the first's again (review L1).\n\t */\n\t#holdTrace(link: HostLink): TelemetryCarrier | undefined {\n\t\tif (this.#holds++ === 0) return this.#trace;\n\t\tconst adapter = link.host.telemetry;\n\t\tif (this.#trace === undefined || untraced(adapter)) return undefined;\n\t\tconst again = new OpenSpan(adapter, \"chord.relay\", this.#attributes(\"hold\"));\n\t\tagain.span.addLink({ context: parentOf(this.#trace, adapter) });\n\t\tconst carrier = carrierOf(again.span);\n\t\tagain.span.setAttributes({ outcome: \"ok\" });\n\t\tagain.end();\n\t\treturn carrier;\n\t}\n\n\t/**\n\t * A relay span's attributes: its host's `chord.host` (the downstream link's host), and names from the wire, bounded\n\t * by the message schema (untrusted links) and capped here.\n\t */\n\t#attributes(member: string): { \"chord.host\": string; type: string; member: string; \"upstream.kind\": string } {\n\t\tconst { type, address } = this.#request;\n\t\treturn {\n\t\t\t\"chord.host\": this.#downstream.link.host.spanHost,\n\t\t\ttype: capped(type),\n\t\t\tmember,\n\t\t\t\"upstream.kind\": capped(address.kind),\n\t\t};\n\t}\n\n\t/** The upstream link dropped: downstream its calls fail and the hold goes loading until the path's next link. */\n\tdropped(error: ChordError): void {\n\t\tconst upstream = this.#upstream;\n\t\tthis.#upstream = undefined;\n\t\tif (upstream !== undefined) this.#downstream.upstreamDropped(this, error);\n\t}\n\n\t/** Its path's address cannot be reached for now: downstream it fails `waiting` with `error` until the next link. */\n\tunreachable(error: ChordError): void {\n\t\tthis.#relayed(\"error\", error);\n\t\tthis.#downstream.send({ kind: \"failed\", hold: this.id, cause: { kind: \"waiting\", error: wireError(error) } });\n\t}\n\n\t/**\n\t * Whether it waits for its path's link (a route still resolving, or a dropped link's next): a revocation ends it then,\n\t * since the link it is held on next gets no past `revoke` (§4).\n\t */\n\tget waiting(): boolean {\n\t\treturn this.#upstream === undefined;\n\t}\n\n\t/** Revoked while it waited for its path's link: forgotten, and `gone` with `error` downstream. */\n\trevoked(error: ChordError): void {\n\t\tthis.drop();\n\t\tthis.#downstream.forget(this);\n\t\tthis.#downstream.send({ kind: \"gone\", hold: this.id, error: wireError(error) });\n\t}\n\n\t/** `gone` from upstream: the hold is forgotten (the downstream origin forwards the message). */\n\tlost(): void {\n\t\tthis.drop();\n\t\tthis.#downstream.forget(this);\n\t}\n\n\t/**\n\t * A call from downstream (registered there under its id), forwarded upstream at once; its reply comes back by the\n\t * origin. Without an upstream link it is answered `unavailable` at once (it crossed the `loading` notice).\n\t */\n\tcall(message: Extract<Message, { readonly kind: \"call\" }>): OpenSpan<\"chord.relay\"> | undefined {\n\t\tconst upstream = this.#upstream;\n\t\tif (upstream === undefined) {\n\t\t\tconst error = new ChordError({ code: \"unavailable\", message: `hold ${this.id}: its upstream link is down` });\n\t\t\tthis.#downstream.reply(message.call, { kind: \"error\", call: message.call, error: wireError(error) });\n\t\t\treturn undefined;\n\t\t}\n\t\t// A downstream link that is not trusted (a page) cannot claim old work: its flag is dropped here.\n\t\tconst forwarded = message.old === true && !this.#downstream.link.trusted ? unmarked(message) : message;\n\t\tconst adapter = upstream.link.host.telemetry;\n\t\tif (untraced(adapter)) {\n\t\t\tupstream.link.send({ ...forwarded, origin: upstream.origin });\n\t\t\treturn undefined;\n\t\t}\n\t\tconst span = new OpenSpan(\n\t\t\tparentOf(message.trace, adapter),\n\t\t\t\"chord.relay\",\n\t\t\tthis.#attributes(`#${message.method}`),\n\t\t);\n\t\tconst trace = carrierOf(span.span) ?? message.trace;\n\t\tupstream.link.send({ ...forwarded, origin: upstream.origin, ...(trace === undefined ? {} : { trace }) });\n\t\treturn span;\n\t}\n\n\t/** A downstream `abort` of call `id`, forwarded. */\n\tabort(id: number): void {\n\t\tconst upstream = this.#upstream;\n\t\tupstream?.link.send({ kind: \"abort\", origin: upstream.origin, call: id });\n\t}\n\n\t/** A downstream `retry`, forwarded with its hop budget as it is (a relay visits no object). */\n\tretry(message: Extract<Message, { readonly kind: \"retry\" }>): void {\n\t\tconst upstream = this.#upstream;\n\t\tupstream?.link.send({ ...message, origin: upstream.origin });\n\t}\n\n\t/** Released downstream: released upstream (its calls with it) and no later link holds it. */\n\trelease(): void {\n\t\tconst upstream = this.#upstream;\n\t\tthis.drop();\n\t\tupstream?.link.send({ kind: \"release\", origin: upstream.origin, hold: this.id });\n\t}\n\n\t/** No later link holds it (gone, or its downstream origin closed, which `closed` tells the upstream links). */\n\tdrop(): void {\n\t\tthis.#relayed(\"aborted\");\n\t\tthis.#upstream = undefined;\n\t\tthis.#path.detach(this);\n\t}\n\n\t/** It was held upstream, failed or dropped first: its `chord.relay` span ends with `outcome`. */\n\t#relayed(outcome: \"ok\" | \"error\" | \"aborted\", error?: ChordError): void {\n\t\tconst relaying = this.#relaying;\n\t\tif (relaying === undefined) return;\n\t\tthis.#relaying = undefined;\n\t\tif (error !== undefined) spanFailed(relaying.span, \"relay_failed\", error);\n\t\trelaying.span.setAttributes({ outcome });\n\t\trelaying.end();\n\t}\n}\n\n/**\n * A relayed call's `chord.relay` span ends with its `reply` forwarded downstream (`ok`, or the error's: `aborted` for\n * a cancel), or `aborted` without one (an abort, a release, a closed link).\n */\nexport function relayEnded(\n\tspan: OpenSpan<\"chord.relay\">,\n\treply: Extract<OriginMessage, { readonly kind: \"result\" | \"error\" }> | undefined,\n): void {\n\tconst outcome =\n\t\treply === undefined\n\t\t\t? \"aborted\"\n\t\t\t: reply.kind === \"result\"\n\t\t\t\t? \"ok\"\n\t\t\t\t: ended(span.span, \"relay_failed\", errorFromWire(reply.error), undefined);\n\tspan.span.setAttributes({ outcome });\n\tspan.end();\n}\n\n/** `message` without its old-work flag (`call.old`), as a relay forwards it from a link that is not trusted. */\nfunction unmarked(message: Extract<Message, { readonly kind: \"call\" }>): Extract<Message, { readonly kind: \"call\" }> {\n\tconst { old: _old, ...rest } = message;\n\treturn rest;\n}\n"]}

package/dist/remote/remote-object.d.ts

@@ -0,0 +1,138 @@
+import type { TelemetryContext, TelemetrySpan } from "@earendil-works/pi-telemetry";
+import { type Context } from "../context/index.ts";
+import type { Contract } from "../contracts/index.ts";
+import { ChordError } from "../data/index.ts";
+import { type AnyHost, type Attachable, type Binding, type Caller, type CheckedParams, type ChordObject, type Followed, type PinnedKey, type RefState, type RetryWalk, type Target } from "../host/internal.ts";
+import { type BoundEntry, type Message, type StateEntry, type WireAddress } from "../link/internal.ts";
+import type { DeriveSource } from "../state/internal.ts";
+import type { HoldRequest } from "./hold.ts";
+import type { HostLink } from "./host-link.ts";
+import type { Path } from "./path.ts";
+/**
+ * One remote reference's object, owned by its host across the links of its path. It is `loading` until a link's hold
+ * of it is bound, and again whenever that link drops or its relay's upstream starts over; each link holds it with its
+ * own id. Two references are two holds, each member of each with its own Delta decoder.
+ */
+export declare class RemoteObject implements Target {
+    #private;
+    readonly kind = "remote";
+    /** The object in errors: its type, and its params key when it has params. */
+    readonly label: string;
+    readonly contract: Contract;
+    /** What its holds ask for: the params as a part (checked by L1 when the reference was made), the address. */
+    readonly request: HoldRequest;
+    /** Whom its reference acts for: named on route links (`actingFor`). */
+    readonly caller: Caller;
+    constructor(host: AnyHost, contract: Contract, { params, key }: CheckedParams, address: WireAddress, caller: Caller, path: Path, dependent: ChordObject | undefined, holder: TelemetryContext);
+    get state(): RefState;
+    /** Over a link the provider decides what each version sees: its state as it is. */
+    stateFor(): RefState;
+    /** Its `chord.hold` span until its first `bound` or failure (a route's resolve links to it); none when not recorded. */
+    get span(): TelemetrySpan | undefined;
+    /** An object over a link is no blocker of this host's first pass. */
+    get blocksFirstPass(): false;
+    /** The error of the last `failed`, until `bound`. */
+    get lastFailure(): ChordError | undefined;
+    /** The variant last bound; `undefined` before the first binding. */
+    get variant(): string | undefined;
+    /** Whether its state members have values: bound once. */
+    get hydrated(): boolean;
+    /** Its one reference bound to it. */
+    hold(binding: Binding): void;
+    /** The reference was released: the current link's provider is told and the reference's sent calls rejected. */
+    unhold(_binding: Binding): void;
+    /**
+     * Holds on `link`, the path's link now (a first hold, or a re-hold on a new link), with the activation chain of its
+     * dependent while that activates (Q5).
+     */
+    attach(link: HostLink): void;
+    /**
+     * Its path's address cannot be reached for now (a route's `resolve` failed, a suspension): `failed { waiting }` with
+     * `error`, still on the path, bound by its next link.
+     */
+    unreachable(error: ChordError): void;
+    /** The link dropped: loading until a new link's hold is bound (`#startOver`). */
+    dropped(_error: ChordError): void;
+    /**
+     * Calls a method of the bound variant over the link; one outside it fails `invalid/member`. Only a live object is
+     * called: bound on an open link.
+     */
+    call(method: string, args: unknown, context: Context): Promise<unknown>;
+    /**
+     * The replica of `member`; `not_ready` before the first binding, `invalid/member` for a member no binding had (one
+     * a later variant lacks reads its `invalid/member` failure).
+     */
+    member(member: string): DeriveSource;
+    /**
+     * What its reference follows of `member` (a consumer over a link binds at its own version, mapped at the provider):
+     * the replica while live, a member the bound variant lacks (`invalid/member`); while loading or failed nothing, the
+     * replica (kept until the next binding) giving its last value (rule 5).
+     */
+    followed(member: string, _version: number): Followed;
+    /** Its binding while live (its replicas change); `undefined` while loading or failed. */
+    get attachable(): Attachable | undefined;
+    /** Keyed members are only in local contracts: no instance to pin a key on. */
+    get instance(): undefined;
+    /** Keyed members are only in local contracts (`keyedMember`). */
+    keyedMapping(member: string): never;
+    /** Keyed members are only in local contracts (`keyedMember`). */
+    pinKey(member: string): Promise<PinnedKey>;
+    /** Keyed members are only in local contracts, whose objects are never held over a link (slice 6a §12). */
+    keyedMember(member: string): never;
+    /** An object over a link activates on another host: it is in no chain here (Q5). */
+    get activationId(): undefined;
+    /** An object over a link waits for nothing on this host: no chain of waits (its holds carry the chain, Q5). */
+    pathTo(): undefined;
+    /**
+     * `ref.retry()`, as a step of `walk`: a failed object's provider is asked for an attempt with the walk's hop budget,
+     * none left: nothing is sent (a hold it refused is started there again; a parked object there passes it on with one
+     * hop less). One that failed for a part past the link's limits is placed anew and held with a new id, now or on its
+     * path's next link (a `hostAddress` that throws fails it broken again).
+     */
+    retry(walk: RetryWalk): void;
+    /**
+     * A part of its snapshot or of a state change was past the link's limits (`too_large/part`): the hold is released
+     * at the provider, and the reference fails broken with `error`, final: no link holds it again (a reconnect
+     * included) until `retry`.
+     */
+    tooLarge(error: ChordError): void;
+    /**
+     * Prepares one entry of a `bound` message (a first binding, a re-hold; a live hold is bound again): the
+     * variant and every state member once, as a value or as failed. Returns what applies it inside the batch of the
+     * whole message: a member it had gets the snapshot as one frame `[["r", value]]` and a fresh decoder, a member
+     * outside the new variant fails (its replica stays, for a later binding that has it again), a new one gets its first
+     * value. Throws on a snapshot that
+     * does not fit (a protocol error), and `too_large/part` for a value past the link's limits, before anything changed.
+     * `wentLive` follows the batch.
+     */
+    prepareBound(entry: BoundEntry, link: HostLink): () => void;
+    /** After a `bound` message's batch: the reference goes live (its parked calls are sent, a parked dependent goes on). */
+    wentLive(): void;
+    /**
+     * `failed`: the provider's object failed and no attempt runs (`retryIn`: the rest of its backoff window), or the hold
+     * is unbound there or its object parked on a failed dependency (`waiting`), each new cause a new message. On a bound
+     * hold it unbinds it (slice 7b, model §5): the members keep their last values until the next `bound`.
+     */
+    failed(message: Extract<Message, {
+        readonly kind: "failed";
+    }>): void;
+    /**
+     * `loading`: the provider's object started a new attempt after a failure, or its relay's upstream link dropped
+     * (`#startOver`).
+     */
+    loading(): void;
+    /**
+     * Decodes and applies one entry of a state message (its members by index, each with its ops), without changing
+     * anything yet: returns what adopts it into the replicas, run inside the batch that applies the whole message.
+     * Throws on an entry that does not fit (a protocol error), and `too_large/part` for ops past the link's limits.
+     */
+    prepare({ hold: id, members, failed, retired }: StateEntry, link: HostLink): () => void;
+    /**
+     * Its principal was revoked on this host (`host.revoke`): released at its provider if it is held there, then ended
+     * with `error` as `lost` does; no later link holds it.
+     */
+    revoke(error: ChordError): void;
+    /** `gone`, or the host closes: the reference ends, its calls reject with `error`. */
+    lost(error: ChordError): void;
+}
+//# sourceMappingURL=remote-object.d.ts.map

package/dist/remote/remote-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-object.d.ts","sourceRoot":"","sources":["../../src/remote/remote-object.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACtG,OAAO,EAAsB,KAAK,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,uBAAuB,CAAC;AAQhE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EAGb,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,MAAM,EACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,KAAK,UAAU,EAGf,KAAK,OAAO,EAEZ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWtC;;;;GAIG;AACH,qBAAa,YAAa,YAAW,MAAM;;IAC1C,QAAQ,CAAC,IAAI,YAAY;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,6GAA6G;IAC7G,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAqBxB,YACC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,QAAQ,EAClB,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,aAAa,EAC9B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,WAAW,GAAG,SAAS,EAClC,MAAM,EAAE,gBAAgB,EAqBxB;IAED,IAAI,KAAK,IAAI,QAAQ,CAEpB;IAED,mFAAmF;IACnF,QAAQ,IAAI,QAAQ,CAEnB;IAED,wHAAwH;IACxH,IAAI,IAAI,IAAI,aAAa,GAAG,SAAS,CAEpC;IAED,qEAAqE;IACrE,IAAI,eAAe,IAAI,KAAK,CAE3B;IAED,qDAAqD;IACrD,IAAI,WAAW,IAAI,UAAU,GAAG,SAAS,CAExC;IAED,oEAAoE;IACpE,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,yDAAyD;IACzD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,qCAAqC;IACrC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE3B;IAED,+GAA+G;IAC/G,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAI9B;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAG3B;IAwBD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAKnC;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGhC;IAED;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA6B5E;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAQnC;IAED;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAWnD;IAED,yFAAyF;IACzF,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;IAED,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,SAAS,CAExB;IAED,iEAAiE;IACjE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAElC;IAED,iEAAiE;IAC3D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE/C;IAED,0GAA0G;IAC1G,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAEjC;IAED,oFAAoF;IACpF,IAAI,YAAY,IAAI,SAAS,CAE5B;IAED,+GAA+G;IAC/G,MAAM,IAAI,SAAS,CAElB;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAO3B;IAiBD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAShC;IASD;;;;;;;;OAQG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAsC1D;IAED,wHAAwH;IACxH,QAAQ,IAAI,IAAI,CAIf;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,GAAG,IAAI,CAOnE;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI,CAEd;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAkCtF;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAK9B;IAED,qFAAqF;IACrF,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAK5B;CA4CD"}