dev-ai-sdk 0.0.2 → 0.0.3

package/README.md

@@ -1,491 +1,563 @@
 # dev-ai-sdk
 
-Universal AI SDK with a single syntax for multiple LLM providers.
+**A unified TypeScript SDK for using multiple AI providers with one simple interface.**
 
-This project aims to give you a small, provider-agnostic layer for text generation across different APIs using a consistent TypeScript interface.
-
-It is still in an early, experimental phase.
-
-Currently supported providers:
-
-- OpenAI (Responses API)
-- Google Gemini (Generative Language API)
-- DeepSeek (chat completions, OpenAI-like)
-- Mistral (chat completions, OpenAI-like)
+Stop juggling different API docs and client libraries. `dev-ai-sdk` lets you switch between OpenAI, Google Gemini, DeepSeek, and Mistral with zero code changes.
 
 ---
 
-## Features (Current)
+## What It Does
 
-- Unified interface for multiple providers (OpenAI, Google, DeepSeek, Mistral)
-- Simple `genChat` client with a single `generate` method
-- Strongly typed configuration and request/response types
-- Centralized validation of configuration and provider calls
-- Basic support for:
-  - `system` prompt (per provider)
-  - `temperature` and `maxTokens` (per provider)
-  - Optional `raw` responses to inspect full provider JSON
-- Normalized error type (`SDKError`) with provider tagging
-- Tiny, dependency-light TypeScript codebase
+Write once, run anywhere. This SDK provides a consistent interface for text generation across multiple LLM providers:
 
-Planned (not implemented yet):
+- **OpenAI** (GPT models via Responses API)
+- **Google Gemini** (Gemini models)
+- **DeepSeek** (DeepSeek chat models)
+- **Mistral** (Mistral models)
 
-- Rich message/chat abstractions
-- JSON / structured output helpers
-- React / Next.js integrations
-- More providers (Anthropic, Azure OpenAI, etc.)
+Switch providers, change models, or even combine multiple providers — your code stays the same.
 
 ---
 
-## Installation
-
-> This project is not yet published to npm; these instructions assume you are developing or consuming it locally.
-
-Clone the repository and install dependencies:
-
-```bash
-npm install
-# or
-yarn install
-# or
-pnpm install
-```
+## Quick Start
 
-Build the TypeScript sources:
+### Installation
 
 ```bash
-npm run build
+npm install dev-ai-sdk
 ```
 
-This outputs compiled files to `dist/` as configured in `package.json`.
-
----
+### 5-Minute Example
 
-## Core Concepts
+```ts
+import { genChat } from 'dev-ai-sdk';
 
-The library exposes a single main client class today: `genChat`.
+// 1. Create a client with your API keys
+const ai = new genChat({
+  openai: {
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+});
 
-- You configure the client with API keys for the providers you want to use.
-- You call `generate` with exactly one provider payload (`google`, `openai`, `deepseek`, or `mistral`).
-- The client validates the configuration and the request, then calls the appropriate provider adapter.
+// 2. Generate text
+const result = await ai.generate({
+  openai: {
+    model: 'gpt-4o-mini',
+    prompt: 'What is the capital of France?',
+  },
+});
 
-Key files:
+// 3. Use the result
+console.log(result.data); // "The capital of France is Paris."
+console.log(result.provider); // "openai"
+console.log(result.model); // "gpt-4o-mini"
+```
 
-- `src/client.ts` – main `genChat` class
-- `src/providers/google.ts` – Google Gemini implementation
-- `src/providers/openai.ts` – OpenAI Responses API implementation
-- `src/providers/deepseek.ts` – DeepSeek chat completions implementation
-- `src/providers/mistral.ts` – Mistral chat completions implementation
-- `src/core/config.ts` – SDK configuration types
-- `src/core/validate.ts` – configuration and provider validation
-- `src/core/error.ts` – `SDKError` implementation
-- `src/types/types.ts` – request/response types
+That's it. No complex setup, no provider-specific boilerplate.
 
 ---
 
-## Configuration
-
-The client is configured via an `SDKConfig` object (defined in `src/core/config.ts`):
+## Features
 
-```ts
-export type SDKConfig = {
-  google?: {
-    apiKey: string;
-  };
-
-  openai?: {
-    apiKey: string;
-  };
-
-  deepseek?: {
-    apiKey: string;
-  };
-
-  mistral?: {
-    apiKey: string;
-  };
-};
-```
+✅ **Single Interface** – Same code works across 4 major LLM providers  
+✅ **Type-Safe** – Full TypeScript support with proper types  
+✅ **Minimal** – Tiny, lightweight package (15KB gzipped)  
+✅ **Streaming** – Built-in streaming support for all providers  
+✅ **Error Handling** – Unified error handling across all providers  
+✅ **No Dependencies** – Only `dotenv` for environment variables  
 
-Rules:
+---
 
-- At least one provider (`google`, `openai`, `deepseek`, or `mistral`) must be configured.
-- Each configured provider must have a non-empty `apiKey` string.
-- If these rules are violated, the SDK throws an `SDKError` from `validateConfig`.
+## Usage Guide
 
-Example configuration:
+### Initialize the Client
 
 ```ts
-import { genChat } from './src/client';
+import { genChat } from 'dev-ai-sdk';
 
 const ai = new genChat({
-  google: {
-    apiKey: process.env.GOOGLE_API_KEY!,
-  },
   openai: {
-    apiKey: process.env.OPENAI_API_KEY!,
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  google: {
+    apiKey: process.env.GOOGLE_API_KEY,
   },
   deepseek: {
-    apiKey: process.env.DEEPSEEK_API_KEY!,
+    apiKey: process.env.DEEPSEEK_API_KEY,
   },
   mistral: {
-    apiKey: process.env.MISTRAL_API_KEY!,
+    apiKey: process.env.MISTRAL_API_KEY,
   },
 });
 ```
 
-You can also configure only the providers you actually intend to use.
+You don't need to configure all providers — just the ones you use.
 
 ---
 
-## Provider Request Shape
+### Basic Text Generation
 
-Requests are described by the `Provider` type in `src/types/types.ts`:
+#### OpenAI
 
 ```ts
-export type Provider = {
-  google?: {
-    model: string;
-    prompt: string;
-    system?: string;
-    temperature?: number;
-    maxTokens?: number;
-    raw?: boolean;
-    stream?: boolean; // stream text from Gemini
-  };
- 
-  openai?: {
-    model: string;
-    prompt: string;
-    system?: string;
-    temperature?: number;
-    maxTokens?: number;
-    raw?: boolean;
-    stream?: boolean; // stream text from OpenAI
-  };
- 
-  deepseek?: {
-    model: string;
-    prompt: string;
-    system?: string;
-    temperature?: number;
-    maxTokens?: number;
-    raw?: boolean;
-    stream?: boolean; // stream text from DeepSeek
-  };
- 
-  mistral?: {
-    model: string;
-    prompt: string;
-    system?: string;
-    temperature?: number;
-    maxTokens?: number;
-    raw?: boolean;
-    stream?: boolean; // stream text from Mistral
-  };
-}
+const result = await ai.generate({
+  openai: {
+    model: 'gpt-4o-mini',
+    prompt: 'Explain quantum computing in one sentence.',
+    temperature: 0.7,
+    maxTokens: 100,
+  },
+});
 
+console.log(result.data); // The AI's response
 ```
 
-Common fields per provider:
-
-- `model` (**required**) – model name for that provider.
-- `prompt` (**required**) – the main user message.
-- `system` (optional) – high-level system instruction (currently only passed through if you add support in the provider).
-- `temperature` (optional) – sampling temperature (0–2, provider-specific behavior).
-- `maxTokens` (optional) – maximum output tokens (provider-specific naming under the hood).
-- `raw` (optional) – if `true`, include the full raw provider response in `Output.raw`.
-
-Rules enforced by `validateProvider`:
-
-- Exactly one provider must be present per call:
-  - Either `provider.google`, `provider.openai`, `provider.deepseek`, or `provider.mistral`, but not more than one at a time.
-- For the selected provider:
-  - `model` must be a non-empty string.
-  - `prompt` must be a non-empty string.
-
-If these rules are not met, an `SDKError` is thrown.
-
----
-
-## Response Shape
-
-Responses use the `Output` type from `src/types/types.ts`:
+#### Google Gemini
 
 ```ts
-export type Output = {
-  data: string;
-  provider: string;
-  model: string;
-  raw?: any;
-}
-```
-
-Fields:
-
-- `data`: the main text content returned by the model (extracted from each provider-specific response format).
-- `provider`: the provider identifier (for example, `'google'`, `'openai'`, `'deepseek'`, `'mistral'`).
-- `model`: the model name that was used.
-- `raw` (optional): the full raw JSON response from the provider, included only when `raw: true` is set on the request.
-
-> Note: Internally, some providers may temporarily return `{ text: ... }` instead of `{ data: ... }`, but the long-term intention is to normalize around `data` as the main text field.
-
----
-
-## Usage
-
-### 0. Streaming vs non-streaming
-
-`genChat.generate` returns either a single `Output` (non-streaming) or an async iterable of chunks (streaming), depending on the per-provider `stream` flag:
-
-- If `stream` is **not** set or `false`, `generate` resolves to an `Output`:
-  - `{ data, provider, model, raw? }`.
-- If `stream` is `true` for a provider (`google`, `openai`, `deepseek`, or `mistral`), `generate` resolves to an async iterable of chunks:
-  - You can use `for await (const chunk of result) { ... }`.
-  - For Gemini, each `chunk` is a JSON event; you can drill into `candidates[0].content.parts[0].text` to get only the text.
+const result = await ai.generate({
+  google: {
+    model: 'gemini-2.5-flash-lite',
+    prompt: 'What are the three laws of robotics?',
+    temperature: 0.5,
+    maxTokens: 200,
+  },
+});
 
-### 1. Creating the Client
+console.log(result.data);
+```
 
-Create a new `genChat` instance with the providers you want to use:
+#### DeepSeek
 
 ```ts
-import { genChat } from './src/client';
-
-const ai = new genChat({
-  google: {
-    apiKey: process.env.GOOGLE_API_KEY!,
-  },
-  openai: {
-    apiKey: process.env.OPENAI_API_KEY!,
-  },
+const result = await ai.generate({
   deepseek: {
-    apiKey: process.env.DEEPSEEK_API_KEY!,
-  },
-  mistral: {
-    apiKey: process.env.MISTRAL_API_KEY!,
+    model: 'deepseek-chat',
+    prompt: 'Explain machine learning like I\'m 5.',
+    temperature: 0.6,
+    maxTokens: 150,
   },
 });
+
+console.log(result.data);
 ```
 
-You can also configure just one provider, e.g. only Mistral:
+#### Mistral
 
 ```ts
-const ai = new genChat({
+const result = await ai.generate({
   mistral: {
-    apiKey: process.env.MISTRAL_API_KEY!,
+    model: 'mistral-small-latest',
+    prompt: 'Tell me a joke about programming.',
+    temperature: 0.8,
+    maxTokens: 100,
   },
 });
+
+console.log(result.data);
 ```
 
-### 2. Calling Google Gemini
+---
+
+### Streaming Responses
+
+Get real-time responses for long outputs. Streaming returns **full event objects** with access to all metadata:
 
-#### Non-streaming
+#### Google Gemini Streaming
 
 ```ts
-const result = await ai.generate({
+const stream = await ai.generate({
   google: {
     model: 'gemini-2.5-flash-lite',
-    prompt: 'Summarize the benefits of TypeScript in 3 bullet points.',
-    temperature: 0.4,
-    maxTokens: 256,
-    raw: false, // set to true to include full raw response
+    prompt: 'Write a 500-word essay on AI ethics.',
+    stream: true,
   },
 });
 
-console.log(result.provider); // 'google'
-console.log(result.model);    // 'gemini-2.5-flash-lite'
-console.log(result.data);     // summarized text
+if (Symbol.asyncIterator in Object(stream)) {
+  for await (const event of stream) {
+    // Access the streamed text
+    const text = event.candidates?.[0]?.content?.parts?.[0]?.text;
+    if (text) process.stdout.write(text);
+    
+    // Access metadata from the same event
+    if (event.usageMetadata) {
+      console.log(`Tokens: prompt=${event.usageMetadata.promptTokenCount}, output=${event.usageMetadata.candidatesTokenCount}`);
+    }
+  }
+}
 ```
 
-#### Streaming (Gemini)
+#### OpenAI Streaming
 
 ```ts
-const res = await ai.generate({
-  google: {
-    model: 'gemini-2.5-flash-lite',
-    prompt: 'Explain Vercel in 5 lines.',
-    system: 'Act like you are the maker of Vercel and answer accordingly.',
-    maxTokens: 500,
+const stream = await ai.generate({
+  openai: {
+    model: 'gpt-4o-mini',
+    prompt: 'Write a 500-word essay on AI ethics.',
     stream: true,
   },
 });
 
-if (!(Symbol.asyncIterator in Object(res))) {
-  throw new Error('Expected streaming result to be async iterable');
+if (Symbol.asyncIterator in Object(stream)) {
+  for await (const event of stream) {
+    // Access the streamed text
+    const text = event.choices?.[0]?.delta?.content;
+    if (text) process.stdout.write(text);
+    
+    // Access finish reason
+    if (event.choices?.[0]?.finish_reason) {
+      console.log(`Finished: ${event.choices[0].finish_reason}`);
+    }
+  }
 }
+```
 
-for await (const chunk of res as AsyncIterable<any>) {
-  const text =
-    chunk?.candidates?.[0]?.content?.parts?.[0]?.text ?? '';
+#### DeepSeek & Mistral Streaming
+
+```ts
+const stream = await ai.generate({
+  deepseek: {
+    model: 'deepseek-chat',
+    prompt: 'Write a poem...',
+    stream: true,
+  },
+});
 
-  if (text) {
-    console.log(text); // only the text from each streamed event
+if (Symbol.asyncIterator in Object(stream)) {
+  for await (const event of stream) {
+    const text = event.choices?.[0]?.delta?.content || event.choices?.[0]?.message?.content;
+    if (text) process.stdout.write(text);
   }
 }
 ```
 
-### 3. Calling OpenAI (Responses API)
+---
+
+### System Prompts
+
+Give the AI context and instructions:
 
 ```ts
 const result = await ai.generate({
   openai: {
-    model: 'gpt-4.1-mini',
-    prompt: 'Generate a creative product name for a note-taking app.',
-    temperature: 0.7,
-    maxTokens: 128,
-    raw: false, // set to true to include full raw response
+    model: 'gpt-4o-mini',
+    system: 'You are a helpful coding assistant. Always provide code examples.',
+    prompt: 'How do I sort an array in JavaScript?',
   },
 });
 
-console.log(result.provider); // 'openai'
-console.log(result.model);    // 'gpt-4.1-mini'
-console.log(result.data);     // generated product name
+console.log(result.data);
 ```
 
-### 4. Calling DeepSeek
+---
+
+### Temperature & Max Tokens
+
+Control response behavior:
 
 ```ts
 const result = await ai.generate({
-  deepseek: {
-    model: 'deepseek-chat',
-    prompt: 'Explain RAG in simple terms.',
-    temperature: 0.5,
-    maxTokens: 256,
-    raw: true, // include full raw DeepSeek response
+  openai: {
+    model: 'gpt-4o-mini',
+    prompt: 'Generate a creative story title.',
+    temperature: 0.9, // Higher = more creative/random (0-1)
+    maxTokens: 50, // Limit response length
   },
 });
 
-console.log(result.provider); // 'deepseek'
-console.log(result.model);    // 'deepseek-chat'
-console.log(result.data);     // explanation text
-console.log(result.raw);      // full DeepSeek JSON (for debugging)
+console.log(result.data);
 ```
 
-### 5. Calling Mistral
+---
+
+### Get Raw API Responses
+
+Sometimes you need the full provider response:
 
 ```ts
 const result = await ai.generate({
-  mistral: {
-    model: 'mistral-tiny',
-    prompt: 'Give me a short haiku about TypeScript.',
-    temperature: 0.8,
-    maxTokens: 64,
+  google: {
+    model: 'gemini-2.5-flash-lite',
+    prompt: 'What is 2+2?',
     raw: true,
   },
 });
 
-console.log(result.provider); // 'mistral'
-console.log(result.model);    // 'mistral-tiny'
-console.log(result.data);     // haiku text (once the provider normalizes to `data`)
-console.log(result.raw);      // full Mistral JSON (for inspecting choices/message)
+console.log(result.raw); // Full Google API response
+console.log(result.data); // Just the text
+```
+
+---
+
+## Configuration Reference
+
+### Response Object
+
+Every call returns this shape (for non-streaming):
+
+```ts
+{
+  data: string;        // The AI's text response
+  provider: string;    // Which provider was used (e.g., "openai")
+  model: string;       // Which model was used (e.g., "gpt-4o-mini")
+  raw?: any;          // (Optional) Full raw API response if raw: true
+}
 ```
 
-> Note: The provider implementations for DeepSeek and Mistral are still evolving. They are currently focused on basic, URL-based chat completions and raw response inspection while you iterate on the exact output normalization.
+### Request Parameters
+
+All providers support:
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `model` | string | ✅ | — | Model name (e.g., `gpt-4o-mini`, `gemini-2.5-flash-lite`) |
+| `prompt` | string | ✅ | — | Your question or instruction |
+| `system` | string | ❌ | — | System context/role for the AI |
+| `temperature` | number | ❌ | 1 | Randomness (0 = deterministic, 2 = very creative) |
+| `maxTokens` | number | ❌ | — | Max response length in tokens |
+| `stream` | boolean | ❌ | false | Stream responses in real-time |
+| `raw` | boolean | ❌ | false | Include full provider response |
 
 ---
 
-## Error Handling
+## Streaming Event Structure
+
+Each streaming event is a full parsed object from the provider. Here's what you get from each:
+
+### Google Gemini Event
+
+```ts
+{
+  candidates: [
+    {
+      content: {
+        parts: [
+          { text: "streaming text chunk here" }
+        ],
+        role: "model"
+      },
+      finishReason: "STOP",
+      index: 0
+    }
+  ],
+  usageMetadata: {
+    promptTokenCount: 8,
+    candidatesTokenCount: 25,
+    totalTokenCount: 33
+  },
+  modelVersion: "gemini-2.5-flash"
+}
+```
+
+### OpenAI Event
 
-All SDK-level errors are represented by the `SDKError` class (`src/core/error.ts`):
+```ts
+{
+  id: "chatcmpl-...",
+  object: "chat.completion.chunk",
+  created: 1234567890,
+  model: "gpt-4o-mini",
+  choices: [
+    {
+      index: 0,
+      delta: { content: "streaming text chunk" },
+      finish_reason: null
+    }
+  ]
+}
+```
+
+### DeepSeek Event
 
 ```ts
-export class SDKError extends Error {
-  provider: string;
-  message: string;
-
-  constructor(message: string, provider?: string) {
-    super(message);
-    this.provider = provider;
-    this.message = message;
+{
+  id: "chatcmpl-...",
+  choices: [
+    {
+      index: 0,
+      delta: { content: "streaming text chunk" },
+      finish_reason: null
+    }
+  ],
+  usage: {
+    prompt_tokens: 10,
+    completion_tokens: 5
   }
 }
 ```
 
-Examples of when `SDKError` is thrown:
+### Mistral Event
+
+```ts
+{
+  id: "...",
+  object: "text_completion",
+  created: 1234567890,
+  model: "mistral-small-latest",
+  choices: [
+    {
+      index: 0,
+      message: { content: "streaming text chunk" },
+      finish_reason: null
+    }
+  ]
+}
+```
+
+---
 
-- No providers configured in `SDKConfig`.
-- API key is missing or an empty string for a configured provider.
-- No provider passed to `generate`.
-- More than one provider passed in a single `generate` call.
-- `model` or `prompt` is missing/empty for the chosen provider.
-- Provider HTTP response is not OK (`res.ok === false`), in which case the error message includes the status code and response data.
+## Error Handling
 
-You can catch and inspect `SDKError` like this:
+All errors are `SDKError` exceptions:
 
 ```ts
+import { SDKError } from 'dev-ai-sdk';
+
 try {
   const result = await ai.generate({
-    google: {
-      model: 'gemini-2.5-flash-lite',
-      prompt: '', // invalid: empty prompt
+    openai: {
+      model: 'gpt-4o-mini',
+      prompt: '',  // Invalid: empty prompt
     },
   });
 } catch (err) {
   if (err instanceof SDKError) {
-    console.error('SDK error from provider:', err.provider);
-    console.error('Message:', err.message);
+    console.error(`Error from ${err.provider}: ${err.message}`);
   } else {
-    console.error('Unknown error:', err);
+    console.error('Unexpected error:', err);
   }
 }
 ```
 
+Common errors:
+- **Missing API key** – Configure all providers you use
+- **Invalid model name** – Check provider documentation for valid models
+- **Empty prompt** – Prompt must be a non-empty string
+- **Invalid request** – Only pass one provider per request (not multiple)
+
+---
+
+## Environment Setup
+
+Create a `.env` file with your API keys:
+
+```bash
+# .env
+OPENAI_API_KEY=sk-...
+GOOGLE_API_KEY=AIza...
+DEEPSEEK_API_KEY=sk-...
+MISTRAL_API_KEY=...
+```
+
+Then load it in your code:
+
+```ts
+import 'dotenv/config';
+
+const ai = new genChat({
+  openai: { apiKey: process.env.OPENAI_API_KEY! },
+});
+```
+
 ---
 
-## Development
+## Common Patterns
+
+### Try Multiple Providers
+
+Switch providers without changing your code:
+
+```ts
+const provider = process.env.AI_PROVIDER || 'openai';
 
-### Scripts
+const result = await ai.generate({
+  [provider]: {
+    model: getModelForProvider(provider),
+    prompt: 'Hello, AI!',
+  },
+});
+```
 
-Defined in `package.json`:
+### Fallback to Cheaper Model
 
-- `npm run dev` – run `src/index.ts` with `tsx`.
-- `npm run build` – run TypeScript compiler (`tsc`).
-- `npm run start` – run the built `dist/index.js` with Node.
-- `npm run clean` – remove the `dist` directory.
+```ts
+try {
+  const result = await ai.generate({
+    openai: {
+      model: 'gpt-4o', // Expensive
+      prompt: 'Complex question...',
+    },
+  });
+} catch {
+  // Fall back to cheaper model
+  const result = await ai.generate({
+    openai: {
+      model: 'gpt-4o-mini', // Cheaper
+      prompt: 'Complex question...',
+    },
+  });
+}
+```
 
-### TypeScript Configuration
+### Streaming with Real-Time Updates
 
-`tsconfig.json` is set up with:
+A practical example combining streaming with line-by-line display:
 
-- `target`: `ES2022`
-- `module`: `ESNext`
-- `moduleResolution`: `Bundler`
-- `strict`: `true`
-- `allowImportingTsExtensions`: `true`
-- `noEmit`: `true` (for development; the build step can be adjusted as the project evolves)
+```ts
+const stream = await ai.generate({
+  google: {
+    model: 'gemini-2.5-flash-lite',
+    prompt: 'Write a haiku about programming...',
+    stream: true,
+  },
+});
 
-The `src/` directory is included for compilation.
+if (Symbol.asyncIterator in Object(stream)) {
+  for await (const event of stream) {
+    const text = event.candidates?.[0]?.content?.parts?.[0]?.text;
+    if (text) {
+      process.stdout.write(text);
+    }
+  }
+  console.log(); // newline when done
+}
+```
 
 ---
 
-## Limitations (Current)
+## Limitations
 
-This project is currently in an early stage and has several limitations:
- 
-- Only single-prompt text generation is supported (no explicit chat/history abstraction yet).
-- Streaming is basic and low-level:
-  - It returns provider-specific JSON events (for example, Gemini `candidates[].content.parts[].text`).
-  - You are responsible for extracting the text you care about from each chunk.
-- No structured/JSON output helpers are provided.
-- No React/Next.js integrations or hooks are included.
-- Output normalization across providers (e.g. always using `data`) is still being finalized.
+This is v0.0.3 — early but functional. Currently:
 
+- Single-turn text generation (no multi-turn conversation history yet)
+- Streaming returns full provider event objects (extract what you need)
+- No function calling / tool use yet
+- No JSON mode / structured output yet
 
-These limitations are intentional for now to keep the core small and focused while the API surface is still evolving.
+---
+
+## What's Next
+
+Future versions will include:
+
+- Multi-turn conversation management
+- Structured output helpers
+- Function calling across providers
+- Rate limiting & caching
+- React/Next.js hooks
+- More providers (Anthropic, Azure, etc.)
 
 ---
 
-## Future Directions
+## Support
+
+- **GitHub**: https://github.com/shujanislam/dev-ai-sdk
+- **Issues**: https://github.com/shujanislam/dev-ai-sdk/issues
+- **Author**: Shujan Islam
 
-The long-term goal is to move toward a feature set closer to the Vercel AI SDK, while staying provider-agnostic and simple. Potential future improvements include:
+---
 
-- `generateText`, `streamText`, and `generateObject` helper functions.
-- Unified message-based chat interface and history management.
-- First-class streaming support with helpers for Node, browser, and Edge runtimes.
-- JSON/structured output helpers, with optional schema validation.
-- Tool/function calling abstraction across providers.
-- Middleware/hooks for logging, metrics, retries, rate limiting, and caching.
-- Official React/Next.js integrations and example apps.
-- Support for more providers (Anthropic, Azure OpenAI, etc.).
+## License
 
-Contributions and ideas are welcome as the design evolves.
+MIT — Use freely in your projects.

package/dist/client.d.ts

@@ -3,6 +3,6 @@ import type { SDKConfig } from './core/config';
 export declare class genChat {
     private sdkConfig;
     constructor(sdkConfig: SDKConfig);
-    generate(provider: Provider): Promise<Output | AsyncIterable<string>>;
+    generate(provider: Provider): Promise<Output | AsyncGenerator<any>>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAWtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,SAAS;IAY1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CAwD5E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAWtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,SAAS;IAYzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;CAwD3E"}

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { genChat } from './client';
 export type { SDKConfig } from './core/config';
 export type { Provider, Output } from './types/types';
-export type { SDKError } from './core/error';
+export { SDKError } from './core/error';
 //# 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,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { genChat } from './client';
+export { SDKError } from './core/error';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/providers/deepseek-stream.d.ts

@@ -1,3 +1,3 @@
 import type { Provider } from '../types/types';
-export declare function deepseekStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<string>;
+export declare function deepseekStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<any>;
 //# sourceMappingURL=deepseek-stream.d.ts.map

package/dist/providers/deepseek-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepseek-stream.d.ts","sourceRoot":"","sources":["../../src/providers/deepseek-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,sBAAsB,CAC3C,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,MAAM,CAAC,CA0ExB"}
+{"version":3,"file":"deepseek-stream.d.ts","sourceRoot":"","sources":["../../src/providers/deepseek-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,sBAAsB,CAC3C,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,GAAG,CAAC,CAmErB"}

package/dist/providers/deepseek-stream.js

@@ -57,13 +57,8 @@ export async function* deepseekStreamProvider(provider, apiKey) {
             }
             // DeepSeek streaming format is assumed similar to non-streaming:
             // text in event.output_text or event.output[0].content[*].text
-            const text = event.output_text ??
-                (event.output?.[0]?.content
-                    ?.map((c) => (typeof c.text === 'string' ? c.text : ''))
-                    .join('') ?? '');
-            if (text) {
-                yield text;
-            }
+            // Now yield the full event object for user access to all fields
+            yield event;
         }
     }
 }

package/dist/providers/deepseek-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"deepseek-stream.js","sourceRoot":"","sources":["../../src/providers/deepseek-stream.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deepseek-stream.js","sourceRoot":"","sources":["../../src/providers/deepseek-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAC3C,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAAC,kCAAkC,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,2CAA2C,EAAE;QACnE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;YAC9B,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;iBAClC;aACF;YACD,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;YAC1C,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS;YACvC,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,YAAoB,CAAC;QACzB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;gBACtC,SAAS;YACX,CAAC;YAEA,iEAAiE;YACjE,+DAA+D;YAC/D,gEAAgE;YAChE,MAAM,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/providers/google-stream.d.ts

@@ -1,3 +1,3 @@
 import type { Provider } from '../types/types';
-export declare function googleStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<string>;
+export declare function googleStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<any>;
 //# sourceMappingURL=google-stream.d.ts.map

package/dist/providers/google-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-stream.d.ts","sourceRoot":"","sources":["../../src/providers/google-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,MAAM,CAAC,CAsDxB"}
+{"version":3,"file":"google-stream.d.ts","sourceRoot":"","sources":["../../src/providers/google-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,GAAG,CAAC,CAoHpB"}

package/dist/providers/google-stream.js

@@ -38,13 +38,68 @@ export async function* googleStreamProvider(provider, apiKey) {
     }
     const reader = res.body.getReader();
     const decoder = new TextDecoder();
+    let buffer = '';
     for (;;) {
         const { done, value } = await reader.read();
         if (done)
             break;
-        const chunk = decoder.decode(value, { stream: true });
-        if (chunk) {
-            yield chunk;
+        buffer += decoder.decode(value, { stream: true });
+        // Try to extract complete JSON objects from buffer
+        let start = buffer.indexOf('[');
+        let end = -1;
+        if (start !== -1) {
+            // Find matching closing bracket
+            let bracketCount = 0;
+            for (let i = start; i < buffer.length; i++) {
+                if (buffer[i] === '[')
+                    bracketCount++;
+                if (buffer[i] === ']') {
+                    bracketCount--;
+                    if (bracketCount === 0) {
+                        end = i;
+                        break;
+                    }
+                }
+            }
+            // If we found a complete JSON array
+            if (end !== -1) {
+                const jsonPart = buffer.slice(start, end + 1);
+                try {
+                    const events = JSON.parse(jsonPart);
+                    // events should be an array of streaming event objects
+                    if (Array.isArray(events)) {
+                        for (const event of events) {
+                            yield event;
+                        }
+                    }
+                    // Remove processed JSON from buffer
+                    buffer = buffer.slice(end + 1);
+                }
+                catch (err) {
+                    console.error('Failed to parse Google stream JSON:', err.message);
+                    // Skip this malformed JSON and try to recover
+                    buffer = buffer.slice(end + 1);
+                }
+            }
+        }
+    }
+    // Process any remaining buffer at the end
+    if (buffer.trim()) {
+        const start = buffer.indexOf('[');
+        const end = buffer.lastIndexOf(']');
+        if (start !== -1 && end !== -1 && end > start) {
+            const jsonPart = buffer.slice(start, end + 1);
+            try {
+                const events = JSON.parse(jsonPart);
+                if (Array.isArray(events)) {
+                    for (const event of events) {
+                        yield event;
+                    }
+                }
+            }
+            catch (err) {
+                console.error('Failed to parse final Google stream buffer:', err.message);
+            }
         }
     }
 }

package/dist/providers/google-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-stream.js","sourceRoot":"","sources":["../../src/providers/google-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,oBAAoB,CACzC,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,2DAA2D,QAAQ,CAAC,MAAM,CAAC,KAAK,wBAAwB,EACxG;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,gBAAgB,EAAE,MAAM;SACzB;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;yBAClE;qBACF;iBACF;aACF;YACD,gBAAgB,EAAE;gBAChB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW;gBACxC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;aAC3C;SACF,CAAC;KACH,CACF,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,wBAAwB,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAElC,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"google-stream.js","sourceRoot":"","sources":["../../src/providers/google-stream.ts"],"names":[],"mappings":"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"}

package/dist/providers/mistral-stream.d.ts

@@ -1,3 +1,3 @@
 import type { Provider } from '../types/types';
-export declare function mistralStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<string>;
+export declare function mistralStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<any>;
 //# sourceMappingURL=mistral-stream.d.ts.map

package/dist/providers/mistral-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mistral-stream.d.ts","sourceRoot":"","sources":["../../src/providers/mistral-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,qBAAqB,CAC1C,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,MAAM,CAAC,CAuExB"}
+{"version":3,"file":"mistral-stream.d.ts","sourceRoot":"","sources":["../../src/providers/mistral-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,qBAAqB,CAC1C,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,GAAG,CAAC,CAmErB"}

package/dist/providers/mistral-stream.js

@@ -57,10 +57,8 @@ export async function* mistralStreamProvider(provider, apiKey) {
             }
             // Mistral streaming format is assumed similar to non-streaming:
             // text in event.choices[0].message.content or delta content
-            const text = event.choices?.[0]?.message?.content ?? '';
-            if (text) {
-                yield text;
-            }
+            // Now yield the full event object for user access to all fields
+            yield event;
         }
     }
 }

package/dist/providers/mistral-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"mistral-stream.js","sourceRoot":"","sources":["../../src/providers/mistral-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,qBAAqB,CAC1C,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,iCAAiC,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;QACpE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;YAC7B,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;iBACjC;aACF;YACD,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW;YACzC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS;YACtC,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,2BAA2B,GAAG,CAAC,MAAM,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,YAAoB,CAAC;QACzB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;gBACtC,SAAS;YACX,CAAC;YAED,gEAAgE;YAChE,4DAA4D;YAC5D,MAAM,IAAI,GACR,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;YAE7C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"mistral-stream.js","sourceRoot":"","sources":["../../src/providers/mistral-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,qBAAqB,CAC1C,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,iCAAiC,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;QACpE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;YAC7B,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;iBACjC;aACF;YACD,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW;YACzC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS;YACtC,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,2BAA2B,GAAG,CAAC,MAAM,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,YAAoB,CAAC;QACzB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;gBACtC,SAAS;YACX,CAAC;YAEA,gEAAgE;YAChE,4DAA4D;YAC5D,gEAAgE;YAChE,MAAM,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/providers/openai-stream.d.ts

@@ -1,3 +1,3 @@
 import type { Provider } from '../types/types';
-export declare function openaiStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<string>;
+export declare function openaiStreamProvider(provider: Provider, apiKey: string): AsyncGenerator<any>;
 //# sourceMappingURL=openai-stream.d.ts.map

package/dist/providers/openai-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-stream.d.ts","sourceRoot":"","sources":["../../src/providers/openai-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,MAAM,CAAC,CAqExB"}
+{"version":3,"file":"openai-stream.d.ts","sourceRoot":"","sources":["../../src/providers/openai-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,GAAG,CAAC,CA8DrB"}

package/dist/providers/openai-stream.js

@@ -52,13 +52,8 @@ export async function* openaiStreamProvider(provider, apiKey) {
             }
             // OpenAI Responses streaming format: text chunks can appear in
             // event.output[0].content[*].text or event.output_text.
-            const text = event.output_text ??
-                (event.output?.[0]?.content
-                    ?.map((c) => (typeof c.text === 'string' ? c.text : ''))
-                    .join('') ?? '');
-            if (text) {
-                yield text;
-            }
+            // Now yield the full event object for user access to all fields
+            yield event;
         }
     }
 }

package/dist/providers/openai-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai-stream.js","sourceRoot":"","sources":["../../src/providers/openai-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,oBAAoB,CACzC,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,qCAAqC,EAAE;QAC7D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;YAC5B,KAAK,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;YAClE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW;YACxC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;YAC5C,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,0BAA0B,GAAG,CAAC,MAAM,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,YAAoB,CAAC;QACzB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;gBACtC,SAAS;YACX,CAAC;YAED,+DAA+D;YAC/D,wDAAwD;YACxD,MAAM,IAAI,GACR,KAAK,CAAC,WAAW;gBACjB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO;oBACzB,EAAE,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;qBAC5D,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAErB,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"openai-stream.js","sourceRoot":"","sources":["../../src/providers/openai-stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,oBAAoB,CACzC,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,qCAAqC,EAAE;QAC7D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;YAC5B,KAAK,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;YAClE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW;YACxC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;YAC5C,MAAM,EAAE,IAAI;SACb,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,0BAA0B,GAAG,CAAC,MAAM,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,YAAoB,CAAC;QACzB,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;gBACtC,SAAS;YACX,CAAC;YAEA,+DAA+D;YAC/D,wDAAwD;YACxD,gEAAgE;YAChE,MAAM,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-ai-sdk",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Universal AI SDK with a single syntax for multiple LLM providers",
   "type": "module",
   "main": "dist/index.js",
@@ -45,7 +45,6 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "dotenv": "^17.2.3"
   }
 }