@restless-stream/node 0.1.0

package/dist/index.cjs

@@ -0,0 +1,507 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildNodeSseUrl: () => buildNodeSseUrl,
+  createNodeRestlessClient: () => createNodeRestlessClient,
+  subscribeSse: () => subscribeSse,
+  subscribeWebSocket: () => subscribeWebSocket
+});
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("@restless-stream/core"), module.exports);
+
+// src/client.ts
+var import_core2 = require("@restless-stream/core");
+
+// src/sse.ts
+var import_core = require("@restless-stream/core");
+
+// src/url.ts
+function appendResumeParams(inputUrl, params) {
+  const url = new URL(inputUrl);
+  appendResumeParam(url.searchParams, "since", params.since);
+  appendResumeParam(url.searchParams, "cursor", params.cursor);
+  return url.toString();
+}
+function appendResumeParam(searchParams, key, value) {
+  const normalizedValue = value?.toString().trim();
+  if (normalizedValue !== void 0 && normalizedValue !== "") searchParams.set(key, normalizedValue);
+}
+
+// src/sse.ts
+function buildNodeSseUrl(options) {
+  return appendResumeParams(options.sseUrl, {
+    cursor: options.cursor,
+    since: options.since
+  });
+}
+function subscribeSse(clientOrOptions, maybeOptions) {
+  const client = maybeOptions ? clientOrOptions : clientOrOptions.client ?? (0, import_core.createRestlessClient)(clientOrOptions.clientOptions);
+  const options = maybeOptions ?? clientOrOptions;
+  const { iterableOptions, urlOptions } = splitSseOptions(options);
+  return client.sse(buildNodeSseUrl(urlOptions), iterableOptions);
+}
+function splitSseOptions(options) {
+  const { cursor, since, sseUrl } = options;
+  const urlOptions = { sseUrl };
+  if (cursor !== void 0) urlOptions.cursor = cursor;
+  if (since !== void 0) urlOptions.since = since;
+  return { iterableOptions: removeUnsafeSseOptions(options), urlOptions };
+}
+function removeUnsafeSseOptions(options) {
+  const iterableOptions = {};
+  if (options.signal !== void 0) iterableOptions.signal = options.signal;
+  if (options.reconnect !== void 0) iterableOptions.reconnect = options.reconnect;
+  if (options.reconnectDelayMs !== void 0) iterableOptions.reconnectDelayMs = options.reconnectDelayMs;
+  if (options.maxReconnectDelayMs !== void 0) iterableOptions.maxReconnectDelayMs = options.maxReconnectDelayMs;
+  return iterableOptions;
+}
+
+// src/websocket-subscription.ts
+var import_ws2 = __toESM(require("ws"), 1);
+
+// src/websocket-message.ts
+var import_ws = __toESM(require("ws"), 1);
+function parseSocketMessage(data, options, socket) {
+  const text = rawDataToText(data);
+  const heartbeat = normalizeHeartbeat(text);
+  if (heartbeat === "ping") {
+    sendApplicationPong(socket);
+    return void 0;
+  }
+  if (heartbeat === "pong") {
+    return void 0;
+  }
+  if (options.parse === false) {
+    return text;
+  }
+  const parser = options.parser ?? defaultParseSocketEvent;
+  try {
+    return parser(text);
+  } catch (textError) {
+    try {
+      return parser(JSON.parse(text));
+    } catch {
+      throw textError;
+    }
+  }
+}
+function extractCursor(event) {
+  if (event === null || event === void 0 || typeof event !== "object") {
+    return void 0;
+  }
+  const record = event;
+  const cursor = record.cursor ?? record.id ?? record.eventId ?? record.lastEventId;
+  if (typeof cursor === "string" && cursor.length > 0) {
+    return cursor;
+  }
+  if (typeof cursor === "number" && Number.isFinite(cursor) && cursor >= 0) {
+    return String(Math.trunc(cursor));
+  }
+  return extractMetaTimestampCursor(record);
+}
+function defaultParseSocketEvent(message) {
+  if (typeof message === "string") {
+    return JSON.parse(message);
+  }
+  return message;
+}
+function rawDataToText(data) {
+  if (Buffer.isBuffer(data)) {
+    return data.toString("utf8");
+  }
+  if (data instanceof ArrayBuffer) {
+    return Buffer.from(data).toString("utf8");
+  }
+  if (Array.isArray(data)) {
+    return Buffer.concat(data).toString("utf8");
+  }
+  return Buffer.from(data).toString("utf8");
+}
+function extractMetaTimestampCursor(record) {
+  const { meta } = record;
+  if (meta === null || meta === void 0 || typeof meta !== "object") {
+    return void 0;
+  }
+  const { timestamp } = meta;
+  if (typeof timestamp !== "string") {
+    return void 0;
+  }
+  const timestampMs = Date.parse(timestamp);
+  return Number.isFinite(timestampMs) && timestampMs >= 0 ? String(Math.trunc(timestampMs)) : void 0;
+}
+function normalizeHeartbeat(text) {
+  const trimmed = text.trim().toLowerCase();
+  if (trimmed === "ping" || trimmed === '{"type":"ping"}' || trimmed === '{"event":"ping"}') {
+    return "ping";
+  }
+  if (trimmed === "pong" || trimmed === '{"type":"pong"}' || trimmed === '{"event":"pong"}') {
+    return "pong";
+  }
+  return void 0;
+}
+function sendApplicationPong(socket) {
+  if (socket.readyState === import_ws.default.OPEN) {
+    socket.send("pong", { binary: false });
+  }
+}
+
+// src/websocket-options.ts
+var DEFAULT_RECONNECT_OPTIONS = {
+  enabled: true,
+  factor: 2,
+  initialDelayMs: 250,
+  maxDelayMs: 5e3,
+  maxRetries: Number.POSITIVE_INFINITY
+};
+function normalizeReconnectOptions(reconnect) {
+  if (reconnect === false) {
+    return { ...DEFAULT_RECONNECT_OPTIONS, enabled: false };
+  }
+  if (reconnect === true || reconnect === void 0) {
+    return DEFAULT_RECONNECT_OPTIONS;
+  }
+  return {
+    enabled: reconnect.enabled ?? DEFAULT_RECONNECT_OPTIONS.enabled,
+    factor: reconnect.factor ?? DEFAULT_RECONNECT_OPTIONS.factor,
+    initialDelayMs: reconnect.initialDelayMs ?? DEFAULT_RECONNECT_OPTIONS.initialDelayMs,
+    maxDelayMs: reconnect.maxDelayMs ?? DEFAULT_RECONNECT_OPTIONS.maxDelayMs,
+    maxRetries: reconnect.maxRetries ?? DEFAULT_RECONNECT_OPTIONS.maxRetries
+  };
+}
+function resolveWebSocketUrl(options) {
+  const url = options.wsUrl ?? options.websocketUrl ?? options.url;
+  if (url === void 0 || url === "") {
+    throw new TypeError("A WebSocket URL is required. Pass wsUrl, websocketUrl, or url.");
+  }
+  return url;
+}
+function buildClientOptions(options) {
+  const clientOptions = { ...options.clientOptions };
+  const headers = {
+    ...coerceHeaders(options.clientOptions?.headers),
+    ...options.headers
+  };
+  const apiKey = options.apiKey?.trim();
+  if (apiKey !== void 0 && apiKey !== "" && !hasAuthorizationHeader(headers)) {
+    headers.Authorization = `Bearer ${apiKey}`;
+  }
+  if (Object.keys(headers).length > 0) {
+    clientOptions.headers = headers;
+  }
+  return clientOptions;
+}
+function coerceHeaders(headers) {
+  if (headers === void 0) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(headers).map(([key, value]) => [key, Array.isArray(value) ? value.join(", ") : String(value)])
+  );
+}
+function hasAuthorizationHeader(headers) {
+  return Object.keys(headers).some((key) => key.toLowerCase() === "authorization");
+}
+async function sleep(delayMs) {
+  return new Promise((resolve) => {
+    const timeout = setTimeout(resolve, delayMs);
+    timeout.unref?.();
+  });
+}
+
+// src/websocket-subscription.ts
+var WebSocketSubscription = class {
+  options;
+  reconnectOptions;
+  pending = [];
+  queue = [];
+  abortHandler;
+  closed = false;
+  currentSocket;
+  failure;
+  lastCursor;
+  reconnectAttempts = 0;
+  started = false;
+  constructor(options) {
+    this.options = options;
+    this.reconnectOptions = normalizeReconnectOptions(options.reconnect);
+    this.lastCursor = options.cursor;
+  }
+  async next() {
+    this.start();
+    if (this.queue.length > 0) return { done: false, value: this.queue.shift() };
+    if (this.failure !== void 0) throw this.failure;
+    if (this.closed) return { done: true, value: void 0 };
+    return new Promise((resolve, reject) => {
+      this.pending.push({ reject, resolve });
+    });
+  }
+  async return() {
+    this.close();
+    return done();
+  }
+  async throw(error) {
+    this.fail(error ?? new Error("WebSocket subscription iterator was interrupted."));
+    return done();
+  }
+  start() {
+    if (this.started) return;
+    this.started = true;
+    if (this.options.signal?.aborted) {
+      this.close();
+      return;
+    }
+    if (this.options.signal) {
+      this.abortHandler = () => {
+        this.close();
+      };
+      this.options.signal.addEventListener("abort", this.abortHandler, {
+        once: true
+      });
+    }
+    void this.run();
+  }
+  async run() {
+    while (!this.closed) {
+      const socket = this.createSocket();
+      this.currentSocket = socket;
+      const closeInfo = await this.consumeSocket(socket);
+      this.currentSocket = void 0;
+      if (this.closed) {
+        break;
+      }
+      if (!this.shouldReconnect(closeInfo)) {
+        if (closeInfo.error !== void 0) {
+          this.fail(closeInfo.error);
+        } else {
+          this.close();
+        }
+        return;
+      }
+      this.reconnectAttempts += 1;
+      await sleep(this.reconnectDelayMs(this.reconnectAttempts));
+    }
+    this.close();
+  }
+  createSocket() {
+    const url = appendResumeParams(resolveWebSocketUrl(this.options), {
+      cursor: this.lastCursor,
+      since: this.lastCursor !== void 0 && this.lastCursor !== "" ? void 0 : this.options.since
+    });
+    const clientOptions = buildClientOptions(this.options);
+    return this.options.protocols === void 0 ? new import_ws2.default(url, clientOptions) : new import_ws2.default(url, this.options.protocols, clientOptions);
+  }
+  async consumeSocket(socket) {
+    return new Promise((resolve) => {
+      this.attachSocketHandlers(socket, resolve);
+    });
+  }
+  attachSocketHandlers(socket, resolve) {
+    let settled = false;
+    let opened = false;
+    let lastError;
+    const settle = (info) => {
+      if (settled) return;
+      settled = true;
+      socket.off("close", onClose);
+      socket.off("error", onError);
+      socket.off("message", onMessage);
+      socket.off("open", onOpen);
+      socket.off("ping", onPing);
+      socket.off("pong", onPong);
+      resolve(info);
+    };
+    const onOpen = () => {
+      opened = true;
+    };
+    const onError = (error) => {
+      lastError = error;
+      if (!opened) settle({ error });
+    };
+    const onClose = (code) => {
+      settle({ code, error: lastError });
+    };
+    const onMessage = (data) => {
+      this.handleMessage(data, socket);
+    };
+    const onPing = () => {
+    };
+    const onPong = () => {
+    };
+    socket.on("open", onOpen);
+    socket.on("error", onError);
+    socket.on("close", onClose);
+    socket.on("message", onMessage);
+    socket.on("ping", onPing);
+    socket.on("pong", onPong);
+  }
+  handleMessage(data, socket) {
+    try {
+      const event = parseSocketMessage(data, this.options, socket);
+      if (event === void 0) return;
+      this.lastCursor = extractCursor(event) ?? this.lastCursor;
+      this.push(event);
+    } catch (error) {
+      this.fail(error);
+    }
+  }
+  push(event) {
+    const pending = this.pending.shift();
+    if (pending !== void 0) {
+      pending.resolve({ done: false, value: event });
+      return;
+    }
+    this.queue.push(event);
+  }
+  fail(error) {
+    this.closed = true;
+    this.failure = error;
+    this.closeSocket();
+    this.removeAbortHandler();
+    for (const pending of this.pending.splice(0)) {
+      pending.reject(error);
+    }
+  }
+  close() {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    this.closeSocket();
+    this.removeAbortHandler();
+    for (const pending of this.pending.splice(0)) {
+      pending.resolve({ done: true, value: void 0 });
+    }
+  }
+  closeSocket() {
+    if (this.currentSocket === void 0) {
+      return;
+    }
+    const socket = this.currentSocket;
+    if (socket.readyState === import_ws2.default.CONNECTING || socket.readyState === import_ws2.default.OPEN) {
+      socket.close();
+    }
+    this.currentSocket = void 0;
+  }
+  removeAbortHandler() {
+    if (this.abortHandler !== void 0 && this.options.signal !== void 0) {
+      this.options.signal.removeEventListener("abort", this.abortHandler);
+    }
+  }
+  shouldReconnect(info) {
+    if (!this.reconnectOptions.enabled || this.closed) {
+      return false;
+    }
+    if (this.reconnectAttempts >= this.reconnectOptions.maxRetries) {
+      return false;
+    }
+    return info.error !== void 0 ? true : info.code !== void 0 && info.code !== 1e3 && info.code !== 1001;
+  }
+  reconnectDelayMs(attempt) {
+    return Math.min(
+      this.reconnectOptions.maxDelayMs,
+      this.reconnectOptions.initialDelayMs * this.reconnectOptions.factor ** Math.max(0, attempt - 1)
+    );
+  }
+};
+var done = () => ({
+  done: true,
+  value: void 0
+});
+
+// src/websocket.ts
+function subscribeWebSocket(options) {
+  return {
+    [Symbol.asyncIterator]() {
+      return new WebSocketSubscription(options);
+    }
+  };
+}
+
+// src/client.ts
+function createNodeRestlessClient(options) {
+  const coreClient = (0, import_core2.createRestlessClient)(options);
+  const subscribeWebSocketWithDefaults = (subscriptionOptions) => {
+    const mergedOptions = {
+      ...subscriptionOptions
+    };
+    if (mergedOptions.apiKey === void 0 && options.apiKey !== void 0) {
+      mergedOptions.apiKey = options.apiKey;
+    }
+    return subscribeWebSocket(mergedOptions);
+  };
+  const streams = {
+    ...coreClient.streams,
+    subscribeSse: (subscriptionOptions) => subscribeSse(coreClient, subscriptionOptions),
+    subscribeWebSocket: subscribeWebSocketWithDefaults,
+    subscribeWs: subscribeWebSocketWithDefaults
+  };
+  const direct = {
+    ...coreClient.direct,
+    subscribeWebSocket(input, directOptions = {}) {
+      const { cursor, since, ...websocketOptions } = directOptions;
+      const nodeOptions = {
+        ...websocketOptions,
+        wsUrl: coreClient.urls.directWebSocket(input)
+      };
+      if (cursor !== void 0) nodeOptions.cursor = cursor.toString();
+      if (since !== void 0) nodeOptions.since = since.toString();
+      return subscribeWebSocketWithDefaults(nodeOptions);
+    }
+  };
+  return new Proxy(coreClient, {
+    get(target, property, receiver) {
+      if (property === "streams") {
+        return streams;
+      }
+      if (property === "direct") {
+        return direct;
+      }
+      if (property === "subscribeWebSocket" || property === "subscribeWs") {
+        return subscribeWebSocketWithDefaults;
+      }
+      if (property === "subscribeSse") {
+        return (subscriptionOptions) => subscribeSse(coreClient, subscriptionOptions);
+      }
+      return Reflect.get(target, property, receiver);
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildNodeSseUrl,
+  createNodeRestlessClient,
+  subscribeSse,
+  subscribeWebSocket,
+  ...require("@restless-stream/core")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/sse.ts","../src/url.ts","../src/websocket-subscription.ts","../src/websocket-message.ts","../src/websocket-options.ts","../src/websocket.ts"],"sourcesContent":["export * from '@restless-stream/core';\nexport { createNodeRestlessClient } from './client.js';\nexport { buildNodeSseUrl, subscribeSse } from './sse.js';\nexport type {\n  CoreRestlessClientOptions,\n  NodeRestlessClient,\n  NodeRestlessClientOptions,\n  NodeDirectClient,\n  NodeSseHelperOptions,\n  NodeSseSubscriptionOptions,\n  NodeStreamsClient,\n  NodeWebSocketReconnectOptions,\n  NodeWebSocketSubscriptionOptions,\n} from './types.js';\nexport { subscribeWebSocket } from './websocket.js';\n","import {\n  createRestlessClient,\n  type DirectRuntimeUrlInput,\n  type DirectSubscribeWebSocketOptions,\n} from '@restless-stream/core';\n\nimport type { NodeRestlessClient, NodeRestlessClientOptions, NodeWebSocketSubscriptionOptions } from './types.js';\n\nimport { subscribeSse } from './sse.js';\nimport { subscribeWebSocket } from './websocket.js';\n\nexport function createNodeRestlessClient(options: NodeRestlessClientOptions): NodeRestlessClient {\n  const coreClient = createRestlessClient(options);\n\n  const subscribeWebSocketWithDefaults = <TEvent>(subscriptionOptions: NodeWebSocketSubscriptionOptions<TEvent>) => {\n    const mergedOptions: NodeWebSocketSubscriptionOptions<TEvent> = {\n      ...subscriptionOptions,\n    };\n\n    if (mergedOptions.apiKey === undefined && options.apiKey !== undefined) {\n      mergedOptions.apiKey = options.apiKey;\n    }\n\n    return subscribeWebSocket<TEvent>(mergedOptions);\n  };\n\n  const streams = {\n    ...coreClient.streams,\n    subscribeSse: (subscriptionOptions: Parameters<NodeRestlessClient['streams']['subscribeSse']>[0]) =>\n      subscribeSse(coreClient, subscriptionOptions),\n    subscribeWebSocket: subscribeWebSocketWithDefaults,\n    subscribeWs: subscribeWebSocketWithDefaults,\n  } satisfies NodeRestlessClient['streams'];\n\n  const direct = {\n    ...coreClient.direct,\n    subscribeWebSocket<TEvent = unknown>(\n      input: DirectRuntimeUrlInput,\n      directOptions: DirectSubscribeWebSocketOptions = {},\n    ) {\n      const { cursor, since, ...websocketOptions } = directOptions;\n      const nodeOptions: NodeWebSocketSubscriptionOptions<TEvent> = {\n        ...websocketOptions,\n        wsUrl: coreClient.urls.directWebSocket(input),\n      };\n      if (cursor !== undefined) nodeOptions.cursor = cursor.toString();\n      if (since !== undefined) nodeOptions.since = since.toString();\n      return subscribeWebSocketWithDefaults<TEvent>(nodeOptions);\n    },\n  } satisfies NodeRestlessClient['direct'];\n\n  return new Proxy(coreClient, {\n    get(target, property, receiver) {\n      if (property === 'streams') {\n        return streams;\n      }\n\n      if (property === 'direct') {\n        return direct;\n      }\n\n      if (property === 'subscribeWebSocket' || property === 'subscribeWs') {\n        return subscribeWebSocketWithDefaults;\n      }\n\n      if (property === 'subscribeSse') {\n        return (subscriptionOptions: Parameters<NodeRestlessClient['subscribeSse']>[0]) =>\n          subscribeSse(coreClient, subscriptionOptions);\n      }\n\n      return Reflect.get(target, property, receiver);\n    },\n  }) as NodeRestlessClient;\n}\n","import {\n  createRestlessClient,\n  type RestlessClient,\n  type SseIterableOptions,\n  type SseMessage,\n  type StreamEvent,\n} from '@restless-stream/core';\n\nimport type { NodeSseHelperOptions, NodeSseSubscriptionOptions } from './types.js';\n\nimport { appendResumeParams } from './url.js';\n\ntype UnsafeSseOptions = Partial<Pick<SseIterableOptions, 'fetch' | 'headers' | 'url'>>;\ntype SafeSseIterableOptions = Omit<SseIterableOptions, 'cursor' | 'fetch' | 'headers' | 'since' | 'url'>;\ntype NodeSseUrlOptions = Pick<NodeSseSubscriptionOptions, 'sseUrl' | 'cursor' | 'since'>;\n\nexport function buildNodeSseUrl(options: NodeSseUrlOptions): string {\n  return appendResumeParams(options.sseUrl, {\n    cursor: options.cursor,\n    since: options.since,\n  });\n}\n\nexport function subscribeSse<TData = StreamEvent>(\n  client: RestlessClient,\n  options: NodeSseSubscriptionOptions,\n): AsyncIterable<SseMessage<TData>>;\nexport function subscribeSse<TData = StreamEvent>(options: NodeSseHelperOptions): AsyncIterable<SseMessage<TData>>;\nexport function subscribeSse<TData = StreamEvent>(\n  clientOrOptions: RestlessClient | NodeSseHelperOptions,\n  maybeOptions?: NodeSseSubscriptionOptions,\n): AsyncIterable<SseMessage<TData>> {\n  const client = maybeOptions\n    ? (clientOrOptions as RestlessClient)\n    : ((clientOrOptions as NodeSseHelperOptions).client ??\n      createRestlessClient((clientOrOptions as NodeSseHelperOptions).clientOptions));\n  const options = maybeOptions ?? (clientOrOptions as NodeSseHelperOptions);\n  const { iterableOptions, urlOptions } = splitSseOptions(options);\n\n  return client.sse<TData>(buildNodeSseUrl(urlOptions), iterableOptions);\n}\n\nfunction splitSseOptions(options: NodeSseHelperOptions): {\n  iterableOptions: SafeSseIterableOptions;\n  urlOptions: NodeSseUrlOptions;\n} {\n  const { cursor, since, sseUrl } = options;\n  const urlOptions: NodeSseUrlOptions = { sseUrl };\n  if (cursor !== undefined) urlOptions.cursor = cursor;\n  if (since !== undefined) urlOptions.since = since;\n\n  return { iterableOptions: removeUnsafeSseOptions(options), urlOptions };\n}\n\nfunction removeUnsafeSseOptions(options: NodeSseHelperOptions & UnsafeSseOptions): SafeSseIterableOptions {\n  const iterableOptions: SafeSseIterableOptions = {};\n  if (options.signal !== undefined) iterableOptions.signal = options.signal;\n  if (options.reconnect !== undefined) iterableOptions.reconnect = options.reconnect;\n  if (options.reconnectDelayMs !== undefined) iterableOptions.reconnectDelayMs = options.reconnectDelayMs;\n  if (options.maxReconnectDelayMs !== undefined) iterableOptions.maxReconnectDelayMs = options.maxReconnectDelayMs;\n  return iterableOptions;\n}\n","type ResumeParam = number | string | undefined;\n\ninterface ResumeParams {\n  cursor?: ResumeParam;\n  since?: ResumeParam;\n}\n\nexport function appendResumeParams(inputUrl: string, params: ResumeParams): string {\n  const url = new URL(inputUrl);\n\n  appendResumeParam(url.searchParams, 'since', params.since);\n  appendResumeParam(url.searchParams, 'cursor', params.cursor);\n\n  return url.toString();\n}\n\nfunction appendResumeParam(searchParams: URLSearchParams, key: string, value: ResumeParam): void {\n  const normalizedValue = value?.toString().trim();\n  if (normalizedValue !== undefined && normalizedValue !== '') searchParams.set(key, normalizedValue);\n}\n\nexport function normalizeWebSocketUrl(inputUrl: string): string {\n  if (inputUrl.startsWith('https://')) {\n    return `wss://${inputUrl.slice('https://'.length)}`;\n  }\n\n  if (inputUrl.startsWith('http://')) {\n    return `ws://${inputUrl.slice('http://'.length)}`;\n  }\n\n  return inputUrl;\n}\n","import WebSocket from 'ws';\n\nimport type { NodeWebSocketReconnectOptions, NodeWebSocketSubscriptionOptions } from './types.js';\nimport type { CloseInfo, PendingNext } from './websocket-types.js';\n\nimport { appendResumeParams } from './url.js';\nimport { extractCursor, parseSocketMessage } from './websocket-message.js';\nimport { buildClientOptions, normalizeReconnectOptions, resolveWebSocketUrl, sleep } from './websocket-options.js';\n\nexport class WebSocketSubscription<TEvent> implements AsyncIterator<TEvent> {\n  private readonly options: NodeWebSocketSubscriptionOptions<TEvent>;\n  private readonly reconnectOptions: Required<NodeWebSocketReconnectOptions>;\n  private readonly pending: Array<PendingNext<TEvent>> = [];\n  private readonly queue: TEvent[] = [];\n  private abortHandler?: () => void;\n  private closed = false;\n  private currentSocket: WebSocket | undefined;\n  private failure?: unknown;\n  private lastCursor: string | undefined;\n  private reconnectAttempts = 0;\n  private started = false;\n\n  constructor(options: NodeWebSocketSubscriptionOptions<TEvent>) {\n    this.options = options;\n    this.reconnectOptions = normalizeReconnectOptions(options.reconnect);\n    this.lastCursor = options.cursor;\n  }\n\n  async next(): Promise<IteratorResult<TEvent>> {\n    this.start();\n\n    if (this.queue.length > 0) return { done: false, value: this.queue.shift() as TEvent };\n    if (this.failure !== undefined) throw this.failure;\n    if (this.closed) return { done: true, value: undefined };\n\n    return new Promise<IteratorResult<TEvent>>((resolve, reject) => {\n      this.pending.push({ reject, resolve });\n    });\n  }\n\n  async return(): Promise<IteratorResult<TEvent>> {\n    this.close();\n    return done();\n  }\n\n  async throw(error?: unknown): Promise<IteratorResult<TEvent>> {\n    this.fail(error ?? new Error('WebSocket subscription iterator was interrupted.'));\n    return done();\n  }\n\n  private start(): void {\n    if (this.started) return;\n    this.started = true;\n\n    if (this.options.signal?.aborted) {\n      this.close();\n      return;\n    }\n\n    if (this.options.signal) {\n      this.abortHandler = () => {\n        this.close();\n      };\n\n      this.options.signal.addEventListener('abort', this.abortHandler, {\n        once: true,\n      });\n    }\n\n    void this.run();\n  }\n\n  private async run(): Promise<void> {\n    while (!this.closed) {\n      const socket = this.createSocket();\n      this.currentSocket = socket;\n      const closeInfo = await this.consumeSocket(socket);\n      this.currentSocket = undefined;\n\n      if (this.closed) {\n        break;\n      }\n\n      if (!this.shouldReconnect(closeInfo)) {\n        if (closeInfo.error !== undefined) {\n          this.fail(closeInfo.error);\n        } else {\n          this.close();\n        }\n\n        return;\n      }\n\n      this.reconnectAttempts += 1;\n      await sleep(this.reconnectDelayMs(this.reconnectAttempts));\n    }\n\n    this.close();\n  }\n\n  private createSocket(): WebSocket {\n    const url = appendResumeParams(resolveWebSocketUrl(this.options), {\n      cursor: this.lastCursor,\n      since: this.lastCursor !== undefined && this.lastCursor !== '' ? undefined : this.options.since,\n    });\n    const clientOptions = buildClientOptions(this.options);\n\n    return this.options.protocols === undefined\n      ? new WebSocket(url, clientOptions)\n      : new WebSocket(url, this.options.protocols, clientOptions);\n  }\n\n  private async consumeSocket(socket: WebSocket): Promise<CloseInfo> {\n    return new Promise<CloseInfo>((resolve) => {\n      this.attachSocketHandlers(socket, resolve);\n    });\n  }\n\n  private attachSocketHandlers(socket: WebSocket, resolve: (info: CloseInfo) => void): void {\n    let settled = false;\n    let opened = false;\n    let lastError: unknown;\n\n    const settle = (info: CloseInfo) => {\n      if (settled) return;\n      settled = true;\n      socket.off('close', onClose);\n      socket.off('error', onError);\n      socket.off('message', onMessage);\n      socket.off('open', onOpen);\n      socket.off('ping', onPing);\n      socket.off('pong', onPong);\n      resolve(info);\n    };\n\n    const onOpen = () => {\n      opened = true;\n    };\n\n    const onError = (error: unknown) => {\n      lastError = error;\n      if (!opened) settle({ error });\n    };\n\n    const onClose = (code: number) => {\n      settle({ code, error: lastError });\n    };\n\n    const onMessage = (data: WebSocket.RawData) => {\n      this.handleMessage(data, socket);\n    };\n\n    const onPing = () => {};\n    const onPong = () => {};\n\n    socket.on('open', onOpen);\n    socket.on('error', onError);\n    socket.on('close', onClose);\n    socket.on('message', onMessage);\n    socket.on('ping', onPing);\n    socket.on('pong', onPong);\n  }\n\n  private handleMessage(data: WebSocket.RawData, socket: WebSocket): void {\n    try {\n      const event = parseSocketMessage(data, this.options, socket);\n      if (event === undefined) return;\n\n      this.lastCursor = extractCursor(event) ?? this.lastCursor;\n      this.push(event);\n    } catch (error) {\n      this.fail(error);\n    }\n  }\n\n  private push(event: TEvent): void {\n    const pending = this.pending.shift();\n    if (pending !== undefined) {\n      pending.resolve({ done: false, value: event });\n      return;\n    }\n\n    this.queue.push(event);\n  }\n\n  private fail(error: unknown): void {\n    this.closed = true;\n    this.failure = error;\n    this.closeSocket();\n    this.removeAbortHandler();\n\n    for (const pending of this.pending.splice(0)) {\n      pending.reject(error);\n    }\n  }\n\n  private close(): void {\n    if (this.closed) {\n      return;\n    }\n\n    this.closed = true;\n    this.closeSocket();\n    this.removeAbortHandler();\n\n    for (const pending of this.pending.splice(0)) {\n      pending.resolve({ done: true, value: undefined });\n    }\n  }\n\n  private closeSocket(): void {\n    if (this.currentSocket === undefined) {\n      return;\n    }\n\n    const socket = this.currentSocket;\n\n    if (socket.readyState === WebSocket.CONNECTING || socket.readyState === WebSocket.OPEN) {\n      socket.close();\n    }\n\n    this.currentSocket = undefined;\n  }\n\n  private removeAbortHandler(): void {\n    if (this.abortHandler !== undefined && this.options.signal !== undefined) {\n      this.options.signal.removeEventListener('abort', this.abortHandler);\n    }\n  }\n\n  private shouldReconnect(info: CloseInfo): boolean {\n    if (!this.reconnectOptions.enabled || this.closed) {\n      return false;\n    }\n\n    if (this.reconnectAttempts >= this.reconnectOptions.maxRetries) {\n      return false;\n    }\n\n    return info.error !== undefined ? true : info.code !== undefined && info.code !== 1000 && info.code !== 1001;\n  }\n\n  private reconnectDelayMs(attempt: number): number {\n    return Math.min(\n      this.reconnectOptions.maxDelayMs,\n      this.reconnectOptions.initialDelayMs * this.reconnectOptions.factor ** Math.max(0, attempt - 1),\n    );\n  }\n}\n\nconst done = <TEvent>(): IteratorResult<TEvent> => ({\n  done: true,\n  value: undefined,\n});\n","import WebSocket, { type RawData } from 'ws';\n\nimport type { NodeWebSocketSubscriptionOptions } from './types.js';\n\nexport function parseSocketMessage<TEvent>(\n  data: RawData,\n  options: NodeWebSocketSubscriptionOptions<TEvent>,\n  socket: WebSocket,\n): TEvent | undefined {\n  const text = rawDataToText(data);\n  const heartbeat = normalizeHeartbeat(text);\n\n  if (heartbeat === 'ping') {\n    sendApplicationPong(socket);\n    return undefined;\n  }\n\n  if (heartbeat === 'pong') {\n    return undefined;\n  }\n\n  if (options.parse === false) {\n    return text as TEvent;\n  }\n\n  const parser = options.parser ?? defaultParseSocketEvent<TEvent>;\n\n  try {\n    return parser(text);\n  } catch (textError) {\n    try {\n      return parser(JSON.parse(text));\n    } catch {\n      throw textError;\n    }\n  }\n}\n\nexport function extractCursor(event: unknown): string | undefined {\n  if (event === null || event === undefined || typeof event !== 'object') {\n    return undefined;\n  }\n\n  const record = event as Record<string, unknown>;\n  const cursor = record.cursor ?? record.id ?? record.eventId ?? record.lastEventId;\n\n  if (typeof cursor === 'string' && cursor.length > 0) {\n    return cursor;\n  }\n\n  if (typeof cursor === 'number' && Number.isFinite(cursor) && cursor >= 0) {\n    return String(Math.trunc(cursor));\n  }\n\n  return extractMetaTimestampCursor(record);\n}\n\nfunction defaultParseSocketEvent<TEvent>(message: unknown): TEvent {\n  if (typeof message === 'string') {\n    return JSON.parse(message) as TEvent;\n  }\n\n  return message as TEvent;\n}\n\nfunction rawDataToText(data: RawData): string {\n  if (Buffer.isBuffer(data)) {\n    return data.toString('utf8');\n  }\n\n  if (data instanceof ArrayBuffer) {\n    return Buffer.from(data).toString('utf8');\n  }\n\n  if (Array.isArray(data)) {\n    return Buffer.concat(data).toString('utf8');\n  }\n\n  return Buffer.from(data).toString('utf8');\n}\n\nfunction extractMetaTimestampCursor(record: Record<string, unknown>): string | undefined {\n  const { meta } = record;\n  if (meta === null || meta === undefined || typeof meta !== 'object') {\n    return undefined;\n  }\n\n  const { timestamp } = meta as Record<string, unknown>;\n  if (typeof timestamp !== 'string') {\n    return undefined;\n  }\n\n  const timestampMs = Date.parse(timestamp);\n  return Number.isFinite(timestampMs) && timestampMs >= 0 ? String(Math.trunc(timestampMs)) : undefined;\n}\n\nfunction normalizeHeartbeat(text: string): 'ping' | 'pong' | undefined {\n  const trimmed = text.trim().toLowerCase();\n\n  if (trimmed === 'ping' || trimmed === '{\"type\":\"ping\"}' || trimmed === '{\"event\":\"ping\"}') {\n    return 'ping';\n  }\n\n  if (trimmed === 'pong' || trimmed === '{\"type\":\"pong\"}' || trimmed === '{\"event\":\"pong\"}') {\n    return 'pong';\n  }\n\n  return undefined;\n}\n\nfunction sendApplicationPong(socket: WebSocket): void {\n  if (socket.readyState === WebSocket.OPEN) {\n    socket.send('pong', { binary: false });\n  }\n}\n","import type { ClientOptions } from 'ws';\n\nimport type { NodeWebSocketReconnectOptions, NodeWebSocketSubscriptionOptions } from './types.js';\n\nexport const DEFAULT_RECONNECT_OPTIONS: Required<NodeWebSocketReconnectOptions> = {\n  enabled: true,\n  factor: 2,\n  initialDelayMs: 250,\n  maxDelayMs: 5000,\n  maxRetries: Number.POSITIVE_INFINITY,\n};\n\nexport function normalizeReconnectOptions(\n  reconnect: boolean | NodeWebSocketReconnectOptions | undefined,\n): Required<NodeWebSocketReconnectOptions> {\n  if (reconnect === false) {\n    return { ...DEFAULT_RECONNECT_OPTIONS, enabled: false };\n  }\n\n  if (reconnect === true || reconnect === undefined) {\n    return DEFAULT_RECONNECT_OPTIONS;\n  }\n\n  return {\n    enabled: reconnect.enabled ?? DEFAULT_RECONNECT_OPTIONS.enabled,\n    factor: reconnect.factor ?? DEFAULT_RECONNECT_OPTIONS.factor,\n    initialDelayMs: reconnect.initialDelayMs ?? DEFAULT_RECONNECT_OPTIONS.initialDelayMs,\n    maxDelayMs: reconnect.maxDelayMs ?? DEFAULT_RECONNECT_OPTIONS.maxDelayMs,\n    maxRetries: reconnect.maxRetries ?? DEFAULT_RECONNECT_OPTIONS.maxRetries,\n  };\n}\n\nexport function resolveWebSocketUrl(options: NodeWebSocketSubscriptionOptions<unknown>): string {\n  const url = options.wsUrl ?? options.websocketUrl ?? options.url;\n\n  if (url === undefined || url === '') {\n    throw new TypeError('A WebSocket URL is required. Pass wsUrl, websocketUrl, or url.');\n  }\n\n  return url;\n}\n\nexport function buildClientOptions(options: NodeWebSocketSubscriptionOptions<unknown>): ClientOptions {\n  const clientOptions: ClientOptions = { ...options.clientOptions };\n  const headers = {\n    ...coerceHeaders(options.clientOptions?.headers),\n    ...options.headers,\n  };\n\n  const apiKey = options.apiKey?.trim();\n  if (apiKey !== undefined && apiKey !== '' && !hasAuthorizationHeader(headers)) {\n    headers.Authorization = `Bearer ${apiKey}`;\n  }\n\n  if (Object.keys(headers).length > 0) {\n    clientOptions.headers = headers;\n  }\n\n  return clientOptions;\n}\n\nfunction coerceHeaders(headers: ClientOptions['headers']): Record<string, string> {\n  if (headers === undefined) {\n    return {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(headers).map(([key, value]) => [key, Array.isArray(value) ? value.join(', ') : String(value)]),\n  );\n}\n\nfunction hasAuthorizationHeader(headers: Record<string, string>): boolean {\n  return Object.keys(headers).some((key) => key.toLowerCase() === 'authorization');\n}\n\nexport async function sleep(delayMs: number): Promise<void> {\n  return new Promise((resolve) => {\n    const timeout = setTimeout(resolve, delayMs);\n    timeout.unref?.();\n  });\n}\n","import type { StreamEvent } from '@restless-stream/core';\n\nimport type { NodeWebSocketSubscriptionOptions } from './types.js';\n\nimport { WebSocketSubscription } from './websocket-subscription.js';\n\nexport function subscribeWebSocket<TEvent = StreamEvent>(\n  options: NodeWebSocketSubscriptionOptions<TEvent>,\n): AsyncIterable<TEvent> {\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<TEvent> {\n      return new WebSocketSubscription(options);\n    },\n  };\n}\n"],"mappings":"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","names":["import_core","import_ws","WebSocket","WebSocket"]}

package/dist/index.d.cts

@@ -0,0 +1,85 @@
+import { createRestlessClient, RestlessClient, StreamEvent, DirectRuntimeUrlInput, DirectSubscribeWebSocketOptions, SseIterableOptions, SseMessage } from '@restless-stream/core';
+export * from '@restless-stream/core';
+import { ClientOptions } from 'ws';
+
+type CoreRestlessClientOptions = Parameters<typeof createRestlessClient>[0];
+type NodeRestlessClientOptions = CoreRestlessClientOptions & {
+    /** API key used as the default Bearer token for Node WebSocket subscriptions. */
+    apiKey?: string;
+};
+interface NodeWebSocketReconnectOptions {
+    /** Enables reconnects after abnormal closes and connection errors. Defaults to true. */
+    enabled?: boolean;
+    /** Maximum reconnect attempts. Use `Infinity` for an unbounded stream. Defaults to Infinity. */
+    maxRetries?: number;
+    /** First reconnect delay in milliseconds. Defaults to 250. */
+    initialDelayMs?: number;
+    /** Maximum reconnect delay in milliseconds. Defaults to 5000. */
+    maxDelayMs?: number;
+    /** Exponential backoff multiplier. Defaults to 2. */
+    factor?: number;
+}
+interface NodeWebSocketSubscriptionOptions<TEvent = StreamEvent> {
+    /** WebSocket URL returned by Restless Stream. */
+    wsUrl?: string;
+    /** Alias for `wsUrl`. */
+    websocketUrl?: string;
+    /** Alias for `wsUrl`; useful when adapting generic stream records. */
+    url?: string;
+    /** API key sent as `Authorization: Bearer <apiKey>` unless an Authorization header is provided. */
+    apiKey?: string;
+    /** Optional WebSocket subprotocol or subprotocol list. */
+    protocols?: string | string[];
+    /** Additional headers for the Node WebSocket handshake. */
+    headers?: Record<string, string>;
+    /** Abort signal used to cancel the async iterator and close the socket. */
+    signal?: AbortSignal;
+    /** Initial cursor to resume from. Updated automatically from yielded events on reconnect. */
+    cursor?: string;
+    /** Initial timestamp/id to resume from when no cursor has been observed yet. */
+    since?: string;
+    /** Reconnect policy for abnormal closes and connection errors. */
+    reconnect?: boolean | NodeWebSocketReconnectOptions;
+    /** Extra options passed to the `ws` client. */
+    clientOptions?: ClientOptions;
+    /** Disable core parsing and yield raw text frames instead. Defaults to true. */
+    parse?: boolean;
+    /** Override event parsing while keeping reconnect/cancellation behavior. */
+    parser?: (message: unknown) => TEvent;
+}
+interface NodeSseSubscriptionOptions extends Omit<SseIterableOptions, 'fetch' | 'headers' | 'url'> {
+    /** SSE URL returned by Restless Stream. */
+    sseUrl: string;
+}
+interface NodeSseHelperOptions extends NodeSseSubscriptionOptions {
+    /** Existing core client to delegate to. */
+    client?: RestlessClient;
+    /** Options used to create a core client when `client` is omitted. */
+    clientOptions?: CoreRestlessClientOptions;
+}
+interface NodeStreamsClient extends Omit<RestlessClient['streams'], 'subscribeSse' | 'subscribeWebSocket'> {
+    subscribeWebSocket<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeWs<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeSse<TData = StreamEvent>(options: NodeSseSubscriptionOptions): AsyncIterable<SseMessage<TData>>;
+}
+interface NodeDirectClient extends Omit<RestlessClient['direct'], 'subscribeWebSocket'> {
+    subscribeWebSocket<TEvent = StreamEvent>(input: DirectRuntimeUrlInput, options?: DirectSubscribeWebSocketOptions): AsyncIterable<TEvent>;
+}
+type NodeRestlessClient = Omit<RestlessClient, 'streams' | 'subscribeSse' | 'subscribeWebSocket'> & {
+    readonly direct: NodeDirectClient;
+    readonly streams: NodeStreamsClient;
+    subscribeWebSocket<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeWs<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeSse<TData = StreamEvent>(options: NodeSseSubscriptionOptions): AsyncIterable<SseMessage<TData>>;
+};
+
+declare function createNodeRestlessClient(options: NodeRestlessClientOptions): NodeRestlessClient;
+
+type NodeSseUrlOptions = Pick<NodeSseSubscriptionOptions, 'sseUrl' | 'cursor' | 'since'>;
+declare function buildNodeSseUrl(options: NodeSseUrlOptions): string;
+declare function subscribeSse<TData = StreamEvent>(client: RestlessClient, options: NodeSseSubscriptionOptions): AsyncIterable<SseMessage<TData>>;
+declare function subscribeSse<TData = StreamEvent>(options: NodeSseHelperOptions): AsyncIterable<SseMessage<TData>>;
+
+declare function subscribeWebSocket<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+
+export { type CoreRestlessClientOptions, type NodeDirectClient, type NodeRestlessClient, type NodeRestlessClientOptions, type NodeSseHelperOptions, type NodeSseSubscriptionOptions, type NodeStreamsClient, type NodeWebSocketReconnectOptions, type NodeWebSocketSubscriptionOptions, buildNodeSseUrl, createNodeRestlessClient, subscribeSse, subscribeWebSocket };

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+import { createRestlessClient, RestlessClient, StreamEvent, DirectRuntimeUrlInput, DirectSubscribeWebSocketOptions, SseIterableOptions, SseMessage } from '@restless-stream/core';
+export * from '@restless-stream/core';
+import { ClientOptions } from 'ws';
+
+type CoreRestlessClientOptions = Parameters<typeof createRestlessClient>[0];
+type NodeRestlessClientOptions = CoreRestlessClientOptions & {
+    /** API key used as the default Bearer token for Node WebSocket subscriptions. */
+    apiKey?: string;
+};
+interface NodeWebSocketReconnectOptions {
+    /** Enables reconnects after abnormal closes and connection errors. Defaults to true. */
+    enabled?: boolean;
+    /** Maximum reconnect attempts. Use `Infinity` for an unbounded stream. Defaults to Infinity. */
+    maxRetries?: number;
+    /** First reconnect delay in milliseconds. Defaults to 250. */
+    initialDelayMs?: number;
+    /** Maximum reconnect delay in milliseconds. Defaults to 5000. */
+    maxDelayMs?: number;
+    /** Exponential backoff multiplier. Defaults to 2. */
+    factor?: number;
+}
+interface NodeWebSocketSubscriptionOptions<TEvent = StreamEvent> {
+    /** WebSocket URL returned by Restless Stream. */
+    wsUrl?: string;
+    /** Alias for `wsUrl`. */
+    websocketUrl?: string;
+    /** Alias for `wsUrl`; useful when adapting generic stream records. */
+    url?: string;
+    /** API key sent as `Authorization: Bearer <apiKey>` unless an Authorization header is provided. */
+    apiKey?: string;
+    /** Optional WebSocket subprotocol or subprotocol list. */
+    protocols?: string | string[];
+    /** Additional headers for the Node WebSocket handshake. */
+    headers?: Record<string, string>;
+    /** Abort signal used to cancel the async iterator and close the socket. */
+    signal?: AbortSignal;
+    /** Initial cursor to resume from. Updated automatically from yielded events on reconnect. */
+    cursor?: string;
+    /** Initial timestamp/id to resume from when no cursor has been observed yet. */
+    since?: string;
+    /** Reconnect policy for abnormal closes and connection errors. */
+    reconnect?: boolean | NodeWebSocketReconnectOptions;
+    /** Extra options passed to the `ws` client. */
+    clientOptions?: ClientOptions;
+    /** Disable core parsing and yield raw text frames instead. Defaults to true. */
+    parse?: boolean;
+    /** Override event parsing while keeping reconnect/cancellation behavior. */
+    parser?: (message: unknown) => TEvent;
+}
+interface NodeSseSubscriptionOptions extends Omit<SseIterableOptions, 'fetch' | 'headers' | 'url'> {
+    /** SSE URL returned by Restless Stream. */
+    sseUrl: string;
+}
+interface NodeSseHelperOptions extends NodeSseSubscriptionOptions {
+    /** Existing core client to delegate to. */
+    client?: RestlessClient;
+    /** Options used to create a core client when `client` is omitted. */
+    clientOptions?: CoreRestlessClientOptions;
+}
+interface NodeStreamsClient extends Omit<RestlessClient['streams'], 'subscribeSse' | 'subscribeWebSocket'> {
+    subscribeWebSocket<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeWs<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeSse<TData = StreamEvent>(options: NodeSseSubscriptionOptions): AsyncIterable<SseMessage<TData>>;
+}
+interface NodeDirectClient extends Omit<RestlessClient['direct'], 'subscribeWebSocket'> {
+    subscribeWebSocket<TEvent = StreamEvent>(input: DirectRuntimeUrlInput, options?: DirectSubscribeWebSocketOptions): AsyncIterable<TEvent>;
+}
+type NodeRestlessClient = Omit<RestlessClient, 'streams' | 'subscribeSse' | 'subscribeWebSocket'> & {
+    readonly direct: NodeDirectClient;
+    readonly streams: NodeStreamsClient;
+    subscribeWebSocket<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeWs<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+    subscribeSse<TData = StreamEvent>(options: NodeSseSubscriptionOptions): AsyncIterable<SseMessage<TData>>;
+};
+
+declare function createNodeRestlessClient(options: NodeRestlessClientOptions): NodeRestlessClient;
+
+type NodeSseUrlOptions = Pick<NodeSseSubscriptionOptions, 'sseUrl' | 'cursor' | 'since'>;
+declare function buildNodeSseUrl(options: NodeSseUrlOptions): string;
+declare function subscribeSse<TData = StreamEvent>(client: RestlessClient, options: NodeSseSubscriptionOptions): AsyncIterable<SseMessage<TData>>;
+declare function subscribeSse<TData = StreamEvent>(options: NodeSseHelperOptions): AsyncIterable<SseMessage<TData>>;
+
+declare function subscribeWebSocket<TEvent = StreamEvent>(options: NodeWebSocketSubscriptionOptions<TEvent>): AsyncIterable<TEvent>;
+
+export { type CoreRestlessClientOptions, type NodeDirectClient, type NodeRestlessClient, type NodeRestlessClientOptions, type NodeSseHelperOptions, type NodeSseSubscriptionOptions, type NodeStreamsClient, type NodeWebSocketReconnectOptions, type NodeWebSocketSubscriptionOptions, buildNodeSseUrl, createNodeRestlessClient, subscribeSse, subscribeWebSocket };

package/dist/index.js

@@ -0,0 +1,471 @@
+// src/index.ts
+export * from "@restless-stream/core";
+
+// src/client.ts
+import {
+  createRestlessClient as createRestlessClient2
+} from "@restless-stream/core";
+
+// src/sse.ts
+import {
+  createRestlessClient
+} from "@restless-stream/core";
+
+// src/url.ts
+function appendResumeParams(inputUrl, params) {
+  const url = new URL(inputUrl);
+  appendResumeParam(url.searchParams, "since", params.since);
+  appendResumeParam(url.searchParams, "cursor", params.cursor);
+  return url.toString();
+}
+function appendResumeParam(searchParams, key, value) {
+  const normalizedValue = value?.toString().trim();
+  if (normalizedValue !== void 0 && normalizedValue !== "") searchParams.set(key, normalizedValue);
+}
+
+// src/sse.ts
+function buildNodeSseUrl(options) {
+  return appendResumeParams(options.sseUrl, {
+    cursor: options.cursor,
+    since: options.since
+  });
+}
+function subscribeSse(clientOrOptions, maybeOptions) {
+  const client = maybeOptions ? clientOrOptions : clientOrOptions.client ?? createRestlessClient(clientOrOptions.clientOptions);
+  const options = maybeOptions ?? clientOrOptions;
+  const { iterableOptions, urlOptions } = splitSseOptions(options);
+  return client.sse(buildNodeSseUrl(urlOptions), iterableOptions);
+}
+function splitSseOptions(options) {
+  const { cursor, since, sseUrl } = options;
+  const urlOptions = { sseUrl };
+  if (cursor !== void 0) urlOptions.cursor = cursor;
+  if (since !== void 0) urlOptions.since = since;
+  return { iterableOptions: removeUnsafeSseOptions(options), urlOptions };
+}
+function removeUnsafeSseOptions(options) {
+  const iterableOptions = {};
+  if (options.signal !== void 0) iterableOptions.signal = options.signal;
+  if (options.reconnect !== void 0) iterableOptions.reconnect = options.reconnect;
+  if (options.reconnectDelayMs !== void 0) iterableOptions.reconnectDelayMs = options.reconnectDelayMs;
+  if (options.maxReconnectDelayMs !== void 0) iterableOptions.maxReconnectDelayMs = options.maxReconnectDelayMs;
+  return iterableOptions;
+}
+
+// src/websocket-subscription.ts
+import WebSocket2 from "ws";
+
+// src/websocket-message.ts
+import WebSocket from "ws";
+function parseSocketMessage(data, options, socket) {
+  const text = rawDataToText(data);
+  const heartbeat = normalizeHeartbeat(text);
+  if (heartbeat === "ping") {
+    sendApplicationPong(socket);
+    return void 0;
+  }
+  if (heartbeat === "pong") {
+    return void 0;
+  }
+  if (options.parse === false) {
+    return text;
+  }
+  const parser = options.parser ?? defaultParseSocketEvent;
+  try {
+    return parser(text);
+  } catch (textError) {
+    try {
+      return parser(JSON.parse(text));
+    } catch {
+      throw textError;
+    }
+  }
+}
+function extractCursor(event) {
+  if (event === null || event === void 0 || typeof event !== "object") {
+    return void 0;
+  }
+  const record = event;
+  const cursor = record.cursor ?? record.id ?? record.eventId ?? record.lastEventId;
+  if (typeof cursor === "string" && cursor.length > 0) {
+    return cursor;
+  }
+  if (typeof cursor === "number" && Number.isFinite(cursor) && cursor >= 0) {
+    return String(Math.trunc(cursor));
+  }
+  return extractMetaTimestampCursor(record);
+}
+function defaultParseSocketEvent(message) {
+  if (typeof message === "string") {
+    return JSON.parse(message);
+  }
+  return message;
+}
+function rawDataToText(data) {
+  if (Buffer.isBuffer(data)) {
+    return data.toString("utf8");
+  }
+  if (data instanceof ArrayBuffer) {
+    return Buffer.from(data).toString("utf8");
+  }
+  if (Array.isArray(data)) {
+    return Buffer.concat(data).toString("utf8");
+  }
+  return Buffer.from(data).toString("utf8");
+}
+function extractMetaTimestampCursor(record) {
+  const { meta } = record;
+  if (meta === null || meta === void 0 || typeof meta !== "object") {
+    return void 0;
+  }
+  const { timestamp } = meta;
+  if (typeof timestamp !== "string") {
+    return void 0;
+  }
+  const timestampMs = Date.parse(timestamp);
+  return Number.isFinite(timestampMs) && timestampMs >= 0 ? String(Math.trunc(timestampMs)) : void 0;
+}
+function normalizeHeartbeat(text) {
+  const trimmed = text.trim().toLowerCase();
+  if (trimmed === "ping" || trimmed === '{"type":"ping"}' || trimmed === '{"event":"ping"}') {
+    return "ping";
+  }
+  if (trimmed === "pong" || trimmed === '{"type":"pong"}' || trimmed === '{"event":"pong"}') {
+    return "pong";
+  }
+  return void 0;
+}
+function sendApplicationPong(socket) {
+  if (socket.readyState === WebSocket.OPEN) {
+    socket.send("pong", { binary: false });
+  }
+}
+
+// src/websocket-options.ts
+var DEFAULT_RECONNECT_OPTIONS = {
+  enabled: true,
+  factor: 2,
+  initialDelayMs: 250,
+  maxDelayMs: 5e3,
+  maxRetries: Number.POSITIVE_INFINITY
+};
+function normalizeReconnectOptions(reconnect) {
+  if (reconnect === false) {
+    return { ...DEFAULT_RECONNECT_OPTIONS, enabled: false };
+  }
+  if (reconnect === true || reconnect === void 0) {
+    return DEFAULT_RECONNECT_OPTIONS;
+  }
+  return {
+    enabled: reconnect.enabled ?? DEFAULT_RECONNECT_OPTIONS.enabled,
+    factor: reconnect.factor ?? DEFAULT_RECONNECT_OPTIONS.factor,
+    initialDelayMs: reconnect.initialDelayMs ?? DEFAULT_RECONNECT_OPTIONS.initialDelayMs,
+    maxDelayMs: reconnect.maxDelayMs ?? DEFAULT_RECONNECT_OPTIONS.maxDelayMs,
+    maxRetries: reconnect.maxRetries ?? DEFAULT_RECONNECT_OPTIONS.maxRetries
+  };
+}
+function resolveWebSocketUrl(options) {
+  const url = options.wsUrl ?? options.websocketUrl ?? options.url;
+  if (url === void 0 || url === "") {
+    throw new TypeError("A WebSocket URL is required. Pass wsUrl, websocketUrl, or url.");
+  }
+  return url;
+}
+function buildClientOptions(options) {
+  const clientOptions = { ...options.clientOptions };
+  const headers = {
+    ...coerceHeaders(options.clientOptions?.headers),
+    ...options.headers
+  };
+  const apiKey = options.apiKey?.trim();
+  if (apiKey !== void 0 && apiKey !== "" && !hasAuthorizationHeader(headers)) {
+    headers.Authorization = `Bearer ${apiKey}`;
+  }
+  if (Object.keys(headers).length > 0) {
+    clientOptions.headers = headers;
+  }
+  return clientOptions;
+}
+function coerceHeaders(headers) {
+  if (headers === void 0) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(headers).map(([key, value]) => [key, Array.isArray(value) ? value.join(", ") : String(value)])
+  );
+}
+function hasAuthorizationHeader(headers) {
+  return Object.keys(headers).some((key) => key.toLowerCase() === "authorization");
+}
+async function sleep(delayMs) {
+  return new Promise((resolve) => {
+    const timeout = setTimeout(resolve, delayMs);
+    timeout.unref?.();
+  });
+}
+
+// src/websocket-subscription.ts
+var WebSocketSubscription = class {
+  options;
+  reconnectOptions;
+  pending = [];
+  queue = [];
+  abortHandler;
+  closed = false;
+  currentSocket;
+  failure;
+  lastCursor;
+  reconnectAttempts = 0;
+  started = false;
+  constructor(options) {
+    this.options = options;
+    this.reconnectOptions = normalizeReconnectOptions(options.reconnect);
+    this.lastCursor = options.cursor;
+  }
+  async next() {
+    this.start();
+    if (this.queue.length > 0) return { done: false, value: this.queue.shift() };
+    if (this.failure !== void 0) throw this.failure;
+    if (this.closed) return { done: true, value: void 0 };
+    return new Promise((resolve, reject) => {
+      this.pending.push({ reject, resolve });
+    });
+  }
+  async return() {
+    this.close();
+    return done();
+  }
+  async throw(error) {
+    this.fail(error ?? new Error("WebSocket subscription iterator was interrupted."));
+    return done();
+  }
+  start() {
+    if (this.started) return;
+    this.started = true;
+    if (this.options.signal?.aborted) {
+      this.close();
+      return;
+    }
+    if (this.options.signal) {
+      this.abortHandler = () => {
+        this.close();
+      };
+      this.options.signal.addEventListener("abort", this.abortHandler, {
+        once: true
+      });
+    }
+    void this.run();
+  }
+  async run() {
+    while (!this.closed) {
+      const socket = this.createSocket();
+      this.currentSocket = socket;
+      const closeInfo = await this.consumeSocket(socket);
+      this.currentSocket = void 0;
+      if (this.closed) {
+        break;
+      }
+      if (!this.shouldReconnect(closeInfo)) {
+        if (closeInfo.error !== void 0) {
+          this.fail(closeInfo.error);
+        } else {
+          this.close();
+        }
+        return;
+      }
+      this.reconnectAttempts += 1;
+      await sleep(this.reconnectDelayMs(this.reconnectAttempts));
+    }
+    this.close();
+  }
+  createSocket() {
+    const url = appendResumeParams(resolveWebSocketUrl(this.options), {
+      cursor: this.lastCursor,
+      since: this.lastCursor !== void 0 && this.lastCursor !== "" ? void 0 : this.options.since
+    });
+    const clientOptions = buildClientOptions(this.options);
+    return this.options.protocols === void 0 ? new WebSocket2(url, clientOptions) : new WebSocket2(url, this.options.protocols, clientOptions);
+  }
+  async consumeSocket(socket) {
+    return new Promise((resolve) => {
+      this.attachSocketHandlers(socket, resolve);
+    });
+  }
+  attachSocketHandlers(socket, resolve) {
+    let settled = false;
+    let opened = false;
+    let lastError;
+    const settle = (info) => {
+      if (settled) return;
+      settled = true;
+      socket.off("close", onClose);
+      socket.off("error", onError);
+      socket.off("message", onMessage);
+      socket.off("open", onOpen);
+      socket.off("ping", onPing);
+      socket.off("pong", onPong);
+      resolve(info);
+    };
+    const onOpen = () => {
+      opened = true;
+    };
+    const onError = (error) => {
+      lastError = error;
+      if (!opened) settle({ error });
+    };
+    const onClose = (code) => {
+      settle({ code, error: lastError });
+    };
+    const onMessage = (data) => {
+      this.handleMessage(data, socket);
+    };
+    const onPing = () => {
+    };
+    const onPong = () => {
+    };
+    socket.on("open", onOpen);
+    socket.on("error", onError);
+    socket.on("close", onClose);
+    socket.on("message", onMessage);
+    socket.on("ping", onPing);
+    socket.on("pong", onPong);
+  }
+  handleMessage(data, socket) {
+    try {
+      const event = parseSocketMessage(data, this.options, socket);
+      if (event === void 0) return;
+      this.lastCursor = extractCursor(event) ?? this.lastCursor;
+      this.push(event);
+    } catch (error) {
+      this.fail(error);
+    }
+  }
+  push(event) {
+    const pending = this.pending.shift();
+    if (pending !== void 0) {
+      pending.resolve({ done: false, value: event });
+      return;
+    }
+    this.queue.push(event);
+  }
+  fail(error) {
+    this.closed = true;
+    this.failure = error;
+    this.closeSocket();
+    this.removeAbortHandler();
+    for (const pending of this.pending.splice(0)) {
+      pending.reject(error);
+    }
+  }
+  close() {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    this.closeSocket();
+    this.removeAbortHandler();
+    for (const pending of this.pending.splice(0)) {
+      pending.resolve({ done: true, value: void 0 });
+    }
+  }
+  closeSocket() {
+    if (this.currentSocket === void 0) {
+      return;
+    }
+    const socket = this.currentSocket;
+    if (socket.readyState === WebSocket2.CONNECTING || socket.readyState === WebSocket2.OPEN) {
+      socket.close();
+    }
+    this.currentSocket = void 0;
+  }
+  removeAbortHandler() {
+    if (this.abortHandler !== void 0 && this.options.signal !== void 0) {
+      this.options.signal.removeEventListener("abort", this.abortHandler);
+    }
+  }
+  shouldReconnect(info) {
+    if (!this.reconnectOptions.enabled || this.closed) {
+      return false;
+    }
+    if (this.reconnectAttempts >= this.reconnectOptions.maxRetries) {
+      return false;
+    }
+    return info.error !== void 0 ? true : info.code !== void 0 && info.code !== 1e3 && info.code !== 1001;
+  }
+  reconnectDelayMs(attempt) {
+    return Math.min(
+      this.reconnectOptions.maxDelayMs,
+      this.reconnectOptions.initialDelayMs * this.reconnectOptions.factor ** Math.max(0, attempt - 1)
+    );
+  }
+};
+var done = () => ({
+  done: true,
+  value: void 0
+});
+
+// src/websocket.ts
+function subscribeWebSocket(options) {
+  return {
+    [Symbol.asyncIterator]() {
+      return new WebSocketSubscription(options);
+    }
+  };
+}
+
+// src/client.ts
+function createNodeRestlessClient(options) {
+  const coreClient = createRestlessClient2(options);
+  const subscribeWebSocketWithDefaults = (subscriptionOptions) => {
+    const mergedOptions = {
+      ...subscriptionOptions
+    };
+    if (mergedOptions.apiKey === void 0 && options.apiKey !== void 0) {
+      mergedOptions.apiKey = options.apiKey;
+    }
+    return subscribeWebSocket(mergedOptions);
+  };
+  const streams = {
+    ...coreClient.streams,
+    subscribeSse: (subscriptionOptions) => subscribeSse(coreClient, subscriptionOptions),
+    subscribeWebSocket: subscribeWebSocketWithDefaults,
+    subscribeWs: subscribeWebSocketWithDefaults
+  };
+  const direct = {
+    ...coreClient.direct,
+    subscribeWebSocket(input, directOptions = {}) {
+      const { cursor, since, ...websocketOptions } = directOptions;
+      const nodeOptions = {
+        ...websocketOptions,
+        wsUrl: coreClient.urls.directWebSocket(input)
+      };
+      if (cursor !== void 0) nodeOptions.cursor = cursor.toString();
+      if (since !== void 0) nodeOptions.since = since.toString();
+      return subscribeWebSocketWithDefaults(nodeOptions);
+    }
+  };
+  return new Proxy(coreClient, {
+    get(target, property, receiver) {
+      if (property === "streams") {
+        return streams;
+      }
+      if (property === "direct") {
+        return direct;
+      }
+      if (property === "subscribeWebSocket" || property === "subscribeWs") {
+        return subscribeWebSocketWithDefaults;
+      }
+      if (property === "subscribeSse") {
+        return (subscriptionOptions) => subscribeSse(coreClient, subscriptionOptions);
+      }
+      return Reflect.get(target, property, receiver);
+    }
+  });
+}
+export {
+  buildNodeSseUrl,
+  createNodeRestlessClient,
+  subscribeSse,
+  subscribeWebSocket
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/sse.ts","../src/url.ts","../src/websocket-subscription.ts","../src/websocket-message.ts","../src/websocket-options.ts","../src/websocket.ts"],"sourcesContent":["export * from '@restless-stream/core';\nexport { createNodeRestlessClient } from './client.js';\nexport { buildNodeSseUrl, subscribeSse } from './sse.js';\nexport type {\n  CoreRestlessClientOptions,\n  NodeRestlessClient,\n  NodeRestlessClientOptions,\n  NodeDirectClient,\n  NodeSseHelperOptions,\n  NodeSseSubscriptionOptions,\n  NodeStreamsClient,\n  NodeWebSocketReconnectOptions,\n  NodeWebSocketSubscriptionOptions,\n} from './types.js';\nexport { subscribeWebSocket } from './websocket.js';\n","import {\n  createRestlessClient,\n  type DirectRuntimeUrlInput,\n  type DirectSubscribeWebSocketOptions,\n} from '@restless-stream/core';\n\nimport type { NodeRestlessClient, NodeRestlessClientOptions, NodeWebSocketSubscriptionOptions } from './types.js';\n\nimport { subscribeSse } from './sse.js';\nimport { subscribeWebSocket } from './websocket.js';\n\nexport function createNodeRestlessClient(options: NodeRestlessClientOptions): NodeRestlessClient {\n  const coreClient = createRestlessClient(options);\n\n  const subscribeWebSocketWithDefaults = <TEvent>(subscriptionOptions: NodeWebSocketSubscriptionOptions<TEvent>) => {\n    const mergedOptions: NodeWebSocketSubscriptionOptions<TEvent> = {\n      ...subscriptionOptions,\n    };\n\n    if (mergedOptions.apiKey === undefined && options.apiKey !== undefined) {\n      mergedOptions.apiKey = options.apiKey;\n    }\n\n    return subscribeWebSocket<TEvent>(mergedOptions);\n  };\n\n  const streams = {\n    ...coreClient.streams,\n    subscribeSse: (subscriptionOptions: Parameters<NodeRestlessClient['streams']['subscribeSse']>[0]) =>\n      subscribeSse(coreClient, subscriptionOptions),\n    subscribeWebSocket: subscribeWebSocketWithDefaults,\n    subscribeWs: subscribeWebSocketWithDefaults,\n  } satisfies NodeRestlessClient['streams'];\n\n  const direct = {\n    ...coreClient.direct,\n    subscribeWebSocket<TEvent = unknown>(\n      input: DirectRuntimeUrlInput,\n      directOptions: DirectSubscribeWebSocketOptions = {},\n    ) {\n      const { cursor, since, ...websocketOptions } = directOptions;\n      const nodeOptions: NodeWebSocketSubscriptionOptions<TEvent> = {\n        ...websocketOptions,\n        wsUrl: coreClient.urls.directWebSocket(input),\n      };\n      if (cursor !== undefined) nodeOptions.cursor = cursor.toString();\n      if (since !== undefined) nodeOptions.since = since.toString();\n      return subscribeWebSocketWithDefaults<TEvent>(nodeOptions);\n    },\n  } satisfies NodeRestlessClient['direct'];\n\n  return new Proxy(coreClient, {\n    get(target, property, receiver) {\n      if (property === 'streams') {\n        return streams;\n      }\n\n      if (property === 'direct') {\n        return direct;\n      }\n\n      if (property === 'subscribeWebSocket' || property === 'subscribeWs') {\n        return subscribeWebSocketWithDefaults;\n      }\n\n      if (property === 'subscribeSse') {\n        return (subscriptionOptions: Parameters<NodeRestlessClient['subscribeSse']>[0]) =>\n          subscribeSse(coreClient, subscriptionOptions);\n      }\n\n      return Reflect.get(target, property, receiver);\n    },\n  }) as NodeRestlessClient;\n}\n","import {\n  createRestlessClient,\n  type RestlessClient,\n  type SseIterableOptions,\n  type SseMessage,\n  type StreamEvent,\n} from '@restless-stream/core';\n\nimport type { NodeSseHelperOptions, NodeSseSubscriptionOptions } from './types.js';\n\nimport { appendResumeParams } from './url.js';\n\ntype UnsafeSseOptions = Partial<Pick<SseIterableOptions, 'fetch' | 'headers' | 'url'>>;\ntype SafeSseIterableOptions = Omit<SseIterableOptions, 'cursor' | 'fetch' | 'headers' | 'since' | 'url'>;\ntype NodeSseUrlOptions = Pick<NodeSseSubscriptionOptions, 'sseUrl' | 'cursor' | 'since'>;\n\nexport function buildNodeSseUrl(options: NodeSseUrlOptions): string {\n  return appendResumeParams(options.sseUrl, {\n    cursor: options.cursor,\n    since: options.since,\n  });\n}\n\nexport function subscribeSse<TData = StreamEvent>(\n  client: RestlessClient,\n  options: NodeSseSubscriptionOptions,\n): AsyncIterable<SseMessage<TData>>;\nexport function subscribeSse<TData = StreamEvent>(options: NodeSseHelperOptions): AsyncIterable<SseMessage<TData>>;\nexport function subscribeSse<TData = StreamEvent>(\n  clientOrOptions: RestlessClient | NodeSseHelperOptions,\n  maybeOptions?: NodeSseSubscriptionOptions,\n): AsyncIterable<SseMessage<TData>> {\n  const client = maybeOptions\n    ? (clientOrOptions as RestlessClient)\n    : ((clientOrOptions as NodeSseHelperOptions).client ??\n      createRestlessClient((clientOrOptions as NodeSseHelperOptions).clientOptions));\n  const options = maybeOptions ?? (clientOrOptions as NodeSseHelperOptions);\n  const { iterableOptions, urlOptions } = splitSseOptions(options);\n\n  return client.sse<TData>(buildNodeSseUrl(urlOptions), iterableOptions);\n}\n\nfunction splitSseOptions(options: NodeSseHelperOptions): {\n  iterableOptions: SafeSseIterableOptions;\n  urlOptions: NodeSseUrlOptions;\n} {\n  const { cursor, since, sseUrl } = options;\n  const urlOptions: NodeSseUrlOptions = { sseUrl };\n  if (cursor !== undefined) urlOptions.cursor = cursor;\n  if (since !== undefined) urlOptions.since = since;\n\n  return { iterableOptions: removeUnsafeSseOptions(options), urlOptions };\n}\n\nfunction removeUnsafeSseOptions(options: NodeSseHelperOptions & UnsafeSseOptions): SafeSseIterableOptions {\n  const iterableOptions: SafeSseIterableOptions = {};\n  if (options.signal !== undefined) iterableOptions.signal = options.signal;\n  if (options.reconnect !== undefined) iterableOptions.reconnect = options.reconnect;\n  if (options.reconnectDelayMs !== undefined) iterableOptions.reconnectDelayMs = options.reconnectDelayMs;\n  if (options.maxReconnectDelayMs !== undefined) iterableOptions.maxReconnectDelayMs = options.maxReconnectDelayMs;\n  return iterableOptions;\n}\n","type ResumeParam = number | string | undefined;\n\ninterface ResumeParams {\n  cursor?: ResumeParam;\n  since?: ResumeParam;\n}\n\nexport function appendResumeParams(inputUrl: string, params: ResumeParams): string {\n  const url = new URL(inputUrl);\n\n  appendResumeParam(url.searchParams, 'since', params.since);\n  appendResumeParam(url.searchParams, 'cursor', params.cursor);\n\n  return url.toString();\n}\n\nfunction appendResumeParam(searchParams: URLSearchParams, key: string, value: ResumeParam): void {\n  const normalizedValue = value?.toString().trim();\n  if (normalizedValue !== undefined && normalizedValue !== '') searchParams.set(key, normalizedValue);\n}\n\nexport function normalizeWebSocketUrl(inputUrl: string): string {\n  if (inputUrl.startsWith('https://')) {\n    return `wss://${inputUrl.slice('https://'.length)}`;\n  }\n\n  if (inputUrl.startsWith('http://')) {\n    return `ws://${inputUrl.slice('http://'.length)}`;\n  }\n\n  return inputUrl;\n}\n","import WebSocket from 'ws';\n\nimport type { NodeWebSocketReconnectOptions, NodeWebSocketSubscriptionOptions } from './types.js';\nimport type { CloseInfo, PendingNext } from './websocket-types.js';\n\nimport { appendResumeParams } from './url.js';\nimport { extractCursor, parseSocketMessage } from './websocket-message.js';\nimport { buildClientOptions, normalizeReconnectOptions, resolveWebSocketUrl, sleep } from './websocket-options.js';\n\nexport class WebSocketSubscription<TEvent> implements AsyncIterator<TEvent> {\n  private readonly options: NodeWebSocketSubscriptionOptions<TEvent>;\n  private readonly reconnectOptions: Required<NodeWebSocketReconnectOptions>;\n  private readonly pending: Array<PendingNext<TEvent>> = [];\n  private readonly queue: TEvent[] = [];\n  private abortHandler?: () => void;\n  private closed = false;\n  private currentSocket: WebSocket | undefined;\n  private failure?: unknown;\n  private lastCursor: string | undefined;\n  private reconnectAttempts = 0;\n  private started = false;\n\n  constructor(options: NodeWebSocketSubscriptionOptions<TEvent>) {\n    this.options = options;\n    this.reconnectOptions = normalizeReconnectOptions(options.reconnect);\n    this.lastCursor = options.cursor;\n  }\n\n  async next(): Promise<IteratorResult<TEvent>> {\n    this.start();\n\n    if (this.queue.length > 0) return { done: false, value: this.queue.shift() as TEvent };\n    if (this.failure !== undefined) throw this.failure;\n    if (this.closed) return { done: true, value: undefined };\n\n    return new Promise<IteratorResult<TEvent>>((resolve, reject) => {\n      this.pending.push({ reject, resolve });\n    });\n  }\n\n  async return(): Promise<IteratorResult<TEvent>> {\n    this.close();\n    return done();\n  }\n\n  async throw(error?: unknown): Promise<IteratorResult<TEvent>> {\n    this.fail(error ?? new Error('WebSocket subscription iterator was interrupted.'));\n    return done();\n  }\n\n  private start(): void {\n    if (this.started) return;\n    this.started = true;\n\n    if (this.options.signal?.aborted) {\n      this.close();\n      return;\n    }\n\n    if (this.options.signal) {\n      this.abortHandler = () => {\n        this.close();\n      };\n\n      this.options.signal.addEventListener('abort', this.abortHandler, {\n        once: true,\n      });\n    }\n\n    void this.run();\n  }\n\n  private async run(): Promise<void> {\n    while (!this.closed) {\n      const socket = this.createSocket();\n      this.currentSocket = socket;\n      const closeInfo = await this.consumeSocket(socket);\n      this.currentSocket = undefined;\n\n      if (this.closed) {\n        break;\n      }\n\n      if (!this.shouldReconnect(closeInfo)) {\n        if (closeInfo.error !== undefined) {\n          this.fail(closeInfo.error);\n        } else {\n          this.close();\n        }\n\n        return;\n      }\n\n      this.reconnectAttempts += 1;\n      await sleep(this.reconnectDelayMs(this.reconnectAttempts));\n    }\n\n    this.close();\n  }\n\n  private createSocket(): WebSocket {\n    const url = appendResumeParams(resolveWebSocketUrl(this.options), {\n      cursor: this.lastCursor,\n      since: this.lastCursor !== undefined && this.lastCursor !== '' ? undefined : this.options.since,\n    });\n    const clientOptions = buildClientOptions(this.options);\n\n    return this.options.protocols === undefined\n      ? new WebSocket(url, clientOptions)\n      : new WebSocket(url, this.options.protocols, clientOptions);\n  }\n\n  private async consumeSocket(socket: WebSocket): Promise<CloseInfo> {\n    return new Promise<CloseInfo>((resolve) => {\n      this.attachSocketHandlers(socket, resolve);\n    });\n  }\n\n  private attachSocketHandlers(socket: WebSocket, resolve: (info: CloseInfo) => void): void {\n    let settled = false;\n    let opened = false;\n    let lastError: unknown;\n\n    const settle = (info: CloseInfo) => {\n      if (settled) return;\n      settled = true;\n      socket.off('close', onClose);\n      socket.off('error', onError);\n      socket.off('message', onMessage);\n      socket.off('open', onOpen);\n      socket.off('ping', onPing);\n      socket.off('pong', onPong);\n      resolve(info);\n    };\n\n    const onOpen = () => {\n      opened = true;\n    };\n\n    const onError = (error: unknown) => {\n      lastError = error;\n      if (!opened) settle({ error });\n    };\n\n    const onClose = (code: number) => {\n      settle({ code, error: lastError });\n    };\n\n    const onMessage = (data: WebSocket.RawData) => {\n      this.handleMessage(data, socket);\n    };\n\n    const onPing = () => {};\n    const onPong = () => {};\n\n    socket.on('open', onOpen);\n    socket.on('error', onError);\n    socket.on('close', onClose);\n    socket.on('message', onMessage);\n    socket.on('ping', onPing);\n    socket.on('pong', onPong);\n  }\n\n  private handleMessage(data: WebSocket.RawData, socket: WebSocket): void {\n    try {\n      const event = parseSocketMessage(data, this.options, socket);\n      if (event === undefined) return;\n\n      this.lastCursor = extractCursor(event) ?? this.lastCursor;\n      this.push(event);\n    } catch (error) {\n      this.fail(error);\n    }\n  }\n\n  private push(event: TEvent): void {\n    const pending = this.pending.shift();\n    if (pending !== undefined) {\n      pending.resolve({ done: false, value: event });\n      return;\n    }\n\n    this.queue.push(event);\n  }\n\n  private fail(error: unknown): void {\n    this.closed = true;\n    this.failure = error;\n    this.closeSocket();\n    this.removeAbortHandler();\n\n    for (const pending of this.pending.splice(0)) {\n      pending.reject(error);\n    }\n  }\n\n  private close(): void {\n    if (this.closed) {\n      return;\n    }\n\n    this.closed = true;\n    this.closeSocket();\n    this.removeAbortHandler();\n\n    for (const pending of this.pending.splice(0)) {\n      pending.resolve({ done: true, value: undefined });\n    }\n  }\n\n  private closeSocket(): void {\n    if (this.currentSocket === undefined) {\n      return;\n    }\n\n    const socket = this.currentSocket;\n\n    if (socket.readyState === WebSocket.CONNECTING || socket.readyState === WebSocket.OPEN) {\n      socket.close();\n    }\n\n    this.currentSocket = undefined;\n  }\n\n  private removeAbortHandler(): void {\n    if (this.abortHandler !== undefined && this.options.signal !== undefined) {\n      this.options.signal.removeEventListener('abort', this.abortHandler);\n    }\n  }\n\n  private shouldReconnect(info: CloseInfo): boolean {\n    if (!this.reconnectOptions.enabled || this.closed) {\n      return false;\n    }\n\n    if (this.reconnectAttempts >= this.reconnectOptions.maxRetries) {\n      return false;\n    }\n\n    return info.error !== undefined ? true : info.code !== undefined && info.code !== 1000 && info.code !== 1001;\n  }\n\n  private reconnectDelayMs(attempt: number): number {\n    return Math.min(\n      this.reconnectOptions.maxDelayMs,\n      this.reconnectOptions.initialDelayMs * this.reconnectOptions.factor ** Math.max(0, attempt - 1),\n    );\n  }\n}\n\nconst done = <TEvent>(): IteratorResult<TEvent> => ({\n  done: true,\n  value: undefined,\n});\n","import WebSocket, { type RawData } from 'ws';\n\nimport type { NodeWebSocketSubscriptionOptions } from './types.js';\n\nexport function parseSocketMessage<TEvent>(\n  data: RawData,\n  options: NodeWebSocketSubscriptionOptions<TEvent>,\n  socket: WebSocket,\n): TEvent | undefined {\n  const text = rawDataToText(data);\n  const heartbeat = normalizeHeartbeat(text);\n\n  if (heartbeat === 'ping') {\n    sendApplicationPong(socket);\n    return undefined;\n  }\n\n  if (heartbeat === 'pong') {\n    return undefined;\n  }\n\n  if (options.parse === false) {\n    return text as TEvent;\n  }\n\n  const parser = options.parser ?? defaultParseSocketEvent<TEvent>;\n\n  try {\n    return parser(text);\n  } catch (textError) {\n    try {\n      return parser(JSON.parse(text));\n    } catch {\n      throw textError;\n    }\n  }\n}\n\nexport function extractCursor(event: unknown): string | undefined {\n  if (event === null || event === undefined || typeof event !== 'object') {\n    return undefined;\n  }\n\n  const record = event as Record<string, unknown>;\n  const cursor = record.cursor ?? record.id ?? record.eventId ?? record.lastEventId;\n\n  if (typeof cursor === 'string' && cursor.length > 0) {\n    return cursor;\n  }\n\n  if (typeof cursor === 'number' && Number.isFinite(cursor) && cursor >= 0) {\n    return String(Math.trunc(cursor));\n  }\n\n  return extractMetaTimestampCursor(record);\n}\n\nfunction defaultParseSocketEvent<TEvent>(message: unknown): TEvent {\n  if (typeof message === 'string') {\n    return JSON.parse(message) as TEvent;\n  }\n\n  return message as TEvent;\n}\n\nfunction rawDataToText(data: RawData): string {\n  if (Buffer.isBuffer(data)) {\n    return data.toString('utf8');\n  }\n\n  if (data instanceof ArrayBuffer) {\n    return Buffer.from(data).toString('utf8');\n  }\n\n  if (Array.isArray(data)) {\n    return Buffer.concat(data).toString('utf8');\n  }\n\n  return Buffer.from(data).toString('utf8');\n}\n\nfunction extractMetaTimestampCursor(record: Record<string, unknown>): string | undefined {\n  const { meta } = record;\n  if (meta === null || meta === undefined || typeof meta !== 'object') {\n    return undefined;\n  }\n\n  const { timestamp } = meta as Record<string, unknown>;\n  if (typeof timestamp !== 'string') {\n    return undefined;\n  }\n\n  const timestampMs = Date.parse(timestamp);\n  return Number.isFinite(timestampMs) && timestampMs >= 0 ? String(Math.trunc(timestampMs)) : undefined;\n}\n\nfunction normalizeHeartbeat(text: string): 'ping' | 'pong' | undefined {\n  const trimmed = text.trim().toLowerCase();\n\n  if (trimmed === 'ping' || trimmed === '{\"type\":\"ping\"}' || trimmed === '{\"event\":\"ping\"}') {\n    return 'ping';\n  }\n\n  if (trimmed === 'pong' || trimmed === '{\"type\":\"pong\"}' || trimmed === '{\"event\":\"pong\"}') {\n    return 'pong';\n  }\n\n  return undefined;\n}\n\nfunction sendApplicationPong(socket: WebSocket): void {\n  if (socket.readyState === WebSocket.OPEN) {\n    socket.send('pong', { binary: false });\n  }\n}\n","import type { ClientOptions } from 'ws';\n\nimport type { NodeWebSocketReconnectOptions, NodeWebSocketSubscriptionOptions } from './types.js';\n\nexport const DEFAULT_RECONNECT_OPTIONS: Required<NodeWebSocketReconnectOptions> = {\n  enabled: true,\n  factor: 2,\n  initialDelayMs: 250,\n  maxDelayMs: 5000,\n  maxRetries: Number.POSITIVE_INFINITY,\n};\n\nexport function normalizeReconnectOptions(\n  reconnect: boolean | NodeWebSocketReconnectOptions | undefined,\n): Required<NodeWebSocketReconnectOptions> {\n  if (reconnect === false) {\n    return { ...DEFAULT_RECONNECT_OPTIONS, enabled: false };\n  }\n\n  if (reconnect === true || reconnect === undefined) {\n    return DEFAULT_RECONNECT_OPTIONS;\n  }\n\n  return {\n    enabled: reconnect.enabled ?? DEFAULT_RECONNECT_OPTIONS.enabled,\n    factor: reconnect.factor ?? DEFAULT_RECONNECT_OPTIONS.factor,\n    initialDelayMs: reconnect.initialDelayMs ?? DEFAULT_RECONNECT_OPTIONS.initialDelayMs,\n    maxDelayMs: reconnect.maxDelayMs ?? DEFAULT_RECONNECT_OPTIONS.maxDelayMs,\n    maxRetries: reconnect.maxRetries ?? DEFAULT_RECONNECT_OPTIONS.maxRetries,\n  };\n}\n\nexport function resolveWebSocketUrl(options: NodeWebSocketSubscriptionOptions<unknown>): string {\n  const url = options.wsUrl ?? options.websocketUrl ?? options.url;\n\n  if (url === undefined || url === '') {\n    throw new TypeError('A WebSocket URL is required. Pass wsUrl, websocketUrl, or url.');\n  }\n\n  return url;\n}\n\nexport function buildClientOptions(options: NodeWebSocketSubscriptionOptions<unknown>): ClientOptions {\n  const clientOptions: ClientOptions = { ...options.clientOptions };\n  const headers = {\n    ...coerceHeaders(options.clientOptions?.headers),\n    ...options.headers,\n  };\n\n  const apiKey = options.apiKey?.trim();\n  if (apiKey !== undefined && apiKey !== '' && !hasAuthorizationHeader(headers)) {\n    headers.Authorization = `Bearer ${apiKey}`;\n  }\n\n  if (Object.keys(headers).length > 0) {\n    clientOptions.headers = headers;\n  }\n\n  return clientOptions;\n}\n\nfunction coerceHeaders(headers: ClientOptions['headers']): Record<string, string> {\n  if (headers === undefined) {\n    return {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(headers).map(([key, value]) => [key, Array.isArray(value) ? value.join(', ') : String(value)]),\n  );\n}\n\nfunction hasAuthorizationHeader(headers: Record<string, string>): boolean {\n  return Object.keys(headers).some((key) => key.toLowerCase() === 'authorization');\n}\n\nexport async function sleep(delayMs: number): Promise<void> {\n  return new Promise((resolve) => {\n    const timeout = setTimeout(resolve, delayMs);\n    timeout.unref?.();\n  });\n}\n","import type { StreamEvent } from '@restless-stream/core';\n\nimport type { NodeWebSocketSubscriptionOptions } from './types.js';\n\nimport { WebSocketSubscription } from './websocket-subscription.js';\n\nexport function subscribeWebSocket<TEvent = StreamEvent>(\n  options: NodeWebSocketSubscriptionOptions<TEvent>,\n): AsyncIterable<TEvent> {\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<TEvent> {\n      return new WebSocketSubscription(options);\n    },\n  };\n}\n"],"mappings":"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","names":["createRestlessClient","WebSocket","WebSocket","createRestlessClient"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@restless-stream/node",
+  "version": "0.1.0",
+  "description": "Node.js SDK helpers for Restless Stream.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "@restless-stream/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:live": "vitest run tests/live.test.ts --config vitest.live.config.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}