opencloud-platform-sdk 1.1.0

package/README.md

@@ -0,0 +1,247 @@
+# @opencloud/sdk
+
+Official SDK for **OpenCloud** - The AI App Marketplace with pay-per-use model.
+
+Build AI-powered apps that automatically handle payments and AI API calls through OpenCloud's platform.
+
+## Features
+
+- ✅ Call 100+ AI models (GPT-4, Claude, Gemini, Llama, etc.) via OpenRouter
+- ✅ Automatic payment processing (70% to creators, 30% to platform)
+- ✅ No API keys needed - OpenCloud handles everything
+- ✅ TypeScript support with full type definitions
+- ✅ Works in browsers and Node.js
+- ✅ Zero dependencies
+
+## Installation
+
+```bash
+npm install @opencloud/sdk
+# or
+pnpm add @opencloud/sdk
+# or
+yarn add @opencloud/sdk
+```
+
+## Quick Start
+
+### For React/Next.js Apps
+
+```typescript
+import { opencloud } from '@opencloud/sdk';
+
+// Initialize with your app ID
+opencloud.init({ appId: 'your-app-slug' });
+
+// Call AI models
+const response = await opencloud.callAI({
+  model: 'openai/gpt-4',
+  prompt: 'Write a tagline for my startup'
+});
+
+console.log(response.text); // AI-generated response
+console.log(response.cost); // $0.10 (or your app's price per use)
+```
+
+### For HTML/Vanilla JS
+
+```html
+<script src="https://opencloud.com/sdk/platform-sdk.js"></script>
+
+<script>
+  PlatformSDK.init({ appId: 'your-app-slug' });
+
+  async function generate() {
+    const result = await PlatformSDK.callAI({
+      model: 'anthropic/claude-3-5-sonnet',
+      prompt: 'Generate a logo description'
+    });
+
+    console.log(result.text);
+  }
+</script>
+```
+
+## API Reference
+
+### `opencloud.init(config)`
+
+Initialize the SDK with your app configuration.
+
+```typescript
+opencloud.init({
+  appId: 'your-app-slug',  // Required: Your app's unique identifier
+  apiUrl: 'https://opencloud.com'  // Optional: Platform URL (defaults to current origin)
+});
+```
+
+### `opencloud.callAI(params)`
+
+Call an AI model through OpenCloud's platform.
+
+```typescript
+const response = await opencloud.callAI({
+  model: 'openai/gpt-4',  // Required: Model identifier
+  prompt: 'Your prompt here',  // Required: The prompt to send
+  options: {  // Optional: Additional model parameters
+    temperature: 0.7,
+    max_tokens: 1000
+  }
+});
+
+// Response structure:
+{
+  success: true,
+  text: "AI-generated response...",
+  usage: {
+    promptTokens: 10,
+    completionTokens: 50,
+    totalTokens: 60
+  },
+  cost: 0.10,  // Amount charged to user
+  model: "openai/gpt-4"
+}
+```
+
+### `opencloud.getBalance()`
+
+Get the current user's token balance.
+
+```typescript
+const balance = await opencloud.getBalance();
+console.log(`Balance: $${balance}`);
+```
+
+### `opencloud.requestTopUp()`
+
+Request the user to purchase more tokens (opens payment dialog).
+
+```typescript
+try {
+  await opencloud.callAI({...});
+} catch (error) {
+  if (error.message.includes('Insufficient balance')) {
+    await opencloud.requestTopUp();
+  }
+}
+```
+
+## Supported AI Models
+
+OpenCloud uses OpenRouter, giving you access to 100+ models:
+
+**OpenAI:**
+- `openai/gpt-4`
+- `openai/gpt-4-turbo`
+- `openai/gpt-3.5-turbo`
+
+**Anthropic:**
+- `anthropic/claude-3-5-sonnet`
+- `anthropic/claude-3-haiku`
+- `anthropic/claude-3-opus`
+
+**Google:**
+- `google/gemini-pro`
+- `google/gemini-pro-vision`
+
+**Meta:**
+- `meta-llama/llama-3-70b`
+- `meta-llama/llama-3-8b`
+
+**And many more!** See [OpenRouter docs](https://openrouter.ai/docs) for full list.
+
+## Example Apps
+
+### Text Summarizer
+
+```typescript
+import { opencloud } from '@opencloud/sdk';
+
+opencloud.init({ appId: 'text-summarizer' });
+
+async function summarize(text: string) {
+  const response = await opencloud.callAI({
+    model: 'anthropic/claude-3-haiku',  // Fast and cheap
+    prompt: `Summarize this text in 3 bullet points:\n\n${text}`
+  });
+
+  return response.text;
+}
+```
+
+### Image Description Generator
+
+```typescript
+import { opencloud } from '@opencloud/sdk';
+
+opencloud.init({ appId: 'image-describer' });
+
+async function describeImage(imageUrl: string) {
+  const response = await opencloud.callAI({
+    model: 'google/gemini-pro-vision',
+    prompt: 'Describe this image in detail',
+    options: {
+      image: imageUrl
+    }
+  });
+
+  return response.text;
+}
+```
+
+## Revenue Model
+
+OpenCloud uses a **70/30 revenue split**:
+
+- **70%** goes to you (the app creator)
+- **30%** goes to OpenCloud (platform fee)
+
+Example:
+```
+User pays:     $0.10 per use
+AI cost:       -$0.03 (OpenAI API)
+Net revenue:   $0.07
+├─ You get:    $0.049 (70%)
+└─ Platform:   $0.021 (30%)
+```
+
+## TypeScript Support
+
+Full TypeScript definitions included:
+
+```typescript
+import {
+  opencloud,
+  OpenCloudSDK,
+  AICallParams,
+  AIResponse,
+  OpenCloudConfig
+} from '@opencloud/sdk';
+
+const params: AICallParams = {
+  model: 'openai/gpt-4',
+  prompt: 'Hello world'
+};
+
+const response: AIResponse = await opencloud.callAI(params);
+```
+
+## Publishing Your App
+
+1. Build your app with the SDK
+2. Go to [opencloud.com/publish](https://opencloud.com/publish)
+3. Upload your app or connect GitHub
+4. Set pricing and details
+5. Test with $5 free credits
+6. Publish to marketplace!
+
+## Support
+
+- 📚 [Documentation](https://opencloud.com/docs)
+- 💬 [Discord Community](https://discord.gg/opencloud)
+- 🐛 [Report Issues](https://github.com/opencloud/sdk/issues)
+- ✉️ support@opencloud.com
+
+## License
+
+MIT © OpenCloud

package/dist/index.d.mts

@@ -0,0 +1,99 @@
+/**
+ * @opencloud/sdk v1.1.0
+ * Official SDK for OpenCloud - AI App Marketplace
+ *
+ * Features:
+ * - Automatic preview/production mode detection
+ * - Works in bolt.diy/WebContainers preview
+ * - Seamless transition to production with credits
+ */
+interface OpenCloudConfig {
+    appId: string;
+    apiUrl?: string;
+    previewApiKey?: string;
+}
+interface AICallParams {
+    model: string;
+    prompt: string;
+    options?: Record<string, any>;
+}
+interface AIResponse {
+    success: boolean;
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    cost: number;
+    model: string;
+    mode: 'preview' | 'production';
+}
+interface UserSession {
+    token: string;
+}
+declare class OpenCloudSDK {
+    private config;
+    private heartbeatInterval?;
+    private _isPreviewMode;
+    constructor();
+    /**
+     * Detect if running in preview/development mode
+     */
+    private detectPreviewMode;
+    /**
+     * Check if currently in preview mode
+     */
+    isPreview(): boolean;
+    /**
+     * Initialize the SDK
+     */
+    init(options: OpenCloudConfig): void;
+    /**
+     * Set API key for preview mode
+     */
+    setPreviewApiKey(key: string, provider?: 'openrouter' | 'anthropic' | 'openai'): void;
+    /**
+     * Get API key for preview mode
+     */
+    private getPreviewApiKey;
+    /**
+     * Call an AI model - automatically uses preview or production mode
+     */
+    callAI(params: AICallParams): Promise<AIResponse>;
+    /**
+     * Call AI in preview mode (direct to OpenRouter/provider)
+     */
+    private callAIPreview;
+    /**
+     * Call AI in production mode (through OpenCloud API)
+     */
+    private callAIProduction;
+    /**
+     * Get current user's balance (production only)
+     */
+    getBalance(): Promise<number>;
+    /**
+     * Request user to purchase more tokens
+     */
+    requestTopUp(): Promise<void>;
+    /**
+     * Start sending heartbeats
+     */
+    private startHeartbeat;
+    /**
+     * Send heartbeat to platform
+     */
+    private sendHeartbeat;
+    /**
+     * Get user session token
+     */
+    private getUserSession;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+declare const opencloud: OpenCloudSDK;
+
+export { type AICallParams, type AIResponse, type OpenCloudConfig, OpenCloudSDK, type UserSession, opencloud };

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @opencloud/sdk v1.1.0
+ * Official SDK for OpenCloud - AI App Marketplace
+ *
+ * Features:
+ * - Automatic preview/production mode detection
+ * - Works in bolt.diy/WebContainers preview
+ * - Seamless transition to production with credits
+ */
+interface OpenCloudConfig {
+    appId: string;
+    apiUrl?: string;
+    previewApiKey?: string;
+}
+interface AICallParams {
+    model: string;
+    prompt: string;
+    options?: Record<string, any>;
+}
+interface AIResponse {
+    success: boolean;
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    cost: number;
+    model: string;
+    mode: 'preview' | 'production';
+}
+interface UserSession {
+    token: string;
+}
+declare class OpenCloudSDK {
+    private config;
+    private heartbeatInterval?;
+    private _isPreviewMode;
+    constructor();
+    /**
+     * Detect if running in preview/development mode
+     */
+    private detectPreviewMode;
+    /**
+     * Check if currently in preview mode
+     */
+    isPreview(): boolean;
+    /**
+     * Initialize the SDK
+     */
+    init(options: OpenCloudConfig): void;
+    /**
+     * Set API key for preview mode
+     */
+    setPreviewApiKey(key: string, provider?: 'openrouter' | 'anthropic' | 'openai'): void;
+    /**
+     * Get API key for preview mode
+     */
+    private getPreviewApiKey;
+    /**
+     * Call an AI model - automatically uses preview or production mode
+     */
+    callAI(params: AICallParams): Promise<AIResponse>;
+    /**
+     * Call AI in preview mode (direct to OpenRouter/provider)
+     */
+    private callAIPreview;
+    /**
+     * Call AI in production mode (through OpenCloud API)
+     */
+    private callAIProduction;
+    /**
+     * Get current user's balance (production only)
+     */
+    getBalance(): Promise<number>;
+    /**
+     * Request user to purchase more tokens
+     */
+    requestTopUp(): Promise<void>;
+    /**
+     * Start sending heartbeats
+     */
+    private startHeartbeat;
+    /**
+     * Send heartbeat to platform
+     */
+    private sendHeartbeat;
+    /**
+     * Get user session token
+     */
+    private getUserSession;
+    /**
+     * Cleanup
+     */
+    destroy(): void;
+}
+declare const opencloud: OpenCloudSDK;
+
+export { type AICallParams, type AIResponse, type OpenCloudConfig, OpenCloudSDK, type UserSession, opencloud };

package/dist/index.js

@@ -0,0 +1,397 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  OpenCloudSDK: () => OpenCloudSDK,
+  opencloud: () => opencloud
+});
+module.exports = __toCommonJS(index_exports);
+var STORAGE_KEYS = {
+  OPENROUTER_KEY: "openrouter_api_key",
+  ANTHROPIC_KEY: "anthropic_api_key",
+  OPENAI_KEY: "openai_api_key",
+  PREVIEW_PROVIDER: "opencloud_preview_provider"
+};
+var OpenCloudSDK = class {
+  constructor() {
+    this._isPreviewMode = false;
+    this.config = {
+      appId: "",
+      apiUrl: typeof window !== "undefined" ? window.location.origin : "http://localhost:3000",
+      previewApiKey: void 0
+    };
+    if (typeof window !== "undefined") {
+      this._isPreviewMode = this.detectPreviewMode();
+    }
+  }
+  /**
+   * Detect if running in preview/development mode
+   */
+  detectPreviewMode() {
+    if (typeof window === "undefined") return false;
+    const hostname = window.location.hostname;
+    return hostname.includes("webcontainer") || hostname.includes("localhost") || hostname.includes("127.0.0.1") || hostname.includes(".local") || hostname.includes("stackblitz") || hostname.includes("codesandbox");
+  }
+  /**
+   * Check if currently in preview mode
+   */
+  isPreview() {
+    return this._isPreviewMode;
+  }
+  /**
+   * Initialize the SDK
+   */
+  init(options) {
+    if (!options.appId) {
+      throw new Error("OpenCloudSDK: appId is required");
+    }
+    this.config = {
+      appId: options.appId,
+      apiUrl: options.apiUrl || this.config.apiUrl,
+      previewApiKey: options.previewApiKey
+    };
+    if (!this._isPreviewMode) {
+      this.startHeartbeat();
+    }
+    const mode = this._isPreviewMode ? "preview" : "production";
+    console.log(`[OpenCloudSDK] Initialized for app: ${options.appId} (${mode} mode)`);
+  }
+  /**
+   * Set API key for preview mode
+   */
+  setPreviewApiKey(key, provider = "openrouter") {
+    if (typeof window === "undefined") return;
+    const storageKey = provider === "openrouter" ? STORAGE_KEYS.OPENROUTER_KEY : provider === "anthropic" ? STORAGE_KEYS.ANTHROPIC_KEY : STORAGE_KEYS.OPENAI_KEY;
+    localStorage.setItem(storageKey, key);
+    localStorage.setItem(STORAGE_KEYS.PREVIEW_PROVIDER, provider);
+    this.config.previewApiKey = key;
+  }
+  /**
+   * Get API key for preview mode
+   */
+  getPreviewApiKey() {
+    if (typeof window === "undefined") return null;
+    if (this.config.previewApiKey) {
+      return { key: this.config.previewApiKey, provider: "openrouter" };
+    }
+    const provider = localStorage.getItem(STORAGE_KEYS.PREVIEW_PROVIDER) || "openrouter";
+    const storageKey = provider === "openrouter" ? STORAGE_KEYS.OPENROUTER_KEY : provider === "anthropic" ? STORAGE_KEYS.ANTHROPIC_KEY : STORAGE_KEYS.OPENAI_KEY;
+    const key = localStorage.getItem(storageKey);
+    if (key) {
+      return { key, provider };
+    }
+    for (const [name, storageKey2] of Object.entries(STORAGE_KEYS)) {
+      if (name === "PREVIEW_PROVIDER") continue;
+      const key2 = localStorage.getItem(storageKey2);
+      if (key2) {
+        return { key: key2, provider: name.replace("_KEY", "").toLowerCase() };
+      }
+    }
+    return null;
+  }
+  /**
+   * Call an AI model - automatically uses preview or production mode
+   */
+  async callAI(params) {
+    if (!this.config.appId) {
+      throw new Error("OpenCloudSDK: Must call init() before using callAI()");
+    }
+    const { model, prompt, options = {} } = params;
+    if (!model || !prompt) {
+      throw new Error("OpenCloudSDK: model and prompt are required");
+    }
+    if (this._isPreviewMode) {
+      return this.callAIPreview(params);
+    } else {
+      return this.callAIProduction(params);
+    }
+  }
+  /**
+   * Call AI in preview mode (direct to OpenRouter/provider)
+   */
+  async callAIPreview(params) {
+    const { model, prompt, options = {} } = params;
+    const apiKeyInfo = this.getPreviewApiKey();
+    if (!apiKeyInfo) {
+      throw new Error(
+        '[OpenCloudSDK Preview] No API key found. Please set your API key using opencloud.setPreviewApiKey("your-key") or configure it in the builder settings.'
+      );
+    }
+    const { key, provider } = apiKeyInfo;
+    try {
+      let response;
+      let responseData;
+      if (provider === "openrouter" || provider === "openrouter_key") {
+        response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${key}`,
+            "HTTP-Referer": window.location.origin,
+            "X-Title": this.config.appId
+          },
+          body: JSON.stringify({
+            model,
+            messages: [{ role: "user", content: prompt }],
+            ...options
+          })
+        });
+        responseData = await response.json();
+        if (!response.ok) {
+          throw new Error(responseData.error?.message || `OpenRouter API error: ${response.status}`);
+        }
+        return {
+          success: true,
+          text: responseData.choices?.[0]?.message?.content || "",
+          usage: {
+            promptTokens: responseData.usage?.prompt_tokens || 0,
+            completionTokens: responseData.usage?.completion_tokens || 0,
+            totalTokens: responseData.usage?.total_tokens || 0
+          },
+          cost: 0,
+          // Preview mode - no cost tracking
+          model,
+          mode: "preview"
+        };
+      } else if (provider === "anthropic" || provider === "anthropic_key") {
+        response = await fetch("https://api.anthropic.com/v1/messages", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": key,
+            "anthropic-version": "2023-06-01",
+            "anthropic-dangerous-direct-browser-access": "true"
+          },
+          body: JSON.stringify({
+            model: model.replace("anthropic/", ""),
+            max_tokens: options.max_tokens || 1024,
+            messages: [{ role: "user", content: prompt }]
+          })
+        });
+        responseData = await response.json();
+        if (!response.ok) {
+          throw new Error(responseData.error?.message || `Anthropic API error: ${response.status}`);
+        }
+        return {
+          success: true,
+          text: responseData.content?.[0]?.text || "",
+          usage: {
+            promptTokens: responseData.usage?.input_tokens || 0,
+            completionTokens: responseData.usage?.output_tokens || 0,
+            totalTokens: (responseData.usage?.input_tokens || 0) + (responseData.usage?.output_tokens || 0)
+          },
+          cost: 0,
+          model,
+          mode: "preview"
+        };
+      } else if (provider === "openai" || provider === "openai_key") {
+        response = await fetch("https://api.openai.com/v1/chat/completions", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${key}`
+          },
+          body: JSON.stringify({
+            model: model.replace("openai/", ""),
+            messages: [{ role: "user", content: prompt }],
+            ...options
+          })
+        });
+        responseData = await response.json();
+        if (!response.ok) {
+          throw new Error(responseData.error?.message || `OpenAI API error: ${response.status}`);
+        }
+        return {
+          success: true,
+          text: responseData.choices?.[0]?.message?.content || "",
+          usage: {
+            promptTokens: responseData.usage?.prompt_tokens || 0,
+            completionTokens: responseData.usage?.completion_tokens || 0,
+            totalTokens: responseData.usage?.total_tokens || 0
+          },
+          cost: 0,
+          model,
+          mode: "preview"
+        };
+      }
+      throw new Error(`Unsupported provider: ${provider}`);
+    } catch (error) {
+      console.error("[OpenCloudSDK Preview] AI call failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Call AI in production mode (through OpenCloud API)
+   */
+  async callAIProduction(params) {
+    const { model, prompt, options = {} } = params;
+    try {
+      const session = await this.getUserSession();
+      const response = await fetch(`${this.config.apiUrl}/api/ai/call`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${session.token}`
+        },
+        body: JSON.stringify({
+          appId: this.config.appId,
+          model,
+          prompt,
+          options
+        })
+      });
+      if (!response.ok) {
+        const error = await response.json();
+        throw new Error(error.error || `API call failed: ${response.status}`);
+      }
+      const data = await response.json();
+      return {
+        ...data,
+        mode: "production"
+      };
+    } catch (error) {
+      console.error("[OpenCloudSDK Production] AI call failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Get current user's balance (production only)
+   */
+  async getBalance() {
+    if (this._isPreviewMode) {
+      console.warn("[OpenCloudSDK] getBalance() not available in preview mode");
+      return 0;
+    }
+    try {
+      const session = await this.getUserSession();
+      const response = await fetch(`${this.config.apiUrl}/api/user/balance`, {
+        headers: {
+          "Authorization": `Bearer ${session.token}`
+        }
+      });
+      if (!response.ok) {
+        throw new Error("Failed to get balance");
+      }
+      const data = await response.json();
+      return data.balance;
+    } catch (error) {
+      console.error("[OpenCloudSDK] Get balance failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Request user to purchase more tokens
+   */
+  async requestTopUp() {
+    if (typeof window === "undefined") return;
+    if (this._isPreviewMode) {
+      console.warn("[OpenCloudSDK] Top-up not available in preview mode");
+      return;
+    }
+    if (window.parent !== window) {
+      window.parent.postMessage({
+        type: "OPENCLOUD_REQUEST_TOPUP",
+        appId: this.config.appId
+      }, "*");
+    } else {
+      window.location.href = `${this.config.apiUrl}/topup`;
+    }
+  }
+  /**
+   * Start sending heartbeats
+   */
+  startHeartbeat() {
+    if (typeof window === "undefined") return;
+    this.sendHeartbeat();
+    this.heartbeatInterval = setInterval(() => this.sendHeartbeat(), 3e4);
+  }
+  /**
+   * Send heartbeat to platform
+   */
+  sendHeartbeat() {
+    if (!this.config.appId || typeof window === "undefined") return;
+    const data = JSON.stringify({
+      appId: this.config.appId,
+      timestamp: Date.now(),
+      version: "1.1.0",
+      url: window.location.href
+    });
+    if (navigator.sendBeacon) {
+      navigator.sendBeacon(`${this.config.apiUrl}/api/sdk/heartbeat`, data);
+    }
+  }
+  /**
+   * Get user session token
+   */
+  async getUserSession() {
+    if (typeof window === "undefined") {
+      throw new Error("getUserSession can only be called in browser");
+    }
+    return new Promise((resolve, reject) => {
+      if (window.parent !== window) {
+        const messageHandler = (event) => {
+          if (event.data.type === "USER_SESSION_RESPONSE") {
+            window.removeEventListener("message", messageHandler);
+            if (event.data.session) {
+              resolve(event.data.session);
+            } else {
+              reject(new Error("User not authenticated"));
+            }
+          }
+        };
+        window.addEventListener("message", messageHandler);
+        window.parent.postMessage({
+          type: "GET_USER_SESSION",
+          appId: this.config.appId
+        }, "*");
+        setTimeout(() => {
+          window.removeEventListener("message", messageHandler);
+          reject(new Error("Session request timeout"));
+        }, 5e3);
+      } else {
+        const token = localStorage.getItem("opencloud_session_token");
+        if (token) {
+          resolve({ token });
+        } else {
+          reject(new Error("User not authenticated. Please log in."));
+        }
+      }
+    });
+  }
+  /**
+   * Cleanup
+   */
+  destroy() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+    }
+  }
+};
+var opencloud = new OpenCloudSDK();
+if (typeof window !== "undefined") {
+  window.OpenCloudSDK = opencloud;
+  window.PlatformSDK = opencloud;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OpenCloudSDK,
+  opencloud
+});

package/dist/index.mjs

@@ -0,0 +1,371 @@
+// src/index.ts
+var STORAGE_KEYS = {
+  OPENROUTER_KEY: "openrouter_api_key",
+  ANTHROPIC_KEY: "anthropic_api_key",
+  OPENAI_KEY: "openai_api_key",
+  PREVIEW_PROVIDER: "opencloud_preview_provider"
+};
+var OpenCloudSDK = class {
+  constructor() {
+    this._isPreviewMode = false;
+    this.config = {
+      appId: "",
+      apiUrl: typeof window !== "undefined" ? window.location.origin : "http://localhost:3000",
+      previewApiKey: void 0
+    };
+    if (typeof window !== "undefined") {
+      this._isPreviewMode = this.detectPreviewMode();
+    }
+  }
+  /**
+   * Detect if running in preview/development mode
+   */
+  detectPreviewMode() {
+    if (typeof window === "undefined") return false;
+    const hostname = window.location.hostname;
+    return hostname.includes("webcontainer") || hostname.includes("localhost") || hostname.includes("127.0.0.1") || hostname.includes(".local") || hostname.includes("stackblitz") || hostname.includes("codesandbox");
+  }
+  /**
+   * Check if currently in preview mode
+   */
+  isPreview() {
+    return this._isPreviewMode;
+  }
+  /**
+   * Initialize the SDK
+   */
+  init(options) {
+    if (!options.appId) {
+      throw new Error("OpenCloudSDK: appId is required");
+    }
+    this.config = {
+      appId: options.appId,
+      apiUrl: options.apiUrl || this.config.apiUrl,
+      previewApiKey: options.previewApiKey
+    };
+    if (!this._isPreviewMode) {
+      this.startHeartbeat();
+    }
+    const mode = this._isPreviewMode ? "preview" : "production";
+    console.log(`[OpenCloudSDK] Initialized for app: ${options.appId} (${mode} mode)`);
+  }
+  /**
+   * Set API key for preview mode
+   */
+  setPreviewApiKey(key, provider = "openrouter") {
+    if (typeof window === "undefined") return;
+    const storageKey = provider === "openrouter" ? STORAGE_KEYS.OPENROUTER_KEY : provider === "anthropic" ? STORAGE_KEYS.ANTHROPIC_KEY : STORAGE_KEYS.OPENAI_KEY;
+    localStorage.setItem(storageKey, key);
+    localStorage.setItem(STORAGE_KEYS.PREVIEW_PROVIDER, provider);
+    this.config.previewApiKey = key;
+  }
+  /**
+   * Get API key for preview mode
+   */
+  getPreviewApiKey() {
+    if (typeof window === "undefined") return null;
+    if (this.config.previewApiKey) {
+      return { key: this.config.previewApiKey, provider: "openrouter" };
+    }
+    const provider = localStorage.getItem(STORAGE_KEYS.PREVIEW_PROVIDER) || "openrouter";
+    const storageKey = provider === "openrouter" ? STORAGE_KEYS.OPENROUTER_KEY : provider === "anthropic" ? STORAGE_KEYS.ANTHROPIC_KEY : STORAGE_KEYS.OPENAI_KEY;
+    const key = localStorage.getItem(storageKey);
+    if (key) {
+      return { key, provider };
+    }
+    for (const [name, storageKey2] of Object.entries(STORAGE_KEYS)) {
+      if (name === "PREVIEW_PROVIDER") continue;
+      const key2 = localStorage.getItem(storageKey2);
+      if (key2) {
+        return { key: key2, provider: name.replace("_KEY", "").toLowerCase() };
+      }
+    }
+    return null;
+  }
+  /**
+   * Call an AI model - automatically uses preview or production mode
+   */
+  async callAI(params) {
+    if (!this.config.appId) {
+      throw new Error("OpenCloudSDK: Must call init() before using callAI()");
+    }
+    const { model, prompt, options = {} } = params;
+    if (!model || !prompt) {
+      throw new Error("OpenCloudSDK: model and prompt are required");
+    }
+    if (this._isPreviewMode) {
+      return this.callAIPreview(params);
+    } else {
+      return this.callAIProduction(params);
+    }
+  }
+  /**
+   * Call AI in preview mode (direct to OpenRouter/provider)
+   */
+  async callAIPreview(params) {
+    const { model, prompt, options = {} } = params;
+    const apiKeyInfo = this.getPreviewApiKey();
+    if (!apiKeyInfo) {
+      throw new Error(
+        '[OpenCloudSDK Preview] No API key found. Please set your API key using opencloud.setPreviewApiKey("your-key") or configure it in the builder settings.'
+      );
+    }
+    const { key, provider } = apiKeyInfo;
+    try {
+      let response;
+      let responseData;
+      if (provider === "openrouter" || provider === "openrouter_key") {
+        response = await fetch("https://openrouter.ai/api/v1/chat/completions", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${key}`,
+            "HTTP-Referer": window.location.origin,
+            "X-Title": this.config.appId
+          },
+          body: JSON.stringify({
+            model,
+            messages: [{ role: "user", content: prompt }],
+            ...options
+          })
+        });
+        responseData = await response.json();
+        if (!response.ok) {
+          throw new Error(responseData.error?.message || `OpenRouter API error: ${response.status}`);
+        }
+        return {
+          success: true,
+          text: responseData.choices?.[0]?.message?.content || "",
+          usage: {
+            promptTokens: responseData.usage?.prompt_tokens || 0,
+            completionTokens: responseData.usage?.completion_tokens || 0,
+            totalTokens: responseData.usage?.total_tokens || 0
+          },
+          cost: 0,
+          // Preview mode - no cost tracking
+          model,
+          mode: "preview"
+        };
+      } else if (provider === "anthropic" || provider === "anthropic_key") {
+        response = await fetch("https://api.anthropic.com/v1/messages", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": key,
+            "anthropic-version": "2023-06-01",
+            "anthropic-dangerous-direct-browser-access": "true"
+          },
+          body: JSON.stringify({
+            model: model.replace("anthropic/", ""),
+            max_tokens: options.max_tokens || 1024,
+            messages: [{ role: "user", content: prompt }]
+          })
+        });
+        responseData = await response.json();
+        if (!response.ok) {
+          throw new Error(responseData.error?.message || `Anthropic API error: ${response.status}`);
+        }
+        return {
+          success: true,
+          text: responseData.content?.[0]?.text || "",
+          usage: {
+            promptTokens: responseData.usage?.input_tokens || 0,
+            completionTokens: responseData.usage?.output_tokens || 0,
+            totalTokens: (responseData.usage?.input_tokens || 0) + (responseData.usage?.output_tokens || 0)
+          },
+          cost: 0,
+          model,
+          mode: "preview"
+        };
+      } else if (provider === "openai" || provider === "openai_key") {
+        response = await fetch("https://api.openai.com/v1/chat/completions", {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${key}`
+          },
+          body: JSON.stringify({
+            model: model.replace("openai/", ""),
+            messages: [{ role: "user", content: prompt }],
+            ...options
+          })
+        });
+        responseData = await response.json();
+        if (!response.ok) {
+          throw new Error(responseData.error?.message || `OpenAI API error: ${response.status}`);
+        }
+        return {
+          success: true,
+          text: responseData.choices?.[0]?.message?.content || "",
+          usage: {
+            promptTokens: responseData.usage?.prompt_tokens || 0,
+            completionTokens: responseData.usage?.completion_tokens || 0,
+            totalTokens: responseData.usage?.total_tokens || 0
+          },
+          cost: 0,
+          model,
+          mode: "preview"
+        };
+      }
+      throw new Error(`Unsupported provider: ${provider}`);
+    } catch (error) {
+      console.error("[OpenCloudSDK Preview] AI call failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Call AI in production mode (through OpenCloud API)
+   */
+  async callAIProduction(params) {
+    const { model, prompt, options = {} } = params;
+    try {
+      const session = await this.getUserSession();
+      const response = await fetch(`${this.config.apiUrl}/api/ai/call`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${session.token}`
+        },
+        body: JSON.stringify({
+          appId: this.config.appId,
+          model,
+          prompt,
+          options
+        })
+      });
+      if (!response.ok) {
+        const error = await response.json();
+        throw new Error(error.error || `API call failed: ${response.status}`);
+      }
+      const data = await response.json();
+      return {
+        ...data,
+        mode: "production"
+      };
+    } catch (error) {
+      console.error("[OpenCloudSDK Production] AI call failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Get current user's balance (production only)
+   */
+  async getBalance() {
+    if (this._isPreviewMode) {
+      console.warn("[OpenCloudSDK] getBalance() not available in preview mode");
+      return 0;
+    }
+    try {
+      const session = await this.getUserSession();
+      const response = await fetch(`${this.config.apiUrl}/api/user/balance`, {
+        headers: {
+          "Authorization": `Bearer ${session.token}`
+        }
+      });
+      if (!response.ok) {
+        throw new Error("Failed to get balance");
+      }
+      const data = await response.json();
+      return data.balance;
+    } catch (error) {
+      console.error("[OpenCloudSDK] Get balance failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Request user to purchase more tokens
+   */
+  async requestTopUp() {
+    if (typeof window === "undefined") return;
+    if (this._isPreviewMode) {
+      console.warn("[OpenCloudSDK] Top-up not available in preview mode");
+      return;
+    }
+    if (window.parent !== window) {
+      window.parent.postMessage({
+        type: "OPENCLOUD_REQUEST_TOPUP",
+        appId: this.config.appId
+      }, "*");
+    } else {
+      window.location.href = `${this.config.apiUrl}/topup`;
+    }
+  }
+  /**
+   * Start sending heartbeats
+   */
+  startHeartbeat() {
+    if (typeof window === "undefined") return;
+    this.sendHeartbeat();
+    this.heartbeatInterval = setInterval(() => this.sendHeartbeat(), 3e4);
+  }
+  /**
+   * Send heartbeat to platform
+   */
+  sendHeartbeat() {
+    if (!this.config.appId || typeof window === "undefined") return;
+    const data = JSON.stringify({
+      appId: this.config.appId,
+      timestamp: Date.now(),
+      version: "1.1.0",
+      url: window.location.href
+    });
+    if (navigator.sendBeacon) {
+      navigator.sendBeacon(`${this.config.apiUrl}/api/sdk/heartbeat`, data);
+    }
+  }
+  /**
+   * Get user session token
+   */
+  async getUserSession() {
+    if (typeof window === "undefined") {
+      throw new Error("getUserSession can only be called in browser");
+    }
+    return new Promise((resolve, reject) => {
+      if (window.parent !== window) {
+        const messageHandler = (event) => {
+          if (event.data.type === "USER_SESSION_RESPONSE") {
+            window.removeEventListener("message", messageHandler);
+            if (event.data.session) {
+              resolve(event.data.session);
+            } else {
+              reject(new Error("User not authenticated"));
+            }
+          }
+        };
+        window.addEventListener("message", messageHandler);
+        window.parent.postMessage({
+          type: "GET_USER_SESSION",
+          appId: this.config.appId
+        }, "*");
+        setTimeout(() => {
+          window.removeEventListener("message", messageHandler);
+          reject(new Error("Session request timeout"));
+        }, 5e3);
+      } else {
+        const token = localStorage.getItem("opencloud_session_token");
+        if (token) {
+          resolve({ token });
+        } else {
+          reject(new Error("User not authenticated. Please log in."));
+        }
+      }
+    });
+  }
+  /**
+   * Cleanup
+   */
+  destroy() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+    }
+  }
+};
+var opencloud = new OpenCloudSDK();
+if (typeof window !== "undefined") {
+  window.OpenCloudSDK = opencloud;
+  window.PlatformSDK = opencloud;
+}
+export {
+  OpenCloudSDK,
+  opencloud
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "opencloud-platform-sdk",
+  "version": "1.1.0",
+  "description": "Official SDK for OpenCloud - AI App Marketplace",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencloud",
+    "ai",
+    "sdk",
+    "marketplace",
+    "openrouter",
+    "gpt",
+    "claude"
+  ],
+  "author": "OpenCloud",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opencloud/sdk"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  }
+}