@draht/chord 2026.10.20 → 2026.10.23
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/dist/cell.d.ts +122 -0
- package/dist/cell.d.ts.map +1 -0
- package/dist/cell.js +356 -0
- package/dist/cell.js.map +1 -0
- package/dist/cluster.d.ts +27 -0
- package/dist/cluster.d.ts.map +1 -0
- package/dist/cluster.js +230 -0
- package/dist/cluster.js.map +1 -0
- package/dist/connection.d.ts +270 -0
- package/dist/connection.d.ts.map +1 -0
- package/dist/connection.js +1216 -0
- package/dist/connection.js.map +1 -0
- package/dist/context/index.d.ts +20 -1
- package/dist/context/index.d.ts.map +1 -1
- package/dist/context/index.js +15 -0
- package/dist/context/index.js.map +1 -1
- package/dist/contract.d.ts +208 -0
- package/dist/contract.d.ts.map +1 -0
- package/dist/contract.js +246 -0
- package/dist/contract.js.map +1 -0
- package/dist/declare.d.ts +33 -0
- package/dist/declare.d.ts.map +1 -0
- package/dist/declare.js +2 -0
- package/dist/declare.js.map +1 -0
- package/dist/delta/apply-immutable-trusted.js.map +1 -1
- package/dist/delta/diff.d.ts +1 -1
- package/dist/delta/diff.d.ts.map +1 -1
- package/dist/delta/diff.js.map +1 -1
- package/dist/delta/index.d.ts +4 -3
- package/dist/delta/index.d.ts.map +1 -1
- package/dist/delta/index.js +45 -0
- package/dist/delta/index.js.map +1 -1
- package/dist/delta/revision-validator.d.ts +1 -1
- package/dist/delta/revision-validator.d.ts.map +1 -1
- package/dist/delta/revision-validator.js.map +1 -1
- package/dist/delta/tracker.d.ts +1 -1
- package/dist/delta/tracker.d.ts.map +1 -1
- package/dist/delta/tracker.js +40 -4
- package/dist/delta/tracker.js.map +1 -1
- package/dist/errors.d.ts +28 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +59 -0
- package/dist/errors.js.map +1 -0
- package/dist/host.d.ts +348 -0
- package/dist/host.d.ts.map +1 -0
- package/dist/host.js +1000 -0
- package/dist/host.js.map +1 -0
- package/dist/index.d.ts +17 -10
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -8
- package/dist/index.js.map +1 -1
- package/dist/json.d.ts +9 -1
- package/dist/json.d.ts.map +1 -1
- package/dist/json.js.map +1 -1
- package/dist/link.d.ts +109 -0
- package/dist/link.d.ts.map +1 -0
- package/dist/link.js +375 -0
- package/dist/link.js.map +1 -0
- package/dist/loader.d.ts +4 -0
- package/dist/loader.d.ts.map +1 -0
- package/dist/loader.js +73 -0
- package/dist/loader.js.map +1 -0
- package/dist/manager.d.ts +115 -0
- package/dist/manager.d.ts.map +1 -0
- package/dist/manager.js +345 -0
- package/dist/manager.js.map +1 -0
- package/dist/node.d.ts +3 -4
- package/dist/node.d.ts.map +1 -1
- package/dist/node.js +3 -2
- package/dist/node.js.map +1 -1
- package/dist/object.d.ts +438 -0
- package/dist/object.d.ts.map +1 -0
- package/dist/object.js +1571 -0
- package/dist/object.js.map +1 -0
- package/dist/output.d.ts +91 -0
- package/dist/output.d.ts.map +1 -0
- package/dist/output.js +360 -0
- package/dist/output.js.map +1 -0
- package/dist/publish.d.ts +5 -0
- package/dist/publish.d.ts.map +1 -0
- package/dist/publish.js +40 -0
- package/dist/publish.js.map +1 -0
- package/dist/registry.d.ts +25 -0
- package/dist/registry.d.ts.map +1 -0
- package/dist/registry.js +6 -0
- package/dist/registry.js.map +1 -0
- package/dist/reload.d.ts +126 -0
- package/dist/reload.d.ts.map +1 -0
- package/dist/reload.js +653 -0
- package/dist/reload.js.map +1 -0
- package/dist/remote.d.ts +165 -0
- package/dist/remote.d.ts.map +1 -0
- package/dist/remote.js +612 -0
- package/dist/remote.js.map +1 -0
- package/dist/schema.d.ts +21 -0
- package/dist/schema.d.ts.map +1 -0
- package/dist/schema.js +228 -0
- package/dist/schema.js.map +1 -0
- package/dist/sqlite/cloudflare.d.ts +52 -0
- package/dist/sqlite/cloudflare.d.ts.map +1 -0
- package/dist/sqlite/cloudflare.js +134 -0
- package/dist/sqlite/cloudflare.js.map +1 -0
- package/dist/sqlite/database.d.ts +37 -0
- package/dist/sqlite/database.d.ts.map +1 -0
- package/dist/sqlite/database.js +2 -0
- package/dist/sqlite/database.js.map +1 -0
- package/dist/sqlite/index.d.ts +4 -0
- package/dist/sqlite/index.d.ts.map +1 -0
- package/dist/sqlite/index.js +3 -0
- package/dist/sqlite/index.js.map +1 -0
- package/dist/sqlite/migrations.d.ts +10 -0
- package/dist/sqlite/migrations.d.ts.map +1 -0
- package/dist/sqlite/migrations.js +33 -0
- package/dist/sqlite/migrations.js.map +1 -0
- package/dist/sqlite/node.d.ts +38 -0
- package/dist/sqlite/node.d.ts.map +1 -0
- package/dist/sqlite/node.js +174 -0
- package/dist/sqlite/node.js.map +1 -0
- package/dist/sqlite/schema.d.ts +3 -0
- package/dist/sqlite/schema.d.ts.map +1 -0
- package/dist/sqlite/schema.js +10 -0
- package/dist/sqlite/schema.js.map +1 -0
- package/dist/state.d.ts +92 -0
- package/dist/state.d.ts.map +1 -0
- package/dist/{services/state.js → state.js} +28 -138
- package/dist/state.js.map +1 -0
- package/dist/telemetry-sqlite/index.d.ts +24 -0
- package/dist/telemetry-sqlite/index.d.ts.map +1 -0
- package/dist/telemetry-sqlite/index.js +273 -0
- package/dist/telemetry-sqlite/index.js.map +1 -0
- package/dist/telemetry-sqlite/store.d.ts +9 -0
- package/dist/telemetry-sqlite/store.d.ts.map +1 -0
- package/dist/telemetry-sqlite/store.js +110 -0
- package/dist/telemetry-sqlite/store.js.map +1 -0
- package/dist/types.d.ts +69 -254
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/dist/websocket.d.ts +15 -0
- package/dist/websocket.d.ts.map +1 -0
- package/dist/websocket.js +16 -0
- package/dist/websocket.js.map +1 -0
- package/dist/wire.d.ts +216 -0
- package/dist/wire.d.ts.map +1 -0
- package/dist/wire.js +165 -0
- package/dist/wire.js.map +1 -0
- package/docs/guide.md +814 -0
- package/docs/spec.md +288 -0
- package/docs/tutorial.md +931 -0
- package/package.json +36 -12
- package/dist/api.d.ts +0 -20
- package/dist/api.d.ts.map +0 -1
- package/dist/api.js +0 -77
- package/dist/api.js.map +0 -1
- package/dist/bundler.d.ts +0 -6
- package/dist/bundler.d.ts.map +0 -1
- package/dist/bundler.js +0 -3
- package/dist/bundler.js.map +0 -1
- package/dist/facets/host.d.ts +0 -12
- package/dist/facets/host.d.ts.map +0 -1
- package/dist/facets/host.js +0 -763
- package/dist/facets/host.js.map +0 -1
- package/dist/facets/loader.d.ts +0 -3
- package/dist/facets/loader.d.ts.map +0 -1
- package/dist/facets/loader.js +0 -5
- package/dist/facets/loader.js.map +0 -1
- package/dist/node/bundle-loader.d.ts +0 -30
- package/dist/node/bundle-loader.d.ts.map +0 -1
- package/dist/node/bundle-loader.js +0 -377
- package/dist/node/bundle-loader.js.map +0 -1
- package/dist/node/bundle.d.ts +0 -26
- package/dist/node/bundle.d.ts.map +0 -1
- package/dist/node/bundle.js +0 -183
- package/dist/node/bundle.js.map +0 -1
- package/dist/node/manifest.d.ts +0 -36
- package/dist/node/manifest.d.ts.map +0 -1
- package/dist/node/manifest.js +0 -6
- package/dist/node/manifest.js.map +0 -1
- package/dist/node/package.d.ts +0 -15
- package/dist/node/package.d.ts.map +0 -1
- package/dist/node/package.js +0 -199
- package/dist/node/package.js.map +0 -1
- package/dist/services/consumer.d.ts +0 -11
- package/dist/services/consumer.d.ts.map +0 -1
- package/dist/services/consumer.js +0 -585
- package/dist/services/consumer.js.map +0 -1
- package/dist/services/errors.d.ts +0 -8
- package/dist/services/errors.d.ts.map +0 -1
- package/dist/services/errors.js +0 -22
- package/dist/services/errors.js.map +0 -1
- package/dist/services/handle.d.ts +0 -15
- package/dist/services/handle.d.ts.map +0 -1
- package/dist/services/handle.js +0 -101
- package/dist/services/handle.js.map +0 -1
- package/dist/services/instances.d.ts +0 -26
- package/dist/services/instances.d.ts.map +0 -1
- package/dist/services/instances.js +0 -140
- package/dist/services/instances.js.map +0 -1
- package/dist/services/loopback.d.ts +0 -5
- package/dist/services/loopback.d.ts.map +0 -1
- package/dist/services/loopback.js +0 -15
- package/dist/services/loopback.js.map +0 -1
- package/dist/services/provider.d.ts +0 -37
- package/dist/services/provider.d.ts.map +0 -1
- package/dist/services/provider.js +0 -521
- package/dist/services/provider.js.map +0 -1
- package/dist/services/state-codec.d.ts +0 -15
- package/dist/services/state-codec.d.ts.map +0 -1
- package/dist/services/state-codec.js +0 -133
- package/dist/services/state-codec.js.map +0 -1
- package/dist/services/state-internals.d.ts +0 -13
- package/dist/services/state-internals.d.ts.map +0 -1
- package/dist/services/state-internals.js +0 -10
- package/dist/services/state-internals.js.map +0 -1
- package/dist/services/state.d.ts +0 -28
- package/dist/services/state.d.ts.map +0 -1
- package/dist/services/state.js.map +0 -1
- package/dist/services/wire.d.ts +0 -63
- package/dist/services/wire.d.ts.map +0 -1
- package/dist/services/wire.js +0 -186
- package/dist/services/wire.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"remote.js","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"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","sourcesContent":["import { Value } from \"typebox/value\";\nimport { HYDRATION, type Hydration } from \"./cell.ts\";\nimport { type AnyContract, takesNoArgs } from \"./contract.ts\";\nimport { applyImmutable, type Decoder, decoder } from \"./delta/index.ts\";\nimport { ChordError, invalid } from \"./errors.ts\";\nimport {\n\tCtxImpl,\n\tnotifyStatus,\n\tREF_BASE,\n\ttype RefCore,\n\ttype RefOwner,\n\traceSignal,\n\trefsByProxy,\n\ttype StatusListener,\n} from \"./object.ts\";\nimport type { Ctx, Readable, RefStatus, Shape, StateEvent } from \"./types.ts\";\nimport { fromWireError, type RootRef, type WireError } from \"./wire.ts\";\n\nconst noop = (): void => {};\n\n/** One state frame for a member, as the binding receives it (payload unpacked). */\nexport interface StateIn {\n\treadonly as: \"snap\" | \"reset\" | \"ops\" | \"error\";\n\treadonly value?: unknown;\n\treadonly ops?: readonly unknown[];\n\treadonly error?: WireError;\n}\n\n/** What a binding needs from the link it is bound to (implemented by Connection). */\nexport interface RemoteChannel {\n\t/** Sends a hold for `binding`; `again`: the binding already has values (a re-hold), its unit is not urgent. */\n\thold(binding: RemoteBinding, again: boolean): number;\n\trelease(id: number): void;\n\tcall(hold: number, member: string, args: unknown, root: RootRef | undefined, signal: AbortSignal): Promise<unknown>;\n\t/** Starts (`sub`) or stops (`unsub`) the state of a hold. */\n\twantState(hold: number, wanted: boolean): void;\n}\n\n/** What a binding needs from its host. */\nexport interface RemoteHost {\n\treadonly inFactory: number;\n\treport(error: unknown): void;\n\troot<T>(fn: (ctx: Ctx) => T | Promise<T>, options?: { signal?: AbortSignal }): Promise<T>;\n\t/** The binding has no views left: the host lingers it or closes it. */\n\tbindingIdle(binding: RemoteBinding): void;\n\t/** The binding ended or was closed: the host forgets it. */\n\tforgetBinding(binding: RemoteBinding): void;\n}\n\ntype Settle = { resolve: () => void; reject: (error: unknown) => void };\n\nfunction deferred(): { promise: Promise<void> } & Settle {\n\tlet resolve = noop;\n\tlet reject: (error: unknown) => void = noop;\n\tconst promise = new Promise<void>((done, fail) => {\n\t\tresolve = done;\n\t\treject = fail;\n\t});\n\tpromise.catch(noop);\n\treturn { promise, resolve, reject };\n}\n\n/** A member's value with the decoder of its current stream. */\ninterface MemberState {\n\tvalue: unknown;\n\tdecoder: Decoder;\n}\n\n/**\n * One hold per host and key (type, normalized input, principal key, contract fingerprint), shared by every reference to\n * it: one hold over the link, one stream per state member, calls over the same hold. References are views onto it.\n *\n * A hold implies the state of its variant (unless no view wants state): the provider answers with a unit, the shape\n * followed by a snapshot of each state member the binding lacks. A shape is applied only once all of its snapshots are\n * here, so a live binding always has every state member of its variant. After the first hydration the values stay\n * readable while the binding re-holds (link loss): status `loading`, last values kept.\n */\nexport class RemoteBinding {\n\treadonly host: RemoteHost;\n\treadonly key: string;\n\treadonly contract: AnyContract;\n\treadonly at: string;\n\treadonly input: unknown;\n\t/** Forwarded principal (omitted for the host's own principal). */\n\treadonly principal: unknown | undefined;\n\t/** `ended`: gone with `error`, or closed (no views, no linger). */\n\tstatus: \"loading\" | \"live\" | \"ended\" = \"loading\";\n\terror: unknown;\n\t/** The applied shape (kept while re-holding). */\n\tshape: Shape | undefined;\n\t/** Every state member of the applied shape has a value (stays true while re-holding). */\n\thydrated = false;\n\t/** The current hold; undefined while resolving the route or after a link loss. */\n\thold: { readonly channel: RemoteChannel; readonly id: number } | undefined;\n\t/** What the provider was told: state for this hold (`state: false` / `sub` / `unsub`). */\n\tstateOn = false;\n\treadonly views = new Set<RemoteRef>();\n\treadonly members = new Map<string, MemberState>();\n\t/** Lingering since (no views): set by the host. */\n\tlingerTimer: ReturnType<typeof setTimeout> | undefined;\n\treadonly #listeners = new Map<string, Set<ViewReadable>>();\n\t/** A shape waiting for its snapshots. */\n\t#pending: { shape: Shape; readonly missing: Set<string>; readonly values: Map<string, MemberState> } | undefined;\n\t/** Resolved while a shape is applied for the current hold (calls wait for it). */\n\t#live = deferred();\n\t/** A shape was applied once (a re-hold says `again`). */\n\t#applied = false;\n\t/** Waiting for the first hydration (`whenHydrated`). */\n\treadonly #hydrationWaiters = new Set<Settle>();\n\n\tconstructor(\n\t\thost: RemoteHost,\n\t\tfields: { key: string; contract: AnyContract; at: string; input: unknown; principal: unknown | undefined },\n\t) {\n\t\tthis.host = host;\n\t\tthis.key = fields.key;\n\t\tthis.contract = fields.contract;\n\t\tthis.at = fields.at;\n\t\tthis.input = fields.input;\n\t\tthis.principal = fields.principal;\n\t}\n\n\tget ended(): boolean {\n\t\treturn this.status === \"ended\";\n\t}\n\n\t/** Views that want state. */\n\tget stateViews(): number {\n\t\tlet count = 0;\n\t\tfor (const view of this.views) if (view.wantsState) count++;\n\t\treturn count;\n\t}\n\n\t/** Whether the next hold should carry state: some view wants it, or nobody is left (lingering keeps it). */\n\tget wantsState(): boolean {\n\t\treturn this.views.size === 0 ? this.stateOn : this.stateViews > 0;\n\t}\n\n\t/** Whether a re-hold is `again` (the binding already has a shape). */\n\tget applied(): boolean {\n\t\treturn this.#applied;\n\t}\n\n\t// ─── views ───\n\n\taddView(view: RemoteRef): void {\n\t\tthis.views.add(view);\n\t\tif (this.lingerTimer !== undefined) {\n\t\t\tclearTimeout(this.lingerTimer);\n\t\t\tthis.lingerTimer = undefined;\n\t\t}\n\t\tthis.#syncState();\n\t\tview.update();\n\t}\n\n\tremoveView(view: RemoteRef): void {\n\t\tif (!this.views.delete(view)) return;\n\t\tfor (const set of this.#listeners.values())\n\t\t\tfor (const readable of set) if (readable.view === view) set.delete(readable);\n\t\tif (this.views.size === 0) {\n\t\t\tthis.host.bindingIdle(this);\n\t\t\treturn;\n\t\t}\n\t\tthis.#syncState();\n\t}\n\n\t/** Tells the provider to start or stop state when the views' wish changed. */\n\t#syncState(): void {\n\t\tif (this.ended || this.views.size === 0) return;\n\t\tconst wanted = this.stateViews > 0;\n\t\tif (wanted === this.stateOn) return;\n\t\tthis.stateOn = wanted;\n\t\tif (!wanted) {\n\t\t\tthis.hydrated = false;\n\t\t\tthis.members.clear();\n\t\t\tif (this.#pending !== undefined) this.#pending.missing.clear();\n\t\t}\n\t\tif (this.hold !== undefined) this.hold.channel.wantState(this.hold.id, wanted);\n\t\tfor (const view of this.views) view.update();\n\t}\n\n\tlisten(name: string, readable: ViewReadable): void {\n\t\tlet set = this.#listeners.get(name);\n\t\tif (set === undefined) {\n\t\t\tset = new Set();\n\t\t\tthis.#listeners.set(name, set);\n\t\t}\n\t\tset.add(readable);\n\t}\n\n\tunlisten(name: string, readable: ViewReadable): void {\n\t\tthis.#listeners.get(name)?.delete(readable);\n\t}\n\n\t/** Whether `name` is a state member of the applied variant (as the consumer's contract describes it). */\n\tinVariant(name: string): boolean {\n\t\tconst variant = this.shape?.variant;\n\t\treturn variant !== undefined && this.contract.description.variants[variant]?.[name]?.kind === \"state\";\n\t}\n\n\t/** The members' value as views read it: throws `not_ready` before the first hydration, `not_in_variant` outside it. */\n\tread(name: string): unknown {\n\t\tif (this.status === \"ended\") throw this.terminalError();\n\t\tif (!this.hydrated) throw new ChordError(\"not_ready\", `${this.key}.${name} is not hydrated yet`);\n\t\tif (!this.inVariant(name))\n\t\t\tthrow new ChordError(\n\t\t\t\t\"not_in_variant\",\n\t\t\t\t`${this.key}: ${name} is not a state member of variant ${this.shape?.variant}`,\n\t\t\t);\n\t\treturn this.members.get(name)?.value;\n\t}\n\n\t/** Resolves once the binding has its state (rejects if it ends first). */\n\twhenHydrated(): Promise<void> {\n\t\tif (this.hydrated) return Promise.resolve();\n\t\tif (this.ended) return Promise.reject(this.terminalError());\n\t\treturn new Promise<void>((resolve, reject) => this.#hydrationWaiters.add({ resolve, reject }));\n\t}\n\n\t#settleHydration(error?: unknown): void {\n\t\tconst waiters = [...this.#hydrationWaiters];\n\t\tthis.#hydrationWaiters.clear();\n\t\tfor (const waiter of waiters) {\n\t\t\tif (error === undefined) waiter.resolve();\n\t\t\telse waiter.reject(error);\n\t\t}\n\t}\n\n\treadable(name: string): boolean {\n\t\treturn this.status !== \"ended\" && this.hydrated && this.inVariant(name);\n\t}\n\n\tterminalError(): unknown {\n\t\treturn this.error ?? new ChordError(\"released\", `reference ${this.key} released`);\n\t}\n\n\t// ─── driven by the host and the link ───\n\n\tbound(channel: RemoteChannel, id: number): void {\n\t\tthis.hold = { channel, id };\n\t\tthis.stateOn = this.wantsState;\n\t}\n\n\t/** A unit begins: `listed` are the members whose snapshots follow. */\n\tshaped(shape: Shape, listed: readonly string[]): void {\n\t\tif (this.ended) return;\n\t\tconst previous = this.#pending;\n\t\tconst missing = new Set<string>(listed);\n\t\t// A newer shape before the older one's snapshots (relays may reorder them): wait for both.\n\t\tif (previous !== undefined) for (const name of previous.missing) missing.add(name);\n\t\tconst wanted = new Set(this.#stateMembers(shape));\n\t\tfor (const name of [...missing]) if (!wanted.has(name) || !this.stateOn) missing.delete(name);\n\t\tthis.#pending = { shape, missing, values: previous?.values ?? new Map() };\n\t\tif (missing.size === 0) this.#apply();\n\t}\n\n\t/** A state frame for member `name` of the current hold. */\n\tstate(name: string, frame: StateIn): void {\n\t\tif (this.ended) return;\n\t\tif (frame.as === \"error\") {\n\t\t\tconst error = fromWireError(frame.error!);\n\t\t\t// Before the first hydration nobody could read anything: the binding fails instead of waiting forever.\n\t\t\tif (!this.hydrated && this.stateOn) {\n\t\t\t\tthis.gone(error);\n\t\t\t\tthis.close();\n\t\t\t} else this.host.report(error);\n\t\t\treturn;\n\t\t}\n\t\tconst pending = this.#pending;\n\t\tif (frame.as === \"ops\") {\n\t\t\tconst target = pending?.values.get(name) ?? this.members.get(name);\n\t\t\tif (target === undefined) return;\n\t\t\tconst ops = target.decoder.decode(frame.ops ?? []);\n\t\t\ttarget.value = applyImmutable(target.value, ops);\n\t\t\tif (target === this.members.get(name)) this.#deliver(name, { type: \"ops\", ops, value: target.value });\n\t\t\treturn;\n\t\t}\n\t\tconst fresh: MemberState = { value: frame.value, decoder: decoder() };\n\t\tif (pending !== undefined && (pending.missing.has(name) || pending.values.has(name))) {\n\t\t\tpending.values.set(name, fresh);\n\t\t\tpending.missing.delete(name);\n\t\t\tif (pending.missing.size === 0) this.#apply();\n\t\t\treturn;\n\t\t}\n\t\tif (!this.inVariant(name)) return;\n\t\tthis.members.set(name, fresh);\n\t\tthis.#deliver(name, { type: \"reset\", value: fresh.value });\n\t}\n\n\t/** The provider ended the object (or refused the hold): every view is gone. */\n\tgone(error: unknown): void {\n\t\tif (this.ended) return;\n\t\tthis.status = \"ended\";\n\t\tthis.error = error;\n\t\tthis.hold = undefined;\n\t\tthis.#pending = undefined;\n\t\tthis.#live.reject(error);\n\t\tthis.#settleHydration(error);\n\t\tfor (const view of [...this.views]) view.end(error);\n\t\tthis.#listeners.clear();\n\t\tthis.host.forgetBinding(this);\n\t}\n\n\t/** The link went down but may come back (upstream reconnect): keep the values, wait for the re-hold. */\n\tdetached(): void {\n\t\tif (this.ended) return;\n\t\tthis.hold = undefined;\n\t\tthis.#pending = undefined;\n\t\tif (this.status === \"live\") {\n\t\t\tthis.status = \"loading\";\n\t\t\tthis.#live = deferred();\n\t\t}\n\t\tfor (const view of this.views) view.update();\n\t}\n\n\t/** No views and no linger: releases the hold and forgets the binding. */\n\tclose(): void {\n\t\tif (this.lingerTimer !== undefined) clearTimeout(this.lingerTimer);\n\t\tthis.lingerTimer = undefined;\n\t\tif (this.hold !== undefined) this.hold.channel.release(this.hold.id);\n\t\tthis.hold = undefined;\n\t\tif (this.status !== \"ended\") {\n\t\t\tthis.status = \"ended\";\n\t\t\tconst error = new ChordError(\"released\", `reference ${this.key} released`);\n\t\t\tthis.#live.reject(error);\n\t\t\tthis.#settleHydration(error);\n\t\t\tfor (const view of [...this.views]) view.end(error);\n\t\t}\n\t\tthis.#pending = undefined;\n\t\tthis.#listeners.clear();\n\t\tthis.host.forgetBinding(this);\n\t}\n\n\t/** Calls `name` over the current hold, waiting for it while the binding (re)holds. */\n\tasync call(name: string, args: unknown, ctx: Ctx): Promise<unknown> {\n\t\tfor (;;) {\n\t\t\tif (this.ended) throw this.terminalError();\n\t\t\tif (this.status !== \"live\" || this.hold === undefined) await raceSignal(this.#live.promise, ctx.signal);\n\t\t\tconst hold = this.hold;\n\t\t\tif (hold === undefined || this.status !== \"live\") continue;\n\t\t\tconst variant = this.shape?.variant;\n\t\t\tconst description = variant === undefined ? undefined : this.contract.description.variants[variant]?.[name];\n\t\t\tif (description?.kind !== \"method\") {\n\t\t\t\tthrow new ChordError(\"not_in_variant\", `${this.key}: ${name} is not a method of variant ${variant}`);\n\t\t\t}\n\t\t\t// Send only what the consumer's own schema knows (the additive rule's premise; see ObjectImpl.call).\n\t\t\tconst sent = description.args === undefined ? undefined : Value.Clean(description.args, Value.Clone(args));\n\t\t\treturn hold.channel.call(\n\t\t\t\thold.id,\n\t\t\t\tname,\n\t\t\t\tsent,\n\t\t\t\t{ rootId: ctx.rootId, codeVersion: ctx.codeVersion },\n\t\t\t\tctx.signal,\n\t\t\t);\n\t\t}\n\t}\n\n\t#stateMembers(shape: Shape): string[] {\n\t\tconst members = shape.variant === undefined ? undefined : this.contract.description.variants[shape.variant];\n\t\tif (members === undefined) return [];\n\t\treturn shape.members.filter((name) => members[name]?.kind === \"state\");\n\t}\n\n\t/** Applies the pending shape with its snapshots: members outside the variant go, new values are announced. */\n\t#apply(): void {\n\t\tconst pending = this.#pending;\n\t\tif (pending === undefined) return;\n\t\tthis.#pending = undefined;\n\t\tthis.shape = pending.shape;\n\t\tconst wanted = new Set(this.#stateMembers(pending.shape));\n\t\tfor (const name of [...this.members.keys()]) if (!wanted.has(name)) this.members.delete(name);\n\t\tfor (const [name, state] of pending.values) if (wanted.has(name)) this.members.set(name, state);\n\t\tthis.hydrated = this.stateOn && [...wanted].every((name) => this.members.has(name));\n\t\tif (this.hydrated) this.#settleHydration();\n\t\tthis.status = \"live\";\n\t\tthis.#applied = true;\n\t\tthis.#live.resolve();\n\t\tfor (const view of this.views) view.update();\n\t\tfor (const [name, state] of pending.values) {\n\t\t\tif (wanted.has(name)) this.#deliver(name, { type: \"reset\", value: state.value });\n\t\t}\n\t\tfor (const view of [...this.views]) view.shapeChanged();\n\t}\n\n\t#deliver(name: string, event: StateEvent<unknown>): void {\n\t\tconst readables = this.#listeners.get(name);\n\t\tif (readables === undefined) return;\n\t\tfor (const readable of [...readables]) readable.deliver(event);\n\t}\n}\n\n/**\n * A state member of a remote reference: the binding's value. Reading throws `not_ready` before the first hydration and\n * `not_in_variant` outside the variant. A listener added before the hydration gets its snapshot then.\n */\nclass ViewReadable implements Readable<unknown> {\n\treadonly view: RemoteRef;\n\treadonly #name: string;\n\treadonly #values = new Set<(value: unknown) => void>();\n\treadonly #events = new Set<(event: StateEvent<unknown>) => void>();\n\t/** Event listeners that have not had their snapshot yet. */\n\treadonly #unseen = new Set<(event: StateEvent<unknown>) => void>();\n\n\tconstructor(view: RemoteRef, name: string) {\n\t\tthis.view = view;\n\t\tthis.#name = name;\n\t}\n\n\tget value(): unknown {\n\t\tif (this.view.ended) throw this.view.terminalError();\n\t\treturn this.view.binding.read(this.#name);\n\t}\n\n\t/** Not hydrated before the binding's first snapshots (a local object forwarding this member waits for them). */\n\tget [HYDRATION](): Hydration | undefined {\n\t\tconst binding = this.view.binding;\n\t\tif (binding.hydrated) return undefined;\n\t\treturn { hydrated: false, whenHydrated: () => binding.whenHydrated() };\n\t}\n\n\tsubscribe(listener: (value: unknown) => void): () => void {\n\t\tthis.#values.add(listener);\n\t\tthis.#attach();\n\t\tif (this.#readable()) this.#safe(() => listener(this.view.binding.members.get(this.#name)?.value));\n\t\treturn () => this.#remove(this.#values, listener);\n\t}\n\n\tevents(listener: (event: StateEvent<unknown>) => void): () => void {\n\t\tthis.#events.add(listener);\n\t\tthis.#attach();\n\t\tif (this.#readable()) {\n\t\t\tconst value = this.view.binding.members.get(this.#name)?.value;\n\t\t\tthis.#safe(() => listener({ type: \"snap\", value }));\n\t\t} else this.#unseen.add(listener);\n\t\treturn () => {\n\t\t\tthis.#unseen.delete(listener);\n\t\t\tthis.#remove(this.#events, listener);\n\t\t};\n\t}\n\n\tdeliver(event: StateEvent<unknown>): void {\n\t\tfor (const listener of [...this.#events]) {\n\t\t\tif (!this.#unseen.delete(listener)) this.#safe(() => listener(event));\n\t\t\telse if (event.type !== \"ops\") this.#safe(() => listener({ type: \"snap\", value: event.value }));\n\t\t}\n\t\tfor (const listener of [...this.#values]) this.#safe(() => listener(event.value));\n\t}\n\n\tstop(): void {\n\t\tthis.#values.clear();\n\t\tthis.#events.clear();\n\t\tthis.#unseen.clear();\n\t\tthis.view.binding.unlisten(this.#name, this);\n\t}\n\n\t#readable(): boolean {\n\t\treturn !this.view.ended && this.view.binding.readable(this.#name);\n\t}\n\n\t#attach(): void {\n\t\tif (!this.view.ended) this.view.binding.listen(this.#name, this);\n\t}\n\n\t#remove<T>(set: Set<T>, listener: T): void {\n\t\tset.delete(listener);\n\t\tif (this.#values.size + this.#events.size === 0) this.view.binding.unlisten(this.#name, this);\n\t}\n\n\t#safe(fn: () => void): void {\n\t\ttry {\n\t\t\tfn();\n\t\t} catch (error) {\n\t\t\tthis.view.binding.host.report(error);\n\t\t}\n\t}\n}\n\n/**\n * A reference to an object on another host: a view onto the host's shared binding for its key. Each view has its own\n * owner, status, observers and `release`; ending by the provider and re-holding belong to the binding.\n */\nexport class RemoteRef implements RefCore {\n\treadonly object = undefined;\n\treadonly binding: RemoteBinding;\n\treadonly owner: RefOwner;\n\t/** False: a method-only view (`state: false`), ready once live. */\n\treadonly wantsState: boolean;\n\treadonly proxy: object;\n\treadonly ready: Promise<void>;\n\tstatus: RefStatus = \"loading\";\n\terror: unknown;\n\treadonly shapeListeners = new Set<(shape: Shape) => void>();\n\treadonly #statusListeners = new Set<StatusListener>();\n\treadonly #readables = new Map<string, ViewReadable>();\n\treadonly #callers = new Map<string, (...given: unknown[]) => Promise<unknown>>();\n\t#settleReady: Settle | undefined;\n\n\tconstructor(binding: RemoteBinding, owner: RefOwner, wantsState: boolean) {\n\t\tthis.binding = binding;\n\t\tthis.owner = owner;\n\t\tthis.wantsState = wantsState;\n\t\tconst ready = deferred();\n\t\tthis.ready = ready.promise;\n\t\tthis.#settleReady = ready;\n\t\tthis.proxy = new Proxy(this, {\n\t\t\tget: (target, property) => {\n\t\t\t\tif (REF_BASE.has(property)) {\n\t\t\t\t\tconst value: unknown = Reflect.get(target, property, target);\n\t\t\t\t\treturn typeof value === \"function\" ? value.bind(target) : value;\n\t\t\t\t}\n\t\t\t\tif (typeof property !== \"string\" || property === \"then\") return undefined;\n\t\t\t\treturn target.member(property);\n\t\t\t},\n\t\t});\n\t\trefsByProxy.set(this.proxy, this);\n\t}\n\n\tget contract(): AnyContract {\n\t\treturn this.binding.contract;\n\t}\n\n\tget address(): string {\n\t\treturn this.binding.key;\n\t}\n\n\tget ended(): boolean {\n\t\treturn this.status === \"released\" || this.status === \"gone\";\n\t}\n\n\tget variant(): string | undefined {\n\t\treturn this.binding.shape?.variant;\n\t}\n\n\tget shape(): Shape | undefined {\n\t\treturn this.binding.shape;\n\t}\n\n\tonShape(listener: (shape: Shape) => void): () => void {\n\t\tthis.shapeListeners.add(listener);\n\t\treturn () => this.shapeListeners.delete(listener);\n\t}\n\n\tonStatus(listener: StatusListener): () => void {\n\t\tthis.#statusListeners.add(listener);\n\t\treturn () => this.#statusListeners.delete(listener);\n\t}\n\n\tterminalError(): unknown {\n\t\treturn this.status === \"gone\" ? this.error : new ChordError(\"released\", `reference ${this.address} released`);\n\t}\n\n\trelease(): void {\n\t\tif (this.ended) return;\n\t\tthis.status = \"released\";\n\t\tthis.#notify();\n\t\tthis.#settleReady?.reject(new ChordError(\"released\", `reference ${this.address} released`));\n\t\tthis.#settleReady = undefined;\n\t\tfor (const readable of this.#readables.values()) readable.stop();\n\t\tthis.binding.removeView(this);\n\t}\n\n\t// ─── driven by the binding ───\n\n\t/** Follows the binding: live once it has a shape (and, for a state view, its state) over a current hold. */\n\tupdate(): void {\n\t\tif (this.ended) return;\n\t\tconst binding = this.binding;\n\t\tconst live = binding.status === \"live\" && binding.hold !== undefined && (!this.wantsState || binding.hydrated);\n\t\tconst next: RefStatus = live ? \"live\" : \"loading\";\n\t\tif (next === this.status) return;\n\t\tthis.status = next;\n\t\tthis.#notify();\n\t\tif (live) {\n\t\t\tthis.#settleReady?.resolve();\n\t\t\tthis.#settleReady = undefined;\n\t\t}\n\t}\n\n\tend(error: unknown): void {\n\t\tif (this.ended) return;\n\t\tconst released = error instanceof ChordError && error.code === \"released\";\n\t\tthis.status = released ? \"released\" : \"gone\";\n\t\tif (!released) this.error = error;\n\t\tthis.#notify();\n\t\tthis.#settleReady?.reject(error);\n\t\tthis.#settleReady = undefined;\n\t\tfor (const readable of this.#readables.values()) readable.stop();\n\t}\n\n\tshapeChanged(): void {\n\t\tconst shape = this.binding.shape;\n\t\tif (shape === undefined || this.ended) return;\n\t\tfor (const listener of [...this.shapeListeners]) {\n\t\t\ttry {\n\t\t\t\tlistener(shape);\n\t\t\t} catch (error) {\n\t\t\t\tthis.binding.host.report(error);\n\t\t\t}\n\t\t}\n\t}\n\n\t#notify(): void {\n\t\tnotifyStatus(this.#statusListeners, this.status, this.error, (error) => this.binding.host.report(error));\n\t}\n\n\t// ─── members ───\n\n\tmember(name: string): unknown {\n\t\tconst description = Object.values(this.contract.description.variants)\n\t\t\t.map((members) => members[name])\n\t\t\t.find((member) => member !== undefined);\n\t\tif (description?.kind === \"method\") return this.#caller(name);\n\t\tif (description?.kind === \"state\") {\n\t\t\tlet readable = this.#readables.get(name);\n\t\t\tif (readable === undefined) {\n\t\t\t\treadable = new ViewReadable(this, name);\n\t\t\t\tthis.#readables.set(name, readable);\n\t\t\t}\n\t\t\treturn readable;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t#caller(name: string): (...given: unknown[]) => Promise<unknown> {\n\t\tlet caller = this.#callers.get(name);\n\t\tif (caller === undefined) {\n\t\t\tconst noArgs = takesNoArgs(this.contract, name);\n\t\t\tcaller = (...given) => {\n\t\t\t\t// A method without arguments is called as `ref.name(ctx)`.\n\t\t\t\tconst [args, ctx] = (noArgs ? [undefined, given[0]] : given) as [unknown, Ctx | undefined];\n\t\t\t\tconst host = this.binding.host;\n\t\t\t\tif (host.inFactory > 0)\n\t\t\t\t\tthrow new ChordError(\"not_ready\", `${this.address}.${name} called inside a factory`);\n\t\t\t\t// The same checks as a local reference's caller (RefImpl.caller and ObjectImpl.call): a ctx from another host\n\t\t\t\t// or one not made by Chord would carry a root this host does not own over its link.\n\t\t\t\tif (ctx !== undefined && !(ctx instanceof CtxImpl)) {\n\t\t\t\t\treturn Promise.reject(invalid(\"foreign_ctx\", \"ctx must come from a Chord host\"));\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tctx?.check(host);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treturn Promise.reject(error);\n\t\t\t\t}\n\t\t\t\tif (ctx === undefined || ctx.holder) {\n\t\t\t\t\treturn host.root((root) => this.#call(name, args, root), { signal: ctx?.signal });\n\t\t\t\t}\n\t\t\t\treturn this.#call(name, args, ctx);\n\t\t\t};\n\t\t\tthis.#callers.set(name, caller);\n\t\t}\n\t\treturn caller;\n\t}\n\n\t#call(name: string, args: unknown, ctx: Ctx): Promise<unknown> {\n\t\tif (this.ended) return Promise.reject(this.terminalError());\n\t\treturn this.binding.call(name, args, ctx);\n\t}\n}\n"]}
|
package/dist/schema.d.ts
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { TSchema } from "typebox";
|
|
2
|
+
import { type ChordErrorReason } from "./errors.ts";
|
|
3
|
+
/** Canonical JSON: sorted object keys, `undefined` members dropped. */
|
|
4
|
+
export declare function canonicalJson(value: unknown): string;
|
|
5
|
+
/** Non-cryptographic 64-bit hash (two FNV-1a lanes). Contracts are trusted, so collisions are not an attack surface. */
|
|
6
|
+
export declare function hash64(text: string): string;
|
|
7
|
+
export declare function deepEqual(a: unknown, b: unknown): boolean;
|
|
8
|
+
/** Throws `invalid` (with `reason`) and the first schema errors when `value` does not match. */
|
|
9
|
+
export declare function assertValid(reason: ChordErrorReason, what: string, schema: TSchema, value: unknown): void;
|
|
10
|
+
/** Applies defaults, strips unknown fields, validates. Returns a fresh value. */
|
|
11
|
+
export declare function normalize(schema: TSchema, value: unknown, what: string): unknown;
|
|
12
|
+
/** Canonical identity of a normalized value: fields equal to their schema default are omitted. */
|
|
13
|
+
export declare function canonicalIdentity(schema: TSchema, value: unknown): string;
|
|
14
|
+
/**
|
|
15
|
+
* Conservative structural subtyping: true only if every value valid under `sub` is valid under `sup`, where object
|
|
16
|
+
* fields missing from `sub` but optional in `sup` count as fine (unknown fields are stripped at the provider, see
|
|
17
|
+
* `RecordImpl.call`). A provider schema using a keyword this function does not model (`not`, `allOf`, `contains`,
|
|
18
|
+
* `$ref`, ...) or an `additionalProperties` schema only fits an identical consumer schema.
|
|
19
|
+
*/
|
|
20
|
+
export declare function fits(subSchema: unknown, supSchema: unknown): boolean;
|
|
21
|
+
//# sourceMappingURL=schema.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,aAAa,CAAC;AAQ7D,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOpD;AAED,wHAAwH;AACxH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS3C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKzG;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIhF;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzE;AAyED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CA0BpE"}
|
package/dist/schema.js
ADDED
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
import { Value } from "typebox/value";
|
|
2
|
+
import { invalid } from "./errors.js";
|
|
3
|
+
const asSchema = (schema) => schema !== null && typeof schema === "object" ? schema : schema === false ? { not: {} } : {};
|
|
4
|
+
/** Canonical JSON: sorted object keys, `undefined` members dropped. */
|
|
5
|
+
export function canonicalJson(value) {
|
|
6
|
+
if (value === null || typeof value !== "object")
|
|
7
|
+
return JSON.stringify(value) ?? "null";
|
|
8
|
+
if (Array.isArray(value))
|
|
9
|
+
return `[${value.map((item) => canonicalJson(item)).join(",")}]`;
|
|
10
|
+
const keys = Object.keys(value)
|
|
11
|
+
.filter((key) => value[key] !== undefined)
|
|
12
|
+
.sort();
|
|
13
|
+
return `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`).join(",")}}`;
|
|
14
|
+
}
|
|
15
|
+
/** Non-cryptographic 64-bit hash (two FNV-1a lanes). Contracts are trusted, so collisions are not an attack surface. */
|
|
16
|
+
export function hash64(text) {
|
|
17
|
+
let a = 0x811c9dc5;
|
|
18
|
+
let b = 0x01000193 ^ 0x5bd1e995;
|
|
19
|
+
for (let index = 0; index < text.length; index++) {
|
|
20
|
+
const code = text.charCodeAt(index);
|
|
21
|
+
a = Math.imul(a ^ code, 0x01000193);
|
|
22
|
+
b = Math.imul(b ^ code, 0x5bd1e995) ^ (b >>> 13);
|
|
23
|
+
}
|
|
24
|
+
return (a >>> 0).toString(16).padStart(8, "0") + (b >>> 0).toString(16).padStart(8, "0");
|
|
25
|
+
}
|
|
26
|
+
export function deepEqual(a, b) {
|
|
27
|
+
return a === b || canonicalJson(a) === canonicalJson(b);
|
|
28
|
+
}
|
|
29
|
+
/** Throws `invalid` (with `reason`) and the first schema errors when `value` does not match. */
|
|
30
|
+
export function assertValid(reason, what, schema, value) {
|
|
31
|
+
if (Value.Check(schema, value))
|
|
32
|
+
return;
|
|
33
|
+
const errors = [...Value.Errors(schema, value)].slice(0, 3);
|
|
34
|
+
const summary = errors.map((error) => `${error.instancePath || "/"} ${error.message}`).join("; ");
|
|
35
|
+
throw invalid(reason, `${what}: ${summary}`, errors);
|
|
36
|
+
}
|
|
37
|
+
/** Applies defaults, strips unknown fields, validates. Returns a fresh value. */
|
|
38
|
+
export function normalize(schema, value, what) {
|
|
39
|
+
const normalized = Value.Clean(schema, Value.Default(schema, Value.Clone(value ?? {})));
|
|
40
|
+
assertValid("input", what, schema, normalized);
|
|
41
|
+
return normalized;
|
|
42
|
+
}
|
|
43
|
+
/** Canonical identity of a normalized value: fields equal to their schema default are omitted. */
|
|
44
|
+
export function canonicalIdentity(schema, value) {
|
|
45
|
+
return canonicalJson(stripDefaults(asSchema(schema), value));
|
|
46
|
+
}
|
|
47
|
+
function stripDefaults(schema, value) {
|
|
48
|
+
if (Array.isArray(value)) {
|
|
49
|
+
const items = schema.items;
|
|
50
|
+
if (Array.isArray(items))
|
|
51
|
+
return value.map((item, index) => stripDefaults(asSchema(items[index]), item));
|
|
52
|
+
return value.map((item) => stripDefaults(asSchema(items), item));
|
|
53
|
+
}
|
|
54
|
+
if (value === null || typeof value !== "object")
|
|
55
|
+
return value;
|
|
56
|
+
const properties = asSchema(schema.properties);
|
|
57
|
+
const result = {};
|
|
58
|
+
for (const [key, item] of Object.entries(value)) {
|
|
59
|
+
const property = asSchema(properties[key]);
|
|
60
|
+
if ("default" in property && deepEqual(property.default, item))
|
|
61
|
+
continue;
|
|
62
|
+
result[key] = stripDefaults(property, item);
|
|
63
|
+
}
|
|
64
|
+
return result;
|
|
65
|
+
}
|
|
66
|
+
const CONSTRAINTS = [
|
|
67
|
+
"minLength",
|
|
68
|
+
"maxLength",
|
|
69
|
+
"pattern",
|
|
70
|
+
"format",
|
|
71
|
+
"minimum",
|
|
72
|
+
"maximum",
|
|
73
|
+
"exclusiveMinimum",
|
|
74
|
+
"exclusiveMaximum",
|
|
75
|
+
"multipleOf",
|
|
76
|
+
"minItems",
|
|
77
|
+
"maxItems",
|
|
78
|
+
"uniqueItems",
|
|
79
|
+
"minProperties",
|
|
80
|
+
"maxProperties",
|
|
81
|
+
];
|
|
82
|
+
const typesOf = (schema) => typeof schema.type === "string" ? [schema.type] : Array.isArray(schema.type) ? schema.type : undefined;
|
|
83
|
+
/** Keywords `fits` reasons about. Any other validation keyword in the provider's schema forces exact equality. */
|
|
84
|
+
const KNOWN = new Set([
|
|
85
|
+
...CONSTRAINTS,
|
|
86
|
+
"type",
|
|
87
|
+
"properties",
|
|
88
|
+
"required",
|
|
89
|
+
"additionalProperties",
|
|
90
|
+
"patternProperties",
|
|
91
|
+
"items",
|
|
92
|
+
"additionalItems",
|
|
93
|
+
"const",
|
|
94
|
+
"enum",
|
|
95
|
+
"anyOf",
|
|
96
|
+
"parameters",
|
|
97
|
+
"returnType",
|
|
98
|
+
]);
|
|
99
|
+
/** Annotations: no effect on validity. */
|
|
100
|
+
const ANNOTATIONS = new Set([
|
|
101
|
+
"title",
|
|
102
|
+
"description",
|
|
103
|
+
"default",
|
|
104
|
+
"examples",
|
|
105
|
+
"$id",
|
|
106
|
+
"$schema",
|
|
107
|
+
"$comment",
|
|
108
|
+
"readOnly",
|
|
109
|
+
"writeOnly",
|
|
110
|
+
"deprecated",
|
|
111
|
+
]);
|
|
112
|
+
const withoutAnnotations = (schema) => Object.fromEntries(Object.entries(schema).filter(([key]) => !ANNOTATIONS.has(key)));
|
|
113
|
+
/**
|
|
114
|
+
* Conservative structural subtyping: true only if every value valid under `sub` is valid under `sup`, where object
|
|
115
|
+
* fields missing from `sub` but optional in `sup` count as fine (unknown fields are stripped at the provider, see
|
|
116
|
+
* `RecordImpl.call`). A provider schema using a keyword this function does not model (`not`, `allOf`, `contains`,
|
|
117
|
+
* `$ref`, ...) or an `additionalProperties` schema only fits an identical consumer schema.
|
|
118
|
+
*/
|
|
119
|
+
export function fits(subSchema, supSchema) {
|
|
120
|
+
const sub = withoutAnnotations(asSchema(subSchema));
|
|
121
|
+
const sup = withoutAnnotations(asSchema(supSchema));
|
|
122
|
+
if (Object.keys(sup).length === 0)
|
|
123
|
+
return true;
|
|
124
|
+
if (deepEqual(sub, sup))
|
|
125
|
+
return true;
|
|
126
|
+
if (Object.keys(sup).some((key) => !KNOWN.has(key)))
|
|
127
|
+
return false;
|
|
128
|
+
if (sup.additionalProperties !== undefined && typeof sup.additionalProperties !== "boolean")
|
|
129
|
+
return false;
|
|
130
|
+
if (Array.isArray(sub.anyOf))
|
|
131
|
+
return sub.anyOf.every((branch) => fits(branch, sup));
|
|
132
|
+
if (Array.isArray(sup.anyOf))
|
|
133
|
+
return sup.anyOf.some((branch) => fits(sub, branch));
|
|
134
|
+
if ("const" in sup)
|
|
135
|
+
return "const" in sub && deepEqual(sub.const, sup.const);
|
|
136
|
+
if (Array.isArray(sup.enum)) {
|
|
137
|
+
const values = "const" in sub ? [sub.const] : Array.isArray(sub.enum) ? sub.enum : undefined;
|
|
138
|
+
return values?.every((item) => sup.enum.some((allowed) => deepEqual(allowed, item))) ?? false;
|
|
139
|
+
}
|
|
140
|
+
for (const key of CONSTRAINTS)
|
|
141
|
+
if (key in sup && !deepEqual(sub[key], sup[key]))
|
|
142
|
+
return false;
|
|
143
|
+
const supTypes = typesOf(sup);
|
|
144
|
+
const subTypes = typesOf(sub);
|
|
145
|
+
if (supTypes === undefined || subTypes === undefined)
|
|
146
|
+
return false;
|
|
147
|
+
if (!subTypes.every((type) => supTypes.includes(type) || (type === "integer" && supTypes.includes("number")))) {
|
|
148
|
+
return false;
|
|
149
|
+
}
|
|
150
|
+
if ("const" in sub || Array.isArray(sub.enum))
|
|
151
|
+
return true;
|
|
152
|
+
if (subTypes.includes("object") && !objectFits(sub, sup))
|
|
153
|
+
return false;
|
|
154
|
+
if (subTypes.includes("array") && !arrayFits(sub, sup))
|
|
155
|
+
return false;
|
|
156
|
+
if (subTypes.includes("function"))
|
|
157
|
+
return functionFits(sub, sup);
|
|
158
|
+
return true;
|
|
159
|
+
}
|
|
160
|
+
function objectFits(sub, sup) {
|
|
161
|
+
const subProperties = asSchema(sub.properties);
|
|
162
|
+
const supProperties = asSchema(sup.properties);
|
|
163
|
+
const subRequired = new Set(sub.required ?? []);
|
|
164
|
+
for (const key of sup.required ?? [])
|
|
165
|
+
if (!subRequired.has(key))
|
|
166
|
+
return false;
|
|
167
|
+
for (const [key, property] of Object.entries(supProperties)) {
|
|
168
|
+
if (key in subProperties) {
|
|
169
|
+
if (!fits(subProperties[key], property))
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
else if (typeof sub.additionalProperties === "object" && !fits(sub.additionalProperties, property)) {
|
|
173
|
+
// The consumer may send this name with any value its `additionalProperties` allows. Open consumer objects
|
|
174
|
+
// are fine: unknown names are stripped with the consumer's own schema before the call (`RecordImpl.call`).
|
|
175
|
+
return false;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
if (sup.additionalProperties === false) {
|
|
179
|
+
if (sub.additionalProperties !== false)
|
|
180
|
+
return false;
|
|
181
|
+
if (Object.keys(subProperties).some((key) => !(key in supProperties)))
|
|
182
|
+
return false;
|
|
183
|
+
}
|
|
184
|
+
const supPatterns = asSchema(sup.patternProperties);
|
|
185
|
+
if (Object.keys(supPatterns).length > 0) {
|
|
186
|
+
// Every value the consumer may put under a matching name must fit, and the consumer must not allow arbitrary
|
|
187
|
+
// extra names (it would then allow any value under a matching one).
|
|
188
|
+
const subPatterns = asSchema(sub.patternProperties);
|
|
189
|
+
if (sub.additionalProperties !== false && Object.keys(subPatterns).length === 0)
|
|
190
|
+
return false;
|
|
191
|
+
for (const [pattern, property] of Object.entries(supPatterns)) {
|
|
192
|
+
const matcher = new RegExp(pattern, "u");
|
|
193
|
+
for (const [key, subProperty] of Object.entries(subProperties)) {
|
|
194
|
+
if (!(key in supProperties) && matcher.test(key) && !fits(subProperty, property))
|
|
195
|
+
return false;
|
|
196
|
+
}
|
|
197
|
+
if (Object.keys(subPatterns).length > 0 &&
|
|
198
|
+
(!(pattern in subPatterns) || !fits(subPatterns[pattern], property))) {
|
|
199
|
+
return false;
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
for (const pattern of Object.keys(subPatterns))
|
|
203
|
+
if (!(pattern in supPatterns))
|
|
204
|
+
return false;
|
|
205
|
+
}
|
|
206
|
+
return true;
|
|
207
|
+
}
|
|
208
|
+
function arrayFits(sub, sup) {
|
|
209
|
+
if (Array.isArray(sup.items)) {
|
|
210
|
+
if (!Array.isArray(sub.items) || sub.items.length !== sup.items.length)
|
|
211
|
+
return false;
|
|
212
|
+
return sub.items.every((item, index) => fits(item, sup.items[index]));
|
|
213
|
+
}
|
|
214
|
+
if (Array.isArray(sub.items))
|
|
215
|
+
return sub.items.every((item) => fits(item, sup.items));
|
|
216
|
+
return fits(sub.items, sup.items);
|
|
217
|
+
}
|
|
218
|
+
function functionFits(sub, sup) {
|
|
219
|
+
const subParameters = sub.parameters ?? [];
|
|
220
|
+
const supParameters = sup.parameters ?? [];
|
|
221
|
+
// A function accepting fewer parameters is fine; each shared parameter is contravariant.
|
|
222
|
+
if (subParameters.length > supParameters.length)
|
|
223
|
+
return false;
|
|
224
|
+
if (!subParameters.every((parameter, index) => fits(supParameters[index], parameter)))
|
|
225
|
+
return false;
|
|
226
|
+
return fits(sub.returnType, sup.returnType);
|
|
227
|
+
}
|
|
228
|
+
//# sourceMappingURL=schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TSchema } from \"typebox\";\nimport { Value } from \"typebox/value\";\nimport { type ChordErrorReason, invalid } from \"./errors.ts\";\n\n/** JSON Schema as data. TypeBox schemas are plain JSON Schema objects. */\ntype Schema = { readonly [key: string]: unknown };\n\nconst asSchema = (schema: unknown): Schema =>\n\tschema !== null && typeof schema === \"object\" ? (schema as Schema) : schema === false ? { not: {} } : {};\n\n/** Canonical JSON: sorted object keys, `undefined` members dropped. */\nexport function canonicalJson(value: unknown): string {\n\tif (value === null || typeof value !== \"object\") return JSON.stringify(value) ?? \"null\";\n\tif (Array.isArray(value)) return `[${value.map((item) => canonicalJson(item)).join(\",\")}]`;\n\tconst keys = Object.keys(value)\n\t\t.filter((key) => (value as Record<string, unknown>)[key] !== undefined)\n\t\t.sort();\n\treturn `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalJson((value as Record<string, unknown>)[key])}`).join(\",\")}}`;\n}\n\n/** Non-cryptographic 64-bit hash (two FNV-1a lanes). Contracts are trusted, so collisions are not an attack surface. */\nexport function hash64(text: string): string {\n\tlet a = 0x811c9dc5;\n\tlet b = 0x01000193 ^ 0x5bd1e995;\n\tfor (let index = 0; index < text.length; index++) {\n\t\tconst code = text.charCodeAt(index);\n\t\ta = Math.imul(a ^ code, 0x01000193);\n\t\tb = Math.imul(b ^ code, 0x5bd1e995) ^ (b >>> 13);\n\t}\n\treturn (a >>> 0).toString(16).padStart(8, \"0\") + (b >>> 0).toString(16).padStart(8, \"0\");\n}\n\nexport function deepEqual(a: unknown, b: unknown): boolean {\n\treturn a === b || canonicalJson(a) === canonicalJson(b);\n}\n\n/** Throws `invalid` (with `reason`) and the first schema errors when `value` does not match. */\nexport function assertValid(reason: ChordErrorReason, what: string, schema: TSchema, value: unknown): void {\n\tif (Value.Check(schema, value)) return;\n\tconst errors = [...Value.Errors(schema, value)].slice(0, 3);\n\tconst summary = errors.map((error) => `${error.instancePath || \"/\"} ${error.message}`).join(\"; \");\n\tthrow invalid(reason, `${what}: ${summary}`, errors);\n}\n\n/** Applies defaults, strips unknown fields, validates. Returns a fresh value. */\nexport function normalize(schema: TSchema, value: unknown, what: string): unknown {\n\tconst normalized = Value.Clean(schema, Value.Default(schema, Value.Clone(value ?? {})));\n\tassertValid(\"input\", what, schema, normalized);\n\treturn normalized;\n}\n\n/** Canonical identity of a normalized value: fields equal to their schema default are omitted. */\nexport function canonicalIdentity(schema: TSchema, value: unknown): string {\n\treturn canonicalJson(stripDefaults(asSchema(schema), value));\n}\n\nfunction stripDefaults(schema: Schema, value: unknown): unknown {\n\tif (Array.isArray(value)) {\n\t\tconst items = schema.items;\n\t\tif (Array.isArray(items)) return value.map((item, index) => stripDefaults(asSchema(items[index]), item));\n\t\treturn value.map((item) => stripDefaults(asSchema(items), item));\n\t}\n\tif (value === null || typeof value !== \"object\") return value;\n\tconst properties = asSchema(schema.properties);\n\tconst result: Record<string, unknown> = {};\n\tfor (const [key, item] of Object.entries(value)) {\n\t\tconst property = asSchema(properties[key]);\n\t\tif (\"default\" in property && deepEqual(property.default, item)) continue;\n\t\tresult[key] = stripDefaults(property, item);\n\t}\n\treturn result;\n}\n\nconst CONSTRAINTS = [\n\t\"minLength\",\n\t\"maxLength\",\n\t\"pattern\",\n\t\"format\",\n\t\"minimum\",\n\t\"maximum\",\n\t\"exclusiveMinimum\",\n\t\"exclusiveMaximum\",\n\t\"multipleOf\",\n\t\"minItems\",\n\t\"maxItems\",\n\t\"uniqueItems\",\n\t\"minProperties\",\n\t\"maxProperties\",\n] as const;\n\nconst typesOf = (schema: Schema): string[] | undefined =>\n\ttypeof schema.type === \"string\" ? [schema.type] : Array.isArray(schema.type) ? (schema.type as string[]) : undefined;\n\n/** Keywords `fits` reasons about. Any other validation keyword in the provider's schema forces exact equality. */\nconst KNOWN: ReadonlySet<string> = new Set([\n\t...CONSTRAINTS,\n\t\"type\",\n\t\"properties\",\n\t\"required\",\n\t\"additionalProperties\",\n\t\"patternProperties\",\n\t\"items\",\n\t\"additionalItems\",\n\t\"const\",\n\t\"enum\",\n\t\"anyOf\",\n\t\"parameters\",\n\t\"returnType\",\n]);\n\n/** Annotations: no effect on validity. */\nconst ANNOTATIONS: ReadonlySet<string> = new Set([\n\t\"title\",\n\t\"description\",\n\t\"default\",\n\t\"examples\",\n\t\"$id\",\n\t\"$schema\",\n\t\"$comment\",\n\t\"readOnly\",\n\t\"writeOnly\",\n\t\"deprecated\",\n]);\n\nconst withoutAnnotations = (schema: Schema): Schema =>\n\tObject.fromEntries(Object.entries(schema).filter(([key]) => !ANNOTATIONS.has(key)));\n\n/**\n * Conservative structural subtyping: true only if every value valid under `sub` is valid under `sup`, where object\n * fields missing from `sub` but optional in `sup` count as fine (unknown fields are stripped at the provider, see\n * `RecordImpl.call`). A provider schema using a keyword this function does not model (`not`, `allOf`, `contains`,\n * `$ref`, ...) or an `additionalProperties` schema only fits an identical consumer schema.\n */\nexport function fits(subSchema: unknown, supSchema: unknown): boolean {\n\tconst sub = withoutAnnotations(asSchema(subSchema));\n\tconst sup = withoutAnnotations(asSchema(supSchema));\n\tif (Object.keys(sup).length === 0) return true;\n\tif (deepEqual(sub, sup)) return true;\n\tif (Object.keys(sup).some((key) => !KNOWN.has(key))) return false;\n\tif (sup.additionalProperties !== undefined && typeof sup.additionalProperties !== \"boolean\") return false;\n\tif (Array.isArray(sub.anyOf)) return sub.anyOf.every((branch) => fits(branch, sup));\n\tif (Array.isArray(sup.anyOf)) return sup.anyOf.some((branch) => fits(sub, branch));\n\tif (\"const\" in sup) return \"const\" in sub && deepEqual(sub.const, sup.const);\n\tif (Array.isArray(sup.enum)) {\n\t\tconst values = \"const\" in sub ? [sub.const] : Array.isArray(sub.enum) ? sub.enum : undefined;\n\t\treturn values?.every((item) => (sup.enum as unknown[]).some((allowed) => deepEqual(allowed, item))) ?? false;\n\t}\n\tfor (const key of CONSTRAINTS) if (key in sup && !deepEqual(sub[key], sup[key])) return false;\n\tconst supTypes = typesOf(sup);\n\tconst subTypes = typesOf(sub);\n\tif (supTypes === undefined || subTypes === undefined) return false;\n\tif (!subTypes.every((type) => supTypes.includes(type) || (type === \"integer\" && supTypes.includes(\"number\")))) {\n\t\treturn false;\n\t}\n\tif (\"const\" in sub || Array.isArray(sub.enum)) return true;\n\tif (subTypes.includes(\"object\") && !objectFits(sub, sup)) return false;\n\tif (subTypes.includes(\"array\") && !arrayFits(sub, sup)) return false;\n\tif (subTypes.includes(\"function\")) return functionFits(sub, sup);\n\treturn true;\n}\n\nfunction objectFits(sub: Schema, sup: Schema): boolean {\n\tconst subProperties = asSchema(sub.properties);\n\tconst supProperties = asSchema(sup.properties);\n\tconst subRequired = new Set((sub.required as string[] | undefined) ?? []);\n\tfor (const key of (sup.required as string[] | undefined) ?? []) if (!subRequired.has(key)) return false;\n\tfor (const [key, property] of Object.entries(supProperties)) {\n\t\tif (key in subProperties) {\n\t\t\tif (!fits(subProperties[key], property)) return false;\n\t\t} else if (typeof sub.additionalProperties === \"object\" && !fits(sub.additionalProperties, property)) {\n\t\t\t// The consumer may send this name with any value its `additionalProperties` allows. Open consumer objects\n\t\t\t// are fine: unknown names are stripped with the consumer's own schema before the call (`RecordImpl.call`).\n\t\t\treturn false;\n\t\t}\n\t}\n\tif (sup.additionalProperties === false) {\n\t\tif (sub.additionalProperties !== false) return false;\n\t\tif (Object.keys(subProperties).some((key) => !(key in supProperties))) return false;\n\t}\n\tconst supPatterns = asSchema(sup.patternProperties);\n\tif (Object.keys(supPatterns).length > 0) {\n\t\t// Every value the consumer may put under a matching name must fit, and the consumer must not allow arbitrary\n\t\t// extra names (it would then allow any value under a matching one).\n\t\tconst subPatterns = asSchema(sub.patternProperties);\n\t\tif (sub.additionalProperties !== false && Object.keys(subPatterns).length === 0) return false;\n\t\tfor (const [pattern, property] of Object.entries(supPatterns)) {\n\t\t\tconst matcher = new RegExp(pattern, \"u\");\n\t\t\tfor (const [key, subProperty] of Object.entries(subProperties)) {\n\t\t\t\tif (!(key in supProperties) && matcher.test(key) && !fits(subProperty, property)) return false;\n\t\t\t}\n\t\t\tif (\n\t\t\t\tObject.keys(subPatterns).length > 0 &&\n\t\t\t\t(!(pattern in subPatterns) || !fits(subPatterns[pattern], property))\n\t\t\t) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t\tfor (const pattern of Object.keys(subPatterns)) if (!(pattern in supPatterns)) return false;\n\t}\n\treturn true;\n}\n\nfunction arrayFits(sub: Schema, sup: Schema): boolean {\n\tif (Array.isArray(sup.items)) {\n\t\tif (!Array.isArray(sub.items) || sub.items.length !== sup.items.length) return false;\n\t\treturn sub.items.every((item, index) => fits(item, (sup.items as unknown[])[index]));\n\t}\n\tif (Array.isArray(sub.items)) return sub.items.every((item) => fits(item, sup.items));\n\treturn fits(sub.items, sup.items);\n}\n\nfunction functionFits(sub: Schema, sup: Schema): boolean {\n\tconst subParameters = (sub.parameters as unknown[] | undefined) ?? [];\n\tconst supParameters = (sup.parameters as unknown[] | undefined) ?? [];\n\t// A function accepting fewer parameters is fine; each shared parameter is contravariant.\n\tif (subParameters.length > supParameters.length) return false;\n\tif (!subParameters.every((parameter, index) => fits(supParameters[index], parameter))) return false;\n\treturn fits(sub.returnType, sup.returnType);\n}\n"]}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { SqliteDatabase, SqliteExecutor, SqliteValue } from "./database.ts";
|
|
2
|
+
/** Values a Durable Object SQL binding accepts and returns. */
|
|
3
|
+
type DurableObjectSqlValue = ArrayBuffer | string | number | null;
|
|
4
|
+
/**
|
|
5
|
+
* The parts of a SQLite-backed Durable Object's `ctx.storage` this adapter uses, typed structurally so the package
|
|
6
|
+
* needs no Workers type dependency.
|
|
7
|
+
*/
|
|
8
|
+
export type DurableObjectSqliteStorage = {
|
|
9
|
+
readonly sql: {
|
|
10
|
+
exec(query: string, ...bindings: DurableObjectSqlValue[]): {
|
|
11
|
+
next(): {
|
|
12
|
+
readonly done?: false;
|
|
13
|
+
readonly value: Record<string, DurableObjectSqlValue>;
|
|
14
|
+
} | {
|
|
15
|
+
readonly done: true;
|
|
16
|
+
readonly value?: undefined;
|
|
17
|
+
};
|
|
18
|
+
toArray(): Record<string, DurableObjectSqlValue>[];
|
|
19
|
+
};
|
|
20
|
+
};
|
|
21
|
+
transaction<T>(closure: () => Promise<T>): Promise<T>;
|
|
22
|
+
};
|
|
23
|
+
/** Executes SQL through `ctx.storage.sql`, which has no separate prepare step. */
|
|
24
|
+
declare class DurableObjectSqliteExecutor implements SqliteExecutor {
|
|
25
|
+
protected readonly storage: DurableObjectSqliteStorage;
|
|
26
|
+
constructor(storage: DurableObjectSqliteStorage);
|
|
27
|
+
exec(sql: string): Promise<void>;
|
|
28
|
+
run(sql: string, ...params: SqliteValue[]): Promise<void>;
|
|
29
|
+
get<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T | undefined>;
|
|
30
|
+
all<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T[]>;
|
|
31
|
+
/** Throws when this handle may no longer run SQL. */
|
|
32
|
+
protected check(): void;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* `SqliteDatabase` adapter for the SQLite storage of a Cloudflare Durable Object. Adapters given the same storage
|
|
36
|
+
* object share a queue; direct calls to the underlying storage bypass it. Integers are JavaScript numbers; binding a
|
|
37
|
+
* `bigint` outside the safe integer range throws.
|
|
38
|
+
*/
|
|
39
|
+
export declare class DurableObjectSqliteDatabase extends DurableObjectSqliteExecutor implements SqliteDatabase {
|
|
40
|
+
private readonly queue;
|
|
41
|
+
constructor(storage: DurableObjectSqliteStorage);
|
|
42
|
+
exec(sql: string): Promise<void>;
|
|
43
|
+
run(sql: string, ...params: SqliteValue[]): Promise<void>;
|
|
44
|
+
get<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T | undefined>;
|
|
45
|
+
all<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T[]>;
|
|
46
|
+
/** `ctx.storage.transaction()` commits when the callback resolves and rolls back when it rejects. */
|
|
47
|
+
transaction<T>(callback: (transaction: SqliteExecutor) => Promise<T>): Promise<T>;
|
|
48
|
+
/** Waits for queued work. The Durable Object owns its storage, so nothing else closes. */
|
|
49
|
+
close(): Promise<void>;
|
|
50
|
+
}
|
|
51
|
+
export {};
|
|
52
|
+
//# sourceMappingURL=cloudflare.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/sqlite/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjF,+DAA+D;AAC/D,KAAK,qBAAqB,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACxC,QAAQ,CAAC,GAAG,EAAE;QACb,IAAI,CACH,KAAK,EAAE,MAAM,EACb,GAAG,QAAQ,EAAE,qBAAqB,EAAE,GAClC;YACF,IAAI,IACD;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;aAAE,GAChF;gBAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;aAAE,CAAC;YACvD,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,CAAC;SACnD,CAAC;KACF,CAAC;IACF,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtD,CAAC;AAiEF,kFAAkF;AAClF,cAAM,2BAA4B,YAAW,cAAc;IAC1D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAEvD,YAAY,OAAO,EAAE,0BAA0B,EAE9C;IAEK,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrC;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9D;IAEK,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAIzF;IAEK,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAM/E;IAED,qDAAqD;IACrD,SAAS,CAAC,KAAK,IAAI,IAAI,CAAG;CAC1B;AAWD;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,2BAA4B,YAAW,cAAc;IACrG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,YAAY,OAAO,EAAE,0BAA0B,EAG9C;IAEQ,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;IAEQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE;IAEQ,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAE5F;IAEQ,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAElF;IAED,qGAAqG;IACrG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWhF;IAED,0FAA0F;IAC1F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;CACD"}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
/** Runs synchronous operations immediately when idle and holds queued calls behind a transaction. */
|
|
2
|
+
class SerialQueue {
|
|
3
|
+
tail = Promise.resolve();
|
|
4
|
+
pending = 0;
|
|
5
|
+
run(operation) {
|
|
6
|
+
if (this.pending > 0)
|
|
7
|
+
return this.enqueue(operation);
|
|
8
|
+
try {
|
|
9
|
+
return Promise.resolve(operation());
|
|
10
|
+
}
|
|
11
|
+
catch (error) {
|
|
12
|
+
return Promise.reject(error);
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
hold(operation) {
|
|
16
|
+
return this.enqueue(operation);
|
|
17
|
+
}
|
|
18
|
+
enqueue(operation) {
|
|
19
|
+
this.pending++;
|
|
20
|
+
const result = this.tail.then(operation).finally(() => {
|
|
21
|
+
this.pending--;
|
|
22
|
+
});
|
|
23
|
+
this.tail = result.then(() => { }, () => { });
|
|
24
|
+
return result;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
const storageQueues = new WeakMap();
|
|
28
|
+
function queueFor(storage) {
|
|
29
|
+
let queue = storageQueues.get(storage);
|
|
30
|
+
if (queue === undefined) {
|
|
31
|
+
queue = new SerialQueue();
|
|
32
|
+
storageQueues.set(storage, queue);
|
|
33
|
+
}
|
|
34
|
+
return queue;
|
|
35
|
+
}
|
|
36
|
+
/** Durable Object SQL binds numbers as doubles: a `bigint` outside the safe integer range would lose precision. */
|
|
37
|
+
function bindValue(value) {
|
|
38
|
+
if (value instanceof Uint8Array)
|
|
39
|
+
return value.slice().buffer;
|
|
40
|
+
if (typeof value !== "bigint")
|
|
41
|
+
return value;
|
|
42
|
+
if (value < BigInt(Number.MIN_SAFE_INTEGER) || value > BigInt(Number.MAX_SAFE_INTEGER)) {
|
|
43
|
+
throw new RangeError(`Durable Object SQL cannot bind ${value} without losing precision`);
|
|
44
|
+
}
|
|
45
|
+
return Number(value);
|
|
46
|
+
}
|
|
47
|
+
const bind = (params) => params.map(bindValue);
|
|
48
|
+
/** A row as returned, with `BLOB` columns converted to `Uint8Array` in place; no other copy is made. */
|
|
49
|
+
function row(row) {
|
|
50
|
+
for (const key in row) {
|
|
51
|
+
const value = row[key];
|
|
52
|
+
if (value instanceof ArrayBuffer)
|
|
53
|
+
row[key] = new Uint8Array(value);
|
|
54
|
+
}
|
|
55
|
+
return row;
|
|
56
|
+
}
|
|
57
|
+
/** Executes SQL through `ctx.storage.sql`, which has no separate prepare step. */
|
|
58
|
+
class DurableObjectSqliteExecutor {
|
|
59
|
+
storage;
|
|
60
|
+
constructor(storage) {
|
|
61
|
+
this.storage = storage;
|
|
62
|
+
}
|
|
63
|
+
async exec(sql) {
|
|
64
|
+
this.check();
|
|
65
|
+
this.storage.sql.exec(sql);
|
|
66
|
+
}
|
|
67
|
+
async run(sql, ...params) {
|
|
68
|
+
this.check();
|
|
69
|
+
this.storage.sql.exec(sql, ...bind(params));
|
|
70
|
+
}
|
|
71
|
+
async get(sql, ...params) {
|
|
72
|
+
this.check();
|
|
73
|
+
const result = this.storage.sql.exec(sql, ...bind(params)).next();
|
|
74
|
+
return result.done ? undefined : row(result.value);
|
|
75
|
+
}
|
|
76
|
+
async all(sql, ...params) {
|
|
77
|
+
this.check();
|
|
78
|
+
return this.storage.sql
|
|
79
|
+
.exec(sql, ...bind(params))
|
|
80
|
+
.toArray()
|
|
81
|
+
.map((value) => row(value));
|
|
82
|
+
}
|
|
83
|
+
/** Throws when this handle may no longer run SQL. */
|
|
84
|
+
check() { }
|
|
85
|
+
}
|
|
86
|
+
/** The handle a transaction callback receives; invalid once the callback settles. */
|
|
87
|
+
class DurableObjectSqliteTransaction extends DurableObjectSqliteExecutor {
|
|
88
|
+
active = true;
|
|
89
|
+
check() {
|
|
90
|
+
if (!this.active)
|
|
91
|
+
throw new Error("SQLite transaction handle is no longer active");
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* `SqliteDatabase` adapter for the SQLite storage of a Cloudflare Durable Object. Adapters given the same storage
|
|
96
|
+
* object share a queue; direct calls to the underlying storage bypass it. Integers are JavaScript numbers; binding a
|
|
97
|
+
* `bigint` outside the safe integer range throws.
|
|
98
|
+
*/
|
|
99
|
+
export class DurableObjectSqliteDatabase extends DurableObjectSqliteExecutor {
|
|
100
|
+
queue;
|
|
101
|
+
constructor(storage) {
|
|
102
|
+
super(storage);
|
|
103
|
+
this.queue = queueFor(storage);
|
|
104
|
+
}
|
|
105
|
+
exec(sql) {
|
|
106
|
+
return this.queue.run(() => super.exec(sql));
|
|
107
|
+
}
|
|
108
|
+
run(sql, ...params) {
|
|
109
|
+
return this.queue.run(() => super.run(sql, ...params));
|
|
110
|
+
}
|
|
111
|
+
get(sql, ...params) {
|
|
112
|
+
return this.queue.run(() => super.get(sql, ...params));
|
|
113
|
+
}
|
|
114
|
+
all(sql, ...params) {
|
|
115
|
+
return this.queue.run(() => super.all(sql, ...params));
|
|
116
|
+
}
|
|
117
|
+
/** `ctx.storage.transaction()` commits when the callback resolves and rolls back when it rejects. */
|
|
118
|
+
transaction(callback) {
|
|
119
|
+
return this.queue.hold(() => this.storage.transaction(async () => {
|
|
120
|
+
const transaction = new DurableObjectSqliteTransaction(this.storage);
|
|
121
|
+
try {
|
|
122
|
+
return await callback(transaction);
|
|
123
|
+
}
|
|
124
|
+
finally {
|
|
125
|
+
transaction.active = false;
|
|
126
|
+
}
|
|
127
|
+
}));
|
|
128
|
+
}
|
|
129
|
+
/** Waits for queued work. The Durable Object owns its storage, so nothing else closes. */
|
|
130
|
+
close() {
|
|
131
|
+
return this.queue.run(() => { });
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
//# sourceMappingURL=cloudflare.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../../src/sqlite/cloudflare.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SqliteDatabase, SqliteExecutor, SqliteValue } from \"./database.ts\";\n\n/** Values a Durable Object SQL binding accepts and returns. */\ntype DurableObjectSqlValue = ArrayBuffer | string | number | null;\n\n/**\n * The parts of a SQLite-backed Durable Object's `ctx.storage` this adapter uses, typed structurally so the package\n * needs no Workers type dependency.\n */\nexport type DurableObjectSqliteStorage = {\n\treadonly sql: {\n\t\texec(\n\t\t\tquery: string,\n\t\t\t...bindings: DurableObjectSqlValue[]\n\t\t): {\n\t\t\tnext():\n\t\t\t\t| { readonly done?: false; readonly value: Record<string, DurableObjectSqlValue> }\n\t\t\t\t| { readonly done: true; readonly value?: undefined };\n\t\t\ttoArray(): Record<string, DurableObjectSqlValue>[];\n\t\t};\n\t};\n\ttransaction<T>(closure: () => Promise<T>): Promise<T>;\n};\n\n/** Runs synchronous operations immediately when idle and holds queued calls behind a transaction. */\nclass SerialQueue {\n\tprivate tail: Promise<void> = Promise.resolve();\n\tprivate pending = 0;\n\n\trun<T>(operation: () => T | Promise<T>): Promise<T> {\n\t\tif (this.pending > 0) return this.enqueue(operation);\n\t\ttry {\n\t\t\treturn Promise.resolve(operation());\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n\n\thold<T>(operation: () => Promise<T>): Promise<T> {\n\t\treturn this.enqueue(operation);\n\t}\n\n\tprivate enqueue<T>(operation: () => T | Promise<T>): Promise<T> {\n\t\tthis.pending++;\n\t\tconst result = this.tail.then(operation).finally(() => {\n\t\t\tthis.pending--;\n\t\t});\n\t\tthis.tail = result.then(\n\t\t\t() => {},\n\t\t\t() => {},\n\t\t);\n\t\treturn result;\n\t}\n}\n\nconst storageQueues = new WeakMap<DurableObjectSqliteStorage, SerialQueue>();\n\nfunction queueFor(storage: DurableObjectSqliteStorage): SerialQueue {\n\tlet queue = storageQueues.get(storage);\n\tif (queue === undefined) {\n\t\tqueue = new SerialQueue();\n\t\tstorageQueues.set(storage, queue);\n\t}\n\treturn queue;\n}\n\n/** Durable Object SQL binds numbers as doubles: a `bigint` outside the safe integer range would lose precision. */\nfunction bindValue(value: SqliteValue): DurableObjectSqlValue {\n\tif (value instanceof Uint8Array) return value.slice().buffer as ArrayBuffer;\n\tif (typeof value !== \"bigint\") return value;\n\tif (value < BigInt(Number.MIN_SAFE_INTEGER) || value > BigInt(Number.MAX_SAFE_INTEGER)) {\n\t\tthrow new RangeError(`Durable Object SQL cannot bind ${value} without losing precision`);\n\t}\n\treturn Number(value);\n}\n\nconst bind = (params: readonly SqliteValue[]): DurableObjectSqlValue[] => params.map(bindValue);\n\n/** A row as returned, with `BLOB` columns converted to `Uint8Array` in place; no other copy is made. */\nfunction row<T>(row: Record<string, DurableObjectSqlValue>): T {\n\tfor (const key in row) {\n\t\tconst value = row[key];\n\t\tif (value instanceof ArrayBuffer) (row as Record<string, unknown>)[key] = new Uint8Array(value);\n\t}\n\treturn row as T;\n}\n\n/** Executes SQL through `ctx.storage.sql`, which has no separate prepare step. */\nclass DurableObjectSqliteExecutor implements SqliteExecutor {\n\tprotected readonly storage: DurableObjectSqliteStorage;\n\n\tconstructor(storage: DurableObjectSqliteStorage) {\n\t\tthis.storage = storage;\n\t}\n\n\tasync exec(sql: string): Promise<void> {\n\t\tthis.check();\n\t\tthis.storage.sql.exec(sql);\n\t}\n\n\tasync run(sql: string, ...params: SqliteValue[]): Promise<void> {\n\t\tthis.check();\n\t\tthis.storage.sql.exec(sql, ...bind(params));\n\t}\n\n\tasync get<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T | undefined> {\n\t\tthis.check();\n\t\tconst result = this.storage.sql.exec(sql, ...bind(params)).next();\n\t\treturn result.done ? undefined : row<T>(result.value);\n\t}\n\n\tasync all<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T[]> {\n\t\tthis.check();\n\t\treturn this.storage.sql\n\t\t\t.exec(sql, ...bind(params))\n\t\t\t.toArray()\n\t\t\t.map((value) => row<T>(value));\n\t}\n\n\t/** Throws when this handle may no longer run SQL. */\n\tprotected check(): void {}\n}\n\n/** The handle a transaction callback receives; invalid once the callback settles. */\nclass DurableObjectSqliteTransaction extends DurableObjectSqliteExecutor {\n\tactive = true;\n\n\tprotected override check(): void {\n\t\tif (!this.active) throw new Error(\"SQLite transaction handle is no longer active\");\n\t}\n}\n\n/**\n * `SqliteDatabase` adapter for the SQLite storage of a Cloudflare Durable Object. Adapters given the same storage\n * object share a queue; direct calls to the underlying storage bypass it. Integers are JavaScript numbers; binding a\n * `bigint` outside the safe integer range throws.\n */\nexport class DurableObjectSqliteDatabase extends DurableObjectSqliteExecutor implements SqliteDatabase {\n\tprivate readonly queue: SerialQueue;\n\n\tconstructor(storage: DurableObjectSqliteStorage) {\n\t\tsuper(storage);\n\t\tthis.queue = queueFor(storage);\n\t}\n\n\toverride exec(sql: string): Promise<void> {\n\t\treturn this.queue.run(() => super.exec(sql));\n\t}\n\n\toverride run(sql: string, ...params: SqliteValue[]): Promise<void> {\n\t\treturn this.queue.run(() => super.run(sql, ...params));\n\t}\n\n\toverride get<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T | undefined> {\n\t\treturn this.queue.run(() => super.get<T>(sql, ...params));\n\t}\n\n\toverride all<T extends object>(sql: string, ...params: SqliteValue[]): Promise<T[]> {\n\t\treturn this.queue.run(() => super.all<T>(sql, ...params));\n\t}\n\n\t/** `ctx.storage.transaction()` commits when the callback resolves and rolls back when it rejects. */\n\ttransaction<T>(callback: (transaction: SqliteExecutor) => Promise<T>): Promise<T> {\n\t\treturn this.queue.hold(() =>\n\t\t\tthis.storage.transaction(async () => {\n\t\t\t\tconst transaction = new DurableObjectSqliteTransaction(this.storage);\n\t\t\t\ttry {\n\t\t\t\t\treturn await callback(transaction);\n\t\t\t\t} finally {\n\t\t\t\t\ttransaction.active = false;\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t}\n\n\t/** Waits for queued work. The Durable Object owns its storage, so nothing else closes. */\n\tclose(): Promise<void> {\n\t\treturn this.queue.run(() => {});\n\t}\n}\n"]}
|