@aippy/runtime 0.2.7-dev.0 → 0.2.7-dev.1

package/dist/ai/config/bridge.d.ts

@@ -0,0 +1,23 @@
+import { AIConfig } from './types';
+/**
+ * Sends AI configuration to app container via postMessage
+ *
+ * Supports two scenarios:
+ * - iOS WebView: Uses `webkit.messageHandlers.aippyListener.postMessage()`
+ * - Iframe: Uses `window.parent.postMessage()`
+ *
+ * This is a one-way communication - we send the config but don't listen for updates
+ * because AI config is static (loaded at startup), not reactive like tweaks.
+ *
+ * @param config - The AI configuration to send
+ *
+ * @example
+ * ```ts
+ * import { sendAIConfigToContainer, loadAIConfig } from '@aippy/runtime/ai';
+ * import aiConfigJson from '@/config/aiConfig.json';
+ *
+ * const config = loadAIConfig(aiConfigJson);
+ * sendAIConfigToContainer(config);
+ * ```
+ */
+export declare function sendAIConfigToContainer(config: AIConfig): void;

package/dist/ai/config/helper.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AI Configuration helper functions
+ *
+ * Provides convenient utilities for loading and accessing AI configuration
+ * from aiConfig.json files generated by LLMs.
+ */
+/**
+ * Type for the values object returned by createAIConfig
+ * Provides direct property access to configuration values
+ */
+export interface AIConfigValues {
+    readonly [key: string]: unknown;
+}
+/**
+ * Creates an AI configuration helper that loads, validates, and provides
+ * convenient access to configuration values.
+ *
+ * This function:
+ * 1. Loads and validates the configuration
+ * 2. Sends it to the app container (for aippy app editing)
+ * 3. Returns an object with direct property access to config values
+ *
+ * **Recommended usage**: Call this once at app initialization and export
+ * the result for use throughout your app.
+ *
+ * @param configJson - The AI configuration JSON (usually from `import aiConfigJson from '@/config/aiConfig.json'`)
+ * @returns An object with direct property access to configuration values
+ *
+ * @example
+ * ```ts
+ * // app.tsx or main.tsx
+ * import aiConfigJson from '@/config/aiConfig.json';
+ * import { createAIConfig } from '@aippy/runtime/ai';
+ *
+ * export const aiConfig = createAIConfig(aiConfigJson);
+ *
+ * // In your AI code - direct property access
+ * import { aiConfig } from './app';
+ * const model = aiConfig.model; // string | undefined
+ * const temperature = aiConfig.temperature; // number | undefined
+ * ```
+ */
+export declare function createAIConfig(configJson: unknown): AIConfigValues;

package/dist/ai/config/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AI Configuration module
+ *
+ * Provides types, validation, and utilities for working with aiConfig.json
+ * files generated by LLMs when creating AI-powered applications.
+ */
+export type { AIConfig, AIConfigValue, AIConfigItem, NumberAIConfigItem, BooleanAIConfigItem, TextAIConfigItem, EnumAIConfigItem, AIConfigError, } from './types';
+export type { AIConfigValues } from './helper';
+export { AIConfigValidationError, validateAIConfig, parseAIConfig, loadAIConfig, getAIConfigValue, } from './parser';
+export { sendAIConfigToContainer } from './bridge';
+export { createAIConfig } from './helper';

package/dist/ai/config/parser.d.ts

@@ -0,0 +1,60 @@
+import { AIConfig, AIConfigError } from './types';
+/**
+ * Custom error class for AI configuration validation failures
+ */
+export declare class AIConfigValidationError extends Error {
+    readonly errors: AIConfigError[];
+    constructor(message: string, errors: AIConfigError[]);
+}
+/**
+ * Validates an AI configuration object
+ *
+ * @param config - The configuration object to validate
+ * @throws {AIConfigValidationError} If validation fails
+ */
+export declare function validateAIConfig(config: unknown): asserts config is AIConfig;
+/**
+ * Parses and validates AI configuration from a JSON string
+ *
+ * @param json - JSON string to parse
+ * @returns Validated AIConfig object
+ * @throws {AIConfigValidationError} If JSON is invalid or validation fails
+ *
+ * @example
+ * ```ts
+ * const json = '{"model": {"index": 0, "name": "Model", ...}}';
+ * const config = parseAIConfig(json);
+ * ```
+ */
+export declare function parseAIConfig(json: string): AIConfig;
+/**
+ * Loads and validates AI configuration from a configuration object
+ *
+ * Typically used with: `import aiConfig from '@/config/aiConfig.json'`
+ *
+ * @param config - Configuration object (usually from JSON import)
+ * @returns Validated AIConfig object
+ * @throws {AIConfigValidationError} If validation fails
+ *
+ * @example
+ * ```ts
+ * import aiConfigJson from '@/config/aiConfig.json';
+ * const config = loadAIConfig(aiConfigJson);
+ * ```
+ */
+export declare function loadAIConfig(config: unknown): AIConfig;
+/**
+ * Gets a configuration value by key
+ *
+ * @param config - The AIConfig object
+ * @param key - Configuration key to retrieve
+ * @returns The value of the configuration item
+ * @throws {Error} If the key is not found
+ *
+ * @example
+ * ```ts
+ * const model = getAIConfigValue<string>(config, 'model');
+ * const temperature = getAIConfigValue<number>(config, 'temperature');
+ * ```
+ */
+export declare function getAIConfigValue<T = unknown>(config: AIConfig, key: string): T;

package/dist/ai/config/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * AI Configuration types for aiConfig.json
+ *
+ * These types define the structure of the AI configuration file that LLMs
+ * generate when creating AI-powered applications.
+ */
+/**
+ * Base interface for all AI configuration items
+ */
+export interface AIConfigItem {
+    /** Display order (lower index = higher priority) */
+    index: number;
+    /** User-friendly display name */
+    name: string;
+    /** Description of the parameter */
+    description: string;
+    /** Optional group name for organizing related parameters */
+    group?: string;
+    /** Type of the configuration item */
+    type: 'number' | 'boolean' | 'text' | 'enum';
+    /** Current value */
+    value: number | string | boolean;
+}
+/**
+ * Number type configuration item
+ */
+export interface NumberAIConfigItem extends AIConfigItem {
+    type: 'number';
+    /** Minimum allowed value */
+    min?: number;
+    /** Maximum allowed value */
+    max?: number;
+    /** Step size for adjustments */
+    step?: number;
+    value: number;
+}
+/**
+ * Boolean type configuration item
+ */
+export interface BooleanAIConfigItem extends AIConfigItem {
+    type: 'boolean';
+    value: boolean;
+}
+/**
+ * Text type configuration item
+ */
+export interface TextAIConfigItem extends AIConfigItem {
+    type: 'text';
+    value: string;
+}
+/**
+ * Enum type configuration item
+ * Used for parameters with a fixed set of valid values (e.g., model names, image sizes)
+ */
+export interface EnumAIConfigItem extends AIConfigItem {
+    type: 'enum';
+    /** Array of valid option values */
+    options: string[];
+    value: string;
+}
+/**
+ * Union type of all possible AI configuration item types
+ */
+export type AIConfigValue = NumberAIConfigItem | BooleanAIConfigItem | TextAIConfigItem | EnumAIConfigItem;
+/**
+ * AI Configuration object structure
+ * Maps configuration keys to their respective configuration items
+ */
+export interface AIConfig {
+    [key: string]: AIConfigValue;
+}
+/**
+ * Validation error information
+ */
+export interface AIConfigError {
+    /** Configuration key that has the error */
+    key: string;
+    /** Error message describing the issue */
+    message: string;
+}

package/dist/ai/errors.d.ts

@@ -1,6 +1,10 @@
 import { AISDKError } from 'ai';
 /**
  * Normalizes a backend error response into an AISDKError.
+ *
+ * If the backend error response includes container message data (e.g., `appMessage` field),
+ * it will be automatically sent to the app container for user-facing UI (e.g., payment dialog,
+ * error popup, success notification).
  */
 export declare function normalizeError(response: Response, body?: unknown): AISDKError;
 /**

package/dist/ai/index.d.ts

@@ -5,7 +5,7 @@
  *
  * ## Path 1: OpenAI-Compatible Provider (AI SDK Core)
  *
- * Use `aippy()` provider with AI SDK Core functions:
+ * Use `aippyAIProvider()` provider with AI SDK Core functions:
  * - generateText / streamText
  * - generateObject / streamObject
  * - embed / embedMany
@@ -13,9 +13,9 @@
  *
  * ```ts
  * import { streamText } from 'ai';
- * import { aippy } from '@aippy/runtime/ai';
+ * import { aippyAIProvider } from '@aippy/runtime/ai';
  *
- * const provider = aippy();
+ * const provider = aippyAIProvider();
  * const result = await streamText({
  *   model: provider('gpt-5'),
  *   prompt: 'Hello!',
@@ -26,8 +26,6 @@
  *
  * Use config builders with @ai-sdk/react hooks:
  * - useChat → aippyChatConfig()
- * - useCompletion → aippyCompletionConfig()
- * - useObject → aippyObjectConfig()
  *
  * ```tsx
  * import { useChat } from '@ai-sdk/react';
@@ -38,8 +36,11 @@
  *
  * @module
  */
-export { aippy, type AippyProvider } from './openai';
+export { aippyAIProvider, type AippyProvider } from './openai';
 export type { AippyOpenAIConfig } from './openai';
-export { aippyChatConfig, aippyCompletionConfig, aippyObjectConfig, aippyObjectBaseConfig, type AippyObjectConfigOptions, type AippyUseChatOptions, type UseObjectOptions, type UseObjectConfigWithSchema, type AippyUIConfig, type AippyChatConfig, UI_CHAT_ENDPOINT, UI_COMPLETION_ENDPOINT, UI_OBJECT_ENDPOINT, } from './ui';
+/** @deprecated Use aippyAIProvider() instead */
+export { aippyAIProvider as aippy } from './openai';
+export { aippyChatConfig, type AippyUseChatOptions, type AippyUIConfig, type AippyChatConfig, UI_CHAT_ENDPOINT, } from './ui';
 export { DEFAULT_BASE_URL, DEFAULT_UI_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_CHAT_SYSTEM, } from './shared';
 export { normalizeError, missingTokenError, abortedError, networkError, parseError, } from './errors';
+export { type AIConfig, type AIConfigValue, type AIConfigItem, type NumberAIConfigItem, type BooleanAIConfigItem, type TextAIConfigItem, type EnumAIConfigItem, type AIConfigError, type AIConfigValues, AIConfigValidationError, validateAIConfig, parseAIConfig, loadAIConfig, getAIConfigValue, sendAIConfigToContainer, createAIConfig, } from './config';

package/dist/ai/index.js

@@ -1,22 +1,25 @@
-import { D as E, i, j as p, h as _, U as T, f as e, g as C, k as U, a as n, b as t, c as A, e as D, d as O, m as I, l as L, n as m, p as N } from "../errors-DWRVLkVz.js";
+import { A as i, D as A, d as n, e, c as E, U as C, f as p, a as g, a as t, b as I, j as T, i as _, l as f, m as U, g as d, n as D, h as L, p as l, s as m, v as F } from "../helper-CRGxnlsu.js";
 import "react";
-import "../bridge-DdAH4txB.js";
+import "../bridge-D2d8hnO_.js";
 export {
-  E as DEFAULT_BASE_URL,
-  i as DEFAULT_CHAT_MODEL,
-  p as DEFAULT_CHAT_SYSTEM,
-  _ as DEFAULT_UI_BASE_URL,
-  T as UI_CHAT_ENDPOINT,
-  e as UI_COMPLETION_ENDPOINT,
-  C as UI_OBJECT_ENDPOINT,
-  U as abortedError,
-  n as aippy,
-  t as aippyChatConfig,
-  A as aippyCompletionConfig,
-  D as aippyObjectBaseConfig,
-  O as aippyObjectConfig,
-  I as missingTokenError,
-  L as networkError,
-  m as normalizeError,
-  N as parseError
+  i as AIConfigValidationError,
+  A as DEFAULT_BASE_URL,
+  n as DEFAULT_CHAT_MODEL,
+  e as DEFAULT_CHAT_SYSTEM,
+  E as DEFAULT_UI_BASE_URL,
+  C as UI_CHAT_ENDPOINT,
+  p as abortedError,
+  g as aippy,
+  t as aippyAIProvider,
+  I as aippyChatConfig,
+  T as createAIConfig,
+  _ as getAIConfigValue,
+  f as loadAIConfig,
+  U as missingTokenError,
+  d as networkError,
+  D as normalizeError,
+  L as parseAIConfig,
+  l as parseError,
+  m as sendAIConfigToContainer,
+  F as validateAIConfig
 };

package/dist/ai/openai/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * OpenAI-compatible module for Aippy AI SDK.
  *
- * Provides the `aippy()` provider factory for use with AI SDK Core functions:
+ * Provides the `aippyAIProvider()` provider factory for use with AI SDK Core functions:
  * - generateText / streamText
  * - generateObject / streamObject
  * - embed / embedMany
  * - generateImage
  */
-export { aippy, type AippyProvider } from './provider';
+export { aippyAIProvider, type AippyProvider } from './provider';
 export type { AippyOpenAIConfig } from '../shared/config';

package/dist/ai/openai/provider.d.ts

@@ -19,9 +19,9 @@ export type AippyProvider = OpenAICompatibleProvider<string, string, string, str
  * @example
  * ```ts
  * import { generateText, streamText, embed, generateImage } from 'ai';
- * import { aippy } from '@aippy/runtime/ai';
+ * import { aippyAIProvider } from '@aippy/runtime/ai';
  *
- * const provider = aippy();
+ * const provider = aippyAIProvider();
  *
  * // Text generation
  * const text = await generateText({
@@ -48,4 +48,4 @@ export type AippyProvider = OpenAICompatibleProvider<string, string, string, str
  * });
  * ```
  */
-export declare function aippy(config?: AippyOpenAIConfig): AippyProvider;
+export declare function aippyAIProvider(config?: AippyOpenAIConfig): AippyProvider;

package/dist/ai/ui/config.d.ts

@@ -1,6 +1,5 @@
-import { AippyUIConfig, AippyChatConfig } from '../shared';
-import { UseCompletionOptions } from 'ai';
-import { AippyUseChatOptions, UseObjectOptions, UseObjectConfigWithSchema } from './types';
+import { AippyChatConfig } from '../shared';
+import { AippyUseChatOptions } from './types';
 /**
  * Creates configuration for the useChat hook.
  *
@@ -24,58 +23,3 @@ import { AippyUseChatOptions, UseObjectOptions, UseObjectConfigWithSchema } from
  * ```
  */
 export declare function aippyChatConfig(config?: AippyChatConfig): AippyUseChatOptions;
-/**
- * Creates configuration for the useCompletion hook.
- *
- * @param config - Optional configuration to override defaults
- * @returns Promise resolving to configuration object to spread into useCompletion()
- *
- * @example
- * ```tsx
- * import { useCompletion } from '@ai-sdk/react';
- * import { aippyCompletionConfig } from '@aippy/runtime/ai';
- *
- * const config = await aippyCompletionConfig();
- * const { completion, input, handleSubmit } = useCompletion(config);
- * ```
- */
-export declare function aippyCompletionConfig(config?: AippyUIConfig): UseCompletionOptions;
-/**
- * Configuration options for aippyObjectConfig.
- */
-export interface AippyObjectConfigOptions extends AippyUIConfig {
-    /**
-     * Schema identifier registered on the backend.
-     * Required for useObject to work with the Aippy backend.
-     */
-    schemaId: string;
-}
-/**
- * Creates configuration for the useObject hook.
- *
- * Note: Unlike useChat/useCompletion, useObject requires a schema.
- * With the Aippy backend, we use schemaId to reference a pre-registered
- * schema on the server (instead of passing the schema directly).
- *
- * @param options - Configuration including required schemaId
- * @returns Promise resolving to configuration object to spread into useObject()
- *
- * @example
- * ```tsx
- * import { useObject } from '@ai-sdk/react';
- * import { aippyObjectConfig } from '@aippy/runtime/ai';
- *
- * // The schemaId must match a schema registered on your backend
- * const config = await aippyObjectConfig({ schemaId: 'user-profile' });
- * const { object, submit } = useObject(config);
- * ```
- */
-export declare function aippyObjectConfig(options: AippyObjectConfigOptions): Promise<UseObjectConfigWithSchema>;
-/**
- * Creates base configuration for useObject without schemaId.
- * Use this when you want to pass schemaId separately.
- *
- * @param config - Optional configuration to override defaults
- * @returns Promise resolving to base configuration object (api + headers only)
- */
-export declare function aippyObjectBaseConfig(config?: AippyUIConfig): Promise<UseObjectOptions>;

package/dist/ai/ui/endpoints.d.ts

@@ -10,7 +10,3 @@
  */
 /** Endpoint for useChat hook */
 export declare const UI_CHAT_ENDPOINT = "/chat";
-/** Endpoint for useCompletion hook */
-export declare const UI_COMPLETION_ENDPOINT = "/completion";
-/** Endpoint for useObject hook */
-export declare const UI_OBJECT_ENDPOINT = "/object";

package/dist/ai/ui/index.d.ts

@@ -3,13 +3,11 @@
  *
  * Provides configuration builders for @ai-sdk/react hooks:
  * - useChat → aippyChatConfig()
- * - useCompletion → aippyCompletionConfig()
- * - useObject → aippyObjectConfig()
  *
  * These hooks communicate with the Aippy backend using
  * AI SDK Data Stream Protocol (SSE with x-vercel-ai-ui-message-stream: v1).
  */
-export { aippyChatConfig, aippyCompletionConfig, aippyObjectConfig, aippyObjectBaseConfig, type AippyObjectConfigOptions, } from './config';
-export type { AippyUseChatOptions, UseObjectOptions, UseObjectConfigWithSchema, } from './types';
-export { UI_CHAT_ENDPOINT, UI_COMPLETION_ENDPOINT, UI_OBJECT_ENDPOINT, } from './endpoints';
+export { aippyChatConfig } from './config';
+export type { AippyUseChatOptions } from './types';
+export { UI_CHAT_ENDPOINT } from './endpoints';
 export type { AippyUIConfig, AippyChatConfig } from '../shared/config';

package/dist/ai/ui/types.d.ts

@@ -18,29 +18,4 @@ export interface AippyUseChatOptions<UI_MESSAGE extends UIMessage = UIMessage> {
     /** Transport for custom API communication */
     transport: ChatTransport<UI_MESSAGE>;
 }
-/**
- * Base configuration for useObject hook.
- *
- * Similar to UseCompletionOptions but for useObject hook.
- * We define this separately since useObject is from @ai-sdk/react, not 'ai'.
- */
-export interface UseObjectOptions {
-    /** API endpoint URL */
-    api: string;
-    /** Headers to include in requests */
-    headers: Record<string, string>;
-}
-/**
- * Extended configuration for useObject with schemaId.
- *
- * This is Aippy-specific: we use schemaId to reference a pre-registered
- * schema on the backend instead of passing the schema directly.
- */
-export interface UseObjectConfigWithSchema extends UseObjectOptions {
-    /**
-     * Schema identifier registered on the backend.
-     * This will be included in the request body.
-     */
-    schemaId: string;
-}
 export type { UseChatBody };