@playfast/reform-remote-web 0.0.2 → 0.0.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@playfast/reform-remote-web",
   "playbook": "./playbook",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "description": "Browser/web WebSocket client transport for reform-remote — streams a server-run reform scene to a thin renderer.",
   "keywords": [
@@ -27,7 +27,7 @@
     "./*": "./src/*.ts"
   },
   "files": [
-    "dist",
+    "src",
     "README.md"
   ],
   "scripts": {

package/src/client.test.ts

@@ -0,0 +1,155 @@
+import type { AddressInfo } from 'node:net'
+import { createElement, Fragment, type ReactNode } from 'react'
+import { renderToStaticMarkup } from 'react-dom/server'
+import { afterEach, expect, test, vi } from 'vitest'
+import { Layer, Schema as S } from 'effect'
+import {
+  Composition,
+  Engine,
+  Event,
+  Reducer,
+  State,
+  StateGroup,
+  Ui,
+  provide,
+  scene,
+  ui,
+} from '@playfast/reform'
+import { connect, remoteViews } from '@playfast/reform-remote'
+import { type NodeWebSocketServer, serveNodeWebSocket } from '@playfast/reform-remote-node'
+import { createWebSocketClientTransport } from './index'
+
+// Self-contained counter scene for the server end of the round-trip.
+class Count extends State.make('count', S.Number) {}
+class Counters extends StateGroup.make(Count) {}
+class Bumped extends Event.make('Bumped', S.Struct({ by: S.Number })) {}
+class Bump extends Reducer.make('Bump', { states: [Count], events: [Bumped] }) {}
+class CounterUi extends ui('Counter', {
+  props: S.Struct({ count: S.Number }),
+  events: { bump: S.Struct({ by: S.Number }) },
+}) {}
+class Counter extends Composition.make('Counter', { title: 'Counter', ui: CounterUi, states: [Count] }) {}
+
+const counterScene = () => {
+  const presentation = Layer.mergeAll(
+    provide(CounterUi, Ui.make(CounterUi, ({ count }) => `count:${count}`)),
+    StateGroup.live(Counters, { count: 0 }),
+  )
+  const app = Layer.mergeAll(
+    Composition.live(Counter, function* () {
+      const count = yield* StateGroup.select(Counters, 'count')
+      const bump = yield* Event.trigger(Bumped)
+      return (yield* CounterUi)({ count }, { bump })
+    }),
+    Reducer.live(Bump, (n, event) => n + event.by),
+  ).pipe(Layer.provideMerge(presentation), Layer.provideMerge(Engine))
+  return scene(Counter, { provide: [app] })
+}
+
+interface Probe {
+  props?: Record<string, unknown>
+  // The counter contract's only event, `bump`, takes `{ by: number }`.
+  events?: Record<string, (payload: { by: number }) => void>
+}
+const probeView = (probe: Probe) =>
+  Ui.make(CounterUi, (props, _slots, events) => {
+    probe.props = props
+    probe.events = events
+    return null
+  })
+
+// Views render as React components now, so a test runs them by rendering node().
+const draw = (node: ReactNode): void => void renderToStaticMarkup(createElement(Fragment, null, node))
+
+const listening = (host: NodeWebSocketServer): Promise<number> =>
+  new Promise((resolve) =>
+    host.wss.once('listening', () => resolve((host.wss.address() as AddressInfo).port)),
+  )
+
+const open = new Set<NodeWebSocketServer>()
+afterEach(async () => {
+  await Promise.all([...open].map((host) => host.stop()))
+  open.clear()
+})
+
+test('the web client renders server state over a real socket and drives it back', async () => {
+  const host = serveNodeWebSocket({ scene: counterScene() })
+  open.add(host)
+  const port = await listening(host)
+
+  const transport = createWebSocketClientTransport({ url: `ws://localhost:${port}` })
+  const probe: Probe = {}
+  const client = connect({
+    transport,
+    views: remoteViews<{ Counter: typeof CounterUi }>({ Counter: probeView(probe) }),
+  })
+  try {
+    await vi.waitFor(() => {
+      draw(client.node())
+      expect(probe.props).toEqual({ count: 0 })
+    })
+
+    probe.events?.['bump']?.({ by: 6 })
+    await vi.waitFor(() => {
+      draw(client.node())
+      expect(probe.props).toEqual({ count: 6 })
+    })
+    expect(transport.status()).toBe('open')
+  } finally {
+    transport.close()
+    client.dispose()
+  }
+})
+
+test('a dropped connection reconnects with backoff and re-syncs via the fresh snapshot', async () => {
+  const host = serveNodeWebSocket({ scene: counterScene() })
+  open.add(host)
+  const port = await listening(host)
+
+  const transport = createWebSocketClientTransport({
+    url: `ws://localhost:${port}`,
+    baseDelayMs: 20,
+    maxDelayMs: 80,
+  })
+  const probe: Probe = {}
+  const client = connect({
+    transport,
+    views: remoteViews<{ Counter: typeof CounterUi }>({ Counter: probeView(probe) }),
+  })
+  try {
+    // Live, then bump so the client holds a non-zero count.
+    await vi.waitFor(() => {
+      draw(client.node())
+      expect(probe.props).toEqual({ count: 0 })
+    })
+    probe.events?.['bump']?.({ by: 5 })
+    await vi.waitFor(() => {
+      draw(client.node())
+      expect(probe.props).toEqual({ count: 5 })
+    })
+
+    // Kill the server out from under the client.
+    await host.stop()
+    open.delete(host)
+    await vi.waitFor(() => expect(transport.status()).toBe('reconnecting'))
+
+    // Bring a fresh runtime back on the same port. The client reconnects and the
+    // new session's snapshot resets the tree — count is 0 again, proving re-sync
+    // (not the stale 5).
+    const restarted = serveNodeWebSocket({ scene: counterScene(), port })
+    open.add(restarted)
+    await listening(restarted)
+
+    await vi.waitFor(
+      () => {
+        draw(client.node())
+        expect(probe.props).toEqual({ count: 0 })
+        expect(transport.status()).toBe('open')
+      },
+      { timeout: 4000 },
+    )
+  } finally {
+    transport.close()
+    client.dispose()
+  }
+})

package/{dist/errors.d.ts → src/errors.ts}

@@ -1,22 +1,26 @@
-import { type Cause } from 'effect';
+import { type Cause, Data } from 'effect'
+
 /**
  * Tagged errors for the web client transport. Every failure carries a `_tag` and
  * structured fields — never a bare `Error` — so callers can match with Effect
  * `catchTag` / `Match`. Tags are namespaced by package to stay globally unique.
  */
+
 /**
  * The constructor shape `Data.TaggedError(tag)<A>` produces, named so the
  * generated `.d.ts` can describe the `extends` base under `isolatedDeclarations`
  * (which forbids an inferred expression in an extends clause).
  */
-type TaggedErrorClass<Tag extends string, A extends Record<string, unknown>> = new (args: A) => Cause.YieldableError & {
-    readonly _tag: Tag;
-} & Readonly<A>;
-declare const MissingWebSocketBase: TaggedErrorClass<'@playfast/reform-remote-web/MissingWebSocket', {
-    readonly message: string;
-}>;
+type TaggedErrorClass<Tag extends string, A extends Record<string, unknown>> = new (
+  args: A,
+) => Cause.YieldableError & { readonly _tag: Tag } & Readonly<A>
+
+const MissingWebSocketBase: TaggedErrorClass<
+  '@playfast/reform-remote-web/MissingWebSocket',
+  { readonly message: string }
+> = Data.TaggedError('@playfast/reform-remote-web/MissingWebSocket')<{
+  readonly message: string
+}>
+
 /** Thrown when no `WebSocket` is available and none was injected via options. */
-export declare class MissingWebSocket extends MissingWebSocketBase {
-}
-export {};
-//# sourceMappingURL=errors.d.ts.map
+export class MissingWebSocket extends MissingWebSocketBase {}

package/{dist/index.js → src/index.ts}

@@ -6,8 +6,14 @@
  * from "@playfast/reform-remote-web/transport"`). The select re-exports below keep
  * the common entry points nameable from the root.
  */
-export * as Transport from './transport.js';
-export * as Errors from './errors.js';
-export { createWebSocketClientTransport, } from './transport.js';
-export { MissingWebSocket } from './errors.js';
-//# sourceMappingURL=index.js.map
+
+export * as Transport from './transport.js'
+export * as Errors from './errors.js'
+
+export {
+  type ClientStatus,
+  createWebSocketClientTransport,
+  type WebSocketClientTransport,
+  type WebSocketClientTransportOptions,
+} from './transport.js'
+export { MissingWebSocket } from './errors.js'

package/src/transport.ts

@@ -0,0 +1,175 @@
+import { Redacted } from 'effect'
+import type { InvokeMessage, RemoteTransport, ServerMessage } from '@playfast/reform-remote'
+import { MissingWebSocket } from './errors.js'
+
+/**
+ * The browser/web client side of the remote transport. A factory that wraps a
+ * WebSocket into a `RemoteTransport` you hand to `connect({ transport, views })`:
+ * it sends `Invoke`s up and surfaces `Snapshot`/`Patches` down, with JSON framing.
+ *
+ * It owns reconnection so the caller doesn't have to: a dropped socket is retried
+ * with exponential backoff, and because the message handlers persist across
+ * sockets, the server's first frame on the new connection — always a `Snapshot` —
+ * re-syncs the tree automatically (no stale nodes leak). Works anywhere a global
+ * `WebSocket` exists (browsers, Bun, Node 22+); inject one via `options` otherwise.
+ * There is no React hook — this is the transport only.
+ */
+
+export type ClientStatus = 'connecting' | 'open' | 'reconnecting' | 'closed'
+
+/**
+ * Options for {@link createWebSocketClientTransport}. A single named-options object
+ * (no positional args) so every reform-remote adapter constructor has the same
+ * shape and the client transports stay drop-in swappable.
+ */
+export interface WebSocketClientTransportOptions {
+  /** The WebSocket URL to connect to (e.g. `ws://127.0.0.1:8787/reform`). */
+  readonly url: string
+  /** First reconnect delay; doubles each attempt up to `maxDelayMs`. Default 250ms. */
+  readonly baseDelayMs?: number
+  /** Ceiling for the backoff delay. Default 5000ms. */
+  readonly maxDelayMs?: number
+  /** Subprotocols passed to the `WebSocket` constructor. */
+  readonly protocols?: string | ReadonlyArray<string>
+  /**
+   * A bearer token to authenticate the connection. A browser `WebSocket` can't set headers,
+   * so the only header-like channel is the subprotocol list: the token rides as an extra
+   * `bearer.<token>` subprotocol alongside any {@link protocols}. The server reads it off
+   * `Sec-WebSocket-Protocol` at the upgrade. Held `Redacted` so it never logs.
+   */
+  readonly authToken?: Redacted.Redacted<string>
+  /** The `WebSocket` implementation to use. Defaults to the global. */
+  readonly WebSocket?: typeof WebSocket
+  /** Notified on every connection-status transition. */
+  readonly onStatus?: (status: ClientStatus) => void
+}
+
+/** A `RemoteTransport` that also exposes its connection status and a manual close. */
+export type WebSocketClientTransport = RemoteTransport<InvokeMessage, ServerMessage> & {
+  readonly status: () => ClientStatus
+  /**
+   * Subscribe to status transitions (returns an unsubscribe). With `status()`
+   * this satisfies the React binding's `StatusReporter`, so `useConnectionStatus`
+   * can drive a reconnecting badge with no manual store.
+   */
+  readonly onStatusChange: (listener: () => void) => () => void
+  /** Stop reconnecting and close the socket. The transport is inert afterwards. */
+  readonly close: () => void
+}
+
+const resolveWebSocket = (injected: typeof WebSocket | undefined): typeof WebSocket => {
+  const impl = injected ?? (globalThis as { WebSocket?: typeof WebSocket }).WebSocket
+  if (impl === undefined) {
+    throw new MissingWebSocket({
+      message: 'No global WebSocket; pass `WebSocket` in options (e.g. the `ws` package in Node <22).',
+    })
+  }
+  return impl
+}
+
+export const createWebSocketClientTransport = (
+  options: WebSocketClientTransportOptions,
+): WebSocketClientTransport => {
+  const url = options.url
+  const WS = resolveWebSocket(options.WebSocket)
+  const baseDelayMs = options.baseDelayMs ?? 250
+  const maxDelayMs = options.maxDelayMs ?? 5000
+
+  // Normalize `protocols` to an array and fold in the auth token as a `bearer.<token>`
+  // subprotocol. Computed once (the token doesn't change across reconnects). `undefined`
+  // when there's nothing to send, so the no-auth path matches the original behavior.
+  const baseProtocols: ReadonlyArray<string> =
+    options.protocols === undefined
+      ? []
+      : typeof options.protocols === 'string'
+        ? [options.protocols]
+        : options.protocols
+  const protocols: ReadonlyArray<string> | undefined =
+    options.authToken !== undefined
+      ? [`bearer.${Redacted.value(options.authToken)}`, ...baseProtocols]
+      : baseProtocols.length === 0
+        ? undefined
+        : baseProtocols
+
+  const handlers = new Set<(message: ServerMessage) => void>()
+  const statusListeners = new Set<() => void>()
+  const queue: Array<InvokeMessage> = []
+  // A const holder whose fields swap — the codebase's no-`let` idiom.
+  const state: {
+    socket: WebSocket | null
+    status: ClientStatus
+    attempts: number
+    timer: ReturnType<typeof setTimeout> | null
+  } = { socket: null, status: 'connecting', attempts: 0, timer: null }
+
+  const setStatus = (status: ClientStatus): void => {
+    if (status === state.status) return
+    state.status = status
+    options.onStatus?.(status)
+    for (const listener of statusListeners) listener()
+  }
+
+  const flush = (): void => {
+    const socket = state.socket
+    if (socket === null || socket.readyState !== WS.OPEN) return
+    const pending = queue.splice(0, queue.length)
+    for (const message of pending) socket.send(JSON.stringify(message))
+  }
+
+  const scheduleReconnect = (): void => {
+    if (state.status === 'closed') return
+    setStatus('reconnecting')
+    const delay = Math.min(maxDelayMs, baseDelayMs * 2 ** state.attempts)
+    state.attempts += 1
+    state.timer = setTimeout(connect, delay)
+  }
+
+  // A drop while live (or a failed connect) backs off and retries. A socket can
+  // fire both `error` and `close`, so guard on identity — null out the current
+  // socket on the first drop, so the second event is a no-op and only one
+  // reconnect is scheduled. A user `close` flips the status, making this inert.
+  const handleDrop = (socket: WebSocket): void => {
+    if (state.socket !== socket) return
+    state.socket = null
+    scheduleReconnect()
+  }
+
+  function connect(): void {
+    const socket = protocols === undefined ? new WS(url) : new WS(url, [...protocols])
+    state.socket = socket
+    socket.addEventListener('open', () => {
+      state.attempts = 0
+      setStatus('open')
+      flush()
+    })
+    socket.addEventListener('message', (event: MessageEvent) => {
+      const message = JSON.parse(event.data as string) as ServerMessage
+      for (const handler of handlers) handler(message)
+    })
+    socket.addEventListener('close', () => handleDrop(socket))
+    socket.addEventListener('error', () => handleDrop(socket))
+  }
+
+  connect()
+
+  return {
+    send: (message) => {
+      queue.push(message)
+      flush()
+    },
+    onMessage: (handler) => {
+      handlers.add(handler)
+      return () => void handlers.delete(handler)
+    },
+    status: () => state.status,
+    onStatusChange: (listener) => {
+      statusListeners.add(listener)
+      return () => void statusListeners.delete(listener)
+    },
+    close: () => {
+      setStatus('closed')
+      if (state.timer !== null) clearTimeout(state.timer)
+      state.socket?.close()
+    },
+  }
+}

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAQ,MAAM,QAAQ,CAAA;AAEzC;;;;GAIG;AAEH;;;;GAIG;AACH,KAAK,gBAAgB,CAAC,GAAG,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,KAC7E,IAAI,EAAE,CAAC,KACJ,KAAK,CAAC,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAEhE,QAAA,MAAM,oBAAoB,EAAE,gBAAgB,CAC1C,8CAA8C,EAC9C;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAG5B,CAAA;AAEF,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,oBAAoB;CAAG"}

package/dist/errors.js

@@ -1,6 +0,0 @@
-import { Data } from 'effect';
-const MissingWebSocketBase = (Data.TaggedError('@playfast/reform-remote-web/MissingWebSocket'));
-/** Thrown when no `WebSocket` is available and none was injected via options. */
-export class MissingWebSocket extends MissingWebSocketBase {
-}
-//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,IAAI,EAAE,MAAM,QAAQ,CAAA;AAiBzC,MAAM,oBAAoB,GAGtB,CAAA,IAAI,CAAC,WAAW,CAAC,8CAA8C,CAEjE,CAAA,CAAA;AAEF,iFAAiF;AACjF,MAAM,OAAO,gBAAiB,SAAQ,oBAAoB;CAAG"}

package/dist/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * `@playfast/reform-remote-web` — the browser/web client side of the remote
- * transport. Public API is exposed two ways (Effect-style): namespace barrels for
- * discovery (`import { Transport } from "@playfast/reform-remote-web"`) and
- * per-path subpaths for direct use (`import { createWebSocketClientTransport }
- * from "@playfast/reform-remote-web/transport"`). The select re-exports below keep
- * the common entry points nameable from the root.
- */
-export * as Transport from './transport.js';
-export * as Errors from './errors.js';
-export { type ClientStatus, createWebSocketClientTransport, type WebSocketClientTransport, type WebSocketClientTransportOptions, } from './transport.js';
-export { MissingWebSocket } from './errors.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,EACL,KAAK,YAAY,EACjB,8BAA8B,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,GACrC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,EAEL,8BAA8B,GAG/B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/transport.d.ts

@@ -1,55 +0,0 @@
-import { Redacted } from 'effect';
-import type { InvokeMessage, RemoteTransport, ServerMessage } from '@playfast/reform-remote';
-/**
- * The browser/web client side of the remote transport. A factory that wraps a
- * WebSocket into a `RemoteTransport` you hand to `connect({ transport, views })`:
- * it sends `Invoke`s up and surfaces `Snapshot`/`Patches` down, with JSON framing.
- *
- * It owns reconnection so the caller doesn't have to: a dropped socket is retried
- * with exponential backoff, and because the message handlers persist across
- * sockets, the server's first frame on the new connection — always a `Snapshot` —
- * re-syncs the tree automatically (no stale nodes leak). Works anywhere a global
- * `WebSocket` exists (browsers, Bun, Node 22+); inject one via `options` otherwise.
- * There is no React hook — this is the transport only.
- */
-export type ClientStatus = 'connecting' | 'open' | 'reconnecting' | 'closed';
-/**
- * Options for {@link createWebSocketClientTransport}. A single named-options object
- * (no positional args) so every reform-remote adapter constructor has the same
- * shape and the client transports stay drop-in swappable.
- */
-export interface WebSocketClientTransportOptions {
-    /** The WebSocket URL to connect to (e.g. `ws://127.0.0.1:8787/reform`). */
-    readonly url: string;
-    /** First reconnect delay; doubles each attempt up to `maxDelayMs`. Default 250ms. */
-    readonly baseDelayMs?: number;
-    /** Ceiling for the backoff delay. Default 5000ms. */
-    readonly maxDelayMs?: number;
-    /** Subprotocols passed to the `WebSocket` constructor. */
-    readonly protocols?: string | ReadonlyArray<string>;
-    /**
-     * A bearer token to authenticate the connection. A browser `WebSocket` can't set headers,
-     * so the only header-like channel is the subprotocol list: the token rides as an extra
-     * `bearer.<token>` subprotocol alongside any {@link protocols}. The server reads it off
-     * `Sec-WebSocket-Protocol` at the upgrade. Held `Redacted` so it never logs.
-     */
-    readonly authToken?: Redacted.Redacted<string>;
-    /** The `WebSocket` implementation to use. Defaults to the global. */
-    readonly WebSocket?: typeof WebSocket;
-    /** Notified on every connection-status transition. */
-    readonly onStatus?: (status: ClientStatus) => void;
-}
-/** A `RemoteTransport` that also exposes its connection status and a manual close. */
-export type WebSocketClientTransport = RemoteTransport<InvokeMessage, ServerMessage> & {
-    readonly status: () => ClientStatus;
-    /**
-     * Subscribe to status transitions (returns an unsubscribe). With `status()`
-     * this satisfies the React binding's `StatusReporter`, so `useConnectionStatus`
-     * can drive a reconnecting badge with no manual store.
-     */
-    readonly onStatusChange: (listener: () => void) => () => void;
-    /** Stop reconnecting and close the socket. The transport is inert afterwards. */
-    readonly close: () => void;
-};
-export declare const createWebSocketClientTransport: (options: WebSocketClientTransportOptions) => WebSocketClientTransport;
-//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAG5F;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAA;AAE5E;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC9C,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,SAAS,CAAA;IACrC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;CACnD;AAED,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,YAAY,CAAA;IACnC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IAC7D,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAYD,eAAO,MAAM,8BAA8B,GACzC,SAAS,+BAA+B,KACvC,wBAuGF,CAAA"}

package/dist/transport.js

@@ -1,108 +0,0 @@
-import { Redacted } from 'effect';
-import { MissingWebSocket } from './errors.js';
-const resolveWebSocket = (injected) => {
-    const impl = injected ?? globalThis.WebSocket;
-    if (impl === undefined) {
-        throw new MissingWebSocket({
-            message: 'No global WebSocket; pass `WebSocket` in options (e.g. the `ws` package in Node <22).',
-        });
-    }
-    return impl;
-};
-export const createWebSocketClientTransport = (options) => {
-    const url = options.url;
-    const WS = resolveWebSocket(options.WebSocket);
-    const baseDelayMs = options.baseDelayMs ?? 250;
-    const maxDelayMs = options.maxDelayMs ?? 5000;
-    // Normalize `protocols` to an array and fold in the auth token as a `bearer.<token>`
-    // subprotocol. Computed once (the token doesn't change across reconnects). `undefined`
-    // when there's nothing to send, so the no-auth path matches the original behavior.
-    const baseProtocols = options.protocols === undefined
-        ? []
-        : typeof options.protocols === 'string'
-            ? [options.protocols]
-            : options.protocols;
-    const protocols = options.authToken !== undefined
-        ? [`bearer.${Redacted.value(options.authToken)}`, ...baseProtocols]
-        : baseProtocols.length === 0
-            ? undefined
-            : baseProtocols;
-    const handlers = new Set();
-    const statusListeners = new Set();
-    const queue = [];
-    // A const holder whose fields swap — the codebase's no-`let` idiom.
-    const state = { socket: null, status: 'connecting', attempts: 0, timer: null };
-    const setStatus = (status) => {
-        if (status === state.status)
-            return;
-        state.status = status;
-        options.onStatus?.(status);
-        for (const listener of statusListeners)
-            listener();
-    };
-    const flush = () => {
-        const socket = state.socket;
-        if (socket === null || socket.readyState !== WS.OPEN)
-            return;
-        const pending = queue.splice(0, queue.length);
-        for (const message of pending)
-            socket.send(JSON.stringify(message));
-    };
-    const scheduleReconnect = () => {
-        if (state.status === 'closed')
-            return;
-        setStatus('reconnecting');
-        const delay = Math.min(maxDelayMs, baseDelayMs * 2 ** state.attempts);
-        state.attempts += 1;
-        state.timer = setTimeout(connect, delay);
-    };
-    // A drop while live (or a failed connect) backs off and retries. A socket can
-    // fire both `error` and `close`, so guard on identity — null out the current
-    // socket on the first drop, so the second event is a no-op and only one
-    // reconnect is scheduled. A user `close` flips the status, making this inert.
-    const handleDrop = (socket) => {
-        if (state.socket !== socket)
-            return;
-        state.socket = null;
-        scheduleReconnect();
-    };
-    function connect() {
-        const socket = protocols === undefined ? new WS(url) : new WS(url, [...protocols]);
-        state.socket = socket;
-        socket.addEventListener('open', () => {
-            state.attempts = 0;
-            setStatus('open');
-            flush();
-        });
-        socket.addEventListener('message', (event) => {
-            const message = JSON.parse(event.data);
-            for (const handler of handlers)
-                handler(message);
-        });
-        socket.addEventListener('close', () => handleDrop(socket));
-        socket.addEventListener('error', () => handleDrop(socket));
-    }
-    connect();
-    return {
-        send: (message) => {
-            queue.push(message);
-            flush();
-        },
-        onMessage: (handler) => {
-            handlers.add(handler);
-            return () => void handlers.delete(handler);
-        },
-        status: () => state.status,
-        onStatusChange: (listener) => {
-            statusListeners.add(listener);
-            return () => void statusListeners.delete(listener);
-        },
-        close: () => {
-            setStatus('closed');
-            if (state.timer !== null)
-                clearTimeout(state.timer);
-            state.socket?.close();
-        },
-    };
-};
-//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}