@mostra/protocol 0.0.0-stage → 0.1.0

package/dist/methods/secret/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","names":[],"sources":["../../../src/methods/secret/set.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { SECRET_NAME_PATTERN, SECRET_VALUE_MAX } from \"../../actions.ts\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `secret/set` (INTERFACES §6, D44). */\nexport interface SecretSetParams {\n  /** Letters, digits, `_`, `.` and `-`, starting with a letter or `_`, at most 128 characters. */\n  readonly name: string;\n  /** The value, at most 64 KiB of UTF-8. Never returned by any method. */\n  readonly value: string;\n  /** The artifact the secret belongs to; absent: shared by every artifact of the home. */\n  readonly artifact?: ArtifactRef;\n}\n\n/** Where a secret lives. */\nexport interface SecretEntry {\n  /** The secret's name. */\n  readonly name: string;\n  /** `artifact` for one artifact's secret, `home` for one every artifact shares. */\n  readonly scope: \"artifact\" | \"home\";\n  /** The artifact, for `scope: \"artifact\"`. */\n  readonly artifactId?: string;\n  /** When it was last set. */\n  readonly updatedAt: string;\n}\n\n/** The Zod schema of the `SecretEntry` type. */\nexport const SecretEntry: z.ZodType<SecretEntry> = z\n  .object({\n    name: z.string(),\n    scope: z.enum([\"artifact\", \"home\"]),\n    artifactId: z.string().exactOptional(),\n    updatedAt: z.string(),\n  })\n  .register(wireRegistry, {\n    id: \"SecretEntry\",\n    description: \"A secret's name, scope and when it was set; never its value.\",\n  });\n\n/** The result of `secret/set`: the secret, without its value. */\nexport type SecretSetResult = SecretEntry;\n\nconst params: z.ZodType<SecretSetParams> = z\n  .object({\n    name: z.string().regex(SECRET_NAME_PATTERN),\n    // Characters here; the instance also refuses more than 64 KiB of UTF-8.\n    value: z.string().min(1).max(SECRET_VALUE_MAX),\n    artifact: ArtifactRef.exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"SecretSetParams\",\n    description: \"A secret's name, value and optional artifact scope.\",\n  });\n\n/**\n * `secret/set`: stores a named secret in the home's owner-only store (D44), for one artifact or\n * for every artifact of the home; server code reads it with `secret(name)`. Setting it again\n * replaces the value. Setting is idempotent by nature, so it takes no `requestId`: the ledger\n * never records anything derived from a secret's value.\n */\nexport const secretSetMethod: MethodDefinition<SecretSetParams, SecretSetResult> = defineMethod({\n  method: \"secret/set\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result: SecretEntry,\n});\n"],"mappings":";;;;;;;AA6BA,MAAa,cAAsC,EAChD,OAAO;CACN,MAAM,EAAE,OAAO;CACf,OAAO,EAAE,KAAK,CAAC,YAAY,MAAM,CAAC;CAClC,YAAY,EAAE,OAAO,CAAC,CAAC,cAAc;CACrC,WAAW,EAAE,OAAO;AACtB,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAKH,MAAM,SAAqC,EACxC,OAAO;CACN,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,mBAAmB;CAE1C,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,gBAAgB;CAC7C,UAAU,YAAY,cAAc;AACtC,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;;AAQH,MAAa,kBAAsE,aAAa;CAC9F,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/state/get.d.ts

@@ -0,0 +1,25 @@
+import { ArtifactRef } from "../../artifact.js";
+import { DocumentRevision, FieldState } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/state/get.d.ts
+/** The params of `state/get` (INTERFACES §6, D63). */
+export interface StateGetParams {
+  /** The artifact whose shared state to read. */
+  readonly artifact: ArtifactRef;
+  /** Only these field IDs; absent: every field. */
+  readonly ids?: readonly string[];
+}
+/** The result of `state/get`: the artifact state's revision and its fields by ID. */
+export interface StateGetResult {
+  /** The state's revision; pass it as `baseRevision` to `state/patch` for compare-and-set. */
+  readonly revision: DocumentRevision;
+  /** The fields by ID. */
+  readonly fields: Readonly<Record<string, FieldState>>;
+}
+/**
+ * `state/get`: reads an artifact's shared state (its artifact-scoped fields, D63) with each
+ * field's value, revision and last writer.
+ */
+export declare const stateGetMethod: MethodDefinition<StateGetParams, StateGetResult>;
+//#endregion
+//# sourceMappingURL=get.d.ts.map

package/dist/methods/state/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","names":[],"sources":["../../../src/methods/state/get.ts"],"mappings":";;;;;iBAOiB;;WAEN,UAAU;;WAEV;;;iBAIM;;WAEN,UAAU;;WAEV,QAAQ,SAAS,eAAe;;;;;;qBAkB9B,gBAAgB,iBAAiB,gBAAgB"}

package/dist/methods/state/get.js

@@ -0,0 +1,29 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactRef } from "../../artifact.js";
+import { DocumentRevision, FieldState } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/state/get.ts
+const params = z.object({
+	artifact: ArtifactRef,
+	ids: z.array(z.string().min(1).max(256)).max(1e4).readonly().exactOptional()
+}).register(wireRegistry, { id: "StateGetParams" });
+const result = z.object({
+	revision: DocumentRevision,
+	fields: z.record(z.string(), FieldState)
+}).register(wireRegistry, { id: "StateGetResult" });
+/**
+* `state/get`: reads an artifact's shared state (its artifact-scoped fields, D63) with each
+* field's value, revision and last writer.
+*/
+const stateGetMethod = defineMethod({
+	method: "state/get",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { stateGetMethod };
+
+//# sourceMappingURL=get.js.map

package/dist/methods/state/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","names":[],"sources":["../../../src/methods/state/get.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { DocumentRevision, FieldState } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `state/get` (INTERFACES §6, D63). */\nexport interface StateGetParams {\n  /** The artifact whose shared state to read. */\n  readonly artifact: ArtifactRef;\n  /** Only these field IDs; absent: every field. */\n  readonly ids?: readonly string[];\n}\n\n/** The result of `state/get`: the artifact state's revision and its fields by ID. */\nexport interface StateGetResult {\n  /** The state's revision; pass it as `baseRevision` to `state/patch` for compare-and-set. */\n  readonly revision: DocumentRevision;\n  /** The fields by ID. */\n  readonly fields: Readonly<Record<string, FieldState>>;\n}\n\nconst params: z.ZodType<StateGetParams> = z\n  .object({\n    artifact: ArtifactRef,\n    ids: z.array(z.string().min(1).max(256)).max(10_000).readonly().exactOptional(),\n  })\n  .register(wireRegistry, { id: \"StateGetParams\" });\n\nconst result: z.ZodType<StateGetResult> = z\n  .object({ revision: DocumentRevision, fields: z.record(z.string(), FieldState) })\n  .register(wireRegistry, { id: \"StateGetResult\" });\n\n/**\n * `state/get`: reads an artifact's shared state (its artifact-scoped fields, D63) with each\n * field's value, revision and last writer.\n */\nexport const stateGetMethod: MethodDefinition<StateGetParams, StateGetResult> = defineMethod({\n  method: \"state/get\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;;;AAsBA,MAAM,SAAoC,EACvC,OAAO;CACN,UAAU;CACV,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAM,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;AAChF,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,iBAAiB,CAAC;AAElD,MAAM,SAAoC,EACvC,OAAO;CAAE,UAAU;CAAkB,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU;AAAE,CAAC,CAAC,CAChF,SAAS,cAAc,EAAE,IAAI,iBAAiB,CAAC;;;;;AAMlD,MAAa,iBAAmE,aAAa;CAC3F,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/state/patch.d.ts

@@ -0,0 +1,32 @@
+import { ArtifactRef } from "../../artifact.js";
+import { DocumentRevision, FieldOp, MutationResult } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/state/patch.d.ts
+/** The params of `state/patch` (INTERFACES §6, D63, D106). */
+export interface StatePatchParams {
+  /** The artifact whose shared state to write. */
+  readonly artifact: ArtifactRef;
+  /** The field changes, applied together under one revision. */
+  readonly ops: readonly FieldOp[];
+  /**
+   * The state revision the caller last read. A field changed after it is a conflict and keeps its
+   * value; the other ops apply. Absent: every op applies, whatever changed in between.
+   */
+  readonly baseRevision?: DocumentRevision;
+  /**
+   * The change's ID, the idempotency key of this method (H-03): a retry with the same ID and
+   * contents returns the recorded result.
+   */
+  readonly mutationId: string;
+  /** Who writes: `agent` (the default) or `host`, recorded as each field's last writer. */
+  readonly as?: "agent" | "host";
+}
+/** The result of `state/patch`. */
+export type StatePatchResult = MutationResult;
+/**
+ * `state/patch`: writes an artifact's shared state with compare-and-set and per-field conflicts,
+ * through the same path as viewers' edits (D63). Changes append `state.changed`.
+ */
+export declare const statePatchMethod: MethodDefinition<StatePatchParams, StatePatchResult>;
+//#endregion
+//# sourceMappingURL=patch.d.ts.map

package/dist/methods/state/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","names":[],"sources":["../../../src/methods/state/patch.ts"],"mappings":";;;;;iBAQiB;;WAEN,UAAU;;WAEV,cAAc;;;;;WAKd,eAAe;;;;;WAKf;;WAEA;;;YAIC,mBAAmB;;;;;qBAgBlB,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/state/patch.js

@@ -0,0 +1,29 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { MutationId } from "../../ids.js";
+import { ArtifactRef } from "../../artifact.js";
+import { DocumentRevision, FieldOp, MutationResult } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/state/patch.ts
+const params = z.object({
+	artifact: ArtifactRef,
+	ops: z.array(FieldOp).min(1).max(1e3).readonly(),
+	baseRevision: DocumentRevision.exactOptional(),
+	mutationId: MutationId.schema,
+	as: z.enum(["agent", "host"]).exactOptional()
+}).register(wireRegistry, { id: "StatePatchParams" });
+/**
+* `state/patch`: writes an artifact's shared state with compare-and-set and per-field conflicts,
+* through the same path as viewers' edits (D63). Changes append `state.changed`.
+*/
+const statePatchMethod = defineMethod({
+	method: "state/patch",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result: MutationResult
+});
+//#endregion
+export { statePatchMethod };
+
+//# sourceMappingURL=patch.js.map

package/dist/methods/state/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","names":[],"sources":["../../../src/methods/state/patch.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { MutationId } from \"../../ids.ts\";\nimport { DocumentRevision, FieldOp, MutationResult } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `state/patch` (INTERFACES §6, D63, D106). */\nexport interface StatePatchParams {\n  /** The artifact whose shared state to write. */\n  readonly artifact: ArtifactRef;\n  /** The field changes, applied together under one revision. */\n  readonly ops: readonly FieldOp[];\n  /**\n   * The state revision the caller last read. A field changed after it is a conflict and keeps its\n   * value; the other ops apply. Absent: every op applies, whatever changed in between.\n   */\n  readonly baseRevision?: DocumentRevision;\n  /**\n   * The change's ID, the idempotency key of this method (H-03): a retry with the same ID and\n   * contents returns the recorded result.\n   */\n  readonly mutationId: string;\n  /** Who writes: `agent` (the default) or `host`, recorded as each field's last writer. */\n  readonly as?: \"agent\" | \"host\";\n}\n\n/** The result of `state/patch`. */\nexport type StatePatchResult = MutationResult;\n\nconst params: z.ZodType<StatePatchParams> = z\n  .object({\n    artifact: ArtifactRef,\n    ops: z.array(FieldOp).min(1).max(1000).readonly(),\n    baseRevision: DocumentRevision.exactOptional(),\n    mutationId: MutationId.schema,\n    as: z.enum([\"agent\", \"host\"]).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"StatePatchParams\" });\n\n/**\n * `state/patch`: writes an artifact's shared state with compare-and-set and per-field conflicts,\n * through the same path as viewers' edits (D63). Changes append `state.changed`.\n */\nexport const statePatchMethod: MethodDefinition<StatePatchParams, StatePatchResult> = defineMethod({\n  method: \"state/patch\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result: MutationResult,\n});\n"],"mappings":";;;;;;;AA8BA,MAAM,SAAsC,EACzC,OAAO;CACN,UAAU;CACV,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAI,CAAC,CAAC,SAAS;CAChD,cAAc,iBAAiB,cAAc;CAC7C,YAAY,WAAW;CACvB,IAAI,EAAE,KAAK,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,cAAc;AAC9C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;;;;;AAMpD,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/view/default.d.ts

@@ -0,0 +1,19 @@
+import { ArtifactRef } from "../../artifact.js";
+import { MethodDefinition } from "../../method.js";
+import { CapabilityLink } from "./url.js";
+//#region src/methods/view/default.d.ts
+/** The params of `view/default` (INTERFACES §6, D140). */
+export interface ViewDefaultParams {
+  /** The artifact whose default link to return. */
+  readonly artifact: ArtifactRef;
+}
+/** The result of `view/default`: the artifact's default link (D97 item 3). */
+export type ViewDefaultResult = CapabilityLink;
+/**
+ * `view/default`: the artifact's default link, the one every publish receipt carries (D97 item
+ * 3), without minting a new token. When the default link was revoked, it mints a new default (the
+ * old token stays revoked). `view/url` always mints a separate link.
+ */
+export declare const viewDefaultMethod: MethodDefinition<ViewDefaultParams, ViewDefaultResult>;
+//#endregion
+//# sourceMappingURL=default.d.ts.map

package/dist/methods/view/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","names":[],"sources":["../../../src/methods/view/default.ts"],"mappings":";;;;;iBAOiB;;WAEN,UAAU;;;YAIT,oBAAoB;;;;;;qBAWnB,mBAAmB,iBAAiB,mBAAmB"}

package/dist/methods/view/default.js

@@ -0,0 +1,23 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { ArtifactRef } from "../../artifact.js";
+import { defineMethod } from "../../method.js";
+import { CapabilityLink } from "./url.js";
+import * as z from "zod";
+//#region src/methods/view/default.ts
+const params = z.object({ artifact: ArtifactRef }).register(wireRegistry, { id: "ViewDefaultParams" });
+/**
+* `view/default`: the artifact's default link, the one every publish receipt carries (D97 item
+* 3), without minting a new token. When the default link was revoked, it mints a new default (the
+* old token stays revoked). `view/url` always mints a separate link.
+*/
+const viewDefaultMethod = defineMethod({
+	method: "view/default",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result: CapabilityLink
+});
+//#endregion
+export { viewDefaultMethod };
+
+//# sourceMappingURL=default.js.map

package/dist/methods/view/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","names":[],"sources":["../../../src/methods/view/default.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\nimport { CapabilityLink } from \"./url.ts\";\n\n/** The params of `view/default` (INTERFACES §6, D140). */\nexport interface ViewDefaultParams {\n  /** The artifact whose default link to return. */\n  readonly artifact: ArtifactRef;\n}\n\n/** The result of `view/default`: the artifact's default link (D97 item 3). */\nexport type ViewDefaultResult = CapabilityLink;\n\nconst params: z.ZodType<ViewDefaultParams> = z\n  .object({ artifact: ArtifactRef })\n  .register(wireRegistry, { id: \"ViewDefaultParams\" });\n\n/**\n * `view/default`: the artifact's default link, the one every publish receipt carries (D97 item\n * 3), without minting a new token. When the default link was revoked, it mints a new default (the\n * old token stays revoked). `view/url` always mints a separate link.\n */\nexport const viewDefaultMethod: MethodDefinition<ViewDefaultParams, ViewDefaultResult> =\n  defineMethod({\n    method: \"view/default\",\n    direction: \"client-to-instance\",\n    mutating: true,\n    params,\n    result: CapabilityLink,\n  });\n"],"mappings":";;;;;;AAeA,MAAM,SAAuC,EAC1C,OAAO,EAAE,UAAU,YAAY,CAAC,CAAC,CACjC,SAAS,cAAc,EAAE,IAAI,oBAAoB,CAAC;;;;;;AAOrD,MAAa,oBACX,aAAa;CACX,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/view/launch.d.ts

@@ -0,0 +1,27 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/view/launch.d.ts
+/** The params of `view/launch` (INTERFACES §6, D140 item 15). */
+export interface ViewLaunchParams {
+  /** The link whose session the launch URL opens: a `CapabilityLink.tokenId`. */
+  readonly tokenId: string;
+}
+/** The result of `view/launch`. */
+export interface ViewLaunchResult {
+  /**
+   * `http://<url host>:<shell port>/a/<artifactId>[/v/<number>]#l=<ticket>`: a URL to hand a
+   * browser on its command line. The shell exchanges the single-use ticket for the session the
+   * link would give; the link's secret is never in it.
+   */
+  readonly url: string;
+  /** When the ticket stops working, 60 s after it was minted (RFC 3339, UTC). */
+  readonly expiresAt: string;
+}
+/**
+ * `view/launch`: a one-time launch URL for a link (D140 item 15), so a browser opens it without
+ * the link's secret on a command line other local users can read. The ticket is single-use,
+ * lives 60 s and carries 130 bits, like a frame ticket; it is never recorded, so the method takes
+ * no `requestId`. A revoked or expired link is `MOSTRA_HYGIENE_TOKEN_REVOKED`.
+ */
+export declare const viewLaunchMethod: MethodDefinition<ViewLaunchParams, ViewLaunchResult>;
+//#endregion
+//# sourceMappingURL=launch.d.ts.map

package/dist/methods/view/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","names":[],"sources":["../../../src/methods/view/launch.ts"],"mappings":";;;iBAMiB;;WAEN;;;iBAIM;;;;;;WAMN;;WAEA;;;;;;;;qBAoBE,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/view/launch.js

@@ -0,0 +1,30 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { TokenId } from "../../ids.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/view/launch.ts
+const params = z.object({ tokenId: TokenId.schema }).register(wireRegistry, { id: "ViewLaunchParams" });
+const result = z.object({
+	url: z.string().min(1),
+	expiresAt: z.iso.datetime()
+}).register(wireRegistry, {
+	id: "ViewLaunchResult",
+	description: "A one-time launch URL for a browser."
+});
+/**
+* `view/launch`: a one-time launch URL for a link (D140 item 15), so a browser opens it without
+* the link's secret on a command line other local users can read. The ticket is single-use,
+* lives 60 s and carries 130 bits, like a frame ticket; it is never recorded, so the method takes
+* no `requestId`. A revoked or expired link is `MOSTRA_HYGIENE_TOKEN_REVOKED`.
+*/
+const viewLaunchMethod = defineMethod({
+	method: "view/launch",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { viewLaunchMethod };
+
+//# sourceMappingURL=launch.js.map

package/dist/methods/view/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","names":[],"sources":["../../../src/methods/view/launch.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { TokenId } from \"../../ids.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `view/launch` (INTERFACES §6, D140 item 15). */\nexport interface ViewLaunchParams {\n  /** The link whose session the launch URL opens: a `CapabilityLink.tokenId`. */\n  readonly tokenId: string;\n}\n\n/** The result of `view/launch`. */\nexport interface ViewLaunchResult {\n  /**\n   * `http://<url host>:<shell port>/a/<artifactId>[/v/<number>]#l=<ticket>`: a URL to hand a\n   * browser on its command line. The shell exchanges the single-use ticket for the session the\n   * link would give; the link's secret is never in it.\n   */\n  readonly url: string;\n  /** When the ticket stops working, 60 s after it was minted (RFC 3339, UTC). */\n  readonly expiresAt: string;\n}\n\nconst params: z.ZodType<ViewLaunchParams> = z\n  .object({ tokenId: TokenId.schema })\n  .register(wireRegistry, { id: \"ViewLaunchParams\" });\n\nconst result: z.ZodType<ViewLaunchResult> = z\n  .object({ url: z.string().min(1), expiresAt: z.iso.datetime() })\n  .register(wireRegistry, {\n    id: \"ViewLaunchResult\",\n    description: \"A one-time launch URL for a browser.\",\n  });\n\n/**\n * `view/launch`: a one-time launch URL for a link (D140 item 15), so a browser opens it without\n * the link's secret on a command line other local users can read. The ticket is single-use,\n * lives 60 s and carries 130 bits, like a frame ticket; it is never recorded, so the method takes\n * no `requestId`. A revoked or expired link is `MOSTRA_HYGIENE_TOKEN_REVOKED`.\n */\nexport const viewLaunchMethod: MethodDefinition<ViewLaunchParams, ViewLaunchResult> = defineMethod({\n  method: \"view/launch\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;AAuBA,MAAM,SAAsC,EACzC,OAAO,EAAE,SAAS,QAAQ,OAAO,CAAC,CAAC,CACnC,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;AAEpD,MAAM,SAAsC,EACzC,OAAO;CAAE,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CAAG,WAAW,EAAE,IAAI,SAAS;AAAE,CAAC,CAAC,CAC/D,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;;;;;;;AAQH,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/view/revoke.d.ts

@@ -0,0 +1,19 @@
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/view/revoke.d.ts
+/** The params of `view/revoke` (INTERFACES §6, D97). */
+export interface ViewRevokeParams {
+  /** The token whose link stops working. */
+  readonly tokenId: string;
+  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */
+  readonly requestId?: string;
+}
+/** The result of `view/revoke`. */
+export type ViewRevokeResult = Record<string, never>;
+/**
+ * `view/revoke`: ends a capability link and every session opened with it; both answer 410 from
+ * then on (HY-03). Revoking a revoked token succeeds; an unknown token is
+ * `MOSTRA_HYGIENE_TOKEN_INVALID`.
+ */
+export declare const viewRevokeMethod: MethodDefinition<ViewRevokeParams, ViewRevokeResult>;
+//#endregion
+//# sourceMappingURL=revoke.d.ts.map

package/dist/methods/view/revoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revoke.d.ts","names":[],"sources":["../../../src/methods/view/revoke.ts"],"mappings":";;;iBAMiB;;WAEN;;WAEA;;;YAIC,mBAAmB;;;;;;qBAkBlB,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/view/revoke.js

@@ -0,0 +1,26 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { TokenId } from "../../ids.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/view/revoke.ts
+const params = z.object({
+	tokenId: TokenId.schema,
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "ViewRevokeParams" });
+const result = z.object({}).register(wireRegistry, { id: "ViewRevokeResult" });
+/**
+* `view/revoke`: ends a capability link and every session opened with it; both answer 410 from
+* then on (HY-03). Revoking a revoked token succeeds; an unknown token is
+* `MOSTRA_HYGIENE_TOKEN_INVALID`.
+*/
+const viewRevokeMethod = defineMethod({
+	method: "view/revoke",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result
+});
+//#endregion
+export { viewRevokeMethod };
+
+//# sourceMappingURL=revoke.js.map

package/dist/methods/view/revoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revoke.js","names":[],"sources":["../../../src/methods/view/revoke.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { TokenId } from \"../../ids.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `view/revoke` (INTERFACES §6, D97). */\nexport interface ViewRevokeParams {\n  /** The token whose link stops working. */\n  readonly tokenId: string;\n  /** Makes retries idempotent: a repeated `requestId` returns the recorded result (H-03). */\n  readonly requestId?: string;\n}\n\n/** The result of `view/revoke`. */\nexport type ViewRevokeResult = Record<string, never>;\n\nconst params: z.ZodType<ViewRevokeParams> = z\n  .object({\n    tokenId: TokenId.schema,\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ViewRevokeParams\" });\n\nconst result: z.ZodType<ViewRevokeResult> = z\n  .object({})\n  .register(wireRegistry, { id: \"ViewRevokeResult\" });\n\n/**\n * `view/revoke`: ends a capability link and every session opened with it; both answer 410 from\n * then on (HY-03). Revoking a revoked token succeeds; an unknown token is\n * `MOSTRA_HYGIENE_TOKEN_INVALID`.\n */\nexport const viewRevokeMethod: MethodDefinition<ViewRevokeParams, ViewRevokeResult> = defineMethod({\n  method: \"view/revoke\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result,\n});\n"],"mappings":";;;;;AAgBA,MAAM,SAAsC,EACzC,OAAO;CACN,SAAS,QAAQ;CACjB,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;AAEpD,MAAM,SAAsC,EACzC,OAAO,CAAC,CAAC,CAAC,CACV,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;;;;;;AAOpD,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}

package/dist/methods/view/rotate.d.ts

@@ -0,0 +1,21 @@
+import { MethodDefinition } from "../../method.js";
+import { CapabilityLink } from "./url.js";
+//#region src/methods/view/rotate.d.ts
+/** The params of `view/rotate` (D97). */
+export interface ViewRotateParams {
+  /** The token to replace. */
+  readonly tokenId: string;
+  /** Makes retries idempotent: a repeated `requestId` returns the same new link (H-03). */
+  readonly requestId?: string;
+}
+/** The result of `view/rotate`: the new link. */
+export type ViewRotateResult = CapabilityLink;
+/**
+ * `view/rotate`: replaces a capability link in one step. The new link has the same artifact,
+ * scopes and expiry; the old one and its sessions answer 410 from then on. Rotating the artifact's
+ * default link makes the new one its default. A revoked or expired token can't be rotated
+ * (`MOSTRA_HYGIENE_TOKEN_REVOKED`).
+ */
+export declare const viewRotateMethod: MethodDefinition<ViewRotateParams, ViewRotateResult>;
+//#endregion
+//# sourceMappingURL=rotate.d.ts.map

package/dist/methods/view/rotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate.d.ts","names":[],"sources":["../../../src/methods/view/rotate.ts"],"mappings":";;;;iBAOiB;;WAEN;;WAEA;;;YAIC,mBAAmB;;;;;;;qBAelB,kBAAkB,iBAAiB,kBAAkB"}

package/dist/methods/view/rotate.js

@@ -0,0 +1,27 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { TokenId } from "../../ids.js";
+import { defineMethod } from "../../method.js";
+import { CapabilityLink } from "./url.js";
+import * as z from "zod";
+//#region src/methods/view/rotate.ts
+const params = z.object({
+	tokenId: TokenId.schema,
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "ViewRotateParams" });
+/**
+* `view/rotate`: replaces a capability link in one step. The new link has the same artifact,
+* scopes and expiry; the old one and its sessions answer 410 from then on. Rotating the artifact's
+* default link makes the new one its default. A revoked or expired token can't be rotated
+* (`MOSTRA_HYGIENE_TOKEN_REVOKED`).
+*/
+const viewRotateMethod = defineMethod({
+	method: "view/rotate",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result: CapabilityLink
+});
+//#endregion
+export { viewRotateMethod };
+
+//# sourceMappingURL=rotate.js.map

package/dist/methods/view/rotate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotate.js","names":[],"sources":["../../../src/methods/view/rotate.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { TokenId } from \"../../ids.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\nimport { CapabilityLink } from \"./url.ts\";\n\n/** The params of `view/rotate` (D97). */\nexport interface ViewRotateParams {\n  /** The token to replace. */\n  readonly tokenId: string;\n  /** Makes retries idempotent: a repeated `requestId` returns the same new link (H-03). */\n  readonly requestId?: string;\n}\n\n/** The result of `view/rotate`: the new link. */\nexport type ViewRotateResult = CapabilityLink;\n\nconst params: z.ZodType<ViewRotateParams> = z\n  .object({\n    tokenId: TokenId.schema,\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ViewRotateParams\" });\n\n/**\n * `view/rotate`: replaces a capability link in one step. The new link has the same artifact,\n * scopes and expiry; the old one and its sessions answer 410 from then on. Rotating the artifact's\n * default link makes the new one its default. A revoked or expired token can't be rotated\n * (`MOSTRA_HYGIENE_TOKEN_REVOKED`).\n */\nexport const viewRotateMethod: MethodDefinition<ViewRotateParams, ViewRotateResult> = defineMethod({\n  method: \"view/rotate\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result: CapabilityLink,\n});\n"],"mappings":";;;;;;AAiBA,MAAM,SAAsC,EACzC,OAAO;CACN,SAAS,QAAQ;CACjB,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,mBAAmB,CAAC;;;;;;;AAQpD,MAAa,mBAAyE,aAAa;CACjG,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/view/url.d.ts

@@ -0,0 +1,52 @@
+import { ArtifactRef } from "../../artifact.js";
+import { Viewer, ViewerSpec } from "../../interaction.js";
+import { CapabilityScope, Duration } from "../../capability.js";
+import { MethodDefinition } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/view/url.d.ts
+/** The params of `view/url` (INTERFACES §6, D97). */
+export interface ViewUrlParams {
+  /** The artifact the link opens. */
+  readonly artifact: ArtifactRef;
+  /**
+   * The version the link opens, by number or ID. Without it the link opens the artifact's latest
+   * version whenever it is used.
+   */
+  readonly version?: number | string;
+  /** What the link allows (D97). Default: every scope. `view` is always included. */
+  readonly scopes?: readonly CapabilityScope[];
+  /** How long the link works, such as `24h` or `7d`. Default: until it is revoked (D63). */
+  readonly ttl?: Duration;
+  /**
+   * The person the link acts for (D104): its sessions draft, submit and sign as that viewer, so
+   * `once` per-viewer gives each person one submission. Absent: the home's local user.
+   */
+  readonly viewer?: ViewerSpec;
+  /** Makes retries idempotent: a repeated `requestId` returns the same link (H-03). */
+  readonly requestId?: string;
+}
+/** A capability link: what `view/url` and `view/rotate` return. */
+export interface CapabilityLink {
+  /** The capability URL. Holding it is the authorization (D06); share it like a password. */
+  readonly url: string;
+  /** The token's ID, for `view/rotate` and `view/revoke`. Never a secret. */
+  readonly tokenId: string;
+  /** The scopes the link carries, `view` included. */
+  readonly scopes: readonly CapabilityScope[];
+  /** When the link stops working; absent when it works until revoked. */
+  readonly expiresAt?: string;
+  /** The viewer the link acts for, when it was minted with one (D104). */
+  readonly viewer?: Viewer;
+}
+/** The result of `view/url`. */
+export type ViewUrlResult = CapabilityLink;
+/** The Zod schema of the `CapabilityLink` type. */
+export declare const CapabilityLink: z.ZodType<CapabilityLink>;
+/**
+ * `view/url`: mints a new capability link to an artifact, with the scopes and lifetime asked for.
+ * Each call mints a separate token that `view/revoke` ends on its own; the artifact's default link
+ * is the publish receipt's `url`.
+ */
+export declare const viewUrlMethod: MethodDefinition<ViewUrlParams, ViewUrlResult>;
+//#endregion
+//# sourceMappingURL=url.d.ts.map

package/dist/methods/view/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","names":[],"sources":["../../../src/methods/view/url.ts"],"mappings":";;;;;;;iBASiB;;WAEN,UAAU;;;;;WAKV;;WAEA,kBAAkB;;WAElB,MAAM;;;;;WAKN,SAAS;;WAET;;;iBAIM;;WAEN;;WAEA;;WAEA,iBAAiB;;WAEjB;;WAEA,SAAS;;;YAIR,gBAAgB;;qBAGf,gBAAgB,EAAE,QAAQ;;;;;;qBA6B1B,eAAe,iBAAiB,eAAe"}

package/dist/methods/view/url.js

@@ -0,0 +1,43 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { TokenId, VersionId } from "../../ids.js";
+import { ArtifactRef } from "../../artifact.js";
+import { Viewer, ViewerSpec } from "../../interaction.js";
+import { CapabilityScope, Duration } from "../../capability.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/view/url.ts
+/** The Zod schema of the `CapabilityLink` type. */
+const CapabilityLink = z.object({
+	url: z.string().min(1),
+	tokenId: TokenId.schema,
+	scopes: z.array(CapabilityScope).readonly(),
+	expiresAt: z.iso.datetime().exactOptional(),
+	viewer: Viewer.exactOptional()
+}).register(wireRegistry, {
+	id: "CapabilityLink",
+	description: "A capability URL with its token ID, scopes and expiry."
+});
+const params = z.object({
+	artifact: ArtifactRef,
+	version: z.union([z.int().min(1), VersionId.schema]).exactOptional(),
+	scopes: z.array(CapabilityScope).min(1).readonly().exactOptional(),
+	ttl: Duration.exactOptional(),
+	viewer: ViewerSpec.exactOptional(),
+	requestId: z.string().min(1).exactOptional()
+}).register(wireRegistry, { id: "ViewUrlParams" });
+/**
+* `view/url`: mints a new capability link to an artifact, with the scopes and lifetime asked for.
+* Each call mints a separate token that `view/revoke` ends on its own; the artifact's default link
+* is the publish receipt's `url`.
+*/
+const viewUrlMethod = defineMethod({
+	method: "view/url",
+	direction: "client-to-instance",
+	mutating: true,
+	params,
+	result: CapabilityLink
+});
+//#endregion
+export { CapabilityLink, viewUrlMethod };
+
+//# sourceMappingURL=url.js.map

package/dist/methods/view/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","names":[],"sources":["../../../src/methods/view/url.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { CapabilityScope, Duration } from \"../../capability.ts\";\nimport { TokenId, VersionId } from \"../../ids.ts\";\nimport { Viewer, ViewerSpec } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The params of `view/url` (INTERFACES §6, D97). */\nexport interface ViewUrlParams {\n  /** The artifact the link opens. */\n  readonly artifact: ArtifactRef;\n  /**\n   * The version the link opens, by number or ID. Without it the link opens the artifact's latest\n   * version whenever it is used.\n   */\n  readonly version?: number | string;\n  /** What the link allows (D97). Default: every scope. `view` is always included. */\n  readonly scopes?: readonly CapabilityScope[];\n  /** How long the link works, such as `24h` or `7d`. Default: until it is revoked (D63). */\n  readonly ttl?: Duration;\n  /**\n   * The person the link acts for (D104): its sessions draft, submit and sign as that viewer, so\n   * `once` per-viewer gives each person one submission. Absent: the home's local user.\n   */\n  readonly viewer?: ViewerSpec;\n  /** Makes retries idempotent: a repeated `requestId` returns the same link (H-03). */\n  readonly requestId?: string;\n}\n\n/** A capability link: what `view/url` and `view/rotate` return. */\nexport interface CapabilityLink {\n  /** The capability URL. Holding it is the authorization (D06); share it like a password. */\n  readonly url: string;\n  /** The token's ID, for `view/rotate` and `view/revoke`. Never a secret. */\n  readonly tokenId: string;\n  /** The scopes the link carries, `view` included. */\n  readonly scopes: readonly CapabilityScope[];\n  /** When the link stops working; absent when it works until revoked. */\n  readonly expiresAt?: string;\n  /** The viewer the link acts for, when it was minted with one (D104). */\n  readonly viewer?: Viewer;\n}\n\n/** The result of `view/url`. */\nexport type ViewUrlResult = CapabilityLink;\n\n/** The Zod schema of the `CapabilityLink` type. */\nexport const CapabilityLink: z.ZodType<CapabilityLink> = z\n  .object({\n    url: z.string().min(1),\n    tokenId: TokenId.schema,\n    scopes: z.array(CapabilityScope).readonly(),\n    expiresAt: z.iso.datetime().exactOptional(),\n    viewer: Viewer.exactOptional(),\n  })\n  .register(wireRegistry, {\n    id: \"CapabilityLink\",\n    description: \"A capability URL with its token ID, scopes and expiry.\",\n  });\n\nconst params: z.ZodType<ViewUrlParams> = z\n  .object({\n    artifact: ArtifactRef,\n    version: z.union([z.int().min(1), VersionId.schema]).exactOptional(),\n    scopes: z.array(CapabilityScope).min(1).readonly().exactOptional(),\n    ttl: Duration.exactOptional(),\n    viewer: ViewerSpec.exactOptional(),\n    requestId: z.string().min(1).exactOptional(),\n  })\n  .register(wireRegistry, { id: \"ViewUrlParams\" });\n\n/**\n * `view/url`: mints a new capability link to an artifact, with the scopes and lifetime asked for.\n * Each call mints a separate token that `view/revoke` ends on its own; the artifact's default link\n * is the publish receipt's `url`.\n */\nexport const viewUrlMethod: MethodDefinition<ViewUrlParams, ViewUrlResult> = defineMethod({\n  method: \"view/url\",\n  direction: \"client-to-instance\",\n  mutating: true,\n  params,\n  result: CapabilityLink,\n});\n"],"mappings":";;;;;;;;;AAgDA,MAAa,iBAA4C,EACtD,OAAO;CACN,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACrB,SAAS,QAAQ;CACjB,QAAQ,EAAE,MAAM,eAAe,CAAC,CAAC,SAAS;CAC1C,WAAW,EAAE,IAAI,SAAS,CAAC,CAAC,cAAc;CAC1C,QAAQ,OAAO,cAAc;AAC/B,CAAC,CAAC,CACD,SAAS,cAAc;CACtB,IAAI;CACJ,aAAa;AACf,CAAC;AAEH,MAAM,SAAmC,EACtC,OAAO;CACN,UAAU;CACV,SAAS,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC,CAAC,cAAc;CACnE,QAAQ,EAAE,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,cAAc;CACjE,KAAK,SAAS,cAAc;CAC5B,QAAQ,WAAW,cAAc;CACjC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;AAC7C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,gBAAgB,CAAC;;;;;;AAOjD,MAAa,gBAAgE,aAAa;CACxF,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA,QAAQ;AACV,CAAC"}

package/dist/methods/wait/wait.d.ts

@@ -0,0 +1,37 @@
+import { ArtifactRef } from "../../artifact.js";
+import { EventRecord, WaitCondition } from "../../interaction.js";
+import { MethodDefinition } from "../../method.js";
+//#region src/methods/wait/wait.d.ts
+/** The longest `wait`, in milliseconds: the longest timer JavaScript keeps (about 24.8 days). */
+export declare const WAIT_MAX_MS = 2147483647;
+/** The params of `wait` (INTERFACES §6, ARCHITECTURE §6, D103). */
+export interface WaitParams {
+  /** The artifact to wait on. */
+  readonly artifact: ArtifactRef;
+  /** `submitted`, `signal:<name>`, `state:<fieldId>` or `event:<type>`. */
+  readonly until: WaitCondition;
+  /**
+   * Wait for what happens after this cursor (edge-triggered conditions, and `submitted` under
+   * `epochs`). Default: the cursor of the artifact's latest publish.
+   */
+  readonly after?: string;
+  /** How long to block, in milliseconds; 0 checks once. */
+  readonly timeoutMs: number;
+}
+/** The result of `wait`. */
+export type WaitResult = {
+  readonly status: "satisfied";
+  readonly event: EventRecord;
+  readonly cursor: string;
+} | {
+  readonly status: "still_waiting";
+  readonly cursor: string;
+};
+/**
+ * `wait`: blocks until a condition holds or the timeout passes (IN-10). `satisfied` carries the
+ * event that met it; `still_waiting` carries the newest cursor examined, so a later wait from it
+ * misses nothing.
+ */
+export declare const waitMethod: MethodDefinition<WaitParams, WaitResult>;
+//#endregion
+//# sourceMappingURL=wait.d.ts.map

package/dist/methods/wait/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","names":[],"sources":["../../../src/methods/wait/wait.ts"],"mappings":";;;;;qBAQa;;iBAGI;;WAEN,UAAU;;WAEV,OAAO;;;;;WAKP;;WAEA;;;YAIC;WACG;WAA8B,OAAO;WAAsB;;WAC3D;WAAkC;;;;;;;qBAuBpC,YAAY,iBAAiB,YAAY"}

package/dist/methods/wait/wait.js

@@ -0,0 +1,39 @@
+import { wireRegistry } from "../../wire-registry.js";
+import { Cursor } from "../../ids.js";
+import { ArtifactRef } from "../../artifact.js";
+import { EventRecord, WaitCondition } from "../../interaction.js";
+import { defineMethod } from "../../method.js";
+import * as z from "zod";
+//#region src/methods/wait/wait.ts
+/** The longest `wait`, in milliseconds: the longest timer JavaScript keeps (about 24.8 days). */
+const WAIT_MAX_MS = 2147483647;
+const params = z.object({
+	artifact: ArtifactRef,
+	until: WaitCondition,
+	after: Cursor.schema.exactOptional(),
+	timeoutMs: z.int().min(0).max(WAIT_MAX_MS)
+}).register(wireRegistry, { id: "WaitParams" });
+const result = z.discriminatedUnion("status", [z.object({
+	status: z.literal("satisfied"),
+	event: EventRecord,
+	cursor: Cursor.schema
+}), z.object({
+	status: z.literal("still_waiting"),
+	cursor: Cursor.schema
+})]).register(wireRegistry, { id: "WaitResult" });
+/**
+* `wait`: blocks until a condition holds or the timeout passes (IN-10). `satisfied` carries the
+* event that met it; `still_waiting` carries the newest cursor examined, so a later wait from it
+* misses nothing.
+*/
+const waitMethod = defineMethod({
+	method: "wait",
+	direction: "client-to-instance",
+	mutating: false,
+	params,
+	result
+});
+//#endregion
+export { WAIT_MAX_MS, waitMethod };
+
+//# sourceMappingURL=wait.js.map

package/dist/methods/wait/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","names":[],"sources":["../../../src/methods/wait/wait.ts"],"sourcesContent":["import * as z from \"zod\";\nimport { ArtifactRef } from \"../../artifact.ts\";\nimport { Cursor } from \"../../ids.ts\";\nimport { EventRecord, WaitCondition } from \"../../interaction.ts\";\nimport { defineMethod, type MethodDefinition } from \"../../method.ts\";\nimport { wireRegistry } from \"../../wire-registry.ts\";\n\n/** The longest `wait`, in milliseconds: the longest timer JavaScript keeps (about 24.8 days). */\nexport const WAIT_MAX_MS = 2_147_483_647;\n\n/** The params of `wait` (INTERFACES §6, ARCHITECTURE §6, D103). */\nexport interface WaitParams {\n  /** The artifact to wait on. */\n  readonly artifact: ArtifactRef;\n  /** `submitted`, `signal:<name>`, `state:<fieldId>` or `event:<type>`. */\n  readonly until: WaitCondition;\n  /**\n   * Wait for what happens after this cursor (edge-triggered conditions, and `submitted` under\n   * `epochs`). Default: the cursor of the artifact's latest publish.\n   */\n  readonly after?: string;\n  /** How long to block, in milliseconds; 0 checks once. */\n  readonly timeoutMs: number;\n}\n\n/** The result of `wait`. */\nexport type WaitResult =\n  | { readonly status: \"satisfied\"; readonly event: EventRecord; readonly cursor: string }\n  | { readonly status: \"still_waiting\"; readonly cursor: string };\n\nconst params: z.ZodType<WaitParams> = z\n  .object({\n    artifact: ArtifactRef,\n    until: WaitCondition,\n    after: Cursor.schema.exactOptional(),\n    timeoutMs: z.int().min(0).max(WAIT_MAX_MS),\n  })\n  .register(wireRegistry, { id: \"WaitParams\" });\n\nconst result: z.ZodType<WaitResult> = z\n  .discriminatedUnion(\"status\", [\n    z.object({ status: z.literal(\"satisfied\"), event: EventRecord, cursor: Cursor.schema }),\n    z.object({ status: z.literal(\"still_waiting\"), cursor: Cursor.schema }),\n  ])\n  .register(wireRegistry, { id: \"WaitResult\" });\n\n/**\n * `wait`: blocks until a condition holds or the timeout passes (IN-10). `satisfied` carries the\n * event that met it; `still_waiting` carries the newest cursor examined, so a later wait from it\n * misses nothing.\n */\nexport const waitMethod: MethodDefinition<WaitParams, WaitResult> = defineMethod({\n  method: \"wait\",\n  direction: \"client-to-instance\",\n  mutating: false,\n  params,\n  result,\n});\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAc;AAsB3B,MAAM,SAAgC,EACnC,OAAO;CACN,UAAU;CACV,OAAO;CACP,OAAO,OAAO,OAAO,cAAc;CACnC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,WAAW;AAC3C,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,aAAa,CAAC;AAE9C,MAAM,SAAgC,EACnC,mBAAmB,UAAU,CAC5B,EAAE,OAAO;CAAE,QAAQ,EAAE,QAAQ,WAAW;CAAG,OAAO;CAAa,QAAQ,OAAO;AAAO,CAAC,GACtF,EAAE,OAAO;CAAE,QAAQ,EAAE,QAAQ,eAAe;CAAG,QAAQ,OAAO;AAAO,CAAC,CACxE,CAAC,CAAC,CACD,SAAS,cAAc,EAAE,IAAI,aAAa,CAAC;;;;;;AAO9C,MAAa,aAAuD,aAAa;CAC/E,QAAQ;CACR,WAAW;CACX,UAAU;CACV;CACA;AACF,CAAC"}