statewire 0.21.0 → 0.22.0

package/dist/host/socket.d.ts

@@ -1,174 +1,174 @@
-import { CommandsHost } from "./host.js";
-import { StatewireHost } from "../host.js";
-import { StatewireProtocol } from "../wire/protocol.js";
-import { StatewireDocument } from "../document.js";
-import { Statewire } from "../types.js";
-import { StatewirePath } from "../wire/ops.js";
-import { StatewireHostInternal } from "../host-internal.js";
-import { ResourceElement } from "@assistant-ui/tap";
-//#region src/host/socket.d.ts
-declare const CLIENT_ID_RE: RegExp;
-declare const PRINCIPAL_MISMATCH_MESSAGE = "client id is bound to another principal";
+import type { StatewireProtocol } from "../wire/protocol.js";
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { CommandsHost } from "./host.js";
+import type { Statewire } from "../types.js";
+import type { StatewireHost } from "../host.js";
+import type { StatewireHostInternal } from "../host-internal.js";
+import type { StatewireDocument } from "../document.js";
+import type { StatewirePath } from "../wire/ops.js";
+export declare const CLIENT_ID_RE: RegExp;
+export declare const PRINCIPAL_MISMATCH_MESSAGE = "client id is bound to another principal";
 /** Structural equality over auth values: primitives, Dates, arrays, and plain
  * objects compare by value; anything else by identity. */
-declare const authEquals: (a: unknown, b: unknown) => boolean;
-declare const SUBSCRIBER_LIMIT_MESSAGE = "stream subscriber limit reached";
+export declare const authEquals: (a: unknown, b: unknown) => boolean;
+export declare const SUBSCRIBER_LIMIT_MESSAGE = "stream subscriber limit reached";
 type Cmd = StatewireHostInternal.Cmd;
 type WireOp = {
-  op: string;
-  doc?: number;
-  path?: StatewirePath;
-  value?: unknown;
-  meta?: StatewireDocument.MetaEntry[];
-  protocol?: string;
-  key?: readonly string[];
-  main?: boolean;
+    op: string;
+    doc?: number;
+    path?: StatewirePath;
+    value?: unknown;
+    meta?: StatewireDocument.MetaEntry[];
+    protocol?: string;
+    key?: readonly string[];
+    main?: boolean;
 };
 type Admission = {
-  protocol: string;
-  seq: number;
-  method: string;
-  applied: boolean;
-  appliedSent: boolean;
-  settled: boolean;
+    protocol: string;
+    seq: number;
+    method: string;
+    applied: boolean;
+    appliedSent: boolean;
+    settled: boolean;
 };
 /** One statement lane: durable lanes live on the client record, ephemeral lanes on the attach. */
 type Lane = {
-  protocol: string;
-  clientId: string;
-  conn: Conn | null;
-  lastSeq: number;
-  results: Map<number, {
-    ts: number;
-    cmd: Cmd;
-  }>;
-  inflight: Map<number, Admission>;
+    protocol: string;
+    clientId: string;
+    conn: Conn | null;
+    lastSeq: number;
+    results: Map<number, {
+        ts: number;
+        cmd: Cmd;
+    }>;
+    inflight: Map<number, Admission>;
 };
-type ClientRec = {
-  id: string;
-  touched: number;
-  lanes: Map<string, Lane>;
-  /** The auth captured at the record's first attach; later attaches must match. */
-  principal: unknown;
+export type ClientRec = {
+    id: string;
+    touched: number;
+    lanes: Map<string, Lane>;
+    /** The auth captured at the record's first attach; later attaches must match. */
+    principal: unknown;
 };
-type Conn = {
-  selection: StatewireProtocol.Selection;
-  clientId: string;
-  socket: StatewireHostInternal.Socket;
-  open: boolean;
-  ready: boolean;
-  sawFrame: boolean;
-  lastSentAt: number;
-  lease: string | null;
-  /** The awaited `authorize` return captured at this attach's authorization. */
-  auth: unknown;
-  authorizedAt: number | undefined;
-  leaseTimer: ReturnType<typeof setTimeout> | null;
-  lanes: Map<string, Lane>;
-  contexts: Map<string, Statewire.Context>;
-  documents: Map<string, StatewireHost.Document>;
-  included: Set<string>;
-  view: Map<string, {
-    doc: number;
-    value: unknown;
-  }>;
-  nextDoc: number;
-  pendingApplied: Cmd[];
-  pendingCmds: Cmd[];
-  attach: StatewireHost.Attach;
+export type Conn = {
+    selection: StatewireProtocol.Selection;
+    clientId: string;
+    socket: StatewireHostInternal.Socket;
+    open: boolean;
+    ready: boolean;
+    sawFrame: boolean;
+    lastSentAt: number;
+    lease: string | null;
+    /** The awaited `authorize` return captured at this attach's authorization. */
+    auth: unknown;
+    authorizedAt: number | undefined;
+    leaseTimer: ReturnType<typeof setTimeout> | null;
+    lanes: Map<string, Lane>;
+    contexts: Map<string, Statewire.Context>;
+    documents: Map<string, StatewireHost.Document>;
+    included: Set<string>;
+    onIncludedChange: ((included: readonly StatewireHostInternal.IncludedDocument[]) => void) | undefined;
+    view: Map<string, {
+        doc: number;
+        value: unknown;
+    }>;
+    nextDoc: number;
+    pendingApplied: Cmd[];
+    pendingCmds: Cmd[];
+    attach: StatewireHost.Attach;
 };
 type PendingConn = {
-  socket: StatewireHostInternal.Socket;
-  open: boolean;
-  authorizing: boolean;
-  queued: string[];
-  timer: ReturnType<typeof setTimeout> | null;
-  connection: StatewireHostInternal.SocketConnection | null;
+    socket: StatewireHostInternal.Socket;
+    open: boolean;
+    authorizing: boolean;
+    queued: string[];
+    timer: ReturnType<typeof setTimeout> | null;
+    connection: StatewireHostInternal.SocketConnection | null;
 };
 type CmdStatement = {
-  protocol: string;
-  seq: number;
-  method: string;
-  params: unknown;
-  meta?: unknown;
-};
-type ParsedFrame = {
-  cmd: CmdStatement[];
-  ctx?: {
     protocol: string;
-    value: Statewire.Context;
-  }[];
+    seq: number;
+    method: string;
+    params: unknown;
+    meta?: unknown;
+};
+export type ParsedFrame = {
+    cmd: CmdStatement[];
+    ctx?: {
+        protocol: string;
+        value: Statewire.Context;
+    }[];
 };
-declare const parseFrameValue: (frame: unknown) => ParsedFrame;
-declare const parseFrame: (raw: string) => ParsedFrame;
-type SocketHostState = {
-  protocol: StatewireProtocol.Definition;
-  key: readonly string[] | undefined;
-  wireVersion: StatewireProtocol.Range;
-  heartbeatMs: number;
-  maxLeaseLifetimeMs: number | null;
-  wsInitTimeoutMs: number;
-  maxSubscribers: number;
-  maxInflightCommands: number;
-  streamQueueSize: number;
-  clientRecordLimit: number;
-  finOnIdle: boolean;
-  pushback: (() => number | null) | undefined;
-  authorize: StatewireHostInternal.SocketHostOptions["authorize"];
-  clients: Map<string, ClientRec>;
-  conns: Set<Conn>;
-  pendingConns: Set<PendingConn>;
-  pendingOps: WireOp[];
-  pendingApplied: Map<string, Cmd[]>;
-  pendingCmds: Map<string, Cmd[]>;
-  viewsDirty: boolean;
-  idleWire: boolean;
-  finished: StatewireHost.Fin | null;
-  disposed: boolean;
-  flushScheduled: boolean;
-  heartbeatTimer: ReturnType<typeof setInterval> | null;
-  stateHost: StatewireHost.StateHost | null;
-  commandsHost: CommandsHost | null;
-  current: Statewire<unknown> | null;
-  persistence: StatewireHostInternal.SocketHostPersistence | undefined;
-  post: () => void;
-  connect: (clientId: string, socket: StatewireHostInternal.Socket, options?: StatewireHostInternal.SocketConnectOptions) => StatewireHostInternal.SocketConnection | null;
-  finish: (fin: StatewireHost.Fin) => void;
-  stream: (request: Request) => Promise<Response>;
-  frames: (request: Request) => Promise<Response>;
+export declare const parseFrameValue: (frame: unknown) => ParsedFrame;
+export declare const parseFrame: (raw: string) => ParsedFrame;
+export type SocketHostState = {
+    protocol: StatewireProtocol.Definition;
+    key: readonly string[] | undefined;
+    wireVersion: StatewireProtocol.Range;
+    heartbeatMs: number;
+    maxLeaseLifetimeMs: number | null;
+    wsInitTimeoutMs: number;
+    maxSubscribers: number;
+    maxInflightCommands: number;
+    streamQueueSize: number;
+    clientRecordLimit: number;
+    finOnIdle: boolean;
+    pushback: (() => number | null) | undefined;
+    authorize: StatewireHostInternal.SocketHostOptions["authorize"];
+    clients: Map<string, ClientRec>;
+    conns: Set<Conn>;
+    pendingConns: Set<PendingConn>;
+    pendingOps: WireOp[];
+    pendingApplied: Map<string, Cmd[]>;
+    pendingCmds: Map<string, Cmd[]>;
+    viewsDirty: boolean;
+    idleWire: boolean;
+    finished: StatewireHost.Fin | null;
+    disposed: boolean;
+    flushScheduled: boolean;
+    heartbeatTimer: ReturnType<typeof setInterval> | null;
+    stateHost: StatewireHost.StateHost | null;
+    commandsHost: CommandsHost | null;
+    current: Statewire<unknown> | null;
+    persistence: StatewireHostInternal.SocketHostPersistence | undefined;
+    post: () => void;
+    connect: (clientId: string, socket: StatewireHostInternal.Socket, options?: StatewireHostInternal.SocketConnectOptions) => StatewireHostInternal.SocketConnection | null;
+    finish: (fin: StatewireHost.Fin) => void;
+    stream: (request: Request) => Promise<Response>;
+    frames: (request: Request) => Promise<Response>;
 };
-declare const closeConn: (h: SocketHostState, conn: Conn, code?: number, reason?: string) => void;
-declare const sendTo: (h: SocketHostState, conn: Conn, data: string) => void;
-declare const expireLease: (h: SocketHostState, conn: Conn) => boolean;
-declare const atSubscriberLimit: (h: SocketHostState) => boolean;
-declare const flush: (h: SocketHostState, fin?: StatewireHost.Fin) => void;
-type FrameAdmission = {
-  type: "ok";
+export declare const closeConn: (h: SocketHostState, conn: Conn, code?: number, reason?: string) => void;
+export declare const sendTo: (h: SocketHostState, conn: Conn, data: string) => void;
+export declare const expireLease: (h: SocketHostState, conn: Conn) => boolean;
+export declare const atSubscriberLimit: (h: SocketHostState) => boolean;
+export declare const flush: (h: SocketHostState, fin?: StatewireHost.Fin) => void;
+export type FrameAdmission = {
+    type: "ok";
 } | {
-  type: "expired";
+    type: "expired";
 } | {
-  type: "refused";
-  syn: {
+    type: "refused";
     syn: {
-      protocols: {
-        name: string;
-        seq: number;
-      }[];
-      retry?: number;
+        syn: {
+            protocols: {
+                name: string;
+                seq: number;
+            }[];
+            retry?: number;
+        };
     };
-  };
 };
-declare const admitFrame: (h: SocketHostState, conn: Conn, frame: ParsedFrame) => FrameAdmission;
-type Registration = {
-  conn: Conn;
-  connection: StatewireHostInternal.SocketConnection;
+export declare const admitFrame: (h: SocketHostState, conn: Conn, frame: ParsedFrame) => FrameAdmission;
+export type Registration = {
+    conn: Conn;
+    connection: StatewireHostInternal.SocketConnection;
 };
 /**
  * Attach a socket: ephemeral-lane statements of the attach frame are admitted
  * before the snapshot (their documents and answers ride the hello), durable
  * ones after it. A violation in the attach frame closes the attach and throws.
  */
-declare const register: (h: SocketHostState, clientId: string, socket: StatewireHostInternal.Socket, sawFrame?: boolean, auth?: unknown, selection?: StatewireProtocol.Selection, frame?: ParsedFrame, authorizedAt?: number) => Registration | null;
+export declare const register: (h: SocketHostState, clientId: string, socket: StatewireHostInternal.Socket, sawFrame?: boolean, auth?: unknown, selection?: StatewireProtocol.Selection, frame?: ParsedFrame, authorizedAt?: number, included?: Pick<StatewireHostInternal.SocketConnectOptions, "included" | "onIncludedChange">) => Registration | null;
 /**
  * Transport-agnostic WS binding over a statewire/host transport:
  * feed it sockets (anything with `send`/`close`) and raw text frames, and it
@@ -178,7 +178,6 @@ declare const register: (h: SocketHostState, clientId: string, socket: Statewire
  * admitting attach (ephemeral lanes), per-attach document views, idle edges,
  * and `fin` on finish.
  */
-declare const StatewireSocketHost: (transport: ResourceElement<Statewire>, options?: StatewireHostInternal.SocketHostOptions, persistence?: StatewireHostInternal.SocketHostPersistence) => StatewireHostInternal.SocketHost;
-//#endregion
-export { CLIENT_ID_RE, ClientRec, Conn, FrameAdmission, PRINCIPAL_MISMATCH_MESSAGE, ParsedFrame, Registration, SUBSCRIBER_LIMIT_MESSAGE, SocketHostState, StatewireSocketHost, admitFrame, atSubscriberLimit, authEquals, closeConn, expireLease, flush, parseFrame, parseFrameValue, register, sendTo };
+export declare const StatewireSocketHost: (transport: ResourceElement<Statewire>, options?: StatewireHostInternal.SocketHostOptions, persistence?: StatewireHostInternal.SocketHostPersistence) => StatewireHostInternal.SocketHost;
+export {};
 //# sourceMappingURL=socket.d.ts.map

package/dist/host/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","names":[],"sources":["../../src/host/socket.ts"],"mappings":";;;;;;;;;cAiCa,cAAY;cACZ;;;cAKA,aAAc,YAAY;cAoC1B;KAGR,MAAM,sBAAsB;KAE5B;EACH;EACA;EACA,OAAO;EACP;EACA,OAAO,kBAAkB;EACzB;EACA;EACA;;KAGG;EACH;EACA;EACA;EACA;EACA;EACA;;;KAIG;EACH;EACA;EACA,MAAM;EACN;EACA,SAAS;IAAc;IAAY,KAAK;;EACxC,UAAU,YAAY;;KAGZ;EACV;EACA;EACA,OAAO,YAAY;;EAEnB;;KAIU;EACV,WAAW,kBAAkB;EAC7B;EACA,QAAQ,sBAAsB;EAC9B;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA,YAAY,kBAAkB;EAC9B,OAAO,YAAY;EACnB,UAAU,YAAY,UAAU;EAChC,WAAW,YAAY,cAAc;EACrC,UAAU;EACV,MAAM;IAAc;IAAa;;EACjC;EACA,gBAAgB;EAChB,aAAa;EACb,QAAQ,cAAc;;KAGnB;EACH,QAAQ,sBAAsB;EAC9B;EACA;EACA;EACA,OAAO,kBAAkB;EACzB,YAAY,sBAAsB;;KAc/B;EACH;EACA;EACA;EACA;EACA;;KAGU;EACV,KAAK;EACL;IAAQ;IAAkB,OAAO,UAAU;;;cAQhC,kBAAmB,mBAAiB;cAqFpC,aAAc,gBAAc;KAuF7B;EACV,UAAU,kBAAkB;EAC5B;EACA,aAAa,kBAAkB;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAW,sBAAsB;EACjC,SAAS,YAAY;EACrB,OAAO,IAAI;EACX,cAAc,IAAI;EAClB,YAAY;EACZ,gBAAgB,YAAY;EAC5B,aAAa,YAAY;EACzB;EACA;EACA,UAAU,cAAc;EACxB;EACA;EACA,gBAAgB,kBAAkB;EAClC,WAAW,cAAc;EACzB,cAAc;EACd,SAAS;EACT,aAAa,sBAAsB;EACnC;EACA,UACE,kBACA,QAAQ,sBAAsB,QAC9B,UAAU,sBAAsB,yBAC7B,sBAAsB;EAC3B,SAAS,KAAK,cAAc;EAC5B,SAAS,SAAS,YAAY,QAAQ;EACtC,SAAS,SAAS,YAAY,QAAQ;;cAsD3B,YACX,GAAG,iBACH,MAAM,MACN,eACA;cAqBW,SAAU,GAAG,iBAAiB,MAAM,MAAM;cA0B1C,cAAe,GAAG,iBAAiB,MAAM;cAoCzC,oBAAqB,GAAG;cAsLxB,QAAS,GAAG,iBAAiB,MAAM,cAAc;KAoUlD;EACN;;EACA;;EAEA;EACA;IACE;MAAO;QAAa;QAAc;;MAAiB;;;;cAyE9C,aACX,GAAG,iBACH,MAAM,MACN,OAAO,gBACN;KAkaS;EACV,MAAM;EACN,YAAY,sBAAsB;;;;;;;cAQvB,WACX,GAAG,iBACH,kBACA,QAAQ,sBAAsB,QAC9B,oBACA,gBACA,YAAW,kBAAkB,WAI7B,QAAO,aACP,0BACC;;;;;;;;;;cA6WU,sBACX,WAAW,gBAAgB,YAC3B,UAAU,sBAAsB,mBAChC,cAAc,sBAAsB,0BACnC,sBAAsB"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/host/socket.ts"],"names":[],"mappings":"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"}

package/dist/host/socket.js

@@ -1,6 +1,6 @@
+import { DEFAULT_PROTOCOL, WIRE_VERSION, negotiateProtocols } from "../wire/protocol.js";
 import { encodeDocument, reviveDocumentValue } from "../document.js";
 import { COMMAND_CAPACITY_RETRY_MS, MAX_INFLIGHT_COMMANDS_PER_HOST } from "../wire/limits.js";
-import { DEFAULT_PROTOCOL, WIRE_VERSION, negotiateProtocols } from "../wire/protocol.js";
 import { captureContext, contextValue } from "../wire/context.js";
 import { sanitizeValue } from "../wire/ops.js";
 import { StatewireSendError } from "../types.js";
@@ -9,7 +9,7 @@ import { createMacrotaskPoster } from "../util/macrotask.js";
 import { frames, stream } from "./http.js";
 import { useEffect, useState } from "@assistant-ui/tap/react-shim";
 import { createTapRoot, flushTapSync, useResource } from "@assistant-ui/tap";
-//#region src/host/socket.ts
+// src/host/socket.ts
 const CLIENT_ID_RE = /^[A-Za-z0-9._~-]{1,256}$/;
 const PRINCIPAL_MISMATCH_MESSAGE = "client id is bound to another principal";
 /** Structural equality over auth values: primitives, Dates, arrays, and plain
@@ -354,6 +354,11 @@ const diffView = (h, conn) => {
 	}
 	return ops;
 };
+const notifyIncluded = (conn) => conn.onIncludedChange?.([...conn.included].map((id) => JSON.parse(id)));
+const restoredIncluded = (included) => new Set(included.map((entry) => {
+	if (!Array.isArray(entry) || entry.length !== 2 || typeof entry[0] !== "string" || !(entry[1] === null || Array.isArray(entry[1]) && entry[1].every((part) => typeof part === "string"))) throw new TypeError("statewire: invalid restored include");
+	return documentIdentity(entry[0], entry[1] ?? void 0);
+}));
 const attachOf = (h, conn) => {
 	const requireSelected = (protocol) => {
 		const entry = conn.selection.protocols.find((p) => p.name === protocol);
@@ -396,11 +401,15 @@ const attachOf = (h, conn) => {
 		},
 		include: (protocol, key) => {
 			if (requireSelected(protocol).record !== void 0) throw new Error(`statewire: protocol ${protocol} is not durable`);
-			conn.included.add(documentIdentity(protocol, key));
+			const id = documentIdentity(protocol, key);
+			if (conn.included.has(id)) return;
+			conn.included.add(id);
+			notifyIncluded(conn);
 			markViews(h);
 		},
 		exclude: (protocol, key) => {
-			conn.included.delete(documentIdentity(protocol, key));
+			if (!conn.included.delete(documentIdentity(protocol, key))) return;
+			notifyIncluded(conn);
 			markViews(h);
 		}
 	};
@@ -802,7 +811,7 @@ const connectAuthorized = (h, clientId, socket, options) => {
 			} catch {}
 			return null;
 		}
-		return register(h, clientId, socket, options.authorized === true, options.auth, options.selection, void 0, options.authorizedAt)?.connection ?? null;
+		return register(h, clientId, socket, options.authorized === true, options.auth, options.selection, void 0, options.authorizedAt, options)?.connection ?? null;
 	}
 	const refuse = (code, reason) => {
 		try {
@@ -907,7 +916,7 @@ const connectAuthorized = (h, clientId, socket, options) => {
 				if (pending.timer !== null) clearTimeout(pending.timer);
 				let registration;
 				try {
-					registration = register(h, clientId, socket, true, auth, selection, frame, authorizedAt);
+					registration = register(h, clientId, socket, true, auth, selection, frame, authorizedAt, options.onIncludedChange === void 0 ? {} : { onIncludedChange: options.onIncludedChange });
 				} catch (error) {
 					if (violationReason(error) === null) throw error;
 					return;
@@ -951,7 +960,8 @@ const register = (h, clientId, socket, sawFrame = false, auth = void 0, selectio
 		name: h.protocol.name,
 		version: h.protocol.version
 	}]
-}, frame = { cmd: [] }, authorizedAt) => {
+}, frame = { cmd: [] }, authorizedAt, included = {}) => {
+	const restored = restoredIncluded(included.included ?? []);
 	const refuse = (code, reason) => {
 		try {
 			socket.close(code, reason);
@@ -1012,7 +1022,8 @@ const register = (h, clientId, socket, sawFrame = false, auth = void 0, selectio
 		lanes: /* @__PURE__ */ new Map(),
 		contexts: /* @__PURE__ */ new Map(),
 		documents: /* @__PURE__ */ new Map(),
-		included: /* @__PURE__ */ new Set(),
+		included: restored,
+		onIncludedChange: included.onIncludedChange,
 		view: /* @__PURE__ */ new Map(),
 		nextDoc: 1,
 		pendingApplied: [],
@@ -1258,7 +1269,6 @@ const StatewireSocketHost = (transport, options, persistence) => {
 		}
 	};
 };
-//#endregion
 export { CLIENT_ID_RE, PRINCIPAL_MISMATCH_MESSAGE, SUBSCRIBER_LIMIT_MESSAGE, StatewireSocketHost, admitFrame, atSubscriberLimit, authEquals, closeConn, expireLease, flush, parseFrame, parseFrameValue, register, sendTo };
 
 //# sourceMappingURL=socket.js.map