@tipsy-studio/sdk 0.0.1 → 0.0.2

package/README.md

@@ -1,6 +1,6 @@
 # @tipsy-studio/sdk
 
-React sdk for Tipsy Studio apps.
+React SDK for Tipsy Studio iframe apps.
 
 ## Install
 
@@ -13,13 +13,53 @@ npm install @tipsy-studio/sdk react
 React-specific exports are available from the `/react` subpath.
 
 ```tsx
-import { useMounted } from "@tipsy-studio/sdk/react";
+import { TipsyStudioProvider, useTipsyChat } from "@tipsy-studio/sdk/react";
 
-export function Demo() {
-  const mounted = useMounted();
+function ChatButton() {
+  const chat = useTipsyChat();
+
+  async function handleClick() {
+    const textParts: string[] = [];
+
+    const result = await chat.completions(
+      {
+        messages: [
+          {
+            role: "system",
+            content: "You are a helpful assistant.",
+          },
+        ],
+        stream: true,
+      },
+      {
+        onData(chunk) {
+          textParts.push(chunk.chunk);
+        },
+        onComplete() {
+          console.log("stream complete", textParts.join(""));
+        },
+      },
+    );
 
-  if (!mounted) return null;
+    console.log(result.raw);
+  }
+
+  return <button onClick={handleClick}>Run chat</button>;
+}
 
-  return <div>Client content</div>;
+export function Demo() {
+  return (
+    <TipsyStudioProvider>
+      <ChatButton />
+    </TipsyStudioProvider>
+  );
 }
 ```
+
+If the parent page uses a fixed allowlist, pass `targetOrigin` explicitly:
+
+```tsx
+<TipsyStudioProvider targetOrigin="https://tipsy.chat">
+  <App />
+</TipsyStudioProvider>
+```

package/dist/react.cjs

@@ -2,16 +2,255 @@
 
 var react = require('react');
 
-// src/hooks/useMounted.ts
-function useMounted() {
-  const [mounted, setMounted] = react.useState(false);
+// src/react.ts
+
+// src/bridge.ts
+var TIPSY_BRIDGE_PROTOCOL = "tipsy-bridge-v1";
+var TIPSY_INIT_RETRY_MS = 500;
+var CHAT_COMPLETIONS_METHOD = "chat.completions";
+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/react.ts
+var TipsyStudioContext = react.createContext(null);
+function TipsyStudioProvider({
+  children,
+  targetOrigin
+}) {
+  const resolvedTargetOrigin = react.useMemo(
+    () => normalizeTargetOrigin(targetOrigin),
+    [targetOrigin]
+  );
+  const [isReady, setIsReady] = react.useState(false);
+  const pendingRef = react.useRef(/* @__PURE__ */ new Map());
+  const readyRef = react.useRef(false);
+  const targetOriginRef = react.useRef(resolvedTargetOrigin);
+  react.useEffect(() => {
+    targetOriginRef.current = resolvedTargetOrigin;
+  }, [resolvedTargetOrigin]);
   react.useEffect(() => {
-    setMounted(true);
-    console.log("npm \u5305\u6D4B\u8BD5\u901A\u8FC7666");
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    let cancelled = false;
+    const rejectPending = (error) => {
+      const pendingRequests = Array.from(pendingRef.current.values());
+      pendingRef.current.clear();
+      for (const pending of pendingRequests) {
+        pending.reject(new TipsyBridgeClientError(error));
+      }
+    };
+    const postInit = () => {
+      if (cancelled || readyRef.current || window.parent === window) {
+        return;
+      }
+      const initMessage = {
+        protocol: TIPSY_BRIDGE_PROTOCOL,
+        type: "tipsy:init"
+      };
+      window.parent.postMessage(initMessage, targetOriginRef.current);
+    };
+    const intervalId = window.setInterval(postInit, TIPSY_INIT_RETRY_MS);
+    postInit();
+    const handleMessage = (event) => {
+      if (window.parent === window || event.source !== window.parent) {
+        return;
+      }
+      if (targetOriginRef.current !== "*" && event.origin !== targetOriginRef.current) {
+        return;
+      }
+      if (!isBridgeMessage(event.data)) {
+        return;
+      }
+      if (event.data.type === "tipsy:init:ack") {
+        readyRef.current = true;
+        setIsReady(true);
+        return;
+      }
+      if (event.data.type === "tipsy:error") {
+        if (!event.data.requestId) {
+          return;
+        }
+        const pending = pendingRef.current.get(event.data.requestId);
+        if (!pending) {
+          return;
+        }
+        pendingRef.current.delete(event.data.requestId);
+        pending.reject(new TipsyBridgeClientError(event.data.error));
+        return;
+      }
+      if (event.data.type === "tipsy:stream") {
+        const pending = pendingRef.current.get(event.data.requestId);
+        if (!pending || pending.method !== CHAT_COMPLETIONS_METHOD) {
+          return;
+        }
+        pending.onData?.(event.data.payload);
+        return;
+      }
+      if (event.data.type === "tipsy:response") {
+        const pending = pendingRef.current.get(event.data.requestId);
+        if (!pending) {
+          return;
+        }
+        pendingRef.current.delete(event.data.requestId);
+        pending.onComplete?.(event.data.payload);
+        pending.resolve(event.data.payload);
+      }
+    };
+    window.addEventListener("message", handleMessage);
+    return () => {
+      cancelled = true;
+      readyRef.current = false;
+      setIsReady(false);
+      window.clearInterval(intervalId);
+      window.removeEventListener("message", handleMessage);
+      rejectPending({
+        code: "NETWORK_ERROR",
+        message: "Tipsy bridge was disconnected."
+      });
+    };
   }, []);
-  return mounted;
+  const contextValue = react.useMemo(() => {
+    return {
+      isReady,
+      targetOrigin: resolvedTargetOrigin,
+      call(method, payload, controller) {
+        if (typeof window === "undefined" || window.parent === window) {
+          return Promise.reject(
+            new TipsyBridgeClientError({
+              code: "NETWORK_ERROR",
+              message: "Tipsy bridge is only available inside an iframe."
+            })
+          );
+        }
+        if (!readyRef.current) {
+          return Promise.reject(
+            new TipsyBridgeClientError({
+              code: "NETWORK_ERROR",
+              message: "Tipsy bridge is not ready."
+            })
+          );
+        }
+        const requestId = createRequestId();
+        return new Promise(
+          (resolve, reject) => {
+            const pending = {
+              method,
+              resolve: (value) => resolve(value),
+              reject,
+              onData: method === CHAT_COMPLETIONS_METHOD ? controller?.onData : void 0,
+              onComplete: method === CHAT_COMPLETIONS_METHOD ? controller?.onComplete : void 0
+            };
+            pendingRef.current.set(requestId, pending);
+            const abortSignal = controller?.signal;
+            const handleAbort = () => {
+              if (!pendingRef.current.has(requestId)) {
+                return;
+              }
+              pendingRef.current.delete(requestId);
+              const abortMessage = {
+                protocol: TIPSY_BRIDGE_PROTOCOL,
+                type: "tipsy:abort",
+                requestId
+              };
+              window.parent.postMessage(abortMessage, targetOriginRef.current);
+              reject(
+                new DOMException("The operation was aborted.", "AbortError")
+              );
+            };
+            if (abortSignal?.aborted) {
+              handleAbort();
+              return;
+            }
+            abortSignal?.addEventListener("abort", handleAbort, { once: true });
+            const requestMessage = {
+              protocol: TIPSY_BRIDGE_PROTOCOL,
+              type: "tipsy:request",
+              requestId,
+              method,
+              payload
+            };
+            window.parent.postMessage(requestMessage, targetOriginRef.current);
+          }
+        );
+      }
+    };
+  }, [isReady, resolvedTargetOrigin]);
+  return react.createElement(
+    TipsyStudioContext.Provider,
+    { value: contextValue },
+    children
+  );
+}
+function useTipsyStudio() {
+  const context = react.useContext(TipsyStudioContext);
+  if (!context) {
+    throw new Error("useTipsyStudio must be used within TipsyStudioProvider.");
+  }
+  return context;
+}
+function useTipsyChat() {
+  const studio = useTipsyStudio();
+  return react.useMemo(() => {
+    return {
+      completions(input, controller) {
+        return studio.call(CHAT_COMPLETIONS_METHOD, input, controller);
+      }
+    };
+  }, [studio]);
 }
 
-exports.useMounted = useMounted;
+exports.CHAT_COMPLETIONS_METHOD = CHAT_COMPLETIONS_METHOD;
+exports.TIPSY_BRIDGE_PROTOCOL = TIPSY_BRIDGE_PROTOCOL;
+exports.TipsyBridgeClientError = TipsyBridgeClientError;
+exports.TipsyStudioProvider = TipsyStudioProvider;
+exports.useTipsyChat = useTipsyChat;
+exports.useTipsyStudio = useTipsyStudio;
 //# sourceMappingURL=react.cjs.map
 //# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useMounted.ts"],"names":["useState","useEffect"],"mappings":";;;;;AAIO,SAAS,UAAA,GAA+B;AAC7C,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAS,KAAK,CAAA;AAE5C,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,UAAA,CAAW,IAAI,CAAA;AACf,IAAA,OAAA,CAAQ,IAAI,uCAAc,CAAA;AAAA,EAC5B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,OAAA;AACT","file":"react.cjs","sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport type UseMountedReturn = boolean;\n\nexport function useMounted(): UseMountedReturn {\n  const [mounted, setMounted] = useState(false);\n\n  useEffect(() => {\n    setMounted(true);\n    console.log(\"npm 包测试通过666\");\n  }, []);\n\n  return mounted;\n}\n"]}
+{"version":3,"sources":["../src/bridge.ts","../src/react.ts"],"names":["createContext","useMemo","useState","useRef","useEffect","createElement","useContext"],"mappings":"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","file":"react.cjs","sourcesContent":["export const TIPSY_BRIDGE_PROTOCOL = \"tipsy-bridge-v1\";\nexport const TIPSY_INIT_RETRY_MS = 500;\nexport const CHAT_COMPLETIONS_METHOD = \"chat.completions\";\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\ntype TipsyRole = \"system\" | \"user\" | \"assistant\";\n\nexport type TipsyChatMessage = {\n  role: TipsyRole;\n  content: string;\n};\n\nexport type TipsyChatCompletionInput = {\n  messages: TipsyChatMessage[];\n  stream: true;\n};\n\nexport type TipsyChatCompletionRawChunk = {\n  type?: string;\n  choices?: Array<{\n    delta?: {\n      content?: string;\n      reasoning?: string;\n    };\n  }>;\n  isFinished?: boolean;\n  [key: string]: unknown;\n};\n\nexport type TipsyChatCompletionChunk = {\n  type: \"stream\";\n  chunk: string;\n  raw: TipsyChatCompletionRawChunk;\n  isFinished: false;\n};\n\nexport type TipsyChatCompletionResult = {\n  type: \"done\";\n  raw: TipsyChatCompletionRawChunk;\n  isFinished: true;\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  [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionInput;\n};\n\nexport type TipsyBridgeResponseMap = {\n  [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionResult;\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  payload: TipsyBridgeRequestMap[M];\n};\n\ntype TipsyStreamMessage = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:stream\";\n  requestId: string;\n  payload: TipsyChatCompletionChunk;\n};\n\ntype TipsyResponseMessage<M extends keyof TipsyBridgeResponseMap> = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:response\";\n  requestId: string;\n  payload: TipsyBridgeResponseMap[M];\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\n  | TipsyResponseMessage<keyof TipsyBridgeResponseMap>\n  | TipsyErrorMessage\n  | TipsyAbortMessage;\n\nexport type TipsyRequestController = {\n  signal?: AbortSignal;\n};\n\nexport type TipsyChatCompletionController = TipsyRequestController & {\n  onData?: (chunk: TipsyChatCompletionChunk) => void;\n  onComplete?: (result: TipsyChatCompletionResult) => 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  createElement,\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  CHAT_COMPLETIONS_METHOD,\n  TIPSY_BRIDGE_PROTOCOL,\n  TIPSY_INIT_RETRY_MS,\n  type TipsyAbortMessage,\n  type TipsyBridgeError,\n  type TipsyBridgeRequestMap,\n  type TipsyBridgeResponseMap,\n  type TipsyInitMessage,\n  type TipsyRequestController,\n  type TipsyRequestMessage,\n  TipsyBridgeClientError,\n  type TipsyChatCompletionChunk,\n  type TipsyChatCompletionController,\n  type TipsyChatCompletionInput,\n  type TipsyChatCompletionResult,\n  createRequestId,\n  isBridgeMessage,\n  normalizeTargetOrigin,\n} from \"./bridge\";\nexport {\n  CHAT_COMPLETIONS_METHOD,\n  TIPSY_BRIDGE_PROTOCOL,\n  TipsyBridgeClientError,\n  type TipsyAbortMessage,\n  type TipsyBridgeError,\n  type TipsyBridgeMessage,\n  type TipsyBridgeRequestMap,\n  type TipsyBridgeResponseMap,\n  type TipsyChatCompletionChunk,\n  type TipsyChatCompletionController,\n  type TipsyChatCompletionInput,\n  type TipsyChatCompletionRawChunk,\n  type TipsyChatCompletionResult,\n  type TipsyChatMessage,\n} from \"./bridge\";\n\nexport type TipsyStudioProviderProps = PropsWithChildren<{\n  targetOrigin?: string;\n}>;\n\ntype PendingRequest = {\n  method: keyof TipsyBridgeRequestMap;\n  resolve: (value: TipsyChatCompletionResult) => void;\n  reject: (reason?: unknown) => void;\n  onData?: (chunk: TipsyChatCompletionChunk) => void;\n  onComplete?: (result: TipsyChatCompletionResult) => void;\n};\n\ntype TipsyStudioContextValue = {\n  isReady: boolean;\n  targetOrigin: string;\n  call: <M extends keyof TipsyBridgeRequestMap>(\n    method: M,\n    payload: TipsyBridgeRequestMap[M],\n    controller?: M extends \"chat.completions\"\n      ? TipsyChatCompletionController\n      : TipsyRequestController,\n  ) => Promise<TipsyBridgeResponseMap[M]>;\n};\n\nconst TipsyStudioContext = createContext<TipsyStudioContextValue | null>(null);\n\nexport function TipsyStudioProvider({\n  children,\n  targetOrigin,\n}: TipsyStudioProviderProps) {\n  const resolvedTargetOrigin = useMemo(\n    () => normalizeTargetOrigin(targetOrigin),\n    [targetOrigin],\n  );\n  const [isReady, setIsReady] = useState(false);\n  const pendingRef = useRef<Map<string, PendingRequest>>(new Map());\n  const readyRef = useRef(false);\n  const targetOriginRef = useRef(resolvedTargetOrigin);\n\n  useEffect(() => {\n    targetOriginRef.current = resolvedTargetOrigin;\n  }, [resolvedTargetOrigin]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return undefined;\n    }\n\n    let cancelled = false;\n\n    const rejectPending = (error: TipsyBridgeError) => {\n      const pendingRequests = Array.from(pendingRef.current.values());\n      pendingRef.current.clear();\n      for (const pending of pendingRequests) {\n        pending.reject(new TipsyBridgeClientError(error));\n      }\n    };\n\n    const postInit = () => {\n      if (cancelled || readyRef.current || window.parent === window) {\n        return;\n      }\n\n      const initMessage: TipsyInitMessage = {\n        protocol: TIPSY_BRIDGE_PROTOCOL,\n        type: \"tipsy:init\",\n      };\n\n      window.parent.postMessage(initMessage, targetOriginRef.current);\n    };\n\n    const intervalId = window.setInterval(postInit, TIPSY_INIT_RETRY_MS);\n    postInit();\n\n    const handleMessage = (event: MessageEvent) => {\n      if (window.parent === window || event.source !== window.parent) {\n        return;\n      }\n\n      if (\n        targetOriginRef.current !== \"*\" &&\n        event.origin !== targetOriginRef.current\n      ) {\n        return;\n      }\n\n      if (!isBridgeMessage(event.data)) {\n        return;\n      }\n\n      if (event.data.type === \"tipsy:init:ack\") {\n        readyRef.current = true;\n        setIsReady(true);\n        return;\n      }\n\n      if (event.data.type === \"tipsy:error\") {\n        if (!event.data.requestId) {\n          return;\n        }\n\n        const pending = pendingRef.current.get(event.data.requestId);\n        if (!pending) {\n          return;\n        }\n\n        pendingRef.current.delete(event.data.requestId);\n        pending.reject(new TipsyBridgeClientError(event.data.error));\n        return;\n      }\n\n      if (event.data.type === \"tipsy:stream\") {\n        const pending = pendingRef.current.get(event.data.requestId);\n        if (!pending || pending.method !== CHAT_COMPLETIONS_METHOD) {\n          return;\n        }\n\n        pending.onData?.(event.data.payload);\n        return;\n      }\n\n      if (event.data.type === \"tipsy:response\") {\n        const pending = pendingRef.current.get(event.data.requestId);\n        if (!pending) {\n          return;\n        }\n\n        pendingRef.current.delete(event.data.requestId);\n        pending.onComplete?.(event.data.payload as TipsyChatCompletionResult);\n        pending.resolve(event.data.payload as TipsyChatCompletionResult);\n      }\n    };\n\n    window.addEventListener(\"message\", handleMessage);\n\n    return () => {\n      cancelled = true;\n      readyRef.current = false;\n      setIsReady(false);\n      window.clearInterval(intervalId);\n      window.removeEventListener(\"message\", handleMessage);\n      rejectPending({\n        code: \"NETWORK_ERROR\",\n        message: \"Tipsy bridge was disconnected.\",\n      });\n    };\n  }, []);\n\n  const contextValue = useMemo<TipsyStudioContextValue>(() => {\n    return {\n      isReady,\n      targetOrigin: resolvedTargetOrigin,\n      call(method, payload, controller) {\n        if (typeof window === \"undefined\" || window.parent === window) {\n          return Promise.reject(\n            new TipsyBridgeClientError({\n              code: \"NETWORK_ERROR\",\n              message: \"Tipsy bridge is only available inside an iframe.\",\n            }),\n          );\n        }\n\n        if (!readyRef.current) {\n          return Promise.reject(\n            new TipsyBridgeClientError({\n              code: \"NETWORK_ERROR\",\n              message: \"Tipsy bridge is not ready.\",\n            }),\n          );\n        }\n\n        const requestId = createRequestId();\n\n        return 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              onData:\n                method === CHAT_COMPLETIONS_METHOD\n                  ? (controller as TipsyChatCompletionController | undefined)\n                      ?.onData\n                  : undefined,\n              onComplete:\n                method === CHAT_COMPLETIONS_METHOD\n                  ? (controller as TipsyChatCompletionController | undefined)\n                      ?.onComplete\n                  : undefined,\n            };\n\n            pendingRef.current.set(requestId, pending);\n\n            const abortSignal = controller?.signal;\n            const handleAbort = () => {\n              if (!pendingRef.current.has(requestId)) {\n                return;\n              }\n\n              pendingRef.current.delete(requestId);\n              const abortMessage: TipsyAbortMessage = {\n                protocol: TIPSY_BRIDGE_PROTOCOL,\n                type: \"tipsy:abort\",\n                requestId,\n              };\n              window.parent.postMessage(abortMessage, targetOriginRef.current);\n              reject(\n                new DOMException(\"The operation was aborted.\", \"AbortError\"),\n              );\n            };\n\n            if (abortSignal?.aborted) {\n              handleAbort();\n              return;\n            }\n\n            abortSignal?.addEventListener(\"abort\", handleAbort, { once: true });\n\n            const requestMessage: TipsyRequestMessage<typeof method> = {\n              protocol: TIPSY_BRIDGE_PROTOCOL,\n              type: \"tipsy:request\",\n              requestId,\n              method,\n              payload,\n            };\n\n            window.parent.postMessage(requestMessage, targetOriginRef.current);\n          },\n        );\n      },\n    };\n  }, [isReady, resolvedTargetOrigin]);\n\n  return createElement(\n    TipsyStudioContext.Provider,\n    { value: contextValue },\n    children,\n  );\n}\n\nexport function useTipsyStudio() {\n  const context = useContext(TipsyStudioContext);\n\n  if (!context) {\n    throw new Error(\"useTipsyStudio must be used within TipsyStudioProvider.\");\n  }\n\n  return context;\n}\n\nexport function useTipsyChat() {\n  const studio = useTipsyStudio();\n\n  return useMemo(() => {\n    return {\n      completions(\n        input: TipsyChatCompletionInput,\n        controller?: TipsyChatCompletionController,\n      ) {\n        return studio.call(CHAT_COMPLETIONS_METHOD, input, controller);\n      },\n    };\n  }, [studio]);\n}\n"]}

package/dist/react.d.cts

@@ -1,4 +1,113 @@
-type UseMountedReturn = boolean;
-declare function useMounted(): UseMountedReturn;
+import * as react from 'react';
+import { PropsWithChildren } from 'react';
 
-export { type UseMountedReturn, useMounted };
+declare const TIPSY_BRIDGE_PROTOCOL = "tipsy-bridge-v1";
+declare const CHAT_COMPLETIONS_METHOD = "chat.completions";
+type TipsyRole = "system" | "user" | "assistant";
+type TipsyChatMessage = {
+    role: TipsyRole;
+    content: string;
+};
+type TipsyChatCompletionInput = {
+    messages: TipsyChatMessage[];
+    stream: true;
+};
+type TipsyChatCompletionRawChunk = {
+    type?: string;
+    choices?: Array<{
+        delta?: {
+            content?: string;
+            reasoning?: string;
+        };
+    }>;
+    isFinished?: boolean;
+    [key: string]: unknown;
+};
+type TipsyChatCompletionChunk = {
+    type: "stream";
+    chunk: string;
+    raw: TipsyChatCompletionRawChunk;
+    isFinished: false;
+};
+type TipsyChatCompletionResult = {
+    type: "done";
+    raw: TipsyChatCompletionRawChunk;
+    isFinished: true;
+};
+type TipsyBridgeErrorCode = "UNAUTHORIZED" | "BAD_REQUEST" | "NETWORK_ERROR" | "STREAM_PARSE_ERROR" | "ORIGIN_MISMATCH" | "UNSUPPORTED_METHOD" | "INTERNAL_ERROR";
+type TipsyBridgeError = {
+    code: TipsyBridgeErrorCode;
+    message: string;
+};
+type TipsyBridgeRequestMap = {
+    [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionInput;
+};
+type TipsyBridgeResponseMap = {
+    [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionResult;
+};
+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;
+    payload: TipsyBridgeRequestMap[M];
+};
+type TipsyStreamMessage = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:stream";
+    requestId: string;
+    payload: TipsyChatCompletionChunk;
+};
+type TipsyResponseMessage<M extends keyof TipsyBridgeResponseMap> = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:response";
+    requestId: string;
+    payload: 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 | TipsyResponseMessage<keyof TipsyBridgeResponseMap> | TipsyErrorMessage | TipsyAbortMessage;
+type TipsyRequestController = {
+    signal?: AbortSignal;
+};
+type TipsyChatCompletionController = TipsyRequestController & {
+    onData?: (chunk: TipsyChatCompletionChunk) => void;
+    onComplete?: (result: TipsyChatCompletionResult) => void;
+};
+declare class TipsyBridgeClientError extends Error {
+    code: TipsyBridgeErrorCode;
+    constructor(error: TipsyBridgeError);
+}
+
+type TipsyStudioProviderProps = PropsWithChildren<{
+    targetOrigin?: string;
+}>;
+type TipsyStudioContextValue = {
+    isReady: boolean;
+    targetOrigin: string;
+    call: <M extends keyof TipsyBridgeRequestMap>(method: M, payload: TipsyBridgeRequestMap[M], controller?: M extends "chat.completions" ? TipsyChatCompletionController : TipsyRequestController) => Promise<TipsyBridgeResponseMap[M]>;
+};
+declare function TipsyStudioProvider({ children, targetOrigin, }: TipsyStudioProviderProps): react.FunctionComponentElement<react.ProviderProps<TipsyStudioContextValue | null>>;
+declare function useTipsyStudio(): TipsyStudioContextValue;
+declare function useTipsyChat(): {
+    completions(input: TipsyChatCompletionInput, controller?: TipsyChatCompletionController): Promise<TipsyChatCompletionResult>;
+};
+
+export { CHAT_COMPLETIONS_METHOD, TIPSY_BRIDGE_PROTOCOL, type TipsyAbortMessage, TipsyBridgeClientError, type TipsyBridgeError, type TipsyBridgeMessage, type TipsyBridgeRequestMap, type TipsyBridgeResponseMap, type TipsyChatCompletionChunk, type TipsyChatCompletionController, type TipsyChatCompletionInput, type TipsyChatCompletionRawChunk, type TipsyChatCompletionResult, type TipsyChatMessage, TipsyStudioProvider, type TipsyStudioProviderProps, useTipsyChat, useTipsyStudio };

package/dist/react.d.ts

@@ -1,4 +1,113 @@
-type UseMountedReturn = boolean;
-declare function useMounted(): UseMountedReturn;
+import * as react from 'react';
+import { PropsWithChildren } from 'react';
 
-export { type UseMountedReturn, useMounted };
+declare const TIPSY_BRIDGE_PROTOCOL = "tipsy-bridge-v1";
+declare const CHAT_COMPLETIONS_METHOD = "chat.completions";
+type TipsyRole = "system" | "user" | "assistant";
+type TipsyChatMessage = {
+    role: TipsyRole;
+    content: string;
+};
+type TipsyChatCompletionInput = {
+    messages: TipsyChatMessage[];
+    stream: true;
+};
+type TipsyChatCompletionRawChunk = {
+    type?: string;
+    choices?: Array<{
+        delta?: {
+            content?: string;
+            reasoning?: string;
+        };
+    }>;
+    isFinished?: boolean;
+    [key: string]: unknown;
+};
+type TipsyChatCompletionChunk = {
+    type: "stream";
+    chunk: string;
+    raw: TipsyChatCompletionRawChunk;
+    isFinished: false;
+};
+type TipsyChatCompletionResult = {
+    type: "done";
+    raw: TipsyChatCompletionRawChunk;
+    isFinished: true;
+};
+type TipsyBridgeErrorCode = "UNAUTHORIZED" | "BAD_REQUEST" | "NETWORK_ERROR" | "STREAM_PARSE_ERROR" | "ORIGIN_MISMATCH" | "UNSUPPORTED_METHOD" | "INTERNAL_ERROR";
+type TipsyBridgeError = {
+    code: TipsyBridgeErrorCode;
+    message: string;
+};
+type TipsyBridgeRequestMap = {
+    [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionInput;
+};
+type TipsyBridgeResponseMap = {
+    [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionResult;
+};
+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;
+    payload: TipsyBridgeRequestMap[M];
+};
+type TipsyStreamMessage = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:stream";
+    requestId: string;
+    payload: TipsyChatCompletionChunk;
+};
+type TipsyResponseMessage<M extends keyof TipsyBridgeResponseMap> = {
+    protocol: typeof TIPSY_BRIDGE_PROTOCOL;
+    type: "tipsy:response";
+    requestId: string;
+    payload: 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 | TipsyResponseMessage<keyof TipsyBridgeResponseMap> | TipsyErrorMessage | TipsyAbortMessage;
+type TipsyRequestController = {
+    signal?: AbortSignal;
+};
+type TipsyChatCompletionController = TipsyRequestController & {
+    onData?: (chunk: TipsyChatCompletionChunk) => void;
+    onComplete?: (result: TipsyChatCompletionResult) => void;
+};
+declare class TipsyBridgeClientError extends Error {
+    code: TipsyBridgeErrorCode;
+    constructor(error: TipsyBridgeError);
+}
+
+type TipsyStudioProviderProps = PropsWithChildren<{
+    targetOrigin?: string;
+}>;
+type TipsyStudioContextValue = {
+    isReady: boolean;
+    targetOrigin: string;
+    call: <M extends keyof TipsyBridgeRequestMap>(method: M, payload: TipsyBridgeRequestMap[M], controller?: M extends "chat.completions" ? TipsyChatCompletionController : TipsyRequestController) => Promise<TipsyBridgeResponseMap[M]>;
+};
+declare function TipsyStudioProvider({ children, targetOrigin, }: TipsyStudioProviderProps): react.FunctionComponentElement<react.ProviderProps<TipsyStudioContextValue | null>>;
+declare function useTipsyStudio(): TipsyStudioContextValue;
+declare function useTipsyChat(): {
+    completions(input: TipsyChatCompletionInput, controller?: TipsyChatCompletionController): Promise<TipsyChatCompletionResult>;
+};
+
+export { CHAT_COMPLETIONS_METHOD, TIPSY_BRIDGE_PROTOCOL, type TipsyAbortMessage, TipsyBridgeClientError, type TipsyBridgeError, type TipsyBridgeMessage, type TipsyBridgeRequestMap, type TipsyBridgeResponseMap, type TipsyChatCompletionChunk, type TipsyChatCompletionController, type TipsyChatCompletionInput, type TipsyChatCompletionRawChunk, type TipsyChatCompletionResult, type TipsyChatMessage, TipsyStudioProvider, type TipsyStudioProviderProps, useTipsyChat, useTipsyStudio };

package/dist/react.js

@@ -1,15 +1,249 @@
-import { useState, useEffect } from 'react';
+import { createContext, useMemo, useState, useRef, useEffect, createElement, useContext } from 'react';
 
-// src/hooks/useMounted.ts
-function useMounted() {
-  const [mounted, setMounted] = useState(false);
+// src/react.ts
+
+// src/bridge.ts
+var TIPSY_BRIDGE_PROTOCOL = "tipsy-bridge-v1";
+var TIPSY_INIT_RETRY_MS = 500;
+var CHAT_COMPLETIONS_METHOD = "chat.completions";
+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/react.ts
+var TipsyStudioContext = createContext(null);
+function TipsyStudioProvider({
+  children,
+  targetOrigin
+}) {
+  const resolvedTargetOrigin = useMemo(
+    () => normalizeTargetOrigin(targetOrigin),
+    [targetOrigin]
+  );
+  const [isReady, setIsReady] = useState(false);
+  const pendingRef = useRef(/* @__PURE__ */ new Map());
+  const readyRef = useRef(false);
+  const targetOriginRef = useRef(resolvedTargetOrigin);
+  useEffect(() => {
+    targetOriginRef.current = resolvedTargetOrigin;
+  }, [resolvedTargetOrigin]);
   useEffect(() => {
-    setMounted(true);
-    console.log("npm \u5305\u6D4B\u8BD5\u901A\u8FC7666");
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    let cancelled = false;
+    const rejectPending = (error) => {
+      const pendingRequests = Array.from(pendingRef.current.values());
+      pendingRef.current.clear();
+      for (const pending of pendingRequests) {
+        pending.reject(new TipsyBridgeClientError(error));
+      }
+    };
+    const postInit = () => {
+      if (cancelled || readyRef.current || window.parent === window) {
+        return;
+      }
+      const initMessage = {
+        protocol: TIPSY_BRIDGE_PROTOCOL,
+        type: "tipsy:init"
+      };
+      window.parent.postMessage(initMessage, targetOriginRef.current);
+    };
+    const intervalId = window.setInterval(postInit, TIPSY_INIT_RETRY_MS);
+    postInit();
+    const handleMessage = (event) => {
+      if (window.parent === window || event.source !== window.parent) {
+        return;
+      }
+      if (targetOriginRef.current !== "*" && event.origin !== targetOriginRef.current) {
+        return;
+      }
+      if (!isBridgeMessage(event.data)) {
+        return;
+      }
+      if (event.data.type === "tipsy:init:ack") {
+        readyRef.current = true;
+        setIsReady(true);
+        return;
+      }
+      if (event.data.type === "tipsy:error") {
+        if (!event.data.requestId) {
+          return;
+        }
+        const pending = pendingRef.current.get(event.data.requestId);
+        if (!pending) {
+          return;
+        }
+        pendingRef.current.delete(event.data.requestId);
+        pending.reject(new TipsyBridgeClientError(event.data.error));
+        return;
+      }
+      if (event.data.type === "tipsy:stream") {
+        const pending = pendingRef.current.get(event.data.requestId);
+        if (!pending || pending.method !== CHAT_COMPLETIONS_METHOD) {
+          return;
+        }
+        pending.onData?.(event.data.payload);
+        return;
+      }
+      if (event.data.type === "tipsy:response") {
+        const pending = pendingRef.current.get(event.data.requestId);
+        if (!pending) {
+          return;
+        }
+        pendingRef.current.delete(event.data.requestId);
+        pending.onComplete?.(event.data.payload);
+        pending.resolve(event.data.payload);
+      }
+    };
+    window.addEventListener("message", handleMessage);
+    return () => {
+      cancelled = true;
+      readyRef.current = false;
+      setIsReady(false);
+      window.clearInterval(intervalId);
+      window.removeEventListener("message", handleMessage);
+      rejectPending({
+        code: "NETWORK_ERROR",
+        message: "Tipsy bridge was disconnected."
+      });
+    };
   }, []);
-  return mounted;
+  const contextValue = useMemo(() => {
+    return {
+      isReady,
+      targetOrigin: resolvedTargetOrigin,
+      call(method, payload, controller) {
+        if (typeof window === "undefined" || window.parent === window) {
+          return Promise.reject(
+            new TipsyBridgeClientError({
+              code: "NETWORK_ERROR",
+              message: "Tipsy bridge is only available inside an iframe."
+            })
+          );
+        }
+        if (!readyRef.current) {
+          return Promise.reject(
+            new TipsyBridgeClientError({
+              code: "NETWORK_ERROR",
+              message: "Tipsy bridge is not ready."
+            })
+          );
+        }
+        const requestId = createRequestId();
+        return new Promise(
+          (resolve, reject) => {
+            const pending = {
+              method,
+              resolve: (value) => resolve(value),
+              reject,
+              onData: method === CHAT_COMPLETIONS_METHOD ? controller?.onData : void 0,
+              onComplete: method === CHAT_COMPLETIONS_METHOD ? controller?.onComplete : void 0
+            };
+            pendingRef.current.set(requestId, pending);
+            const abortSignal = controller?.signal;
+            const handleAbort = () => {
+              if (!pendingRef.current.has(requestId)) {
+                return;
+              }
+              pendingRef.current.delete(requestId);
+              const abortMessage = {
+                protocol: TIPSY_BRIDGE_PROTOCOL,
+                type: "tipsy:abort",
+                requestId
+              };
+              window.parent.postMessage(abortMessage, targetOriginRef.current);
+              reject(
+                new DOMException("The operation was aborted.", "AbortError")
+              );
+            };
+            if (abortSignal?.aborted) {
+              handleAbort();
+              return;
+            }
+            abortSignal?.addEventListener("abort", handleAbort, { once: true });
+            const requestMessage = {
+              protocol: TIPSY_BRIDGE_PROTOCOL,
+              type: "tipsy:request",
+              requestId,
+              method,
+              payload
+            };
+            window.parent.postMessage(requestMessage, targetOriginRef.current);
+          }
+        );
+      }
+    };
+  }, [isReady, resolvedTargetOrigin]);
+  return createElement(
+    TipsyStudioContext.Provider,
+    { value: contextValue },
+    children
+  );
+}
+function useTipsyStudio() {
+  const context = useContext(TipsyStudioContext);
+  if (!context) {
+    throw new Error("useTipsyStudio must be used within TipsyStudioProvider.");
+  }
+  return context;
+}
+function useTipsyChat() {
+  const studio = useTipsyStudio();
+  return useMemo(() => {
+    return {
+      completions(input, controller) {
+        return studio.call(CHAT_COMPLETIONS_METHOD, input, controller);
+      }
+    };
+  }, [studio]);
 }
 
-export { useMounted };
+export { CHAT_COMPLETIONS_METHOD, TIPSY_BRIDGE_PROTOCOL, TipsyBridgeClientError, TipsyStudioProvider, useTipsyChat, useTipsyStudio };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useMounted.ts"],"names":[],"mappings":";;;AAIO,SAAS,UAAA,GAA+B;AAC7C,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAS,KAAK,CAAA;AAE5C,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,UAAA,CAAW,IAAI,CAAA;AACf,IAAA,OAAA,CAAQ,IAAI,uCAAc,CAAA;AAAA,EAC5B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,OAAA;AACT","file":"react.js","sourcesContent":["import { useEffect, useState } from \"react\";\n\nexport type UseMountedReturn = boolean;\n\nexport function useMounted(): UseMountedReturn {\n  const [mounted, setMounted] = useState(false);\n\n  useEffect(() => {\n    setMounted(true);\n    console.log(\"npm 包测试通过666\");\n  }, []);\n\n  return mounted;\n}\n"]}
+{"version":3,"sources":["../src/bridge.ts","../src/react.ts"],"names":[],"mappings":";;;;;AAAO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,mBAAA,GAAsB,GAAA;AAC5B,IAAM,uBAAA,GAA0B;AAqIhC,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;;;AC9HA,IAAM,kBAAA,GAAqB,cAA8C,IAAI,CAAA;AAEtE,SAAS,mBAAA,CAAoB;AAAA,EAClC,QAAA;AAAA,EACA;AACF,CAAA,EAA6B;AAC3B,EAAA,MAAM,oBAAA,GAAuB,OAAA;AAAA,IAC3B,MAAM,sBAAsB,YAAY,CAAA;AAAA,IACxC,CAAC,YAAY;AAAA,GACf;AACA,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAS,KAAK,CAAA;AAC5C,EAAA,MAAM,UAAA,GAAa,MAAA,iBAAoC,IAAI,GAAA,EAAK,CAAA;AAChE,EAAA,MAAM,QAAA,GAAW,OAAO,KAAK,CAAA;AAC7B,EAAA,MAAM,eAAA,GAAkB,OAAO,oBAAoB,CAAA;AAEnD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,eAAA,CAAgB,OAAA,GAAU,oBAAA;AAAA,EAC5B,CAAA,EAAG,CAAC,oBAAoB,CAAC,CAAA;AAEzB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,MAAA,OAAO,MAAA;AAAA,IACT;AAEA,IAAA,IAAI,SAAA,GAAY,KAAA;AAEhB,IAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAA4B;AACjD,MAAA,MAAM,kBAAkB,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,QAAQ,CAAA;AAC9D,MAAA,UAAA,CAAW,QAAQ,KAAA,EAAM;AACzB,MAAA,KAAA,MAAW,WAAW,eAAA,EAAiB;AACrC,QAAA,OAAA,CAAQ,MAAA,CAAO,IAAI,sBAAA,CAAuB,KAAK,CAAC,CAAA;AAAA,MAClD;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,IAAI,SAAA,IAAa,QAAA,CAAS,OAAA,IAAW,MAAA,CAAO,WAAW,MAAA,EAAQ;AAC7D,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,WAAA,GAAgC;AAAA,QACpC,QAAA,EAAU,qBAAA;AAAA,QACV,IAAA,EAAM;AAAA,OACR;AAEA,MAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,WAAA,EAAa,eAAA,CAAgB,OAAO,CAAA;AAAA,IAChE,CAAA;AAEA,IAAA,MAAM,UAAA,GAAa,MAAA,CAAO,WAAA,CAAY,QAAA,EAAU,mBAAmB,CAAA;AACnE,IAAA,QAAA,EAAS;AAET,IAAA,MAAM,aAAA,GAAgB,CAAC,KAAA,KAAwB;AAC7C,MAAA,IAAI,OAAO,MAAA,KAAW,MAAA,IAAU,KAAA,CAAM,MAAA,KAAW,OAAO,MAAA,EAAQ;AAC9D,QAAA;AAAA,MACF;AAEA,MAAA,IACE,gBAAgB,OAAA,KAAY,GAAA,IAC5B,KAAA,CAAM,MAAA,KAAW,gBAAgB,OAAA,EACjC;AACA,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,CAAC,eAAA,CAAgB,KAAA,CAAM,IAAI,CAAA,EAAG;AAChC,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,gBAAA,EAAkB;AACxC,QAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AACnB,QAAA,UAAA,CAAW,IAAI,CAAA;AACf,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,aAAA,EAAe;AACrC,QAAA,IAAI,CAAC,KAAA,CAAM,IAAA,CAAK,SAAA,EAAW;AACzB,UAAA;AAAA,QACF;AAEA,QAAA,MAAM,UAAU,UAAA,CAAW,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,KAAK,SAAS,CAAA;AAC3D,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA;AAAA,QACF;AAEA,QAAA,UAAA,CAAW,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA;AAC9C,QAAA,OAAA,CAAQ,OAAO,IAAI,sBAAA,CAAuB,KAAA,CAAM,IAAA,CAAK,KAAK,CAAC,CAAA;AAC3D,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,cAAA,EAAgB;AACtC,QAAA,MAAM,UAAU,UAAA,CAAW,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,KAAK,SAAS,CAAA;AAC3D,QAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,MAAA,KAAW,uBAAA,EAAyB;AAC1D,UAAA;AAAA,QACF;AAEA,QAAA,OAAA,CAAQ,MAAA,GAAS,KAAA,CAAM,IAAA,CAAK,OAAO,CAAA;AACnC,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAA,KAAS,gBAAA,EAAkB;AACxC,QAAA,MAAM,UAAU,UAAA,CAAW,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,KAAK,SAAS,CAAA;AAC3D,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA;AAAA,QACF;AAEA,QAAA,UAAA,CAAW,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,IAAA,CAAK,SAAS,CAAA;AAC9C,QAAA,OAAA,CAAQ,UAAA,GAAa,KAAA,CAAM,IAAA,CAAK,OAAoC,CAAA;AACpE,QAAA,OAAA,CAAQ,OAAA,CAAQ,KAAA,CAAM,IAAA,CAAK,OAAoC,CAAA;AAAA,MACjE;AAAA,IACF,CAAA;AAEA,IAAA,MAAA,CAAO,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAEhD,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AACnB,MAAA,UAAA,CAAW,KAAK,CAAA;AAChB,MAAA,MAAA,CAAO,cAAc,UAAU,CAAA;AAC/B,MAAA,MAAA,CAAO,mBAAA,CAAoB,WAAW,aAAa,CAAA;AACnD,MAAA,aAAA,CAAc;AAAA,QACZ,IAAA,EAAM,eAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,YAAA,GAAe,QAAiC,MAAM;AAC1D,IAAA,OAAO;AAAA,MACL,OAAA;AAAA,MACA,YAAA,EAAc,oBAAA;AAAA,MACd,IAAA,CAAK,MAAA,EAAQ,OAAA,EAAS,UAAA,EAAY;AAChC,QAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,WAAW,MAAA,EAAQ;AAC7D,UAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,YACb,IAAI,sBAAA,CAAuB;AAAA,cACzB,IAAA,EAAM,eAAA;AAAA,cACN,OAAA,EAAS;AAAA,aACV;AAAA,WACH;AAAA,QACF;AAEA,QAAA,IAAI,CAAC,SAAS,OAAA,EAAS;AACrB,UAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,YACb,IAAI,sBAAA,CAAuB;AAAA,cACzB,IAAA,EAAM,eAAA;AAAA,cACN,OAAA,EAAS;AAAA,aACV;AAAA,WACH;AAAA,QACF;AAEA,QAAA,MAAM,YAAY,eAAA,EAAgB;AAElC,QAAA,OAAO,IAAI,OAAA;AAAA,UACT,CAAC,SAAS,MAAA,KAAW;AACnB,YAAA,MAAM,OAAA,GAA0B;AAAA,cAC9B,MAAA;AAAA,cACA,OAAA,EAAS,CAAC,KAAA,KACR,OAAA,CAAQ,KAA8C,CAAA;AAAA,cACxD,MAAA;AAAA,cACA,MAAA,EACE,MAAA,KAAW,uBAAA,GACN,UAAA,EACG,MAAA,GACJ,MAAA;AAAA,cACN,UAAA,EACE,MAAA,KAAW,uBAAA,GACN,UAAA,EACG,UAAA,GACJ;AAAA,aACR;AAEA,YAAA,UAAA,CAAW,OAAA,CAAQ,GAAA,CAAI,SAAA,EAAW,OAAO,CAAA;AAEzC,YAAA,MAAM,cAAc,UAAA,EAAY,MAAA;AAChC,YAAA,MAAM,cAAc,MAAM;AACxB,cAAA,IAAI,CAAC,UAAA,CAAW,OAAA,CAAQ,GAAA,CAAI,SAAS,CAAA,EAAG;AACtC,gBAAA;AAAA,cACF;AAEA,cAAA,UAAA,CAAW,OAAA,CAAQ,OAAO,SAAS,CAAA;AACnC,cAAA,MAAM,YAAA,GAAkC;AAAA,gBACtC,QAAA,EAAU,qBAAA;AAAA,gBACV,IAAA,EAAM,aAAA;AAAA,gBACN;AAAA,eACF;AACA,cAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,YAAA,EAAc,eAAA,CAAgB,OAAO,CAAA;AAC/D,cAAA,MAAA;AAAA,gBACE,IAAI,YAAA,CAAa,4BAAA,EAA8B,YAAY;AAAA,eAC7D;AAAA,YACF,CAAA;AAEA,YAAA,IAAI,aAAa,OAAA,EAAS;AACxB,cAAA,WAAA,EAAY;AACZ,cAAA;AAAA,YACF;AAEA,YAAA,WAAA,EAAa,iBAAiB,OAAA,EAAS,WAAA,EAAa,EAAE,IAAA,EAAM,MAAM,CAAA;AAElE,YAAA,MAAM,cAAA,GAAqD;AAAA,cACzD,QAAA,EAAU,qBAAA;AAAA,cACV,IAAA,EAAM,eAAA;AAAA,cACN,SAAA;AAAA,cACA,MAAA;AAAA,cACA;AAAA,aACF;AAEA,YAAA,MAAA,CAAO,MAAA,CAAO,WAAA,CAAY,cAAA,EAAgB,eAAA,CAAgB,OAAO,CAAA;AAAA,UACnE;AAAA,SACF;AAAA,MACF;AAAA,KACF;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,oBAAoB,CAAC,CAAA;AAElC,EAAA,OAAO,aAAA;AAAA,IACL,kBAAA,CAAmB,QAAA;AAAA,IACnB,EAAE,OAAO,YAAA,EAAa;AAAA,IACtB;AAAA,GACF;AACF;AAEO,SAAS,cAAA,GAAiB;AAC/B,EAAA,MAAM,OAAA,GAAU,WAAW,kBAAkB,CAAA;AAE7C,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,MAAM,yDAAyD,CAAA;AAAA,EAC3E;AAEA,EAAA,OAAO,OAAA;AACT;AAEO,SAAS,YAAA,GAAe;AAC7B,EAAA,MAAM,SAAS,cAAA,EAAe;AAE9B,EAAA,OAAO,QAAQ,MAAM;AACnB,IAAA,OAAO;AAAA,MACL,WAAA,CACE,OACA,UAAA,EACA;AACA,QAAA,OAAO,MAAA,CAAO,IAAA,CAAK,uBAAA,EAAyB,KAAA,EAAO,UAAU,CAAA;AAAA,MAC/D;AAAA,KACF;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AACb","file":"react.js","sourcesContent":["export const TIPSY_BRIDGE_PROTOCOL = \"tipsy-bridge-v1\";\nexport const TIPSY_INIT_RETRY_MS = 500;\nexport const CHAT_COMPLETIONS_METHOD = \"chat.completions\";\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\ntype TipsyRole = \"system\" | \"user\" | \"assistant\";\n\nexport type TipsyChatMessage = {\n  role: TipsyRole;\n  content: string;\n};\n\nexport type TipsyChatCompletionInput = {\n  messages: TipsyChatMessage[];\n  stream: true;\n};\n\nexport type TipsyChatCompletionRawChunk = {\n  type?: string;\n  choices?: Array<{\n    delta?: {\n      content?: string;\n      reasoning?: string;\n    };\n  }>;\n  isFinished?: boolean;\n  [key: string]: unknown;\n};\n\nexport type TipsyChatCompletionChunk = {\n  type: \"stream\";\n  chunk: string;\n  raw: TipsyChatCompletionRawChunk;\n  isFinished: false;\n};\n\nexport type TipsyChatCompletionResult = {\n  type: \"done\";\n  raw: TipsyChatCompletionRawChunk;\n  isFinished: true;\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  [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionInput;\n};\n\nexport type TipsyBridgeResponseMap = {\n  [CHAT_COMPLETIONS_METHOD]: TipsyChatCompletionResult;\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  payload: TipsyBridgeRequestMap[M];\n};\n\ntype TipsyStreamMessage = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:stream\";\n  requestId: string;\n  payload: TipsyChatCompletionChunk;\n};\n\ntype TipsyResponseMessage<M extends keyof TipsyBridgeResponseMap> = {\n  protocol: typeof TIPSY_BRIDGE_PROTOCOL;\n  type: \"tipsy:response\";\n  requestId: string;\n  payload: TipsyBridgeResponseMap[M];\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\n  | TipsyResponseMessage<keyof TipsyBridgeResponseMap>\n  | TipsyErrorMessage\n  | TipsyAbortMessage;\n\nexport type TipsyRequestController = {\n  signal?: AbortSignal;\n};\n\nexport type TipsyChatCompletionController = TipsyRequestController & {\n  onData?: (chunk: TipsyChatCompletionChunk) => void;\n  onComplete?: (result: TipsyChatCompletionResult) => 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  createElement,\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  CHAT_COMPLETIONS_METHOD,\n  TIPSY_BRIDGE_PROTOCOL,\n  TIPSY_INIT_RETRY_MS,\n  type TipsyAbortMessage,\n  type TipsyBridgeError,\n  type TipsyBridgeRequestMap,\n  type TipsyBridgeResponseMap,\n  type TipsyInitMessage,\n  type TipsyRequestController,\n  type TipsyRequestMessage,\n  TipsyBridgeClientError,\n  type TipsyChatCompletionChunk,\n  type TipsyChatCompletionController,\n  type TipsyChatCompletionInput,\n  type TipsyChatCompletionResult,\n  createRequestId,\n  isBridgeMessage,\n  normalizeTargetOrigin,\n} from \"./bridge\";\nexport {\n  CHAT_COMPLETIONS_METHOD,\n  TIPSY_BRIDGE_PROTOCOL,\n  TipsyBridgeClientError,\n  type TipsyAbortMessage,\n  type TipsyBridgeError,\n  type TipsyBridgeMessage,\n  type TipsyBridgeRequestMap,\n  type TipsyBridgeResponseMap,\n  type TipsyChatCompletionChunk,\n  type TipsyChatCompletionController,\n  type TipsyChatCompletionInput,\n  type TipsyChatCompletionRawChunk,\n  type TipsyChatCompletionResult,\n  type TipsyChatMessage,\n} from \"./bridge\";\n\nexport type TipsyStudioProviderProps = PropsWithChildren<{\n  targetOrigin?: string;\n}>;\n\ntype PendingRequest = {\n  method: keyof TipsyBridgeRequestMap;\n  resolve: (value: TipsyChatCompletionResult) => void;\n  reject: (reason?: unknown) => void;\n  onData?: (chunk: TipsyChatCompletionChunk) => void;\n  onComplete?: (result: TipsyChatCompletionResult) => void;\n};\n\ntype TipsyStudioContextValue = {\n  isReady: boolean;\n  targetOrigin: string;\n  call: <M extends keyof TipsyBridgeRequestMap>(\n    method: M,\n    payload: TipsyBridgeRequestMap[M],\n    controller?: M extends \"chat.completions\"\n      ? TipsyChatCompletionController\n      : TipsyRequestController,\n  ) => Promise<TipsyBridgeResponseMap[M]>;\n};\n\nconst TipsyStudioContext = createContext<TipsyStudioContextValue | null>(null);\n\nexport function TipsyStudioProvider({\n  children,\n  targetOrigin,\n}: TipsyStudioProviderProps) {\n  const resolvedTargetOrigin = useMemo(\n    () => normalizeTargetOrigin(targetOrigin),\n    [targetOrigin],\n  );\n  const [isReady, setIsReady] = useState(false);\n  const pendingRef = useRef<Map<string, PendingRequest>>(new Map());\n  const readyRef = useRef(false);\n  const targetOriginRef = useRef(resolvedTargetOrigin);\n\n  useEffect(() => {\n    targetOriginRef.current = resolvedTargetOrigin;\n  }, [resolvedTargetOrigin]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return undefined;\n    }\n\n    let cancelled = false;\n\n    const rejectPending = (error: TipsyBridgeError) => {\n      const pendingRequests = Array.from(pendingRef.current.values());\n      pendingRef.current.clear();\n      for (const pending of pendingRequests) {\n        pending.reject(new TipsyBridgeClientError(error));\n      }\n    };\n\n    const postInit = () => {\n      if (cancelled || readyRef.current || window.parent === window) {\n        return;\n      }\n\n      const initMessage: TipsyInitMessage = {\n        protocol: TIPSY_BRIDGE_PROTOCOL,\n        type: \"tipsy:init\",\n      };\n\n      window.parent.postMessage(initMessage, targetOriginRef.current);\n    };\n\n    const intervalId = window.setInterval(postInit, TIPSY_INIT_RETRY_MS);\n    postInit();\n\n    const handleMessage = (event: MessageEvent) => {\n      if (window.parent === window || event.source !== window.parent) {\n        return;\n      }\n\n      if (\n        targetOriginRef.current !== \"*\" &&\n        event.origin !== targetOriginRef.current\n      ) {\n        return;\n      }\n\n      if (!isBridgeMessage(event.data)) {\n        return;\n      }\n\n      if (event.data.type === \"tipsy:init:ack\") {\n        readyRef.current = true;\n        setIsReady(true);\n        return;\n      }\n\n      if (event.data.type === \"tipsy:error\") {\n        if (!event.data.requestId) {\n          return;\n        }\n\n        const pending = pendingRef.current.get(event.data.requestId);\n        if (!pending) {\n          return;\n        }\n\n        pendingRef.current.delete(event.data.requestId);\n        pending.reject(new TipsyBridgeClientError(event.data.error));\n        return;\n      }\n\n      if (event.data.type === \"tipsy:stream\") {\n        const pending = pendingRef.current.get(event.data.requestId);\n        if (!pending || pending.method !== CHAT_COMPLETIONS_METHOD) {\n          return;\n        }\n\n        pending.onData?.(event.data.payload);\n        return;\n      }\n\n      if (event.data.type === \"tipsy:response\") {\n        const pending = pendingRef.current.get(event.data.requestId);\n        if (!pending) {\n          return;\n        }\n\n        pendingRef.current.delete(event.data.requestId);\n        pending.onComplete?.(event.data.payload as TipsyChatCompletionResult);\n        pending.resolve(event.data.payload as TipsyChatCompletionResult);\n      }\n    };\n\n    window.addEventListener(\"message\", handleMessage);\n\n    return () => {\n      cancelled = true;\n      readyRef.current = false;\n      setIsReady(false);\n      window.clearInterval(intervalId);\n      window.removeEventListener(\"message\", handleMessage);\n      rejectPending({\n        code: \"NETWORK_ERROR\",\n        message: \"Tipsy bridge was disconnected.\",\n      });\n    };\n  }, []);\n\n  const contextValue = useMemo<TipsyStudioContextValue>(() => {\n    return {\n      isReady,\n      targetOrigin: resolvedTargetOrigin,\n      call(method, payload, controller) {\n        if (typeof window === \"undefined\" || window.parent === window) {\n          return Promise.reject(\n            new TipsyBridgeClientError({\n              code: \"NETWORK_ERROR\",\n              message: \"Tipsy bridge is only available inside an iframe.\",\n            }),\n          );\n        }\n\n        if (!readyRef.current) {\n          return Promise.reject(\n            new TipsyBridgeClientError({\n              code: \"NETWORK_ERROR\",\n              message: \"Tipsy bridge is not ready.\",\n            }),\n          );\n        }\n\n        const requestId = createRequestId();\n\n        return 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              onData:\n                method === CHAT_COMPLETIONS_METHOD\n                  ? (controller as TipsyChatCompletionController | undefined)\n                      ?.onData\n                  : undefined,\n              onComplete:\n                method === CHAT_COMPLETIONS_METHOD\n                  ? (controller as TipsyChatCompletionController | undefined)\n                      ?.onComplete\n                  : undefined,\n            };\n\n            pendingRef.current.set(requestId, pending);\n\n            const abortSignal = controller?.signal;\n            const handleAbort = () => {\n              if (!pendingRef.current.has(requestId)) {\n                return;\n              }\n\n              pendingRef.current.delete(requestId);\n              const abortMessage: TipsyAbortMessage = {\n                protocol: TIPSY_BRIDGE_PROTOCOL,\n                type: \"tipsy:abort\",\n                requestId,\n              };\n              window.parent.postMessage(abortMessage, targetOriginRef.current);\n              reject(\n                new DOMException(\"The operation was aborted.\", \"AbortError\"),\n              );\n            };\n\n            if (abortSignal?.aborted) {\n              handleAbort();\n              return;\n            }\n\n            abortSignal?.addEventListener(\"abort\", handleAbort, { once: true });\n\n            const requestMessage: TipsyRequestMessage<typeof method> = {\n              protocol: TIPSY_BRIDGE_PROTOCOL,\n              type: \"tipsy:request\",\n              requestId,\n              method,\n              payload,\n            };\n\n            window.parent.postMessage(requestMessage, targetOriginRef.current);\n          },\n        );\n      },\n    };\n  }, [isReady, resolvedTargetOrigin]);\n\n  return createElement(\n    TipsyStudioContext.Provider,\n    { value: contextValue },\n    children,\n  );\n}\n\nexport function useTipsyStudio() {\n  const context = useContext(TipsyStudioContext);\n\n  if (!context) {\n    throw new Error(\"useTipsyStudio must be used within TipsyStudioProvider.\");\n  }\n\n  return context;\n}\n\nexport function useTipsyChat() {\n  const studio = useTipsyStudio();\n\n  return useMemo(() => {\n    return {\n      completions(\n        input: TipsyChatCompletionInput,\n        controller?: TipsyChatCompletionController,\n      ) {\n        return studio.call(CHAT_COMPLETIONS_METHOD, input, controller);\n      },\n    };\n  }, [studio]);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tipsy-studio/sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "React sdk for Tipsy Studio apps.",
   "license": "MIT",
   "type": "module",