@viceme-ai/sdk 0.2.0 → 0.4.0

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClG,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/testing.js

@@ -0,0 +1,76 @@
+import { a as s } from "./chunks/errors-B-Qv_azy.js";
+import { i as w, a as u, V as d } from "./chunks/client-Cbldd7F2.js";
+function g(e) {
+  const i = [], o = [...e.sessionFailures ?? []], a = e.latencyMs ?? 0;
+  return {
+    requests: i,
+    async request(t) {
+      if (t.signal?.aborted)
+        throw new DOMException("Aborted", "AbortError");
+      if (i.push(t), await new Promise((r, n) => {
+        const c = t.signal, l = setTimeout(() => r(), a);
+        c?.addEventListener(
+          "abort",
+          () => {
+            clearTimeout(l), n(new DOMException("Aborted", "AbortError"));
+          },
+          { once: !0 }
+        );
+      }), t.path === "/v1/public/work-sdk/sessions" && t.method === "POST") {
+        const r = o.shift();
+        if (r) {
+          if (r instanceof Error) throw r;
+          return {
+            status: r.status,
+            body: {
+              error: { code: r.code, message: r.message ?? "Simulated failure." }
+            }
+          };
+        }
+        return {
+          status: 201,
+          body: {
+            workKey: e.work.key,
+            capabilities: [...e.work.capabilities],
+            ...e.work.token !== void 0 ? { token: e.work.token } : {},
+            ...e.work.expiresAt !== void 0 ? { expiresAt: new Date(e.work.expiresAt).toISOString() } : {}
+          },
+          requestId: `test-${i.length}`
+        };
+      }
+      return {
+        status: 404,
+        body: { error: { code: "CONFIG_INVALID", message: `No fixture for ${t.path}.` } }
+      };
+    }
+  };
+}
+function m(e) {
+  if (!w(e.workKey))
+    throw s('Test client requires a valid workKey ("wrk_…").');
+  if (!u(e.region))
+    throw s('Test client requires region "cn" or "global".');
+  if (typeof e.transport?.request != "function")
+    throw s("Test client requires a transport with a request() method.");
+  return new d({
+    config: {
+      workKey: e.workKey,
+      region: e.region,
+      signal: e.signal
+    },
+    transport: e.transport,
+    presenter: e.presenter,
+    ...e.now !== void 0 ? { now: e.now } : {}
+  });
+}
+const y = {
+  key: "wrk_test",
+  capabilities: ["fixture"],
+  token: "test-session-token"
+};
+export {
+  y as FIXTURE_WORK,
+  g as createMemoryTransport,
+  m as createTestViceMe
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sources":["../src/testing/test-adapter.ts"],"sourcesContent":["/**\n * `@viceme-ai/sdk/testing` — explicit test adapter.\n *\n * Deterministic fixture helpers for SDK consumers and capability authors.\n * This code must never be imported from production core, loader, or capability\n * bundles; it is excluded from them at build time and only exported via the\n * `./testing` subpath.\n *\n * The test client runs the exact same config, lifecycle, error, and contract\n * validation as production `createViceMe()` — it is not a bypass mock.\n */\n\nimport { configInvalid } from '../core/errors.ts';\nimport { isValidWorkKey, isValidRegion } from '../core/config.ts';\nimport { ViceMeClientImpl } from '../core/client.ts';\nimport type { ViceMeClient } from '../core/client.ts';\nimport type { ViceMeRegion } from '../core/config.ts';\nimport type { AccessPresenter } from '../core/presentation.ts';\nimport type { Transport, TransportRequest, TransportResponse } from '../transport/transport.ts';\n\nexport interface MemoryTransportWorkFixture {\n  key: string;\n  capabilities: string[];\n  token?: string;\n  expiresAt?: number;\n}\n\nexport interface MemoryTransportOptions {\n  /** Work descriptor served for `POST /v1/public/work-sdk/sessions`. */\n  work: MemoryTransportWorkFixture;\n  /** Artificial response latency in milliseconds (default 0). */\n  latencyMs?: number;\n  /**\n   * Queue of failures thrown before the fixture response is served; each\n   * entry is consumed by one session request. Use for retry/timeout tests.\n   */\n  sessionFailures?: Array<Error | { status: number; code: string; message?: string }>;\n}\n\nexport interface MemoryTransport extends Transport {\n  /** Every request seen so far, for assertions. */\n  readonly requests: TransportRequest[];\n}\n\nexport function createMemoryTransport(options: MemoryTransportOptions): MemoryTransport {\n  const requests: TransportRequest[] = [];\n  const failures = [...(options.sessionFailures ?? [])];\n  const latencyMs = options.latencyMs ?? 0;\n\n  return {\n    requests,\n    async request(request: TransportRequest): Promise<TransportResponse> {\n      // A pre-aborted signal never counts as an issued request.\n      if (request.signal?.aborted) {\n        throw new DOMException('Aborted', 'AbortError');\n      }\n      requests.push(request);\n      await new Promise<void>((resolve, reject) => {\n        const signal = request.signal;\n        const timer = setTimeout(() => resolve(), latencyMs);\n        signal?.addEventListener(\n          'abort',\n          () => {\n            clearTimeout(timer);\n            reject(new DOMException('Aborted', 'AbortError'));\n          },\n          { once: true },\n        );\n      });\n      if (request.path === '/v1/public/work-sdk/sessions' && request.method === 'POST') {\n        const failure = failures.shift();\n        if (failure) {\n          if (failure instanceof Error) throw failure;\n          return {\n            status: failure.status,\n            body: {\n              error: { code: failure.code, message: failure.message ?? 'Simulated failure.' },\n            },\n          };\n        }\n        return {\n          status: 201,\n          body: {\n            workKey: options.work.key,\n            capabilities: [...options.work.capabilities],\n            ...(options.work.token !== undefined ? { token: options.work.token } : {}),\n            ...(options.work.expiresAt !== undefined\n              ? { expiresAt: new Date(options.work.expiresAt).toISOString() }\n              : {}),\n          },\n          requestId: `test-${requests.length}`,\n        };\n      }\n      return {\n        status: 404,\n        body: { error: { code: 'CONFIG_INVALID', message: `No fixture for ${request.path}.` } },\n      };\n    },\n  };\n}\n\nexport interface CreateTestViceMeOptions {\n  workKey: string;\n  region: ViceMeRegion;\n  /** Mock transport serving the fixture contract. */\n  transport: Transport;\n  signal?: AbortSignal;\n  presenter?: AccessPresenter;\n  /** Stable virtual clock for deterministic time-based assertions. */\n  now?: () => number;\n}\n\n/**\n * Create a client backed by an injected transport. Runs identical validation\n * and lifecycle logic to `createViceMe()`.\n */\nexport function createTestViceMe(options: CreateTestViceMeOptions): ViceMeClient {\n  if (!isValidWorkKey(options.workKey)) {\n    throw configInvalid('Test client requires a valid workKey (\"wrk_…\").');\n  }\n  if (!isValidRegion(options.region)) {\n    throw configInvalid('Test client requires region \"cn\" or \"global\".');\n  }\n  if (typeof options.transport?.request !== 'function') {\n    throw configInvalid('Test client requires a transport with a request() method.');\n  }\n  return new ViceMeClientImpl({\n    config: {\n      workKey: options.workKey,\n      region: options.region,\n      signal: options.signal,\n    },\n    transport: options.transport,\n    presenter: options.presenter,\n    ...(options.now !== undefined ? { now: options.now } : {}),\n  });\n}\n\n/** Standard fixture work used across repo tests and examples. */\nexport const FIXTURE_WORK: MemoryTransportWorkFixture = {\n  key: 'wrk_test',\n  capabilities: ['fixture'],\n  token: 'test-session-token',\n};\n"],"names":["createMemoryTransport","options","requests","failures","latencyMs","request","resolve","reject","signal","timer","failure","createTestViceMe","isValidWorkKey","configInvalid","isValidRegion","ViceMeClientImpl","FIXTURE_WORK"],"mappings":";;AA4CO,SAASA,EAAsBC,GAAkD;AACtF,QAAMC,IAA+B,CAAA,GAC/BC,IAAW,CAAC,GAAIF,EAAQ,mBAAmB,CAAA,CAAG,GAC9CG,IAAYH,EAAQ,aAAa;AAEvC,SAAO;AAAA,IACL,UAAAC;AAAA,IACA,MAAM,QAAQG,GAAuD;AAEnE,UAAIA,EAAQ,QAAQ;AAClB,cAAM,IAAI,aAAa,WAAW,YAAY;AAehD,UAbAH,EAAS,KAAKG,CAAO,GACrB,MAAM,IAAI,QAAc,CAACC,GAASC,MAAW;AAC3C,cAAMC,IAASH,EAAQ,QACjBI,IAAQ,WAAW,MAAMH,EAAA,GAAWF,CAAS;AACnD,QAAAI,GAAQ;AAAA,UACN;AAAA,UACA,MAAM;AACJ,yBAAaC,CAAK,GAClBF,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAAA,UAClD;AAAA,UACA,EAAE,MAAM,GAAA;AAAA,QAAK;AAAA,MAEjB,CAAC,GACGF,EAAQ,SAAS,kCAAkCA,EAAQ,WAAW,QAAQ;AAChF,cAAMK,IAAUP,EAAS,MAAA;AACzB,YAAIO,GAAS;AACX,cAAIA,aAAmB,MAAO,OAAMA;AACpC,iBAAO;AAAA,YACL,QAAQA,EAAQ;AAAA,YAChB,MAAM;AAAA,cACJ,OAAO,EAAE,MAAMA,EAAQ,MAAM,SAASA,EAAQ,WAAW,qBAAA;AAAA,YAAqB;AAAA,UAChF;AAAA,QAEJ;AACA,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,MAAM;AAAA,YACJ,SAAST,EAAQ,KAAK;AAAA,YACtB,cAAc,CAAC,GAAGA,EAAQ,KAAK,YAAY;AAAA,YAC3C,GAAIA,EAAQ,KAAK,UAAU,SAAY,EAAE,OAAOA,EAAQ,KAAK,MAAA,IAAU,CAAA;AAAA,YACvE,GAAIA,EAAQ,KAAK,cAAc,SAC3B,EAAE,WAAW,IAAI,KAAKA,EAAQ,KAAK,SAAS,EAAE,YAAA,EAAY,IAC1D,CAAA;AAAA,UAAC;AAAA,UAEP,WAAW,QAAQC,EAAS,MAAM;AAAA,QAAA;AAAA,MAEtC;AACA,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,SAAS,kBAAkBG,EAAQ,IAAI,IAAA,EAAI;AAAA,MAAE;AAAA,IAE1F;AAAA,EAAA;AAEJ;AAiBO,SAASM,EAAiBV,GAAgD;AAC/E,MAAI,CAACW,EAAeX,EAAQ,OAAO;AACjC,UAAMY,EAAc,iDAAiD;AAEvE,MAAI,CAACC,EAAcb,EAAQ,MAAM;AAC/B,UAAMY,EAAc,+CAA+C;AAErE,MAAI,OAAOZ,EAAQ,WAAW,WAAY;AACxC,UAAMY,EAAc,2DAA2D;AAEjF,SAAO,IAAIE,EAAiB;AAAA,IAC1B,QAAQ;AAAA,MACN,SAASd,EAAQ;AAAA,MACjB,QAAQA,EAAQ;AAAA,MAChB,QAAQA,EAAQ;AAAA,IAAA;AAAA,IAElB,WAAWA,EAAQ;AAAA,IACnB,WAAWA,EAAQ;AAAA,IACnB,GAAIA,EAAQ,QAAQ,SAAY,EAAE,KAAKA,EAAQ,QAAQ,CAAA;AAAA,EAAC,CACzD;AACH;AAGO,MAAMe,IAA2C;AAAA,EACtD,KAAK;AAAA,EACL,cAAc,CAAC,SAAS;AAAA,EACxB,OAAO;AACT;"}

package/dist/tip/index.d.ts

@@ -0,0 +1,22 @@
+import type { ViceMeClient } from '../core/client.ts';
+export interface TipMountOptions {
+    target: Element;
+    theme: 'light' | 'dark' | 'auto';
+    signal?: AbortSignal;
+}
+export interface TipMountHandle {
+    readonly capability: 'tip';
+    destroy(): void;
+}
+export interface TipWidgetCloseDetail {
+    workId: string;
+}
+export interface TipPaidDetail {
+    workId: string;
+    orderNo: string;
+    status: 'PAID';
+    amountCents: number;
+}
+/** Explicit ESM/npm entry point; the CDN loader calls the same mount function. */
+export declare function mountTip(client: ViceMeClient, options: TipMountOptions): Promise<TipMountHandle>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tip/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgChG"}

package/dist/tip/mount.d.ts

@@ -0,0 +1,5 @@
+import type { ViceMeClient } from '../core/client.ts';
+import type { CapabilityMountHandle, CapabilityMountOptions } from '../capability-mount.ts';
+export declare const FRAME_READY_TIMEOUT_MS = 8000;
+export declare function mount(client: ViceMeClient, options: CapabilityMountOptions): Promise<CapabilityMountHandle>;
+//# sourceMappingURL=mount.d.ts.map

package/dist/tip/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/tip/mount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAS5F,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAM5C,wBAAsB,KAAK,CACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAsLhC"}

package/dist/tip.js

@@ -0,0 +1,137 @@
+import { c as p, V as b, B as N } from "./chunks/errors-B-Qv_azy.js";
+const M = /* @__PURE__ */ new Map([
+  ["viceme:ready", /* @__PURE__ */ new Set(["clientKey", "workKey", "capabilities", "version"])],
+  ["viceme:capability-ready", /* @__PURE__ */ new Set(["clientKey", "instanceKey", "capability", "version"])],
+  [
+    "viceme:error",
+    /* @__PURE__ */ new Set(["clientKey", "instanceKey", "capability", "code", "retryable", "requestId"])
+  ],
+  ["viceme:destroyed", /* @__PURE__ */ new Set(["clientKey", "instanceKey", "capability"])],
+  ["viceme:widget-close", /* @__PURE__ */ new Set(["workId"])],
+  ["viceme:tip-paid", /* @__PURE__ */ new Set(["workId", "orderNo", "status", "amountCents"])]
+]);
+function D(i, t) {
+  const a = M.get(i), n = {};
+  for (const [s, o] of Object.entries(t))
+    a.has(s) && o !== void 0 && (n[s] = o);
+  return n;
+}
+function k(i, t, a) {
+  const n = new CustomEvent(t, {
+    detail: D(t, a),
+    bubbles: !0,
+    composed: !0,
+    cancelable: !1
+  });
+  i.dispatchEvent(n);
+}
+const R = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i, S = /^VT\d{14}[0-9a-f]{12}$/, C = 100, O = 2e4, K = 2048, P = 8e3;
+function x(i) {
+  return typeof i == "object" && i !== null;
+}
+async function U(i, t) {
+  if (t.signal?.aborted) throw p();
+  if (await i.ready(), t.signal?.aborted) throw p();
+  if (!i.hasCapability("tip"))
+    throw new b({
+      code: "CAPABILITY_DISABLED",
+      message: "Tip is not available in this SDK build.",
+      retryable: !1,
+      capability: "tip"
+    });
+  const a = t.target.ownerDocument, n = a.defaultView;
+  if (!n)
+    throw new b({
+      code: "CONFIG_INVALID",
+      message: "Tip requires a browser document.",
+      retryable: !1,
+      capability: "tip"
+    });
+  const s = N[i.region], o = t.theme === "auto" ? n.matchMedia("(prefers-color-scheme: dark)") : void 0;
+  let l = t.theme === "auto" ? o?.matches ? "dark" : "light" : t.theme, y = !1, m, u;
+  const c = a.createElement("div");
+  c.dataset.vicemeTip = "mounted", c.style.all = "initial", c.style.display = "block", c.style.width = "100%", c.style.maxWidth = "100%", c.style.contain = "layout style";
+  const L = c.attachShadow({ mode: "open" }), r = a.createElement("iframe"), h = new URL(`/widget/tip/${encodeURIComponent(i.workKey)}`, s);
+  h.searchParams.set("appearance", l), r.title = "ViceMe Tip", r.src = h.toString(), r.loading = "eager", r.referrerPolicy = "strict-origin", r.setAttribute(
+    "sandbox",
+    "allow-forms allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"
+  ), r.setAttribute("allow", "payment"), r.style.boxSizing = "border-box", r.style.display = "block", r.style.width = "100%", r.style.height = "0px", r.style.margin = "0", r.style.border = "0", r.style.background = "transparent", r.style.colorScheme = l, r.style.pointerEvents = "none", L.append(r);
+  let v, I;
+  const _ = new Promise((d, e) => {
+    v = d, I = e, m = n.setTimeout(() => {
+      e(
+        new b({
+          code: "INTERNAL_ERROR",
+          message: "Hosted Tip widget did not become ready in time.",
+          retryable: !0,
+          capability: "tip"
+        })
+      );
+    }, P);
+  }), E = (d) => {
+    if (d.origin !== s || d.source !== r.contentWindow) return;
+    const e = d.data;
+    if (!(!x(e) || typeof e.type != "string")) {
+      if (e.type === "viceme:widget-resize") {
+        if (typeof e.workId != "string" || !R.test(e.workId) || typeof e.height != "number" || !Number.isInteger(e.height) || e.height < 1 || e.height > K || u !== void 0 && e.workId !== u)
+          return;
+        r.style.height = `${e.height}px`, u === void 0 && (u = e.workId, r.style.pointerEvents = "auto", m !== void 0 && (n.clearTimeout(m), m = void 0), v?.());
+        return;
+      }
+      if (!(typeof e.workId != "string" || e.workId !== u)) {
+        if (e.type === "viceme:widget-close") {
+          k(t.target, "viceme:widget-close", { workId: e.workId });
+          return;
+        }
+        e.type === "viceme:tip-paid" && typeof e.orderNo == "string" && S.test(e.orderNo) && e.status === "PAID" && typeof e.amountCents == "number" && Number.isInteger(e.amountCents) && e.amountCents >= C && e.amountCents <= O && k(t.target, "viceme:tip-paid", {
+          workId: e.workId,
+          orderNo: e.orderNo,
+          status: "PAID",
+          amountCents: e.amountCents
+        });
+      }
+    }
+  }, g = (d) => {
+    l = d.matches ? "dark" : "light", r.style.colorScheme = l, r.contentWindow?.postMessage(
+      { type: "viceme:widget-appearance", appearance: l },
+      s
+    );
+  };
+  let w;
+  const T = () => {
+    I?.(p()), f();
+  }, f = () => {
+    y || (y = !0, m !== void 0 && n.clearTimeout(m), n.removeEventListener("message", E), w?.(), t.signal?.removeEventListener("abort", T), c.remove());
+  };
+  try {
+    if (n.addEventListener("message", E), o && (typeof o.addEventListener == "function" ? (o.addEventListener("change", g), w = () => o.removeEventListener("change", g)) : (o.addListener(g), w = () => o.removeListener(g))), t.signal?.addEventListener("abort", T, { once: !0 }), t.signal?.aborted) throw p();
+    t.target.appendChild(c), await _;
+  } catch (d) {
+    throw f(), d;
+  }
+  return { capability: "tip", destroy: f };
+}
+const A = /* @__PURE__ */ new WeakMap();
+function V(i, t) {
+  let a = A.get(i);
+  a || (a = /* @__PURE__ */ new WeakMap(), A.set(i, a));
+  const n = a.get(t.target);
+  if (n) return n;
+  const s = U(i, t).then((o) => {
+    let l = !1;
+    const y = {
+      capability: "tip",
+      destroy() {
+        l || (l = !0, t.signal?.removeEventListener("abort", y.destroy), a.get(t.target) === s && a.delete(t.target), o.destroy());
+      }
+    };
+    return t.signal?.addEventListener("abort", y.destroy, { once: !0 }), t.signal?.aborted && y.destroy(), y;
+  }).catch((o) => {
+    throw a.get(t.target) === s && a.delete(t.target), o;
+  });
+  return a.set(t.target, s), s;
+}
+export {
+  V as mountTip
+};
+//# sourceMappingURL=tip.js.map

package/dist/tip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tip.js","sources":["../src/browser-events.ts","../src/tip/mount.ts","../src/tip/index.ts"],"sourcesContent":["/** Stable, allowlisted `viceme:*` DOM events shared by hosted capabilities. */\n\nimport type { ViceMeErrorCode } from './core/errors.ts';\n\nexport interface VicemeReadyDetail {\n  clientKey: string;\n  workKey: string;\n  capabilities: string[];\n  version: string;\n}\n\nexport interface VicemeCapabilityReadyDetail {\n  clientKey: string;\n  instanceKey: string;\n  capability: string;\n  version: string;\n}\n\nexport interface VicemeErrorDetail {\n  clientKey?: string;\n  instanceKey?: string;\n  capability?: string;\n  code: ViceMeErrorCode;\n  retryable: boolean;\n  requestId?: string;\n}\n\nexport interface VicemeDestroyedDetail {\n  clientKey: string;\n  instanceKey: string;\n  capability: string;\n}\n\nexport interface VicemeWidgetCloseDetail {\n  workId: string;\n}\n\nexport interface VicemeTipPaidDetail {\n  workId: string;\n  orderNo: string;\n  status: 'PAID';\n  amountCents: number;\n}\n\nexport type VicemeEventType =\n  | 'viceme:ready'\n  | 'viceme:capability-ready'\n  | 'viceme:error'\n  | 'viceme:destroyed'\n  | 'viceme:widget-close'\n  | 'viceme:tip-paid';\n\nexport type VicemeEventDetailMap = {\n  'viceme:ready': VicemeReadyDetail;\n  'viceme:capability-ready': VicemeCapabilityReadyDetail;\n  'viceme:error': VicemeErrorDetail;\n  'viceme:destroyed': VicemeDestroyedDetail;\n  'viceme:widget-close': VicemeWidgetCloseDetail;\n  'viceme:tip-paid': VicemeTipPaidDetail;\n};\n\nconst ALLOWED_KEYS: ReadonlyMap<VicemeEventType, ReadonlySet<string>> = new Map([\n  ['viceme:ready', new Set(['clientKey', 'workKey', 'capabilities', 'version'])],\n  ['viceme:capability-ready', new Set(['clientKey', 'instanceKey', 'capability', 'version'])],\n  [\n    'viceme:error',\n    new Set(['clientKey', 'instanceKey', 'capability', 'code', 'retryable', 'requestId']),\n  ],\n  ['viceme:destroyed', new Set(['clientKey', 'instanceKey', 'capability'])],\n  ['viceme:widget-close', new Set(['workId'])],\n  ['viceme:tip-paid', new Set(['workId', 'orderNo', 'status', 'amountCents'])],\n]);\n\n/** Strip anything outside the documented allowlist before dispatch. */\nexport function sanitizeDetail(\n  type: VicemeEventType,\n  detail: VicemeEventDetailMap[VicemeEventType],\n): VicemeEventDetailMap[VicemeEventType] {\n  const allowed = ALLOWED_KEYS.get(type)!;\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(detail)) {\n    if (allowed.has(key) && value !== undefined) result[key] = value;\n  }\n  return result as unknown as VicemeEventDetailMap[VicemeEventType];\n}\n\nexport function dispatchViceMeEvent<K extends VicemeEventType>(\n  target: EventTarget,\n  type: K,\n  detail: VicemeEventDetailMap[K],\n): void {\n  const event = new CustomEvent(type, {\n    detail: sanitizeDetail(type, detail),\n    bubbles: true,\n    composed: true,\n    cancelable: false,\n  });\n  target.dispatchEvent(event);\n}\n","import type { ViceMeClient } from '../core/client.ts';\nimport { BUILD_WIDGET_ORIGINS } from '../core/build-endpoints.ts';\nimport { clientDestroyed, ViceMeError } from '../core/errors.ts';\nimport { dispatchViceMeEvent } from '../browser-events.ts';\nimport type { CapabilityMountHandle, CapabilityMountOptions } from '../capability-mount.ts';\n\ntype WidgetAppearance = 'light' | 'dark';\n\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\nconst TIP_ORDER_NO_PATTERN = /^VT\\d{14}[0-9a-f]{12}$/;\nconst TIP_AMOUNT_MIN = 100;\nconst TIP_AMOUNT_MAX = 20_000;\nconst WIDGET_HEIGHT_MAX = 2_048;\nexport const FRAME_READY_TIMEOUT_MS = 8_000;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nexport async function mount(\n  client: ViceMeClient,\n  options: CapabilityMountOptions,\n): Promise<CapabilityMountHandle> {\n  if (options.signal?.aborted) throw clientDestroyed();\n  await client.ready();\n  if (options.signal?.aborted) throw clientDestroyed();\n  if (!client.hasCapability('tip')) {\n    throw new ViceMeError({\n      code: 'CAPABILITY_DISABLED',\n      message: 'Tip is not available in this SDK build.',\n      retryable: false,\n      capability: 'tip',\n    });\n  }\n\n  const documentObject = options.target.ownerDocument;\n  const windowObject = documentObject.defaultView;\n  if (!windowObject) {\n    throw new ViceMeError({\n      code: 'CONFIG_INVALID',\n      message: 'Tip requires a browser document.',\n      retryable: false,\n      capability: 'tip',\n    });\n  }\n\n  const widgetOrigin = BUILD_WIDGET_ORIGINS[client.region];\n  const mediaQuery =\n    options.theme === 'auto' ? windowObject.matchMedia('(prefers-color-scheme: dark)') : undefined;\n  let appearance: WidgetAppearance =\n    options.theme === 'auto' ? (mediaQuery?.matches ? 'dark' : 'light') : options.theme;\n  let destroyed = false;\n  let readyTimer: number | undefined;\n  let boundWorkId: string | undefined;\n\n  const portal = documentObject.createElement('div');\n  portal.dataset.vicemeTip = 'mounted';\n  portal.style.all = 'initial';\n  portal.style.display = 'block';\n  portal.style.width = '100%';\n  portal.style.maxWidth = '100%';\n  portal.style.contain = 'layout style';\n\n  const shadow = portal.attachShadow({ mode: 'open' });\n  const frame = documentObject.createElement('iframe');\n  const frameUrl = new URL(`/widget/tip/${encodeURIComponent(client.workKey)}`, widgetOrigin);\n  frameUrl.searchParams.set('appearance', appearance);\n  frame.title = 'ViceMe Tip';\n  frame.src = frameUrl.toString();\n  frame.loading = 'eager';\n  frame.referrerPolicy = 'strict-origin';\n  frame.setAttribute(\n    'sandbox',\n    'allow-forms allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts',\n  );\n  frame.setAttribute('allow', 'payment');\n  frame.style.boxSizing = 'border-box';\n  frame.style.display = 'block';\n  frame.style.width = '100%';\n  frame.style.height = '0px';\n  frame.style.margin = '0';\n  frame.style.border = '0';\n  frame.style.background = 'transparent';\n  frame.style.colorScheme = appearance;\n  frame.style.pointerEvents = 'none';\n  shadow.append(frame);\n\n  let resolveReady: (() => void) | undefined;\n  let rejectReady: ((error: ViceMeError) => void) | undefined;\n  const readiness = new Promise<void>((resolve, reject) => {\n    resolveReady = resolve;\n    rejectReady = reject;\n    readyTimer = windowObject.setTimeout(() => {\n      reject(\n        new ViceMeError({\n          code: 'INTERNAL_ERROR',\n          message: 'Hosted Tip widget did not become ready in time.',\n          retryable: true,\n          capability: 'tip',\n        }),\n      );\n    }, FRAME_READY_TIMEOUT_MS);\n  });\n\n  const onMessage = (event: MessageEvent<unknown>): void => {\n    if (event.origin !== widgetOrigin || event.source !== frame.contentWindow) return;\n    const message = event.data;\n    if (!isRecord(message) || typeof message.type !== 'string') return;\n\n    if (message.type === 'viceme:widget-resize') {\n      if (\n        typeof message.workId !== 'string' ||\n        !UUID_PATTERN.test(message.workId) ||\n        typeof message.height !== 'number' ||\n        !Number.isInteger(message.height) ||\n        message.height < 1 ||\n        message.height > WIDGET_HEIGHT_MAX ||\n        (boundWorkId !== undefined && message.workId !== boundWorkId)\n      ) {\n        return;\n      }\n      frame.style.height = `${message.height}px`;\n      if (boundWorkId === undefined) {\n        boundWorkId = message.workId;\n        frame.style.pointerEvents = 'auto';\n        if (readyTimer !== undefined) {\n          windowObject.clearTimeout(readyTimer);\n          readyTimer = undefined;\n        }\n        resolveReady?.();\n      }\n      return;\n    }\n\n    if (typeof message.workId !== 'string' || message.workId !== boundWorkId) return;\n    if (message.type === 'viceme:widget-close') {\n      dispatchViceMeEvent(options.target, 'viceme:widget-close', { workId: message.workId });\n      return;\n    }\n    if (\n      message.type === 'viceme:tip-paid' &&\n      typeof message.orderNo === 'string' &&\n      TIP_ORDER_NO_PATTERN.test(message.orderNo) &&\n      message.status === 'PAID' &&\n      typeof message.amountCents === 'number' &&\n      Number.isInteger(message.amountCents) &&\n      message.amountCents >= TIP_AMOUNT_MIN &&\n      message.amountCents <= TIP_AMOUNT_MAX\n    ) {\n      dispatchViceMeEvent(options.target, 'viceme:tip-paid', {\n        workId: message.workId,\n        orderNo: message.orderNo,\n        status: 'PAID',\n        amountCents: message.amountCents,\n      });\n    }\n  };\n\n  const onAppearanceChange = (event: MediaQueryListEvent): void => {\n    appearance = event.matches ? 'dark' : 'light';\n    frame.style.colorScheme = appearance;\n    frame.contentWindow?.postMessage(\n      { type: 'viceme:widget-appearance', appearance },\n      widgetOrigin,\n    );\n  };\n\n  let removeAppearanceListener: (() => void) | undefined;\n  const onAbort = (): void => {\n    rejectReady?.(clientDestroyed());\n    cleanup();\n  };\n  const cleanup = (): void => {\n    if (destroyed) return;\n    destroyed = true;\n    if (readyTimer !== undefined) windowObject.clearTimeout(readyTimer);\n    windowObject.removeEventListener('message', onMessage);\n    removeAppearanceListener?.();\n    options.signal?.removeEventListener('abort', onAbort);\n    portal.remove();\n  };\n\n  try {\n    windowObject.addEventListener('message', onMessage);\n    if (mediaQuery) {\n      if (typeof mediaQuery.addEventListener === 'function') {\n        mediaQuery.addEventListener('change', onAppearanceChange);\n        removeAppearanceListener = () =>\n          mediaQuery.removeEventListener('change', onAppearanceChange);\n      } else {\n        mediaQuery.addListener(onAppearanceChange);\n        removeAppearanceListener = () => mediaQuery.removeListener(onAppearanceChange);\n      }\n    }\n    options.signal?.addEventListener('abort', onAbort, { once: true });\n    if (options.signal?.aborted) throw clientDestroyed();\n    options.target.appendChild(portal);\n    await readiness;\n  } catch (error) {\n    cleanup();\n    throw error;\n  }\n\n  return { capability: 'tip', destroy: cleanup };\n}\n","import type { ViceMeClient } from '../core/client.ts';\nimport { mount } from './mount.ts';\n\nexport interface TipMountOptions {\n  target: Element;\n  theme: 'light' | 'dark' | 'auto';\n  signal?: AbortSignal;\n}\n\nexport interface TipMountHandle {\n  readonly capability: 'tip';\n  destroy(): void;\n}\n\nexport interface TipWidgetCloseDetail {\n  workId: string;\n}\n\nexport interface TipPaidDetail {\n  workId: string;\n  orderNo: string;\n  status: 'PAID';\n  amountCents: number;\n}\n\nconst mounts = new WeakMap<ViceMeClient, WeakMap<Element, Promise<TipMountHandle>>>();\n\n/** Explicit ESM/npm entry point; the CDN loader calls the same mount function. */\nexport function mountTip(client: ViceMeClient, options: TipMountOptions): Promise<TipMountHandle> {\n  let byTarget = mounts.get(client);\n  if (!byTarget) {\n    byTarget = new WeakMap();\n    mounts.set(client, byTarget);\n  }\n  const existing = byTarget.get(options.target);\n  if (existing) return existing;\n\n  const pending: Promise<TipMountHandle> = mount(client, options)\n    .then((raw) => {\n      let destroyed = false;\n      const handle: TipMountHandle = {\n        capability: 'tip' as const,\n        destroy(): void {\n          if (destroyed) return;\n          destroyed = true;\n          options.signal?.removeEventListener('abort', handle.destroy);\n          if (byTarget.get(options.target) === pending) byTarget.delete(options.target);\n          raw.destroy();\n        },\n      };\n      options.signal?.addEventListener('abort', handle.destroy, { once: true });\n      if (options.signal?.aborted) handle.destroy();\n      return handle;\n    })\n    .catch((error: unknown) => {\n      if (byTarget.get(options.target) === pending) byTarget.delete(options.target);\n      throw error;\n    });\n  byTarget.set(options.target, pending);\n  return pending;\n}\n"],"names":["ALLOWED_KEYS","sanitizeDetail","type","detail","allowed","result","key","value","dispatchViceMeEvent","target","event","UUID_PATTERN","TIP_ORDER_NO_PATTERN","TIP_AMOUNT_MIN","TIP_AMOUNT_MAX","WIDGET_HEIGHT_MAX","FRAME_READY_TIMEOUT_MS","isRecord","mount","client","options","clientDestroyed","ViceMeError","documentObject","windowObject","widgetOrigin","BUILD_WIDGET_ORIGINS","mediaQuery","appearance","destroyed","readyTimer","boundWorkId","portal","shadow","frame","frameUrl","resolveReady","rejectReady","readiness","resolve","reject","onMessage","message","onAppearanceChange","removeAppearanceListener","onAbort","cleanup","error","mounts","mountTip","byTarget","existing","pending","raw","handle"],"mappings":"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"}

package/dist/transport/transport.d.ts

@@ -0,0 +1,46 @@
+/**
+ * HTTP transport for the public API.
+ *
+ * Responsibilities: request execution with timeout, abort, client request ids,
+ * and normalization of every failure into the public `ViceMeError` model.
+ * Capabilities and the loader never build their own `fetch` calls — they go
+ * through a Transport so tests can swap in `createMemoryTransport`.
+ */
+export interface TransportRequest {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Absolute path under the public API base. */
+    path: string;
+    /** JSON-serializable request body. */
+    body?: unknown;
+    /** Work-session token. It is never persisted by the transport. */
+    authorization?: string;
+    /** Optional memory-only signed-in widget token. */
+    userAuthorization?: string;
+    signal?: AbortSignal;
+    /** Per-request timeout; defaults to the transport default. */
+    timeoutMs?: number;
+}
+export interface TransportResponse {
+    status: number;
+    body?: unknown;
+    /** Echoed server request id, when provided. */
+    requestId?: string;
+}
+export interface Transport {
+    request(request: TransportRequest): Promise<TransportResponse>;
+}
+export interface FetchTransportOptions {
+    apiBaseUrl: string;
+    /** Injectable for tests; defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+    defaultTimeoutMs?: number;
+    /** Injectable id generator (default: `crypto.randomUUID`). */
+    generateRequestId?: () => string;
+}
+export declare class FetchTransport implements Transport {
+    #private;
+    constructor(options: FetchTransportOptions);
+    request(request: TransportRequest): Promise<TransportResponse>;
+}
+export declare function createFetchTransport(options: FetchTransportOptions): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;CAClC;AAqED,qBAAa,cAAe,YAAW,SAAS;;gBAMlC,OAAO,EAAE,qBAAqB;IAOpC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA0GrE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAE9E"}

package/dist/version.d.ts

@@ -4,7 +4,7 @@
  * Kept in sync with `packages/sdk/package.json#version`; a unit test enforces
  * the match so the loader, release manifest, and npm metadata can never drift.
  */
-export declare const SDK_VERSION = "0.2.0";
+export declare const SDK_VERSION = "0.4.0";
 /** Public API major carried by this build (loader namespace `v1`). */
 export declare const API_MAJOR = 1;
 //# sourceMappingURL=version.d.ts.map