@tipsy-studio/sdk 0.0.2 → 0.0.4

package/dist/index.cjs

@@ -1,4 +1,328 @@
 'use strict';
 
+// src/bridge.ts
+var TIPSY_BRIDGE_PROTOCOL = "tipsy-bridge-v1";
+var TIPSY_INIT_RETRY_MS = 500;
+var RESPOND_METHOD = "sdk.respond";
+var TipsyBridgeClientError = class extends Error {
+  constructor(error) {
+    super(error.message);
+    this.name = "TipsyBridgeClientError";
+    this.code = error.code;
+  }
+};
+function getParentOriginFromReferrer() {
+  if (typeof document === "undefined" || !document.referrer) {
+    return null;
+  }
+  try {
+    return new URL(document.referrer).origin;
+  } catch {
+    return null;
+  }
+}
+function normalizeTargetOrigin(value) {
+  if (value && value.trim()) {
+    return value;
+  }
+  return getParentOriginFromReferrer() ?? "*";
+}
+function isBridgeMessage(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const candidate = value;
+  if (candidate.protocol !== TIPSY_BRIDGE_PROTOCOL) {
+    return false;
+  }
+  const validTypes = /* @__PURE__ */ new Set([
+    "tipsy:init",
+    "tipsy:init:ack",
+    "tipsy:request",
+    "tipsy:stream",
+    "tipsy:response",
+    "tipsy:error",
+    "tipsy:abort"
+  ]);
+  return typeof candidate.type === "string" && validTypes.has(candidate.type);
+}
+function createRequestId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `tipsy_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+
+// src/client.ts
+var TIPSY_READY_WAIT_RETRY_COUNT = 6;
+function createTipsyStudioClient(options = {}) {
+  const sourceWindow = options.sourceWindow ?? (typeof window !== "undefined" ? window : void 0);
+  const targetWindow = options.targetWindow ?? (sourceWindow && sourceWindow.parent !== sourceWindow ? sourceWindow.parent : void 0);
+  const targetOrigin = normalizeTargetOrigin(options.targetOrigin);
+  const pendingRequests = /* @__PURE__ */ new Map();
+  const readyWaiters = /* @__PURE__ */ new Set();
+  const listeners = /* @__PURE__ */ new Set();
+  let isDestroyed = false;
+  let isConnected = false;
+  let isReady = false;
+  let initIntervalId = null;
+  const emitReadyChange = (nextReady) => {
+    if (isReady === nextReady) {
+      return;
+    }
+    isReady = nextReady;
+    for (const listener of listeners) {
+      listener(isReady);
+    }
+  };
+  const resolveReadyWaiters = () => {
+    const waiters = Array.from(readyWaiters.values());
+    readyWaiters.clear();
+    for (const resolve of waiters) {
+      resolve();
+    }
+  };
+  const rejectPending = (error) => {
+    const requests = Array.from(pendingRequests.values());
+    pendingRequests.clear();
+    for (const pending of requests) {
+      pending.cleanupAbortListener?.();
+      pending.reject(new TipsyBridgeClientError(error));
+    }
+  };
+  const postMessageToTarget = (message) => {
+    targetWindow?.postMessage(message, targetOrigin);
+  };
+  const postInit = () => {
+    if (isDestroyed || isReady || !targetWindow) {
+      return;
+    }
+    postMessageToTarget({
+      protocol: TIPSY_BRIDGE_PROTOCOL,
+      type: "tipsy:init"
+    });
+  };
+  const handleMessage = (event) => {
+    if (isDestroyed || event.source !== targetWindow) {
+      return;
+    }
+    if (targetOrigin !== "*" && event.origin !== targetOrigin) {
+      return;
+    }
+    if (!isBridgeMessage(event.data)) {
+      return;
+    }
+    if (event.data.type === "tipsy:init:ack") {
+      emitReadyChange(true);
+      resolveReadyWaiters();
+      return;
+    }
+    if (event.data.type === "tipsy:error") {
+      if (!event.data.requestId) {
+        return;
+      }
+      const pending = pendingRequests.get(event.data.requestId);
+      if (!pending) {
+        return;
+      }
+      pendingRequests.delete(event.data.requestId);
+      pending.cleanupAbortListener?.();
+      pending.reject(new TipsyBridgeClientError(event.data.error));
+      return;
+    }
+    if (event.data.type === "tipsy:stream") {
+      const pending = pendingRequests.get(event.data.requestId);
+      if (!pending || pending.method !== event.data.payload.method) {
+        return;
+      }
+      pending.onEvent?.(event.data.payload.event);
+      return;
+    }
+    if (event.data.type === "tipsy:response") {
+      const pending = pendingRequests.get(event.data.requestId);
+      if (!pending || pending.method !== event.data.payload.method) {
+        return;
+      }
+      pendingRequests.delete(event.data.requestId);
+      pending.cleanupAbortListener?.();
+      pending.resolve(event.data.payload.result);
+    }
+  };
+  const ensureConnected = () => {
+    if (isDestroyed || isConnected || !sourceWindow) {
+      return;
+    }
+    sourceWindow.addEventListener("message", handleMessage);
+    initIntervalId = sourceWindow.setInterval(postInit, TIPSY_INIT_RETRY_MS);
+    isConnected = true;
+    postInit();
+  };
+  const ensureBridgeAvailable = () => {
+    if (!sourceWindow || !targetWindow) {
+      throw new TipsyBridgeClientError({
+        code: "NETWORK_ERROR",
+        message: "Tipsy bridge is only available inside an iframe."
+      });
+    }
+  };
+  const waitForReady = async (signal) => {
+    if (isDestroyed) {
+      throw new TipsyBridgeClientError({
+        code: "NETWORK_ERROR",
+        message: "Tipsy bridge was disconnected."
+      });
+    }
+    ensureBridgeAvailable();
+    ensureConnected();
+    const activeSourceWindow = sourceWindow;
+    if (!activeSourceWindow) {
+      throw new TipsyBridgeClientError({
+        code: "NETWORK_ERROR",
+        message: "Tipsy bridge is only available inside an iframe."
+      });
+    }
+    if (isReady) {
+      return;
+    }
+    for (let attempt = 0; attempt < TIPSY_READY_WAIT_RETRY_COUNT; attempt += 1) {
+      if (signal?.aborted) {
+        throw new DOMException("The operation was aborted.", "AbortError");
+      }
+      postInit();
+      await new Promise((resolve, reject) => {
+        let timeoutId = 0;
+        const handleReady = () => {
+          activeSourceWindow.clearTimeout(timeoutId);
+          signal?.removeEventListener("abort", handleAbort);
+          readyWaiters.delete(handleReady);
+          resolve();
+        };
+        const handleAbort = () => {
+          activeSourceWindow.clearTimeout(timeoutId);
+          readyWaiters.delete(handleReady);
+          signal?.removeEventListener("abort", handleAbort);
+          reject(new DOMException("The operation was aborted.", "AbortError"));
+        };
+        readyWaiters.add(handleReady);
+        timeoutId = activeSourceWindow.setTimeout(() => {
+          readyWaiters.delete(handleReady);
+          signal?.removeEventListener("abort", handleAbort);
+          resolve();
+        }, TIPSY_INIT_RETRY_MS);
+        signal?.addEventListener("abort", handleAbort, { once: true });
+      });
+      if (isReady) {
+        return;
+      }
+    }
+    throw new TipsyBridgeClientError({
+      code: "NETWORK_ERROR",
+      message: "Tipsy bridge is not ready."
+    });
+  };
+  function respond(request, controller) {
+    return client.call(RESPOND_METHOD, request, {
+      signal: controller?.signal,
+      onEvent: controller?.onEvent
+    });
+  }
+  const client = {
+    isReady: () => isReady,
+    subscribe(listener) {
+      listeners.add(listener);
+      listener(isReady);
+      ensureConnected();
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    async waitForReady(signal) {
+      await waitForReady(signal);
+    },
+    async call(method, params, controller) {
+      if (isDestroyed) {
+        throw new TipsyBridgeClientError({
+          code: "NETWORK_ERROR",
+          message: "Tipsy bridge was disconnected."
+        });
+      }
+      await waitForReady(controller?.signal);
+      const requestId = createRequestId();
+      return await new Promise(
+        (resolve, reject) => {
+          const pending = {
+            method,
+            resolve: (value) => resolve(value),
+            reject,
+            onEvent: controller?.onEvent
+          };
+          pendingRequests.set(requestId, pending);
+          const abortSignal = controller?.signal;
+          const handleAbort = () => {
+            if (!pendingRequests.has(requestId)) {
+              return;
+            }
+            pendingRequests.delete(requestId);
+            pending.cleanupAbortListener?.();
+            postMessageToTarget({
+              protocol: TIPSY_BRIDGE_PROTOCOL,
+              type: "tipsy:abort",
+              requestId
+            });
+            reject(new DOMException("The operation was aborted.", "AbortError"));
+          };
+          pending.cleanupAbortListener = () => {
+            abortSignal?.removeEventListener("abort", handleAbort);
+          };
+          if (abortSignal?.aborted) {
+            handleAbort();
+            return;
+          }
+          abortSignal?.addEventListener("abort", handleAbort, { once: true });
+          postMessageToTarget({
+            protocol: TIPSY_BRIDGE_PROTOCOL,
+            type: "tipsy:request",
+            requestId,
+            method,
+            params
+          });
+        }
+      );
+    },
+    respond,
+    destroy() {
+      if (isDestroyed) {
+        return;
+      }
+      isDestroyed = true;
+      resolveReadyWaiters();
+      emitReadyChange(false);
+      listeners.clear();
+      if (isConnected && sourceWindow) {
+        if (initIntervalId !== null) {
+          sourceWindow.clearInterval(initIntervalId);
+        }
+        sourceWindow.removeEventListener("message", handleMessage);
+      }
+      initIntervalId = null;
+      isConnected = false;
+      rejectPending({
+        code: "NETWORK_ERROR",
+        message: "Tipsy bridge was disconnected."
+      });
+    }
+  };
+  return client;
+}
+
+exports.RESPOND_METHOD = RESPOND_METHOD;
+exports.TIPSY_BRIDGE_PROTOCOL = TIPSY_BRIDGE_PROTOCOL;
+exports.TIPSY_INIT_RETRY_MS = TIPSY_INIT_RETRY_MS;
+exports.TipsyBridgeClientError = TipsyBridgeClientError;
+exports.createRequestId = createRequestId;
+exports.createTipsyStudioClient = createTipsyStudioClient;
+exports.getParentOriginFromReferrer = getParentOriginFromReferrer;
+exports.isBridgeMessage = isBridgeMessage;
+exports.normalizeTargetOrigin = normalizeTargetOrigin;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../src/bridge.ts","../src/client.ts"],"names":[],"mappings":";;;AAAO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,mBAAA,GAAsB;AAC5B,IAAM,cAAA,GAAiB;AA0MvB,IAAM,sBAAA,GAAN,cAAqC,KAAA,CAAM;AAAA,EAGhD,YAAY,KAAA,EAAyB;AACnC,IAAA,KAAA,CAAM,MAAM,OAAO,CAAA;AACnB,IAAA,IAAA,CAAK,IAAA,GAAO,wBAAA;AACZ,IAAA,IAAA,CAAK,OAAO,KAAA,CAAM,IAAA;AAAA,EACpB;AACF;AAEO,SAAS,2BAAA,GAA6C;AAC3D,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,CAAC,SAAS,QAAA,EAAU;AACzD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,GAAA,CAAI,QAAA,CAAS,QAAQ,CAAA,CAAE,MAAA;AAAA,EACpC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEO,SAAS,sBAAsB,KAAA,EAAwB;AAC5D,EAAA,IAAI,KAAA,IAAS,KAAA,CAAM,IAAA,EAAK,EAAG;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,OAAO,6BAA4B,IAAK,GAAA;AAC1C;AAEO,SAAS,gBAAgB,KAAA,EAA6C;AAC3E,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,EAAU;AACvC,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAA,GAAY,KAAA;AAClB,EAAA,IAAI,SAAA,CAAU,aAAa,qBAAA,EAAuB;AAChD,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,UAAA,uBAAiB,GAAA,CAA4B;AAAA,IACjD,YAAA;AAAA,IACA,gBAAA;AAAA,IACA,eAAA;AAAA,IACA,cAAA;AAAA,IACA,gBAAA;AAAA,IACA,aAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,OAAO,OAAO,SAAA,CAAU,IAAA,KAAS,YAAY,UAAA,CAAW,GAAA,CAAI,UAAU,IAAI,CAAA;AAC5E;AAEO,SAAS,eAAA,GAAkB;AAChC,EAAA,IACE,OAAO,MAAA,KAAW,WAAA,IAClB,OAAO,MAAA,CAAO,eAAe,UAAA,EAC7B;AACA,IAAA,OAAO,OAAO,UAAA,EAAW;AAAA,EAC3B;AAEA,EAAA,OAAO,CAAA,MAAA,EAAS,IAAA,CAAK,GAAA,EAAK,IAAI,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAC,CAAA,CAAA;AACvE;;;AClPA,IAAM,4BAAA,GAA+B,CAAA;AAwC9B,SAAS,uBAAA,CACd,OAAA,GAAoC,EAAC,EAClB;AACnB,EAAA,MAAM,eACJ,OAAA,CAAQ,YAAA,KAAiB,OAAO,MAAA,KAAW,cAAc,MAAA,GAAS,MAAA,CAAA;AACpE,EAAA,MAAM,YAAA,GACJ,QAAQ,YAAA,KACP,YAAA,IAAgB,aAAa,MAAA,KAAW,YAAA,GACrC,aAAa,MAAA,GACb,MAAA,CAAA;AACN,EAAA,MAAM,YAAA,GAAe,qBAAA,CAAsB,OAAA,CAAQ,YAAY,CAAA;AAE/D,EAAA,MAAM,eAAA,uBAAsB,GAAA,EAA4B;AACxD,EAAA,MAAM,YAAA,uBAAmB,GAAA,EAAgB;AACzC,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAgC;AAEtD,EAAA,IAAI,WAAA,GAAc,KAAA;AAClB,EAAA,IAAI,WAAA,GAAc,KAAA;AAClB,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,IAAI,cAAA,GAAgC,IAAA;AAEpC,EAAA,MAAM,eAAA,GAAkB,CAAC,SAAA,KAAuB;AAC9C,IAAA,IAAI,YAAY,SAAA,EAAW;AACzB,MAAA;AAAA,IACF;AAEA,IAAA,OAAA,GAAU,SAAA;AACV,IAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,MAAA,QAAA,CAAS,OAAO,CAAA;AAAA,IAClB;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,sBAAsB,MAAM;AAChC,IAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAA,CAAK,YAAA,CAAa,QAAQ,CAAA;AAChD,IAAA,YAAA,CAAa,KAAA,EAAM;AACnB,IAAA,KAAA,MAAW,WAAW,OAAA,EAAS;AAC7B,MAAA,OAAA,EAAQ;AAAA,IACV;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAA4B;AACjD,IAAA,MAAM,QAAA,GAAW,KAAA,CAAM,IAAA,CAAK,eAAA,CAAgB,QAAQ,CAAA;AACpD,IAAA,eAAA,CAAgB,KAAA,EAAM;AACtB,IAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,MAAA,OAAA,CAAQ,oBAAA,IAAuB;AAC/B,MAAA,OAAA,CAAQ,MAAA,CAAO,IAAI,sBAAA,CAAuB,KAAK,CAAC,CAAA;AAAA,IAClD;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,mBAAA,GAAsB,CAC1B,OAAA,KAIG;AACH,IAAA,YAAA,EAAc,WAAA,CAAY,SAAS,YAAY,CAAA;AAAA,EACjD,CAAA;AAEA,EAAA,MAAM,WAAW,MAAM;AACrB,IAAA,IAAI,WAAA,IAAe,OAAA,IAAW,CAAC,YAAA,EAAc;AAC3C,MAAA;AAAA,IACF;AAEA,IAAA,mBAAA,CAAoB;AAAA,MAClB,QAAA,EAAU,qBAAA;AAAA,MACV,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAAwB;AAC7C,IAAA,IAAI,WAAA,IAAe,KAAA,CAAM,MAAA,KAAW,YAAA,EAAc;AAChD,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,YAAA,KAAiB,GAAA,IAAO,KAAA,CAAM,MAAA,KAAW,YAAA,EAAc;AACzD,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,eAAA,CAAgB,KAAA,CAAM,IAAI,CAAA,EAAG;AAChC,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,gBAAA,EAAkB;AACxC,MAAA,eAAA,CAAgB,IAAI,CAAA;AACpB,MAAA,mBAAA,EAAoB;AACpB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,aAAA,EAAe;AACrC,MAAA,IAAI,CAAC,KAAA,CAAM,IAAA,CAAK,SAAA,EAAW;AACzB,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,GAAA,CAAI,KAAA,CAAM,KAAK,SAAS,CAAA;AACxD,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA;AAAA,MACF;AAEA,MAAA,eAAA,CAAgB,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA;AAC3C,MAAA,OAAA,CAAQ,oBAAA,IAAuB;AAC/B,MAAA,OAAA,CAAQ,OAAO,IAAI,sBAAA,CAAuB,KAAA,CAAM,IAAA,CAAK,KAAK,CAAC,CAAA;AAC3D,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,cAAA,EAAgB;AACtC,MAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,GAAA,CAAI,KAAA,CAAM,KAAK,SAAS,CAAA;AACxD,MAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,WAAW,KAAA,CAAM,IAAA,CAAK,QAAQ,MAAA,EAAQ;AAC5D,QAAA;AAAA,MACF;AAEA,MAAA,OAAA,CAAQ,OAAA,GAAU,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA;AAC1C,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,gBAAA,EAAkB;AACxC,MAAA,MAAM,OAAA,GAAU,eAAA,CAAgB,GAAA,CAAI,KAAA,CAAM,KAAK,SAAS,CAAA;AACxD,MAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,WAAW,KAAA,CAAM,IAAA,CAAK,QAAQ,MAAA,EAAQ;AAC5D,QAAA;AAAA,MACF;AAEA,MAAA,eAAA,CAAgB,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA;AAC3C,MAAA,OAAA,CAAQ,oBAAA,IAAuB;AAC/B,MAAA,OAAA,CAAQ,OAAA,CAAQ,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA;AAAA,IAC3C;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,kBAAkB,MAAM;AAC5B,IAAA,IAAI,WAAA,IAAe,WAAA,IAAe,CAAC,YAAA,EAAc;AAC/C,MAAA;AAAA,IACF;AAEA,IAAA,YAAA,CAAa,gBAAA,CAAiB,WAAW,aAAa,CAAA;AACtD,IAAA,cAAA,GAAiB,YAAA,CAAa,WAAA,CAAY,QAAA,EAAU,mBAAmB,CAAA;AACvE,IAAA,WAAA,GAAc,IAAA;AACd,IAAA,QAAA,EAAS;AAAA,EACX,CAAA;AAEA,EAAA,MAAM,wBAAwB,MAAM;AAClC,IAAA,IAAI,CAAC,YAAA,IAAgB,CAAC,YAAA,EAAc;AAClC,MAAA,MAAM,IAAI,sBAAA,CAAuB;AAAA,QAC/B,IAAA,EAAM,eAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,YAAA,GAAe,OAAO,MAAA,KAAyB;AACnD,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,MAAM,IAAI,sBAAA,CAAuB;AAAA,QAC/B,IAAA,EAAM,eAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AAEA,IAAA,qBAAA,EAAsB;AACtB,IAAA,eAAA,EAAgB;AAChB,IAAA,MAAM,kBAAA,GAAqB,YAAA;AAE3B,IAAA,IAAI,CAAC,kBAAA,EAAoB;AACvB,MAAA,MAAM,IAAI,sBAAA,CAAuB;AAAA,QAC/B,IAAA,EAAM,eAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,OAAA,EAAS;AACX,MAAA;AAAA,IACF;AAEA,IAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,GAAU,4BAAA,EAA8B,WAAW,CAAA,EAAG;AAC1E,MAAA,IAAI,QAAQ,OAAA,EAAS;AACnB,QAAA,MAAM,IAAI,YAAA,CAAa,4BAAA,EAA8B,YAAY,CAAA;AAAA,MACnE;AAEA,MAAA,QAAA,EAAS;AAET,MAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC3C,QAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,QAAA,MAAM,cAAc,MAAM;AACxB,UAAA,kBAAA,CAAmB,aAAa,SAAS,CAAA;AACzC,UAAA,MAAA,EAAQ,mBAAA,CAAoB,SAAS,WAAW,CAAA;AAChD,UAAA,YAAA,CAAa,OAAO,WAAW,CAAA;AAC/B,UAAA,OAAA,EAAQ;AAAA,QACV,CAAA;AAEA,QAAA,MAAM,cAAc,MAAM;AACxB,UAAA,kBAAA,CAAmB,aAAa,SAAS,CAAA;AACzC,UAAA,YAAA,CAAa,OAAO,WAAW,CAAA;AAC/B,UAAA,MAAA,EAAQ,mBAAA,CAAoB,SAAS,WAAW,CAAA;AAChD,UAAA,MAAA,CAAO,IAAI,YAAA,CAAa,4BAAA,EAA8B,YAAY,CAAC,CAAA;AAAA,QACrE,CAAA;AAEA,QAAA,YAAA,CAAa,IAAI,WAAW,CAAA;AAC5B,QAAA,SAAA,GAAY,kBAAA,CAAmB,WAAW,MAAM;AAC9C,UAAA,YAAA,CAAa,OAAO,WAAW,CAAA;AAC/B,UAAA,MAAA,EAAQ,mBAAA,CAAoB,SAAS,WAAW,CAAA;AAChD,UAAA,OAAA,EAAQ;AAAA,QACV,GAAG,mBAAmB,CAAA;AAEtB,QAAA,MAAA,EAAQ,iBAAiB,OAAA,EAAS,WAAA,EAAa,EAAE,IAAA,EAAM,MAAM,CAAA;AAAA,MAC/D,CAAC,CAAA;AAED,MAAA,IAAI,OAAA,EAAS;AACX,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,IAAI,sBAAA,CAAuB;AAAA,MAC/B,IAAA,EAAM,eAAA;AAAA,MACN,OAAA,EAAS;AAAA,KACV,CAAA;AAAA,EACH,CAAA;AAUA,EAAA,SAAS,OAAA,CACP,SACA,UAAA,EAC0D;AAC1D,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,cAAA,EAAgB,OAAA,EAAS;AAAA,MAC1C,QAAQ,UAAA,EAAY,MAAA;AAAA,MACpB,SAAS,UAAA,EAAY;AAAA,KAGtB,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,MAAA,GAA4B;AAAA,IAChC,SAAS,MAAM,OAAA;AAAA,IACf,UAAU,QAAA,EAAU;AAClB,MAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,MAAA,QAAA,CAAS,OAAO,CAAA;AAChB,MAAA,eAAA,EAAgB;AAEhB,MAAA,OAAO,MAAM;AACX,QAAA,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,MAC3B,CAAA;AAAA,IACF,CAAA;AAAA,IACA,MAAM,aAAa,MAAA,EAAQ;AACzB,MAAA,MAAM,aAAa,MAAM,CAAA;AAAA,IAC3B,CAAA;AAAA,IACA,MAAM,IAAA,CAAK,MAAA,EAAQ,MAAA,EAAQ,UAAA,EAAY;AACrC,MAAA,IAAI,WAAA,EAAa;AACf,QAAA,MAAM,IAAI,sBAAA,CAAuB;AAAA,UAC/B,IAAA,EAAM,eAAA;AAAA,UACN,OAAA,EAAS;AAAA,SACV,CAAA;AAAA,MACH;AAEA,MAAA,MAAM,YAAA,CAAa,YAAY,MAAM,CAAA;AAErC,MAAA,MAAM,YAAY,eAAA,EAAgB;AAElC,MAAA,OAAO,MAAM,IAAI,OAAA;AAAA,QACf,CAAC,SAAS,MAAA,KAAW;AACnB,UAAA,MAAM,OAAA,GAA0B;AAAA,YAC9B,MAAA;AAAA,YACA,OAAA,EAAS,CAAC,KAAA,KACR,OAAA,CAAQ,KAA8C,CAAA;AAAA,YACxD,MAAA;AAAA,YACA,SAAS,UAAA,EAAY;AAAA,WAGvB;AAEA,UAAA,eAAA,CAAgB,GAAA,CAAI,WAAW,OAAO,CAAA;AAEtC,UAAA,MAAM,cAAc,UAAA,EAAY,MAAA;AAChC,UAAA,MAAM,cAAc,MAAM;AACxB,YAAA,IAAI,CAAC,eAAA,CAAgB,GAAA,CAAI,SAAS,CAAA,EAAG;AACnC,cAAA;AAAA,YACF;AAEA,YAAA,eAAA,CAAgB,OAAO,SAAS,CAAA;AAChC,YAAA,OAAA,CAAQ,oBAAA,IAAuB;AAC/B,YAAA,mBAAA,CAAoB;AAAA,cAClB,QAAA,EAAU,qBAAA;AAAA,cACV,IAAA,EAAM,aAAA;AAAA,cACN;AAAA,aACD,CAAA;AACD,YAAA,MAAA,CAAO,IAAI,YAAA,CAAa,4BAAA,EAA8B,YAAY,CAAC,CAAA;AAAA,UACrE,CAAA;AAEA,UAAA,OAAA,CAAQ,uBAAuB,MAAM;AACnC,YAAA,WAAA,EAAa,mBAAA,CAAoB,SAAS,WAAW,CAAA;AAAA,UACvD,CAAA;AAEA,UAAA,IAAI,aAAa,OAAA,EAAS;AACxB,YAAA,WAAA,EAAY;AACZ,YAAA;AAAA,UACF;AAEA,UAAA,WAAA,EAAa,iBAAiB,OAAA,EAAS,WAAA,EAAa,EAAE,IAAA,EAAM,MAAM,CAAA;AAElE,UAAA,mBAAA,CAAoB;AAAA,YAClB,QAAA,EAAU,qBAAA;AAAA,YACV,IAAA,EAAM,eAAA;AAAA,YACN,SAAA;AAAA,YACA,MAAA;AAAA,YACA;AAAA,WACD,CAAA;AAAA,QACH;AAAA,OACF;AAAA,IACF,CAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,IAAI,WAAA,EAAa;AACf,QAAA;AAAA,MACF;AAEA,MAAA,WAAA,GAAc,IAAA;AACd,MAAA,mBAAA,EAAoB;AACpB,MAAA,eAAA,CAAgB,KAAK,CAAA;AACrB,MAAA,SAAA,CAAU,KAAA,EAAM;AAEhB,MAAA,IAAI,eAAe,YAAA,EAAc;AAC/B,QAAA,IAAI,mBAAmB,IAAA,EAAM;AAC3B,UAAA,YAAA,CAAa,cAAc,cAAc,CAAA;AAAA,QAC3C;AACA,QAAA,YAAA,CAAa,mBAAA,CAAoB,WAAW,aAAa,CAAA;AAAA,MAC3D;AAEA,MAAA,cAAA,GAAiB,IAAA;AACjB,MAAA,WAAA,GAAc,KAAA;AACd,MAAA,aAAA,CAAc;AAAA,QACZ,IAAA,EAAM,eAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AAAA,GACF;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["export const TIPSY_BRIDGE_PROTOCOL = \"tipsy-bridge-v1\";\nexport const TIPSY_INIT_RETRY_MS = 500;\nexport const RESPOND_METHOD = \"sdk.respond\";\n\ntype TipsyBridgeMessageType =\n  | \"tipsy:init\"\n  | \"tipsy:init:ack\"\n  | \"tipsy:request\"\n  | \"tipsy:stream\"\n  | \"tipsy:response\"\n  | \"tipsy:error\"\n  | \"tipsy:abort\";\n\nexport type TipsyRole = \"system\" | \"user\" | \"assistant\";\n\nexport type TipsyMessage = {\n  role: TipsyRole;\n  content: string;\n};\n\nexport type TipsyUsage = {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n};\n\nexport type TipsyTextResponseFormat = {\n  type: \"text\";\n};\n\nexport type TipsyJsonSchemaResponseFormat = {\n  type: \"json_schema\";\n  name: string;\n  schema: Record<string, unknown>;\n};\n\nexport type TipsyRespondResponseFormat =\n  | TipsyTextResponseFormat\n  | TipsyJsonSchemaResponseFormat;\n\ntype TipsyRespondRequestBase = {\n  messages: TipsyMessage[];\n  model_id?: string | null;\n  response_format: TipsyRespondResponseFormat;\n};\n\nexport type TipsyRespondStreamRequest = TipsyRespondRequestBase & {\n  stream: true;\n};\n\nexport type TipsyRespondNonStreamRequest = TipsyRespondRequestBase & {\n  stream: false;\n};\n\nexport type TipsyRespondRequest =\n  | TipsyRespondStreamRequest\n  | TipsyRespondNonStreamRequest;\n\nexport type TipsyRespondEnvelope<T = unknown> = {\n  code: number;\n  msg: string;\n  trace_id: string;\n  data: {\n    message_id: string;\n    result: T;\n    response_format:\n      | TipsyTextResponseFormat\n      | {\n          type: \"json_schema\";\n          name: string;\n        };\n    usage: TipsyUsage;\n  };\n};\n\nexport type TipsyRespondTextStreamEvent = {\n  type: \"delta\";\n  delta: string;\n};\n\nexport type TipsyRespondJsonStreamEvent<T = unknown> = {\n  type: \"delta\";\n  snapshot: Partial<T> | T;\n};\n\nexport type TipsyRespondMetaEvent = {\n  type: \"meta\";\n  message_id: string;\n  usage: TipsyUsage;\n  trace_id: string;\n};\n\nexport type TipsyRespondStreamEvent<T = unknown> =\n  | TipsyRespondTextStreamEvent\n  | TipsyRespondJsonStreamEvent<T>\n  | TipsyRespondMetaEvent;\n\nexport type TipsyRespondResult<T = unknown> = {\n  message_id: string;\n  result: T;\n  response_format:\n    | TipsyTextResponseFormat\n    | {\n        type: \"json_schema\";\n        name: string;\n      };\n};\n\nexport type TipsyBridgeErrorCode =\n  | \"UNAUTHORIZED\"\n  | \"BAD_REQUEST\"\n  | \"NETWORK_ERROR\"\n  | \"STREAM_PARSE_ERROR\"\n  | \"ORIGIN_MISMATCH\"\n  | \"UNSUPPORTED_METHOD\"\n  | \"INTERNAL_ERROR\";\n\nexport type TipsyBridgeError = {\n  code: TipsyBridgeErrorCode;\n  message: string;\n};\n\nexport type TipsyBridgeRequestMap = {\n  [RESPOND_METHOD]: TipsyRespondRequest;\n};\n\nexport type TipsyBridgeStreamMap = {\n  [RESPOND_METHOD]: TipsyRespondStreamEvent;\n};\n\nexport type TipsyBridgeResponseMap = {\n  [RESPOND_METHOD]: TipsyRespondEnvelope | TipsyRespondResult;\n};\n\nexport type TipsyInitMessage = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:init\";\n};\n\ntype TipsyInitAckMessage = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:init:ack\";\n};\n\nexport type TipsyRequestMessage<M extends keyof TipsyBridgeRequestMap> = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:request\";\n  requestId: string;\n  method: M;\n  params: TipsyBridgeRequestMap[M];\n};\n\ntype TipsyStreamMessage<M extends keyof TipsyBridgeStreamMap> = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:stream\";\n  requestId: string;\n  payload: {\n    method: M;\n    event: TipsyBridgeStreamMap[M];\n  };\n};\n\ntype TipsyResponseMessage<M extends keyof TipsyBridgeResponseMap> = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:response\";\n  requestId: string;\n  payload: {\n    method: M;\n    result: TipsyBridgeResponseMap[M];\n  };\n};\n\ntype TipsyErrorMessage = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:error\";\n  requestId?: string;\n  error: TipsyBridgeError;\n};\n\nexport type TipsyAbortMessage = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:abort\";\n  requestId: string;\n};\n\nexport type TipsyBridgeMessage =\n  | TipsyInitMessage\n  | TipsyInitAckMessage\n  | TipsyRequestMessage<keyof TipsyBridgeRequestMap>\n  | TipsyStreamMessage<keyof TipsyBridgeStreamMap>\n  | TipsyResponseMessage<keyof TipsyBridgeResponseMap>\n  | TipsyErrorMessage\n  | TipsyAbortMessage;\n\nexport type TipsyRequestController<M extends keyof TipsyBridgeRequestMap> = {\n  signal?: AbortSignal;\n  onEvent?: (event: TipsyBridgeStreamMap[M]) => void;\n};\n\nexport type TipsyRespondController<T = unknown> = {\n  signal?: AbortSignal;\n  onEvent?: (event: TipsyRespondStreamEvent<T>) => void;\n};\n\nexport class TipsyBridgeClientError extends Error {\n  code: TipsyBridgeErrorCode;\n\n  constructor(error: TipsyBridgeError) {\n    super(error.message);\n    this.name = \"TipsyBridgeClientError\";\n    this.code = error.code;\n  }\n}\n\nexport function getParentOriginFromReferrer(): string | null {\n  if (typeof document === \"undefined\" || !document.referrer) {\n    return null;\n  }\n\n  try {\n    return new URL(document.referrer).origin;\n  } catch {\n    return null;\n  }\n}\n\nexport function normalizeTargetOrigin(value?: string): string {\n  if (value && value.trim()) {\n    return value;\n  }\n\n  return getParentOriginFromReferrer() ?? \"*\";\n}\n\nexport function isBridgeMessage(value: unknown): value is TipsyBridgeMessage {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Partial<TipsyBridgeMessage>;\n  if (candidate.protocol !== TIPSY_BRIDGE_PROTOCOL) {\n    return false;\n  }\n\n  const validTypes = new Set<TipsyBridgeMessageType>([\n    \"tipsy:init\",\n    \"tipsy:init:ack\",\n    \"tipsy:request\",\n    \"tipsy:stream\",\n    \"tipsy:response\",\n    \"tipsy:error\",\n    \"tipsy:abort\",\n  ]);\n\n  return typeof candidate.type === \"string\" && validTypes.has(candidate.type);\n}\n\nexport function createRequestId() {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n\n  return `tipsy_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;\n}\n","import {\n  RESPOND_METHOD,\n  TIPSY_BRIDGE_PROTOCOL,\n  TIPSY_INIT_RETRY_MS,\n  type TipsyAbortMessage,\n  type TipsyBridgeError,\n  TipsyBridgeClientError,\n  type TipsyBridgeRequestMap,\n  type TipsyBridgeResponseMap,\n  type TipsyBridgeStreamMap,\n  type TipsyInitMessage,\n  type TipsyRequestController,\n  type TipsyRequestMessage,\n  type TipsyRespondController,\n  type TipsyRespondEnvelope,\n  type TipsyRespondNonStreamRequest,\n  type TipsyRespondRequest,\n  type TipsyRespondResult,\n  type TipsyRespondStreamRequest,\n  isBridgeMessage,\n  normalizeTargetOrigin,\n  createRequestId,\n} from \"./bridge\";\n\nconst TIPSY_READY_WAIT_RETRY_COUNT = 6;\n\ntype PendingRequest = {\n  method: keyof TipsyBridgeRequestMap;\n  resolve: (value: TipsyBridgeResponseMap[keyof TipsyBridgeResponseMap]) => void;\n  reject: (reason?: unknown) => void;\n  onEvent?: (event: any) => void;\n  cleanupAbortListener?: () => void;\n};\n\nexport type TipsyStudioClientOptions = {\n  targetOrigin?: string;\n  sourceWindow?: Window;\n  targetWindow?: Window;\n};\n\nexport type TipsyStudioClient = {\n  isReady: () => boolean;\n  subscribe: (listener: (isReady: boolean) => void) => () => void;\n  waitForReady: (signal?: AbortSignal) => Promise<void>;\n  call: <M extends keyof TipsyBridgeRequestMap>(\n    method: M,\n    params: TipsyBridgeRequestMap[M],\n    controller?: TipsyRequestController<M>,\n  ) => Promise<TipsyBridgeResponseMap[M]>;\n  respond<T = string>(\n    request: TipsyRespondNonStreamRequest,\n    controller?: TipsyRespondController<T>,\n  ): Promise<TipsyRespondEnvelope<T>>;\n  respond<T = string>(\n    request: TipsyRespondStreamRequest,\n    controller?: TipsyRespondController<T>,\n  ): Promise<TipsyRespondResult<T>>;\n  respond<T = string>(\n    request: TipsyRespondRequest,\n    controller?: TipsyRespondController<T>,\n  ): Promise<TipsyRespondEnvelope<T> | TipsyRespondResult<T>>;\n  destroy: () => void;\n};\n\nexport function createTipsyStudioClient(\n  options: TipsyStudioClientOptions = {},\n): TipsyStudioClient {\n  const sourceWindow =\n    options.sourceWindow ?? (typeof window !== \"undefined\" ? window : undefined);\n  const targetWindow =\n    options.targetWindow ??\n    (sourceWindow && sourceWindow.parent !== sourceWindow\n      ? sourceWindow.parent\n      : undefined);\n  const targetOrigin = normalizeTargetOrigin(options.targetOrigin);\n\n  const pendingRequests = new Map<string, PendingRequest>();\n  const readyWaiters = new Set<() => void>();\n  const listeners = new Set<(isReady: boolean) => void>();\n\n  let isDestroyed = false;\n  let isConnected = false;\n  let isReady = false;\n  let initIntervalId: number | null = null;\n\n  const emitReadyChange = (nextReady: boolean) => {\n    if (isReady === nextReady) {\n      return;\n    }\n\n    isReady = nextReady;\n    for (const listener of listeners) {\n      listener(isReady);\n    }\n  };\n\n  const resolveReadyWaiters = () => {\n    const waiters = Array.from(readyWaiters.values());\n    readyWaiters.clear();\n    for (const resolve of waiters) {\n      resolve();\n    }\n  };\n\n  const rejectPending = (error: TipsyBridgeError) => {\n    const requests = Array.from(pendingRequests.values());\n    pendingRequests.clear();\n    for (const pending of requests) {\n      pending.cleanupAbortListener?.();\n      pending.reject(new TipsyBridgeClientError(error));\n    }\n  };\n\n  const postMessageToTarget = (\n    message:\n      | TipsyInitMessage\n      | TipsyAbortMessage\n      | TipsyRequestMessage<keyof TipsyBridgeRequestMap>,\n  ) => {\n    targetWindow?.postMessage(message, targetOrigin);\n  };\n\n  const postInit = () => {\n    if (isDestroyed || isReady || !targetWindow) {\n      return;\n    }\n\n    postMessageToTarget({\n      protocol: TIPSY_BRIDGE_PROTOCOL,\n      type: \"tipsy:init\",\n    });\n  };\n\n  const handleMessage = (event: MessageEvent) => {\n    if (isDestroyed || event.source !== targetWindow) {\n      return;\n    }\n\n    if (targetOrigin !== \"*\" && event.origin !== targetOrigin) {\n      return;\n    }\n\n    if (!isBridgeMessage(event.data)) {\n      return;\n    }\n\n    if (event.data.type === \"tipsy:init:ack\") {\n      emitReadyChange(true);\n      resolveReadyWaiters();\n      return;\n    }\n\n    if (event.data.type === \"tipsy:error\") {\n      if (!event.data.requestId) {\n        return;\n      }\n\n      const pending = pendingRequests.get(event.data.requestId);\n      if (!pending) {\n        return;\n      }\n\n      pendingRequests.delete(event.data.requestId);\n      pending.cleanupAbortListener?.();\n      pending.reject(new TipsyBridgeClientError(event.data.error));\n      return;\n    }\n\n    if (event.data.type === \"tipsy:stream\") {\n      const pending = pendingRequests.get(event.data.requestId);\n      if (!pending || pending.method !== event.data.payload.method) {\n        return;\n      }\n\n      pending.onEvent?.(event.data.payload.event);\n      return;\n    }\n\n    if (event.data.type === \"tipsy:response\") {\n      const pending = pendingRequests.get(event.data.requestId);\n      if (!pending || pending.method !== event.data.payload.method) {\n        return;\n      }\n\n      pendingRequests.delete(event.data.requestId);\n      pending.cleanupAbortListener?.();\n      pending.resolve(event.data.payload.result);\n    }\n  };\n\n  const ensureConnected = () => {\n    if (isDestroyed || isConnected || !sourceWindow) {\n      return;\n    }\n\n    sourceWindow.addEventListener(\"message\", handleMessage);\n    initIntervalId = sourceWindow.setInterval(postInit, TIPSY_INIT_RETRY_MS);\n    isConnected = true;\n    postInit();\n  };\n\n  const ensureBridgeAvailable = () => {\n    if (!sourceWindow || !targetWindow) {\n      throw new TipsyBridgeClientError({\n        code: \"NETWORK_ERROR\",\n        message: \"Tipsy bridge is only available inside an iframe.\",\n      });\n    }\n  };\n\n  const waitForReady = async (signal?: AbortSignal) => {\n    if (isDestroyed) {\n      throw new TipsyBridgeClientError({\n        code: \"NETWORK_ERROR\",\n        message: \"Tipsy bridge was disconnected.\",\n      });\n    }\n\n    ensureBridgeAvailable();\n    ensureConnected();\n    const activeSourceWindow = sourceWindow;\n\n    if (!activeSourceWindow) {\n      throw new TipsyBridgeClientError({\n        code: \"NETWORK_ERROR\",\n        message: \"Tipsy bridge is only available inside an iframe.\",\n      });\n    }\n\n    if (isReady) {\n      return;\n    }\n\n    for (let attempt = 0; attempt < TIPSY_READY_WAIT_RETRY_COUNT; attempt += 1) {\n      if (signal?.aborted) {\n        throw new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n\n      postInit();\n\n      await new Promise<void>((resolve, reject) => {\n        let timeoutId = 0;\n\n        const handleReady = () => {\n          activeSourceWindow.clearTimeout(timeoutId);\n          signal?.removeEventListener(\"abort\", handleAbort);\n          readyWaiters.delete(handleReady);\n          resolve();\n        };\n\n        const handleAbort = () => {\n          activeSourceWindow.clearTimeout(timeoutId);\n          readyWaiters.delete(handleReady);\n          signal?.removeEventListener(\"abort\", handleAbort);\n          reject(new DOMException(\"The operation was aborted.\", \"AbortError\"));\n        };\n\n        readyWaiters.add(handleReady);\n        timeoutId = activeSourceWindow.setTimeout(() => {\n          readyWaiters.delete(handleReady);\n          signal?.removeEventListener(\"abort\", handleAbort);\n          resolve();\n        }, TIPSY_INIT_RETRY_MS);\n\n        signal?.addEventListener(\"abort\", handleAbort, { once: true });\n      });\n\n      if (isReady) {\n        return;\n      }\n    }\n\n    throw new TipsyBridgeClientError({\n      code: \"NETWORK_ERROR\",\n      message: \"Tipsy bridge is not ready.\",\n    });\n  };\n\n  function respond<T = string>(\n    request: TipsyRespondNonStreamRequest,\n    controller?: TipsyRespondController<T>,\n  ): Promise<TipsyRespondEnvelope<T>>;\n  function respond<T = string>(\n    request: TipsyRespondStreamRequest,\n    controller?: TipsyRespondController<T>,\n  ): Promise<TipsyRespondResult<T>>;\n  function respond<T = string>(\n    request: TipsyRespondRequest,\n    controller?: TipsyRespondController<T>,\n  ): Promise<TipsyRespondEnvelope<T> | TipsyRespondResult<T>> {\n    return client.call(RESPOND_METHOD, request, {\n      signal: controller?.signal,\n      onEvent: controller?.onEvent as\n        | ((event: TipsyBridgeStreamMap[typeof RESPOND_METHOD]) => void)\n        | undefined,\n    }) as Promise<TipsyRespondEnvelope<T> | TipsyRespondResult<T>>;\n  }\n\n  const client: TipsyStudioClient = {\n    isReady: () => isReady,\n    subscribe(listener) {\n      listeners.add(listener);\n      listener(isReady);\n      ensureConnected();\n\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    async waitForReady(signal) {\n      await waitForReady(signal);\n    },\n    async call(method, params, controller) {\n      if (isDestroyed) {\n        throw new TipsyBridgeClientError({\n          code: \"NETWORK_ERROR\",\n          message: \"Tipsy bridge was disconnected.\",\n        });\n      }\n\n      await waitForReady(controller?.signal);\n\n      const requestId = createRequestId();\n\n      return await new Promise<TipsyBridgeResponseMap[typeof method]>(\n        (resolve, reject) => {\n          const pending: PendingRequest = {\n            method,\n            resolve: (value) =>\n              resolve(value as TipsyBridgeResponseMap[typeof method]),\n            reject,\n            onEvent: controller?.onEvent as\n              | ((event: TipsyBridgeStreamMap[typeof method]) => void)\n              | undefined,\n          };\n\n          pendingRequests.set(requestId, pending);\n\n          const abortSignal = controller?.signal;\n          const handleAbort = () => {\n            if (!pendingRequests.has(requestId)) {\n              return;\n            }\n\n            pendingRequests.delete(requestId);\n            pending.cleanupAbortListener?.();\n            postMessageToTarget({\n              protocol: TIPSY_BRIDGE_PROTOCOL,\n              type: \"tipsy:abort\",\n              requestId,\n            });\n            reject(new DOMException(\"The operation was aborted.\", \"AbortError\"));\n          };\n\n          pending.cleanupAbortListener = () => {\n            abortSignal?.removeEventListener(\"abort\", handleAbort);\n          };\n\n          if (abortSignal?.aborted) {\n            handleAbort();\n            return;\n          }\n\n          abortSignal?.addEventListener(\"abort\", handleAbort, { once: true });\n\n          postMessageToTarget({\n            protocol: TIPSY_BRIDGE_PROTOCOL,\n            type: \"tipsy:request\",\n            requestId,\n            method,\n            params,\n          });\n        },\n      );\n    },\n    respond,\n    destroy() {\n      if (isDestroyed) {\n        return;\n      }\n\n      isDestroyed = true;\n      resolveReadyWaiters();\n      emitReadyChange(false);\n      listeners.clear();\n\n      if (isConnected && sourceWindow) {\n        if (initIntervalId !== null) {\n          sourceWindow.clearInterval(initIntervalId);\n        }\n        sourceWindow.removeEventListener(\"message\", handleMessage);\n      }\n\n      initIntervalId = null;\n      isConnected = false;\n      rejectPending({\n        code: \"NETWORK_ERROR\",\n        message: \"Tipsy bridge was disconnected.\",\n      });\n    },\n  };\n\n  return client;\n}\n"]}

package/dist/index.d.cts

@@ -1,2 +1,165 @@
+declare const TIPSY_BRIDGE_PROTOCOL = "tipsy-bridge-v1";
+declare const TIPSY_INIT_RETRY_MS = 500;
+declare const RESPOND_METHOD = "sdk.respond";
+type TipsyRole = "system" | "user" | "assistant";
+type TipsyMessage = {
+    role: TipsyRole;
+    content: string;
+};
+type TipsyUsage = {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+};
+type TipsyTextResponseFormat = {
+    type: "text";
+};
+type TipsyJsonSchemaResponseFormat = {
+    type: "json_schema";
+    name: string;
+    schema: Record<string, unknown>;
+};
+type TipsyRespondResponseFormat = TipsyTextResponseFormat | TipsyJsonSchemaResponseFormat;
+type TipsyRespondRequestBase = {
+    messages: TipsyMessage[];
+    model_id?: string | null;
+    response_format: TipsyRespondResponseFormat;
+};
+type TipsyRespondStreamRequest = TipsyRespondRequestBase & {
+    stream: true;
+};
+type TipsyRespondNonStreamRequest = TipsyRespondRequestBase & {
+    stream: false;
+};
+type TipsyRespondRequest = TipsyRespondStreamRequest | TipsyRespondNonStreamRequest;
+type TipsyRespondEnvelope<T = unknown> = {
+    code: number;
+    msg: string;
+    trace_id: string;
+    data: {
+        message_id: string;
+        result: T;
+        response_format: TipsyTextResponseFormat | {
+            type: "json_schema";
+            name: string;
+        };
+        usage: TipsyUsage;
+    };
+};
+type TipsyRespondTextStreamEvent = {
+    type: "delta";
+    delta: string;
+};
+type TipsyRespondJsonStreamEvent<T = unknown> = {
+    type: "delta";
+    snapshot: Partial<T> | T;
+};
+type TipsyRespondMetaEvent = {
+    type: "meta";
+    message_id: string;
+    usage: TipsyUsage;
+    trace_id: string;
+};
+type TipsyRespondStreamEvent<T = unknown> = TipsyRespondTextStreamEvent | TipsyRespondJsonStreamEvent<T> | TipsyRespondMetaEvent;
+type TipsyRespondResult<T = unknown> = {
+    message_id: string;
+    result: T;
+    response_format: TipsyTextResponseFormat | {
+        type: "json_schema";
+        name: string;
+    };
+};
+type TipsyBridgeErrorCode = "UNAUTHORIZED" | "BAD_REQUEST" | "NETWORK_ERROR" | "STREAM_PARSE_ERROR" | "ORIGIN_MISMATCH" | "UNSUPPORTED_METHOD" | "INTERNAL_ERROR";
+type TipsyBridgeError = {
+    code: TipsyBridgeErrorCode;
+    message: string;
+};
+type TipsyBridgeRequestMap = {
+    [RESPOND_METHOD]: TipsyRespondRequest;
+};
+type TipsyBridgeStreamMap = {
+    [RESPOND_METHOD]: TipsyRespondStreamEvent;
+};
+type TipsyBridgeResponseMap = {
+    [RESPOND_METHOD]: TipsyRespondEnvelope | TipsyRespondResult;
+};
+type TipsyInitMessage = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:init";
+};
+type TipsyInitAckMessage = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:init:ack";
+};
+type TipsyRequestMessage<M extends keyof TipsyBridgeRequestMap> = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:request";
+    requestId: string;
+    method: M;
+    params: TipsyBridgeRequestMap[M];
+};
+type TipsyStreamMessage<M extends keyof TipsyBridgeStreamMap> = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:stream";
+    requestId: string;
+    payload: {
+        method: M;
+        event: TipsyBridgeStreamMap[M];
+    };
+};
+type TipsyResponseMessage<M extends keyof TipsyBridgeResponseMap> = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:response";
+    requestId: string;
+    payload: {
+        method: M;
+        result: TipsyBridgeResponseMap[M];
+    };
+};
+type TipsyErrorMessage = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:error";
+    requestId?: string;
+    error: TipsyBridgeError;
+};
+type TipsyAbortMessage = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:abort";
+    requestId: string;
+};
+type TipsyBridgeMessage = TipsyInitMessage | TipsyInitAckMessage | TipsyRequestMessage<keyof TipsyBridgeRequestMap> | TipsyStreamMessage<keyof TipsyBridgeStreamMap> | TipsyResponseMessage<keyof TipsyBridgeResponseMap> | TipsyErrorMessage | TipsyAbortMessage;
+type TipsyRequestController<M extends keyof TipsyBridgeRequestMap> = {
+    signal?: AbortSignal;
+    onEvent?: (event: TipsyBridgeStreamMap[M]) => void;
+};
+type TipsyRespondController<T = unknown> = {
+    signal?: AbortSignal;
+    onEvent?: (event: TipsyRespondStreamEvent<T>) => void;
+};
+declare class TipsyBridgeClientError extends Error {
+    code: TipsyBridgeErrorCode;
+    constructor(error: TipsyBridgeError);
+}
+declare function getParentOriginFromReferrer(): string | null;
+declare function normalizeTargetOrigin(value?: string): string;
+declare function isBridgeMessage(value: unknown): value is TipsyBridgeMessage;
+declare function createRequestId(): string;
 
-export {  }
+type TipsyStudioClientOptions = {
+    targetOrigin?: string;
+    sourceWindow?: Window;
+    targetWindow?: Window;
+};
+type TipsyStudioClient = {
+    isReady: () => boolean;
+    subscribe: (listener: (isReady: boolean) => void) => () => void;
+    waitForReady: (signal?: AbortSignal) => Promise<void>;
+    call: <M extends keyof TipsyBridgeRequestMap>(method: M, params: TipsyBridgeRequestMap[M], controller?: TipsyRequestController<M>) => Promise<TipsyBridgeResponseMap[M]>;
+    respond<T = string>(request: TipsyRespondNonStreamRequest, controller?: TipsyRespondController<T>): Promise<TipsyRespondEnvelope<T>>;
+    respond<T = string>(request: TipsyRespondStreamRequest, controller?: TipsyRespondController<T>): Promise<TipsyRespondResult<T>>;
+    respond<T = string>(request: TipsyRespondRequest, controller?: TipsyRespondController<T>): Promise<TipsyRespondEnvelope<T> | TipsyRespondResult<T>>;
+    destroy: () => void;
+};
+declare function createTipsyStudioClient(options?: TipsyStudioClientOptions): TipsyStudioClient;
+
+export { RESPOND_METHOD, TIPSY_BRIDGE_PROTOCOL, TIPSY_INIT_RETRY_MS, type TipsyAbortMessage, TipsyBridgeClientError, type TipsyBridgeError, type TipsyBridgeErrorCode, type TipsyBridgeMessage, type TipsyBridgeRequestMap, type TipsyBridgeResponseMap, type TipsyBridgeStreamMap, type TipsyJsonSchemaResponseFormat, type TipsyMessage, type TipsyRequestController, type TipsyRequestMessage, type TipsyRespondController, type TipsyRespondEnvelope, type TipsyRespondMetaEvent, type TipsyRespondNonStreamRequest, type TipsyRespondRequest, type TipsyRespondResponseFormat, type TipsyRespondResult, type TipsyRespondStreamEvent, type TipsyRespondStreamRequest, type TipsyRole, type TipsyStudioClient, type TipsyStudioClientOptions, type TipsyTextResponseFormat, type TipsyUsage, createRequestId, createTipsyStudioClient, getParentOriginFromReferrer, isBridgeMessage, normalizeTargetOrigin };