statewire 0.20.0 → 0.22.0

package/dist/statewire.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire.js","names":["StatewireDocuments","StatewireProtocol","StatewireHost","useCallback","useEffect","useMemo","useRef","useState","useSyncExternalStore","createTapRoot","flushTapSync","resource","useContextProvider","useResource","useResources","withKey","ResourceElement","CONNECTED_CONNECTION","useStatewireCore","Statewire","TERMINAL","DocumentStorageContext","LinkContext","ProtocolContext","SessionStorageContext","useSessionTransport","transport","session","documents","protocol","link","StatewireClient","SessionStorage","Storage","Options","isNew","context","Readonly","Record","Context","SessionTransport","useStatewire","Commands","options","TState","TCommands","Helpers","latest","current","storage","undefined","wireVersion","applicationProtocols","keyPrefixes","value","localContext","connection","setContext","Object","entries","core","rematerialize","materializeKey","subscribe","listener","state","getState","isBusy","getBusy","failed","getFailed","source","selection","invoke","transportInvoke","transportSetContext","failures","transportFailures","method","params","Error","NonNullable","commands","CommandsProxy","retryFailed","entry","FailedCommand","retry","discardFailed","discard","StatewireResource","root","disposed","constructor","ClientRoot","getValue","Connection","Source","Selection","Promise","dispose","unmount","Range","Offer","initialState","optimistic","Optimistic","materialize","Materialize","onStateChange","ctx","changes","Changes","onCommandChange","update","CommandUpdate","onConnectionChange","onError","error","ConnectionError","failureCovered","ConnectionState","status","reason","degraded","attempt","cause","code","nextRetryAt","lastError","message","payload","reconnect","ConnectionStatus","draft","command","Command","OptimisticContext","ts","seq","clientId","SendFailure","fate","predecessorLost","OnSessionLost","pending","ReadonlyArray","produced","SessionCommand","meta","failure","wire","protocols","SessionLane","nextSeq","verdicts","SessionVerdict","SessionRecord","lanes","type","ready","flush","load","save","record","migrate","lock","fn","T","fin","Fin","HeadersOption","HeadersInit","staleAuth","HttpOptions","sessionStore","url","headers","fetch","globalThis","onSessionLost","onChange","onDone","WebsocketOptions","query","webSocket","WebSocket"],"sources":["../src/statewire.ts"],"sourcesContent":["import type { StatewireDocuments } from \"./wire/documents\";\nimport type { StatewireProtocol } from \"./wire/protocol\";\nimport type { StatewireHost } from \"./host\";\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\nimport {\n  createTapRoot,\n  flushTapSync,\n  resource,\n  useContextProvider,\n  useResource,\n  useResources,\n  withKey,\n} from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { CONNECTED_CONNECTION, useStatewireCore } from \"./client/core\";\nimport type { Statewire } from \"./types\";\nimport type { TERMINAL } from \"./client/connection\";\nimport {\n  DocumentStorageContext,\n  LinkContext,\n  ProtocolContext,\n  SessionStorageContext,\n} from \"./client/sessionStore\";\n\nconst useSessionTransport = ({\n  transport,\n  session,\n  documents,\n  protocol,\n  link,\n}: {\n  transport: ResourceElement<Statewire<any, any>>;\n  session: StatewireClient.SessionStorage | undefined;\n  documents: StatewireDocuments.Storage | undefined;\n  protocol: StatewireProtocol.Options;\n  link: {\n    isNew?: boolean | undefined;\n    context?: Readonly<Record<string, Statewire.Context>> | undefined;\n  };\n}): Statewire<unknown> =>\n  useContextProvider(SessionStorageContext, session, () =>\n    // oxlint-disable-next-line react-hooks/rules-of-hooks\n    useContextProvider(DocumentStorageContext, documents, () =>\n      // oxlint-disable-next-line react-hooks/rules-of-hooks\n      useContextProvider(ProtocolContext, protocol, () =>\n        // oxlint-disable-next-line react-hooks/rules-of-hooks\n        useContextProvider(LinkContext, link, () =>\n          // oxlint-disable-next-line react-hooks/rules-of-hooks\n          useResource(transport),\n        ),\n      ),\n    ),\n  );\n\n// The transport owns the session; it reads the storage off the context this\n// wrapper's own fiber provides, so plain-React callers get a provider too.\nconst SessionTransport = resource(useSessionTransport);\n\nexport const useStatewire = <\n  TState,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.Options<TState, TCommands>,\n): StatewireClient.Helpers<TState, TCommands> => {\n  const latest = useRef(options);\n  latest.current = options;\n\n  const session = useResources(\n    options.storage?.session !== undefined\n      ? [withKey(\"session\", options.storage.session)]\n      : [],\n  )[0];\n  const documents = useResources(\n    options.storage?.documents === undefined\n      ? []\n      : [withKey(\"documents\", options.storage.documents)],\n  )[0];\n  const protocol: StatewireProtocol.Options = {\n    ...(options.protocol !== undefined && { protocol: options.protocol }),\n    ...(options.wireVersion !== undefined && {\n      wireVersion: options.wireVersion,\n    }),\n    ...(options.applicationProtocols !== undefined && {\n      applicationProtocols: options.applicationProtocols,\n    }),\n    ...(options.keyPrefixes !== undefined && {\n      keyPrefixes: options.keyPrefixes,\n    }),\n  };\n  const link = useMemo(\n    () => ({\n      ...(options.isNew === undefined ? {} : { isNew: options.isNew }),\n      ...(options.context === undefined ? {} : { context: options.context }),\n    }),\n    [options.isNew, options.context],\n  );\n  const value = useResource(\n    SessionTransport({\n      transport: options.transport,\n      session,\n      documents,\n      protocol,\n      link,\n    }),\n  );\n  const localContext =\n    value.connection === undefined ? value.setContext : undefined;\n  useEffect(() => {\n    const current = latest.current;\n    if (localContext === undefined || current.context === undefined) return;\n    for (const [protocol, context] of Object.entries(current.context))\n      localContext(protocol, context);\n  }, [options.context, localContext]);\n  const core = useStatewireCore(() => latest.current, value);\n  useEffect(() => core.rematerialize(), [core, options.materializeKey]);\n  const [subscribe] = useState(\n    () => (listener: () => void) =>\n      core.subscribe(() => flushTapSync(listener)),\n  );\n\n  const state = useSyncExternalStore(\n    subscribe,\n    core.getState,\n    core.getState,\n  ) as TState;\n  const isBusy = useSyncExternalStore(subscribe, core.getBusy, core.getBusy);\n  const failed = useSyncExternalStore(\n    subscribe,\n    core.getFailed,\n    core.getFailed,\n  );\n  const connection = value.connection ?? CONNECTED_CONNECTION;\n  const {\n    documents: source,\n    selection,\n    invoke: transportInvoke,\n    setContext: transportSetContext,\n    failures: transportFailures,\n  } = value;\n\n  const invoke = useCallback(\n    (protocol: string, method: string, params: readonly unknown[]) => {\n      if (!transportInvoke)\n        throw new Error(\n          \"statewire: transport does not support protocol commands\",\n        );\n      return transportInvoke(protocol, method, params);\n    },\n    [transportInvoke],\n  );\n\n  return useMemo(() => {\n    const failures = (): NonNullable<typeof transportFailures> => {\n      if (!transportFailures) {\n        throw new Error(\"statewire: this transport has no failed-send lane\");\n      }\n      return transportFailures;\n    };\n    return {\n      state,\n      documents: source,\n      selection,\n      invoke,\n      setContext: (protocol: string, value: Statewire.Context) => {\n        if (!transportSetContext)\n          throw new Error(\"statewire: transport does not support context\");\n        transportSetContext(protocol, value);\n      },\n      getState: core.getState as () => TState,\n      connection,\n      commands: core.commands as Statewire.CommandsProxy<TCommands>,\n      isBusy,\n      failed,\n      retryFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().retry(entry),\n      discardFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().discard(entry),\n    };\n  }, [\n    state,\n    isBusy,\n    failed,\n    connection,\n    core,\n    source,\n    selection,\n    invoke,\n    transportFailures,\n    transportSetContext,\n  ]);\n};\n\nexport const StatewireResource = <\n  TState,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.Options<TState, TCommands>,\n): ResourceElement<StatewireClient.Helpers<TState, TCommands>> =>\n  resource(useStatewire<TState, TCommands>)(options);\n\nexport class StatewireClient<\n  TState,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n> {\n  private readonly root;\n  private disposed = false;\n\n  constructor(options: StatewireClient.Options<TState, TCommands>) {\n    const ClientRoot = () => useStatewire<TState, TCommands>(options);\n    this.root = createTapRoot(ClientRoot);\n  }\n\n  get state(): TState {\n    return this.root.getValue().getState();\n  }\n\n  get connection(): StatewireClient.Connection {\n    return this.root.getValue().connection;\n  }\n\n  get commands(): Statewire.CommandsProxy<TCommands> {\n    return this.root.getValue().commands;\n  }\n\n  get documents(): StatewireDocuments.Source | undefined {\n    return this.root.getValue().documents;\n  }\n  get selection(): StatewireProtocol.Selection | undefined {\n    return this.root.getValue().selection;\n  }\n  invoke(\n    protocol: string,\n    method: string,\n    params: readonly unknown[],\n  ): Promise<unknown> {\n    return this.root.getValue().invoke(protocol, method, params);\n  }\n  setContext(protocol: string, value: Statewire.Context): void {\n    this.root.getValue().setContext(protocol, value);\n  }\n  get isBusy(): boolean {\n    return this.root.getValue().isBusy;\n  }\n\n  get failed(): readonly StatewireClient.FailedCommand[] {\n    return this.root.getValue().failed;\n  }\n\n  retryFailed(entry: StatewireClient.FailedCommand): Promise<unknown> {\n    return this.root.getValue().retryFailed(entry);\n  }\n\n  discardFailed(entry: StatewireClient.FailedCommand): void {\n    this.root.getValue().discardFailed(entry);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.root.subscribe(listener);\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.root.unmount();\n  }\n}\n\nexport namespace StatewireClient {\n  export type Options<\n    TState,\n    TCommands extends Statewire.Commands = Statewire.Commands,\n  > = {\n    protocol?: string;\n    context?: Readonly<Record<string, Statewire.Context>>;\n    keyPrefixes?: Readonly<Record<string, readonly string[]>>;\n    wireVersion?: StatewireProtocol.Range;\n    applicationProtocols?: readonly StatewireProtocol.Offer[] | \"*\";\n    transport: ResourceElement<Statewire<TState, TCommands>>;\n    /** The session does not exist on the server yet: the transport's first attach waits for the first command send; the transport's own `isNew` wins. */\n    isNew?: boolean;\n    /** Durable session: the mounted storage holds this client's lane identity and its un-durable commands, which resend on the next attach. */\n    storage?:\n      | {\n          session?: ResourceElement<SessionStorage> | undefined;\n          documents?: ResourceElement<StatewireDocuments.Storage> | undefined;\n        }\n      | undefined;\n    /** Served as the canonical state until the attach snapshot; own commands fold over it. */\n    initialState?: TState;\n    optimistic?: Optimistic<NonNullable<TState>, TCommands>;\n    materialize?: Materialize<NonNullable<TState>>;\n    /** Republishes through `materialize` when it changes (`Object.is`); `materialize` itself is read fresh on every publish. */\n    materializeKey?: unknown;\n    onStateChange?: (\n      state: NonNullable<TState>,\n      ctx: { changes: Statewire.Changes },\n    ) => void;\n    onCommandChange?: (\n      update: Statewire.CommandUpdate<TCommands>,\n      ctx: { state: NonNullable<TState> },\n    ) => void;\n    onConnectionChange?: (connection: Connection) => void;\n    onError?: (error: ConnectionError) => void;\n    /** Drops a retained failed entry once a canonical snapshot shows its effect landed; checked against each new snapshot. */\n    failureCovered?: (\n      state: NonNullable<TState>,\n      entry: FailedCommand,\n    ) => boolean;\n  };\n\n  export type Helpers<\n    TState,\n    TCommands extends Statewire.Commands = Statewire.Commands,\n  > = {\n    /** The statewire's state type — remote statewires include `undefined` until the first attach snapshot applies. */\n    state: TState;\n    documents: StatewireDocuments.Source | undefined;\n    selection: StatewireProtocol.Selection | undefined;\n    setContext: (protocol: string, value: Statewire.Context) => void;\n    invoke: (\n      protocol: string,\n      method: string,\n      params: readonly unknown[],\n    ) => Promise<unknown>;\n    /** Identity-stable across renders; reads the current canonical state without subscribing the caller. */\n    getState: () => TState;\n    connection: Connection;\n    commands: Statewire.CommandsProxy<TCommands>;\n    /** Negation of the server's broadcast idle level (a transport without idle is always busy). */\n    isBusy: boolean;\n    /** Non-accepted sends retained in the session record; reload with it. */\n    failed: readonly FailedCommand[];\n    /** Re-enqueues the entry's command on fresh clocks and removes the entry. */\n    retryFailed: (entry: FailedCommand) => Promise<unknown>;\n    /** Removes the entry. */\n    discardFailed: (entry: FailedCommand) => void;\n  };\n\n  /** Connection lifecycle and whether its current state warrants a problem indicator. */\n  export type ConnectionState =\n    | { status: \"standby\"; reason: \"deferred\" | \"idle\"; degraded: false }\n    | { status: \"connecting\"; degraded: false }\n    | { status: \"connected\"; degraded: false }\n    | {\n        status: \"retrying\";\n        degraded: true;\n        attempt: number;\n        /** Backoff details are absent while the retry dial is in flight. */\n        cause?: \"dropped\" | \"reconnect\" | \"error\" | \"unauthorized\";\n        code?: string;\n        nextRetryAt?: number;\n        lastError?: string;\n        message?: string;\n      }\n    | {\n        status: \"stopped\";\n        degraded: true;\n        reason:\n          | \"gone\"\n          | \"forbidden\"\n          | \"protocol-error\"\n          | \"unauthorized\"\n          | \"storage-error\";\n        message?: string;\n        payload?: unknown;\n      };\n  export type Connection = ConnectionState & {\n    error?: ConnectionError;\n    reconnect: () => void;\n  };\n  export type ConnectionStatus = Connection[\"status\"];\n\n  /**\n   * Mutate the draft in place; the client records the next state plus the exact\n   * changed paths. Re-run against the new base on every rebase.\n   */\n  export type Optimistic<\n    TState,\n    TCommands extends Statewire.Commands = Statewire.Commands,\n  > = (\n    draft: TState,\n    command: Statewire.Command<TCommands>,\n    ctx: OptimisticContext,\n  ) => void;\n\n  export type OptimisticContext = {\n    ts: number;\n    seq: number;\n    clientId?: string;\n  };\n\n  /**\n   * Mutate the draft to fold client-known facts into the state: server-accepted,\n   * still-uncommitted intents (e.g. dispatch records into messages) or the live\n   * state of a sibling statewire. Runs after the optimistic folds on every\n   * published state; `materializeKey` republishes when the facts change.\n   */\n  export type Materialize<TState> = (draft: TState) => void;\n\n  /**\n   * fate: \"aborted\" = never sent, \"rejected\" = the server refused it\n   * (`code` \"unknown-command\" | \"invalid-params\" for the static rejects,\n   * code-less for handler rejects), \"lost\" = sent but no verdict will ever\n   * arrive — the record is gone (a proven seq gap) or the channel died: it\n   * may or may not have run, \"failed\" = the handler ran and threw,\n   * \"crashed\" = the handler died involuntarily, \"expired\" = settled —\n   * result, rejected, failed, or crashed — but the verdict outlived the\n   * server's retention.\n   * cause is which channel settled it: \"server\" = the server's answer;\n   * the rest are channel deaths the client settled locally.\n   */\n  export type SendFailure =\n    | {\n        fate: \"rejected\";\n        cause: \"server\";\n        code?: string;\n        message?: string;\n        payload?: unknown;\n      }\n    | { fate: \"failed\"; cause: \"server\"; message?: string }\n    | { fate: \"crashed\"; cause: \"server\" }\n    | { fate: \"expired\"; cause: \"server\" }\n    | {\n        fate: \"aborted\";\n        cause: \"unmount\" | \"stream-gone\" | \"session-lost\";\n        predecessorLost?: true;\n      }\n    | {\n        fate: \"lost\";\n        cause: \"unmount\" | \"stream-gone\" | \"session-lost\";\n      };\n\n  /** Held commands a proven record gap settled `{fate: \"lost\", cause: \"session-lost\"}`; return \"requeue\" to re-enqueue them on the reset clocks. */\n  export type OnSessionLost = (\n    pending: ReadonlyArray<{\n      method: string;\n      params: readonly unknown[];\n      ts: number;\n      seq: number;\n      clientId?: string;\n    }>,\n  ) => \"requeue\" | \"drop\";\n\n  /** A non-accepted send retained for the user: the wire statement, its failure, and its original clocks. */\n  export type FailedCommand = {\n    readonly protocol: string;\n    readonly produced?: SessionCommand[\"produced\"];\n    readonly command: string;\n    readonly params: readonly unknown[];\n    readonly meta?: unknown;\n    readonly failure: SendFailure;\n    readonly ts: number;\n    readonly seq: number;\n  };\n\n  /** A command as persisted while un-durable: its lane seq plus the wire statement. */\n  export type SessionCommand = {\n    seq: number;\n    produced?: {\n      wire: StatewireProtocol.Range;\n      protocols: readonly StatewireProtocol.Offer[] | \"*\";\n    };\n    method: string;\n    params: unknown[];\n    meta?: unknown;\n  };\n\n  /** A durable lane: its cmd clock and the commands the server has not marked durable. */\n  export type SessionLane = {\n    nextSeq: number;\n    commands: readonly SessionCommand[];\n    /** Terminal verdicts parked for the sharer that minted the seq (shared storage only). */\n    verdicts?: readonly SessionVerdict[];\n    /** Non-accepted sends retained for the user; survive record rebases and resets. */\n    failed?: readonly FailedCommand[];\n  };\n\n  /** The persisted session: the client identity plus one lane per durable protocol. */\n  export type SessionRecord = {\n    clientId: string;\n    lanes: Readonly<Record<string, SessionLane>>;\n  };\n\n  /** A terminal verdict one sharer's connection carried, parked for the sharer awaiting the seq. */\n  export type SessionVerdict = {\n    seq: number;\n    type: (typeof TERMINAL)[number];\n    code?: string;\n    message?: string;\n    payload?: unknown;\n    meta?: unknown;\n  };\n\n  /** Session storage seam with optional asynchronous hydration and persistence. */\n  export type SessionStorage = {\n    /** Resolves when a synchronous load can return the hydrated record. */\n    ready?: Promise<void>;\n    /** Resolves after all queued saves are persisted; awaited before sending statements. */\n    flush?: () => void | Promise<void>;\n    load: () => SessionRecord | null;\n    save: (record: SessionRecord) => void;\n    /** Upgrade incompatible stored commands; null discards the old record and starts a new client identity. */\n    migrate?: (\n      record: SessionRecord,\n      current: NonNullable<SessionCommand[\"produced\"]>,\n    ) => SessionRecord | null;\n    /** Serializes record mutations across sharers; presence marks the storage shared. */\n    lock?: <T>(fn: () => T | Promise<T>) => Promise<T>;\n    /** Notifies of record saves by other sharers; returns unsubscribe. Required alongside `lock`. */\n    subscribe?: (listener: () => void) => () => void;\n  };\n\n  /** Static headers, or a resolver invoked per request/attach; `staleAuth` is true right after an auth rejection. */\n  export type ConnectionError = Error & { fin?: StatewireHost.Fin };\n\n  export type HeadersOption =\n    | HeadersInit\n    | ((ctx: { staleAuth: boolean }) => HeadersInit | Promise<HeadersInit>);\n\n  export type HttpOptions = StatewireProtocol.Options & {\n    sessionStore?: SessionStorage | undefined;\n    url: string;\n    /** The session does not exist on the server yet: the first attach waits for the first command send (or an explicit `reconnect()`). */\n    isNew?: boolean;\n    headers?: HeadersOption;\n    fetch?: typeof globalThis.fetch;\n    onSessionLost?: OnSessionLost;\n    onChange?: (connection: Connection) => void;\n    onError?: (error: ConnectionError) => void;\n    /** The broadcast idle flag's rising edge: the instance went quiet. */\n    onDone?: () => void;\n  };\n\n  export type WebsocketOptions = StatewireProtocol.Options & {\n    sessionStore?: SessionStorage | undefined;\n    url: string;\n    /** The session does not exist on the server yet: the first attach waits for the first command send (or an explicit `reconnect()`). */\n    isNew?: boolean;\n    headers?: HeadersOption;\n    protocols?: string | string[];\n    query?:\n      | Record<string, string>\n      | (() => Record<string, string> | Promise<Record<string, string>>);\n    webSocket?: new (url: string, protocols?: string | string[]) => WebSocket;\n    onSessionLost?: OnSessionLost;\n    onChange?: (connection: Connection) => void;\n    onError?: (error: ConnectionError) => void;\n    /** The broadcast idle flag's rising edge: the instance went quiet. */\n    onDone?: () => void;\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"statewire.js","names":["StatewireDocuments","StatewireProtocol","StatewireHost","useCallback","useEffect","useMemo","useRef","useState","useSyncExternalStore","createTapRoot","flushTapSync","resource","useContextProvider","useResource","useResources","withKey","ResourceElement","CONNECTED_CONNECTION","useStatewireCore","Statewire","TERMINAL","DocumentStorageContext","LinkContext","ProtocolContext","SessionStorageContext","useSessionTransport","transport","session","documents","protocol","link","StatewireClient","SessionStorage","Storage","Options","isNew","context","Readonly","Record","Context","SessionTransport","useStatewire","Commands","options","TState","TCommands","Helpers","latest","current","storage","undefined","wireVersion","applicationProtocols","keyPrefixes","value","localContext","connection","setContext","Object","entries","core","rematerialize","materializeKey","subscribe","listener","state","getState","isBusy","getBusy","failed","getFailed","source","selection","invoke","transportInvoke","transportSetContext","failures","transportFailures","method","params","Error","NonNullable","commands","CommandsProxy","retryFailed","entry","FailedCommand","retry","discardFailed","discard","StatewireResource","root","disposed","constructor","ClientRoot","getValue","Connection","Source","Selection","Promise","dispose","unmount","Range","Offer","initialState","optimistic","Optimistic","materialize","Materialize","onStateChange","ctx","changes","Changes","onCommandChange","update","CommandUpdate","onConnectionChange","onError","error","ConnectionError","failureCovered","ConnectionState","status","reason","degraded","attempt","cause","code","nextRetryAt","lastError","message","payload","reconnect","ConnectionStatus","draft","command","Command","OptimisticContext","ts","seq","clientId","SendFailure","fate","predecessorLost","OnSessionLost","pending","ReadonlyArray","produced","SessionCommand","meta","failure","wire","protocols","SessionLane","nextSeq","verdicts","SessionVerdict","SessionRecord","lanes","type","ready","flush","load","save","record","migrate","lock","fn","T","fin","Fin","HeadersOption","HeadersInit","staleAuth","HttpOptions","sessionStore","url","headers","fetch","globalThis","onSessionLost","onChange","onDone","WebsocketOptions","query","webSocket","WebSocket"],"sources":["../src/statewire.ts"],"sourcesContent":["import type { StatewireDocuments } from \"./wire/documents\";\nimport type { StatewireProtocol } from \"./wire/protocol\";\nimport type { StatewireHost } from \"./host\";\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\nimport {\n  createTapRoot,\n  flushTapSync,\n  resource,\n  useContextProvider,\n  useResource,\n  useResources,\n  withKey,\n} from \"@assistant-ui/tap\";\nimport type { ResourceElement } from \"@assistant-ui/tap\";\nimport { CONNECTED_CONNECTION, useStatewireCore } from \"./client/core\";\nimport type { Statewire } from \"./types\";\nimport type { TERMINAL } from \"./client/connection\";\nimport {\n  DocumentStorageContext,\n  LinkContext,\n  ProtocolContext,\n  SessionStorageContext,\n} from \"./client/sessionStore\";\n\nconst useSessionTransport = ({\n  transport,\n  session,\n  documents,\n  protocol,\n  link,\n}: {\n  transport: ResourceElement<Statewire<any, any>>;\n  session: StatewireClient.SessionStorage | undefined;\n  documents: StatewireDocuments.Storage | undefined;\n  protocol: StatewireProtocol.Options;\n  link: {\n    isNew?: boolean | undefined;\n    context?: Readonly<Record<string, Statewire.Context>> | undefined;\n  };\n}): Statewire<unknown> =>\n  useContextProvider(SessionStorageContext, session, () =>\n    // oxlint-disable-next-line react-hooks/rules-of-hooks\n    useContextProvider(DocumentStorageContext, documents, () =>\n      // oxlint-disable-next-line react-hooks/rules-of-hooks\n      useContextProvider(ProtocolContext, protocol, () =>\n        // oxlint-disable-next-line react-hooks/rules-of-hooks\n        useContextProvider(LinkContext, link, () =>\n          // oxlint-disable-next-line react-hooks/rules-of-hooks\n          useResource(transport),\n        ),\n      ),\n    ),\n  );\n\n// The transport owns the session; it reads the storage off the context this\n// wrapper's own fiber provides, so plain-React callers get a provider too.\nconst SessionTransport = resource(useSessionTransport);\n\nexport const useStatewire = <\n  TState,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.Options<TState, TCommands>,\n): StatewireClient.Helpers<TState, TCommands> => {\n  const latest = useRef(options);\n  latest.current = options;\n\n  const session = useResources(\n    options.storage?.session !== undefined\n      ? [withKey(\"session\", options.storage.session)]\n      : [],\n  )[0];\n  const documents = useResources(\n    options.storage?.documents === undefined\n      ? []\n      : [withKey(\"documents\", options.storage.documents)],\n  )[0];\n  const protocol: StatewireProtocol.Options = {\n    ...(options.protocol !== undefined && { protocol: options.protocol }),\n    ...(options.wireVersion !== undefined && {\n      wireVersion: options.wireVersion,\n    }),\n    ...(options.applicationProtocols !== undefined && {\n      applicationProtocols: options.applicationProtocols,\n    }),\n    ...(options.keyPrefixes !== undefined && {\n      keyPrefixes: options.keyPrefixes,\n    }),\n  };\n  const link = useMemo(\n    () => ({\n      ...(options.isNew === undefined ? {} : { isNew: options.isNew }),\n      ...(options.context === undefined ? {} : { context: options.context }),\n    }),\n    [options.isNew, options.context],\n  );\n  const value = useResource(\n    SessionTransport({\n      transport: options.transport,\n      session,\n      documents,\n      protocol,\n      link,\n    }),\n  );\n  const localContext =\n    value.connection === undefined ? value.setContext : undefined;\n  useEffect(() => {\n    const current = latest.current;\n    if (localContext === undefined || current.context === undefined) return;\n    for (const [protocol, context] of Object.entries(current.context))\n      localContext(protocol, context);\n  }, [options.context, localContext]);\n  const core = useStatewireCore(() => latest.current, value);\n  useEffect(() => core.rematerialize(), [core, options.materializeKey]);\n  const [subscribe] = useState(\n    () => (listener: () => void) =>\n      core.subscribe(() => flushTapSync(listener)),\n  );\n\n  const state = useSyncExternalStore(\n    subscribe,\n    core.getState,\n    core.getState,\n  ) as TState;\n  const isBusy = useSyncExternalStore(subscribe, core.getBusy, core.getBusy);\n  const failed = useSyncExternalStore(\n    subscribe,\n    core.getFailed,\n    core.getFailed,\n  );\n  const connection = value.connection ?? CONNECTED_CONNECTION;\n  const {\n    documents: source,\n    selection,\n    invoke: transportInvoke,\n    setContext: transportSetContext,\n    failures: transportFailures,\n  } = value;\n\n  const invoke = useCallback(\n    (protocol: string, method: string, params: readonly unknown[]) => {\n      if (!transportInvoke)\n        throw new Error(\n          \"statewire: transport does not support protocol commands\",\n        );\n      return transportInvoke(protocol, method, params);\n    },\n    [transportInvoke],\n  );\n\n  const setContext = useCallback(\n    (protocol: string, value: Statewire.Context) => {\n      if (!transportSetContext)\n        throw new Error(\"statewire: transport does not support context\");\n      transportSetContext(protocol, value);\n    },\n    [transportSetContext],\n  );\n\n  return useMemo(() => {\n    const failures = (): NonNullable<typeof transportFailures> => {\n      if (!transportFailures) {\n        throw new Error(\"statewire: this transport has no failed-send lane\");\n      }\n      return transportFailures;\n    };\n    return {\n      state,\n      documents: source,\n      selection,\n      invoke,\n      setContext,\n      getState: core.getState as () => TState,\n      connection,\n      commands: core.commands as Statewire.CommandsProxy<TCommands>,\n      isBusy,\n      failed,\n      retryFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().retry(entry),\n      discardFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().discard(entry),\n    };\n  }, [\n    state,\n    isBusy,\n    failed,\n    connection,\n    core,\n    source,\n    selection,\n    invoke,\n    transportFailures,\n    setContext,\n  ]);\n};\n\nexport const StatewireResource = <\n  TState,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n>(\n  options: StatewireClient.Options<TState, TCommands>,\n): ResourceElement<StatewireClient.Helpers<TState, TCommands>> =>\n  resource(useStatewire<TState, TCommands>)(options);\n\nexport class StatewireClient<\n  TState,\n  TCommands extends Statewire.Commands = Statewire.Commands,\n> {\n  private readonly root;\n  private disposed = false;\n\n  constructor(options: StatewireClient.Options<TState, TCommands>) {\n    const ClientRoot = () => useStatewire<TState, TCommands>(options);\n    this.root = createTapRoot(ClientRoot);\n  }\n\n  get state(): TState {\n    return this.root.getValue().getState();\n  }\n\n  get connection(): StatewireClient.Connection {\n    return this.root.getValue().connection;\n  }\n\n  get commands(): Statewire.CommandsProxy<TCommands> {\n    return this.root.getValue().commands;\n  }\n\n  get documents(): StatewireDocuments.Source | undefined {\n    return this.root.getValue().documents;\n  }\n  get selection(): StatewireProtocol.Selection | undefined {\n    return this.root.getValue().selection;\n  }\n  invoke(\n    protocol: string,\n    method: string,\n    params: readonly unknown[],\n  ): Promise<unknown> {\n    return this.root.getValue().invoke(protocol, method, params);\n  }\n  setContext(protocol: string, value: Statewire.Context): void {\n    this.root.getValue().setContext(protocol, value);\n  }\n  get isBusy(): boolean {\n    return this.root.getValue().isBusy;\n  }\n\n  get failed(): readonly StatewireClient.FailedCommand[] {\n    return this.root.getValue().failed;\n  }\n\n  retryFailed(entry: StatewireClient.FailedCommand): Promise<unknown> {\n    return this.root.getValue().retryFailed(entry);\n  }\n\n  discardFailed(entry: StatewireClient.FailedCommand): void {\n    this.root.getValue().discardFailed(entry);\n  }\n\n  subscribe(listener: () => void): () => void {\n    return this.root.subscribe(listener);\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.root.unmount();\n  }\n}\n\nexport namespace StatewireClient {\n  export type Options<\n    TState,\n    TCommands extends Statewire.Commands = Statewire.Commands,\n  > = {\n    protocol?: string;\n    context?: Readonly<Record<string, Statewire.Context>>;\n    keyPrefixes?: Readonly<Record<string, readonly string[]>>;\n    wireVersion?: StatewireProtocol.Range;\n    applicationProtocols?: readonly StatewireProtocol.Offer[] | \"*\";\n    transport: ResourceElement<Statewire<TState, TCommands>>;\n    /** The session does not exist on the server yet: the transport's first attach waits for the first command send; the transport's own `isNew` wins. */\n    isNew?: boolean;\n    /** Durable session: the mounted storage holds this client's lane identity and its un-durable commands, which resend on the next attach. */\n    storage?:\n      | {\n          session?: ResourceElement<SessionStorage> | undefined;\n          documents?: ResourceElement<StatewireDocuments.Storage> | undefined;\n        }\n      | undefined;\n    /** Served as the canonical state until the attach snapshot; own commands fold over it. */\n    initialState?: TState;\n    optimistic?: Optimistic<NonNullable<TState>, TCommands>;\n    materialize?: Materialize<NonNullable<TState>>;\n    /** Republishes through `materialize` when it changes (`Object.is`); `materialize` itself is read fresh on every publish. */\n    materializeKey?: unknown;\n    onStateChange?: (\n      state: NonNullable<TState>,\n      ctx: { changes: Statewire.Changes },\n    ) => void;\n    onCommandChange?: (\n      update: Statewire.CommandUpdate<TCommands>,\n      ctx: { state: NonNullable<TState> },\n    ) => void;\n    onConnectionChange?: (connection: Connection) => void;\n    onError?: (error: ConnectionError) => void;\n    /** Drops a retained failed entry once a canonical snapshot shows its effect landed; checked against each new snapshot. */\n    failureCovered?: (\n      state: NonNullable<TState>,\n      entry: FailedCommand,\n    ) => boolean;\n  };\n\n  export type Helpers<\n    TState,\n    TCommands extends Statewire.Commands = Statewire.Commands,\n  > = {\n    /** The statewire's state type — remote statewires include `undefined` until the first attach snapshot applies. */\n    state: TState;\n    documents: StatewireDocuments.Source | undefined;\n    selection: StatewireProtocol.Selection | undefined;\n    setContext: (protocol: string, value: Statewire.Context) => void;\n    invoke: (\n      protocol: string,\n      method: string,\n      params: readonly unknown[],\n    ) => Promise<unknown>;\n    /** Identity-stable across renders; reads the current canonical state without subscribing the caller. */\n    getState: () => TState;\n    connection: Connection;\n    commands: Statewire.CommandsProxy<TCommands>;\n    /** Negation of the server's broadcast idle level (a transport without idle is always busy). */\n    isBusy: boolean;\n    /** Non-accepted sends retained in the session record; reload with it. */\n    failed: readonly FailedCommand[];\n    /** Re-enqueues the entry's command on fresh clocks and removes the entry. */\n    retryFailed: (entry: FailedCommand) => Promise<unknown>;\n    /** Removes the entry. */\n    discardFailed: (entry: FailedCommand) => void;\n  };\n\n  /** Connection lifecycle and whether its current state warrants a problem indicator. */\n  export type ConnectionState =\n    | { status: \"standby\"; reason: \"deferred\" | \"idle\"; degraded: false }\n    | { status: \"connecting\"; degraded: false }\n    | { status: \"connected\"; degraded: false }\n    | {\n        status: \"retrying\";\n        degraded: true;\n        attempt: number;\n        /** Backoff details are absent while the retry dial is in flight. */\n        cause?: \"dropped\" | \"reconnect\" | \"error\" | \"unauthorized\";\n        code?: string;\n        nextRetryAt?: number;\n        lastError?: string;\n        message?: string;\n      }\n    | {\n        status: \"stopped\";\n        degraded: true;\n        reason:\n          | \"gone\"\n          | \"forbidden\"\n          | \"protocol-error\"\n          | \"unauthorized\"\n          | \"storage-error\";\n        message?: string;\n        payload?: unknown;\n      };\n  export type Connection = ConnectionState & {\n    error?: ConnectionError;\n    reconnect: () => void;\n  };\n  export type ConnectionStatus = Connection[\"status\"];\n\n  /**\n   * Mutate the draft in place; the client records the next state plus the exact\n   * changed paths. Re-run against the new base on every rebase.\n   */\n  export type Optimistic<\n    TState,\n    TCommands extends Statewire.Commands = Statewire.Commands,\n  > = (\n    draft: TState,\n    command: Statewire.Command<TCommands>,\n    ctx: OptimisticContext,\n  ) => void;\n\n  export type OptimisticContext = {\n    ts: number;\n    seq: number;\n    clientId?: string;\n  };\n\n  /**\n   * Mutate the draft to fold client-known facts into the state: server-accepted,\n   * still-uncommitted intents (e.g. dispatch records into messages) or the live\n   * state of a sibling statewire. Runs after the optimistic folds on every\n   * published state; `materializeKey` republishes when the facts change.\n   */\n  export type Materialize<TState> = (draft: TState) => void;\n\n  /**\n   * fate: \"aborted\" = never sent, \"rejected\" = the server refused it\n   * (`code` \"unknown-command\" | \"invalid-params\" for the static rejects,\n   * code-less for handler rejects), \"lost\" = sent but no verdict will ever\n   * arrive — the record is gone (a proven seq gap) or the channel died: it\n   * may or may not have run, \"failed\" = the handler ran and threw,\n   * \"crashed\" = the handler died involuntarily, \"expired\" = settled —\n   * result, rejected, failed, or crashed — but the verdict outlived the\n   * server's retention.\n   * cause is which channel settled it: \"server\" = the server's answer;\n   * the rest are channel deaths the client settled locally.\n   */\n  export type SendFailure =\n    | {\n        fate: \"rejected\";\n        cause: \"server\";\n        code?: string;\n        message?: string;\n        payload?: unknown;\n      }\n    | { fate: \"failed\"; cause: \"server\"; message?: string }\n    | { fate: \"crashed\"; cause: \"server\" }\n    | { fate: \"expired\"; cause: \"server\" }\n    | {\n        fate: \"aborted\";\n        cause: \"unmount\" | \"stream-gone\" | \"session-lost\";\n        predecessorLost?: true;\n      }\n    | {\n        fate: \"lost\";\n        cause: \"unmount\" | \"stream-gone\" | \"session-lost\";\n      };\n\n  /** Held commands a proven record gap settled `{fate: \"lost\", cause: \"session-lost\"}`; return \"requeue\" to re-enqueue them on the reset clocks. */\n  export type OnSessionLost = (\n    pending: ReadonlyArray<{\n      method: string;\n      params: readonly unknown[];\n      ts: number;\n      seq: number;\n      clientId?: string;\n    }>,\n  ) => \"requeue\" | \"drop\";\n\n  /** A non-accepted send retained for the user: the wire statement, its failure, and its original clocks. */\n  export type FailedCommand = {\n    readonly protocol: string;\n    readonly produced?: SessionCommand[\"produced\"];\n    readonly command: string;\n    readonly params: readonly unknown[];\n    readonly meta?: unknown;\n    readonly failure: SendFailure;\n    readonly ts: number;\n    readonly seq: number;\n  };\n\n  /** A command as persisted while un-durable: its lane seq plus the wire statement. */\n  export type SessionCommand = {\n    seq: number;\n    produced?: {\n      wire: StatewireProtocol.Range;\n      protocols: readonly StatewireProtocol.Offer[] | \"*\";\n    };\n    method: string;\n    params: unknown[];\n    meta?: unknown;\n  };\n\n  /** A durable lane: its cmd clock and the commands the server has not marked durable. */\n  export type SessionLane = {\n    nextSeq: number;\n    commands: readonly SessionCommand[];\n    /** Terminal verdicts parked for the sharer that minted the seq (shared storage only). */\n    verdicts?: readonly SessionVerdict[];\n    /** Non-accepted sends retained for the user; survive record rebases and resets. */\n    failed?: readonly FailedCommand[];\n  };\n\n  /** The persisted session: the client identity plus one lane per durable protocol. */\n  export type SessionRecord = {\n    clientId: string;\n    lanes: Readonly<Record<string, SessionLane>>;\n  };\n\n  /** A terminal verdict one sharer's connection carried, parked for the sharer awaiting the seq. */\n  export type SessionVerdict = {\n    seq: number;\n    type: (typeof TERMINAL)[number];\n    code?: string;\n    message?: string;\n    payload?: unknown;\n    meta?: unknown;\n  };\n\n  /** Session storage seam with optional asynchronous hydration and persistence. */\n  export type SessionStorage = {\n    /** Resolves when a synchronous load can return the hydrated record. */\n    ready?: Promise<void>;\n    /** Resolves after all queued saves are persisted; awaited before sending statements. */\n    flush?: () => void | Promise<void>;\n    load: () => SessionRecord | null;\n    save: (record: SessionRecord) => void;\n    /** Upgrade incompatible stored commands; null discards the old record and starts a new client identity. */\n    migrate?: (\n      record: SessionRecord,\n      current: NonNullable<SessionCommand[\"produced\"]>,\n    ) => SessionRecord | null;\n    /** Serializes record mutations across sharers; presence marks the storage shared. */\n    lock?: <T>(fn: () => T | Promise<T>) => Promise<T>;\n    /** Notifies of record saves by other sharers; returns unsubscribe. Required alongside `lock`. */\n    subscribe?: (listener: () => void) => () => void;\n  };\n\n  /** Static headers, or a resolver invoked per request/attach; `staleAuth` is true right after an auth rejection. */\n  export type ConnectionError = Error & { fin?: StatewireHost.Fin };\n\n  export type HeadersOption =\n    | HeadersInit\n    | ((ctx: { staleAuth: boolean }) => HeadersInit | Promise<HeadersInit>);\n\n  export type HttpOptions = StatewireProtocol.Options & {\n    sessionStore?: SessionStorage | undefined;\n    url: string;\n    /** The session does not exist on the server yet: the first attach waits for the first command send (or an explicit `reconnect()`). */\n    isNew?: boolean;\n    headers?: HeadersOption;\n    fetch?: typeof globalThis.fetch;\n    onSessionLost?: OnSessionLost;\n    onChange?: (connection: Connection) => void;\n    onError?: (error: ConnectionError) => void;\n    /** The broadcast idle flag's rising edge: the instance went quiet. */\n    onDone?: () => void;\n  };\n\n  export type WebsocketOptions = StatewireProtocol.Options & {\n    sessionStore?: SessionStorage | undefined;\n    url: string;\n    /** The session does not exist on the server yet: the first attach waits for the first command send (or an explicit `reconnect()`). */\n    isNew?: boolean;\n    headers?: HeadersOption;\n    protocols?: string | string[];\n    query?:\n      | Record<string, string>\n      | (() => Record<string, string> | Promise<Record<string, string>>);\n    webSocket?: new (url: string, protocols?: string | string[]) => WebSocket;\n    onSessionLost?: OnSessionLost;\n    onChange?: (connection: Connection) => void;\n    onError?: (error: ConnectionError) => void;\n    /** The broadcast idle flag's rising edge: the instance went quiet. */\n    onDone?: () => void;\n  };\n}\n"],"mappings":"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"}

package/dist/storage.d.ts

@@ -1,30 +1,27 @@
-import { StatewireClient } from "./statewire.js";
-//#region src/storage.d.ts
+import type { StatewireClient } from "./statewire.js";
 /** Persist sessions through a synchronous or asynchronous string storage backend. */
-declare const KeyValueSessionStorage: import("@assistant-ui/tap").Resource<StatewireClient.SessionStorage, [options: KeyValueSessionStorage.Options]>;
-declare namespace KeyValueSessionStorage {
-  type Backend = {
-    getItem: (key: string) => string | null | Promise<string | null>;
-    setItem: (key: string, value: string) => void | Promise<void>;
-    removeItem: (key: string) => void | Promise<void>;
-    getAllKeys?: () => readonly string[] | Promise<readonly string[]>;
-    /** Runs cleanup under exclusive access, skipping keys in use by another runtime. */
-    withUnused?: (key: string, action: () => Promise<void>) => Promise<void>;
-  };
-  type Options = {
-    backend: Backend;
-    key: string;
-    namespace?: string;
-    /** The lane that sessions saved in a single-lane format lift into; defaults to the client's default protocol. */
-    protocol?: string;
-    migrate?: StatewireClient.SessionStorage["migrate"];
-    retention?: {
-      maxAgeMs?: number;
-      maxEntries?: number;
+export declare const KeyValueSessionStorage: import("@assistant-ui/tap").Resource<StatewireClient.SessionStorage, [options: KeyValueSessionStorage.Options]>;
+export declare namespace KeyValueSessionStorage {
+    type Backend = {
+        getItem: (key: string) => string | null | Promise<string | null>;
+        setItem: (key: string, value: string) => void | Promise<void>;
+        removeItem: (key: string) => void | Promise<void>;
+        getAllKeys?: () => readonly string[] | Promise<readonly string[]>;
+        /** Runs cleanup under exclusive access, skipping keys in use by another runtime. */
+        withUnused?: (key: string, action: () => Promise<void>) => Promise<void>;
+    };
+    type Options = {
+        backend: Backend;
+        key: string;
+        namespace?: string;
+        /** The lane that sessions saved in a single-lane format lift into; defaults to the client's default protocol. */
+        protocol?: string;
+        migrate?: StatewireClient.SessionStorage["migrate"];
+        retention?: {
+            maxAgeMs?: number;
+            maxEntries?: number;
+        };
+        onError?: (error: unknown) => void;
     };
-    onError?: (error: unknown) => void;
-  };
 }
-//#endregion
-export { KeyValueSessionStorage };
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","names":[],"sources":["../src/storage.ts"],"mappings":";;;cAggBa,oDAAsB,SAAA,gBAAA,iBAAA,SAAA,uBAAA;kBAElB;OACH;IACV,UAAU,gCAAgC;IAC1C,UAAU,aAAa,yBAAyB;IAChD,aAAa,uBAAuB;IACpC,uCAAuC;;IAEvC,cAAc,aAAa,cAAc,kBAAkB;;OAEjD;IACV,SAAS;IACT;IACA;;IAEA;IACA,UAAU,gBAAgB;IAC1B;MAAc;MAAmB;;IACjC,WAAW"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAoB;AA4fnD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,iHAAsC,CAAC;AAE1E,yBAAiB,sBAAsB,CAAC;IACtC,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,UAAU,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;QAClE,oFAAoF;QACpF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1E,CAAC;IACF,KAAY,OAAO,GAAG;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iHAAiH;QACjH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACpD,SAAS,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KACpC,CAAC;CACH"}

package/dist/storage.js

@@ -2,7 +2,7 @@ import { DEFAULT_PROTOCOL, negotiationHeaders, protocolToken } from "./wire/prot
 import { wrapStorageError } from "./client/storageError.js";
 import { useEffect, useMemo, useRef } from "@assistant-ui/tap/react-shim";
 import { resource } from "@assistant-ui/tap";
-//#region src/storage.ts
+// src/storage.ts
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isOptionalString = (value) => value === void 0 || typeof value === "string";
 const isPositiveSafeInteger = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0;
@@ -330,7 +330,6 @@ const useKeyValueSessionStorage = (options) => {
 };
 /** Persist sessions through a synchronous or asynchronous string storage backend. */
 const KeyValueSessionStorage = resource(useKeyValueSessionStorage);
-//#endregion
 export { KeyValueSessionStorage };
 
 //# sourceMappingURL=storage.js.map

package/dist/transports/fake-sse.d.ts

@@ -1,12 +1,9 @@
-import { StatewireEnvelope } from "../client/connection.js";
-//#region src/transports/fake-sse.d.ts
-type FakeStreamHandle = {
-  clientId: string;
-  send: (text: string) => void;
-  close: () => void;
+import type { StatewireEnvelope } from "../client/connection.js";
+export type FakeStreamHandle = {
+    clientId: string;
+    send: (text: string) => void;
+    close: () => void;
 };
-declare const sseFrame: (envelope: StatewireEnvelope) => string;
-declare const openSSEStream: (streams: Set<FakeStreamHandle>, clientId: string, onOpen: (handle: FakeStreamHandle) => void, signal?: AbortSignal, headers?: Record<string, string>) => Response;
-//#endregion
-export { FakeStreamHandle, openSSEStream, sseFrame };
+export declare const sseFrame: (envelope: StatewireEnvelope) => string;
+export declare const openSSEStream: (streams: Set<FakeStreamHandle>, clientId: string, onOpen: (handle: FakeStreamHandle) => void, signal?: AbortSignal, headers?: Record<string, string>) => Response;
 //# sourceMappingURL=fake-sse.d.ts.map

package/dist/transports/fake-sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake-sse.d.ts","names":[],"sources":["../../src/transports/fake-sse.ts"],"mappings":";;KAEY;EACV;EACA,OAAO;EACP;;cAGW,WAAY,UAAU;cAGtB,gBACX,SAAS,IAAI,mBACb,kBACA,SAAS,QAAQ,2BACjB,SAAS,aACT,UAAU,2BACT"}
+{"version":3,"file":"fake-sse.d.ts","sourceRoot":"","sources":["../../src/transports/fake-sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gCAA6B;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,UAAU,iBAAiB,WACX,CAAC;AAE1C,eAAO,MAAM,aAAa,GACxB,SAAS,GAAG,CAAC,gBAAgB,CAAC,EAC9B,UAAU,MAAM,EAChB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,EAC1C,SAAS,WAAW,EACpB,UAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC/B,QAkCF,CAAC"}

package/dist/transports/fake-sse.js

@@ -1,4 +1,4 @@
-//#region src/transports/fake-sse.ts
+// src/transports/fake-sse.ts
 const sseFrame = (envelope) => `data: ${JSON.stringify(envelope)}\n\n`;
 const openSSEStream = (streams, clientId, onOpen, signal, headers) => {
 	const encoder = new TextEncoder();
@@ -36,7 +36,6 @@ const openSSEStream = (streams, clientId, onOpen, signal, headers) => {
 		}
 	});
 };
-//#endregion
 export { openSSEStream, sseFrame };
 
 //# sourceMappingURL=fake-sse.js.map

package/dist/transports/fixtures.d.ts

@@ -1,32 +1,26 @@
-import { StatewireHost } from "../host.js";
-import { Statewire } from "../types.js";
-import "../index.js";
-//#region src/transports/fixtures.d.ts
 /** Let several rounds of queued microtasks and op batches drain. */
-declare const settle: () => Promise<void>;
+export declare const settle: () => Promise<void>;
 /** A minimal statewire host element: `{ count }` state with an `increment` command. */
-declare const createCounterElement: () => import("@assistant-ui/tap").ResourceElement<{
-  state: {
-    count: number;
-  };
-  commands: Statewire.CommandsProxy<StatewireHost.HandledCommands<{
-    increment: () => void;
-  }>>;
+export declare const createCounterElement: () => import("@assistant-ui/tap").ResourceElement<{
+    state: {
+        count: number;
+    };
+    commands: import("../index.js").Statewire.CommandsProxy<import("../host.js").StatewireHost.HandledCommands<{
+        increment: () => void;
+    }>>;
 }>;
 /** Serialize a one-statement cmd-lane frame as a client would send it. */
-declare const commandFrame: (method: string, seq: number, params?: unknown[]) => string;
-type SocketRecorder = {
-  sent: string[];
-  closes: {
-    code?: number;
-    reason?: string;
-  }[];
-  last: () => any;
-  send: (data: string) => void;
-  close: (code?: number, reason?: string) => void;
+export declare const commandFrame: (method: string, seq: number, params?: unknown[]) => string;
+export type SocketRecorder = {
+    sent: string[];
+    closes: {
+        code?: number;
+        reason?: string;
+    }[];
+    last: () => any;
+    send: (data: string) => void;
+    close: (code?: number, reason?: string) => void;
 };
 /** Record sent frames and close calls; `last()` parses the latest frame. */
-declare const createSocketRecorder: () => SocketRecorder;
-//#endregion
-export { SocketRecorder, commandFrame, createCounterElement, createSocketRecorder, settle };
+export declare const createSocketRecorder: () => SocketRecorder;
 //# sourceMappingURL=fixtures.d.ts.map

package/dist/transports/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","names":[],"sources":["../../src/transports/fixtures.ts"],"mappings":";;;;;cAKa,cAAM;;cAKN,wDAAoB;;;;YAApB,UAAA,cAAA,cAAA;;;;;cAYA,eACX,gBACA,aACA;KAGU;EACV;EACA;IAAU;IAAe;;EACzB;EACA,OAAO;EACP,QAAQ,eAAe;;;cAIZ,4BAA2B"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/transports/fixtures.ts"],"names":[],"mappings":"AAIA,oEAAoE;AACpE,eAAO,MAAM,MAAM,qBAElB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,oBAAoB;;;;;;;EAS3B,CAAC;AAEP,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,KAAK,MAAM,EACX,SAAQ,OAAO,EAAO,WACoD,CAAC;AAE7E,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,IAAI,EAAE,MAAM,GAAG,CAAC;IAChB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,QAAO,cAiBvC,CAAC"}

package/dist/transports/fixtures.js

@@ -2,7 +2,7 @@ import { useStatewireCommands, useStatewireState } from "../host/host.js";
 import "../host.js";
 import { tick } from "./testing.js";
 import { resource } from "@assistant-ui/tap";
-//#region src/transports/fixtures.ts
+// src/transports/fixtures.ts
 /** Let several rounds of queued microtasks and op batches drain. */
 const settle = async () => {
 	for (let i = 0; i < 3; i++) await tick();
@@ -43,7 +43,6 @@ const createSocketRecorder = () => {
 		}
 	};
 };
-//#endregion
 export { commandFrame, createCounterElement, createSocketRecorder, settle };
 
 //# sourceMappingURL=fixtures.js.map

package/dist/transports/remote.d.ts

@@ -1,13 +1,10 @@
-import { RemoteLink, StatewireRemoteProps } from "./sse.js";
-import { StatewireClient } from "../statewire.js";
-import { Statewire } from "../types.js";
-import { StatewireSessionOptions } from "../client/session.js";
-//#region src/transports/remote.d.ts
-declare const useStatewireRemote: <TOptions extends {
-  url: string;
-  onChange?: (connection: StatewireClient.Connection) => void;
-  onDone?: () => void;
+import type { Statewire } from "../types.js";
+import type { StatewireSessionOptions } from "../client/session.js";
+import type { StatewireClient } from "../statewire.js";
+import type { RemoteLink, StatewireRemoteProps } from "./sse.js";
+export declare const useStatewireRemote: <TOptions extends {
+    url: string;
+    onChange?: (connection: StatewireClient.Connection) => void;
+    onDone?: () => void;
 } & StatewireSessionOptions>(options: TOptions, useLink: (options: TOptions, ctx: StatewireRemoteProps) => RemoteLink) => Statewire<any, any>;
-//#endregion
-export { useStatewireRemote };
 //# sourceMappingURL=remote.d.ts.map

package/dist/transports/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","names":[],"sources":["../../src/transports/remote.ts"],"mappings":";;;;;cAiBa,qBACX;EACE;EACA,YAAY,YAAY,gBAAgB;EACxC;IACE,yBAEJ,SAAS,UACT,UAAU,SAAS,UAAU,KAAK,yBAAyB,eAC1D"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/transports/remote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAiB;AAW1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,6BAA0B;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAqB;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAc;AAE9D,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,SAAS;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,KAAK,IAAI,CAAC;IAC5D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB,GAAG,uBAAuB,EAE3B,SAAS,QAAQ,EACjB,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,oBAAoB,KAAK,UAAU,KACpE,SAAS,CAAC,GAAG,EAAE,GAAG,CAuCpB,CAAC"}

package/dist/transports/remote.js

@@ -1,7 +1,7 @@
 import { LinkContext, ProtocolContext } from "../client/sessionStore.js";
 import { discardFailed, documentSource, failedCommands, invokeProtocol, retryFailed, setContext, setTransport, useStatewireSession } from "../client/session.js";
 import { useContext, useEffect, useMemo } from "@assistant-ui/tap/react-shim";
-//#region src/transports/remote.ts
+// src/transports/remote.ts
 const useStatewireRemote = (options, useLink) => {
 	const configured = {
 		...useContext(ProtocolContext),
@@ -35,7 +35,6 @@ const useStatewireRemote = (options, useLink) => {
 		}
 	};
 };
-//#endregion
 export { useStatewireRemote };
 
 //# sourceMappingURL=remote.js.map

package/dist/transports/sse-parser.d.ts

@@ -1,5 +1,2 @@
-//#region src/transports/sse-parser.d.ts
-declare const createSseParser: () => ((chunk: string) => string[]);
-//#endregion
-export { createSseParser };
+export declare const createSseParser: () => ((chunk: string) => string[]);
 //# sourceMappingURL=sse-parser.d.ts.map

package/dist/transports/sse-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-parser.d.ts","names":[],"sources":["../../src/transports/sse-parser.ts"],"mappings":";cAAa,yBAAwB"}
+{"version":3,"file":"sse-parser.d.ts","sourceRoot":"","sources":["../../src/transports/sse-parser.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,QAAO,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAuB9D,CAAC"}

package/dist/transports/sse-parser.js

@@ -1,4 +1,4 @@
-//#region src/transports/sse-parser.ts
+// src/transports/sse-parser.ts
 const createSseParser = () => {
 	let buffer = "";
 	let dataLines = [];
@@ -20,7 +20,6 @@ const createSseParser = () => {
 		return events;
 	};
 };
-//#endregion
 export { createSseParser };
 
 //# sourceMappingURL=sse-parser.js.map

package/dist/transports/sse.d.ts

@@ -1,62 +1,60 @@
-import { StatewireHost } from "../host.js";
-import { StatewireDocument } from "../document.js";
-import { StatewireCmd, StatewireSyn } from "../client/connection.js";
-import { StatewireClient } from "../statewire.js";
-import { Statewire } from "../types.js";
-import { ResourceElement } from "@assistant-ui/tap";
-//#region src/transports/sse.d.ts
+import type { StatewireDocument } from "../document.js";
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { StatewireCmd, StatewireSyn } from "../client/connection.js";
+import type { Statewire } from "../types.js";
+import type { StatewireClient } from "../statewire.js";
+import type { StatewireHost } from "../host.js";
 /** A client frame's lanes: stamped statements, strictly consecutive per lane. */
-type StatewireFrame = {
-  ctx?: ({
-    protocol: string;
-  } & StatewireDocument.Encoded)[];
-  cmd?: {
-    protocol: string;
-    method: string;
-    params: unknown[];
-    meta?: unknown;
-    seq: number;
-  }[];
+export type StatewireFrame = {
+    ctx?: ({
+        protocol: string;
+    } & StatewireDocument.Encoded)[];
+    cmd?: {
+        protocol: string;
+        method: string;
+        params: unknown[];
+        meta?: unknown;
+        seq: number;
+    }[];
 };
-type StatewireRemoteProps = {
-  beforeAttach?: () => void | Promise<void>;
-  clientId: string;
-  /** Lanes to ride the attach frame: ephemeral-lane statements, plus durable cmds on no-lease supersession; records the included entries. */
-  takeAttachLanes: () => StatewireFrame | null;
-  onHello: (args: {
-    ops: unknown[];
-    syn: StatewireSyn;
-  }) => void;
-  onOps: (args: {
-    ops: unknown[];
-    cmds: StatewireCmd[];
-  }) => void;
-  onCmds: (cmds: StatewireCmd[]) => void;
-  onRefusal: (syn: StatewireSyn) => void;
-  onIdle: (level: boolean) => void;
-  onDetach: () => void;
-  onFinish: (args: StatewireHost.Fin) => void;
+export type StatewireRemoteProps = {
+    beforeAttach?: () => void | Promise<void>;
+    clientId: string;
+    /** Lanes to ride the attach frame: ephemeral-lane statements, plus durable cmds on no-lease supersession; records the included entries. */
+    takeAttachLanes: () => StatewireFrame | null;
+    onHello: (args: {
+        ops: unknown[];
+        syn: StatewireSyn;
+    }) => void;
+    onOps: (args: {
+        ops: unknown[];
+        cmds: StatewireCmd[];
+    }) => void;
+    onCmds: (cmds: StatewireCmd[]) => void;
+    onRefusal: (syn: StatewireSyn) => void;
+    onIdle: (level: boolean) => void;
+    onDetach: () => void;
+    onFinish: (args: StatewireHost.Fin) => void;
 };
-type StatewireSubmitResult = {
-  type: "ok";
+export type StatewireSubmitResult = {
+    type: "ok";
 } | {
-  type: "refusal";
-  syn: StatewireSyn;
+    type: "refusal";
+    syn: StatewireSyn;
 } | {
-  type: "stale-lease";
+    type: "stale-lease";
 } | {
-  type: "no-lease";
+    type: "no-lease";
 };
-type ConnectionState = StatewireClient.ConnectionState;
+export type ConnectionState = StatewireClient.ConnectionState;
 /** The live wire a remote session drives: connection status plus frame submission. */
-type RemoteLink = {
-  storageFailed: (error: Error) => void;
-  connection: StatewireClient.Connection;
-  /** A deferred first attach still waiting; `reconnect()` releases it. */
-  parked: boolean;
-  send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;
+export type RemoteLink = {
+    storageFailed: (error: Error) => void;
+    protocolFailed: (error: Error) => void;
+    connection: StatewireClient.Connection;
+    /** A deferred first attach still waiting; `reconnect()` releases it. */
+    parked: boolean;
+    send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;
 };
-declare const StatewireHttp: <TState = any, TCommands extends Statewire.Commands = Statewire.Commands>(options: StatewireClient.HttpOptions) => ResourceElement<Statewire<TState | undefined, TCommands>>;
-//#endregion
-export { ConnectionState, RemoteLink, StatewireFrame, StatewireHttp, StatewireRemoteProps, StatewireSubmitResult };
+export declare const StatewireHttp: <TState = any, TCommands extends Statewire.Commands = Statewire.Commands>(options: StatewireClient.HttpOptions) => ResourceElement<Statewire<TState | undefined, TCommands>>;
 //# sourceMappingURL=sse.d.ts.map

package/dist/transports/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","names":[],"sources":["../../src/transports/sse.ts"],"mappings":";;;;;;;;KA2BY;EACV;IAAS;MAAqB,kBAAkB;EAChD;IACE;IACA;IACA;IACA;IACA;;;KAIQ;EACV,4BAA4B;EAC5B;;EAEA,uBAAuB;EACvB,UAAU;IAAQ;IAAgB,KAAK;;EACvC,QAAQ;IAAQ;IAAgB,MAAM;;EACtC,SAAS,MAAM;EACf,YAAY,KAAK;EACjB,SAAS;EACT;EACA,WAAW,MAAM,cAAc;;KAGrB;EACN;;EACA;EAAiB,KAAK;;EACtB;;EACA;;KAEM,kBAAkB,gBAAgB;;KAGlC;EACV,gBAAgB,OAAO;EACvB,YAAY,gBAAgB;;EAE5B;EACA,OAAO,OAAO,mBAAmB,QAAQ;;cAyP9B,gBACX,cACA,kBAAkB,UAAU,WAAW,UAAU,UAEjD,SAAS,gBAAgB,gBACtB,gBAAgB,UAAU,oBAAoB"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/transports/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAoB;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWzD,OAAO,KAAK,EAGV,YAAY,EAEZ,YAAY,EACb,gCAA6B;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAiB;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAqB;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAgB;AAI7C,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,CAAC,EAAE,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,GAAG,CAAC,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,2IAA2I;IAC3I,eAAe,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAAC,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D,KAAK,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QAAC,IAAI,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IAChE,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC,eAAe,CAAC;AAE9D,sFAAsF;AACtF,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACtC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC;IACvC,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACjE,CAAC;AAmQF,eAAO,MAAM,aAAa,EAAiC,CACzD,MAAM,GAAG,GAAG,EACZ,SAAS,SAAS,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAEzD,OAAO,EAAE,eAAe,CAAC,WAAW,KACjC,eAAe,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/dist/transports/sse.js

@@ -1,11 +1,17 @@
 import { negotiationHeaders, parseNegotiation } from "../wire/protocol.js";
-import { createSseParser } from "./sse-parser.js";
 import { timing } from "../client/timing.js";
 import { classify, handleEnvelope, resolveHeaders, settleFin, useLink, validateRefusalSyn } from "../client/connection.js";
+import { createSseParser } from "./sse-parser.js";
 import { useStatewireRemote } from "./remote.js";
 import { flushTapSync, resource } from "@assistant-ui/tap";
-//#region src/transports/sse.ts
+// src/transports/sse.ts
 const LEASE_HEADER = "Statewire-Lease";
+let warnedNoLease = false;
+const warnNoLease = () => {
+	if (warnedNoLease) return;
+	warnedNoLease = true;
+	console.warn("statewire: SSE attach returned no readable Statewire-Lease header; commands will re-attach the stream. Cross-origin hosts must expose it (Access-Control-Expose-Headers: Statewire-Lease).");
+};
 const baseUrl = (options) => options.url.replace(/\/$/, "");
 const withExtra = (headers, extra) => {
 	const merged = new Headers(headers);
@@ -76,6 +82,7 @@ const attemptStream = async (c, options, abort) => {
 	}
 	if (!res.body) throw new Error("statewire: protocol error: stream response has no body");
 	c.lease = res.headers.get(LEASE_HEADER);
+	if (c.lease === null) warnNoLease();
 	const reader = res.body.getReader();
 	const cancel = () => {
 		reader.cancel().catch(() => {});
@@ -159,7 +166,6 @@ const useSseLink = (options, ctx) => useLink({
 });
 const useStatewireHttp = (options) => useStatewireRemote(options, useSseLink);
 const StatewireHttp = resource(useStatewireHttp);
-//#endregion
 export { StatewireHttp };
 
 //# sourceMappingURL=sse.js.map