@econ-v1/rpc 6.6.0 → 6.10.0

package/dist/stage-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-context.d.ts","sourceRoot":"","sources":["../src/stage-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEzF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE;QACf,OAAO,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3F,SAAS,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;KAC7G,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;KACnB,CAAC;IACF,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IACpG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC"}
+{"version":3,"file":"stage-context.d.ts","sourceRoot":"","sources":["../src/stage-context.js"],"names":[],"mappings":"8BAEc,OAAO,iBAAiB,EAAE,eAAe;wBACzC,OAAO,iBAAiB,EAAE,SAAS;0BACnC,OAAO,aAAa,EAAE,WAAW;2BACjC,OAAO,sBAAsB,EAAE,YAAY;iCAC3C,OAAO,6BAA6B,EAAE,kBAAkB;2BACxD;IAAE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;+BAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC;iCACzD;IACb,QAAY,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAY,CAAC,MAAM,EAAE;QACf,OAAO,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACrH,SAAS,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAA;KACtI,CAAC;IACF,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW,CAAC;IAC9H,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,QAAY,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAC3C;8BACU;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE;6BACxD,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE;6BAC/E,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE;2BAC3J,cAAc,GAAG,cAAc;0BAC/B;IAAE,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE"}

package/dist/sync-cursors-contract.d.ts

@@ -0,0 +1,6 @@
+export const SYNC_CURSORS_QUERY: "sync.cursors.v1";
+export type SyncCursorView = {
+    readonly domain: string;
+    readonly updatedAt: string;
+};
+//# sourceMappingURL=sync-cursors-contract.d.ts.map

package/dist/sync-cursors-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cursors-contract.d.ts","sourceRoot":"","sources":["../src/sync-cursors-contract.js"],"names":[],"mappings":"AACA,iCAAkC,iBAAiB,CAAC;6BACtC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE"}

package/dist/system-notice-contract.d.ts

@@ -0,0 +1,70 @@
+export type SystemNoticeSeverity = "error" | "info" | "security" | "success" | "warning";
+export type SystemNoticeActionKind = "primary" | "secondary";
+export type SystemNoticeBlockScope = "shell" | "stage";
+export type SystemNoticeState = "busy" | "failed" | "idle" | "resolved";
+export type SystemNotice = SystemNoticeInput;
+export type SystemNoticeListener = (notices: readonly SystemNotice[]) => void;
+export type SystemNoticeAction = {
+    /**
+     * Stable action identity, rendered as `data-action` on the button.
+     * `kind` only says how an action LOOKS ("primary"/"secondary"), so two actions of the same
+     * kind on one notice are otherwise distinguishable only by slot position — publishers that
+     * need to style or target one specific action set an `id` instead of relying on order.
+     */
+    id?: string;
+    kind: SystemNoticeActionKind;
+    label: string;
+    onSelect: () => void | Promise<void>;
+};
+export type SystemNoticeDetail = {
+    readonly label: string;
+    readonly value: string;
+};
+export type SystemNoticeDisclosure = {
+    readonly body: string;
+    readonly summary: string;
+};
+export type SystemNoticeBody = {
+    readonly details?: readonly SystemNoticeDetail[];
+    readonly disclosure?: SystemNoticeDisclosure;
+    readonly steps?: readonly string[];
+};
+export type SystemNoticeInput = {
+    actions?: readonly SystemNoticeAction[];
+    blocking?: SystemNoticeBlockScope;
+    body?: SystemNoticeBody;
+    dismissible: boolean;
+    id: string;
+    message: string;
+    persistent: boolean;
+    priority?: number;
+    severity: SystemNoticeSeverity;
+    source: string;
+    state?: SystemNoticeState;
+    title: string;
+};
+export type SystemNoticePatch = {
+    actions?: readonly SystemNoticeAction[] | undefined;
+    blocking?: SystemNoticeBlockScope | undefined;
+    body?: SystemNoticeBody | undefined;
+    dismissible?: boolean | undefined;
+    message?: string | undefined;
+    persistent?: boolean | undefined;
+    priority?: number | undefined;
+    severity?: SystemNoticeSeverity | undefined;
+    source?: string | undefined;
+    state?: SystemNoticeState | undefined;
+    title?: string | undefined;
+};
+export type SystemNoticeHandle = {
+    dismiss: () => void;
+    update: (patch: SystemNoticePatch) => void;
+};
+export type SystemNoticeCenter = {
+    dismiss: (id: string) => void;
+    getAll: () => readonly SystemNotice[];
+    publish: (input: SystemNoticeInput) => SystemNoticeHandle;
+    subscribe: (listener: SystemNoticeListener) => () => void;
+    update: (id: string, patch: SystemNoticePatch) => void;
+};
+//# sourceMappingURL=system-notice-contract.d.ts.map

package/dist/system-notice-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-notice-contract.d.ts","sourceRoot":"","sources":["../src/system-notice-contract.js"],"names":[],"mappings":"mCAGc,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS;qCACrD,SAAS,GAAG,WAAW;qCACvB,OAAO,GAAG,OAAO;gCACjB,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU;2BACvC,iBAAiB;mCACjB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,KAAK,IAAI;;;;;;;;SAG1C,MAAM;UAIN,sBAAsB;WACtB,MAAM;cACN,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;;iCAE1B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE;qCAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;+BACnD;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;;cAGtI,SAAS,kBAAkB,EAAE;eAC7B,sBAAsB;WACtB,gBAAgB;iBAChB,OAAO;QACP,MAAM;aACN,MAAM;gBACN,OAAO;eACP,MAAM;cACN,oBAAoB;YACpB,MAAM;YACN,iBAAiB;WACjB,MAAM;;;cAIN,SAAS,kBAAkB,EAAE,GAAG,SAAS;eACzC,sBAAsB,GAAG,SAAS;WAClC,gBAAgB,GAAG,SAAS;kBAC5B,OAAO,GAAG,SAAS;cACnB,MAAM,GAAG,SAAS;iBAClB,OAAO,GAAG,SAAS;eACnB,MAAM,GAAG,SAAS;eAClB,oBAAoB,GAAG,SAAS;aAChC,MAAM,GAAG,SAAS;YAClB,iBAAiB,GAAG,SAAS;YAC7B,MAAM,GAAG,SAAS;;;aAIlB,MAAM,IAAI;YACV,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;;;aAIlC,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;YACpB,MAAM,SAAS,YAAY,EAAE;aAC7B,CAAC,KAAK,EAAE,iBAAiB,KAAK,kBAAkB;eAChD,CAAC,QAAQ,EAAE,oBAAoB,KAAK,MAAM,IAAI;YAC9C,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI"}

package/dist/transport-contract.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Query names for the kernel's transport state.
+ *
+ * `v1` is a compatibility shim: it collapses the transitional `connecting` and
+ * `reconnecting` states down to plain `offline` so pre-state-machine consumers
+ * keep seeing the binary connected/offline world they were written against.
+ * `v2` serves the state verbatim. Delete `v1` with its last consumer.
+ */
+export const TRANSPORT_STATE_QUERY: "transport.state.v1";
+export const TRANSPORT_STATE_QUERY_V2: "transport.state.v2";
+//# sourceMappingURL=transport-contract.d.ts.map

package/dist/transport-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-contract.d.ts","sourceRoot":"","sources":["../src/transport-contract.js"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,oCAA2D,oBAAoB,CAAE;AACjF,uCAA8D,oBAAoB,CAAE"}

package/dist/transport.d.ts

@@ -1,9 +1,9 @@
 export type RpcTransportState = "closed" | "open";
-export interface RpcTransport {
+export type RpcTransport = {
     close(): void;
     send(message: string): void;
     subscribe(listener: (message: string) => void): () => void;
     subscribeClose(listener: () => void): () => void;
     readonly state: RpcTransportState;
-}
+};
 //# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC3D,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.js"],"names":[],"mappings":"gCAEc,QAAQ,GAAG,MAAM;2BACjB;IAAE,KAAK,IAAI,IAAI,CAAC;IAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE"}

package/dist/trust-contract.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @param {unknown} value
+ * @returns {value is Record<string, never>}
+ */
+export function isTrustInstallRestartPayload(value: unknown): value is Record<string, never>;
+/**
+ * @param {unknown} value
+ * @returns {value is Record<string, never>}
+ */
+export function isTrustVerifyPayload(value: unknown): value is Record<string, never>;
+/**
+ * @param {unknown} value
+ * @returns {value is Record<string, never>}
+ */
+export function isTrustSkipPayload(value: unknown): value is Record<string, never>;
+/** @typedef {import("@econ-v1/domain").CertificateTrustSnapshot} CertificateTrustSnapshot */
+export const TRUST_STATUS_QUERY: "trust.status.v1";
+export const TRUST_INSTALL_RESTART_COMMAND: "trust.install.restart.v1";
+export const TRUST_VERIFY_COMMAND: "trust.verify.v1";
+export const TRUST_SKIP_COMMAND: "trust.skip.v1";
+export type CertificateTrustSnapshot = import("@econ-v1/domain").CertificateTrustSnapshot;
+export type TrustStatusView = CertificateTrustSnapshot;
+//# sourceMappingURL=trust-contract.d.ts.map

package/dist/trust-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-contract.d.ts","sourceRoot":"","sources":["../src/trust-contract.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH,oDAHW,OAAO,GACL,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAI1C;AACD;;;GAGG;AACH,4CAHW,OAAO,GACL,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAI1C;AACD;;;GAGG;AACH,0CAHW,OAAO,GACL,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAI1C;AAzBD,6FAA6F;AAC7F,iCAAkC,iBAAiB,CAAC;AACpD,4CAA6C,0BAA0B,CAAC;AACxE,mCAAoC,iBAAiB,CAAC;AACtD,iCAAkC,eAAe,CAAC;uCAJpC,OAAO,iBAAiB,EAAE,wBAAwB;8BAiClD,wBAAwB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/rpc",
-  "version": "6.6.0",
+  "version": "6.10.0",
   "description": "Typed runtime and contracts for Node client stage-to-kernel RPC",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",
@@ -21,28 +21,32 @@
     "typescript"
   ],
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./src/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "rm -rf dist && tsc -b --pretty false",
+    "build": "rm -rf dist && tsc -p tsconfig.publish.json --pretty false",
+    "check": "tsc -p jsconfig.json --pretty false",
     "lint": "eslint src",
-    "prepack": "npm run build",
+    "prepack": "npm run build && node ../scripts/check-public-package.mjs .",
     "test": "vitest run --passWithNoTests",
-    "type-check": "tsc -b --pretty false"
+    "check:consumer": "node ../scripts/check-negative-type-contracts.mjs --config jsconfig.consumer.json",
+    "type-check": "yarn run check && yarn check:consumer"
+  },
+  "devDependencies": {
+    "typescript": "~5.8.3"
   },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "import": "./src/index.js",
+      "default": "./src/index.js"
     }
   },
   "files": [
+    "src/**/*.js",
     "dist/**/*.d.ts",
     "dist/**/*.d.ts.map",
-    "dist/**/*.js",
-    "dist/**/*.js.map",
-    "!dist/**/*.test.*"
+    "!src/**/*.test.js"
   ],
   "sideEffects": false,
   "engines": {
@@ -52,7 +56,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@econ-v1/domain": "6.6.0",
-    "@econ-v1/ports": "6.6.0"
+    "@econ-v1/domain": "6.10.0",
+    "@econ-v1/ports": "6.10.0"
   }
 }

package/src/client-device-pending-contract.js

@@ -0,0 +1,6 @@
+// @ts-check
+export const CLIENT_DEVICE_PENDING_QUERY = "client-device.pending.v2";
+/**
+ * One row per live pending pairing request, keyed by operationHash.
+ * @typedef {{ readonly id: string, readonly operationHash: string, readonly action: string, readonly deviceName: string, readonly requestedAt: string, readonly remainingSeconds: number, readonly targetDevice: string }} ClientDevicePendingRow
+ */

package/src/client.js

@@ -0,0 +1,26 @@
+// @ts-check
+
+/** @typedef {import("@econ-v1/domain").DomainEvent} DomainEvent */
+/** @typedef {import("@econ-v1/domain").KernelEventType} KernelEventType */
+/** @typedef {import("@econ-v1/domain").QueryName} QueryName */
+/** @typedef {() => void} Unsubscribe */
+/** @typedef {{ readonly appName: string, readonly entryUrl: string, readonly manifestSha256: string, readonly version: string }} PreparedStage */
+/** @typedef {{
+ *   command<T>(name: string, payload: unknown): Promise<T>,
+ *   liveQuery<T>(name: QueryName, params: unknown, listener: (diff: import("@econ-v1/domain").QueryDiff<T>) => void): Unsubscribe,
+ *   openStageSession(appName: string, manifestSha256: string): Promise<StageRpcSession>,
+ *   prepareStage(appName: string): Promise<PreparedStage>,
+ *   publish<T extends KernelEventType>(type: T, payload: import("@econ-v1/domain").KernelEventPayload<T>): Promise<void>,
+ *   query<T>(name: QueryName, params: unknown): Promise<T>,
+ *   subscribe<T extends KernelEventType>(type: T, listener: (event: import("@econ-v1/domain").KernelEventByType<T>) => void): Unsubscribe
+ * }} KernelRpcClient */
+/** @typedef {{
+ *   close(): void,
+ *   invokeCapability<T>(capability: string, payload: unknown): Promise<T>,
+ *   liveQuery<T>(name: QueryName, params: unknown, listener: (diff: import("@econ-v1/domain").QueryDiff<T>) => void): Unsubscribe,
+ *   publish<T extends KernelEventType>(type: T, payload: import("@econ-v1/domain").KernelEventPayload<T>): Promise<void>,
+ *   query<T>(name: QueryName, params: unknown): Promise<T>,
+ *   subscribe<T extends KernelEventType>(type: T, listener: (event: import("@econ-v1/domain").KernelEventByType<T>) => void): Unsubscribe
+ * }} StageRpcSession */
+
+export {};

package/src/device-boot-contract.js

@@ -0,0 +1,4 @@
+// @ts-check
+/**  @typedef {{ readonly id: "boot-state"; readonly kind: "unpaired" | "paired" | "paired-expired" | "revoked"; readonly delegationExpiresAt?: string; }} DeviceBootStateRow */
+export {};
+export const DEVICE_BOOT_STATE_QUERY = /** @type {const} */ ("device.boot-state.v1");

package/src/device-cleanup-contract.js

@@ -0,0 +1,9 @@
+// @ts-check
+export const DEVICE_CLEANUP_REQUEST_COMMAND = "client-device.cleanup-request.v1";
+export const DEVICE_CLEANUP_STATUS_COMMAND = "client-device.cleanup-status.v1";
+export const DEVICE_CLEANUP_CANCEL_COMMAND = "client-device.cleanup-cancel.v1";
+export const DEVICE_CLEANUP_QUERY = "client-device.cleanup.v1";
+/** @typedef {"pending" | "approved" | "declined" | "expired" | "no_candidate" | "not_needed" | "failed"} CleanupState */
+/** @typedef {{ readonly sessionId: string, readonly state: CleanupState }} DeviceCleanupRequestResult */
+/** @typedef {{ readonly state: CleanupState }} DeviceCleanupStatusResult */
+/** @typedef {{ readonly id: "device-cleanup", readonly state: CleanupState }} DeviceCleanupRow */

package/src/dialog-contract.js

@@ -0,0 +1,6 @@
+// @ts-check
+/** @typedef {{ readonly cancel?: boolean, readonly href?: string, readonly id: string, readonly label: string, readonly onSelect?: (handle: DialogHandle) => void | Promise<void>, readonly variant?: "neutral" | "primary" }} DialogAction */
+/** @typedef {{ readonly body: readonly string[], readonly emphasis?: string, readonly initialFocus?: string, readonly actions: readonly DialogAction[], readonly title: string }} DialogRequest */
+/** @typedef {{ readonly closed: Promise<string | undefined>, close(): void, setActionBusy(id: string, busy: boolean): void, setError(message: string | undefined): void, update(patch: Partial<DialogRequest>): void }} DialogHandle */
+/** @typedef {{ open(request: DialogRequest): DialogHandle }} DialogCenter */
+export {};

package/src/errors.js

@@ -0,0 +1,111 @@
+// @ts-check
+import {
+  DOMAIN_ERROR_CODES,
+  DomainError,
+  SYNC_ERROR_CODES,
+  SyncError,
+  TRANSPORT_ERROR_CODES,
+  TransportError,
+} from "@econ-v1/domain";
+
+/** @typedef {import("@econ-v1/domain").ClientError} ClientError */
+/** @typedef {import("@econ-v1/domain").JsonObject} JsonObject */
+/** @typedef {import("@econ-v1/domain").JsonValue} JsonValue */
+/** @typedef {import("@econ-v1/domain").SerializableClientError} SerializableClientError */
+
+/**
+ * @param {ClientError} error
+ * @returns {SerializableClientError}
+ */
+export function serializeClientError(error) {
+  return error.toJSON();
+}
+
+/**
+ * @param {unknown} value
+ * @returns {ClientError}
+ */
+export function deserializeClientError(value) {
+  if (!isSerializableClientError(value)) throw new TypeError("Invalid RPC error");
+
+  switch (value.kind) {
+    case "domain":
+      return new DomainError(errorOptions(value));
+    case "sync":
+      return new SyncError(errorOptions(value));
+    case "transport":
+      return new TransportError(errorOptions(value));
+  }
+}
+
+/**
+ * @param {unknown} value
+ * @returns {value is SerializableClientError}
+ */
+export function isSerializableClientError(value) {
+  if (!isJsonObject(value) || typeof value.code !== "string" || typeof value.kind !== "string" || typeof value.message !== "string") {
+    return false;
+  }
+
+  if (value.details !== undefined && !isJsonObject(value.details)) return false;
+
+  switch (value.kind) {
+    case "domain":
+      return includesCode(DOMAIN_ERROR_CODES, value.code);
+    case "sync":
+      return includesCode(SYNC_ERROR_CODES, value.code);
+    case "transport":
+      return includesCode(TRANSPORT_ERROR_CODES, value.code);
+    default:
+      return false;
+  }
+}
+
+/**
+ * @param {unknown} value
+ * @returns {value is JsonValue}
+ */
+export function isJsonValue(value) {
+  if (value === null || typeof value === "boolean" || typeof value === "string") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  if (Array.isArray(value)) return value.every(isJsonValue);
+  return isJsonObject(value);
+}
+
+/**
+ * @param {unknown} value
+ * @returns {value is JsonObject}
+ */
+export function isJsonObject(value) {
+  return isPlainObject(value) && Object.values(value).every(isJsonValue);
+}
+
+/**
+ * @template {string} TKind
+ * @template {string} TCode
+ * @param {import("@econ-v1/domain").SerializableError<TKind, TCode>} value
+ * @returns {import("@econ-v1/domain").ErrorOptions<TCode>}
+ */
+function errorOptions(value) {
+  return value.details === undefined
+    ? { code: value.code, message: value.message }
+    : { code: value.code, details: value.details, message: value.message };
+}
+
+/**
+ * @template {readonly string[]} TCodes
+ * @param {TCodes} codes
+ * @param {string} value
+ * @returns {value is TCodes[number]}
+ */
+function includesCode(codes, value) {
+  return /** @type {readonly string[]} */ (codes).includes(value);
+}
+
+/**
+ * @param {unknown} value
+ * @returns {value is Record<string, unknown>}
+ */
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}

package/src/index.js

@@ -0,0 +1,194 @@
+// @ts-check
+
+/** @typedef {import("./client.js").KernelRpcClient} KernelRpcClient */
+/** @typedef {import("./client.js").PreparedStage} PreparedStage */
+/** @typedef {import("./client.js").StageRpcSession} StageRpcSession */
+/** @typedef {import("./client.js").Unsubscribe} Unsubscribe */
+/** @typedef {import("@econ-v1/domain").ClientError} ClientError */
+/** @typedef {import("@econ-v1/domain").DomainEvent} DomainEvent */
+/** @typedef {import("@econ-v1/domain").DomainErrorCode} DomainErrorCode */
+/** @template {KernelEventType} T @typedef {import("@econ-v1/domain").KernelEventByType<T>} KernelEventByType */
+/** @template {KernelEventType} T @typedef {import("@econ-v1/domain").KernelEventPayload<T>} KernelEventPayload */
+/** @typedef {import("@econ-v1/domain").KernelEventType} KernelEventType */
+/** @typedef {import("@econ-v1/domain").OutboxIntent} OutboxIntent */
+/** @template T @typedef {import("@econ-v1/domain").QueryDiff<T>} QueryDiff */
+/** @typedef {import("@econ-v1/domain").QueryName} QueryName */
+/** @typedef {import("@econ-v1/domain").SerializableClientError} SerializableClientError */
+/** @typedef {import("@econ-v1/domain").SyncErrorCode} SyncErrorCode */
+/** @typedef {import("@econ-v1/domain").TransportState} TransportState */
+/** @typedef {import("@econ-v1/domain").TransportOfflineReason} TransportOfflineReason */
+/** @typedef {import("@econ-v1/domain").TransportErrorCode} TransportErrorCode */
+/** @typedef {import("@econ-v1/ports").EncryptedStorageDiagnostic} EncryptedStorageDiagnostic */
+/** @typedef {import("@econ-v1/ports").AppDataManifest} AppDataManifest */
+/** @typedef {import("@econ-v1/ports").AppDataOfflinePolicy} AppDataOfflinePolicy */
+/** @typedef {import("@econ-v1/ports").AppDataQueryDeclaration} AppDataQueryDeclaration */
+/** @typedef {import("@econ-v1/ports").AppDataQueryKind} AppDataQueryKind */
+/** @typedef {import("@econ-v1/ports").AppDataStreamDeclaration} AppDataStreamDeclaration */
+/** @typedef {import("@econ-v1/ports").AppDataStreamKind} AppDataStreamKind */
+/** @typedef {import("@econ-v1/ports").AppDataSyncKind} AppDataSyncKind */
+/** @typedef {import("@econ-v1/ports").AppDataSyncPolicy} AppDataSyncPolicy */
+/** @typedef {import("@econ-v1/ports").ClientUiChoice} ClientUiChoice */
+/** @typedef {import("@econ-v1/ports").ClientUiPreferencePort} ClientUiPreferencePort */
+/** @typedef {import("@econ-v1/ports").ClipboardPort} ClipboardPort */
+/** @typedef {import("@econ-v1/ports").CredentialHandoffCancellationReason} CredentialHandoffCancellationReason */
+/** @typedef {import("@econ-v1/ports").CredentialHandoffConnection} CredentialHandoffConnection */
+/** @typedef {import("@econ-v1/ports").CredentialHandoffMessage} CredentialHandoffMessage */
+/** @typedef {import("@econ-v1/ports").CredentialHandoffOpenResult} CredentialHandoffOpenResult */
+/** @typedef {import("@econ-v1/ports").CredentialHandoffPort} CredentialHandoffPort */
+/** @typedef {import("@econ-v1/ports").LegacyCredentialProbePort} LegacyCredentialProbePort */
+/** @typedef {import("@econ-v1/ports").LegacyCredentialStatus} LegacyCredentialStatus */
+/** @typedef {import("@econ-v1/ports").NodeAppMemoryApp} NodeAppMemoryApp */
+/** @typedef {import("@econ-v1/ports").NodeAppMemoryReading} NodeAppMemoryReading */
+/** @typedef {import("@econ-v1/ports").NodeAppBudgetVerdict} NodeAppBudgetVerdict */
+/** @typedef {import("@econ-v1/ports").NodeAppDeviceMemory} NodeAppDeviceMemory */
+/** @typedef {import("@econ-v1/ports").NodeAppGovernorRow} NodeAppGovernorRow */
+/** @typedef {import("@econ-v1/ports").NodeAppHeapSnapshot} NodeAppHeapSnapshot */
+/** @typedef {import("@econ-v1/ports").NodeAppLaneKind} NodeAppLaneKind */
+/** @typedef {import("@econ-v1/ports").NodeAppMemoryOverview} NodeAppMemoryOverview */
+/** @typedef {import("@econ-v1/ports").NodeAppMemoryOverviewApp} NodeAppMemoryOverviewApp */
+/** @typedef {import("@econ-v1/ports").ShellCacheResetPort} ShellCacheResetPort */
+/** @typedef {import("@econ-v1/ports").ShellVersionPort} ShellVersionPort */
+/** @typedef {import("@econ-v1/ports").ShellVersionReport} ShellVersionReport */
+/** @typedef {import("@econ-v1/ports").InstallEnvironmentPort} InstallEnvironmentPort */
+/** @typedef {import("@econ-v1/ports").InstallInstructionMode} InstallInstructionMode */
+/** @typedef {import("@econ-v1/ports").MediaPreferencesPort} MediaPreferencesPort */
+/** @typedef {import("@econ-v1/ports").StageCatalogEntry} StageCatalogEntry */
+/** @typedef {import("@econ-v1/ports").StorageRecoveryCode} StorageRecoveryCode */
+/** @typedef {import("@econ-v1/ports").StorageRecoveryState} StorageRecoveryState */
+/** @typedef {import("@econ-v1/ports").ThemeEnvironmentPort} ThemeEnvironmentPort */
+/** @typedef {import("@econ-v1/ports").ThemePreference} ThemePreference */
+/** @typedef {import("./message-port-client.js").MessagePortKernelRpcClientOptions} MessagePortKernelRpcClientOptions */
+/** @typedef {import("./onboarding/discovery-contract.js").DiscoveryCandidateStatus} DiscoveryCandidateStatus */
+/** @typedef {import("./onboarding/discovery-contract.js").DiscoveryCandidateView} DiscoveryCandidateView */
+/** @typedef {import("./onboarding/discovery-contract.js").DiscoveryFoundNode} DiscoveryFoundNode */
+/** @typedef {import("./onboarding/discovery-contract.js").DiscoverNodePayload} DiscoverNodePayload */
+/** @typedef {import("./onboarding/discovery-contract.js").NodeDiscoveryCandidate} NodeDiscoveryCandidate */
+/** @typedef {import("./onboarding/discovery-contract.js").NodeDiscoveryResult} NodeDiscoveryResult */
+/** @typedef {import("./onboarding/discovery-contract.js").ProbeCandidatesPayload} ProbeCandidatesPayload */
+/** @typedef {import("./onboarding/discovery-contract.js").PromoteCandidatePayload} PromoteCandidatePayload */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingApprovalState} OnboardingApprovalState */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingCommand} OnboardingCommand */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingDiscoveryCandidate} OnboardingDiscoveryCandidate */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingEvent} OnboardingEvent */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLifecycleState} OnboardingLifecycleState */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLifecycleStatus} OnboardingLifecycleStatus */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingPhase} OnboardingPhase */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingScenario} OnboardingScenario */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingScreen} OnboardingScreen */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingView} OnboardingView */
+/** @typedef {import("./node-app-memory-contract.js").NodeAppMemoryDetailQueryParams} NodeAppMemoryDetailQueryParams */
+/** @typedef {import("./dialog-contract.js").DialogAction} DialogAction */
+/** @typedef {import("./dialog-contract.js").DialogCenter} DialogCenter */
+/** @typedef {import("./dialog-contract.js").DialogHandle} DialogHandle */
+/** @typedef {import("./dialog-contract.js").DialogRequest} DialogRequest */
+/** @typedef {import("./client-device-pending-contract.js").ClientDevicePendingRow} ClientDevicePendingRow */
+/** @typedef {import("./pairing-status-contract.js").ClientDevicePairingStatusRow} ClientDevicePairingStatusRow */
+/** @typedef {import("./device-boot-contract.js").DeviceBootStateRow} DeviceBootStateRow */
+/** @typedef {import("./device-cleanup-contract.js").CleanupState} CleanupState */
+/** @typedef {import("./device-cleanup-contract.js").DeviceCleanupRequestResult} DeviceCleanupRequestResult */
+/** @typedef {import("./device-cleanup-contract.js").DeviceCleanupRow} DeviceCleanupRow */
+/** @typedef {import("./device-cleanup-contract.js").DeviceCleanupStatusResult} DeviceCleanupStatusResult */
+/** @typedef {import("./sync-cursors-contract.js").SyncCursorView} SyncCursorView */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingFlowBase} OnboardingFlowBase */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingFlowView} OnboardingFlowView */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLcdScreenBase} OnboardingLcdScreenBase */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLcdScreenId} OnboardingLcdScreenId */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLcdScreenState} OnboardingLcdScreenState */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLcdScreenTree} OnboardingLcdScreenTree */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLcdScreenView} OnboardingLcdScreenView */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingLcdUnavailableReason} OnboardingLcdUnavailableReason */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingNetwork} OnboardingNetwork */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingReasonCode} OnboardingReasonCode */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingStepId} OnboardingStepId */
+/** @typedef {import("./onboarding/onboarding-contract.js").OnboardingWifiSecurity} OnboardingWifiSecurity */
+/** @typedef {import("./onboarding/owner-claim-contract.js").OwnerClaimCompleteOutcome} OwnerClaimCompleteOutcome */
+/** @typedef {import("./onboarding/owner-claim-contract.js").OwnerClaimCompletePayload} OwnerClaimCompletePayload */
+/** @typedef {import("./onboarding/owner-claim-contract.js").OwnerClaimCompleteResult} OwnerClaimCompleteResult */
+/** @typedef {import("./onboarding/owner-claim-contract.js").OwnerClaimPrepareResult} OwnerClaimPrepareResult */
+/** @typedef {import("./trust-contract.js").TrustStatusView} TrustStatusView */
+/** @typedef {import("./stage-context.js").StageContextV1} StageContextV1 */
+/** @typedef {import("./stage-context.js").StageContextV2} StageContextV2 */
+/** @typedef {import("./system-notice-contract.js").SystemNotice} SystemNotice */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeAction} SystemNoticeAction */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeActionKind} SystemNoticeActionKind */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeBlockScope} SystemNoticeBlockScope */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeBody} SystemNoticeBody */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeCenter} SystemNoticeCenter */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeDetail} SystemNoticeDetail */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeDisclosure} SystemNoticeDisclosure */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeHandle} SystemNoticeHandle */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeInput} SystemNoticeInput */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeListener} SystemNoticeListener */
+/** @typedef {import("./system-notice-contract.js").SystemNoticePatch} SystemNoticePatch */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeSeverity} SystemNoticeSeverity */
+/** @typedef {import("./system-notice-contract.js").SystemNoticeState} SystemNoticeState */
+/** @typedef {import("./protocol.js").RpcEvent} RpcEvent */
+/** @typedef {import("./protocol.js").RpcRequest} RpcRequest */
+/** @typedef {import("./protocol.js").RpcResponse} RpcResponse */
+/** @typedef {import("./stage-context.js").MountedStage} MountedStage */
+/** @typedef {import("./stage-context.js").StageContext} StageContext */
+/** @typedef {import("./stage-context.js").StageModule} StageModule */
+/** @typedef {import("./transport.js").RpcTransport} RpcTransport */
+/** @typedef {import("./transport.js").RpcTransportState} RpcTransportState */
+
+export {
+  DOMAIN_ERROR_CODES,
+  DomainError,
+  SYNC_ERROR_CODES,
+  SyncError,
+  TRANSPORT_ERROR_CODES,
+  TransportError,
+} from "@econ-v1/domain";
+export {
+  deserializeClientError,
+  isJsonValue,
+  isSerializableClientError,
+  serializeClientError,
+} from "./errors.js";
+export { KernelRpcTimeoutError, MessagePortKernelRpcClient } from "./message-port-client.js";
+export { NODE_APP_MEMORY_CAPTURE_COMMAND, NODE_APP_MEMORY_DETAIL_QUERY, NODE_APP_MEMORY_DOWNLOAD_COMMAND, NODE_APP_MEMORY_LIST_QUERY, NODE_APP_MEMORY_OVERVIEW_QUERY, NODE_APP_MEMORY_STATUS_COMMAND } from "./node-app-memory-contract.js";
+export { DEVICE_BOOT_STATE_QUERY } from "./device-boot-contract.js";
+export { CLIENT_DEVICE_PENDING_QUERY } from "./client-device-pending-contract.js";
+export {
+  CLIENT_DEVICE_PAIRING_STATUS_QUERY,
+  CLIENT_DEVICE_WIRE_ERROR_DEVICE_NOT_REGISTERED,
+  CLIENT_DEVICE_WIRE_ERROR_LAST_DEVICE,
+  CLIENT_DEVICE_WIRE_ERROR_LAST_DEVICE_PROTECTED,
+  CLIENT_DEVICE_WIRE_ERROR_NAME_TAKEN,
+} from "./pairing-status-contract.js";
+export {
+  DEVICE_CLEANUP_CANCEL_COMMAND,
+  DEVICE_CLEANUP_QUERY,
+  DEVICE_CLEANUP_REQUEST_COMMAND,
+  DEVICE_CLEANUP_STATUS_COMMAND,
+} from "./device-cleanup-contract.js";
+export { SYNC_CURSORS_QUERY } from "./sync-cursors-contract.js";
+export { TRANSPORT_STATE_QUERY, TRANSPORT_STATE_QUERY_V2 } from "./transport-contract.js";
+export {
+  DISCOVER_NODE_COMMAND,
+  DISCOVERY_PROBE_COMMAND,
+  DISCOVERY_PROMOTE_COMMAND,
+  DISCOVERY_QUERY,
+  isDiscoverNodePayload,
+  isProbeCandidatesPayload,
+  isPromoteCandidatePayload,
+} from "./onboarding/discovery-contract.js";
+export {
+  isOnboardingCommand,
+  ONBOARDING_COMMAND,
+  ONBOARDING_EVENTS,
+  ONBOARDING_FLOW_QUERY,
+  ONBOARDING_LCD_SCREEN_QUERY,
+  ONBOARDING_STATUS_QUERY,
+  ONBOARDING_STEP_IDS,
+} from "./onboarding/onboarding-contract.js";
+export { TRUST_INSTALL_RESTART_COMMAND, TRUST_SKIP_COMMAND, TRUST_STATUS_QUERY, TRUST_VERIFY_COMMAND, isTrustInstallRestartPayload, isTrustSkipPayload, isTrustVerifyPayload } from "./trust-contract.js";
+export { isOwnerClaimCompletePayload, OWNER_CLAIM_COMPLETE_COMMAND, OWNER_CLAIM_PREPARE_COMMAND } from "./onboarding/owner-claim-contract.js";
+export {
+  deserializeRpcEvent,
+  deserializeRpcRequest,
+  deserializeRpcResponse,
+  serializeRpcEvent,
+  serializeRpcRequest,
+  serializeRpcResponse,
+} from "./protocol.js";