@sensiblestats/widget-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+SensibleStats Widget SDK — Proprietary License
+
+Copyright (c) 2026 SensibleStats. All rights reserved.
+
+This software and the accompanying files (the "Software") are the proprietary and
+confidential property of SensibleStats. The Software is licensed, not sold.
+
+Use of the Software is permitted solely by SensibleStats operators and their
+authorized end users, and only as necessary to integrate and operate the
+SensibleStats chat widget in accordance with a valid, active commercial agreement
+with SensibleStats. All rights not expressly granted are reserved by SensibleStats.
+
+Except as permitted above, no part of the Software may be copied, modified, merged,
+published, distributed, sublicensed, sold, reverse engineered, decompiled, or used
+to create derivative works without the prior written consent of SensibleStats.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL SENSIBLESTATS BE LIABLE
+FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT,
+OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @sensiblestats/widget-sdk
+
+Headless browser SDK for the SensibleStats chat widget gateway. Zero dependencies, typed.
+
+## Install
+
+`yarn add @sensiblestats/widget-sdk`
+
+## Usage
+
+```ts
+import { StatsWidgetClient } from '@sensiblestats/widget-sdk'
+
+const client = new StatsWidgetClient({ operatorId: 'sandbox1', publicKey: 'wgk_…' })
+
+// Streaming chat — iterate
+for await (const ev of client.chat({ message: 'odds for Arsenal?' })) {
+  if (ev.type === 'answer') console.log(ev.data.text)
+}
+
+// Streaming chat — callbacks (await to run to completion)
+await client.chat({ message: 'odds for Arsenal?' }, { onAnswer: a => render(a.text) })
+
+// Multi-turn
+const convo = client.conversation({ operatorUserId: 'u_42' })
+await convo.send({ message: 'and their recent form?' })
+
+// Signals
+await client.sendSignal({ signalType: 'MatchPageView', entityType: 'Match', entityName: 'Arsenal vs Chelsea', operatorUserId: 'u_42' })
+```
+
+Errors are typed: `AuthError` (401), `ForbiddenError` (403), `RateLimitError` (429), `UpstreamError` (5xx), `NetworkError`, `ParseError`.

package/dist/index.cjs

@@ -0,0 +1,353 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthError: () => AuthError,
+  Conversation: () => Conversation,
+  ENTITY_TYPE_CODES: () => ENTITY_TYPE_CODES,
+  ForbiddenError: () => ForbiddenError,
+  NetworkError: () => NetworkError,
+  ParseError: () => ParseError,
+  RateLimitError: () => RateLimitError,
+  SIGNAL_TYPE_CODES: () => SIGNAL_TYPE_CODES,
+  StatsWidgetClient: () => StatsWidgetClient,
+  UpstreamError: () => UpstreamError,
+  WidgetSdkError: () => WidgetSdkError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var WidgetSdkError = class extends Error {
+  constructor(message, code, status) {
+    super(message);
+    this.name = new.target.name;
+    this.code = code;
+    this.status = status;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AuthError = class extends WidgetSdkError {
+  constructor(message = "Invalid or missing public key") {
+    super(message, "unauthorized", 401);
+  }
+};
+var ForbiddenError = class extends WidgetSdkError {
+  constructor(message = "Origin not allowed or widget disabled") {
+    super(message, "forbidden", 403);
+  }
+};
+var RateLimitError = class extends WidgetSdkError {
+  constructor(retryAfter, message = "Rate limited") {
+    super(message, "rate_limited", 429);
+    this.retryAfter = retryAfter;
+  }
+};
+var UpstreamError = class extends WidgetSdkError {
+  constructor(status, message = "Upstream error") {
+    super(message, "upstream_error", status);
+  }
+};
+var NetworkError = class extends WidgetSdkError {
+  constructor(message = "Network request failed", cause) {
+    super(message, "network_error");
+    this.cause = cause;
+  }
+};
+var ParseError = class extends WidgetSdkError {
+  constructor(message = "Malformed NDJSON line", line) {
+    super(message, "parse_error");
+    this.line = line;
+  }
+};
+
+// src/http.ts
+function endpoint(cfg, path) {
+  return `${cfg.baseUrl.replace(/\/+$/, "")}/v1/${encodeURIComponent(cfg.operatorId)}/${path}`;
+}
+function toWidgetError(status, retryAfterHeader) {
+  switch (status) {
+    case 401:
+      return new AuthError();
+    case 403:
+      return new ForbiddenError();
+    case 429: {
+      const n = retryAfterHeader != null ? Number(retryAfterHeader) : void 0;
+      return new RateLimitError(Number.isFinite(n) ? n : void 0);
+    }
+    default:
+      return new UpstreamError(status);
+  }
+}
+function isAbort(error) {
+  return error instanceof Error && error.name === "AbortError";
+}
+async function send(cfg, path, body, signal) {
+  try {
+    return await cfg.fetch(endpoint(cfg, path), {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-SS-Public-Key": cfg.publicKey },
+      body: JSON.stringify(body),
+      signal
+    });
+  } catch (error) {
+    if (isAbort(error)) throw error;
+    throw new NetworkError("Network request failed", error);
+  }
+}
+async function postChat(cfg, input, signal) {
+  const res = await send(cfg, "chat", input, signal);
+  if (!res.ok || res.body == null) throw toWidgetError(res.status, res.headers.get("Retry-After"));
+  return res;
+}
+async function postSignal(cfg, wireBody, signal) {
+  const res = await send(cfg, "signals", wireBody, signal);
+  if (!res.ok) throw toWidgetError(res.status, res.headers.get("Retry-After"));
+}
+
+// src/ndjson.ts
+function parseLine(line) {
+  const trimmed = line.trim();
+  if (trimmed === "") return void 0;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    throw new ParseError("Malformed NDJSON line", line);
+  }
+}
+function createNdjsonParser() {
+  let buffer = "";
+  return {
+    push(text) {
+      buffer += text;
+      const out = [];
+      let idx;
+      while ((idx = buffer.indexOf("\n")) >= 0) {
+        const line = buffer.slice(0, idx);
+        buffer = buffer.slice(idx + 1);
+        const parsed = parseLine(line);
+        if (parsed !== void 0) out.push(parsed);
+      }
+      return out;
+    },
+    flush() {
+      const rest = buffer;
+      buffer = "";
+      const parsed = parseLine(rest);
+      return parsed === void 0 ? [] : [parsed];
+    }
+  };
+}
+
+// src/chat.ts
+function dispatch(ev, cb) {
+  switch (ev.type) {
+    case "progress":
+      cb.onProgress?.(ev.data);
+      break;
+    case "answer":
+      cb.onAnswer?.(ev.data);
+      break;
+    case "entity_card":
+      cb.onEntityCard?.(ev.data);
+      break;
+    case "action_button":
+      cb.onActionButton?.(ev.data);
+      break;
+    case "intent_chip":
+      cb.onIntentChip?.(ev.data);
+      break;
+    case "actions_loading":
+      cb.onActionsLoading?.(ev.data);
+      break;
+    case "turn_complete":
+      cb.onComplete?.(ev.data);
+      break;
+    case "error":
+      cb.onError?.(ev.data);
+      break;
+  }
+}
+async function* streamEvents(cfg, input, signal) {
+  const res = await postChat(cfg, input, signal);
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  const parser = createNdjsonParser();
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      for (const obj of parser.push(decoder.decode(value, { stream: true }))) yield obj;
+    }
+    for (const obj of parser.flush()) yield obj;
+  } finally {
+    await reader.cancel().catch(() => {
+    });
+  }
+}
+function runChat(cfg, input, callbacks, opts) {
+  const controller = new AbortController();
+  const external = opts?.signal;
+  if (external) {
+    if (external.aborted) controller.abort();
+    else external.addEventListener("abort", () => controller.abort(), { once: true });
+  }
+  async function* source() {
+    for await (const ev of streamEvents(cfg, input, controller.signal)) {
+      opts?.tap?.(ev);
+      yield ev;
+    }
+  }
+  const iterator = source();
+  let consumed = false;
+  async function drive() {
+    try {
+      for await (const ev of iterator) {
+        if (callbacks) dispatch(ev, callbacks);
+      }
+    } catch (error) {
+      if (callbacks?.onError && error instanceof WidgetSdkError) {
+        callbacks.onError(error);
+        return;
+      }
+      throw error;
+    }
+  }
+  return {
+    [Symbol.asyncIterator]() {
+      if (consumed) throw new Error("chat stream already consumed");
+      consumed = true;
+      return iterator;
+    },
+    then(onfulfilled, onrejected) {
+      if (consumed) return Promise.resolve().then(onfulfilled, onrejected);
+      consumed = true;
+      return drive().then(onfulfilled, onrejected);
+    },
+    cancel() {
+      controller.abort();
+    }
+  };
+}
+
+// src/signals.ts
+var SIGNAL_TYPE_CODES = {
+  MatchPageView: 1,
+  PlayerPageView: 2,
+  TeamPageView: 3,
+  MarketView: 4,
+  SearchQuery: 5,
+  SessionDepth: 6,
+  TimeOnPage: 7,
+  InsightViewed: 8,
+  InsightMarketClicked: 9,
+  BetPlacedFromInsight: 10,
+  InsightScrollDepth: 11,
+  ToolCall: 12,
+  EntityMention: 13,
+  Handoff: 14,
+  FollowUpQuery: 15,
+  RecommendationDismissed: 16
+};
+var ENTITY_TYPE_CODES = {
+  Match: 1,
+  Team: 2,
+  Player: 3,
+  Competition: 4,
+  Market: 5,
+  Article: 6,
+  Session: 7,
+  Query: 8,
+  Conversation: 9
+};
+function toSignalWireBody(input) {
+  const signalType = SIGNAL_TYPE_CODES[input.signalType];
+  const entityType = ENTITY_TYPE_CODES[input.entityType];
+  if (signalType === void 0) throw new Error(`Unknown signalType: ${String(input.signalType)}`);
+  if (entityType === void 0) throw new Error(`Unknown entityType: ${String(input.entityType)}`);
+  return { signalType, entityType, entityName: input.entityName, operatorUserId: input.operatorUserId };
+}
+
+// src/conversation.ts
+var Conversation = class {
+  constructor(cfg, context) {
+    this.cfg = cfg;
+    this.context = context;
+  }
+  send(input, callbacks) {
+    const mergedContext = { ...this.context, ...input.userContext };
+    const full = {
+      ...input,
+      conversationId: input.conversationId ?? this.conversationId,
+      userContext: Object.keys(mergedContext).length > 0 ? mergedContext : void 0
+    };
+    return runChat(this.cfg, full, callbacks, {
+      tap: (ev) => {
+        if (ev.type === "turn_complete") this.conversationId = ev.data.conversationId;
+      }
+    });
+  }
+  sendSignal(input) {
+    const operatorUserId = input.operatorUserId ?? this.context?.operatorUserId;
+    if (!operatorUserId) throw new Error("operatorUserId is required (set it on conversation() or pass it to sendSignal)");
+    return postSignal(this.cfg, toSignalWireBody({ ...input, operatorUserId }));
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://widget.sensiblestats.com";
+var StatsWidgetClient = class {
+  constructor(options) {
+    if (!options.operatorId) throw new Error("operatorId is required");
+    if (!options.publicKey) throw new Error("publicKey is required");
+    const fetchImpl = options.fetch ?? (globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
+    if (!fetchImpl) throw new Error("No fetch implementation available; pass options.fetch");
+    this.cfg = {
+      operatorId: options.operatorId,
+      publicKey: options.publicKey,
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+      fetch: fetchImpl
+    };
+  }
+  chat(input, callbacks) {
+    return runChat(this.cfg, input, callbacks);
+  }
+  async sendSignal(input) {
+    await postSignal(this.cfg, toSignalWireBody(input));
+  }
+  conversation(context) {
+    return new Conversation(this.cfg, context);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthError,
+  Conversation,
+  ENTITY_TYPE_CODES,
+  ForbiddenError,
+  NetworkError,
+  ParseError,
+  RateLimitError,
+  SIGNAL_TYPE_CODES,
+  StatsWidgetClient,
+  UpstreamError,
+  WidgetSdkError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/ndjson.ts","../src/chat.ts","../src/signals.ts","../src/conversation.ts","../src/client.ts"],"sourcesContent":["export { StatsWidgetClient } from './client'\nexport { Conversation } from './conversation'\nexport type { ChatCallbacks, ChatHandle } from './chat'\nexport { SIGNAL_TYPE_CODES, ENTITY_TYPE_CODES } from './signals'\nexport {\n  WidgetSdkError, AuthError, ForbiddenError, RateLimitError, UpstreamError, NetworkError, ParseError,\n} from './errors'\nexport type {\n  StatsWidgetClientOptions, FetchLike, UserContext, ChatInput,\n  SignalType, SignalEntityType, SignalInput,\n} from './types'\nexport type {\n  ChatEvent, ProgressEventData, AnswerEventData, EntityCard, EntityCardEventData,\n  ActionButtonEventData, IntentChipEventData, ActionsLoadingEventData,\n  TurnCompleteEventData, StreamErrorEventData,\n} from './events'\n","export class WidgetSdkError extends Error {\n  readonly code: string\n  readonly status?: number\n  constructor(message: string, code: string, status?: number) {\n    super(message)\n    this.name = new.target.name\n    this.code = code\n    this.status = status\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\nexport class AuthError extends WidgetSdkError {\n  constructor(message = 'Invalid or missing public key') { super(message, 'unauthorized', 401) }\n}\nexport class ForbiddenError extends WidgetSdkError {\n  constructor(message = 'Origin not allowed or widget disabled') { super(message, 'forbidden', 403) }\n}\nexport class RateLimitError extends WidgetSdkError {\n  readonly retryAfter?: number\n  constructor(retryAfter?: number, message = 'Rate limited') { super(message, 'rate_limited', 429); this.retryAfter = retryAfter }\n}\nexport class UpstreamError extends WidgetSdkError {\n  constructor(status: number, message = 'Upstream error') { super(message, 'upstream_error', status) }\n}\nexport class NetworkError extends WidgetSdkError {\n  readonly cause?: unknown\n  constructor(message = 'Network request failed', cause?: unknown) { super(message, 'network_error'); this.cause = cause }\n}\nexport class ParseError extends WidgetSdkError {\n  readonly line?: string\n  constructor(message = 'Malformed NDJSON line', line?: string) { super(message, 'parse_error'); this.line = line }\n}\n","import { AuthError, ForbiddenError, NetworkError, RateLimitError, UpstreamError, WidgetSdkError } from './errors'\nimport type { ChatInput, FetchLike } from './types'\n\nexport interface ResolvedConfig {\n  operatorId: string\n  publicKey: string\n  baseUrl: string\n  fetch: FetchLike\n}\n\nfunction endpoint(cfg: ResolvedConfig, path: string): string {\n  return `${cfg.baseUrl.replace(/\\/+$/, '')}/v1/${encodeURIComponent(cfg.operatorId)}/${path}`\n}\n\nexport function toWidgetError(status: number, retryAfterHeader: string | null): WidgetSdkError {\n  switch (status) {\n    case 401: return new AuthError()\n    case 403: return new ForbiddenError()\n    case 429: {\n      const n = retryAfterHeader != null ? Number(retryAfterHeader) : undefined\n      return new RateLimitError(Number.isFinite(n) ? (n as number) : undefined)\n    }\n    default: return new UpstreamError(status)\n  }\n}\n\nfunction isAbort(error: unknown): boolean {\n  return error instanceof Error && error.name === 'AbortError'\n}\n\nasync function send(cfg: ResolvedConfig, path: string, body: object, signal?: AbortSignal): Promise<Response> {\n  try {\n    return await cfg.fetch(endpoint(cfg, path), {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', 'X-SS-Public-Key': cfg.publicKey },\n      body: JSON.stringify(body),\n      signal,\n    })\n  } catch (error) {\n    if (isAbort(error)) throw error\n    throw new NetworkError('Network request failed', error)\n  }\n}\n\nexport async function postChat(cfg: ResolvedConfig, input: ChatInput, signal: AbortSignal): Promise<Response> {\n  const res = await send(cfg, 'chat', input, signal)\n  if (!res.ok || res.body == null) throw toWidgetError(res.status, res.headers.get('Retry-After'))\n  return res\n}\n\nexport async function postSignal(cfg: ResolvedConfig, wireBody: object, signal?: AbortSignal): Promise<void> {\n  const res = await send(cfg, 'signals', wireBody, signal)\n  if (!res.ok) throw toWidgetError(res.status, res.headers.get('Retry-After'))\n}\n","import { ParseError } from './errors'\n\nexport interface NdjsonParser {\n  push(text: string): unknown[]\n  flush(): unknown[]\n}\n\nfunction parseLine(line: string): unknown | undefined {\n  const trimmed = line.trim()\n  if (trimmed === '') return undefined\n  try {\n    return JSON.parse(trimmed)\n  } catch {\n    throw new ParseError('Malformed NDJSON line', line)\n  }\n}\n\nexport function createNdjsonParser(): NdjsonParser {\n  let buffer = ''\n  return {\n    push(text: string): unknown[] {\n      buffer += text\n      const out: unknown[] = []\n      let idx: number\n      while ((idx = buffer.indexOf('\\n')) >= 0) {\n        const line = buffer.slice(0, idx)\n        buffer = buffer.slice(idx + 1)\n        const parsed = parseLine(line)\n        if (parsed !== undefined) out.push(parsed)\n      }\n      return out\n    },\n    flush(): unknown[] {\n      const rest = buffer\n      buffer = ''\n      const parsed = parseLine(rest)\n      return parsed === undefined ? [] : [parsed]\n    },\n  }\n}\n","import { WidgetSdkError } from './errors'\nimport type {\n  ActionButtonEventData, ActionsLoadingEventData, AnswerEventData, ChatEvent,\n  EntityCardEventData, IntentChipEventData, ProgressEventData, StreamErrorEventData, TurnCompleteEventData,\n} from './events'\nimport { postChat, type ResolvedConfig } from './http'\nimport { createNdjsonParser } from './ndjson'\nimport type { ChatInput } from './types'\n\nexport interface ChatCallbacks {\n  onProgress?(data: ProgressEventData): void\n  onAnswer?(data: AnswerEventData): void\n  onEntityCard?(data: EntityCardEventData): void\n  onActionButton?(data: ActionButtonEventData): void\n  onIntentChip?(data: IntentChipEventData): void\n  onActionsLoading?(data: ActionsLoadingEventData): void\n  onError?(error: StreamErrorEventData | WidgetSdkError): void\n  onComplete?(data: TurnCompleteEventData): void\n}\n\nexport interface ChatHandle extends AsyncIterable<ChatEvent>, PromiseLike<void> {\n  cancel(): void\n}\n\nfunction dispatch(ev: ChatEvent, cb: ChatCallbacks): void {\n  switch (ev.type) {\n    case 'progress': cb.onProgress?.(ev.data); break\n    case 'answer': cb.onAnswer?.(ev.data); break\n    case 'entity_card': cb.onEntityCard?.(ev.data); break\n    case 'action_button': cb.onActionButton?.(ev.data); break\n    case 'intent_chip': cb.onIntentChip?.(ev.data); break\n    case 'actions_loading': cb.onActionsLoading?.(ev.data); break\n    case 'turn_complete': cb.onComplete?.(ev.data); break\n    case 'error': cb.onError?.(ev.data); break\n  }\n}\n\nasync function* streamEvents(cfg: ResolvedConfig, input: ChatInput, signal: AbortSignal): AsyncGenerator<ChatEvent> {\n  const res = await postChat(cfg, input, signal)\n  const reader = res.body!.getReader()\n  const decoder = new TextDecoder()\n  const parser = createNdjsonParser()\n  try {\n    for (;;) {\n      const { done, value } = await reader.read()\n      if (done) break\n      for (const obj of parser.push(decoder.decode(value, { stream: true }))) yield obj as ChatEvent\n    }\n    for (const obj of parser.flush()) yield obj as ChatEvent\n  } finally {\n    await reader.cancel().catch(() => {})\n  }\n}\n\nexport function runChat(\n  cfg: ResolvedConfig,\n  input: ChatInput,\n  callbacks?: ChatCallbacks,\n  opts?: { signal?: AbortSignal; tap?: (ev: ChatEvent) => void },\n): ChatHandle {\n  const controller = new AbortController()\n  const external = opts?.signal\n  if (external) {\n    if (external.aborted) controller.abort()\n    else external.addEventListener('abort', () => controller.abort(), { once: true })\n  }\n\n  async function* source(): AsyncGenerator<ChatEvent> {\n    for await (const ev of streamEvents(cfg, input, controller.signal)) {\n      opts?.tap?.(ev)\n      yield ev\n    }\n  }\n\n  const iterator = source()\n  let consumed = false\n\n  async function drive(): Promise<void> {\n    try {\n      for await (const ev of iterator) { if (callbacks) dispatch(ev, callbacks) }\n    } catch (error) {\n      if (callbacks?.onError && error instanceof WidgetSdkError) { callbacks.onError(error); return }\n      throw error\n    }\n  }\n\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<ChatEvent> {\n      if (consumed) throw new Error('chat stream already consumed')\n      consumed = true\n      return iterator\n    },\n    then<TResult1 = void, TResult2 = never>(\n      onfulfilled?: ((value: void) => TResult1 | PromiseLike<TResult1>) | null,\n      onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n    ): PromiseLike<TResult1 | TResult2> {\n      if (consumed) return Promise.resolve().then(onfulfilled, onrejected)\n      consumed = true\n      return drive().then(onfulfilled, onrejected)\n    },\n    cancel(): void { controller.abort() },\n  }\n}\n","import type { SignalEntityType, SignalInput, SignalType } from './types'\n\nexport const SIGNAL_TYPE_CODES: Record<SignalType, number> = {\n  MatchPageView: 1, PlayerPageView: 2, TeamPageView: 3, MarketView: 4,\n  SearchQuery: 5, SessionDepth: 6, TimeOnPage: 7, InsightViewed: 8,\n  InsightMarketClicked: 9, BetPlacedFromInsight: 10, InsightScrollDepth: 11,\n  ToolCall: 12, EntityMention: 13, Handoff: 14, FollowUpQuery: 15, RecommendationDismissed: 16,\n}\n\nexport const ENTITY_TYPE_CODES: Record<SignalEntityType, number> = {\n  Match: 1, Team: 2, Player: 3, Competition: 4, Market: 5,\n  Article: 6, Session: 7, Query: 8, Conversation: 9,\n}\n\nexport function toSignalWireBody(input: SignalInput): {\n  signalType: number; entityType: number; entityName: string; operatorUserId: string\n} {\n  const signalType = SIGNAL_TYPE_CODES[input.signalType]\n  const entityType = ENTITY_TYPE_CODES[input.entityType]\n  if (signalType === undefined) throw new Error(`Unknown signalType: ${String(input.signalType)}`)\n  if (entityType === undefined) throw new Error(`Unknown entityType: ${String(input.entityType)}`)\n  return { signalType, entityType, entityName: input.entityName, operatorUserId: input.operatorUserId }\n}\n","import { runChat, type ChatCallbacks, type ChatHandle } from './chat'\nimport { postSignal, type ResolvedConfig } from './http'\nimport { toSignalWireBody } from './signals'\nimport type { ChatInput, SignalInput, UserContext } from './types'\n\nexport class Conversation {\n  conversationId?: string\n\n  constructor(private readonly cfg: ResolvedConfig, private readonly context?: UserContext) {}\n\n  send(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle {\n    const mergedContext: UserContext = { ...this.context, ...input.userContext }\n    const full: ChatInput = {\n      ...input,\n      conversationId: input.conversationId ?? this.conversationId,\n      userContext: Object.keys(mergedContext).length > 0 ? mergedContext : undefined,\n    }\n    return runChat(this.cfg, full, callbacks, {\n      tap: (ev) => { if (ev.type === 'turn_complete') this.conversationId = ev.data.conversationId },\n    })\n  }\n\n  sendSignal(input: Omit<SignalInput, 'operatorUserId'> & { operatorUserId?: string }): Promise<void> {\n    const operatorUserId = input.operatorUserId ?? this.context?.operatorUserId\n    if (!operatorUserId) throw new Error('operatorUserId is required (set it on conversation() or pass it to sendSignal)')\n    return postSignal(this.cfg, toSignalWireBody({ ...input, operatorUserId }))\n  }\n}\n","import { runChat, type ChatCallbacks, type ChatHandle } from './chat'\nimport { Conversation } from './conversation'\nimport { postSignal, type ResolvedConfig } from './http'\nimport { toSignalWireBody } from './signals'\nimport type { ChatInput, SignalInput, StatsWidgetClientOptions, UserContext } from './types'\n\nconst DEFAULT_BASE_URL = 'https://widget.sensiblestats.com'\n\nexport class StatsWidgetClient {\n  private readonly cfg: ResolvedConfig\n\n  constructor(options: StatsWidgetClientOptions) {\n    if (!options.operatorId) throw new Error('operatorId is required')\n    if (!options.publicKey) throw new Error('publicKey is required')\n    const fetchImpl = options.fetch ?? (globalThis.fetch ? globalThis.fetch.bind(globalThis) : undefined)\n    if (!fetchImpl) throw new Error('No fetch implementation available; pass options.fetch')\n    this.cfg = {\n      operatorId: options.operatorId,\n      publicKey: options.publicKey,\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      fetch: fetchImpl,\n    }\n  }\n\n  chat(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle {\n    return runChat(this.cfg, input, callbacks)\n  }\n\n  async sendSignal(input: SignalInput): Promise<void> {\n    await postSignal(this.cfg, toSignalWireBody(input))\n  }\n\n  conversation(context?: UserContext): Conversation {\n    return new Conversation(this.cfg, context)\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,144 @@
+declare class WidgetSdkError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    constructor(message: string, code: string, status?: number);
+}
+declare class AuthError extends WidgetSdkError {
+    constructor(message?: string);
+}
+declare class ForbiddenError extends WidgetSdkError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends WidgetSdkError {
+    readonly retryAfter?: number;
+    constructor(retryAfter?: number, message?: string);
+}
+declare class UpstreamError extends WidgetSdkError {
+    constructor(status: number, message?: string);
+}
+declare class NetworkError extends WidgetSdkError {
+    readonly cause?: unknown;
+    constructor(message?: string, cause?: unknown);
+}
+declare class ParseError extends WidgetSdkError {
+    readonly line?: string;
+    constructor(message?: string, line?: string);
+}
+
+interface ProgressEventData {
+    phase: string;
+    message: string;
+}
+interface AnswerEventData {
+    text: string;
+}
+interface EntityCard {
+    entityId: number;
+    entityType: string;
+    mentionText: string;
+    canonicalName: string;
+    [key: string]: unknown;
+}
+interface EntityCardEventData {
+    card: EntityCard;
+}
+interface ActionButtonEventData {
+    action: Record<string, unknown>;
+}
+interface IntentChipEventData {
+    intent: Record<string, unknown>;
+}
+interface ActionsLoadingEventData {
+    message: string;
+}
+interface TurnCompleteEventData {
+    conversationId: string;
+    agentId?: string;
+    routeDecision: string;
+    isAgentRouted: boolean;
+    totalLatencyMs: number;
+}
+interface StreamErrorEventData {
+    code: string;
+    message: string;
+    terminal: boolean;
+}
+interface EventEnvelope<TType extends string, TData> {
+    type: TType;
+    requestId: string;
+    timestamp: string;
+    data: TData;
+}
+type ChatEvent = EventEnvelope<'progress', ProgressEventData> | EventEnvelope<'answer', AnswerEventData> | EventEnvelope<'entity_card', EntityCardEventData> | EventEnvelope<'action_button', ActionButtonEventData> | EventEnvelope<'intent_chip', IntentChipEventData> | EventEnvelope<'actions_loading', ActionsLoadingEventData> | EventEnvelope<'turn_complete', TurnCompleteEventData> | EventEnvelope<'error', StreamErrorEventData>;
+
+type FetchLike = (input: string, init: RequestInit) => Promise<Response>;
+interface StatsWidgetClientOptions {
+    operatorId: string;
+    publicKey: string;
+    baseUrl?: string;
+    /** Advanced/testing: inject a fetch implementation. Defaults to globalThis.fetch. */
+    fetch?: FetchLike;
+}
+interface UserContext {
+    operatorUserId?: string;
+    defaultLanguage?: string;
+}
+interface ChatInput {
+    message: string;
+    conversationId?: string;
+    actionId?: string;
+    userContext?: UserContext;
+}
+type SignalType = 'MatchPageView' | 'PlayerPageView' | 'TeamPageView' | 'MarketView' | 'SearchQuery' | 'SessionDepth' | 'TimeOnPage' | 'InsightViewed' | 'InsightMarketClicked' | 'BetPlacedFromInsight' | 'InsightScrollDepth' | 'ToolCall' | 'EntityMention' | 'Handoff' | 'FollowUpQuery' | 'RecommendationDismissed';
+type SignalEntityType = 'Match' | 'Team' | 'Player' | 'Competition' | 'Market' | 'Article' | 'Session' | 'Query' | 'Conversation';
+interface SignalInput {
+    signalType: SignalType;
+    entityType: SignalEntityType;
+    entityName: string;
+    operatorUserId: string;
+}
+
+interface ResolvedConfig {
+    operatorId: string;
+    publicKey: string;
+    baseUrl: string;
+    fetch: FetchLike;
+}
+
+interface ChatCallbacks {
+    onProgress?(data: ProgressEventData): void;
+    onAnswer?(data: AnswerEventData): void;
+    onEntityCard?(data: EntityCardEventData): void;
+    onActionButton?(data: ActionButtonEventData): void;
+    onIntentChip?(data: IntentChipEventData): void;
+    onActionsLoading?(data: ActionsLoadingEventData): void;
+    onError?(error: StreamErrorEventData | WidgetSdkError): void;
+    onComplete?(data: TurnCompleteEventData): void;
+}
+interface ChatHandle extends AsyncIterable<ChatEvent>, PromiseLike<void> {
+    cancel(): void;
+}
+
+declare class Conversation {
+    private readonly cfg;
+    private readonly context?;
+    conversationId?: string;
+    constructor(cfg: ResolvedConfig, context?: UserContext | undefined);
+    send(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle;
+    sendSignal(input: Omit<SignalInput, 'operatorUserId'> & {
+        operatorUserId?: string;
+    }): Promise<void>;
+}
+
+declare class StatsWidgetClient {
+    private readonly cfg;
+    constructor(options: StatsWidgetClientOptions);
+    chat(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle;
+    sendSignal(input: SignalInput): Promise<void>;
+    conversation(context?: UserContext): Conversation;
+}
+
+declare const SIGNAL_TYPE_CODES: Record<SignalType, number>;
+declare const ENTITY_TYPE_CODES: Record<SignalEntityType, number>;
+
+export { type ActionButtonEventData, type ActionsLoadingEventData, type AnswerEventData, AuthError, type ChatCallbacks, type ChatEvent, type ChatHandle, type ChatInput, Conversation, ENTITY_TYPE_CODES, type EntityCard, type EntityCardEventData, type FetchLike, ForbiddenError, type IntentChipEventData, NetworkError, ParseError, type ProgressEventData, RateLimitError, SIGNAL_TYPE_CODES, type SignalEntityType, type SignalInput, type SignalType, StatsWidgetClient, type StatsWidgetClientOptions, type StreamErrorEventData, type TurnCompleteEventData, UpstreamError, type UserContext, WidgetSdkError };

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+declare class WidgetSdkError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    constructor(message: string, code: string, status?: number);
+}
+declare class AuthError extends WidgetSdkError {
+    constructor(message?: string);
+}
+declare class ForbiddenError extends WidgetSdkError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends WidgetSdkError {
+    readonly retryAfter?: number;
+    constructor(retryAfter?: number, message?: string);
+}
+declare class UpstreamError extends WidgetSdkError {
+    constructor(status: number, message?: string);
+}
+declare class NetworkError extends WidgetSdkError {
+    readonly cause?: unknown;
+    constructor(message?: string, cause?: unknown);
+}
+declare class ParseError extends WidgetSdkError {
+    readonly line?: string;
+    constructor(message?: string, line?: string);
+}
+
+interface ProgressEventData {
+    phase: string;
+    message: string;
+}
+interface AnswerEventData {
+    text: string;
+}
+interface EntityCard {
+    entityId: number;
+    entityType: string;
+    mentionText: string;
+    canonicalName: string;
+    [key: string]: unknown;
+}
+interface EntityCardEventData {
+    card: EntityCard;
+}
+interface ActionButtonEventData {
+    action: Record<string, unknown>;
+}
+interface IntentChipEventData {
+    intent: Record<string, unknown>;
+}
+interface ActionsLoadingEventData {
+    message: string;
+}
+interface TurnCompleteEventData {
+    conversationId: string;
+    agentId?: string;
+    routeDecision: string;
+    isAgentRouted: boolean;
+    totalLatencyMs: number;
+}
+interface StreamErrorEventData {
+    code: string;
+    message: string;
+    terminal: boolean;
+}
+interface EventEnvelope<TType extends string, TData> {
+    type: TType;
+    requestId: string;
+    timestamp: string;
+    data: TData;
+}
+type ChatEvent = EventEnvelope<'progress', ProgressEventData> | EventEnvelope<'answer', AnswerEventData> | EventEnvelope<'entity_card', EntityCardEventData> | EventEnvelope<'action_button', ActionButtonEventData> | EventEnvelope<'intent_chip', IntentChipEventData> | EventEnvelope<'actions_loading', ActionsLoadingEventData> | EventEnvelope<'turn_complete', TurnCompleteEventData> | EventEnvelope<'error', StreamErrorEventData>;
+
+type FetchLike = (input: string, init: RequestInit) => Promise<Response>;
+interface StatsWidgetClientOptions {
+    operatorId: string;
+    publicKey: string;
+    baseUrl?: string;
+    /** Advanced/testing: inject a fetch implementation. Defaults to globalThis.fetch. */
+    fetch?: FetchLike;
+}
+interface UserContext {
+    operatorUserId?: string;
+    defaultLanguage?: string;
+}
+interface ChatInput {
+    message: string;
+    conversationId?: string;
+    actionId?: string;
+    userContext?: UserContext;
+}
+type SignalType = 'MatchPageView' | 'PlayerPageView' | 'TeamPageView' | 'MarketView' | 'SearchQuery' | 'SessionDepth' | 'TimeOnPage' | 'InsightViewed' | 'InsightMarketClicked' | 'BetPlacedFromInsight' | 'InsightScrollDepth' | 'ToolCall' | 'EntityMention' | 'Handoff' | 'FollowUpQuery' | 'RecommendationDismissed';
+type SignalEntityType = 'Match' | 'Team' | 'Player' | 'Competition' | 'Market' | 'Article' | 'Session' | 'Query' | 'Conversation';
+interface SignalInput {
+    signalType: SignalType;
+    entityType: SignalEntityType;
+    entityName: string;
+    operatorUserId: string;
+}
+
+interface ResolvedConfig {
+    operatorId: string;
+    publicKey: string;
+    baseUrl: string;
+    fetch: FetchLike;
+}
+
+interface ChatCallbacks {
+    onProgress?(data: ProgressEventData): void;
+    onAnswer?(data: AnswerEventData): void;
+    onEntityCard?(data: EntityCardEventData): void;
+    onActionButton?(data: ActionButtonEventData): void;
+    onIntentChip?(data: IntentChipEventData): void;
+    onActionsLoading?(data: ActionsLoadingEventData): void;
+    onError?(error: StreamErrorEventData | WidgetSdkError): void;
+    onComplete?(data: TurnCompleteEventData): void;
+}
+interface ChatHandle extends AsyncIterable<ChatEvent>, PromiseLike<void> {
+    cancel(): void;
+}
+
+declare class Conversation {
+    private readonly cfg;
+    private readonly context?;
+    conversationId?: string;
+    constructor(cfg: ResolvedConfig, context?: UserContext | undefined);
+    send(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle;
+    sendSignal(input: Omit<SignalInput, 'operatorUserId'> & {
+        operatorUserId?: string;
+    }): Promise<void>;
+}
+
+declare class StatsWidgetClient {
+    private readonly cfg;
+    constructor(options: StatsWidgetClientOptions);
+    chat(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle;
+    sendSignal(input: SignalInput): Promise<void>;
+    conversation(context?: UserContext): Conversation;
+}
+
+declare const SIGNAL_TYPE_CODES: Record<SignalType, number>;
+declare const ENTITY_TYPE_CODES: Record<SignalEntityType, number>;
+
+export { type ActionButtonEventData, type ActionsLoadingEventData, type AnswerEventData, AuthError, type ChatCallbacks, type ChatEvent, type ChatHandle, type ChatInput, Conversation, ENTITY_TYPE_CODES, type EntityCard, type EntityCardEventData, type FetchLike, ForbiddenError, type IntentChipEventData, NetworkError, ParseError, type ProgressEventData, RateLimitError, SIGNAL_TYPE_CODES, type SignalEntityType, type SignalInput, type SignalType, StatsWidgetClient, type StatsWidgetClientOptions, type StreamErrorEventData, type TurnCompleteEventData, UpstreamError, type UserContext, WidgetSdkError };

package/dist/index.js

@@ -0,0 +1,316 @@
+// src/errors.ts
+var WidgetSdkError = class extends Error {
+  constructor(message, code, status) {
+    super(message);
+    this.name = new.target.name;
+    this.code = code;
+    this.status = status;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AuthError = class extends WidgetSdkError {
+  constructor(message = "Invalid or missing public key") {
+    super(message, "unauthorized", 401);
+  }
+};
+var ForbiddenError = class extends WidgetSdkError {
+  constructor(message = "Origin not allowed or widget disabled") {
+    super(message, "forbidden", 403);
+  }
+};
+var RateLimitError = class extends WidgetSdkError {
+  constructor(retryAfter, message = "Rate limited") {
+    super(message, "rate_limited", 429);
+    this.retryAfter = retryAfter;
+  }
+};
+var UpstreamError = class extends WidgetSdkError {
+  constructor(status, message = "Upstream error") {
+    super(message, "upstream_error", status);
+  }
+};
+var NetworkError = class extends WidgetSdkError {
+  constructor(message = "Network request failed", cause) {
+    super(message, "network_error");
+    this.cause = cause;
+  }
+};
+var ParseError = class extends WidgetSdkError {
+  constructor(message = "Malformed NDJSON line", line) {
+    super(message, "parse_error");
+    this.line = line;
+  }
+};
+
+// src/http.ts
+function endpoint(cfg, path) {
+  return `${cfg.baseUrl.replace(/\/+$/, "")}/v1/${encodeURIComponent(cfg.operatorId)}/${path}`;
+}
+function toWidgetError(status, retryAfterHeader) {
+  switch (status) {
+    case 401:
+      return new AuthError();
+    case 403:
+      return new ForbiddenError();
+    case 429: {
+      const n = retryAfterHeader != null ? Number(retryAfterHeader) : void 0;
+      return new RateLimitError(Number.isFinite(n) ? n : void 0);
+    }
+    default:
+      return new UpstreamError(status);
+  }
+}
+function isAbort(error) {
+  return error instanceof Error && error.name === "AbortError";
+}
+async function send(cfg, path, body, signal) {
+  try {
+    return await cfg.fetch(endpoint(cfg, path), {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-SS-Public-Key": cfg.publicKey },
+      body: JSON.stringify(body),
+      signal
+    });
+  } catch (error) {
+    if (isAbort(error)) throw error;
+    throw new NetworkError("Network request failed", error);
+  }
+}
+async function postChat(cfg, input, signal) {
+  const res = await send(cfg, "chat", input, signal);
+  if (!res.ok || res.body == null) throw toWidgetError(res.status, res.headers.get("Retry-After"));
+  return res;
+}
+async function postSignal(cfg, wireBody, signal) {
+  const res = await send(cfg, "signals", wireBody, signal);
+  if (!res.ok) throw toWidgetError(res.status, res.headers.get("Retry-After"));
+}
+
+// src/ndjson.ts
+function parseLine(line) {
+  const trimmed = line.trim();
+  if (trimmed === "") return void 0;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    throw new ParseError("Malformed NDJSON line", line);
+  }
+}
+function createNdjsonParser() {
+  let buffer = "";
+  return {
+    push(text) {
+      buffer += text;
+      const out = [];
+      let idx;
+      while ((idx = buffer.indexOf("\n")) >= 0) {
+        const line = buffer.slice(0, idx);
+        buffer = buffer.slice(idx + 1);
+        const parsed = parseLine(line);
+        if (parsed !== void 0) out.push(parsed);
+      }
+      return out;
+    },
+    flush() {
+      const rest = buffer;
+      buffer = "";
+      const parsed = parseLine(rest);
+      return parsed === void 0 ? [] : [parsed];
+    }
+  };
+}
+
+// src/chat.ts
+function dispatch(ev, cb) {
+  switch (ev.type) {
+    case "progress":
+      cb.onProgress?.(ev.data);
+      break;
+    case "answer":
+      cb.onAnswer?.(ev.data);
+      break;
+    case "entity_card":
+      cb.onEntityCard?.(ev.data);
+      break;
+    case "action_button":
+      cb.onActionButton?.(ev.data);
+      break;
+    case "intent_chip":
+      cb.onIntentChip?.(ev.data);
+      break;
+    case "actions_loading":
+      cb.onActionsLoading?.(ev.data);
+      break;
+    case "turn_complete":
+      cb.onComplete?.(ev.data);
+      break;
+    case "error":
+      cb.onError?.(ev.data);
+      break;
+  }
+}
+async function* streamEvents(cfg, input, signal) {
+  const res = await postChat(cfg, input, signal);
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  const parser = createNdjsonParser();
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      for (const obj of parser.push(decoder.decode(value, { stream: true }))) yield obj;
+    }
+    for (const obj of parser.flush()) yield obj;
+  } finally {
+    await reader.cancel().catch(() => {
+    });
+  }
+}
+function runChat(cfg, input, callbacks, opts) {
+  const controller = new AbortController();
+  const external = opts?.signal;
+  if (external) {
+    if (external.aborted) controller.abort();
+    else external.addEventListener("abort", () => controller.abort(), { once: true });
+  }
+  async function* source() {
+    for await (const ev of streamEvents(cfg, input, controller.signal)) {
+      opts?.tap?.(ev);
+      yield ev;
+    }
+  }
+  const iterator = source();
+  let consumed = false;
+  async function drive() {
+    try {
+      for await (const ev of iterator) {
+        if (callbacks) dispatch(ev, callbacks);
+      }
+    } catch (error) {
+      if (callbacks?.onError && error instanceof WidgetSdkError) {
+        callbacks.onError(error);
+        return;
+      }
+      throw error;
+    }
+  }
+  return {
+    [Symbol.asyncIterator]() {
+      if (consumed) throw new Error("chat stream already consumed");
+      consumed = true;
+      return iterator;
+    },
+    then(onfulfilled, onrejected) {
+      if (consumed) return Promise.resolve().then(onfulfilled, onrejected);
+      consumed = true;
+      return drive().then(onfulfilled, onrejected);
+    },
+    cancel() {
+      controller.abort();
+    }
+  };
+}
+
+// src/signals.ts
+var SIGNAL_TYPE_CODES = {
+  MatchPageView: 1,
+  PlayerPageView: 2,
+  TeamPageView: 3,
+  MarketView: 4,
+  SearchQuery: 5,
+  SessionDepth: 6,
+  TimeOnPage: 7,
+  InsightViewed: 8,
+  InsightMarketClicked: 9,
+  BetPlacedFromInsight: 10,
+  InsightScrollDepth: 11,
+  ToolCall: 12,
+  EntityMention: 13,
+  Handoff: 14,
+  FollowUpQuery: 15,
+  RecommendationDismissed: 16
+};
+var ENTITY_TYPE_CODES = {
+  Match: 1,
+  Team: 2,
+  Player: 3,
+  Competition: 4,
+  Market: 5,
+  Article: 6,
+  Session: 7,
+  Query: 8,
+  Conversation: 9
+};
+function toSignalWireBody(input) {
+  const signalType = SIGNAL_TYPE_CODES[input.signalType];
+  const entityType = ENTITY_TYPE_CODES[input.entityType];
+  if (signalType === void 0) throw new Error(`Unknown signalType: ${String(input.signalType)}`);
+  if (entityType === void 0) throw new Error(`Unknown entityType: ${String(input.entityType)}`);
+  return { signalType, entityType, entityName: input.entityName, operatorUserId: input.operatorUserId };
+}
+
+// src/conversation.ts
+var Conversation = class {
+  constructor(cfg, context) {
+    this.cfg = cfg;
+    this.context = context;
+  }
+  send(input, callbacks) {
+    const mergedContext = { ...this.context, ...input.userContext };
+    const full = {
+      ...input,
+      conversationId: input.conversationId ?? this.conversationId,
+      userContext: Object.keys(mergedContext).length > 0 ? mergedContext : void 0
+    };
+    return runChat(this.cfg, full, callbacks, {
+      tap: (ev) => {
+        if (ev.type === "turn_complete") this.conversationId = ev.data.conversationId;
+      }
+    });
+  }
+  sendSignal(input) {
+    const operatorUserId = input.operatorUserId ?? this.context?.operatorUserId;
+    if (!operatorUserId) throw new Error("operatorUserId is required (set it on conversation() or pass it to sendSignal)");
+    return postSignal(this.cfg, toSignalWireBody({ ...input, operatorUserId }));
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://widget.sensiblestats.com";
+var StatsWidgetClient = class {
+  constructor(options) {
+    if (!options.operatorId) throw new Error("operatorId is required");
+    if (!options.publicKey) throw new Error("publicKey is required");
+    const fetchImpl = options.fetch ?? (globalThis.fetch ? globalThis.fetch.bind(globalThis) : void 0);
+    if (!fetchImpl) throw new Error("No fetch implementation available; pass options.fetch");
+    this.cfg = {
+      operatorId: options.operatorId,
+      publicKey: options.publicKey,
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+      fetch: fetchImpl
+    };
+  }
+  chat(input, callbacks) {
+    return runChat(this.cfg, input, callbacks);
+  }
+  async sendSignal(input) {
+    await postSignal(this.cfg, toSignalWireBody(input));
+  }
+  conversation(context) {
+    return new Conversation(this.cfg, context);
+  }
+};
+export {
+  AuthError,
+  Conversation,
+  ENTITY_TYPE_CODES,
+  ForbiddenError,
+  NetworkError,
+  ParseError,
+  RateLimitError,
+  SIGNAL_TYPE_CODES,
+  StatsWidgetClient,
+  UpstreamError,
+  WidgetSdkError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/ndjson.ts","../src/chat.ts","../src/signals.ts","../src/conversation.ts","../src/client.ts"],"sourcesContent":["export class WidgetSdkError extends Error {\n  readonly code: string\n  readonly status?: number\n  constructor(message: string, code: string, status?: number) {\n    super(message)\n    this.name = new.target.name\n    this.code = code\n    this.status = status\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\nexport class AuthError extends WidgetSdkError {\n  constructor(message = 'Invalid or missing public key') { super(message, 'unauthorized', 401) }\n}\nexport class ForbiddenError extends WidgetSdkError {\n  constructor(message = 'Origin not allowed or widget disabled') { super(message, 'forbidden', 403) }\n}\nexport class RateLimitError extends WidgetSdkError {\n  readonly retryAfter?: number\n  constructor(retryAfter?: number, message = 'Rate limited') { super(message, 'rate_limited', 429); this.retryAfter = retryAfter }\n}\nexport class UpstreamError extends WidgetSdkError {\n  constructor(status: number, message = 'Upstream error') { super(message, 'upstream_error', status) }\n}\nexport class NetworkError extends WidgetSdkError {\n  readonly cause?: unknown\n  constructor(message = 'Network request failed', cause?: unknown) { super(message, 'network_error'); this.cause = cause }\n}\nexport class ParseError extends WidgetSdkError {\n  readonly line?: string\n  constructor(message = 'Malformed NDJSON line', line?: string) { super(message, 'parse_error'); this.line = line }\n}\n","import { AuthError, ForbiddenError, NetworkError, RateLimitError, UpstreamError, WidgetSdkError } from './errors'\nimport type { ChatInput, FetchLike } from './types'\n\nexport interface ResolvedConfig {\n  operatorId: string\n  publicKey: string\n  baseUrl: string\n  fetch: FetchLike\n}\n\nfunction endpoint(cfg: ResolvedConfig, path: string): string {\n  return `${cfg.baseUrl.replace(/\\/+$/, '')}/v1/${encodeURIComponent(cfg.operatorId)}/${path}`\n}\n\nexport function toWidgetError(status: number, retryAfterHeader: string | null): WidgetSdkError {\n  switch (status) {\n    case 401: return new AuthError()\n    case 403: return new ForbiddenError()\n    case 429: {\n      const n = retryAfterHeader != null ? Number(retryAfterHeader) : undefined\n      return new RateLimitError(Number.isFinite(n) ? (n as number) : undefined)\n    }\n    default: return new UpstreamError(status)\n  }\n}\n\nfunction isAbort(error: unknown): boolean {\n  return error instanceof Error && error.name === 'AbortError'\n}\n\nasync function send(cfg: ResolvedConfig, path: string, body: object, signal?: AbortSignal): Promise<Response> {\n  try {\n    return await cfg.fetch(endpoint(cfg, path), {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', 'X-SS-Public-Key': cfg.publicKey },\n      body: JSON.stringify(body),\n      signal,\n    })\n  } catch (error) {\n    if (isAbort(error)) throw error\n    throw new NetworkError('Network request failed', error)\n  }\n}\n\nexport async function postChat(cfg: ResolvedConfig, input: ChatInput, signal: AbortSignal): Promise<Response> {\n  const res = await send(cfg, 'chat', input, signal)\n  if (!res.ok || res.body == null) throw toWidgetError(res.status, res.headers.get('Retry-After'))\n  return res\n}\n\nexport async function postSignal(cfg: ResolvedConfig, wireBody: object, signal?: AbortSignal): Promise<void> {\n  const res = await send(cfg, 'signals', wireBody, signal)\n  if (!res.ok) throw toWidgetError(res.status, res.headers.get('Retry-After'))\n}\n","import { ParseError } from './errors'\n\nexport interface NdjsonParser {\n  push(text: string): unknown[]\n  flush(): unknown[]\n}\n\nfunction parseLine(line: string): unknown | undefined {\n  const trimmed = line.trim()\n  if (trimmed === '') return undefined\n  try {\n    return JSON.parse(trimmed)\n  } catch {\n    throw new ParseError('Malformed NDJSON line', line)\n  }\n}\n\nexport function createNdjsonParser(): NdjsonParser {\n  let buffer = ''\n  return {\n    push(text: string): unknown[] {\n      buffer += text\n      const out: unknown[] = []\n      let idx: number\n      while ((idx = buffer.indexOf('\\n')) >= 0) {\n        const line = buffer.slice(0, idx)\n        buffer = buffer.slice(idx + 1)\n        const parsed = parseLine(line)\n        if (parsed !== undefined) out.push(parsed)\n      }\n      return out\n    },\n    flush(): unknown[] {\n      const rest = buffer\n      buffer = ''\n      const parsed = parseLine(rest)\n      return parsed === undefined ? [] : [parsed]\n    },\n  }\n}\n","import { WidgetSdkError } from './errors'\nimport type {\n  ActionButtonEventData, ActionsLoadingEventData, AnswerEventData, ChatEvent,\n  EntityCardEventData, IntentChipEventData, ProgressEventData, StreamErrorEventData, TurnCompleteEventData,\n} from './events'\nimport { postChat, type ResolvedConfig } from './http'\nimport { createNdjsonParser } from './ndjson'\nimport type { ChatInput } from './types'\n\nexport interface ChatCallbacks {\n  onProgress?(data: ProgressEventData): void\n  onAnswer?(data: AnswerEventData): void\n  onEntityCard?(data: EntityCardEventData): void\n  onActionButton?(data: ActionButtonEventData): void\n  onIntentChip?(data: IntentChipEventData): void\n  onActionsLoading?(data: ActionsLoadingEventData): void\n  onError?(error: StreamErrorEventData | WidgetSdkError): void\n  onComplete?(data: TurnCompleteEventData): void\n}\n\nexport interface ChatHandle extends AsyncIterable<ChatEvent>, PromiseLike<void> {\n  cancel(): void\n}\n\nfunction dispatch(ev: ChatEvent, cb: ChatCallbacks): void {\n  switch (ev.type) {\n    case 'progress': cb.onProgress?.(ev.data); break\n    case 'answer': cb.onAnswer?.(ev.data); break\n    case 'entity_card': cb.onEntityCard?.(ev.data); break\n    case 'action_button': cb.onActionButton?.(ev.data); break\n    case 'intent_chip': cb.onIntentChip?.(ev.data); break\n    case 'actions_loading': cb.onActionsLoading?.(ev.data); break\n    case 'turn_complete': cb.onComplete?.(ev.data); break\n    case 'error': cb.onError?.(ev.data); break\n  }\n}\n\nasync function* streamEvents(cfg: ResolvedConfig, input: ChatInput, signal: AbortSignal): AsyncGenerator<ChatEvent> {\n  const res = await postChat(cfg, input, signal)\n  const reader = res.body!.getReader()\n  const decoder = new TextDecoder()\n  const parser = createNdjsonParser()\n  try {\n    for (;;) {\n      const { done, value } = await reader.read()\n      if (done) break\n      for (const obj of parser.push(decoder.decode(value, { stream: true }))) yield obj as ChatEvent\n    }\n    for (const obj of parser.flush()) yield obj as ChatEvent\n  } finally {\n    await reader.cancel().catch(() => {})\n  }\n}\n\nexport function runChat(\n  cfg: ResolvedConfig,\n  input: ChatInput,\n  callbacks?: ChatCallbacks,\n  opts?: { signal?: AbortSignal; tap?: (ev: ChatEvent) => void },\n): ChatHandle {\n  const controller = new AbortController()\n  const external = opts?.signal\n  if (external) {\n    if (external.aborted) controller.abort()\n    else external.addEventListener('abort', () => controller.abort(), { once: true })\n  }\n\n  async function* source(): AsyncGenerator<ChatEvent> {\n    for await (const ev of streamEvents(cfg, input, controller.signal)) {\n      opts?.tap?.(ev)\n      yield ev\n    }\n  }\n\n  const iterator = source()\n  let consumed = false\n\n  async function drive(): Promise<void> {\n    try {\n      for await (const ev of iterator) { if (callbacks) dispatch(ev, callbacks) }\n    } catch (error) {\n      if (callbacks?.onError && error instanceof WidgetSdkError) { callbacks.onError(error); return }\n      throw error\n    }\n  }\n\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<ChatEvent> {\n      if (consumed) throw new Error('chat stream already consumed')\n      consumed = true\n      return iterator\n    },\n    then<TResult1 = void, TResult2 = never>(\n      onfulfilled?: ((value: void) => TResult1 | PromiseLike<TResult1>) | null,\n      onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n    ): PromiseLike<TResult1 | TResult2> {\n      if (consumed) return Promise.resolve().then(onfulfilled, onrejected)\n      consumed = true\n      return drive().then(onfulfilled, onrejected)\n    },\n    cancel(): void { controller.abort() },\n  }\n}\n","import type { SignalEntityType, SignalInput, SignalType } from './types'\n\nexport const SIGNAL_TYPE_CODES: Record<SignalType, number> = {\n  MatchPageView: 1, PlayerPageView: 2, TeamPageView: 3, MarketView: 4,\n  SearchQuery: 5, SessionDepth: 6, TimeOnPage: 7, InsightViewed: 8,\n  InsightMarketClicked: 9, BetPlacedFromInsight: 10, InsightScrollDepth: 11,\n  ToolCall: 12, EntityMention: 13, Handoff: 14, FollowUpQuery: 15, RecommendationDismissed: 16,\n}\n\nexport const ENTITY_TYPE_CODES: Record<SignalEntityType, number> = {\n  Match: 1, Team: 2, Player: 3, Competition: 4, Market: 5,\n  Article: 6, Session: 7, Query: 8, Conversation: 9,\n}\n\nexport function toSignalWireBody(input: SignalInput): {\n  signalType: number; entityType: number; entityName: string; operatorUserId: string\n} {\n  const signalType = SIGNAL_TYPE_CODES[input.signalType]\n  const entityType = ENTITY_TYPE_CODES[input.entityType]\n  if (signalType === undefined) throw new Error(`Unknown signalType: ${String(input.signalType)}`)\n  if (entityType === undefined) throw new Error(`Unknown entityType: ${String(input.entityType)}`)\n  return { signalType, entityType, entityName: input.entityName, operatorUserId: input.operatorUserId }\n}\n","import { runChat, type ChatCallbacks, type ChatHandle } from './chat'\nimport { postSignal, type ResolvedConfig } from './http'\nimport { toSignalWireBody } from './signals'\nimport type { ChatInput, SignalInput, UserContext } from './types'\n\nexport class Conversation {\n  conversationId?: string\n\n  constructor(private readonly cfg: ResolvedConfig, private readonly context?: UserContext) {}\n\n  send(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle {\n    const mergedContext: UserContext = { ...this.context, ...input.userContext }\n    const full: ChatInput = {\n      ...input,\n      conversationId: input.conversationId ?? this.conversationId,\n      userContext: Object.keys(mergedContext).length > 0 ? mergedContext : undefined,\n    }\n    return runChat(this.cfg, full, callbacks, {\n      tap: (ev) => { if (ev.type === 'turn_complete') this.conversationId = ev.data.conversationId },\n    })\n  }\n\n  sendSignal(input: Omit<SignalInput, 'operatorUserId'> & { operatorUserId?: string }): Promise<void> {\n    const operatorUserId = input.operatorUserId ?? this.context?.operatorUserId\n    if (!operatorUserId) throw new Error('operatorUserId is required (set it on conversation() or pass it to sendSignal)')\n    return postSignal(this.cfg, toSignalWireBody({ ...input, operatorUserId }))\n  }\n}\n","import { runChat, type ChatCallbacks, type ChatHandle } from './chat'\nimport { Conversation } from './conversation'\nimport { postSignal, type ResolvedConfig } from './http'\nimport { toSignalWireBody } from './signals'\nimport type { ChatInput, SignalInput, StatsWidgetClientOptions, UserContext } from './types'\n\nconst DEFAULT_BASE_URL = 'https://widget.sensiblestats.com'\n\nexport class StatsWidgetClient {\n  private readonly cfg: ResolvedConfig\n\n  constructor(options: StatsWidgetClientOptions) {\n    if (!options.operatorId) throw new Error('operatorId is required')\n    if (!options.publicKey) throw new Error('publicKey is required')\n    const fetchImpl = options.fetch ?? (globalThis.fetch ? globalThis.fetch.bind(globalThis) : undefined)\n    if (!fetchImpl) throw new Error('No fetch implementation available; pass options.fetch')\n    this.cfg = {\n      operatorId: options.operatorId,\n      publicKey: options.publicKey,\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      fetch: fetchImpl,\n    }\n  }\n\n  chat(input: ChatInput, callbacks?: ChatCallbacks): ChatHandle {\n    return runChat(this.cfg, input, callbacks)\n  }\n\n  async sendSignal(input: SignalInput): Promise<void> {\n    await postSignal(this.cfg, toSignalWireBody(input))\n  }\n\n  conversation(context?: UserContext): Conversation {\n    return new Conversation(this.cfg, context)\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sensiblestats/widget-sdk",
+  "version": "0.1.0",
+  "description": "Headless browser SDK for the SensibleStats chat widget gateway.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cebirci/sensible-stats.git",
+    "directory": "SensibleStats.Widget/packages/widget-sdk"
+  },
+  "homepage": "https://widget.sensiblestats.com",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "yarn build"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}