statewire 0.17.0 → 0.17.2

package/dist/statewire.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire.js","names":["StatewireDocuments","StatewireProtocol","StatewireHost","useMemo","useRef","useState","useSyncExternalStore","createTapRoot","flushTapSync","resource","useContextProvider","useResource","useResources","withKey","ResourceElement","CONNECTED_CONNECTION","useStatewireCore","Statewire","TERMINAL","DocumentStorageContext","ProtocolContext","SessionStorageContext","useSessionTransport","transport","session","documents","protocol","StatewireClient","SessionStorage","Storage","Options","SessionTransport","useStatewire","Commands","options","TState","TCommands","Helpers","latest","current","storage","undefined","wireVersion","applicationProtocols","keyPrefixes","value","core","subscribe","listener","state","getState","isBusy","getBusy","failed","getFailed","connection","failures","NonNullable","Error","selection","invoke","method","params","updateContext","ops","commands","CommandsProxy","setContext","contextValue","Record","retryFailed","entry","FailedCommand","retry","discardFailed","discard","StatewireResource","root","disposed","constructor","ClientRoot","getValue","Connection","Source","Selection","Promise","dispose","unmount","Readonly","Range","Offer","initialState","optimistic","Optimistic","materialize","Materialize","onStateChange","ctx","changes","Changes","onCommandChange","update","CommandUpdate","onConnectionChange","onError","error","ConnectionError","failureCovered","ConnectionState","status","reason","message","payload","attempt","cause","code","nextRetryAt","lastError","reconnect","degraded","ConnectionStatus","draft","command","Command","OptimisticContext","ts","seq","clientId","SendFailure","fate","predecessorLost","OnSessionLost","pending","ReadonlyArray","produced","SessionCommand","meta","failure","wire","protocols","SessionRecord","nextSeq","ctxNextSeq","context","verdicts","SessionVerdict","type","load","save","record","migrate","lock","fn","T","fin","Fin","HeadersOption","HeadersInit","staleAuth","HttpOptions","sessionStore","url","isNew","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 { useMemo, useRef, useState, useSyncExternalStore } 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  ProtocolContext,\n  SessionStorageContext,\n} from \"./client/sessionStore\";\n\nconst useSessionTransport = ({\n  transport,\n  session,\n  documents,\n  protocol,\n}: {\n  transport: ResourceElement<Statewire<any, any>>;\n  session: StatewireClient.SessionStorage | undefined;\n  documents: StatewireDocuments.Storage | undefined;\n  protocol: StatewireProtocol.Options;\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        useResource(transport),\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 value = useResource(\n    SessionTransport({\n      transport: options.transport,\n      session,\n      documents,\n      protocol,\n    }),\n  );\n  const core = useStatewireCore(() => latest.current, value);\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\n  return useMemo(() => {\n    const failures = (): NonNullable<typeof value.failures> => {\n      if (!value.failures) {\n        throw new Error(\"statewire: this transport has no failed-send lane\");\n      }\n      return value.failures;\n    };\n    return {\n      state,\n      documents: value.documents,\n      selection: value.selection,\n      invoke: (\n        protocol: string,\n        method: string,\n        params: readonly unknown[],\n      ) => {\n        if (!value.invoke)\n          throw new Error(\n            \"statewire: transport does not support protocol commands\",\n          );\n        return value.invoke(protocol, method, params);\n      },\n      updateContext: (ops: readonly unknown[]) => {\n        if (!value.updateContext)\n          throw new Error(\n            \"statewire: transport does not support context documents\",\n          );\n        value.updateContext(ops);\n      },\n      getState: core.getState as () => TState,\n      connection,\n      commands: core.commands as Statewire.CommandsProxy<TCommands>,\n      isBusy,\n      setContext: (contextValue: Record<string, unknown>) => {\n        if (!value.setContext) {\n          throw new Error(\n            \"statewire: this transport has no client context channel\",\n          );\n        }\n        value.setContext(contextValue);\n      },\n      failed,\n      retryFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().retry(entry),\n      discardFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().discard(entry),\n    };\n  }, [state, isBusy, failed, connection, core, value]);\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  updateContext(ops: readonly unknown[]): void {\n    this.root.getValue().updateContext(ops);\n  }\n\n  get isBusy(): boolean {\n    return this.root.getValue().isBusy;\n  }\n\n  setContext(value: Record<string, unknown>): void {\n    this.root.getValue().setContext(value);\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    keyPrefixes?: Readonly<Record<string, readonly string[]>>;\n    wireVersion?: StatewireProtocol.Range;\n    applicationProtocols?: readonly StatewireProtocol.Offer[] | \"*\";\n    transport: ResourceElement<Statewire<TState, TCommands>>;\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    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    invoke: (\n      protocol: string,\n      method: string,\n      params: readonly unknown[],\n    ) => Promise<unknown>;\n    updateContext: (ops: readonly unknown[]) => void;\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    /** Replace this client's ambient context on the server; throws on transports without a client context channel. */\n    setContext: (value: Record<string, unknown>) => void;\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  /** `cause`/`nextRetryAt`/`lastError` are present only while waiting out the backoff timer; a dial in flight carries `attempt` alone. */\n  export type ConnectionState =\n    | {\n        status: \"disconnected\";\n        reason:\n          | \"deferred\"\n          | \"idle\"\n          | \"gone\"\n          | \"forbidden\"\n          | \"protocol-error\"\n          | \"unauthorized\";\n        message?: string;\n        payload?: unknown;\n      }\n    | {\n        status: \"connecting\";\n        /** 0 = the episode's first dial, >0 = retry. */\n        attempt: number;\n        cause?: \"dropped\" | \"reconnect\" | \"error\" | \"unauthorized\";\n        code?: string;\n        nextRetryAt?: number;\n        lastError?: string;\n        message?: string;\n      }\n    | { status: \"connected\" };\n  export type Connection = ConnectionState & {\n    error?: ConnectionError;\n    reconnect: () => void;\n    /** True while retrying (`connecting` with `attempt > 0`) or parked `gone`. */\n    degraded: boolean;\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 make server-accepted, still-uncommitted intents in\n   * the state concrete (e.g. dispatch records into messages). Runs after the\n   * optimistic folds on every published state.\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    protocol: string;\n    produced?: {\n      wire: StatewireProtocol.Range;\n      protocols: readonly StatewireProtocol.Offer[] | \"*\";\n    };\n    method: string;\n    params: unknown[];\n    meta?: unknown;\n  };\n\n  /** The persisted session: the lane identity, the lane clocks, and the commands the server has not marked durable. */\n  export type SessionRecord = {\n    clientId: string;\n    nextSeq: number;\n    ctxNextSeq: number;\n    context?: { ops: unknown[]; pending: { seq: number; ops: unknown[] }[] };\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  /** 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; `save` must persist synchronously in the caller's flow. */\n  export type SessionStorage = {\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","useMemo","useRef","useState","useSyncExternalStore","createTapRoot","flushTapSync","resource","useContextProvider","useResource","useResources","withKey","ResourceElement","CONNECTED_CONNECTION","useStatewireCore","Statewire","TERMINAL","DocumentStorageContext","ProtocolContext","SessionStorageContext","useSessionTransport","transport","session","documents","protocol","StatewireClient","SessionStorage","Storage","Options","SessionTransport","useStatewire","Commands","options","TState","TCommands","Helpers","latest","current","storage","undefined","wireVersion","applicationProtocols","keyPrefixes","value","core","subscribe","listener","state","getState","isBusy","getBusy","failed","getFailed","connection","failures","NonNullable","Error","selection","invoke","method","params","updateContext","ops","commands","CommandsProxy","setContext","contextValue","Record","retryFailed","entry","FailedCommand","retry","discardFailed","discard","StatewireResource","root","disposed","constructor","ClientRoot","getValue","Connection","Source","Selection","Promise","dispose","unmount","Readonly","Range","Offer","initialState","optimistic","Optimistic","materialize","Materialize","onStateChange","ctx","changes","Changes","onCommandChange","update","CommandUpdate","onConnectionChange","onError","error","ConnectionError","failureCovered","ConnectionState","status","reason","message","payload","attempt","cause","code","nextRetryAt","lastError","reconnect","degraded","ConnectionStatus","draft","command","Command","OptimisticContext","ts","seq","clientId","SendFailure","fate","predecessorLost","OnSessionLost","pending","ReadonlyArray","produced","SessionCommand","meta","failure","wire","protocols","SessionRecord","nextSeq","ctxNextSeq","context","recover","verdicts","SessionVerdict","type","load","save","record","migrate","lock","fn","T","fin","Fin","HeadersOption","HeadersInit","staleAuth","HttpOptions","sessionStore","url","isNew","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 { useMemo, useRef, useState, useSyncExternalStore } 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  ProtocolContext,\n  SessionStorageContext,\n} from \"./client/sessionStore\";\n\nconst useSessionTransport = ({\n  transport,\n  session,\n  documents,\n  protocol,\n}: {\n  transport: ResourceElement<Statewire<any, any>>;\n  session: StatewireClient.SessionStorage | undefined;\n  documents: StatewireDocuments.Storage | undefined;\n  protocol: StatewireProtocol.Options;\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        useResource(transport),\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 value = useResource(\n    SessionTransport({\n      transport: options.transport,\n      session,\n      documents,\n      protocol,\n    }),\n  );\n  const core = useStatewireCore(() => latest.current, value);\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\n  return useMemo(() => {\n    const failures = (): NonNullable<typeof value.failures> => {\n      if (!value.failures) {\n        throw new Error(\"statewire: this transport has no failed-send lane\");\n      }\n      return value.failures;\n    };\n    return {\n      state,\n      documents: value.documents,\n      selection: value.selection,\n      invoke: (\n        protocol: string,\n        method: string,\n        params: readonly unknown[],\n      ) => {\n        if (!value.invoke)\n          throw new Error(\n            \"statewire: transport does not support protocol commands\",\n          );\n        return value.invoke(protocol, method, params);\n      },\n      updateContext: (ops: readonly unknown[]) => {\n        if (!value.updateContext)\n          throw new Error(\n            \"statewire: transport does not support context documents\",\n          );\n        value.updateContext(ops);\n      },\n      getState: core.getState as () => TState,\n      connection,\n      commands: core.commands as Statewire.CommandsProxy<TCommands>,\n      isBusy,\n      setContext: (contextValue: Record<string, unknown>) => {\n        if (!value.setContext) {\n          throw new Error(\n            \"statewire: this transport has no client context channel\",\n          );\n        }\n        value.setContext(contextValue);\n      },\n      failed,\n      retryFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().retry(entry),\n      discardFailed: (entry: StatewireClient.FailedCommand) =>\n        failures().discard(entry),\n    };\n  }, [state, isBusy, failed, connection, core, value]);\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  updateContext(ops: readonly unknown[]): void {\n    this.root.getValue().updateContext(ops);\n  }\n\n  get isBusy(): boolean {\n    return this.root.getValue().isBusy;\n  }\n\n  setContext(value: Record<string, unknown>): void {\n    this.root.getValue().setContext(value);\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    keyPrefixes?: Readonly<Record<string, readonly string[]>>;\n    wireVersion?: StatewireProtocol.Range;\n    applicationProtocols?: readonly StatewireProtocol.Offer[] | \"*\";\n    transport: ResourceElement<Statewire<TState, TCommands>>;\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    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    invoke: (\n      protocol: string,\n      method: string,\n      params: readonly unknown[],\n    ) => Promise<unknown>;\n    updateContext: (ops: readonly unknown[]) => void;\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    /** Replace this client's ambient context on the server; throws on transports without a client context channel. */\n    setContext: (value: Record<string, unknown>) => void;\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  /** `cause`/`nextRetryAt`/`lastError` are present only while waiting out the backoff timer; a dial in flight carries `attempt` alone. */\n  export type ConnectionState =\n    | {\n        status: \"disconnected\";\n        reason:\n          | \"deferred\"\n          | \"idle\"\n          | \"gone\"\n          | \"forbidden\"\n          | \"protocol-error\"\n          | \"unauthorized\";\n        message?: string;\n        payload?: unknown;\n      }\n    | {\n        status: \"connecting\";\n        /** 0 = the episode's first dial, >0 = retry. */\n        attempt: number;\n        cause?: \"dropped\" | \"reconnect\" | \"error\" | \"unauthorized\";\n        code?: string;\n        nextRetryAt?: number;\n        lastError?: string;\n        message?: string;\n      }\n    | { status: \"connected\" };\n  export type Connection = ConnectionState & {\n    error?: ConnectionError;\n    reconnect: () => void;\n    /** True while retrying (`connecting` with `attempt > 0`) or parked `gone`. */\n    degraded: boolean;\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 make server-accepted, still-uncommitted intents in\n   * the state concrete (e.g. dispatch records into messages). Runs after the\n   * optimistic folds on every published state.\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    protocol: string;\n    produced?: {\n      wire: StatewireProtocol.Range;\n      protocols: readonly StatewireProtocol.Offer[] | \"*\";\n    };\n    method: string;\n    params: unknown[];\n    meta?: unknown;\n  };\n\n  /** The persisted session: the lane identity, the lane clocks, and the commands the server has not marked durable. */\n  export type SessionRecord = {\n    clientId: string;\n    nextSeq: number;\n    ctxNextSeq: number;\n    context?: {\n      ops: unknown[];\n      pending: { seq: number; ops: unknown[] }[];\n      /** Recover the original wire's unpersisted single-document context after the next hello. */\n      recover?: \"version-1\";\n    };\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  /** 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; `save` must persist synchronously in the caller's flow. */\n  export type SessionStorage = {\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":";;;;;AAuBA,MAAMsB,uBAAuB,EAC3BC,WACAC,SACAC,WACAC,eAOAhB,mBAAmBW,uBAAuBG,eAExCd,mBAAmBS,wBAAwBM,iBAEzCf,mBAAmBU,iBAAiBM,gBAElCf,YAAYY,SAAS,CACvB,CACF,CACF;AAIF,MAAMQ,mBAAmBtB,SAASa,mBAAmB;AAErD,MAAaU,gBAIXE,YAC+C;CAC/C,MAAMI,SAASlC,OAAO8B,OAAO;CAC7BI,OAAOC,UAAUL;CAEjB,MAAMV,UAAUZ,aACdsB,QAAQM,SAAShB,YAAYiB,KAAAA,IACzB,CAAC5B,QAAQ,WAAWqB,QAAQM,QAAQhB,OAAO,CAAC,IAC5C,CAAA,CACN,CAAC,CAAC;CACF,MAAMC,YAAYb,aAChBsB,QAAQM,SAASf,cAAcgB,KAAAA,IAC3B,CAAA,IACA,CAAC5B,QAAQ,aAAaqB,QAAQM,QAAQf,SAAS,CAAC,CACtD,CAAC,CAAC;CACF,MAAMC,WAAsC;EAC1C,GAAIQ,QAAQR,aAAae,KAAAA,KAAa,EAAEf,UAAUQ,QAAQR,SAAS;EACnE,GAAIQ,QAAQQ,gBAAgBD,KAAAA,KAAa,EACvCC,aAAaR,QAAQQ,YACvB;EACA,GAAIR,QAAQS,yBAAyBF,KAAAA,KAAa,EAChDE,sBAAsBT,QAAQS,qBAChC;EACA,GAAIT,QAAQU,gBAAgBH,KAAAA,KAAa,EACvCG,aAAaV,QAAQU,YACvB;CACF;CACA,MAAMC,QAAQlC,YACZoB,iBAAiB;EACfR,WAAWW,QAAQX;EACnBC;EACAC;EACAC;CACF,CAAC,CACH;CACA,MAAMoB,OAAO9B,uBAAuBsB,OAAOC,SAASM,KAAK;CACzD,MAAM,CAACE,aAAa1C,gBACX2C,aACLF,KAAKC,gBAAgBvC,aAAawC,QAAQ,CAAC,CAC/C;CAEA,MAAMC,QAAQ3C,qBACZyC,WACAD,KAAKI,UACLJ,KAAKI,QACP;CACA,MAAMC,SAAS7C,qBAAqByC,WAAWD,KAAKM,SAASN,KAAKM,OAAO;CACzE,MAAMC,SAAS/C,qBACbyC,WACAD,KAAKQ,WACLR,KAAKQ,SACP;CACA,MAAMC,aAAaV,MAAMU,cAAcxC;CAEvC,OAAOZ,cAAc;EACnB,MAAMqD,iBAAqD;GACzD,IAAI,CAACX,MAAMW,UACT,MAAM,IAAIE,MAAM,mDAAmD;GAErE,OAAOb,MAAMW;EACf;EACA,OAAO;GACLP;GACAxB,WAAWoB,MAAMpB;GACjBkC,WAAWd,MAAMc;GACjBC,SACElC,YACAmC,QACAC,WACG;IACH,IAAI,CAACjB,MAAMe,QACT,MAAM,IAAIF,MACR,yDACF;IACF,OAAOb,MAAMe,OAAOlC,YAAUmC,QAAQC,MAAM;GAC9C;GACAC,gBAAgBC,QAA4B;IAC1C,IAAI,CAACnB,MAAMkB,eACT,MAAM,IAAIL,MACR,yDACF;IACFb,MAAMkB,cAAcC,GAAG;GACzB;GACAd,UAAUJ,KAAKI;GACfK;GACAU,UAAUnB,KAAKmB;GACfd;GACAgB,aAAaC,iBAA0C;IACrD,IAAI,CAACvB,MAAMsB,YACT,MAAM,IAAIT,MACR,yDACF;IAEFb,MAAMsB,WAAWC,YAAY;GAC/B;GACAf;GACAiB,cAAcC,UACZf,SAAS,CAAC,CAACiB,MAAMF,KAAK;GACxBG,gBAAgBH,YACdf,SAAS,CAAC,CAACmB,QAAQJ,OAAK;EAC5B;CACF,GAAG;EAACtB;EAAOE;EAAQE;EAAQE;EAAYT;EAAMD;CAAK,CAAC;AACrD;AAEA,MAAa+B,qBAIX1C,YAEAzB,SAASuB,YAA+B,CAAC,CAACE,OAAO;AAEnD,IAAaP,kBAAb,MAGE;CACA;CACA,WAAmB;CAEnBoD,YAAY7C,SAAqD;EAC/D,MAAM8C,mBAAmBhD,aAAgCE,OAAO;EAChE,KAAK2C,OAAOtE,cAAcyE,UAAU;CACtC;CAEA,IAAI/B,QAAgB;EAClB,OAAO,KAAK4B,KAAKI,SAAS,CAAC,CAAC/B,SAAS;CACvC;CAEA,IAAIK,aAAyC;EAC3C,OAAO,KAAKsB,KAAKI,SAAS,CAAC,CAAC1B;CAC9B;CAEA,IAAIU,WAA+C;EACjD,OAAO,KAAKY,KAAKI,SAAS,CAAC,CAAChB;CAC9B;CAEA,IAAIxC,YAAmD;EACrD,OAAO,KAAKoD,KAAKI,SAAS,CAAC,CAACxD;CAC9B;CACA,IAAIkC,YAAqD;EACvD,OAAO,KAAKkB,KAAKI,SAAS,CAAC,CAACtB;CAC9B;CACAC,OACElC,UACAmC,QACAC,QACkB;EAClB,OAAO,KAAKe,KAAKI,SAAS,CAAC,CAACrB,OAAOlC,UAAUmC,QAAQC,MAAM;CAC7D;CACAC,cAAcC,KAA+B;EAC3C,KAAKa,KAAKI,SAAS,CAAC,CAAClB,cAAcC,GAAG;CACxC;CAEA,IAAIb,SAAkB;EACpB,OAAO,KAAK0B,KAAKI,SAAS,CAAC,CAAC9B;CAC9B;CAEAgB,WAAWtB,OAAsC;EAC/C,KAAKgC,KAAKI,SAAS,CAAC,CAACd,WAAWtB,KAAK;CACvC;CAEA,IAAIQ,SAAmD;EACrD,OAAO,KAAKwB,KAAKI,SAAS,CAAC,CAAC5B;CAC9B;CAEAiB,YAAYC,OAAwD;EAClE,OAAO,KAAKM,KAAKI,SAAS,CAAC,CAACX,YAAYC,KAAK;CAC/C;CAEAG,cAAcH,OAA4C;EACxD,KAAKM,KAAKI,SAAS,CAAC,CAACP,cAAcH,KAAK;CAC1C;CAEAxB,UAAUC,UAAkC;EAC1C,OAAO,KAAK6B,KAAK9B,UAAUC,QAAQ;CACrC;CAEAsC,UAAgB;EACd,IAAI,KAAKR,UAAU;EACnB,KAAKA,WAAW;EAChB,KAAKD,KAAKU,QAAQ;CACpB;AACF"}

package/dist/wire/documents.js

@@ -1,6 +1,6 @@
+import { reviveDocumentValue } from "../document.js";
 import { protocolToken } from "./protocol.js";
 import { applyOps } from "./ops.js";
-import { reviveValue } from "./meta.js";
 //#region src/wire/documents.ts
 const invalid = (message) => {
 	throw new Error(`statewire: protocol error: ${message}`);
@@ -50,7 +50,7 @@ const applyDocumentOps = (previous, ops, protocols, strict = false) => {
 				key: op.key === void 0 ? null : op.key,
 				...op.protocol === void 0 ? {} : { protocol: op.protocol },
 				...op.main === void 0 ? {} : { main: op.main },
-				value: op.meta === void 0 ? op.value : reviveValue(op.value, op.meta, { rejectUnknown: strict })
+				value: op.meta === void 0 ? op.value : reviveDocumentValue(op.value, op.meta, { rejectUnknown: strict })
 			});
 			if (doc === 0) changedPaths.push([]);
 		} else if (op.op === "unmount") {
@@ -65,7 +65,7 @@ const applyDocumentOps = (previous, ops, protocols, strict = false) => {
 			if (!Array.isArray(op.path) || !op.path.every((part) => typeof part === "string" || typeof part === "number" && Number.isSafeInteger(part) && part >= 0)) invalid("operation requires a valid path");
 			if (op.op !== "remove" && !("value" in op)) invalid("operation requires a value");
 			const { doc: _doc, meta, ...mutation } = op;
-			if (meta !== void 0) mutation.value = reviveValue(mutation.value, meta, { rejectUnknown: strict });
+			if (meta !== void 0) mutation.value = reviveDocumentValue(mutation.value, meta, { rejectUnknown: strict });
 			const applied = applyOps(document.value, [mutation]);
 			documents.set(doc, {
 				...document,

package/dist/wire/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","names":["applyOps","reviveValue","protocolToken","StatewirePath","StatewireDocuments","CacheEntry","version","value","Storage","namespace","load","identity","save","entry","subscribe","listener","Source","get","protocol","key","prefix","list","ReadonlyMap","Document","main","State","mode","documents","invalid","message","Error","applyDocumentOps","previous","ops","protocols","name","strict","undefined","length","Map","changedPaths","raw","Array","isArray","op","Record","doc","Number","isSafeInteger","includes","_doc","unknown","path","set","has","every","test","some","p","values","d","JSON","stringify","meta","rejectUnknown","push","document","delete","part","mutation","applied","state","mainDocument","find","resolveDocumentKey","slice","findDocument","resolved"],"sources":["../../src/wire/documents.ts"],"sourcesContent":["import { applyOps } from \"./ops\";\nimport { reviveValue } from \"./meta\";\nimport { protocolToken } from \"./protocol\";\nimport type { StatewirePath } from \"./ops\";\n\nexport namespace StatewireDocuments {\n  export type CacheEntry = { version: string; value: unknown };\n  export type Storage = {\n    namespace?: string;\n    load: (identity: readonly string[]) => CacheEntry | undefined;\n    save: (identity: readonly string[], entry: CacheEntry) => void;\n    subscribe?: (listener: () => void) => () => void;\n  };\n  export type Source = {\n    get: (\n      protocol: string,\n      key?: readonly string[],\n      prefix?: readonly string[],\n    ) => unknown;\n    list: () => ReadonlyMap<number, Document>;\n    subscribe: (listener: () => void) => () => void;\n  };\n  export type Document = {\n    key: readonly string[] | null;\n    protocol?: string;\n    main?: boolean;\n    value: unknown;\n  };\n  export type State = {\n    mode: \"mounted\" | \"keyless\" | null;\n    documents: ReadonlyMap<number, Document>;\n  };\n}\n\nconst invalid: (message: string) => never = (message) => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nexport const applyDocumentOps = (\n  previous: StatewireDocuments.State,\n  ops: readonly unknown[],\n  protocols?: readonly { name: string; version: string }[],\n  strict = false,\n) => {\n  let mode =\n    previous.mode ??\n    (protocols !== undefined && ops.length === 0 ? \"mounted\" : null);\n  const documents = new Map(previous.documents);\n  const changedPaths: StatewirePath[] = [];\n  for (const raw of ops) {\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n      invalid(\"operation must be an object\");\n    }\n    const op = raw as Record<string, unknown>;\n    const doc = op.doc === undefined ? 0 : op.doc;\n    if (typeof doc !== \"number\" || !Number.isSafeInteger(doc) || doc < 0) {\n      invalid(\"doc must be a nonnegative safe integer\");\n    }\n    if (\n      ![\"mount\", \"unmount\", \"add\", \"replace\", \"remove\"].includes(\n        op.op as string,\n      )\n    ) {\n      if (strict) invalid(\"unknown context operation\");\n      const { doc: _doc, ...unknown } = op;\n      applyOps(undefined, [unknown]);\n      continue;\n    }\n    if (protocols !== undefined && mode === null && op.op !== \"mount\")\n      invalid(\"negotiated state must start with mounts\");\n    if (mode === null) {\n      if (op.op === \"mount\") mode = \"mounted\";\n      else if (\n        op.op === \"replace\" &&\n        doc === 0 &&\n        Array.isArray(op.path) &&\n        op.path.length === 0 &&\n        \"value\" in op\n      ) {\n        mode = \"keyless\";\n        documents.set(0, { key: null, value: undefined });\n      } else\n        invalid(\n          \"first operation must mount a document or replace document 0 at the root\",\n        );\n    }\n    if (\n      mode === \"keyless\" &&\n      (doc !== 0 || op.op === \"mount\" || op.op === \"unmount\")\n    ) {\n      invalid(\"keyless mode only supports mutations of document 0\");\n    }\n    if (op.op === \"mount\") {\n      if (documents.has(doc)) invalid(\"document is already mounted\");\n      if (\n        (op.key !== undefined &&\n          (!Array.isArray(op.key) ||\n            !op.key.every((key) => typeof key === \"string\"))) ||\n        !(\"value\" in op)\n      ) {\n        invalid(\"mount requires value and an optional key array\");\n      }\n      if (\n        op.protocol !== undefined &&\n        (typeof op.protocol !== \"string\" ||\n          !protocolToken.test(op.protocol) ||\n          op.protocol === \"*\")\n      )\n        invalid(\"invalid mount protocol\");\n      if (\n        protocols !== undefined &&\n        !protocols.some((p) => p.name === op.protocol)\n      )\n        invalid(\"mount protocol was not negotiated\");\n      if (op.main !== undefined && typeof op.main !== \"boolean\")\n        invalid(\"main must be boolean\");\n      if (\n        op.main === true &&\n        [...documents.values()].some(\n          (d) => d.protocol === op.protocol && d.main,\n        )\n      )\n        invalid(\"protocol already has a main document\");\n      if (\n        op.key !== undefined &&\n        [...documents.values()].some(\n          (d) =>\n            d.protocol === op.protocol &&\n            JSON.stringify(d.key) === JSON.stringify(op.key),\n        )\n      )\n        invalid(\"protocol document key is already mounted\");\n      documents.set(doc, {\n        key: op.key === undefined ? null : (op.key as string[]),\n        ...(op.protocol === undefined\n          ? {}\n          : { protocol: op.protocol as string }),\n        ...(op.main === undefined ? {} : { main: op.main as boolean }),\n        value:\n          op.meta === undefined\n            ? op.value\n            : reviveValue(op.value, op.meta, { rejectUnknown: strict }),\n      });\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"unmount\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!documents.delete(doc)) invalid(\"document is not mounted\");\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"add\" || op.op === \"replace\" || op.op === \"remove\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!document) invalid(\"document is not mounted\");\n      if (\n        !Array.isArray(op.path) ||\n        !op.path.every(\n          (part) =>\n            typeof part === \"string\" ||\n            (typeof part === \"number\" &&\n              Number.isSafeInteger(part) &&\n              part >= 0),\n        )\n      ) {\n        invalid(\"operation requires a valid path\");\n      }\n      if (op.op !== \"remove\" && !(\"value\" in op))\n        invalid(\"operation requires a value\");\n      const { doc: _doc, meta, ...mutation } = op;\n      if (meta !== undefined)\n        mutation.value = reviveValue(mutation.value, meta, {\n          rejectUnknown: strict,\n        });\n      const applied = applyOps(document.value, [mutation]);\n      documents.set(doc, { ...document, value: applied.state });\n      if (doc === 0) changedPaths.push(...applied.changedPaths);\n    }\n  }\n  if (mode === null) invalid(\"hello missing snapshot\");\n  return { mode, documents, changedPaths };\n};\n\nexport const mainDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n) =>\n  [...state.documents.values()].find(\n    (document) => document.protocol === protocol && document.main,\n  );\n\nexport const resolveDocumentKey = (\n  key: readonly string[],\n  prefix?: readonly string[],\n) =>\n  key[0] === \".\"\n    ? prefix === undefined\n      ? undefined\n      : [...prefix, ...key.slice(1)]\n    : key;\n\nexport const findDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n  key?: readonly string[],\n  prefix?: readonly string[],\n) => {\n  if (key === undefined) return mainDocument(state, protocol);\n  const resolved = resolveDocumentKey(key, prefix);\n  return [...state.documents.values()].find(\n    (document) =>\n      document.protocol === protocol &&\n      document.key !== null &&\n      (JSON.stringify(document.key) === JSON.stringify(key) ||\n        (resolved !== undefined &&\n          JSON.stringify(resolveDocumentKey(document.key, prefix)) ===\n            JSON.stringify(resolved))),\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"documents.js","names":["applyOps","reviveValue","protocolToken","StatewirePath","StatewireDocuments","CacheEntry","version","value","Storage","namespace","load","identity","save","entry","subscribe","listener","Source","get","protocol","key","prefix","list","ReadonlyMap","Document","main","State","mode","documents","invalid","message","Error","applyDocumentOps","previous","ops","protocols","name","strict","undefined","length","Map","changedPaths","raw","Array","isArray","op","Record","doc","Number","isSafeInteger","includes","_doc","unknown","path","set","has","every","test","some","p","values","d","JSON","stringify","meta","rejectUnknown","push","document","delete","part","mutation","applied","state","mainDocument","find","resolveDocumentKey","slice","findDocument","resolved"],"sources":["../../src/wire/documents.ts"],"sourcesContent":["import { applyOps } from \"./ops\";\nimport { reviveValue } from \"./meta\";\nimport { protocolToken } from \"./protocol\";\nimport type { StatewirePath } from \"./ops\";\n\nexport namespace StatewireDocuments {\n  export type CacheEntry = { version: string; value: unknown };\n  export type Storage = {\n    namespace?: string;\n    load: (identity: readonly string[]) => CacheEntry | undefined;\n    save: (identity: readonly string[], entry: CacheEntry) => void;\n    subscribe?: (listener: () => void) => () => void;\n  };\n  export type Source = {\n    get: (\n      protocol: string,\n      key?: readonly string[],\n      prefix?: readonly string[],\n    ) => unknown;\n    list: () => ReadonlyMap<number, Document>;\n    subscribe: (listener: () => void) => () => void;\n  };\n  export type Document = {\n    key: readonly string[] | null;\n    protocol?: string;\n    main?: boolean;\n    value: unknown;\n  };\n  export type State = {\n    mode: \"mounted\" | \"keyless\" | null;\n    documents: ReadonlyMap<number, Document>;\n  };\n}\n\nconst invalid: (message: string) => never = (message) => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nexport const applyDocumentOps = (\n  previous: StatewireDocuments.State,\n  ops: readonly unknown[],\n  protocols?: readonly { name: string; version: string }[],\n  strict = false,\n) => {\n  let mode =\n    previous.mode ??\n    (protocols !== undefined && ops.length === 0 ? \"mounted\" : null);\n  const documents = new Map(previous.documents);\n  const changedPaths: StatewirePath[] = [];\n  for (const raw of ops) {\n    if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n      invalid(\"operation must be an object\");\n    }\n    const op = raw as Record<string, unknown>;\n    const doc = op.doc === undefined ? 0 : op.doc;\n    if (typeof doc !== \"number\" || !Number.isSafeInteger(doc) || doc < 0) {\n      invalid(\"doc must be a nonnegative safe integer\");\n    }\n    if (\n      ![\"mount\", \"unmount\", \"add\", \"replace\", \"remove\"].includes(\n        op.op as string,\n      )\n    ) {\n      if (strict) invalid(\"unknown context operation\");\n      const { doc: _doc, ...unknown } = op;\n      applyOps(undefined, [unknown]);\n      continue;\n    }\n    if (protocols !== undefined && mode === null && op.op !== \"mount\")\n      invalid(\"negotiated state must start with mounts\");\n    if (mode === null) {\n      if (op.op === \"mount\") mode = \"mounted\";\n      else if (\n        op.op === \"replace\" &&\n        doc === 0 &&\n        Array.isArray(op.path) &&\n        op.path.length === 0 &&\n        \"value\" in op\n      ) {\n        mode = \"keyless\";\n        documents.set(0, { key: null, value: undefined });\n      } else\n        invalid(\n          \"first operation must mount a document or replace document 0 at the root\",\n        );\n    }\n    if (\n      mode === \"keyless\" &&\n      (doc !== 0 || op.op === \"mount\" || op.op === \"unmount\")\n    ) {\n      invalid(\"keyless mode only supports mutations of document 0\");\n    }\n    if (op.op === \"mount\") {\n      if (documents.has(doc)) invalid(\"document is already mounted\");\n      if (\n        (op.key !== undefined &&\n          (!Array.isArray(op.key) ||\n            !op.key.every((key) => typeof key === \"string\"))) ||\n        !(\"value\" in op)\n      ) {\n        invalid(\"mount requires value and an optional key array\");\n      }\n      if (\n        op.protocol !== undefined &&\n        (typeof op.protocol !== \"string\" ||\n          !protocolToken.test(op.protocol) ||\n          op.protocol === \"*\")\n      )\n        invalid(\"invalid mount protocol\");\n      if (\n        protocols !== undefined &&\n        !protocols.some((p) => p.name === op.protocol)\n      )\n        invalid(\"mount protocol was not negotiated\");\n      if (op.main !== undefined && typeof op.main !== \"boolean\")\n        invalid(\"main must be boolean\");\n      if (\n        op.main === true &&\n        [...documents.values()].some(\n          (d) => d.protocol === op.protocol && d.main,\n        )\n      )\n        invalid(\"protocol already has a main document\");\n      if (\n        op.key !== undefined &&\n        [...documents.values()].some(\n          (d) =>\n            d.protocol === op.protocol &&\n            JSON.stringify(d.key) === JSON.stringify(op.key),\n        )\n      )\n        invalid(\"protocol document key is already mounted\");\n      documents.set(doc, {\n        key: op.key === undefined ? null : (op.key as string[]),\n        ...(op.protocol === undefined\n          ? {}\n          : { protocol: op.protocol as string }),\n        ...(op.main === undefined ? {} : { main: op.main as boolean }),\n        value:\n          op.meta === undefined\n            ? op.value\n            : reviveValue(op.value, op.meta, { rejectUnknown: strict }),\n      });\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"unmount\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!documents.delete(doc)) invalid(\"document is not mounted\");\n      if (doc === 0) changedPaths.push([]);\n    } else if (op.op === \"add\" || op.op === \"replace\" || op.op === \"remove\") {\n      const document = documents.get(doc);\n      if (\n        protocols !== undefined &&\n        document !== undefined &&\n        !protocols.some((p) => p.name === document.protocol)\n      )\n        invalid(\"document protocol was not negotiated\");\n      if (!document) invalid(\"document is not mounted\");\n      if (\n        !Array.isArray(op.path) ||\n        !op.path.every(\n          (part) =>\n            typeof part === \"string\" ||\n            (typeof part === \"number\" &&\n              Number.isSafeInteger(part) &&\n              part >= 0),\n        )\n      ) {\n        invalid(\"operation requires a valid path\");\n      }\n      if (op.op !== \"remove\" && !(\"value\" in op))\n        invalid(\"operation requires a value\");\n      const { doc: _doc, meta, ...mutation } = op;\n      if (meta !== undefined)\n        mutation.value = reviveValue(mutation.value, meta, {\n          rejectUnknown: strict,\n        });\n      const applied = applyOps(document.value, [mutation]);\n      documents.set(doc, { ...document, value: applied.state });\n      if (doc === 0) changedPaths.push(...applied.changedPaths);\n    }\n  }\n  if (mode === null) invalid(\"hello missing snapshot\");\n  return { mode, documents, changedPaths };\n};\n\nexport const mainDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n) =>\n  [...state.documents.values()].find(\n    (document) => document.protocol === protocol && document.main,\n  );\n\nexport const resolveDocumentKey = (\n  key: readonly string[],\n  prefix?: readonly string[],\n) =>\n  key[0] === \".\"\n    ? prefix === undefined\n      ? undefined\n      : [...prefix, ...key.slice(1)]\n    : key;\n\nexport const findDocument = (\n  state: StatewireDocuments.State,\n  protocol: string,\n  key?: readonly string[],\n  prefix?: readonly string[],\n) => {\n  if (key === undefined) return mainDocument(state, protocol);\n  const resolved = resolveDocumentKey(key, prefix);\n  return [...state.documents.values()].find(\n    (document) =>\n      document.protocol === protocol &&\n      document.key !== null &&\n      (JSON.stringify(document.key) === JSON.stringify(key) ||\n        (resolved !== undefined &&\n          JSON.stringify(resolveDocumentKey(document.key, prefix)) ===\n            JSON.stringify(resolved))),\n  );\n};\n"],"mappings":"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"}

package/dist/wire/meta.d.ts

@@ -1,29 +1,14 @@
+import { StatewireDocument, reviveDocumentValue } from "../document.js";
 //#region src/wire/meta.d.ts
-type StatewireMetaEntry = {
-  path: (string | number)[];
-  type: string;
-};
-/** Revive meta-typed locations inside a wire value (in place). Clients skip
- * unknown types; hosts pass `rejectUnknown` to fault on them instead. */
-declare const reviveValue: (value: unknown, meta: unknown, { rejectUnknown }?: {
-  rejectUnknown?: boolean | undefined;
-}) => unknown;
 declare const reviveOps: (ops: unknown[]) => unknown[];
 declare const reviveResponse: <T extends {
   payload?: unknown;
   meta?: unknown;
 }>(response: T) => T;
-/** Encode Date instances inside command params as canonical ISO strings,
- * recording their paths (starting at the param index) in meta. */
 declare const encodeParams: (params: readonly unknown[]) => {
   params: unknown[];
-  meta?: StatewireMetaEntry[];
-};
-/** Encode Date instances inside a wire value, recording their paths in meta. */
-declare const encodeValue: (value: unknown) => {
-  value: unknown;
-  meta?: StatewireMetaEntry[];
+  meta?: StatewireDocument.MetaEntry[];
 };
 //#endregion
-export { StatewireMetaEntry, encodeParams, encodeValue, reviveOps, reviveResponse, reviveValue };
+export { encodeParams, reviveOps, reviveResponse, reviveDocumentValue as reviveValue };
 //# sourceMappingURL=meta.d.ts.map

package/dist/wire/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","names":[],"sources":["../../src/wire/meta.ts"],"mappings":";KAEY;EACV;EACA;;;;cAiBW,cACX,gBACA,iBACA;;;cAkCW,YAAa;cAOb,iBAAkB;EAAY;EAAmB;GAC5D,UAAU,MACT;;;cA+BU,eACX;EACG;EAAmB,OAAO;;;cAOlB,cACX;EACG;EAAgB,OAAO"}
+{"version":3,"file":"meta.d.ts","names":[],"sources":["../../src/wire/meta.ts"],"mappings":";;cAQa,YAAa;cAOb,iBAAkB;EAAY;EAAmB;GAC5D,UAAU,MACT;cAMU,eACX;EACG;EAAmB,OAAO,kBAAkB"}

package/dist/wire/meta.js

@@ -1,36 +1,11 @@
-import { walkStatePath } from "../util/statePath.js";
+import { encodeDocument, reviveDocumentValue } from "../document.js";
 //#region src/wire/meta.ts
-const fault = (message) => {
-	throw new Error(`statewire: protocol error: ${message}`);
-};
-const isPath = (path) => Array.isArray(path) && path.every((seg) => typeof seg === "string" || typeof seg === "number" && Number.isInteger(seg));
-/** Revive meta-typed locations inside a wire value (in place). Clients skip
-* unknown types; hosts pass `rejectUnknown` to fault on them instead. */
-const reviveValue = (value, meta, { rejectUnknown = false } = {}) => {
-	if (!Array.isArray(meta)) return fault("meta must be an array");
-	for (const entry of meta) {
-		const path = typeof entry === "object" && entry !== null ? entry.path : null;
-		if (!isPath(path)) return fault("meta entry must carry a path array");
-		if (entry.type !== "date") {
-			if (rejectUnknown) return fault(`unknown meta type: ${String(entry.type)}`);
-			continue;
-		}
-		const walked = walkStatePath(value, path, "resolve");
-		if (walked === void 0) return fault(`meta path ${path.join(".")} does not resolve`);
-		if (typeof walked.leaf !== "string") return fault(`meta path ${path.join(".")} must name a string`);
-		const date = new Date(walked.leaf);
-		if (!/(?:T| )\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})$/i.test(walked.leaf) || Number.isNaN(date.getTime())) return fault(`invalid date at meta path ${path.join(".")}`);
-		if (walked.parent === void 0) return date;
-		walked.parent[walked.key] = date;
-	}
-	return value;
-};
 const reviveOps = (ops) => ops.map((op) => {
 	if (typeof op !== "object" || op === null || !("meta" in op)) return op;
 	const { meta, ...rest } = op;
 	return {
 		...rest,
-		value: reviveValue(rest.value, meta)
+		value: reviveDocumentValue(rest.value, meta)
 	};
 });
 const reviveResponse = (response) => {
@@ -38,41 +13,17 @@ const reviveResponse = (response) => {
 	const { meta, ...rest } = response;
 	return {
 		...rest,
-		payload: reviveValue(rest.payload, meta)
+		payload: reviveDocumentValue(rest.payload, meta)
 	};
 };
-const walkDates = (node, path, meta) => {
-	if (node instanceof Date) {
-		meta.push({
-			path,
-			type: "date"
-		});
-		return node.toISOString();
-	}
-	if (Array.isArray(node)) return node.map((item, i) => walkDates(item, [...path, i], meta));
-	if (typeof node === "object" && node !== null) return Object.fromEntries(Object.keys(node).map((key) => [key, walkDates(node[key], [...path, key], meta)]));
-	return node;
-};
-/** Encode Date instances inside command params as canonical ISO strings,
-* recording their paths (starting at the param index) in meta. */
 const encodeParams = (params) => {
-	const meta = [];
-	const encoded = params.map((param, i) => walkDates(param, [i], meta));
-	return meta.length > 0 ? {
-		params: encoded,
-		meta
-	} : { params: encoded };
-};
-/** Encode Date instances inside a wire value, recording their paths in meta. */
-const encodeValue = (value) => {
-	const meta = [];
-	const encoded = walkDates(value, [], meta);
-	return meta.length > 0 ? {
-		value: encoded,
+	const { value, meta } = encodeDocument(params);
+	return meta ? {
+		params: value,
 		meta
-	} : { value: encoded };
+	} : { params: value };
 };
 //#endregion
-export { encodeParams, encodeValue, reviveOps, reviveResponse, reviveValue };
+export { encodeParams, reviveOps, reviveResponse, reviveDocumentValue as reviveValue };
 
 //# sourceMappingURL=meta.js.map

package/dist/wire/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","names":["walkStatePath","StatewireMetaEntry","path","type","fault","message","Error","isPath","Array","isArray","every","seg","Number","isInteger","reviveValue","value","meta","rejectUnknown","entry","String","walked","undefined","join","leaf","date","Date","test","isNaN","getTime","parent","Record","key","reviveOps","ops","map","op","rest","reviveResponse","payload","response","T","walkDates","node","push","toISOString","item","i","Object","fromEntries","keys","encodeParams","params","encoded","param","length","encodeValue"],"sources":["../../src/wire/meta.ts"],"sourcesContent":["import { walkStatePath } from \"../util/statePath\";\n\nexport type StatewireMetaEntry = {\n  path: (string | number)[];\n  type: string;\n};\n\nconst fault = (message: string): never => {\n  throw new Error(`statewire: protocol error: ${message}`);\n};\n\nconst isPath = (path: unknown): path is (string | number)[] =>\n  Array.isArray(path) &&\n  path.every(\n    (seg) =>\n      typeof seg === \"string\" ||\n      (typeof seg === \"number\" && Number.isInteger(seg)),\n  );\n\n/** Revive meta-typed locations inside a wire value (in place). Clients skip\n * unknown types; hosts pass `rejectUnknown` to fault on them instead. */\nexport const reviveValue = (\n  value: unknown,\n  meta: unknown,\n  { rejectUnknown = false } = {},\n): unknown => {\n  if (!Array.isArray(meta)) return fault(\"meta must be an array\");\n  for (const entry of meta as { path?: unknown; type?: unknown }[]) {\n    const path =\n      typeof entry === \"object\" && entry !== null ? entry.path : null;\n    if (!isPath(path)) return fault(\"meta entry must carry a path array\");\n    if (entry.type !== \"date\") {\n      if (rejectUnknown)\n        return fault(`unknown meta type: ${String(entry.type)}`);\n      continue;\n    }\n    const walked = walkStatePath(value, path, \"resolve\");\n    if (walked === undefined) {\n      return fault(`meta path ${path.join(\".\")} does not resolve`);\n    }\n    if (typeof walked.leaf !== \"string\") {\n      return fault(`meta path ${path.join(\".\")} must name a string`);\n    }\n    const date = new Date(walked.leaf);\n    if (\n      !/(?:T| )\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})$/i.test(\n        walked.leaf,\n      ) ||\n      Number.isNaN(date.getTime())\n    ) {\n      return fault(`invalid date at meta path ${path.join(\".\")}`);\n    }\n    if (walked.parent === undefined) return date;\n    (walked.parent as Record<string | number, unknown>)[walked.key] = date;\n  }\n  return value;\n};\n\nexport const reviveOps = (ops: unknown[]): unknown[] =>\n  ops.map((op) => {\n    if (typeof op !== \"object\" || op === null || !(\"meta\" in op)) return op;\n    const { meta, ...rest } = op as { meta: unknown; value?: unknown };\n    return { ...rest, value: reviveValue(rest.value, meta) };\n  });\n\nexport const reviveResponse = <T extends { payload?: unknown; meta?: unknown }>(\n  response: T,\n): T => {\n  if (response.meta === undefined) return response;\n  const { meta, ...rest } = response;\n  return { ...rest, payload: reviveValue(rest.payload, meta) } as T;\n};\n\nconst walkDates = (\n  node: unknown,\n  path: (string | number)[],\n  meta: StatewireMetaEntry[],\n): unknown => {\n  if (node instanceof Date) {\n    meta.push({ path, type: \"date\" });\n    return node.toISOString();\n  }\n  if (Array.isArray(node)) {\n    return node.map((item, i) => walkDates(item, [...path, i], meta));\n  }\n  if (typeof node === \"object\" && node !== null) {\n    return Object.fromEntries(\n      Object.keys(node).map((key) => [\n        key,\n        walkDates((node as Record<string, unknown>)[key], [...path, key], meta),\n      ]),\n    );\n  }\n  return node;\n};\n\n/** Encode Date instances inside command params as canonical ISO strings,\n * recording their paths (starting at the param index) in meta. */\nexport const encodeParams = (\n  params: readonly unknown[],\n): { params: unknown[]; meta?: StatewireMetaEntry[] } => {\n  const meta: StatewireMetaEntry[] = [];\n  const encoded = params.map((param, i) => walkDates(param, [i], meta));\n  return meta.length > 0 ? { params: encoded, meta } : { params: encoded };\n};\n\n/** Encode Date instances inside a wire value, recording their paths in meta. */\nexport const encodeValue = (\n  value: unknown,\n): { value: unknown; meta?: StatewireMetaEntry[] } => {\n  const meta: StatewireMetaEntry[] = [];\n  const encoded = walkDates(value, [], meta);\n  return meta.length > 0 ? { value: encoded, meta } : { value: encoded };\n};\n"],"mappings":"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"}
+{"version":3,"file":"meta.js","names":["encodeDocument","reviveDocumentValue","reviveValue","StatewireDocument","reviveOps","ops","map","op","meta","rest","value","reviveResponse","payload","response","T","undefined","encodeParams","params","MetaEntry"],"sources":["../../src/wire/meta.ts"],"sourcesContent":["import {\n  encodeDocument,\n  reviveDocumentValue as reviveValue,\n} from \"../document\";\nimport type { StatewireDocument } from \"../document\";\n\nexport { reviveDocumentValue as reviveValue } from \"../document\";\n\nexport const reviveOps = (ops: unknown[]): unknown[] =>\n  ops.map((op) => {\n    if (typeof op !== \"object\" || op === null || !(\"meta\" in op)) return op;\n    const { meta, ...rest } = op as { meta: unknown; value?: unknown };\n    return { ...rest, value: reviveValue(rest.value, meta) };\n  });\n\nexport const reviveResponse = <T extends { payload?: unknown; meta?: unknown }>(\n  response: T,\n): T => {\n  if (response.meta === undefined) return response;\n  const { meta, ...rest } = response;\n  return { ...rest, payload: reviveValue(rest.payload, meta) } as T;\n};\n\nexport const encodeParams = (\n  params: readonly unknown[],\n): { params: unknown[]; meta?: StatewireDocument.MetaEntry[] } => {\n  const { value, meta } = encodeDocument(params);\n  return meta\n    ? { params: value as unknown[], meta }\n    : { params: value as unknown[] };\n};\n"],"mappings":";;AAQA,MAAaI,aAAaC,QACxBA,IAAIC,KAAKC,OAAO;CACd,IAAI,OAAOA,OAAO,YAAYA,OAAO,QAAQ,EAAE,UAAUA,KAAK,OAAOA;CACrE,MAAM,EAAEC,MAAM,GAAGC,SAASF;CAC1B,OAAO;EAAE,GAAGE;EAAMC,OAAOR,oBAAYO,KAAKC,OAAOF,IAAI;CAAE;AACzD,CAAC;AAEH,MAAaG,kBACXE,aACM;CACN,IAAIA,SAASL,SAASO,KAAAA,GAAW,OAAOF;CACxC,MAAM,EAAEL,MAAM,GAAGC,SAASI;CAC1B,OAAO;EAAE,GAAGJ;EAAMG,SAASV,oBAAYO,KAAKG,SAASJ,IAAI;CAAE;AAC7D;AAEA,MAAaQ,gBACXC,WACgE;CAChE,MAAM,EAAEP,OAAOF,SAASR,eAAeiB,MAAM;CAC7C,OAAOT,OACH;EAAES,QAAQP;EAAoBF;CAAK,IACnC,EAAES,QAAQP,MAAmB;AACnC"}

package/dist/wire/ops.js

@@ -1,5 +1,5 @@
-import { recordMutations } from "../util/recordMutations.js";
 import { isUnsafeKey, walkStatePath } from "../util/statePath.js";
+import { recordMutations } from "../util/recordMutations.js";
 //#region src/wire/ops.ts
 const warnStripped = (key, parent) => {
 	if (typeof process === "undefined" || process.env["NODE_ENV"] !== "production") console.warn(`statewire: stripped unsafe key "${key}"` + (parent === void 0 ? "" : ` under "${parent}"`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statewire",
-  "version": "0.17.0",
+  "version": "0.17.2",
   "description": "State over the wire: snapshot-first delta streaming and command submission for any state and any command",
   "license": "MIT",
   "repository": {

package/src/client/session.ts

@@ -1,3 +1,4 @@
+import { encodeDocument } from "../document";
 import {
   DEFAULT_PROTOCOL,
   WIRE_VERSION,
@@ -18,12 +19,7 @@ import type { StatewirePath } from "../wire/ops";
 import { MAX_COMMANDS_PER_FRAME } from "../wire/limits";
 import { TERMINAL } from "./connection";
 import type { StatewireCmd, StatewireSyn } from "./connection";
-import {
-  encodeParams,
-  encodeValue,
-  reviveResponse,
-  reviveValue,
-} from "../wire/meta";
+import { encodeParams, reviveResponse, reviveValue } from "../wire/meta";
 import { bindCommandsHost } from "../host/host";
 import type { CommandsInvocation, CommandsListener } from "../host/host";
 import type { Statewire } from "../types";
@@ -584,6 +580,32 @@ const publishIngested = (s: Session) => {
 // unloaded): held seqs resend as-is and the frame's answer arbitrates —
 // absorption where the record survived, a gap refusal where it did not.
 const snapCtxClock = (s: Session, ctxWm: number) => {
+  if (s.record.context?.recover === "version-1") {
+    const document = s.contextDocuments.documents.get(0);
+    if (s.contextDocuments.documents.size !== 1 || !document?.main)
+      throw new Error(
+        "statewire: version-1 context recovery requires one main document at doc 0",
+      );
+    const encoded = encodeDocument(document.value);
+    const ops = [
+      {
+        ...(ctxWm === 0
+          ? { op: "mount", protocol: document.protocol, main: true }
+          : { op: "replace", path: [] }),
+        ...encoded,
+      },
+    ];
+    s.ctxPending = [{ seq: ctxWm + 1, ops, posted: false }];
+    setRecord(s, {
+      ...s.record,
+      ctxNextSeq: ctxWm + 2,
+      context: {
+        ops: contextSnapshot(s.contextDocuments),
+        pending: s.ctxPending,
+      },
+    });
+    return;
+  }
   const ctxAligned =
     s.ctxPending.every((c, i) => c.seq === ctxWm + 1 + i) &&
     s.record.ctxNextSeq === ctxWm + s.ctxPending.length + 1;
@@ -798,7 +820,8 @@ const takeAttachLanes = (s: Session): StatewireFrame | null => {
   s.attachLaneSeqs = [new Set(), new Set()];
   const wanted = s.lanesOnAttach;
   s.lanesOnAttach = false;
-  if (!wanted || !s.sessionKnown) return null;
+  if (!wanted || !s.sessionKnown || s.record.context?.recover !== undefined)
+    return null;
   const lanes = buildLanes(s);
   if (!lanes) return null;
   s.attachLaneSeqs = [
@@ -1165,7 +1188,7 @@ export const retryFailed = (
 
 const contextSnapshot = (documents: StatewireDocuments.State) =>
   [...documents.documents].map(([doc, d]) => {
-    const encoded = encodeValue(d.value);
+    const encoded = encodeDocument(d.value);
     return {
       op: "mount",
       ...(doc === 0 ? {} : { doc }),
@@ -1184,6 +1207,9 @@ const persistContext = (s: Session) => {
     ...s.record,
     context: {
       ops,
+      ...(s.record.context?.recover === undefined
+        ? {}
+        : { recover: s.record.context.recover }),
       pending: s.ctxPending.map(({ seq, ops }) => ({ seq, ops })),
     },
   });
@@ -1253,7 +1279,7 @@ const setContext = (
 ): void => {
   if (typeof value !== "object" || value === null || Array.isArray(value))
     throw new Error("statewire: context must be a plain object");
-  const encoded = encodeValue(value);
+  const encoded = encodeDocument(value);
   changeContext(s, (documents) => {
     const found = [...documents.documents].find(
       ([, d]) => d.protocol === protocol && d.main,