skybridge 0.0.0-dev.4eb7532 → 0.0.0-dev.50c7544

package/dist/src/web/hooks/use-files.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-files.test.js

@@ -0,0 +1,29 @@
+import { renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useFiles } from "./use-files.js";
+describe("useLocale", () => {
+    const OpenaiMock = {
+        uploadFile: vi.fn(),
+        downloadFile: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.stubGlobal("openai", OpenaiMock);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    const dummyFile = new File([], "test.txt");
+    it("should upload a file to ChatGPT", () => {
+        const { result } = renderHook(() => useFiles());
+        result.current.upload(dummyFile);
+        expect(OpenaiMock.uploadFile).toHaveBeenCalledWith(dummyFile);
+    });
+    it("should download a file from ChatGPT", () => {
+        const fileId = "123";
+        const { result } = renderHook(() => useFiles());
+        result.current.download({ fileId });
+        expect(OpenaiMock.downloadFile).toHaveBeenCalledWith({ fileId });
+    });
+});
+//# sourceMappingURL=use-files.test.js.map

package/dist/src/web/hooks/use-files.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-files.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-files.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,UAAU,GAAG;QACjB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;QACnB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;KACtB,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE3C,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,KAAK,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-layout.d.ts

@@ -0,0 +1,22 @@
+import type { SafeArea, Theme } from "../types.js";
+export type LayoutState = {
+    theme: Theme;
+    maxHeight: number;
+    safeArea: SafeArea;
+};
+/**
+ * Hook for accessing layout and visual environment information.
+ * These values may change on resize or theme toggle.
+ *
+ * @example
+ * ```tsx
+ * const { theme, maxHeight, safeArea } = useLayout();
+ *
+ * // Apply theme-aware styling
+ * const backgroundColor = theme === "dark" ? "#1a1a1a" : "#ffffff";
+ *
+ * // Respect safe area insets
+ * const paddingTop = safeArea.insets.top;
+ * ```
+ */
+export declare function useLayout(): LayoutState;

package/dist/src/web/hooks/use-layout.js

@@ -0,0 +1,23 @@
+import { useAppsSdkBridge, useBridge } from "../bridges/index.js";
+/**
+ * Hook for accessing layout and visual environment information.
+ * These values may change on resize or theme toggle.
+ *
+ * @example
+ * ```tsx
+ * const { theme, maxHeight, safeArea } = useLayout();
+ *
+ * // Apply theme-aware styling
+ * const backgroundColor = theme === "dark" ? "#1a1a1a" : "#ffffff";
+ *
+ * // Respect safe area insets
+ * const paddingTop = safeArea.insets.top;
+ * ```
+ */
+export function useLayout() {
+    const theme = useBridge("theme");
+    const maxHeight = useAppsSdkBridge("maxHeight");
+    const safeArea = useBridge("safeArea");
+    return { theme, maxHeight, safeArea };
+}
+//# sourceMappingURL=use-layout.js.map

package/dist/src/web/hooks/use-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-layout.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AASlE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAEvC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACxC,CAAC"}

package/dist/src/web/hooks/use-layout.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-layout.test.js

@@ -0,0 +1,46 @@
+import { renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useLayout } from "./use-layout.js";
+describe("useLayout", () => {
+    let OpenaiMock;
+    beforeEach(() => {
+        OpenaiMock = {
+            theme: "light",
+            maxHeight: 500,
+            safeArea: { insets: { top: 0, bottom: 0, left: 0, right: 0 } },
+        };
+        vi.stubGlobal("openai", OpenaiMock);
+        vi.stubGlobal("skybridge", { hostType: "apps-sdk" });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    it("should return theme, maxHeight, and safeArea from window.openai", () => {
+        const { result } = renderHook(() => useLayout());
+        expect(result.current.theme).toBe("light");
+        expect(result.current.maxHeight).toBe(500);
+        expect(result.current.safeArea).toEqual({
+            insets: { top: 0, bottom: 0, left: 0, right: 0 },
+        });
+    });
+    it("should return dark theme when set to dark", () => {
+        OpenaiMock.theme = "dark";
+        const { result } = renderHook(() => useLayout());
+        expect(result.current.theme).toBe("dark");
+    });
+    it("should return different maxHeight when set", () => {
+        OpenaiMock.maxHeight = 800;
+        const { result } = renderHook(() => useLayout());
+        expect(result.current.maxHeight).toBe(800);
+    });
+    it("should return safeArea with insets when set", () => {
+        OpenaiMock.safeArea = {
+            insets: { top: 44, bottom: 34, left: 0, right: 0 },
+        };
+        const { result } = renderHook(() => useLayout());
+        expect(result.current.safeArea.insets.top).toBe(44);
+        expect(result.current.safeArea.insets.bottom).toBe(34);
+    });
+});
+//# sourceMappingURL=use-layout.test.js.map

package/dist/src/web/hooks/use-layout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-layout.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-layout.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,IAAI,UAIH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;SAC/D,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACtC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;SACjD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC;QAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,UAAU,CAAC,QAAQ,GAAG;YACpB,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;SACnD,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-open-external.d.ts

@@ -0,0 +1 @@
+export declare function useOpenExternal(): (href: string) => void;

package/dist/src/web/hooks/use-open-external.js

@@ -0,0 +1,6 @@
+export function useOpenExternal() {
+    return (href) => {
+        window.openai.openExternal({ href });
+    };
+}
+//# sourceMappingURL=use-open-external.js.map

package/dist/src/web/hooks/use-open-external.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-open-external.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-open-external.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,IAAY,EAAE,EAAE;QACtB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/web/hooks/use-open-external.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-open-external.test.js

@@ -0,0 +1,24 @@
+import { renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useOpenExternal } from "./use-open-external.js";
+describe("useOpenExternal", () => {
+    let openExternalMock;
+    beforeEach(() => {
+        openExternalMock = vi.fn();
+        vi.stubGlobal("openai", {
+            openExternal: openExternalMock,
+        });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    it("should return a function that calls window.openai.openExternal with the href", () => {
+        const { result } = renderHook(() => useOpenExternal());
+        const href = "https://example.com";
+        result.current(href);
+        expect(openExternalMock).toHaveBeenCalledTimes(1);
+        expect(openExternalMock).toHaveBeenCalledWith({ href });
+    });
+});
+//# sourceMappingURL=use-open-external.test.js.map

package/dist/src/web/hooks/use-open-external.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-open-external.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-open-external.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,gBAA0C,CAAC;IAE/C,UAAU,CAAC,GAAG,EAAE;QACd,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtB,YAAY,EAAE,gBAAgB;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;QAEvD,MAAM,IAAI,GAAG,qBAAqB,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAErB,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-openai-global.d.ts

@@ -0,0 +1,3 @@
+import type { OpenAiProperties } from "../types.js";
+/** @deprecated Use `useAppsSdkBridge` instead */
+export declare function useOpenAiGlobal<K extends keyof OpenAiProperties>(key: K): OpenAiProperties[K];

package/dist/src/web/hooks/use-openai-global.js

@@ -0,0 +1,6 @@
+import { useAppsSdkBridge } from "../bridges/index.js";
+/** @deprecated Use `useAppsSdkBridge` instead */
+export function useOpenAiGlobal(key) {
+    return useAppsSdkBridge(key);
+}
+//# sourceMappingURL=use-openai-global.js.map

package/dist/src/web/hooks/use-openai-global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-openai-global.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-openai-global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAC7B,GAAM;IAEN,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/web/hooks/use-request-modal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Triggers a modal containing the widget rendered in display mode "modal"
+ */
+export declare function useRequestModal(): (options: {
+    title: string;
+}) => void;

package/dist/src/web/hooks/use-request-modal.js

@@ -0,0 +1,9 @@
+/**
+ * Triggers a modal containing the widget rendered in display mode "modal"
+ */
+export function useRequestModal() {
+    return (options) => {
+        window.openai.requestModal(options);
+    };
+}
+//# sourceMappingURL=use-request-modal.js.map

package/dist/src/web/hooks/use-request-modal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-request-modal.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-request-modal.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,OAA0B,EAAE,EAAE;QACpC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/web/hooks/use-request-modal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-request-modal.test.js

@@ -0,0 +1,24 @@
+import { renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useRequestModal } from "./use-request-modal.js";
+describe("useRequestModal", () => {
+    let requestModalMock;
+    beforeEach(() => {
+        requestModalMock = vi.fn();
+        vi.stubGlobal("openai", {
+            requestModal: requestModalMock,
+        });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    it("should return a function that calls window.openai.requestModal with the options", () => {
+        const { result } = renderHook(() => useRequestModal());
+        const options = { title: "Test Modal" };
+        result.current(options);
+        expect(requestModalMock).toHaveBeenCalledTimes(1);
+        expect(requestModalMock).toHaveBeenCalledWith(options);
+    });
+});
+//# sourceMappingURL=use-request-modal.test.js.map

package/dist/src/web/hooks/use-request-modal.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-request-modal.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-request-modal.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,gBAA0C,CAAC;IAE/C,UAAU,CAAC,GAAG,EAAE;QACd,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE;YACtB,YAAY,EAAE,gBAAgB;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;QAEvD,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExB,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-send-follow-up-message.d.ts

@@ -0,0 +1 @@
+export declare function useSendFollowUpMessage(): (prompt: string) => Promise<void>;

package/dist/src/web/hooks/use-send-follow-up-message.js

@@ -0,0 +1,11 @@
+import { useCallback } from "react";
+export function useSendFollowUpMessage() {
+    const sendFollowUpMessage = useCallback(async (prompt) => {
+        if (!window.openai?.sendFollowUpMessage) {
+            throw new Error("window.openai.sendFollowUpMessage is not available");
+        }
+        return window.openai.sendFollowUpMessage({ prompt });
+    }, []);
+    return sendFollowUpMessage;
+}
+//# sourceMappingURL=use-send-follow-up-message.js.map

package/dist/src/web/hooks/use-send-follow-up-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-send-follow-up-message.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-send-follow-up-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC,MAAM,UAAU,sBAAsB;IACpC,MAAM,mBAAmB,GAAG,WAAW,CACrC,KAAK,EAAE,MAAc,EAAiB,EAAE;QACtC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC,EACD,EAAE,CACH,CAAC;IAEF,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/src/web/hooks/use-tool-info.d.ts

@@ -0,0 +1,25 @@
+import type { UnknownObject } from "../types.js";
+export type ToolPendingState<ToolInput extends UnknownObject> = {
+    status: "pending";
+    isPending: true;
+    isSuccess: false;
+    input: ToolInput;
+    output: undefined;
+    responseMetadata: undefined;
+};
+export type ToolSuccessState<ToolInput extends UnknownObject, ToolOutput extends UnknownObject, ToolResponseMetadata extends UnknownObject> = {
+    status: "success";
+    isPending: false;
+    isSuccess: true;
+    input: ToolInput;
+    output: ToolOutput;
+    responseMetadata: ToolResponseMetadata;
+};
+export type ToolState<ToolInput extends UnknownObject, ToolOutput extends UnknownObject, ToolResponseMetadata extends UnknownObject> = ToolPendingState<ToolInput> | ToolSuccessState<ToolInput, ToolOutput, ToolResponseMetadata>;
+type ToolSignature = {
+    input: UnknownObject;
+    output: UnknownObject;
+    responseMetadata: UnknownObject;
+};
+export declare function useToolInfo<TS extends Partial<ToolSignature> = Record<string, never>>(): ToolState<UnknownObject & TS["input"], UnknownObject & TS["output"], UnknownObject & TS["responseMetadata"]>;
+export {};

package/dist/src/web/hooks/use-tool-info.js

@@ -0,0 +1,20 @@
+import { useEffect, useState } from "react";
+import { useAppsSdkBridge } from "../bridges/index.js";
+export function useToolInfo() {
+    const [status, setStatus] = useState("pending");
+    const input = useAppsSdkBridge("toolInput");
+    const output = useAppsSdkBridge("toolOutput");
+    const responseMetadata = useAppsSdkBridge("toolResponseMetadata");
+    useEffect(() => {
+        setStatus(output === null && responseMetadata === null ? "pending" : "success");
+    }, [output, responseMetadata]);
+    return {
+        input,
+        status,
+        isPending: status === "pending",
+        isSuccess: status === "success",
+        output,
+        responseMetadata,
+    };
+}
+//# sourceMappingURL=use-tool-info.js.map

package/dist/src/web/hooks/use-tool-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tool-info.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAuCvD,MAAM,UAAU,WAAW;IAGzB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAwB,SAAS,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IAElE,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CACP,MAAM,KAAK,IAAI,IAAI,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACrE,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAM/B,OAAO;QACL,KAAK;QACL,MAAM;QACN,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,MAAM;QACN,gBAAgB;KACqB,CAAC;AAC1C,CAAC"}

package/dist/src/web/hooks/use-tool-info.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-tool-info.test-d.js

@@ -0,0 +1,73 @@
+import { expectTypeOf, test } from "vitest";
+import { useToolInfo } from "./use-tool-info.js";
+test("useToolInfo - TypeScript typing", () => {
+    test("should have correct types when no generic parameter is provided", () => {
+        const result = useToolInfo();
+        expectTypeOf(result.status);
+        expectTypeOf(result.isPending);
+        expectTypeOf(result.isSuccess);
+        expectTypeOf(result.input);
+    });
+    test("should correctly type input, output, and responseMetadata with explicit ToolSignature", () => {
+        const result = useToolInfo();
+        expectTypeOf(result.input);
+        // When pending, output and responseMetadata should be undefined
+        if (result.status === "pending") {
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+        // When success, output and responseMetadata should be defined
+        if (result.status === "success") {
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+    });
+    test("should correctly narrow types based on status discriminated union", () => {
+        const result = useToolInfo();
+        // Test type narrowing
+        if (result.isPending) {
+            expectTypeOf(result.status);
+            expectTypeOf(result.isPending);
+            expectTypeOf(result.isSuccess);
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+        if (result.isSuccess) {
+            expectTypeOf(result.status);
+            expectTypeOf(result.isPending);
+            expectTypeOf(result.isSuccess);
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+        if (result.status === "pending") {
+            expectTypeOf(result.input);
+            expectTypeOf(result.isPending);
+            expectTypeOf(result.isSuccess);
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+        if (result.status === "success") {
+            expectTypeOf(result.input);
+            expectTypeOf(result.isPending);
+            expectTypeOf(result.isSuccess);
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+    });
+    test("should handle partial ToolSignature with only input specified", () => {
+        const result = useToolInfo();
+        expectTypeOf(result.input);
+        if (result.status === "success") {
+            expectTypeOf(result.output);
+            expectTypeOf(result.responseMetadata);
+        }
+    });
+    test("should handle ToolSignature with only output specified", () => {
+        const result = useToolInfo();
+        expectTypeOf(result.input);
+        if (result.status === "success") {
+            expectTypeOf(result.output);
+        }
+    });
+});
+//# sourceMappingURL=use-tool-info.test-d.js.map

package/dist/src/web/hooks/use-tool-info.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tool-info.test-d.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-info.test-d.ts"],"names":[],"mappings":"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"}

package/dist/src/web/hooks/use-tool-info.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-tool-info.test.js

@@ -0,0 +1,60 @@
+import { act, fireEvent, renderHook, waitFor } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, } from "../types.js";
+import { useToolInfo } from "./use-tool-info.js";
+describe("useToolInfo", () => {
+    let OpenaiMock;
+    beforeEach(() => {
+        OpenaiMock = {
+            toolInput: { name: "pokemon", args: { name: "pikachu" } },
+            toolOutput: null,
+            toolResponseMetadata: null,
+        };
+        vi.stubGlobal("openai", OpenaiMock);
+        vi.stubGlobal("skybridge", { hostType: "apps-sdk" });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    it("should return toolInput on initial mount window.openai", () => {
+        const { result } = renderHook(() => useToolInfo());
+        expect(result.current).toMatchObject({
+            input: { name: "pokemon", args: { name: "pikachu" } },
+            status: "pending",
+            isPending: true,
+            isSuccess: false,
+        });
+    });
+    it("should eventually return tool output and response metadata once tool call completes", async () => {
+        const toolOutput = {
+            name: "pikachu",
+            color: "yellow",
+            description: "When several of these POKéMON gather, their\felectricity could build and cause lightning storms.",
+        };
+        const toolResponseMetadata = { id: 12 };
+        const { result } = renderHook(() => useToolInfo());
+        act(() => {
+            OpenaiMock.toolOutput = toolOutput;
+            OpenaiMock.toolResponseMetadata = toolResponseMetadata;
+            fireEvent(window, new SetGlobalsEvent(SET_GLOBALS_EVENT_TYPE, {
+                detail: {
+                    globals: {
+                        toolOutput,
+                        toolResponseMetadata,
+                    },
+                },
+            }));
+        });
+        await waitFor(() => {
+            expect(result.current).toMatchObject({
+                status: "success",
+                isPending: false,
+                isSuccess: true,
+                output: toolOutput,
+                responseMetadata: toolResponseMetadata,
+            });
+        });
+    });
+});
+//# sourceMappingURL=use-tool-info.test.js.map

package/dist/src/web/hooks/use-tool-info.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tool-info.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-info.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAEL,sBAAsB,EACtB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,UAGH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;YACzD,UAAU,EAAE,IAAI;YAChB,oBAAoB,EAAE,IAAI;SAC3B,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAEnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC;YACnC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;YACrD,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACnG,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,QAAQ;YACf,WAAW,EACT,kGAAkG;SACrG,CAAC;QACF,MAAM,oBAAoB,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAEnD,GAAG,CAAC,GAAG,EAAE;YACP,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC;YACnC,UAAU,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;YACvD,SAAS,CACP,MAAM,EACN,IAAI,eAAe,CAAC,sBAAsB,EAAE;gBAC1C,MAAM,EAAE;oBACN,OAAO,EAAE;wBACP,UAAU;wBACV,oBAAoB;qBACrB;iBACF;aACF,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC;gBACnC,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,UAAU;gBAClB,gBAAgB,EAAE,oBAAoB;aACvC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-user.d.ts

@@ -0,0 +1,18 @@
+import type { UserAgent } from "../types.js";
+export type UserState = {
+    locale: string;
+    userAgent: UserAgent;
+};
+/**
+ * Hook for accessing session-stable user information.
+ * These values are set once at initialization and do not change during the session.
+ *
+ * @example
+ * ```tsx
+ * const { locale, userAgent } = useUser();
+ *
+ * // Access device type
+ * const isMobile = userAgent.device.type === "mobile";
+ * ```
+ */
+export declare function useUser(): UserState;

package/dist/src/web/hooks/use-user.js

@@ -0,0 +1,19 @@
+import { useAppsSdkBridge, useBridge } from "../bridges/index.js";
+/**
+ * Hook for accessing session-stable user information.
+ * These values are set once at initialization and do not change during the session.
+ *
+ * @example
+ * ```tsx
+ * const { locale, userAgent } = useUser();
+ *
+ * // Access device type
+ * const isMobile = userAgent.device.type === "mobile";
+ * ```
+ */
+export function useUser() {
+    const locale = useBridge("locale");
+    const userAgent = useAppsSdkBridge("userAgent");
+    return { locale, userAgent };
+}
+//# sourceMappingURL=use-user.js.map

package/dist/src/web/hooks/use-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-user.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQlE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/src/web/hooks/use-user.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/web/hooks/use-user.test.js

@@ -0,0 +1,44 @@
+import { renderHook } from "@testing-library/react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useUser } from "./use-user.js";
+describe("useUser", () => {
+    let OpenaiMock;
+    beforeEach(() => {
+        OpenaiMock = {
+            locale: "en-US",
+            userAgent: {
+                device: { type: "desktop" },
+                capabilities: { hover: true, touch: false },
+            },
+        };
+        vi.stubGlobal("openai", OpenaiMock);
+        vi.stubGlobal("skybridge", { hostType: "apps-sdk" });
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetAllMocks();
+    });
+    it("should return locale and userAgent from window.openai", () => {
+        const { result } = renderHook(() => useUser());
+        expect(result.current.locale).toBe("en-US");
+        expect(result.current.userAgent).toEqual({
+            device: { type: "desktop" },
+            capabilities: { hover: true, touch: false },
+        });
+    });
+    it("should return mobile userAgent when set to mobile", () => {
+        OpenaiMock.userAgent = {
+            device: { type: "mobile" },
+            capabilities: { hover: false, touch: true },
+        };
+        const { result } = renderHook(() => useUser());
+        expect(result.current.userAgent.device.type).toBe("mobile");
+        expect(result.current.userAgent.capabilities.touch).toBe(true);
+    });
+    it("should return different locale when set", () => {
+        OpenaiMock.locale = "es-ES";
+        const { result } = renderHook(() => useUser());
+        expect(result.current.locale).toBe("es-ES");
+    });
+});
+//# sourceMappingURL=use-user.test.js.map

package/dist/src/web/hooks/use-user.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-user.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-user.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,UAGH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,MAAM,EAAE,OAAO;YACf,SAAS,EAAE;gBACT,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC3B,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;aAC5C;SACF,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YACvC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3B,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,UAAU,CAAC,SAAS,GAAG;YACrB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5C,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/web/hooks/use-widget-state.d.ts

@@ -0,0 +1,4 @@
+import { type SetStateAction } from "react";
+import type { UnknownObject } from "../types.js";
+export declare function useWidgetState<T extends UnknownObject>(defaultState: T | (() => T)): readonly [T, (state: SetStateAction<T>) => void];
+export declare function useWidgetState<T extends UnknownObject>(defaultState?: T | (() => T | null) | null): readonly [T | null, (state: SetStateAction<T | null>) => void];

package/dist/src/web/hooks/use-widget-state.js

@@ -0,0 +1,32 @@
+import { useCallback, useEffect, useState } from "react";
+import { useAppsSdkBridge } from "../bridges/index.js";
+import { filterWidgetContext, injectWidgetContext } from "../helpers/state.js";
+export function useWidgetState(defaultState) {
+    const widgetStateFromWindow = useAppsSdkBridge("widgetState");
+    const [widgetState, _setWidgetState] = useState(() => {
+        if (widgetStateFromWindow !== null) {
+            return filterWidgetContext(widgetStateFromWindow);
+        }
+        return typeof defaultState === "function"
+            ? defaultState()
+            : (defaultState ?? null);
+    });
+    useEffect(() => {
+        // Fixes openai implementation bug
+        if (widgetStateFromWindow !== null) {
+            _setWidgetState(filterWidgetContext(widgetStateFromWindow));
+        }
+    }, [widgetStateFromWindow]);
+    const setWidgetState = useCallback((state) => {
+        _setWidgetState((prevState) => {
+            const newState = typeof state === "function" ? state(prevState) : state;
+            const stateToSet = injectWidgetContext(newState);
+            if (stateToSet !== null) {
+                window.openai.setWidgetState(stateToSet);
+            }
+            return filterWidgetContext(stateToSet);
+        });
+    }, []);
+    return [widgetState, setWidgetState];
+}
+//# sourceMappingURL=use-widget-state.js.map