@thewhateverapp/platform 0.7.17 → 0.7.18

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

@@ -0,0 +1,62 @@
+/**
+ * Edge AI Service
+ *
+ * Provides AI capabilities for user-generated apps running on Cloudflare Workers/Pages.
+ * Connects to the platform AI service for inference.
+ *
+ * @example
+ * ```typescript
+ * import { getAI } from '@thewhateverapp/platform';
+ *
+ * export async function POST(req: NextRequest) {
+ *   const ai = await getAI();
+ *
+ *   // Simple text generation
+ *   const answer = await ai.ask("Summarize this text: ...");
+ *
+ *   // With options
+ *   const creative = await ai.ask("Write a poem about coding", {
+ *     capabilities: ['creative'],
+ *     temperature: 0.9
+ *   });
+ *
+ *   // Vision capability
+ *   const response = await ai.prompt({
+ *     prompt: "What's in this image?",
+ *     capabilities: ['vision'],
+ *     images: [{ type: 'url', data: imageUrl }]
+ *   });
+ *
+ *   return NextResponse.json({ answer });
+ * }
+ * ```
+ */
+import type { AIServiceProvider, AIRequest, AIEnv } from './types';
+export type * from './types';
+/**
+ * Get an AI service instance for the current request
+ *
+ * Automatically retrieves configuration from the environment.
+ *
+ * @param req - NextRequest, object with env property, or env object directly
+ * @returns AI service provider instance
+ */
+export declare function getAI(req?: AIRequest | {
+    env: AIEnv;
+} | AIEnv): Promise<AIServiceProvider>;
+/**
+ * Create an AI service instance directly with config
+ *
+ * @example
+ * ```typescript
+ * const ai = createAI({
+ *   apiUrl: 'https://api.thewhatever.app',
+ *   apiKey: env.API_KEY
+ * });
+ * ```
+ */
+export declare function createAI(config: {
+    apiUrl?: string;
+    apiKey: string;
+}): AIServiceProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/edge/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/edge/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,KAAK,EAIN,MAAM,SAAS,CAAC;AAGjB,mBAAmB,SAAS,CAAC;AAK7B;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,GAAG,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,KAAK,CAAA;CAAE,GAAG,KAAK,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAoC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAGvF"}

package/dist/edge/ai/index.js

@@ -0,0 +1,128 @@
+/**
+ * Edge AI Service
+ *
+ * Provides AI capabilities for user-generated apps running on Cloudflare Workers/Pages.
+ * Connects to the platform AI service for inference.
+ *
+ * @example
+ * ```typescript
+ * import { getAI } from '@thewhateverapp/platform';
+ *
+ * export async function POST(req: NextRequest) {
+ *   const ai = await getAI();
+ *
+ *   // Simple text generation
+ *   const answer = await ai.ask("Summarize this text: ...");
+ *
+ *   // With options
+ *   const creative = await ai.ask("Write a poem about coding", {
+ *     capabilities: ['creative'],
+ *     temperature: 0.9
+ *   });
+ *
+ *   // Vision capability
+ *   const response = await ai.prompt({
+ *     prompt: "What's in this image?",
+ *     capabilities: ['vision'],
+ *     images: [{ type: 'url', data: imageUrl }]
+ *   });
+ *
+ *   return NextResponse.json({ answer });
+ * }
+ * ```
+ */
+// Default platform API URL
+const DEFAULT_PLATFORM_API = 'https://api.thewhatever.app';
+/**
+ * Get an AI service instance for the current request
+ *
+ * Automatically retrieves configuration from the environment.
+ *
+ * @param req - NextRequest, object with env property, or env object directly
+ * @returns AI service provider instance
+ */
+export async function getAI(req) {
+    let env;
+    // If no argument provided, try to get context from OpenNext
+    if (!req) {
+        try {
+            // Dynamic import to avoid hard dependency on @opennextjs/cloudflare
+            const importFunc = new Function('moduleName', 'return import(moduleName)');
+            const opennext = await importFunc('@opennextjs/cloudflare');
+            env = opennext.getCloudflareContext().env;
+        }
+        catch {
+            throw new Error('No request provided and @opennextjs/cloudflare not available. Pass env or request object.');
+        }
+    }
+    else if ('env' in req) {
+        env = req.env;
+    }
+    else if ('API_KEY' in req || 'PLATFORM_API_URL' in req || 'APP_ID' in req) {
+        // Direct env object
+        env = req;
+    }
+    else {
+        env = req.env;
+    }
+    if (!env) {
+        throw new Error('No environment found in request. Ensure you are running in edge runtime.');
+    }
+    const apiUrl = env.PLATFORM_API_URL || DEFAULT_PLATFORM_API;
+    const apiKey = env.API_KEY;
+    if (!apiKey) {
+        throw new Error('No API_KEY found in environment. Add API_KEY to your wrangler.jsonc secrets.');
+    }
+    return createAIProvider(apiUrl, apiKey);
+}
+/**
+ * Create an AI service instance directly with config
+ *
+ * @example
+ * ```typescript
+ * const ai = createAI({
+ *   apiUrl: 'https://api.thewhatever.app',
+ *   apiKey: env.API_KEY
+ * });
+ * ```
+ */
+export function createAI(config) {
+    const apiUrl = config.apiUrl || DEFAULT_PLATFORM_API;
+    return createAIProvider(apiUrl, config.apiKey);
+}
+/**
+ * Internal: Create the AI provider implementation
+ */
+function createAIProvider(apiUrl, apiKey) {
+    async function request(endpoint, body) {
+        const response = await fetch(`${apiUrl}/platform/ai${endpoint}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({}));
+            throw new Error(error.error || `AI service error: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    return {
+        async ask(prompt, options) {
+            const result = await request('/prompt', {
+                prompt,
+                provider: options?.provider,
+                capabilities: options?.capabilities,
+                maxTokens: options?.maxTokens,
+                temperature: options?.temperature,
+            });
+            return result.text;
+        },
+        async prompt(req) {
+            return request('/prompt', req);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/edge/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/edge/ai/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,124 @@
+/**
+ * AI Service types for edge runtime
+ *
+ * Type definitions for using AI services from Cloudflare Workers/Pages
+ */
+/**
+ * AI Provider options
+ */
+export type AIProvider = 'anthropic' | 'openai' | 'google' | 'auto';
+/**
+ * AI model capabilities for automatic model selection
+ */
+export type AICapability = 'vision' | 'coding' | 'reasoning' | 'creative' | 'fast' | 'cost-effective' | 'long-context';
+/**
+ * Image input for vision capabilities
+ */
+export interface ImageInput {
+    type: 'url' | 'base64';
+    data: string;
+    mimeType?: string;
+}
+/**
+ * Options for simple ask() method
+ */
+export interface AskOptions {
+    /** AI provider to use (default: auto) */
+    provider?: AIProvider;
+    /** Capabilities to match when selecting model */
+    capabilities?: AICapability[];
+    /** Max tokens for response */
+    maxTokens?: number;
+    /** Temperature (0-1, lower = more focused) */
+    temperature?: number;
+}
+/**
+ * Full prompt request for advanced usage
+ */
+export interface PromptRequest {
+    /** The prompt text */
+    prompt: string;
+    /** AI provider to use */
+    provider?: AIProvider;
+    /** Specific model ID (overrides capabilities) */
+    model?: string;
+    /** Capabilities for auto model selection */
+    capabilities?: AICapability[];
+    /** Max tokens for response */
+    maxTokens?: number;
+    /** Temperature (0-1) */
+    temperature?: number;
+    /** System prompt for context */
+    systemPrompt?: string;
+    /** Images for vision models */
+    images?: ImageInput[];
+}
+/**
+ * Response from AI prompt
+ */
+export interface PromptResponse {
+    /** Generated text response */
+    text: string;
+    /** Provider used */
+    provider: string;
+    /** Model used */
+    model: string;
+    /** Token usage */
+    tokensUsed: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    /** Whether response was cached */
+    cached?: boolean;
+}
+/**
+ * AI Service provider interface
+ */
+export interface AIServiceProvider {
+    /**
+     * Simple ask method - get a text response
+     *
+     * @example
+     * ```typescript
+     * const ai = await getAI();
+     * const answer = await ai.ask("What is the capital of France?");
+     * console.log(answer); // "Paris"
+     * ```
+     */
+    ask(prompt: string, options?: AskOptions): Promise<string>;
+    /**
+     * Full prompt method with detailed response
+     *
+     * @example
+     * ```typescript
+     * const ai = await getAI();
+     * const response = await ai.prompt({
+     *   prompt: "Describe this image",
+     *   capabilities: ['vision'],
+     *   images: [{ type: 'url', data: 'https://example.com/image.jpg' }]
+     * });
+     * console.log(response.text);
+     * console.log(response.tokensUsed);
+     * ```
+     */
+    prompt(request: PromptRequest): Promise<PromptResponse>;
+}
+/**
+ * Cloudflare environment interface for AI
+ */
+export interface AIEnv {
+    /** Platform API URL */
+    PLATFORM_API_URL?: string;
+    /** API key for authentication */
+    API_KEY?: string;
+    /** App ID (tile ID) */
+    APP_ID?: string;
+}
+/**
+ * Request wrapper for NextRequest compatibility
+ */
+export interface AIRequest {
+    env: AIEnv;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/edge/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/edge/ai/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,GACN,gBAAgB,GAChB,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,iDAAiD;IACjD,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;OASG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3D;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,KAAK,CAAC;CACZ"}

package/dist/edge/ai/types.js

@@ -0,0 +1,7 @@
+/**
+ * AI Service types for edge runtime
+ *
+ * Type definitions for using AI services from Cloudflare Workers/Pages
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/edge/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/edge/ai/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/edge/index.d.ts

@@ -9,6 +9,8 @@ export { getKV, createKV } from './kv';
 export type * from './kv/types';
 export { getStorage, createStorage } from './storage';
 export type * from './storage/types';
+export { getAI, createAI } from './ai';
+export type * from './ai/types';
 export { getTileState } from './tile-state';
 export type * from './tile-state/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/edge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,mBAAmB,YAAY,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtD,mBAAmB,iBAAiB,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,mBAAmB,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,mBAAmB,YAAY,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtD,mBAAmB,iBAAiB,CAAC;AAGrC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,mBAAmB,YAAY,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,mBAAmB,oBAAoB,CAAC"}

package/dist/edge/index.js

@@ -9,6 +9,8 @@ export { getDatabase, createDatabase } from './database';
 export { getKV, createKV } from './kv';
 // Storage (Object Storage / R2) exports
 export { getStorage, createStorage } from './storage';
+// AI (Artificial Intelligence) exports
+export { getAI, createAI } from './ai';
 // Tile State (Durable Objects) exports
 export { getTileState } from './tile-state';
 //# sourceMappingURL=index.js.map

package/dist/edge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGzD,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGvC,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtD,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGzD,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGvC,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtD,uCAAuC;AACvC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGvC,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -2,9 +2,36 @@
  * @thewhateverapp/platform - Universal SDK for The Whatever App
  *
  * Provides domain-specific services for apps on The Whatever App platform.
+ *
+ * ## Quick Start (for tiles/apps)
+ *
+ * ```typescript
+ * import { getDatabase, getKV, getAI, getStorage } from '@thewhateverapp/platform';
+ *
+ * // In your API route
+ * export async function POST(req: NextRequest) {
+ *   const db = await getDatabase();
+ *   const ai = await getAI();
+ *
+ *   const answer = await ai.ask("What is 2+2?");
+ *   await db.collection('answers').insertOne({ answer });
+ *
+ *   return NextResponse.json({ answer });
+ * }
+ * ```
  */
 export { createPlatform, WhateverPlatform } from './platform';
 export type * from './types';
+export { getDatabase, createDatabase } from './edge/database';
+export type { DatabaseProvider, Collection, Query, Update, FindOptions, InsertOneResult, InsertManyResult, UpdateResult, DeleteResult, } from './edge/database/types';
+export { getKV, createKV } from './edge/kv';
+export type { KVProvider, KVSetOptions, KVListOptions, KVListResult, KVValueType, KVValue, KVMetadata, } from './edge/kv/types';
+export { getStorage, createStorage } from './edge/storage';
+export type { StorageProvider, StorageObject, StorageMetadata, ListOptions as StorageListOptions, ListResult as StorageListResult, PutOptions as StoragePutOptions, PutResult as StoragePutResult, GetOptions as StorageGetOptions, } from './edge/storage/types';
+export { getAI, createAI } from './edge/ai';
+export type { AIServiceProvider, AIProvider, AICapability, AskOptions, PromptRequest, PromptResponse, ImageInput, } from './edge/ai/types';
+export { getTileState } from './edge/tile-state';
+export type { TileStateProvider, Comment, Report, } from './edge/tile-state/types';
 export { ProductionStorage } from './storage/production';
 export { MockStorage } from './storage/mock';
 export { ProductionDB } from './db/production';
@@ -23,7 +50,4 @@ export { PointsAPI } from './points/client';
 export { TilesAPI } from './tiles/client';
 export { BiddingAPI } from './bidding/client';
 export { DeploymentsAPI } from './deployments/client';
-export { getDatabase, createDatabase } from './edge/database';
-export { getKV, createKV } from './edge/kv';
-export { getStorage, createStorage } from './edge/storage';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9D,mBAAmB,SAAS,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9D,mBAAmB,SAAS,CAAC;AAO7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,MAAM,EACN,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,OAAO,EACP,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,IAAI,kBAAkB,EACjC,UAAU,IAAI,iBAAiB,EAC/B,UAAU,IAAI,iBAAiB,EAC/B,SAAS,IAAI,gBAAgB,EAC7B,UAAU,IAAI,iBAAiB,GAChC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,iBAAiB,EACjB,OAAO,EACP,MAAM,GACP,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,10 +2,42 @@
  * @thewhateverapp/platform - Universal SDK for The Whatever App
  *
  * Provides domain-specific services for apps on The Whatever App platform.
+ *
+ * ## Quick Start (for tiles/apps)
+ *
+ * ```typescript
+ * import { getDatabase, getKV, getAI, getStorage } from '@thewhateverapp/platform';
+ *
+ * // In your API route
+ * export async function POST(req: NextRequest) {
+ *   const db = await getDatabase();
+ *   const ai = await getAI();
+ *
+ *   const answer = await ai.ask("What is 2+2?");
+ *   await db.collection('answers').insertOne({ answer });
+ *
+ *   return NextResponse.json({ answer });
+ * }
+ * ```
  */
 // Main exports
 export { createPlatform, WhateverPlatform } from './platform';
-// Service exports
+// =============================================================================
+// Edge Runtime Services (Primary API for tiles/apps)
+// =============================================================================
+// Database - MongoDB-like schemaless database
+export { getDatabase, createDatabase } from './edge/database';
+// KV - Key-Value storage
+export { getKV, createKV } from './edge/kv';
+// Storage - Object storage (R2)
+export { getStorage, createStorage } from './edge/storage';
+// AI - Artificial Intelligence
+export { getAI, createAI } from './edge/ai';
+// Tile State - Durable Objects for real-time state
+export { getTileState } from './edge/tile-state';
+// =============================================================================
+// Platform API Clients (for web apps, admin tools)
+// =============================================================================
 export { ProductionStorage } from './storage/production';
 export { MockStorage } from './storage/mock';
 export { ProductionDB } from './db/production';
@@ -24,9 +56,4 @@ export { PointsAPI } from './points/client';
 export { TilesAPI } from './tiles/client';
 export { BiddingAPI } from './bidding/client';
 export { DeploymentsAPI } from './deployments/client';
-// Edge runtime exports (for user-generated apps)
-// Available at both '@thewhateverapp/platform' and '@thewhateverapp/platform/edge'
-export { getDatabase, createDatabase } from './edge/database';
-export { getKV, createKV } from './edge/kv';
-export { getStorage, createStorage } from './edge/storage';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,iDAAiD;AACjD,mFAAmF;AACnF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D,gFAAgF;AAChF,qDAAqD;AACrD,gFAAgF;AAEhF,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAa9D,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAW5C,gCAAgC;AAChC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAY3D,+BAA+B;AAC/B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAW5C,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thewhateverapp/platform",
-  "version": "0.7.17",
+  "version": "0.7.18",
   "description": "Universal SDK for The Whatever App platform services",
   "type": "module",
   "main": "./dist/index.js",