sunpeak 0.16.27 → 0.16.28

package/dist/discovery-Du4LHrih.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-Du4LHrih.js","names":[],"sources":["../src/lib/discovery.ts"],"sourcesContent":["/**\n * Discovery utilities for auto-discovering resources and simulations\n *\n * These helpers process the results of import.meta.glob() calls to extract\n * keys, build component maps, and connect simulations to resources.\n *\n * The glob calls themselves must remain in the template (Vite compile-time),\n * but all the processing logic lives here for easy updates across templates.\n *\n * Node.js utilities (findResourceDirs, findToolFiles, etc.) can be used\n * by CLI commands for build-time and runtime discovery.\n */\n\nimport type { Simulation } from '../types/simulation.js';\n\n/**\n * Convert a kebab-case string to PascalCase\n * @example toPascalCase('review') // 'Review'\n * @example toPascalCase('album-art') // 'AlbumArt'\n */\nexport function toPascalCase(str: string): string {\n  return str\n    .split('-')\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n\n/**\n * Extract the resource key from a resource file path.\n * Matches {name}.tsx (e.g., './albums/albums.tsx' → 'albums')\n */\nexport function extractResourceKey(path: string): string | undefined {\n  const match = path.match(/([^/]+)\\.tsx$/);\n  return match ? match[1] : undefined;\n}\n\n/**\n * Extract the simulation key from a simulation file path.\n * Matches any *.json file (e.g., './show-albums.json' → 'show-albums')\n */\nexport function extractSimulationKey(path: string): string | undefined {\n  const match = path.match(/([^/]+)\\.json$/);\n  return match ? match[1] : undefined;\n}\n\n/**\n * Find the best matching resource key for a simulation key.\n * Matches the longest resource name that is a prefix of the simulation key.\n * @example findResourceKey('review-diff', ['review', 'carousel']) // 'review'\n * @example findResourceKey('albums', ['albums', 'review']) // 'albums'\n */\nexport function findResourceKey(simulationKey: string, resourceKeys: string[]): string | undefined {\n  // Sort by length descending to find longest match first\n  const sorted = [...resourceKeys].sort((a, b) => b.length - a.length);\n  for (const resourceKey of sorted) {\n    if (simulationKey === resourceKey || simulationKey.startsWith(resourceKey + '-')) {\n      return resourceKey;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Get the expected component export name for a resource\n * @example getComponentName('review') // 'ReviewResource'\n * @example getComponentName('album-art') // 'AlbumArtResource'\n */\nexport function getComponentName(resourceKey: string): string {\n  return `${toPascalCase(resourceKey)}Resource`;\n}\n\n// --- Glob processing helpers ---\n\ntype GlobModules = Record<string, unknown>;\n\n/**\n * Process resource component modules from import.meta.glob() result.\n * Extracts components and exports them with PascalCase names.\n *\n * @example\n * const modules = import.meta.glob('./*\\/*.tsx', { eager: true });\n * export default createResourceExports(modules);\n */\nexport function createResourceExports(modules: GlobModules): Record<string, React.ComponentType> {\n  const resources: Record<string, React.ComponentType> = {};\n\n  for (const [path, module] of Object.entries(modules)) {\n    const key = extractResourceKey(path);\n    if (!key) continue;\n\n    const exportName = getComponentName(key);\n    const mod = module as Record<string, unknown>;\n\n    // Try default export first, then named export matching the expected name\n    const component = mod.default ?? mod[exportName];\n\n    // Accept functions (regular components) or objects (forwardRef/memo components)\n    if (component && (typeof component === 'function' || typeof component === 'object')) {\n      resources[exportName] = component as React.ComponentType;\n    }\n  }\n\n  return resources;\n}\n\n/**\n * Build a resource metadata map from import.meta.glob() result.\n * Used for connecting simulations to their resource definitions.\n *\n * @example\n * const modules = import.meta.glob('../src/resources/*\\/*.tsx', { eager: true });\n * const resourcesMap = buildResourceMap(modules);\n */\nexport function buildResourceMap<T>(modules: GlobModules): Map<string, T> {\n  const map = new Map<string, T>();\n\n  for (const [path, module] of Object.entries(modules)) {\n    const key = extractResourceKey(path);\n    if (key) {\n      map.set(key, (module as { resource: T }).resource);\n    }\n  }\n\n  return map;\n}\n\n/**\n * Options for building simulations from discovered modules\n */\nexport interface BuildSimulationsOptions<TResource, TSimulation> {\n  /** Glob result of simulation JSON files */\n  simulationModules: GlobModules;\n  /** Map of resource key -> resource metadata */\n  resourcesMap: Map<string, TResource>;\n  /** Map of component name -> React component */\n  resourceComponents: Record<string, React.ComponentType>;\n  /** Create the final simulation object */\n  createSimulation: (\n    simulationKey: string,\n    simulationData: unknown,\n    resource: TResource,\n    resourceComponent: React.ComponentType\n  ) => TSimulation;\n  /** Optional warning handler for missing resources */\n  onMissingResource?: (simulationKey: string, expectedPrefix: string) => void;\n}\n\n/**\n * Build simulations by connecting simulation data with resources and components.\n * This is the main orchestration function for dev server bootstrap.\n */\nexport function buildSimulations<TResource, TSimulation>(\n  options: BuildSimulationsOptions<TResource, TSimulation>\n): Record<string, TSimulation> {\n  const {\n    simulationModules,\n    resourcesMap,\n    resourceComponents,\n    createSimulation,\n    onMissingResource = (key, prefix) =>\n      console.warn(\n        `No matching resource found for simulation \"${key}\". ` +\n          `Expected a resource file like src/resources/${prefix}/${prefix}.tsx`\n      ),\n  } = options;\n\n  const resourceKeys = Array.from(resourcesMap.keys());\n  const simulations: Record<string, TSimulation> = {};\n\n  for (const [path, module] of Object.entries(simulationModules)) {\n    const simulationKey = extractSimulationKey(path);\n    if (!simulationKey) continue;\n\n    const simulationData = (module as { default: unknown }).default;\n\n    // Find matching resource\n    const resourceKey = findResourceKey(simulationKey, resourceKeys);\n    if (!resourceKey) {\n      onMissingResource(simulationKey, simulationKey.split('-')[0]);\n      continue;\n    }\n\n    const resource = resourcesMap.get(resourceKey)!;\n\n    // Get component\n    const componentName = getComponentName(resourceKey);\n    const resourceComponent = resourceComponents[componentName];\n\n    if (!resourceComponent) {\n      console.warn(\n        `Resource component \"${componentName}\" not found for resource \"${resourceKey}\". ` +\n          `Make sure src/resources/${resourceKey}/${resourceKey}.tsx exists with a default export.`\n      );\n      continue;\n    }\n\n    simulations[simulationKey] = createSimulation(\n      simulationKey,\n      simulationData,\n      resource,\n      resourceComponent\n    );\n  }\n\n  return simulations;\n}\n\n// --- Dev server helpers ---\n\n/**\n * Resource metadata from resource .tsx files\n */\nexport interface ResourceMetadata {\n  name: string;\n  [key: string]: unknown;\n}\n\n/**\n * Options for building dev simulations\n */\nexport interface BuildDevSimulationsOptions {\n  /** Glob result of simulation JSON files */\n  simulationModules: GlobModules;\n  /** Resource components map from src/resources/index.ts */\n  resourceComponents: Record<string, React.ComponentType>;\n  /** Glob result of tool files: import.meta.glob('src/tools/*.ts', { eager: true }) */\n  toolModules: GlobModules;\n  /** Glob result of resource .tsx files from src/resources/ */\n  resourceModules: GlobModules;\n}\n\n/**\n * Tool metadata extracted from a tool module's `tool` export\n */\ninterface ToolModuleInfo {\n  tool: Record<string, unknown>;\n  /** Resource name string from tool.resource (undefined for tools without UI) */\n  resourceName?: string;\n}\n\n/**\n * Build simulations for the dev server from glob results.\n * Simulation JSON has `\"tool\": \"tool-name\"` string referencing a tool file.\n * Tool files have `resource: 'name'` linking to a resource discovered from resourceModules.\n */\nexport function buildDevSimulations(\n  options: BuildDevSimulationsOptions\n): Record<string, Simulation> {\n  const { simulationModules, resourceComponents, toolModules, resourceModules } = options;\n\n  // Build resource metadata map from resource modules (keyed by resource name)\n  const resourceMetaByName = new Map<string, ResourceMetadata>();\n  const resourceKeyByName = new Map<string, string>();\n  for (const [path, module] of Object.entries(resourceModules)) {\n    const key = extractResourceKey(path);\n    if (!key) continue;\n    const mod = module as { resource?: ResourceMetadata };\n    if (mod.resource) {\n      // Use explicit name if provided, otherwise derive from directory key\n      const name = mod.resource.name ?? key;\n      resourceMetaByName.set(name, { ...mod.resource, name });\n      resourceKeyByName.set(name, key);\n    }\n  }\n\n  // Build tool map from tool modules\n  const toolsMap = new Map<string, ToolModuleInfo>();\n  if (toolModules) {\n    for (const [path, module] of Object.entries(toolModules)) {\n      const nameMatch = path.match(/([^/]+)\\.ts$/);\n      if (!nameMatch) continue;\n      const mod = module as { tool?: Record<string, unknown> };\n      if (mod.tool) {\n        const resourceName = mod.tool.resource as string | undefined;\n        toolsMap.set(nameMatch[1], { tool: mod.tool, resourceName });\n      }\n    }\n  }\n\n  const simulations: Record<string, Simulation> = {};\n\n  for (const [path, module] of Object.entries(simulationModules)) {\n    const simKey = extractSimulationKey(path);\n    if (!simKey) continue;\n\n    const simulationData = (module as { default: Record<string, unknown> }).default;\n\n    const toolName =\n      typeof simulationData.tool === 'string' ? (simulationData.tool as string) : simKey;\n    const toolInfo = toolsMap.get(toolName);\n    if (!toolInfo) {\n      console.warn(\n        `Tool \"${toolName}\" not found for simulation \"${simKey}\". ` +\n          `Make sure src/tools/${toolName}.ts exists.`\n      );\n      continue;\n    }\n\n    // Look up resource metadata by name (if tool has a UI)\n    const resourceMeta = toolInfo.resourceName\n      ? resourceMetaByName.get(toolInfo.resourceName)\n      : undefined;\n    const resourceKey = toolInfo.resourceName\n      ? resourceKeyByName.get(toolInfo.resourceName)\n      : undefined;\n\n    if (toolInfo.resourceName && (!resourceMeta || !resourceKey)) {\n      console.warn(\n        `Resource \"${toolInfo.resourceName}\" not found for tool \"${toolName}\". ` +\n          `Make sure a resource with name \"${toolInfo.resourceName}\" exists in src/resources/.`\n      );\n      continue;\n    }\n\n    // Build resource block only for UI tools\n    let resourceBlock: Pick<Simulation, 'resource' | 'resourceUrl'> = {};\n    if (resourceKey && resourceMeta) {\n      const componentName = getComponentName(resourceKey);\n      const resourceComponent = resourceComponents[componentName];\n\n      if (!resourceComponent) {\n        console.warn(`Resource component \"${componentName}\" not found for tool \"${toolName}\".`);\n        continue;\n      }\n\n      resourceBlock = {\n        resource: {\n          uri: `ui://${resourceKey}`,\n          name: resourceKey,\n          ...(resourceMeta.title != null ? { title: resourceMeta.title as string } : {}),\n          ...(resourceMeta.description != null\n            ? { description: resourceMeta.description as string }\n            : {}),\n          ...(resourceMeta.mimeType != null ? { mimeType: resourceMeta.mimeType as string } : {}),\n          ...(resourceMeta._meta != null\n            ? { _meta: resourceMeta._meta as Record<string, unknown> }\n            : {}),\n        },\n        resourceUrl: `/.sunpeak/resource-loader.html?component=${componentName}`,\n      };\n    }\n\n    simulations[simKey] = {\n      name: simKey,\n      userMessage: simulationData.userMessage as string | undefined,\n      tool: {\n        name: toolName,\n        description: (toolInfo.tool.description as string) ?? '',\n        inputSchema: { type: 'object' as const },\n        ...(toolInfo.tool.title != null ? { title: toolInfo.tool.title as string } : {}),\n        ...(toolInfo.tool.annotations != null\n          ? { annotations: toolInfo.tool.annotations as Record<string, unknown> }\n          : {}),\n        ...(toolInfo.tool._meta != null\n          ? { _meta: toolInfo.tool._meta as Record<string, unknown> }\n          : {}),\n      },\n      ...resourceBlock,\n      toolInput: simulationData.toolInput as Record<string, unknown> | undefined,\n      toolResult: simulationData.toolResult as Simulation['toolResult'],\n      serverTools: simulationData.serverTools as Simulation['serverTools'],\n    };\n  }\n\n  return simulations;\n}\n\n// --- Node.js utilities for CLI commands ---\n// These utilities use standard Node.js APIs and can be imported by build/push/mcp commands.\n\n/**\n * Information about a discovered resource directory\n */\nexport interface ResourceDirInfo {\n  /** Resource key (directory name), e.g., 'albums', 'carousel' */\n  key: string;\n  /** Full path to the resource directory */\n  dir: string;\n  /** Full path to the main resource file (tsx or json depending on context) */\n  resourcePath: string;\n}\n\n/**\n * File system operations interface for dependency injection in tests\n */\nexport interface FsOps {\n  readdirSync: (\n    path: string,\n    options: { withFileTypes: true }\n  ) => Array<{ name: string; isDirectory: () => boolean }>;\n  existsSync: (path: string) => boolean;\n}\n\n/**\n * Find all resource directories in a base directory.\n * Each valid resource directory contains a file matching the expected pattern.\n *\n * @param baseDir - Base directory to scan (e.g., 'src/resources' or 'dist')\n * @param filePattern - Function to generate expected filename from resource key\n * @param fs - File system operations (for testing)\n *\n * @example\n * // Find source resources (tsx files)\n * const resources = findResourceDirs('src/resources', key => `${key}.tsx`);\n *\n * @example\n * // Find built resources (js files)\n * const resources = findResourceDirs('dist', key => `${key}.js`);\n */\nexport function findResourceDirs(\n  baseDir: string,\n  filePattern: (key: string) => string,\n  fs: FsOps\n): ResourceDirInfo[] {\n  if (!fs.existsSync(baseDir)) {\n    return [];\n  }\n\n  const entries = fs.readdirSync(baseDir, { withFileTypes: true });\n\n  return entries\n    .filter((entry) => entry.isDirectory())\n    .map((entry) => {\n      const key = entry.name;\n      const dir = `${baseDir}/${key}`;\n      const resourcePath = `${dir}/${filePattern(key)}`;\n\n      if (!fs.existsSync(resourcePath)) {\n        return null;\n      }\n\n      return { key, dir, resourcePath };\n    })\n    .filter((info): info is ResourceDirInfo => info !== null);\n}\n\n// --- Tool files + flat simulations discovery ---\n\n/**\n * Information about a discovered tool file\n */\nexport interface ToolFileInfo {\n  /** Tool name derived from filename (e.g., 'show-albums') */\n  name: string;\n  /** Full path to the tool file */\n  path: string;\n}\n\n/**\n * Find all tool files in a tools directory.\n * Matches *.ts files directly in the directory (not recursive).\n *\n * @example\n * findToolFiles('src/tools', fs)\n * // [{ name: 'show-albums', path: 'src/tools/show-albums.ts' }]\n */\nexport function findToolFiles(\n  toolsDir: string,\n  fs: Pick<FsOps, 'readdirSync' | 'existsSync'>\n): ToolFileInfo[] {\n  if (!fs.existsSync(toolsDir)) {\n    return [];\n  }\n\n  const entries = fs.readdirSync(toolsDir, { withFileTypes: true });\n\n  return entries\n    .filter(\n      (entry) =>\n        !entry.isDirectory() && entry.name.endsWith('.ts') && !entry.name.endsWith('.test.ts')\n    )\n    .map((entry) => ({\n      name: entry.name.replace(/\\.ts$/, ''),\n      path: `${toolsDir}/${entry.name}`,\n    }));\n}\n\n/**\n * Information about a discovered simulation file (flat convention)\n */\nexport interface SimulationFileInfo {\n  /** Filename without extension (e.g., 'show-albums') */\n  name: string;\n  /** Full path to the simulation file */\n  path: string;\n}\n\n/**\n * Find all simulation JSON files in a flat simulations directory.\n * Matches any *.json file directly in the directory.\n *\n * @example\n * findSimulationFilesFlat('tests/simulations', fs)\n * // [{ name: 'show-albums', path: 'tests/simulations/show-albums.json' }]\n */\nexport function findSimulationFilesFlat(\n  simulationsDir: string,\n  fs: Pick<FsOps, 'readdirSync' | 'existsSync'>\n): SimulationFileInfo[] {\n  if (!fs.existsSync(simulationsDir)) {\n    return [];\n  }\n\n  const entries = fs.readdirSync(simulationsDir, { withFileTypes: true });\n\n  return entries\n    .filter((entry) => !entry.isDirectory() && entry.name.endsWith('.json'))\n    .map((entry) => ({\n      name: entry.name.replace(/\\.json$/, ''),\n      path: `${simulationsDir}/${entry.name}`,\n    }));\n}\n"],"mappings":"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"}

package/dist/host/chatgpt/index.cjs

@@ -1,81 +1,187 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const React = require("react");
-const useApp = require("../../use-app-D09O2swh.cjs");
+require("../../chunk-9hOWP6kD.cjs");
+require("../../protocol-jbxhzcnS.cjs");
+const require_use_app = require("../../use-app-D2h-aiyr.cjs");
+let react = require("react");
+//#region src/host/chatgpt/openai-types.ts
+/**
+* Get the `window.openai` runtime if available.
+* Returns `undefined` outside of ChatGPT or in SSR.
+*/
 function getOpenAIRuntime() {
-  if (typeof window !== "undefined" && "openai" in window) {
-    return window.openai;
-  }
-  return void 0;
+	if (typeof window !== "undefined" && "openai" in window) return window.openai;
 }
+//#endregion
+//#region src/host/chatgpt/use-create-file.ts
+/**
+* Upload a file from the app UI into the ChatGPT conversation.
+*
+* Wraps `window.openai.uploadFile` which is only available inside ChatGPT.
+* Supported formats: `image/png`, `image/jpeg`, `image/webp`.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useUploadFile } from 'sunpeak/host/chatgpt';
+*
+* function ImageUploader() {
+*   const uploadFile = useUploadFile();
+*
+*   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {
+*     const file = e.currentTarget.files?.[0];
+*     if (!file) return;
+*     const { fileId } = await uploadFile(file);
+*     console.log('Uploaded:', fileId);
+*   };
+*
+*   return <input type="file" accept="image/*" onChange={handleChange} />;
+* }
+* ```
+*/
 function useUploadFile() {
-  const app = useApp.useApp();
-  return React.useCallback(
-    async (file) => {
-      if (!app) {
-        throw new Error("[useUploadFile] App not connected");
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.uploadFile) {
-        throw new Error("[useUploadFile] window.openai.uploadFile not available");
-      }
-      return runtime.uploadFile(file);
-    },
-    [app]
-  );
+	const app = require_use_app.useApp();
+	return (0, react.useCallback)(async (file) => {
+		if (!app) throw new Error("[useUploadFile] App not connected");
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.uploadFile) throw new Error("[useUploadFile] window.openai.uploadFile not available");
+		return runtime.uploadFile(file);
+	}, [app]);
 }
+//#endregion
+//#region src/host/chatgpt/use-file-download.ts
+/**
+* Get a temporary download URL for a file by its ID.
+*
+* @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works
+* across all hosts via the MCP Apps SDK `app.downloadFile()` method.
+*
+* Wraps `window.openai.getFileDownloadUrl` which is only available inside
+* ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}
+* or file IDs received in tool parameters.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';
+*
+* function FilePreview({ fileId }: { fileId: string }) {
+*   const getFileDownloadUrl = useGetFileDownloadUrl();
+*   const [src, setSrc] = useState<string>();
+*
+*   useEffect(() => {
+*     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));
+*   }, [fileId, getFileDownloadUrl]);
+*
+*   return src ? <img src={src} /> : <p>Loading...</p>;
+* }
+* ```
+*/
 function useGetFileDownloadUrl() {
-  const app = useApp.useApp();
-  return React.useCallback(
-    async (params) => {
-      if (!app) {
-        throw new Error("[useGetFileDownloadUrl] App not connected");
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.getFileDownloadUrl) {
-        throw new Error("[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available");
-      }
-      return runtime.getFileDownloadUrl(params);
-    },
-    [app]
-  );
+	const app = require_use_app.useApp();
+	return (0, react.useCallback)(async (params) => {
+		if (!app) throw new Error("[useGetFileDownloadUrl] App not connected");
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.getFileDownloadUrl) throw new Error("[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available");
+		return runtime.getFileDownloadUrl(params);
+	}, [app]);
 }
+//#endregion
+//#region src/host/chatgpt/use-open-modal.ts
+/**
+* Open a host-controlled modal in ChatGPT.
+*
+* Wraps `window.openai.requestModal` which is only available inside ChatGPT.
+* Pass a `template` URL to load alternate UI content in the modal, or omit
+* it to reuse the current UI.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useRequestModal } from 'sunpeak/host/chatgpt';
+*
+* function CheckoutButton() {
+*   const requestModal = useRequestModal();
+*
+*   return (
+*     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>
+*       Checkout
+*     </button>
+*   );
+* }
+* ```
+*/
 function useRequestModal() {
-  const app = useApp.useApp();
-  return React.useCallback(
-    async (params) => {
-      if (!app) {
-        console.warn("[useRequestModal] App not connected");
-        return;
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.requestModal) {
-        throw new Error("[useRequestModal] window.openai.requestModal not available");
-      }
-      return runtime.requestModal(params);
-    },
-    [app]
-  );
+	const app = require_use_app.useApp();
+	return (0, react.useCallback)(async (params) => {
+		if (!app) {
+			console.warn("[useRequestModal] App not connected");
+			return;
+		}
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.requestModal) throw new Error("[useRequestModal] window.openai.requestModal not available");
+		return runtime.requestModal(params);
+	}, [app]);
 }
+//#endregion
+//#region src/host/chatgpt/use-request-checkout.ts
+/**
+* Trigger the ChatGPT instant checkout flow.
+*
+* Wraps `window.openai.requestCheckout` which is only available inside
+* ChatGPT. Opens the host checkout UI, handles payment display, and
+* resolves with the finalized order. Rejects on error or user cancel.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useRequestCheckout } from 'sunpeak/host/chatgpt';
+*
+* function BuyButton() {
+*   const requestCheckout = useRequestCheckout();
+*
+*   const handleBuy = async () => {
+*     try {
+*       const order = await requestCheckout({
+*         id: 'session-1',
+*         payment_provider: {
+*           provider: 'stripe',
+*           merchant_id: 'acct_xxx',
+*           supported_payment_methods: ['card', 'apple_pay'],
+*         },
+*         status: 'ready_for_payment',
+*         currency: 'USD',
+*         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],
+*         links: [],
+*         payment_mode: 'live',
+*       });
+*       console.log('Order completed:', order.id);
+*     } catch {
+*       console.log('Checkout cancelled or failed');
+*     }
+*   };
+*
+*   return <button onClick={handleBuy}>Buy Now</button>;
+* }
+* ```
+*/
 function useRequestCheckout() {
-  const app = useApp.useApp();
-  return React.useCallback(
-    async (session) => {
-      if (!app) {
-        throw new Error("[useRequestCheckout] App not connected");
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.requestCheckout) {
-        throw new Error("[useRequestCheckout] window.openai.requestCheckout not available");
-      }
-      return runtime.requestCheckout(session);
-    },
-    [app]
-  );
+	const app = require_use_app.useApp();
+	return (0, react.useCallback)(async (session) => {
+		if (!app) throw new Error("[useRequestCheckout] App not connected");
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.requestCheckout) throw new Error("[useRequestCheckout] window.openai.requestCheckout not available");
+		return runtime.requestCheckout(session);
+	}, [app]);
 }
+//#endregion
 exports.getOpenAIRuntime = getOpenAIRuntime;
 exports.useGetFileDownloadUrl = useGetFileDownloadUrl;
 exports.useRequestCheckout = useRequestCheckout;
 exports.useRequestModal = useRequestModal;
 exports.useUploadFile = useUploadFile;
-//# sourceMappingURL=index.cjs.map
+
+//# sourceMappingURL=index.cjs.map

package/dist/host/chatgpt/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/host/chatgpt/openai-types.ts","../../../src/host/chatgpt/use-create-file.ts","../../../src/host/chatgpt/use-file-download.ts","../../../src/host/chatgpt/use-open-modal.ts","../../../src/host/chatgpt/use-request-checkout.ts"],"sourcesContent":["/**\n * TypeScript declarations for the `window.openai` ChatGPT runtime.\n *\n * These APIs are available inside ChatGPT-hosted iframes and provide\n * platform-specific capabilities beyond the MCP Apps standard.\n *\n * @see https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt\n */\n\nexport interface OpenAIUploadFileResult {\n  fileId: string;\n}\n\nexport interface OpenAIFileDownloadUrlResult {\n  downloadUrl: string;\n}\n\nexport interface OpenAIRequestModalParams {\n  /** URL of an alternate UI template to load in the modal. Omit to reuse the current UI. */\n  template?: string;\n  /** Arbitrary params forwarded to the modal content. */\n  params?: Record<string, unknown>;\n}\n\nexport interface OpenAICheckoutPaymentProvider {\n  provider: string;\n  merchant_id: string;\n  supported_payment_methods: string[];\n}\n\nexport interface OpenAICheckoutTotal {\n  type: string;\n  display_text: string;\n  amount: number;\n}\n\nexport interface OpenAICheckoutLink {\n  type: 'terms_of_use' | 'privacy_policy' | string;\n  url: string;\n}\n\nexport interface OpenAICheckoutSession {\n  id: string;\n  payment_provider: OpenAICheckoutPaymentProvider;\n  status: 'ready_for_payment';\n  currency: string;\n  totals: OpenAICheckoutTotal[];\n  links: OpenAICheckoutLink[];\n  payment_mode: 'live' | 'test';\n}\n\nexport interface OpenAICheckoutOrder {\n  id: string;\n  checkout_session_id: string;\n  status: 'completed' | string;\n  permalink_url?: string;\n}\n\n/**\n * The `window.openai` runtime object injected by ChatGPT into hosted iframes.\n */\nexport interface OpenAIRuntime {\n  // --- File APIs ---\n  uploadFile?(file: File): Promise<OpenAIUploadFileResult>;\n  getFileDownloadUrl?(params: { fileId: string }): Promise<OpenAIFileDownloadUrlResult>;\n\n  // --- Modal API ---\n  requestModal?(params: OpenAIRequestModalParams): Promise<void>;\n\n  // --- Checkout API ---\n  requestCheckout?(session: OpenAICheckoutSession): Promise<OpenAICheckoutOrder>;\n\n  // --- Display ---\n  requestClose?(): void;\n  requestDisplayMode?(params: { mode: 'inline' | 'PiP' | 'fullscreen' }): Promise<void>;\n\n  // --- Messaging ---\n  sendFollowUpMessage?(params: { prompt: string }): void;\n\n  // --- Other ---\n  openExternal?(params: { href: string }): void;\n}\n\n/**\n * Get the `window.openai` runtime if available.\n * Returns `undefined` outside of ChatGPT or in SSR.\n */\nexport function getOpenAIRuntime(): OpenAIRuntime | undefined {\n  if (typeof window !== 'undefined' && 'openai' in window) {\n    return (window as unknown as { openai: OpenAIRuntime }).openai;\n  }\n  return undefined;\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIUploadFileResult } from './openai-types';\n\nexport type { OpenAIUploadFileResult as CreateFileResult };\n\n/**\n * Upload a file from the app UI into the ChatGPT conversation.\n *\n * Wraps `window.openai.uploadFile` which is only available inside ChatGPT.\n * Supported formats: `image/png`, `image/jpeg`, `image/webp`.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useUploadFile } from 'sunpeak/host/chatgpt';\n *\n * function ImageUploader() {\n *   const uploadFile = useUploadFile();\n *\n *   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {\n *     const file = e.currentTarget.files?.[0];\n *     if (!file) return;\n *     const { fileId } = await uploadFile(file);\n *     console.log('Uploaded:', fileId);\n *   };\n *\n *   return <input type=\"file\" accept=\"image/*\" onChange={handleChange} />;\n * }\n * ```\n */\nexport function useUploadFile(): (file: File) => Promise<OpenAIUploadFileResult> {\n  const app = useApp();\n  return useCallback(\n    async (file: File) => {\n      if (!app) {\n        throw new Error('[useUploadFile] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.uploadFile) {\n        throw new Error('[useUploadFile] window.openai.uploadFile not available');\n      }\n      return runtime.uploadFile(file);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIFileDownloadUrlResult } from './openai-types';\n\nexport type { OpenAIFileDownloadUrlResult as FileDownloadUrlResult };\n\n/**\n * Get a temporary download URL for a file by its ID.\n *\n * @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works\n * across all hosts via the MCP Apps SDK `app.downloadFile()` method.\n *\n * Wraps `window.openai.getFileDownloadUrl` which is only available inside\n * ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}\n * or file IDs received in tool parameters.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';\n *\n * function FilePreview({ fileId }: { fileId: string }) {\n *   const getFileDownloadUrl = useGetFileDownloadUrl();\n *   const [src, setSrc] = useState<string>();\n *\n *   useEffect(() => {\n *     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));\n *   }, [fileId, getFileDownloadUrl]);\n *\n *   return src ? <img src={src} /> : <p>Loading...</p>;\n * }\n * ```\n */\nexport function useGetFileDownloadUrl(): (params: {\n  fileId: string;\n}) => Promise<OpenAIFileDownloadUrlResult> {\n  const app = useApp();\n  return useCallback(\n    async (params: { fileId: string }) => {\n      if (!app) {\n        throw new Error('[useGetFileDownloadUrl] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.getFileDownloadUrl) {\n        throw new Error('[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available');\n      }\n      return runtime.getFileDownloadUrl(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIRequestModalParams } from './openai-types';\n\nexport type { OpenAIRequestModalParams as OpenModalParams };\n\n/**\n * Open a host-controlled modal in ChatGPT.\n *\n * Wraps `window.openai.requestModal` which is only available inside ChatGPT.\n * Pass a `template` URL to load alternate UI content in the modal, or omit\n * it to reuse the current UI.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestModal } from 'sunpeak/host/chatgpt';\n *\n * function CheckoutButton() {\n *   const requestModal = useRequestModal();\n *\n *   return (\n *     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>\n *       Checkout\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useRequestModal(): (params: OpenAIRequestModalParams) => Promise<void> {\n  const app = useApp();\n  return useCallback(\n    async (params: OpenAIRequestModalParams) => {\n      if (!app) {\n        console.warn('[useRequestModal] App not connected');\n        return;\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestModal) {\n        throw new Error('[useRequestModal] window.openai.requestModal not available');\n      }\n      return runtime.requestModal(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport {\n  getOpenAIRuntime,\n  type OpenAICheckoutSession,\n  type OpenAICheckoutOrder,\n} from './openai-types';\n\nexport type { OpenAICheckoutSession as CheckoutSession };\nexport type { OpenAICheckoutOrder as CheckoutOrder };\n\n/**\n * Trigger the ChatGPT instant checkout flow.\n *\n * Wraps `window.openai.requestCheckout` which is only available inside\n * ChatGPT. Opens the host checkout UI, handles payment display, and\n * resolves with the finalized order. Rejects on error or user cancel.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestCheckout } from 'sunpeak/host/chatgpt';\n *\n * function BuyButton() {\n *   const requestCheckout = useRequestCheckout();\n *\n *   const handleBuy = async () => {\n *     try {\n *       const order = await requestCheckout({\n *         id: 'session-1',\n *         payment_provider: {\n *           provider: 'stripe',\n *           merchant_id: 'acct_xxx',\n *           supported_payment_methods: ['card', 'apple_pay'],\n *         },\n *         status: 'ready_for_payment',\n *         currency: 'USD',\n *         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],\n *         links: [],\n *         payment_mode: 'live',\n *       });\n *       console.log('Order completed:', order.id);\n *     } catch {\n *       console.log('Checkout cancelled or failed');\n *     }\n *   };\n *\n *   return <button onClick={handleBuy}>Buy Now</button>;\n * }\n * ```\n */\nexport function useRequestCheckout(): (\n  session: OpenAICheckoutSession\n) => Promise<OpenAICheckoutOrder> {\n  const app = useApp();\n  return useCallback(\n    async (session: OpenAICheckoutSession) => {\n      if (!app) {\n        throw new Error('[useRequestCheckout] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestCheckout) {\n        throw new Error('[useRequestCheckout] window.openai.requestCheckout not available');\n      }\n      return runtime.requestCheckout(session);\n    },\n    [app]\n  );\n}\n"],"names":["useApp","useCallback"],"mappings":";;;;AAuFO,SAAS,mBAA8C;AAC5D,MAAI,OAAO,WAAW,eAAe,YAAY,QAAQ;AACvD,WAAQ,OAAgD;AAAA,EAC1D;AACA,SAAO;AACT;AC5DO,SAAS,gBAAiE;AAC/E,QAAM,MAAMA,OAAAA,OAAA;AACZ,SAAOC,MAAAA;AAAAA,IACL,OAAO,SAAe;AACpB,UAAI,CAAC,KAAK;AACR,cAAM,IAAI,MAAM,mCAAmC;AAAA,MACrD;AACA,YAAM,UAAU,iBAAA;AAChB,UAAI,CAAC,SAAS,YAAY;AACxB,cAAM,IAAI,MAAM,wDAAwD;AAAA,MAC1E;AACA,aAAO,QAAQ,WAAW,IAAI;AAAA,IAChC;AAAA,IACA,CAAC,GAAG;AAAA,EAAA;AAER;ACbO,SAAS,wBAE2B;AACzC,QAAM,MAAMD,OAAAA,OAAA;AACZ,SAAOC,MAAAA;AAAAA,IACL,OAAO,WAA+B;AACpC,UAAI,CAAC,KAAK;AACR,cAAM,IAAI,MAAM,2CAA2C;AAAA,MAC7D;AACA,YAAM,UAAU,iBAAA;AAChB,UAAI,CAAC,SAAS,oBAAoB;AAChC,cAAM,IAAI,MAAM,wEAAwE;AAAA,MAC1F;AACA,aAAO,QAAQ,mBAAmB,MAAM;AAAA,IAC1C;AAAA,IACA,CAAC,GAAG;AAAA,EAAA;AAER;ACrBO,SAAS,kBAAuE;AACrF,QAAM,MAAMD,OAAAA,OAAA;AACZ,SAAOC,MAAAA;AAAAA,IACL,OAAO,WAAqC;AAC1C,UAAI,CAAC,KAAK;AACR,gBAAQ,KAAK,qCAAqC;AAClD;AAAA,MACF;AACA,YAAM,UAAU,iBAAA;AAChB,UAAI,CAAC,SAAS,cAAc;AAC1B,cAAM,IAAI,MAAM,4DAA4D;AAAA,MAC9E;AACA,aAAO,QAAQ,aAAa,MAAM;AAAA,IACpC;AAAA,IACA,CAAC,GAAG;AAAA,EAAA;AAER;ACMO,SAAS,qBAEkB;AAChC,QAAM,MAAMD,OAAAA,OAAA;AACZ,SAAOC,MAAAA;AAAAA,IACL,OAAO,YAAmC;AACxC,UAAI,CAAC,KAAK;AACR,cAAM,IAAI,MAAM,wCAAwC;AAAA,MAC1D;AACA,YAAM,UAAU,iBAAA;AAChB,UAAI,CAAC,SAAS,iBAAiB;AAC7B,cAAM,IAAI,MAAM,kEAAkE;AAAA,MACpF;AACA,aAAO,QAAQ,gBAAgB,OAAO;AAAA,IACxC;AAAA,IACA,CAAC,GAAG;AAAA,EAAA;AAER;;;;;;"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/host/chatgpt/openai-types.ts","../../../src/host/chatgpt/use-create-file.ts","../../../src/host/chatgpt/use-file-download.ts","../../../src/host/chatgpt/use-open-modal.ts","../../../src/host/chatgpt/use-request-checkout.ts"],"sourcesContent":["/**\n * TypeScript declarations for the `window.openai` ChatGPT runtime.\n *\n * These APIs are available inside ChatGPT-hosted iframes and provide\n * platform-specific capabilities beyond the MCP Apps standard.\n *\n * @see https://developers.openai.com/apps-sdk/mcp-apps-in-chatgpt\n */\n\nexport interface OpenAIUploadFileResult {\n  fileId: string;\n}\n\nexport interface OpenAIFileDownloadUrlResult {\n  downloadUrl: string;\n}\n\nexport interface OpenAIRequestModalParams {\n  /** URL of an alternate UI template to load in the modal. Omit to reuse the current UI. */\n  template?: string;\n  /** Arbitrary params forwarded to the modal content. */\n  params?: Record<string, unknown>;\n}\n\nexport interface OpenAICheckoutPaymentProvider {\n  provider: string;\n  merchant_id: string;\n  supported_payment_methods: string[];\n}\n\nexport interface OpenAICheckoutTotal {\n  type: string;\n  display_text: string;\n  amount: number;\n}\n\nexport interface OpenAICheckoutLink {\n  type: 'terms_of_use' | 'privacy_policy' | string;\n  url: string;\n}\n\nexport interface OpenAICheckoutSession {\n  id: string;\n  payment_provider: OpenAICheckoutPaymentProvider;\n  status: 'ready_for_payment';\n  currency: string;\n  totals: OpenAICheckoutTotal[];\n  links: OpenAICheckoutLink[];\n  payment_mode: 'live' | 'test';\n}\n\nexport interface OpenAICheckoutOrder {\n  id: string;\n  checkout_session_id: string;\n  status: 'completed' | string;\n  permalink_url?: string;\n}\n\n/**\n * The `window.openai` runtime object injected by ChatGPT into hosted iframes.\n */\nexport interface OpenAIRuntime {\n  // --- File APIs ---\n  uploadFile?(file: File): Promise<OpenAIUploadFileResult>;\n  getFileDownloadUrl?(params: { fileId: string }): Promise<OpenAIFileDownloadUrlResult>;\n\n  // --- Modal API ---\n  requestModal?(params: OpenAIRequestModalParams): Promise<void>;\n\n  // --- Checkout API ---\n  requestCheckout?(session: OpenAICheckoutSession): Promise<OpenAICheckoutOrder>;\n\n  // --- Display ---\n  requestClose?(): void;\n  requestDisplayMode?(params: { mode: 'inline' | 'PiP' | 'fullscreen' }): Promise<void>;\n\n  // --- Messaging ---\n  sendFollowUpMessage?(params: { prompt: string }): void;\n\n  // --- Other ---\n  openExternal?(params: { href: string }): void;\n}\n\n/**\n * Get the `window.openai` runtime if available.\n * Returns `undefined` outside of ChatGPT or in SSR.\n */\nexport function getOpenAIRuntime(): OpenAIRuntime | undefined {\n  if (typeof window !== 'undefined' && 'openai' in window) {\n    return (window as unknown as { openai: OpenAIRuntime }).openai;\n  }\n  return undefined;\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIUploadFileResult } from './openai-types';\n\nexport type { OpenAIUploadFileResult as CreateFileResult };\n\n/**\n * Upload a file from the app UI into the ChatGPT conversation.\n *\n * Wraps `window.openai.uploadFile` which is only available inside ChatGPT.\n * Supported formats: `image/png`, `image/jpeg`, `image/webp`.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useUploadFile } from 'sunpeak/host/chatgpt';\n *\n * function ImageUploader() {\n *   const uploadFile = useUploadFile();\n *\n *   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {\n *     const file = e.currentTarget.files?.[0];\n *     if (!file) return;\n *     const { fileId } = await uploadFile(file);\n *     console.log('Uploaded:', fileId);\n *   };\n *\n *   return <input type=\"file\" accept=\"image/*\" onChange={handleChange} />;\n * }\n * ```\n */\nexport function useUploadFile(): (file: File) => Promise<OpenAIUploadFileResult> {\n  const app = useApp();\n  return useCallback(\n    async (file: File) => {\n      if (!app) {\n        throw new Error('[useUploadFile] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.uploadFile) {\n        throw new Error('[useUploadFile] window.openai.uploadFile not available');\n      }\n      return runtime.uploadFile(file);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIFileDownloadUrlResult } from './openai-types';\n\nexport type { OpenAIFileDownloadUrlResult as FileDownloadUrlResult };\n\n/**\n * Get a temporary download URL for a file by its ID.\n *\n * @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works\n * across all hosts via the MCP Apps SDK `app.downloadFile()` method.\n *\n * Wraps `window.openai.getFileDownloadUrl` which is only available inside\n * ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}\n * or file IDs received in tool parameters.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';\n *\n * function FilePreview({ fileId }: { fileId: string }) {\n *   const getFileDownloadUrl = useGetFileDownloadUrl();\n *   const [src, setSrc] = useState<string>();\n *\n *   useEffect(() => {\n *     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));\n *   }, [fileId, getFileDownloadUrl]);\n *\n *   return src ? <img src={src} /> : <p>Loading...</p>;\n * }\n * ```\n */\nexport function useGetFileDownloadUrl(): (params: {\n  fileId: string;\n}) => Promise<OpenAIFileDownloadUrlResult> {\n  const app = useApp();\n  return useCallback(\n    async (params: { fileId: string }) => {\n      if (!app) {\n        throw new Error('[useGetFileDownloadUrl] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.getFileDownloadUrl) {\n        throw new Error('[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available');\n      }\n      return runtime.getFileDownloadUrl(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport { getOpenAIRuntime, type OpenAIRequestModalParams } from './openai-types';\n\nexport type { OpenAIRequestModalParams as OpenModalParams };\n\n/**\n * Open a host-controlled modal in ChatGPT.\n *\n * Wraps `window.openai.requestModal` which is only available inside ChatGPT.\n * Pass a `template` URL to load alternate UI content in the modal, or omit\n * it to reuse the current UI.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestModal } from 'sunpeak/host/chatgpt';\n *\n * function CheckoutButton() {\n *   const requestModal = useRequestModal();\n *\n *   return (\n *     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>\n *       Checkout\n *     </button>\n *   );\n * }\n * ```\n */\nexport function useRequestModal(): (params: OpenAIRequestModalParams) => Promise<void> {\n  const app = useApp();\n  return useCallback(\n    async (params: OpenAIRequestModalParams) => {\n      if (!app) {\n        console.warn('[useRequestModal] App not connected');\n        return;\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestModal) {\n        throw new Error('[useRequestModal] window.openai.requestModal not available');\n      }\n      return runtime.requestModal(params);\n    },\n    [app]\n  );\n}\n","import { useCallback } from 'react';\nimport { useApp } from '../../hooks/use-app';\nimport {\n  getOpenAIRuntime,\n  type OpenAICheckoutSession,\n  type OpenAICheckoutOrder,\n} from './openai-types';\n\nexport type { OpenAICheckoutSession as CheckoutSession };\nexport type { OpenAICheckoutOrder as CheckoutOrder };\n\n/**\n * Trigger the ChatGPT instant checkout flow.\n *\n * Wraps `window.openai.requestCheckout` which is only available inside\n * ChatGPT. Opens the host checkout UI, handles payment display, and\n * resolves with the finalized order. Rejects on error or user cancel.\n *\n * Import from `sunpeak/host/chatgpt`:\n *\n * @example\n * ```tsx\n * import { useRequestCheckout } from 'sunpeak/host/chatgpt';\n *\n * function BuyButton() {\n *   const requestCheckout = useRequestCheckout();\n *\n *   const handleBuy = async () => {\n *     try {\n *       const order = await requestCheckout({\n *         id: 'session-1',\n *         payment_provider: {\n *           provider: 'stripe',\n *           merchant_id: 'acct_xxx',\n *           supported_payment_methods: ['card', 'apple_pay'],\n *         },\n *         status: 'ready_for_payment',\n *         currency: 'USD',\n *         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],\n *         links: [],\n *         payment_mode: 'live',\n *       });\n *       console.log('Order completed:', order.id);\n *     } catch {\n *       console.log('Checkout cancelled or failed');\n *     }\n *   };\n *\n *   return <button onClick={handleBuy}>Buy Now</button>;\n * }\n * ```\n */\nexport function useRequestCheckout(): (\n  session: OpenAICheckoutSession\n) => Promise<OpenAICheckoutOrder> {\n  const app = useApp();\n  return useCallback(\n    async (session: OpenAICheckoutSession) => {\n      if (!app) {\n        throw new Error('[useRequestCheckout] App not connected');\n      }\n      const runtime = getOpenAIRuntime();\n      if (!runtime?.requestCheckout) {\n        throw new Error('[useRequestCheckout] window.openai.requestCheckout not available');\n      }\n      return runtime.requestCheckout(session);\n    },\n    [app]\n  );\n}\n"],"mappings":";;;;;;;;;;AAuFA,SAAgB,mBAA8C;AAC5D,KAAI,OAAO,WAAW,eAAe,YAAY,OAC/C,QAAQ,OAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACzD5D,SAAgB,gBAAiE;CAC/E,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,SAAe;AACpB,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,WACZ,OAAM,IAAI,MAAM,yDAAyD;AAE3E,SAAO,QAAQ,WAAW,KAAK;IAEjC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACZH,SAAgB,wBAE2B;CACzC,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,WAA+B;AACpC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,4CAA4C;EAE9D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,mBACZ,OAAM,IAAI,MAAM,yEAAyE;AAE3F,SAAO,QAAQ,mBAAmB,OAAO;IAE3C,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpBH,SAAgB,kBAAuE;CACrF,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,WAAqC;AAC1C,MAAI,CAAC,KAAK;AACR,WAAQ,KAAK,sCAAsC;AACnD;;EAEF,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,aACZ,OAAM,IAAI,MAAM,6DAA6D;AAE/E,SAAO,QAAQ,aAAa,OAAO;IAErC,CAAC,IAAI,CACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACOH,SAAgB,qBAEkB;CAChC,MAAM,MAAM,gBAAA,QAAQ;AACpB,SAAA,GAAA,MAAA,aACE,OAAO,YAAmC;AACxC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,yCAAyC;EAE3D,MAAM,UAAU,kBAAkB;AAClC,MAAI,CAAC,SAAS,gBACZ,OAAM,IAAI,MAAM,mEAAmE;AAErF,SAAO,QAAQ,gBAAgB,QAAQ;IAEzC,CAAC,IAAI,CACN"}

package/dist/host/chatgpt/index.js

@@ -1,81 +1,181 @@
+import "../../protocol-DJmRaBzO.js";
+import { t as useApp } from "../../use-app-X7JbGskk.js";
 import { useCallback } from "react";
-import { u as useApp } from "../../use-app-C9gpzIQO.js";
+//#region src/host/chatgpt/openai-types.ts
+/**
+* Get the `window.openai` runtime if available.
+* Returns `undefined` outside of ChatGPT or in SSR.
+*/
 function getOpenAIRuntime() {
-  if (typeof window !== "undefined" && "openai" in window) {
-    return window.openai;
-  }
-  return void 0;
+	if (typeof window !== "undefined" && "openai" in window) return window.openai;
 }
+//#endregion
+//#region src/host/chatgpt/use-create-file.ts
+/**
+* Upload a file from the app UI into the ChatGPT conversation.
+*
+* Wraps `window.openai.uploadFile` which is only available inside ChatGPT.
+* Supported formats: `image/png`, `image/jpeg`, `image/webp`.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useUploadFile } from 'sunpeak/host/chatgpt';
+*
+* function ImageUploader() {
+*   const uploadFile = useUploadFile();
+*
+*   const handleChange = async (e: React.ChangeEvent<HTMLInputElement>) => {
+*     const file = e.currentTarget.files?.[0];
+*     if (!file) return;
+*     const { fileId } = await uploadFile(file);
+*     console.log('Uploaded:', fileId);
+*   };
+*
+*   return <input type="file" accept="image/*" onChange={handleChange} />;
+* }
+* ```
+*/
 function useUploadFile() {
-  const app = useApp();
-  return useCallback(
-    async (file) => {
-      if (!app) {
-        throw new Error("[useUploadFile] App not connected");
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.uploadFile) {
-        throw new Error("[useUploadFile] window.openai.uploadFile not available");
-      }
-      return runtime.uploadFile(file);
-    },
-    [app]
-  );
+	const app = useApp();
+	return useCallback(async (file) => {
+		if (!app) throw new Error("[useUploadFile] App not connected");
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.uploadFile) throw new Error("[useUploadFile] window.openai.uploadFile not available");
+		return runtime.uploadFile(file);
+	}, [app]);
 }
+//#endregion
+//#region src/host/chatgpt/use-file-download.ts
+/**
+* Get a temporary download URL for a file by its ID.
+*
+* @deprecated Use {@link useDownloadFile} from `sunpeak` instead — it works
+* across all hosts via the MCP Apps SDK `app.downloadFile()` method.
+*
+* Wraps `window.openai.getFileDownloadUrl` which is only available inside
+* ChatGPT. Use this to retrieve URLs for files uploaded via {@link useUploadFile}
+* or file IDs received in tool parameters.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useGetFileDownloadUrl } from 'sunpeak/host/chatgpt';
+*
+* function FilePreview({ fileId }: { fileId: string }) {
+*   const getFileDownloadUrl = useGetFileDownloadUrl();
+*   const [src, setSrc] = useState<string>();
+*
+*   useEffect(() => {
+*     getFileDownloadUrl({ fileId }).then(({ downloadUrl }) => setSrc(downloadUrl));
+*   }, [fileId, getFileDownloadUrl]);
+*
+*   return src ? <img src={src} /> : <p>Loading...</p>;
+* }
+* ```
+*/
 function useGetFileDownloadUrl() {
-  const app = useApp();
-  return useCallback(
-    async (params) => {
-      if (!app) {
-        throw new Error("[useGetFileDownloadUrl] App not connected");
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.getFileDownloadUrl) {
-        throw new Error("[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available");
-      }
-      return runtime.getFileDownloadUrl(params);
-    },
-    [app]
-  );
+	const app = useApp();
+	return useCallback(async (params) => {
+		if (!app) throw new Error("[useGetFileDownloadUrl] App not connected");
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.getFileDownloadUrl) throw new Error("[useGetFileDownloadUrl] window.openai.getFileDownloadUrl not available");
+		return runtime.getFileDownloadUrl(params);
+	}, [app]);
 }
+//#endregion
+//#region src/host/chatgpt/use-open-modal.ts
+/**
+* Open a host-controlled modal in ChatGPT.
+*
+* Wraps `window.openai.requestModal` which is only available inside ChatGPT.
+* Pass a `template` URL to load alternate UI content in the modal, or omit
+* it to reuse the current UI.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useRequestModal } from 'sunpeak/host/chatgpt';
+*
+* function CheckoutButton() {
+*   const requestModal = useRequestModal();
+*
+*   return (
+*     <button onClick={() => requestModal({ template: 'ui://widget/checkout.html' })}>
+*       Checkout
+*     </button>
+*   );
+* }
+* ```
+*/
 function useRequestModal() {
-  const app = useApp();
-  return useCallback(
-    async (params) => {
-      if (!app) {
-        console.warn("[useRequestModal] App not connected");
-        return;
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.requestModal) {
-        throw new Error("[useRequestModal] window.openai.requestModal not available");
-      }
-      return runtime.requestModal(params);
-    },
-    [app]
-  );
+	const app = useApp();
+	return useCallback(async (params) => {
+		if (!app) {
+			console.warn("[useRequestModal] App not connected");
+			return;
+		}
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.requestModal) throw new Error("[useRequestModal] window.openai.requestModal not available");
+		return runtime.requestModal(params);
+	}, [app]);
 }
+//#endregion
+//#region src/host/chatgpt/use-request-checkout.ts
+/**
+* Trigger the ChatGPT instant checkout flow.
+*
+* Wraps `window.openai.requestCheckout` which is only available inside
+* ChatGPT. Opens the host checkout UI, handles payment display, and
+* resolves with the finalized order. Rejects on error or user cancel.
+*
+* Import from `sunpeak/host/chatgpt`:
+*
+* @example
+* ```tsx
+* import { useRequestCheckout } from 'sunpeak/host/chatgpt';
+*
+* function BuyButton() {
+*   const requestCheckout = useRequestCheckout();
+*
+*   const handleBuy = async () => {
+*     try {
+*       const order = await requestCheckout({
+*         id: 'session-1',
+*         payment_provider: {
+*           provider: 'stripe',
+*           merchant_id: 'acct_xxx',
+*           supported_payment_methods: ['card', 'apple_pay'],
+*         },
+*         status: 'ready_for_payment',
+*         currency: 'USD',
+*         totals: [{ type: 'total', display_text: 'Total', amount: 999 }],
+*         links: [],
+*         payment_mode: 'live',
+*       });
+*       console.log('Order completed:', order.id);
+*     } catch {
+*       console.log('Checkout cancelled or failed');
+*     }
+*   };
+*
+*   return <button onClick={handleBuy}>Buy Now</button>;
+* }
+* ```
+*/
 function useRequestCheckout() {
-  const app = useApp();
-  return useCallback(
-    async (session) => {
-      if (!app) {
-        throw new Error("[useRequestCheckout] App not connected");
-      }
-      const runtime = getOpenAIRuntime();
-      if (!runtime?.requestCheckout) {
-        throw new Error("[useRequestCheckout] window.openai.requestCheckout not available");
-      }
-      return runtime.requestCheckout(session);
-    },
-    [app]
-  );
+	const app = useApp();
+	return useCallback(async (session) => {
+		if (!app) throw new Error("[useRequestCheckout] App not connected");
+		const runtime = getOpenAIRuntime();
+		if (!runtime?.requestCheckout) throw new Error("[useRequestCheckout] window.openai.requestCheckout not available");
+		return runtime.requestCheckout(session);
+	}, [app]);
 }
-export {
-  getOpenAIRuntime,
-  useGetFileDownloadUrl,
-  useRequestCheckout,
-  useRequestModal,
-  useUploadFile
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { getOpenAIRuntime, useGetFileDownloadUrl, useRequestCheckout, useRequestModal, useUploadFile };
+
+//# sourceMappingURL=index.js.map