@coduckai/sdk 0.1.0 → 0.3.1

package/dist/ai/index.cjs

@@ -12,20 +12,189 @@ function assertServer(moduleName) {
   }
 }
 
+// src/internal/config.ts
+var globalConfig = {};
+function getConfig() {
+  return globalConfig;
+}
+
 // src/ai/index.ts
 assertServer("ai");
-var ai = {
-  chat: notImplemented("ai.chat"),
-  streamChat: notImplemented("ai.streamChat"),
-  streamToSSE: notImplemented("ai.streamToSSE"),
-  generateImage: notImplemented("ai.generateImage"),
-  getProvider: notImplemented("ai.getProvider")
-};
-function notImplemented(name) {
-  return () => {
-    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.2.0.`);
+function detectProvider() {
+  const config = getConfig();
+  if (config.ai?.provider) return config.ai.provider;
+  if (process.env.OPENAI_API_KEY) return "openai";
+  if (process.env.ANTHROPIC_API_KEY) return "anthropic";
+  return null;
+}
+function requireProvider() {
+  const provider = detectProvider();
+  if (!provider) {
+    throw new Error(
+      "@coduckai/sdk/ai: No AI provider configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY."
+    );
+  }
+  return provider;
+}
+async function openaiChat(options) {
+  const { default: OpenAI } = await import('openai');
+  const config = getConfig();
+  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });
+  const messages = [];
+  if (options.system) {
+    messages.push({ role: "system", content: options.system });
+  }
+  messages.push(...options.messages);
+  const response = await client.chat.completions.create({
+    model: options.model || "gpt-4o",
+    messages,
+    max_tokens: options.maxTokens || 4096,
+    temperature: options.temperature ?? 0.7
+  });
+  return {
+    text: response.choices[0]?.message?.content || "",
+    usage: {
+      inputTokens: response.usage?.prompt_tokens || 0,
+      outputTokens: response.usage?.completion_tokens || 0
+    }
   };
 }
+async function* openaiStreamChat(options) {
+  const { default: OpenAI } = await import('openai');
+  const config = getConfig();
+  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });
+  const messages = [];
+  if (options.system) {
+    messages.push({ role: "system", content: options.system });
+  }
+  messages.push(...options.messages);
+  const stream = await client.chat.completions.create({
+    model: options.model || "gpt-4o",
+    messages,
+    max_tokens: options.maxTokens || 4096,
+    temperature: options.temperature ?? 0.7,
+    stream: true
+  });
+  for await (const chunk of stream) {
+    const text = chunk.choices[0]?.delta?.content || "";
+    const done = chunk.choices[0]?.finish_reason !== null && chunk.choices[0]?.finish_reason !== void 0;
+    if (text) yield { text, done: false };
+    if (done) yield { text: "", done: true };
+  }
+}
+async function anthropicChat(options) {
+  const { default: Anthropic } = await import('@anthropic-ai/sdk');
+  const config = getConfig();
+  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });
+  const messages = options.messages.filter((m) => m.role !== "system").map((m) => ({ role: m.role, content: m.content }));
+  const response = await client.messages.create({
+    model: options.model || "claude-sonnet-4-6",
+    max_tokens: options.maxTokens || 4096,
+    ...options.system && { system: options.system },
+    messages,
+    ...options.temperature !== void 0 && { temperature: options.temperature }
+  });
+  const textBlock = response.content.find((b) => b.type === "text");
+  return {
+    text: textBlock?.text || "",
+    usage: {
+      inputTokens: response.usage?.input_tokens || 0,
+      outputTokens: response.usage?.output_tokens || 0
+    }
+  };
+}
+async function* anthropicStreamChat(options) {
+  const { default: Anthropic } = await import('@anthropic-ai/sdk');
+  const config = getConfig();
+  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });
+  const messages = options.messages.filter((m) => m.role !== "system").map((m) => ({ role: m.role, content: m.content }));
+  const stream = client.messages.stream({
+    model: options.model || "claude-sonnet-4-6",
+    max_tokens: options.maxTokens || 4096,
+    ...options.system && { system: options.system },
+    messages,
+    ...options.temperature !== void 0 && { temperature: options.temperature }
+  });
+  for await (const event of stream) {
+    if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
+      yield { text: event.delta.text, done: false };
+    } else if (event.type === "message_stop") {
+      yield { text: "", done: true };
+    }
+  }
+}
+var ai = {
+  /**
+   * Send a chat completion request. Auto-detects OpenAI or Anthropic from env vars.
+   */
+  async chat(options) {
+    const provider = requireProvider();
+    return provider === "openai" ? openaiChat(options) : anthropicChat(options);
+  },
+  /**
+   * Stream a chat completion. Returns an async iterable of text chunks.
+   */
+  streamChat(options) {
+    const provider = requireProvider();
+    return provider === "openai" ? openaiStreamChat(options) : anthropicStreamChat(options);
+  },
+  /**
+   * Stream AI response directly to an Express response as SSE.
+   * Handles headers, streaming, error handling, and cleanup.
+   */
+  async streamToSSE(res, options) {
+    res.writeHead(200, {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive"
+    });
+    try {
+      for await (const chunk of ai.streamChat(options)) {
+        if (chunk.text) {
+          res.write(`data: ${JSON.stringify({ text: chunk.text })}
+
+`);
+        }
+        if (chunk.done) {
+          res.write(`data: ${JSON.stringify({ done: true })}
+
+`);
+        }
+      }
+    } catch (error) {
+      res.write(`data: ${JSON.stringify({ error: error.message })}
+
+`);
+    } finally {
+      res.end();
+    }
+  },
+  /**
+   * Generate an image (OpenAI DALL-E only).
+   */
+  async generateImage(options) {
+    const provider = detectProvider();
+    if (provider !== "openai") {
+      throw new Error("@coduckai/sdk/ai: generateImage() requires OpenAI. Set OPENAI_API_KEY.");
+    }
+    const { default: OpenAI } = await import('openai');
+    const config = getConfig();
+    const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });
+    const response = await client.images.generate({
+      model: "dall-e-3",
+      prompt: options.prompt,
+      size: options.size || "1024x1024",
+      n: 1
+    });
+    return { url: response.data?.[0]?.url || "" };
+  },
+  /**
+   * Returns the detected AI provider ('openai' | 'anthropic' | null).
+   */
+  getProvider() {
+    return detectProvider();
+  }
+};
 
 exports.ai = ai;
 //# sourceMappingURL=index.cjs.map

package/dist/ai/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/internal/env.ts","../../src/ai/index.ts"],"names":[],"mappings":";;;AAgBO,SAAS,QAAA,GAAoB;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAC3B;AAEO,SAAS,aAAa,UAAA,EAA0B;AACrD,EAAA,IAAI,CAAC,UAAS,EAAG;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iBAAiB,UAAU,CAAA,2DAAA;AAAA,KAC7B;AAAA,EACF;AACF;;;ACnBA,YAAA,CAAa,IAAI,CAAA;AAEV,IAAM,EAAA,GAAK;AAAA,EAChB,IAAA,EAAM,eAAe,SAAS,CAAA;AAAA,EAC9B,UAAA,EAAY,eAAe,eAAe,CAAA;AAAA,EAC1C,WAAA,EAAa,eAAe,gBAAgB,CAAA;AAAA,EAC5C,aAAA,EAAe,eAAe,kBAAkB,CAAA;AAAA,EAChD,WAAA,EAAa,eAAe,gBAAgB;AAC9C;AAEA,SAAS,eAAe,IAAA,EAAc;AACpC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,IAAI,CAAA,4CAAA,CAA8C,CAAA;AAAA,EACtF,CAAA;AACF","file":"index.cjs","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * @coduckai/sdk/ai — AI Providers (server-only)\n *\n * Coming in v0.2.0. Unified interface for OpenAI + Anthropic.\n */\n\nimport { assertServer } from '../internal/env';\nassertServer('ai');\n\nexport const ai = {\n  chat: notImplemented('ai.chat'),\n  streamChat: notImplemented('ai.streamChat'),\n  streamToSSE: notImplemented('ai.streamToSSE'),\n  generateImage: notImplemented('ai.generateImage'),\n  getProvider: notImplemented('ai.getProvider'),\n};\n\nfunction notImplemented(name: string) {\n  return () => {\n    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.2.0.`);\n  };\n}\n"]}
+{"version":3,"sources":["../../src/internal/env.ts","../../src/internal/config.ts","../../src/ai/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * Global SDK configuration\n *\n * CoDuck apps use env vars automatically — no configure() needed.\n * Standalone usage can call configure() to override.\n */\n\nexport interface SDKConfig {\n  auth?: {\n    jwtSecret?: string;\n    jwtExpiresIn?: string;\n    bcryptRounds?: number;\n  };\n  db?: {\n    connectionString?: string;\n  };\n  client?: {\n    baseUrl?: string;\n    tokenKey?: string;\n  };\n  payments?: {\n    stripeSecretKey?: string;\n    connectedAccountId?: string;\n    webhookSecret?: string;\n  };\n  ai?: {\n    provider?: 'openai' | 'anthropic';\n    apiKey?: string;\n  };\n}\n\nlet globalConfig: SDKConfig = {};\n\nexport function setConfig(config: SDKConfig): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\nexport function getConfig(): SDKConfig {\n  return globalConfig;\n}\n","/**\n * @coduckai/sdk/ai — AI Providers (server-only)\n *\n * Unified interface for OpenAI and Anthropic. Auto-detects provider from env vars.\n * Set OPENAI_API_KEY for OpenAI or ANTHROPIC_API_KEY for Anthropic.\n */\n\nimport { assertServer } from '../internal/env';\nimport { getConfig } from '../internal/config';\n\nassertServer('ai');\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface ChatMessage {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n}\n\nexport interface ChatOptions {\n  system?: string;\n  messages: ChatMessage[];\n  model?: string;\n  maxTokens?: number;\n  temperature?: number;\n}\n\nexport interface ChatResponse {\n  text: string;\n  usage: { inputTokens: number; outputTokens: number };\n}\n\nexport interface StreamChunk {\n  text: string;\n  done: boolean;\n}\n\nexport type AIProvider = 'openai' | 'anthropic' | null;\n\n// ---------------------------------------------------------------------------\n// Provider detection\n// ---------------------------------------------------------------------------\n\nfunction detectProvider(): AIProvider {\n  const config = getConfig();\n  if (config.ai?.provider) return config.ai.provider;\n  if (process.env.OPENAI_API_KEY) return 'openai';\n  if (process.env.ANTHROPIC_API_KEY) return 'anthropic';\n  return null;\n}\n\nfunction requireProvider(): AIProvider & string {\n  const provider = detectProvider();\n  if (!provider) {\n    throw new Error(\n      '@coduckai/sdk/ai: No AI provider configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY.'\n    );\n  }\n  return provider;\n}\n\n// ---------------------------------------------------------------------------\n// OpenAI\n// ---------------------------------------------------------------------------\n\nasync function openaiChat(options: ChatOptions): Promise<ChatResponse> {\n  const { default: OpenAI } = await import('openai');\n  const config = getConfig();\n  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });\n\n  const messages: Array<{ role: string; content: string }> = [];\n  if (options.system) {\n    messages.push({ role: 'system', content: options.system });\n  }\n  messages.push(...options.messages);\n\n  const response = await client.chat.completions.create({\n    model: options.model || 'gpt-4o',\n    messages: messages as any,\n    max_tokens: options.maxTokens || 4096,\n    temperature: options.temperature ?? 0.7,\n  });\n\n  return {\n    text: response.choices[0]?.message?.content || '',\n    usage: {\n      inputTokens: response.usage?.prompt_tokens || 0,\n      outputTokens: response.usage?.completion_tokens || 0,\n    },\n  };\n}\n\nasync function* openaiStreamChat(options: ChatOptions): AsyncGenerator<StreamChunk> {\n  const { default: OpenAI } = await import('openai');\n  const config = getConfig();\n  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });\n\n  const messages: Array<{ role: string; content: string }> = [];\n  if (options.system) {\n    messages.push({ role: 'system', content: options.system });\n  }\n  messages.push(...options.messages);\n\n  const stream = await client.chat.completions.create({\n    model: options.model || 'gpt-4o',\n    messages: messages as any,\n    max_tokens: options.maxTokens || 4096,\n    temperature: options.temperature ?? 0.7,\n    stream: true,\n  });\n\n  for await (const chunk of stream) {\n    const text = chunk.choices[0]?.delta?.content || '';\n    const done = chunk.choices[0]?.finish_reason !== null && chunk.choices[0]?.finish_reason !== undefined;\n    if (text) yield { text, done: false };\n    if (done) yield { text: '', done: true };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Anthropic\n// ---------------------------------------------------------------------------\n\nasync function anthropicChat(options: ChatOptions): Promise<ChatResponse> {\n  const { default: Anthropic } = await import('@anthropic-ai/sdk');\n  const config = getConfig();\n  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });\n\n  const messages = options.messages\n    .filter(m => m.role !== 'system')\n    .map(m => ({ role: m.role as 'user' | 'assistant', content: m.content }));\n\n  const response = await client.messages.create({\n    model: options.model || 'claude-sonnet-4-6',\n    max_tokens: options.maxTokens || 4096,\n    ...(options.system && { system: options.system }),\n    messages,\n    ...(options.temperature !== undefined && { temperature: options.temperature }),\n  });\n\n  const textBlock = response.content.find((b: any) => b.type === 'text');\n\n  return {\n    text: (textBlock as any)?.text || '',\n    usage: {\n      inputTokens: response.usage?.input_tokens || 0,\n      outputTokens: response.usage?.output_tokens || 0,\n    },\n  };\n}\n\nasync function* anthropicStreamChat(options: ChatOptions): AsyncGenerator<StreamChunk> {\n  const { default: Anthropic } = await import('@anthropic-ai/sdk');\n  const config = getConfig();\n  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });\n\n  const messages = options.messages\n    .filter(m => m.role !== 'system')\n    .map(m => ({ role: m.role as 'user' | 'assistant', content: m.content }));\n\n  const stream = client.messages.stream({\n    model: options.model || 'claude-sonnet-4-6',\n    max_tokens: options.maxTokens || 4096,\n    ...(options.system && { system: options.system }),\n    messages,\n    ...(options.temperature !== undefined && { temperature: options.temperature }),\n  });\n\n  for await (const event of stream) {\n    if (event.type === 'content_block_delta' && (event.delta as any).type === 'text_delta') {\n      yield { text: (event.delta as any).text, done: false };\n    } else if (event.type === 'message_stop') {\n      yield { text: '', done: true };\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// AI API\n// ---------------------------------------------------------------------------\n\nexport const ai = {\n  /**\n   * Send a chat completion request. Auto-detects OpenAI or Anthropic from env vars.\n   */\n  async chat(options: ChatOptions): Promise<ChatResponse> {\n    const provider = requireProvider();\n    return provider === 'openai' ? openaiChat(options) : anthropicChat(options);\n  },\n\n  /**\n   * Stream a chat completion. Returns an async iterable of text chunks.\n   */\n  streamChat(options: ChatOptions): AsyncGenerator<StreamChunk> {\n    const provider = requireProvider();\n    return provider === 'openai' ? openaiStreamChat(options) : anthropicStreamChat(options);\n  },\n\n  /**\n   * Stream AI response directly to an Express response as SSE.\n   * Handles headers, streaming, error handling, and cleanup.\n   */\n  async streamToSSE(res: any, options: ChatOptions): Promise<void> {\n    res.writeHead(200, {\n      'Content-Type': 'text/event-stream',\n      'Cache-Control': 'no-cache',\n      Connection: 'keep-alive',\n    });\n\n    try {\n      for await (const chunk of ai.streamChat(options)) {\n        if (chunk.text) {\n          res.write(`data: ${JSON.stringify({ text: chunk.text })}\\n\\n`);\n        }\n        if (chunk.done) {\n          res.write(`data: ${JSON.stringify({ done: true })}\\n\\n`);\n        }\n      }\n    } catch (error: any) {\n      res.write(`data: ${JSON.stringify({ error: error.message })}\\n\\n`);\n    } finally {\n      res.end();\n    }\n  },\n\n  /**\n   * Generate an image (OpenAI DALL-E only).\n   */\n  async generateImage(options: { prompt: string; size?: string }): Promise<{ url: string }> {\n    const provider = detectProvider();\n    if (provider !== 'openai') {\n      throw new Error('@coduckai/sdk/ai: generateImage() requires OpenAI. Set OPENAI_API_KEY.');\n    }\n\n    const { default: OpenAI } = await import('openai');\n    const config = getConfig();\n    const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });\n\n    const response = await client.images.generate({\n      model: 'dall-e-3',\n      prompt: options.prompt,\n      size: (options.size as any) || '1024x1024',\n      n: 1,\n    });\n\n    return { url: response.data?.[0]?.url || '' };\n  },\n\n  /**\n   * Returns the detected AI provider ('openai' | 'anthropic' | null).\n   */\n  getProvider(): AIProvider {\n    return detectProvider();\n  },\n};\n"]}

package/dist/ai/index.d.cts

@@ -1,14 +1,59 @@
 /**
  * @coduckai/sdk/ai — AI Providers (server-only)
  *
- * Coming in v0.2.0. Unified interface for OpenAI + Anthropic.
+ * Unified interface for OpenAI and Anthropic. Auto-detects provider from env vars.
+ * Set OPENAI_API_KEY for OpenAI or ANTHROPIC_API_KEY for Anthropic.
  */
+interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+interface ChatOptions {
+    system?: string;
+    messages: ChatMessage[];
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+interface ChatResponse {
+    text: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface StreamChunk {
+    text: string;
+    done: boolean;
+}
+type AIProvider = 'openai' | 'anthropic' | null;
 declare const ai: {
-    chat: () => never;
-    streamChat: () => never;
-    streamToSSE: () => never;
-    generateImage: () => never;
-    getProvider: () => never;
+    /**
+     * Send a chat completion request. Auto-detects OpenAI or Anthropic from env vars.
+     */
+    chat(options: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Stream a chat completion. Returns an async iterable of text chunks.
+     */
+    streamChat(options: ChatOptions): AsyncGenerator<StreamChunk>;
+    /**
+     * Stream AI response directly to an Express response as SSE.
+     * Handles headers, streaming, error handling, and cleanup.
+     */
+    streamToSSE(res: any, options: ChatOptions): Promise<void>;
+    /**
+     * Generate an image (OpenAI DALL-E only).
+     */
+    generateImage(options: {
+        prompt: string;
+        size?: string;
+    }): Promise<{
+        url: string;
+    }>;
+    /**
+     * Returns the detected AI provider ('openai' | 'anthropic' | null).
+     */
+    getProvider(): AIProvider;
 };
 
-export { ai };
+export { type AIProvider, type ChatMessage, type ChatOptions, type ChatResponse, type StreamChunk, ai };

package/dist/ai/index.d.ts

@@ -1,14 +1,59 @@
 /**
  * @coduckai/sdk/ai — AI Providers (server-only)
  *
- * Coming in v0.2.0. Unified interface for OpenAI + Anthropic.
+ * Unified interface for OpenAI and Anthropic. Auto-detects provider from env vars.
+ * Set OPENAI_API_KEY for OpenAI or ANTHROPIC_API_KEY for Anthropic.
  */
+interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+interface ChatOptions {
+    system?: string;
+    messages: ChatMessage[];
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+interface ChatResponse {
+    text: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface StreamChunk {
+    text: string;
+    done: boolean;
+}
+type AIProvider = 'openai' | 'anthropic' | null;
 declare const ai: {
-    chat: () => never;
-    streamChat: () => never;
-    streamToSSE: () => never;
-    generateImage: () => never;
-    getProvider: () => never;
+    /**
+     * Send a chat completion request. Auto-detects OpenAI or Anthropic from env vars.
+     */
+    chat(options: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Stream a chat completion. Returns an async iterable of text chunks.
+     */
+    streamChat(options: ChatOptions): AsyncGenerator<StreamChunk>;
+    /**
+     * Stream AI response directly to an Express response as SSE.
+     * Handles headers, streaming, error handling, and cleanup.
+     */
+    streamToSSE(res: any, options: ChatOptions): Promise<void>;
+    /**
+     * Generate an image (OpenAI DALL-E only).
+     */
+    generateImage(options: {
+        prompt: string;
+        size?: string;
+    }): Promise<{
+        url: string;
+    }>;
+    /**
+     * Returns the detected AI provider ('openai' | 'anthropic' | null).
+     */
+    getProvider(): AIProvider;
 };
 
-export { ai };
+export { type AIProvider, type ChatMessage, type ChatOptions, type ChatResponse, type StreamChunk, ai };

package/dist/ai/index.js

@@ -10,20 +10,189 @@ function assertServer(moduleName) {
   }
 }
 
+// src/internal/config.ts
+var globalConfig = {};
+function getConfig() {
+  return globalConfig;
+}
+
 // src/ai/index.ts
 assertServer("ai");
-var ai = {
-  chat: notImplemented("ai.chat"),
-  streamChat: notImplemented("ai.streamChat"),
-  streamToSSE: notImplemented("ai.streamToSSE"),
-  generateImage: notImplemented("ai.generateImage"),
-  getProvider: notImplemented("ai.getProvider")
-};
-function notImplemented(name) {
-  return () => {
-    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.2.0.`);
+function detectProvider() {
+  const config = getConfig();
+  if (config.ai?.provider) return config.ai.provider;
+  if (process.env.OPENAI_API_KEY) return "openai";
+  if (process.env.ANTHROPIC_API_KEY) return "anthropic";
+  return null;
+}
+function requireProvider() {
+  const provider = detectProvider();
+  if (!provider) {
+    throw new Error(
+      "@coduckai/sdk/ai: No AI provider configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY."
+    );
+  }
+  return provider;
+}
+async function openaiChat(options) {
+  const { default: OpenAI } = await import('openai');
+  const config = getConfig();
+  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });
+  const messages = [];
+  if (options.system) {
+    messages.push({ role: "system", content: options.system });
+  }
+  messages.push(...options.messages);
+  const response = await client.chat.completions.create({
+    model: options.model || "gpt-4o",
+    messages,
+    max_tokens: options.maxTokens || 4096,
+    temperature: options.temperature ?? 0.7
+  });
+  return {
+    text: response.choices[0]?.message?.content || "",
+    usage: {
+      inputTokens: response.usage?.prompt_tokens || 0,
+      outputTokens: response.usage?.completion_tokens || 0
+    }
   };
 }
+async function* openaiStreamChat(options) {
+  const { default: OpenAI } = await import('openai');
+  const config = getConfig();
+  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });
+  const messages = [];
+  if (options.system) {
+    messages.push({ role: "system", content: options.system });
+  }
+  messages.push(...options.messages);
+  const stream = await client.chat.completions.create({
+    model: options.model || "gpt-4o",
+    messages,
+    max_tokens: options.maxTokens || 4096,
+    temperature: options.temperature ?? 0.7,
+    stream: true
+  });
+  for await (const chunk of stream) {
+    const text = chunk.choices[0]?.delta?.content || "";
+    const done = chunk.choices[0]?.finish_reason !== null && chunk.choices[0]?.finish_reason !== void 0;
+    if (text) yield { text, done: false };
+    if (done) yield { text: "", done: true };
+  }
+}
+async function anthropicChat(options) {
+  const { default: Anthropic } = await import('@anthropic-ai/sdk');
+  const config = getConfig();
+  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });
+  const messages = options.messages.filter((m) => m.role !== "system").map((m) => ({ role: m.role, content: m.content }));
+  const response = await client.messages.create({
+    model: options.model || "claude-sonnet-4-6",
+    max_tokens: options.maxTokens || 4096,
+    ...options.system && { system: options.system },
+    messages,
+    ...options.temperature !== void 0 && { temperature: options.temperature }
+  });
+  const textBlock = response.content.find((b) => b.type === "text");
+  return {
+    text: textBlock?.text || "",
+    usage: {
+      inputTokens: response.usage?.input_tokens || 0,
+      outputTokens: response.usage?.output_tokens || 0
+    }
+  };
+}
+async function* anthropicStreamChat(options) {
+  const { default: Anthropic } = await import('@anthropic-ai/sdk');
+  const config = getConfig();
+  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });
+  const messages = options.messages.filter((m) => m.role !== "system").map((m) => ({ role: m.role, content: m.content }));
+  const stream = client.messages.stream({
+    model: options.model || "claude-sonnet-4-6",
+    max_tokens: options.maxTokens || 4096,
+    ...options.system && { system: options.system },
+    messages,
+    ...options.temperature !== void 0 && { temperature: options.temperature }
+  });
+  for await (const event of stream) {
+    if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
+      yield { text: event.delta.text, done: false };
+    } else if (event.type === "message_stop") {
+      yield { text: "", done: true };
+    }
+  }
+}
+var ai = {
+  /**
+   * Send a chat completion request. Auto-detects OpenAI or Anthropic from env vars.
+   */
+  async chat(options) {
+    const provider = requireProvider();
+    return provider === "openai" ? openaiChat(options) : anthropicChat(options);
+  },
+  /**
+   * Stream a chat completion. Returns an async iterable of text chunks.
+   */
+  streamChat(options) {
+    const provider = requireProvider();
+    return provider === "openai" ? openaiStreamChat(options) : anthropicStreamChat(options);
+  },
+  /**
+   * Stream AI response directly to an Express response as SSE.
+   * Handles headers, streaming, error handling, and cleanup.
+   */
+  async streamToSSE(res, options) {
+    res.writeHead(200, {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive"
+    });
+    try {
+      for await (const chunk of ai.streamChat(options)) {
+        if (chunk.text) {
+          res.write(`data: ${JSON.stringify({ text: chunk.text })}
+
+`);
+        }
+        if (chunk.done) {
+          res.write(`data: ${JSON.stringify({ done: true })}
+
+`);
+        }
+      }
+    } catch (error) {
+      res.write(`data: ${JSON.stringify({ error: error.message })}
+
+`);
+    } finally {
+      res.end();
+    }
+  },
+  /**
+   * Generate an image (OpenAI DALL-E only).
+   */
+  async generateImage(options) {
+    const provider = detectProvider();
+    if (provider !== "openai") {
+      throw new Error("@coduckai/sdk/ai: generateImage() requires OpenAI. Set OPENAI_API_KEY.");
+    }
+    const { default: OpenAI } = await import('openai');
+    const config = getConfig();
+    const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });
+    const response = await client.images.generate({
+      model: "dall-e-3",
+      prompt: options.prompt,
+      size: options.size || "1024x1024",
+      n: 1
+    });
+    return { url: response.data?.[0]?.url || "" };
+  },
+  /**
+   * Returns the detected AI provider ('openai' | 'anthropic' | null).
+   */
+  getProvider() {
+    return detectProvider();
+  }
+};
 
 export { ai };
 //# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/internal/env.ts","../../src/ai/index.ts"],"names":[],"mappings":";AAgBO,SAAS,QAAA,GAAoB;AAClC,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAC3B;AAEO,SAAS,aAAa,UAAA,EAA0B;AACrD,EAAA,IAAI,CAAC,UAAS,EAAG;AACf,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iBAAiB,UAAU,CAAA,2DAAA;AAAA,KAC7B;AAAA,EACF;AACF;;;ACnBA,YAAA,CAAa,IAAI,CAAA;AAEV,IAAM,EAAA,GAAK;AAAA,EAChB,IAAA,EAAM,eAAe,SAAS,CAAA;AAAA,EAC9B,UAAA,EAAY,eAAe,eAAe,CAAA;AAAA,EAC1C,WAAA,EAAa,eAAe,gBAAgB,CAAA;AAAA,EAC5C,aAAA,EAAe,eAAe,kBAAkB,CAAA;AAAA,EAChD,WAAA,EAAa,eAAe,gBAAgB;AAC9C;AAEA,SAAS,eAAe,IAAA,EAAc;AACpC,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,IAAI,CAAA,4CAAA,CAA8C,CAAA;AAAA,EACtF,CAAA;AACF","file":"index.js","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * @coduckai/sdk/ai — AI Providers (server-only)\n *\n * Coming in v0.2.0. Unified interface for OpenAI + Anthropic.\n */\n\nimport { assertServer } from '../internal/env';\nassertServer('ai');\n\nexport const ai = {\n  chat: notImplemented('ai.chat'),\n  streamChat: notImplemented('ai.streamChat'),\n  streamToSSE: notImplemented('ai.streamToSSE'),\n  generateImage: notImplemented('ai.generateImage'),\n  getProvider: notImplemented('ai.getProvider'),\n};\n\nfunction notImplemented(name: string) {\n  return () => {\n    throw new Error(`@coduckai/sdk: ${name}() is not yet implemented. Coming in v0.2.0.`);\n  };\n}\n"]}
+{"version":3,"sources":["../../src/internal/env.ts","../../src/internal/config.ts","../../src/ai/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Environment variable helpers\n */\n\nexport function getEnv(key: string, fallback?: string): string | undefined {\n  return process.env[key] || fallback;\n}\n\nexport function requireEnv(key: string): string {\n  const val = process.env[key];\n  if (!val) {\n    throw new Error(`@coduckai/sdk: Missing required environment variable: ${key}`);\n  }\n  return val;\n}\n\nexport function isServer(): boolean {\n  return typeof window === 'undefined';\n}\n\nexport function assertServer(moduleName: string): void {\n  if (!isServer()) {\n    throw new Error(\n      `@coduckai/sdk/${moduleName} is server-only. Use @coduckai/sdk/client for browser code.`\n    );\n  }\n}\n","/**\n * Global SDK configuration\n *\n * CoDuck apps use env vars automatically — no configure() needed.\n * Standalone usage can call configure() to override.\n */\n\nexport interface SDKConfig {\n  auth?: {\n    jwtSecret?: string;\n    jwtExpiresIn?: string;\n    bcryptRounds?: number;\n  };\n  db?: {\n    connectionString?: string;\n  };\n  client?: {\n    baseUrl?: string;\n    tokenKey?: string;\n  };\n  payments?: {\n    stripeSecretKey?: string;\n    connectedAccountId?: string;\n    webhookSecret?: string;\n  };\n  ai?: {\n    provider?: 'openai' | 'anthropic';\n    apiKey?: string;\n  };\n}\n\nlet globalConfig: SDKConfig = {};\n\nexport function setConfig(config: SDKConfig): void {\n  globalConfig = { ...globalConfig, ...config };\n}\n\nexport function getConfig(): SDKConfig {\n  return globalConfig;\n}\n","/**\n * @coduckai/sdk/ai — AI Providers (server-only)\n *\n * Unified interface for OpenAI and Anthropic. Auto-detects provider from env vars.\n * Set OPENAI_API_KEY for OpenAI or ANTHROPIC_API_KEY for Anthropic.\n */\n\nimport { assertServer } from '../internal/env';\nimport { getConfig } from '../internal/config';\n\nassertServer('ai');\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface ChatMessage {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n}\n\nexport interface ChatOptions {\n  system?: string;\n  messages: ChatMessage[];\n  model?: string;\n  maxTokens?: number;\n  temperature?: number;\n}\n\nexport interface ChatResponse {\n  text: string;\n  usage: { inputTokens: number; outputTokens: number };\n}\n\nexport interface StreamChunk {\n  text: string;\n  done: boolean;\n}\n\nexport type AIProvider = 'openai' | 'anthropic' | null;\n\n// ---------------------------------------------------------------------------\n// Provider detection\n// ---------------------------------------------------------------------------\n\nfunction detectProvider(): AIProvider {\n  const config = getConfig();\n  if (config.ai?.provider) return config.ai.provider;\n  if (process.env.OPENAI_API_KEY) return 'openai';\n  if (process.env.ANTHROPIC_API_KEY) return 'anthropic';\n  return null;\n}\n\nfunction requireProvider(): AIProvider & string {\n  const provider = detectProvider();\n  if (!provider) {\n    throw new Error(\n      '@coduckai/sdk/ai: No AI provider configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY.'\n    );\n  }\n  return provider;\n}\n\n// ---------------------------------------------------------------------------\n// OpenAI\n// ---------------------------------------------------------------------------\n\nasync function openaiChat(options: ChatOptions): Promise<ChatResponse> {\n  const { default: OpenAI } = await import('openai');\n  const config = getConfig();\n  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });\n\n  const messages: Array<{ role: string; content: string }> = [];\n  if (options.system) {\n    messages.push({ role: 'system', content: options.system });\n  }\n  messages.push(...options.messages);\n\n  const response = await client.chat.completions.create({\n    model: options.model || 'gpt-4o',\n    messages: messages as any,\n    max_tokens: options.maxTokens || 4096,\n    temperature: options.temperature ?? 0.7,\n  });\n\n  return {\n    text: response.choices[0]?.message?.content || '',\n    usage: {\n      inputTokens: response.usage?.prompt_tokens || 0,\n      outputTokens: response.usage?.completion_tokens || 0,\n    },\n  };\n}\n\nasync function* openaiStreamChat(options: ChatOptions): AsyncGenerator<StreamChunk> {\n  const { default: OpenAI } = await import('openai');\n  const config = getConfig();\n  const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });\n\n  const messages: Array<{ role: string; content: string }> = [];\n  if (options.system) {\n    messages.push({ role: 'system', content: options.system });\n  }\n  messages.push(...options.messages);\n\n  const stream = await client.chat.completions.create({\n    model: options.model || 'gpt-4o',\n    messages: messages as any,\n    max_tokens: options.maxTokens || 4096,\n    temperature: options.temperature ?? 0.7,\n    stream: true,\n  });\n\n  for await (const chunk of stream) {\n    const text = chunk.choices[0]?.delta?.content || '';\n    const done = chunk.choices[0]?.finish_reason !== null && chunk.choices[0]?.finish_reason !== undefined;\n    if (text) yield { text, done: false };\n    if (done) yield { text: '', done: true };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Anthropic\n// ---------------------------------------------------------------------------\n\nasync function anthropicChat(options: ChatOptions): Promise<ChatResponse> {\n  const { default: Anthropic } = await import('@anthropic-ai/sdk');\n  const config = getConfig();\n  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });\n\n  const messages = options.messages\n    .filter(m => m.role !== 'system')\n    .map(m => ({ role: m.role as 'user' | 'assistant', content: m.content }));\n\n  const response = await client.messages.create({\n    model: options.model || 'claude-sonnet-4-6',\n    max_tokens: options.maxTokens || 4096,\n    ...(options.system && { system: options.system }),\n    messages,\n    ...(options.temperature !== undefined && { temperature: options.temperature }),\n  });\n\n  const textBlock = response.content.find((b: any) => b.type === 'text');\n\n  return {\n    text: (textBlock as any)?.text || '',\n    usage: {\n      inputTokens: response.usage?.input_tokens || 0,\n      outputTokens: response.usage?.output_tokens || 0,\n    },\n  };\n}\n\nasync function* anthropicStreamChat(options: ChatOptions): AsyncGenerator<StreamChunk> {\n  const { default: Anthropic } = await import('@anthropic-ai/sdk');\n  const config = getConfig();\n  const client = new Anthropic({ apiKey: config.ai?.apiKey || process.env.ANTHROPIC_API_KEY });\n\n  const messages = options.messages\n    .filter(m => m.role !== 'system')\n    .map(m => ({ role: m.role as 'user' | 'assistant', content: m.content }));\n\n  const stream = client.messages.stream({\n    model: options.model || 'claude-sonnet-4-6',\n    max_tokens: options.maxTokens || 4096,\n    ...(options.system && { system: options.system }),\n    messages,\n    ...(options.temperature !== undefined && { temperature: options.temperature }),\n  });\n\n  for await (const event of stream) {\n    if (event.type === 'content_block_delta' && (event.delta as any).type === 'text_delta') {\n      yield { text: (event.delta as any).text, done: false };\n    } else if (event.type === 'message_stop') {\n      yield { text: '', done: true };\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// AI API\n// ---------------------------------------------------------------------------\n\nexport const ai = {\n  /**\n   * Send a chat completion request. Auto-detects OpenAI or Anthropic from env vars.\n   */\n  async chat(options: ChatOptions): Promise<ChatResponse> {\n    const provider = requireProvider();\n    return provider === 'openai' ? openaiChat(options) : anthropicChat(options);\n  },\n\n  /**\n   * Stream a chat completion. Returns an async iterable of text chunks.\n   */\n  streamChat(options: ChatOptions): AsyncGenerator<StreamChunk> {\n    const provider = requireProvider();\n    return provider === 'openai' ? openaiStreamChat(options) : anthropicStreamChat(options);\n  },\n\n  /**\n   * Stream AI response directly to an Express response as SSE.\n   * Handles headers, streaming, error handling, and cleanup.\n   */\n  async streamToSSE(res: any, options: ChatOptions): Promise<void> {\n    res.writeHead(200, {\n      'Content-Type': 'text/event-stream',\n      'Cache-Control': 'no-cache',\n      Connection: 'keep-alive',\n    });\n\n    try {\n      for await (const chunk of ai.streamChat(options)) {\n        if (chunk.text) {\n          res.write(`data: ${JSON.stringify({ text: chunk.text })}\\n\\n`);\n        }\n        if (chunk.done) {\n          res.write(`data: ${JSON.stringify({ done: true })}\\n\\n`);\n        }\n      }\n    } catch (error: any) {\n      res.write(`data: ${JSON.stringify({ error: error.message })}\\n\\n`);\n    } finally {\n      res.end();\n    }\n  },\n\n  /**\n   * Generate an image (OpenAI DALL-E only).\n   */\n  async generateImage(options: { prompt: string; size?: string }): Promise<{ url: string }> {\n    const provider = detectProvider();\n    if (provider !== 'openai') {\n      throw new Error('@coduckai/sdk/ai: generateImage() requires OpenAI. Set OPENAI_API_KEY.');\n    }\n\n    const { default: OpenAI } = await import('openai');\n    const config = getConfig();\n    const client = new OpenAI({ apiKey: config.ai?.apiKey || process.env.OPENAI_API_KEY });\n\n    const response = await client.images.generate({\n      model: 'dall-e-3',\n      prompt: options.prompt,\n      size: (options.size as any) || '1024x1024',\n      n: 1,\n    });\n\n    return { url: response.data?.[0]?.url || '' };\n  },\n\n  /**\n   * Returns the detected AI provider ('openai' | 'anthropic' | null).\n   */\n  getProvider(): AIProvider {\n    return detectProvider();\n  },\n};\n"]}