statewire 0.21.0 → 0.22.1

package/dist/client/session.d.ts

@@ -1,108 +1,106 @@
-import { StatewireDocuments } from "../wire/documents.js";
-import { CommandsInvocation, CommandsListener } from "../host/host.js";
-import { StatewireProtocol } from "../wire/protocol.js";
-import { RemoteLink, StatewireRemoteProps } from "../transports/sse.js";
-import { StatewireClient } from "../statewire.js";
-import { Statewire } from "../types.js";
-import { StatewirePath } from "../wire/ops.js";
 import { encodeContext } from "../wire/context.js";
-//#region src/client/session.d.ts
+import type { StatewireProtocol } from "../wire/protocol.js";
+import type { StatewireDocuments } from "../wire/documents.js";
+import type { StatewirePath } from "../wire/ops.js";
+import type { CommandsInvocation, CommandsListener } from "../host/host.js";
+import type { Statewire } from "../types.js";
+import type { StatewireClient } from "../statewire.js";
+import type { RemoteLink, StatewireRemoteProps } from "../transports/sse.js";
 type WireCommand = {
-  protocol: string;
-  produced?: NonNullable<StatewireClient.SessionCommand["produced"]>;
-  method: string;
-  params: unknown[];
-  meta?: unknown;
+    protocol: string;
+    produced?: NonNullable<StatewireClient.SessionCommand["produced"]>;
+    method: string;
+    params: unknown[];
+    meta?: unknown;
 };
 type Pending = {
-  readonly seq: number;
-  readonly command: WireCommand;
-  readonly inv: CommandsInvocation;
-  /** A send carrying this statement may have reached the server. */
-  attempted: boolean;
-  /** In the resend queue when false. */
-  posted: boolean;
-  /** The server acknowledged admission; the terminal verdict is still due. */
-  applied: boolean;
-  resolve: (payload: unknown) => void;
-  reject: (error: unknown) => void;
+    readonly seq: number;
+    readonly command: WireCommand;
+    readonly inv: CommandsInvocation;
+    /** A send carrying this statement may have reached the server. */
+    attempted: boolean;
+    /** In the resend queue when false. */
+    posted: boolean;
+    /** The server acknowledged admission; the terminal verdict is still due. */
+    applied: boolean;
+    resolve: (payload: unknown) => void;
+    reject: (error: unknown) => void;
 };
 type AttachState = "detached" | "attached" | "finished";
-type StatewireSessionOptions = StatewireProtocol.Options & {
-  context?: Readonly<Record<string, Statewire.Context>>;
-  sessionStore?: StatewireClient.SessionStorage | undefined;
-  onSessionLost?: StatewireClient.OnSessionLost | undefined;
-  onDone?: (() => void) | undefined;
+export type StatewireSessionOptions = StatewireProtocol.Options & {
+    context?: Readonly<Record<string, Statewire.Context>>;
+    sessionStore?: StatewireClient.SessionStorage | undefined;
+    onSessionLost?: StatewireClient.OnSessionLost | undefined;
+    onDone?: (() => void) | undefined;
 };
 type Shared = {
-  txq: Promise<void>;
-  syncQueued: boolean;
-  parked: {
-    protocol: string;
-    verdict: StatewireClient.SessionVerdict;
-  }[];
-  unsubscribe: (() => void) | null;
+    txq: Promise<void>;
+    syncQueued: boolean;
+    parked: {
+        protocol: string;
+        verdict: StatewireClient.SessionVerdict;
+    }[];
+    unsubscribe: (() => void) | null;
 };
 type Session = {
-  options: StatewireSessionOptions;
-  configuredContext: StatewireSessionOptions["context"];
-  contexts: Map<string, ReturnType<typeof encodeContext>>;
-  dirtyContexts: Set<string>;
-  attachContexts: Map<string, ReturnType<typeof encodeContext>>;
-  selection: StatewireProtocol.Selection | undefined;
-  record: StatewireClient.SessionRecord;
-  ctx: StatewireRemoteProps;
-  recordPersisted: boolean;
-  hydrated: boolean;
-  ready: Promise<void> | undefined;
-  storageError: unknown;
-  persistedRecord: StatewireClient.SessionRecord | null;
-  store: StatewireClient.SessionStorage;
-  documentStore: StatewireDocuments.Storage | undefined;
-  shared: Shared | false;
-  /** Every selected lane is ephemeral: the record dies with the attach. */
-  ephemeral: boolean;
-  /** An ephemeral record died with its attach: the storage is off for good. */
-  deactivated: boolean;
-  sessionKnown: boolean;
-  durableSeq: Record<string, number>;
-  /** Ephemeral lane clocks: restart at 1 on every attach. */
-  ephemeralSeqs: Record<string, number>;
-  resumeAt: number;
-  idle: boolean;
-  onSessionLost: StatewireClient.OnSessionLost | undefined;
-  onDone: (() => void) | undefined;
-  lanesOnAttach: boolean;
-  attachEntries: ReadonlySet<Pending>;
-  frameFailures: number;
-  pending: Pending[];
-  failedList: readonly StatewireClient.FailedCommand[];
-  failedParts: readonly (readonly StatewireClient.FailedCommand[])[];
-  canonical: unknown;
-  documentListeners: Set<() => void>;
-  documents: StatewireDocuments.State;
-  lastPublished: unknown;
-  changed: StatewirePath[];
-  source: Statewire.StateSource;
-  attach: AttachState;
-  attachEpoch: number;
-  running: boolean;
-  pumping: boolean;
-  transport: RemoteLink | null;
-  waiters: (() => void)[];
-  lifecycle: CommandsListener | null;
-  notify: () => void;
-  commands: Record<string, (...params: unknown[]) => Promise<unknown>>;
+    options: StatewireSessionOptions;
+    configuredContext: StatewireSessionOptions["context"];
+    contexts: Map<string, ReturnType<typeof encodeContext>>;
+    dirtyContexts: Set<string>;
+    attachContexts: Map<string, ReturnType<typeof encodeContext>>;
+    selection: StatewireProtocol.Selection | undefined;
+    record: StatewireClient.SessionRecord;
+    ctx: StatewireRemoteProps;
+    recordPersisted: boolean;
+    hydrated: boolean;
+    ready: Promise<void> | undefined;
+    storageError: unknown;
+    persistedRecord: StatewireClient.SessionRecord | null;
+    store: StatewireClient.SessionStorage;
+    documentStore: StatewireDocuments.Storage | undefined;
+    shared: Shared | false;
+    /** Every selected lane is ephemeral: the record dies with the attach. */
+    ephemeral: boolean;
+    /** An ephemeral record died with its attach: the storage is off for good. */
+    deactivated: boolean;
+    sessionKnown: boolean;
+    durableSeq: Record<string, number>;
+    /** Ephemeral lane clocks: restart at 1 on every attach. */
+    ephemeralSeqs: Record<string, number>;
+    resumeAt: number;
+    idle: boolean;
+    onSessionLost: StatewireClient.OnSessionLost | undefined;
+    onDone: (() => void) | undefined;
+    lanesOnAttach: boolean;
+    attachEntries: ReadonlySet<Pending>;
+    frameFailures: number;
+    pending: Pending[];
+    failedList: readonly StatewireClient.FailedCommand[];
+    failedParts: readonly (readonly StatewireClient.FailedCommand[])[];
+    canonical: unknown;
+    documentListeners: Set<() => void>;
+    documents: StatewireDocuments.State;
+    lastPublished: unknown;
+    changed: StatewirePath[];
+    source: Statewire.StateSource;
+    attach: AttachState;
+    attachEpoch: number;
+    running: boolean;
+    pumping: boolean;
+    transport: RemoteLink | null;
+    waiters: (() => void)[];
+    lifecycle: CommandsListener | null;
+    notify: () => void;
+    commands: Record<string, (...params: unknown[]) => Promise<unknown>>;
 };
-declare const failedCommands: (s: Session) => readonly StatewireClient.FailedCommand[];
-declare const MAX_FAILED_RETAINED = 256;
+export declare const failedCommands: (s: Session) => readonly StatewireClient.FailedCommand[];
+export declare const MAX_FAILED_RETAINED = 256;
 declare const setTransport: (s: Session, transport: RemoteLink) => void;
-declare const discardFailed: (s: Session, entry: StatewireClient.FailedCommand) => void;
-declare const retryFailed: (s: Session, entry: StatewireClient.FailedCommand) => Promise<unknown>;
-declare const documentSource: (s: Session) => StatewireDocuments.Source;
-declare const invokeProtocol: (s: Session, protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
-declare const setContext: (s: Session, protocol: string, value: Statewire.Context) => void;
-declare const useStatewireSession: (options: StatewireSessionOptions) => Session;
-//#endregion
-export { MAX_FAILED_RETAINED, StatewireSessionOptions, discardFailed, documentSource, failedCommands, invokeProtocol, retryFailed, setContext, setTransport, useStatewireSession };
+export declare const discardFailed: (s: Session, entry: StatewireClient.FailedCommand) => void;
+export declare const retryFailed: (s: Session, entry: StatewireClient.FailedCommand) => Promise<unknown>;
+export declare const documentSource: (s: Session) => StatewireDocuments.Source;
+export declare const invokeProtocol: (s: Session, protocol: string, method: string, params: readonly unknown[]) => Promise<unknown>;
+export declare const setContext: (s: Session, protocol: string, value: Statewire.Context) => void;
+export declare const useStatewireSession: (options: StatewireSessionOptions) => Session;
+export { setTransport };
 //# sourceMappingURL=session.d.ts.map

package/dist/client/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","names":[],"sources":["../../src/client/session.ts"],"mappings":";;;;;;;;;KA0CK;EACH;EACA,WAAW,YAAY,gBAAgB;EACvC;EACA;EACA;;KAGG;WACM;WACA,SAAS;WACT,KAAK;;EAEd;;EAEA;;EAEA;EACA,UAAU;EACV,SAAS;;KAeN;KAEO,0BAA0B,kBAAkB;EACtD,UAAU,SAAS,eAAe,UAAU;EAC5C,eAAe,gBAAgB;EAC/B,gBAAgB,gBAAgB;EAChC;;KAGG;EACH,KAAK;EACL;EACA;IAAU;IAAkB,SAAS,gBAAgB;;EACrD;;KAGG;EACH,SAAS;EACT,mBAAmB;EACnB,UAAU,YAAY,kBAAkB;EACxC,eAAe;EACf,gBAAgB,YAAY,kBAAkB;EAC9C,WAAW,kBAAkB;EAC7B,QAAQ,gBAAgB;EACxB,KAAK;EACL;EACA;EACA,OAAO;EACP;EACA,iBAAiB,gBAAgB;EACjC,OAAO,gBAAgB;EACvB,eAAe,mBAAmB;EAClC,QAAQ;;EAER;;EAEA;EACA;EACA,YAAY;;EAEZ,eAAe;EACf;EACA;EACA,eAAe,gBAAgB;EAC/B;EACA;EACA,eAAe,YAAY;EAC3B;EACA,SAAS;EACT,qBAAqB,gBAAgB;EACrC,gCAAgC,gBAAgB;EAChD;EACA,mBAAmB;EACnB,WAAW,mBAAmB;EAC9B;EACA,SAAS;EACT,QAAQ,UAAU;EAClB,QAAQ;EACR;EACA;EACA;EACA,WAAW;EACX;EACA,WAAW;EACX;EACA,UAAU,mBAAmB,sBAAsB;;cAmNxC,iBACX,GAAG,qBACO,gBAAgB;cAcf;cAoxBP,eAAgB,GAAG,SAAS,WAAW;cAoNhC,gBACX,GAAG,SACH,OAAO,gBAAgB;cAYZ,cACX,GAAG,SACH,OAAO,gBAAgB,kBACtB;cA4DU,iBAAkB,GAAG,YAAU,mBAAmB;cA+BlD,iBACX,GAAG,SACH,kBACA,gBACA,+BAA0B;cAuEf,aACX,GAAG,SACH,kBACA,OAAO,UAAU;cAcN,sBACX,SAAS,4BACR"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/client/session.ts"],"names":[],"mappings":"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"}

package/dist/client/session.js

@@ -1,19 +1,19 @@
+import { inRange, protocolOffers } from "../wire/protocol.js";
 import { reviveDocumentValue } from "../document.js";
+import { encodeParams, reviveResponse } from "../wire/meta.js";
+import { backoff, retryHint } from "./timing.js";
+import { wrapStorageError } from "./storageError.js";
+import { TERMINAL } from "./connection.js";
 import "../wire/limits.js";
-import { inRange, protocolOffers } from "../wire/protocol.js";
 import { encodeContext } from "../wire/context.js";
 import { createMethodProxy } from "../util/methodProxy.js";
 import { StatewireSendError } from "../types.js";
 import { bindCommandsHost } from "../host/host.js";
-import { encodeParams, reviveResponse } from "../wire/meta.js";
 import { applyDocumentOps, findDocument, mainDocument, resolveDocumentKey } from "../wire/documents.js";
 import { DocumentStorageContext, SessionStorageContext, createMemorySessionStore } from "./sessionStore.js";
-import { backoff, retryHint } from "./timing.js";
-import { wrapStorageError } from "./storageError.js";
-import { TERMINAL } from "./connection.js";
 import { randomId } from "../util/randomId.js";
 import { useContext, useEffect, useState } from "@assistant-ui/tap/react-shim";
-//#region src/client/session.ts
+// src/client/session.ts
 const protocolError = (message) => {
 	throw new Error(`statewire: protocol error: ${message}`);
 };
@@ -1182,7 +1182,6 @@ const useStatewireSession = (options) => {
 	}, [s]);
 	return s;
 };
-//#endregion
 export { MAX_FAILED_RETAINED, discardFailed, documentSource, failedCommands, invokeProtocol, retryFailed, setContext, setTransport, useStatewireSession };
 
 //# sourceMappingURL=session.js.map