@imenam/unified-llm-client 1.4.1 → 2.0.1

package/README.md

@@ -1,6 +1,6 @@
 # @imenam/unified-llm-client
 
-A unified interface for multiple LLM providers — OpenAI, Gemini, Anthropic, and Qwen — with built-in support for tool-calling, streaming, multimodal inputs, and audio generation.
+A unified interface for multiple LLM providers — OpenAI, Gemini, Anthropic, and Qwen — with built-in support for tool-calling, streaming, multimodal inputs, audio generation, and a proxy mode for API key isolation.
 
 ## Features
 
@@ -9,6 +9,9 @@ A unified interface for multiple LLM providers — OpenAI, Gemini, Anthropic, an
 - **Streaming** — chunk-by-chunk responses via callbacks
 - **Multimodal** — image and audio file inputs
 - **Audio generation** — Text-to-Speech (Gemini)
+- **Proxy mode** — delegate LLM calls to a server, no API keys on the client
+- **API key resolver** — dynamically resolve API keys per request from a user-provided context
+- **Cancellation** — native `AbortSignal` support
 - **Usage tracking** — token counts and estimated costs
 - **Full TypeScript support** — exported types and `.d.ts` declarations
 
@@ -35,7 +38,7 @@ Set your API keys in a `.env` file:
 OPENAI_API_KEY=sk-...
 GOOGLE_API_KEY=...
 ANTHROPIC_API_KEY=sk-ant-...
-DASHSCOPE_API_KEY=...   # for Qwen
+ALIBABA_CLOUD_API_KEY=...   # for Qwen
 ```
 
 ```typescript
@@ -73,6 +76,7 @@ MODELS.CLAUDE_OPUS_4_6
 // Qwen
 MODELS.QWEN_VL_3
 MODELS.QWEN_VL_FLASH
+MODELS.QWEN_VL_3_FLASH
 ```
 
 You can also pass a custom model:
@@ -81,6 +85,8 @@ You can also pass a custom model:
 const client = new UnifiedLLMClient({
   provider: "openai",
   modelName: "gpt-4o",
+  costsPer1MTokens: { prompt: 2.5, output: 10 },
+  currency: "USD",
 });
 ```
 
@@ -124,11 +130,11 @@ console.log(response.content);
 ```typescript
 const client = new UnifiedLLMClient(MODELS.GPT_4O_MINI);
 
-const response = await client.chat({
+await client.chat({
   message: "Tell me a short story.",
   stream: true,
   onChunk: (chunk) => {
-    process.stdout.write(chunk.content ?? "");
+    process.stdout.write(chunk.contentChunk ?? "");
   },
   onFinalResponse: (final) => {
     console.log("\n\nTotal tokens:", final.usage?.totalTokens);
@@ -136,23 +142,6 @@ const response = await client.chat({
 });
 ```
 
-## Conversation History
-
-The client maintains conversation history internally. Use `getHistory()` and `setHistory()` to persist or restore it:
-
-```typescript
-const client = new UnifiedLLMClient(MODELS.CLAUDE_SONNET_4_6);
-
-await client.chat({ message: "My name is Alice." });
-await client.chat({ message: "What's my name?" });
-// → "Your name is Alice."
-
-const history = client.getHistory();
-// Save and restore later:
-const newClient = new UnifiedLLMClient(MODELS.CLAUDE_SONNET_4_6);
-newClient.setHistory(history);
-```
-
 ## Multimodal Inputs
 
 Attach images or audio files directly to a message:
@@ -167,6 +156,18 @@ const response = await client.chat({
 });
 ```
 
+Multiple files are also supported:
+
+```typescript
+await client.chat({
+  message: {
+    role: "user",
+    content: "Compare these two images.",
+    attachedFile: ["./image1.jpg", "./image2.png"],
+  },
+});
+```
+
 ## Audio Generation (Gemini)
 
 ```typescript
@@ -181,6 +182,113 @@ const audio = await client.generateAudio({
 });
 ```
 
+## Proxy Mode
+
+Run an HTTP server that holds your API keys server-side, and connect clients without any keys:
+
+```typescript
+import { ProxyServer } from "@imenam/unified-llm-client";
+
+// Server side — API keys are read from process.env
+const server = new ProxyServer({ port: 3000, apiKey: "my-secret" });
+await server.start();
+```
+
+```typescript
+// Client side — no API keys needed
+import { UnifiedLLMClient, MODELS } from "@imenam/unified-llm-client";
+
+const client = new UnifiedLLMClient(MODELS.GEMINI_FLASH_2_5, {
+  proxyUrl: "http://localhost:3000",
+  proxyApiKey: "my-secret",
+});
+
+// The chat() API is identical — streaming and file attachments are fully supported
+const response = await client.chat({ message: "Hello!" });
+```
+
+The proxy server also supports an `apiKeyResolver` for per-request dynamic key resolution (e.g. multi-tenant scenarios):
+
+```typescript
+import { ProxyServer } from "@imenam/unified-llm-client";
+import type { ApiKeyResolver } from "@imenam/unified-llm-client";
+
+const resolver: ApiKeyResolver<{ userId: string }> = async (ctx) =>
+  (await userKeyStore.get(ctx.userId)) ?? false;
+
+const server = new ProxyServer({ port: 3000, apiKey: "my-secret", apiKeyResolver: resolver });
+await server.start();
+```
+
+```typescript
+// Client passes the context — server resolves the key
+const client = new UnifiedLLMClient(MODELS.GPT_4O_MINI, {
+  proxyUrl: "http://localhost:3000",
+  proxyApiKey: "my-secret",
+});
+
+const response = await client.chat({
+  message: "Hello!",
+  apiKeyContext: { userId: "user-123" },
+});
+```
+
+## API Key Resolver
+
+Dynamically resolve which API key to use for each request based on a custom context (e.g. per-user key, request metadata):
+
+```typescript
+import { UnifiedLLMClient, MODELS } from "@imenam/unified-llm-client";
+import type { ApiKeyResolver } from "@imenam/unified-llm-client";
+
+const resolver: ApiKeyResolver<{ userId: string }> = async (ctx) => {
+  const key = await userKeyStore.get(ctx.userId);
+  return key ?? false; // return false to deny access
+};
+
+const client = new UnifiedLLMClient(MODELS.GPT_4O_MINI, {
+  apiKeyResolver: resolver,
+});
+
+const response = await client.chat({
+  message: "Hello!",
+  apiKeyContext: { userId: "user-123" },
+});
+```
+
+You can also set a global default resolver for all instances:
+
+```typescript
+UnifiedLLMClient.setDefaultApiKeyResolver((ctx) => {
+  return ctx.apiKey ?? false;
+});
+```
+
+> The resolver is called on every `chat()` call. Returning `false` throws an access-denied error.
+> The client-side `apiKeyResolver` option is for direct mode only. In proxy mode, the resolver is defined on the `ProxyServer` — the client passes `apiKeyContext` and the server resolves the key.
+
+## Cancellation
+
+Pass an `AbortSignal` to cancel a request mid-flight:
+
+```typescript
+const ac = new AbortController();
+setTimeout(() => ac.abort(), 800);
+
+try {
+  await client.chat({
+    message: "Write a very long story...",
+    stream: true,
+    signal: ac.signal,
+    onChunk: (chunk) => process.stdout.write(chunk.contentChunk ?? ""),
+  });
+} catch (e) {
+  if (e instanceof Error && e.name === "AbortError") {
+    console.log("Request cancelled.");
+  }
+}
+```
+
 ## Logging
 
 Pass a `logger` callback to capture structured logs for every request:
@@ -188,30 +296,46 @@ Pass a `logger` callback to capture structured logs for every request:
 ```typescript
 const client = new UnifiedLLMClient(MODELS.GPT_4O_MINI, {
   logger: (log) => {
-    console.log(`[${log.provider}] ${log.model} — ${log.totalTokens} tokens`);
+    console.log(`[${log.provider}] ${log.model} — ${log.usage.totalTokens} tokens`);
   },
 });
 ```
 
+Set a global default logger applied to all instances:
+
+```typescript
+UnifiedLLMClient.setDefaultLogger((log) => {
+  console.log(`[${log.provider}] ${log.model} — ${log.usage.totalTokens} tokens`);
+});
+```
+
 ## API Reference
 
 ### `new UnifiedLLMClient(model, options?)`
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `model` | `Model` | Model object from `MODELS` or a custom `{ provider, modelName }` |
+| `model` | `Model` | Model object from `MODELS` or a custom `{ provider, modelName, costsPer1MTokens, currency }` |
 | `options.logger` | `(log: UnifiedLog) => void` | Optional logging callback |
+| `options.proxyUrl` | `string` | Proxy server URL — activates proxy mode |
+| `options.proxyApiKey` | `string` | Key sent in the `x-api-key` header (proxy mode) |
+| `options.apiKey` | `string` | Static API key passed directly to the provider (overrides env var) |
+| `options.apiKeyResolver` | `ApiKeyResolver` | Dynamic per-request key resolver (direct mode only — in proxy mode, set this on `ProxyServer`) |
 
 ### `client.chat(options)`
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `message` | `string \| ChatMessage \| ChatMessage[]` | — | User message or history |
+| `message` | `string \| ChatMessage \| ChatMessage[]` | — | User message or full conversation history |
 | `tools` | `ToolDefinition[]` | `[]` | Tools available to the LLM |
 | `toolChoice` | `"auto" \| "none" \| string` | `"auto"` | Tool selection strategy |
 | `stream` | `boolean` | `false` | Enable streaming |
 | `onChunk` | `(chunk: StreamedChatChunk) => void` | — | Streaming chunk callback |
 | `onFinalResponse` | `(res: ChatResponse) => void` | — | Final response callback |
+| `onLog` | `(log: UnifiedLog) => void` | — | Per-call log callback |
+| `config` | `ChatOptionalConfig` | — | Advanced options: `thinkingBudget`, `metadata` |
+| `signal` | `AbortSignal` | — | Cancellation signal |
+| `apiKeyContext` | `unknown` | — | Context passed to `apiKeyResolver` to resolve the API key |
 
 ### `ChatResponse`
 
@@ -224,6 +348,8 @@ interface ChatResponse {
     completionTokens: number;
     totalTokens: number;
   };
+  finishReason?: string;
+  requestId?: string;
   raw: unknown;
 }
 ```

package/dist/common/types.d.ts

@@ -1,4 +1,5 @@
 export type Provider = "openai" | "gemini" | "qwen" | "anthropic";
+export type ApiKeyResolver<T = unknown> = (context: T) => Promise<string | false> | string | false;
 export type ChatMessageRole = "user" | "assistant" | "system" | "tool" | "function";
 export interface ChatMessage {
     tool_call_id?: string;

package/dist/common/types.d.ts.map

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

package/dist/core/LLMAdapter.d.ts

@@ -1,5 +1,5 @@
 import { ChatMessage, ToolDefinition, ChatResponse, ToolCall, AudioGenerationOptions, AudioGenerationResponse, UnifiedLog, Provider } from "../common/types";
-export declare const PROVIDERS_CONFIG: Record<Provider, () => ProviderOptions>;
+export declare const PROVIDERS_CONFIG: Record<Provider, (apiKey?: string) => ProviderOptions>;
 export type StreamedChatChunk = {
     contentChunk?: string;
     toolCallChunk?: ToolCall[];
@@ -28,6 +28,7 @@ export type ChatOptionalConfig = {
     thinkingBudget?: number;
     metadata?: Record<string, any>;
     signal?: AbortSignal;
+    apiKeyContext?: unknown;
 };
 export interface LogData {
     model: string;

package/dist/core/LLMAdapter.d.ts.map

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

package/dist/core/LLMAdapter.js

@@ -24,22 +24,22 @@ const AnthropicLogAdapter_1 = require("../adapters/anthropic/AnthropicLogAdapter
 const dotenv_1 = __importDefault(require("dotenv"));
 dotenv_1.default.config();
 exports.PROVIDERS_CONFIG = {
-    gemini: () => ({
+    gemini: (apiKey) => ({
         promptAdapter: new GeminiPromptAdapter_1.GeminiPromptAdapter({
-            apiKey: process.env.GOOGLE_API_KEY,
+            apiKey: apiKey !== null && apiKey !== void 0 ? apiKey : process.env.GOOGLE_API_KEY,
             model: "gemini-2.5-flash",
         }),
         outputAdapter: new GeminiOutputAdapter_1.GeminiOutputAdapter(),
         toolAdapter: new GeminiToolAdapter_1.GeminiToolAdapter(),
         audioAdapter: new GeminiAudioAdapter_1.GeminiAudioAdapter({
-            apiKey: process.env.GOOGLE_API_KEY,
+            apiKey: apiKey !== null && apiKey !== void 0 ? apiKey : process.env.GOOGLE_API_KEY,
             model: "gemini-2.5-pro-preview-tts",
         }),
         logAdapter: new GeminiLogAdapter_1.GeminiLogAdapter(),
     }),
-    openai: () => ({
+    openai: (apiKey) => ({
         promptAdapter: new OpenAIPromptAdapter_1.OpenAIPromptAdapter({
-            apiKey: process.env.OPENAI_API_KEY,
+            apiKey: apiKey !== null && apiKey !== void 0 ? apiKey : process.env.OPENAI_API_KEY,
             model: "gpt-4o-mini",
         }),
         toolAdapter: new OpenAiToolAdapter_1.OpenAiToolAdapter(),
@@ -47,9 +47,9 @@ exports.PROVIDERS_CONFIG = {
         logAdapter: new OpenAiLogAdapter_1.OpenAiLogAdapter(),
         // Note: OpenAI n'a pas encore d'audioAdapter - peut être ajouté plus tard
     }),
-    qwen: () => ({
+    qwen: (apiKey) => ({
         promptAdapter: new QwenPromptAdapter_1.QwenPromptAdapter({
-            apiKey: process.env.ALIBABA_CLOUD_API_KEY,
+            apiKey: apiKey !== null && apiKey !== void 0 ? apiKey : process.env.ALIBABA_CLOUD_API_KEY,
             model: "qwen3-vl-235b-a22b-instruct",
             baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
         }),
@@ -58,9 +58,9 @@ exports.PROVIDERS_CONFIG = {
         logAdapter: new QwenLogAdapter_1.QwenLogAdapter(),
         // Note: Qwen n'a pas d'audioAdapter pour le moment
     }),
-    anthropic: () => ({
+    anthropic: (apiKey) => ({
         promptAdapter: new AnthropicPromptAdapter_1.AnthropicPromptAdapter({
-            apiKey: process.env.ANTHROPIC_API_KEY,
+            apiKey: apiKey !== null && apiKey !== void 0 ? apiKey : process.env.ANTHROPIC_API_KEY,
             model: "claude-sonnet-4-5-20250929",
         }),
         outputAdapter: new AnthropicOutputAdapter_1.AnthropicOutputAdapter(),

package/dist/core/UnifiedLLMClient.d.ts

@@ -1,4 +1,4 @@
-import { ChatMessage, ChatResponse, ToolDefinition, AudioGenerationOptions, AudioGenerationResponse, UnifiedLog } from "../common/types";
+import { ApiKeyResolver, ChatMessage, ChatResponse, ToolDefinition, AudioGenerationOptions, AudioGenerationResponse, UnifiedLog } from "../common/types";
 import { PromptAdapterOptions, StreamedChatChunk, ChatOptionalConfig } from "./LLMAdapter";
 import { Model } from "../common/types";
 export type UnifiedLLMClientOptions = {
@@ -16,6 +16,7 @@ export type ChatOptions = {
     stream?: boolean;
     config?: ChatOptionalConfig;
     signal?: AbortSignal;
+    apiKeyContext?: unknown;
 };
 export declare class UnifiedLLMClient {
     private promptAdapter;
@@ -26,12 +27,19 @@ export declare class UnifiedLLMClient {
     private rawMessages;
     private model;
     private logger?;
+    private apiKeyResolver?;
+    private readonly isProxyMode;
     static setDefaultLogger(logger: (log: UnifiedLog) => any | Promise<any>): void;
+    static setDefaultApiKeyResolver(resolver: ApiKeyResolver): void;
     constructor(model: Model, options?: {
         logger?: (log: UnifiedLog) => any | Promise<any>;
+        proxyUrl?: string;
+        proxyApiKey?: string;
+        apiKeyResolver?: ApiKeyResolver;
+        apiKey?: string;
     });
     private checkNotImplementedFeatures;
-    chat({ message, tools, toolChoice, onChunk, onFinalResponse, onLog, stream, config, signal }: ChatOptions): Promise<ChatResponse>;
+    chat({ message, tools, toolChoice, onChunk, onFinalResponse, onLog, stream, config, signal, apiKeyContext }: ChatOptions): Promise<ChatResponse>;
     private handleLogging;
     /**
      * Vérifie si la génération d'audio est supportée pour le provider actuel

package/dist/core/UnifiedLLMClient.d.ts.map

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

package/dist/core/UnifiedLLMClient.js

@@ -11,19 +11,37 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnifiedLLMClient = void 0;
 const LLMAdapter_1 = require("./LLMAdapter");
+const ProxyPromptAdapter_1 = require("../proxy/ProxyPromptAdapter");
 class UnifiedLLMClient {
     static setDefaultLogger(logger) {
         global._unifiedLlmDefaultLogger = logger;
     }
+    static setDefaultApiKeyResolver(resolver) {
+        global._unifiedLlmDefaultApiKeyResolver = resolver;
+    }
     constructor(model, options) {
         this.rawMessages = [];
         this.model = model;
-        const config = LLMAdapter_1.PROVIDERS_CONFIG[model.provider]();
-        this.promptAdapter = config.promptAdapter;
-        this.outputAdapter = config.outputAdapter;
-        this.toolAdapter = config.toolAdapter;
-        this.audioAdapter = config.audioAdapter;
-        this.logAdapter = config.logAdapter;
+        this.apiKeyResolver = options === null || options === void 0 ? void 0 : options.apiKeyResolver;
+        this.isProxyMode = Boolean(options === null || options === void 0 ? void 0 : options.proxyUrl);
+        if (options === null || options === void 0 ? void 0 : options.proxyUrl) {
+            const proxyAdapter = new ProxyPromptAdapter_1.ProxyPromptAdapter({
+                serverUrl: options.proxyUrl,
+                apiKey: options.proxyApiKey,
+                model,
+            });
+            this.promptAdapter = proxyAdapter;
+            this.outputAdapter = { parse: (r) => r };
+            this.toolAdapter = { formatToolCallResult: (tc) => tc };
+        }
+        else {
+            const config = LLMAdapter_1.PROVIDERS_CONFIG[model.provider](options === null || options === void 0 ? void 0 : options.apiKey);
+            this.promptAdapter = config.promptAdapter;
+            this.outputAdapter = config.outputAdapter;
+            this.toolAdapter = config.toolAdapter;
+            this.audioAdapter = config.audioAdapter;
+            this.logAdapter = config.logAdapter;
+        }
         this.logger = (options === null || options === void 0 ? void 0 : options.logger) || global._unifiedLlmDefaultLogger;
     }
     checkNotImplementedFeatures(message) {
@@ -32,23 +50,41 @@ class UnifiedLLMClient {
         }
     }
     chat(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ message, tools, toolChoice = "auto", onChunk, onFinalResponse, onLog, stream = false, config, signal }) {
-            const effectiveConfig = config !== undefined || signal !== undefined
+        return __awaiter(this, arguments, void 0, function* ({ message, tools, toolChoice = "auto", onChunk, onFinalResponse, onLog, stream = false, config, signal, apiKeyContext }) {
+            var _b;
+            let effectiveConfig = config !== undefined || signal !== undefined
                 ? Object.assign(Object.assign({}, config), (signal !== undefined ? { signal } : {})) : undefined;
+            if (apiKeyContext !== undefined) {
+                effectiveConfig = Object.assign(Object.assign({}, effectiveConfig), { apiKeyContext });
+            }
+            const effectiveResolver = (_b = this.apiKeyResolver) !== null && _b !== void 0 ? _b : global._unifiedLlmDefaultApiKeyResolver;
+            let promptAdapter = this.promptAdapter;
+            let outputAdapter = this.outputAdapter;
+            if (!this.isProxyMode && effectiveResolver) {
+                if (apiKeyContext === undefined) {
+                    throw new Error("[ApiKeyResolver] A resolver is defined but no apiKeyContext was provided.");
+                }
+                const resolvedKey = yield effectiveResolver(apiKeyContext);
+                if (resolvedKey === false)
+                    throw new Error("[ApiKeyResolver] The resolver returned false — access denied.");
+                const resolved = LLMAdapter_1.PROVIDERS_CONFIG[this.model.provider](resolvedKey);
+                promptAdapter = resolved.promptAdapter;
+                outputAdapter = resolved.outputAdapter;
+            }
             const startTime = Date.now();
             const messageArray = Array.isArray(message)
                 ? message
                 : [typeof message === "string" ? { role: "user", content: message } : message];
             for (const m of messageArray)
                 this.checkNotImplementedFeatures(m);
-            const messages = yield Promise.all(messageArray.map(m => this.promptAdapter.formatMessage(m)));
+            const messages = yield Promise.all(messageArray.map(m => promptAdapter.formatMessage(m)));
             let finalResponse;
             if (stream) {
-                if (!this.promptAdapter.streamFromProvider) {
+                if (!promptAdapter.streamFromProvider) {
                     throw new Error("The current adapter does not support streaming.");
                 }
                 let aggregatedContent = "";
-                finalResponse = yield this.promptAdapter.streamFromProvider({
+                finalResponse = yield promptAdapter.streamFromProvider({
                     messages,
                     tools,
                     toolChoice,
@@ -70,8 +106,8 @@ class UnifiedLLMClient {
                 finalResponse.content = aggregatedContent;
             }
             else {
-                const providerResponse = yield this.promptAdapter.sendToProvider(messages, tools, toolChoice, undefined, this.model.modelName, effectiveConfig);
-                finalResponse = this.outputAdapter.parse(providerResponse);
+                const providerResponse = yield promptAdapter.sendToProvider(messages, tools, toolChoice, undefined, this.model.modelName, effectiveConfig);
+                finalResponse = outputAdapter.parse(providerResponse);
             }
             const latencyMs = Date.now() - startTime;
             yield this.handleLogging(messageArray, finalResponse, latencyMs, effectiveConfig === null || effectiveConfig === void 0 ? void 0 : effectiveConfig.metadata, onLog);

package/dist/examples/api-key-resolver-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-key-resolver-example.d.ts.map

package/dist/examples/api-key-resolver-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-resolver-example.d.ts","sourceRoot":"","sources":["../../src/examples/api-key-resolver-example.ts"],"names":[],"mappings":""}

package/dist/examples/api-key-resolver-example.js

@@ -0,0 +1,65 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Exemple : résolution dynamique de clé API (`apiKeyResolver`) en mode direct,
+ * sans serveur proxy. Les clés viennent ici d’un mapping applicatif (ex. par tenant).
+ *
+ * Prérequis : `GOOGLE_API_KEY` dans l’environnement (provider Gemini dans cet exemple).
+ *
+ * Lancer après build : `npm run example:api-key-resolver`
+ */
+const __1 = require("..");
+/**
+ * Exemple de resolver : renvoie la clé pour un tenant connu, sinon `false` (refus).
+ * En production, vous chargeriez la clé depuis une base, un vault, etc.
+ */
+const demoResolver = (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+    const { tenantId } = ctx;
+    const byTenant = {
+        // Un seul slot de démo : même clé env que la config Gemini par défaut.
+        demo: process.env.GOOGLE_API_KEY,
+    };
+    const key = byTenant[tenantId];
+    if (!key)
+        return false;
+    return key;
+});
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!process.env.GOOGLE_API_KEY) {
+            console.error("[api-key-resolver-example] Définissez GOOGLE_API_KEY pour exécuter cet exemple.");
+            process.exit(1);
+        }
+        const client = new __1.UnifiedLLMClient(__1.MODELS.GEMINI_FLASH_2_5, {
+            apiKeyResolver: demoResolver,
+        });
+        console.log("--- Chat avec apiKeyContext (resolver instance) ---\n");
+        const res = yield client.chat({
+            message: "Réponds en une courte phrase : que signifie « apiKeyResolver » dans ce SDK ?",
+            apiKeyContext: { tenantId: "demo" },
+        });
+        console.log(res.content);
+        console.log();
+        console.log("--- setDefaultApiKeyResolver (global) + même appel ---\n");
+        __1.UnifiedLLMClient.setDefaultApiKeyResolver(demoResolver);
+        const clientNoInstanceResolver = new __1.UnifiedLLMClient(__1.MODELS.GEMINI_FLASH_2_5);
+        const res2 = yield clientNoInstanceResolver.chat({
+            message: "Dis seulement : OK.",
+            apiKeyContext: { tenantId: "demo" },
+        });
+        console.log(res2.content);
+    });
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/examples/example.js

@@ -243,7 +243,6 @@ function getExercisesBoundaries() {
 }
 function exerciseMatching() {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
         const answers = [
             {
                 index: 0,
@@ -310,14 +309,14 @@ function exerciseMatching() {
         const res = yield client.chat({
             message: {
                 role: "user",
-                content: "Voila les reponses des etudiants, et le sujet du devoir. Peux-tu les associer ? answers:\n" + JSON.stringify(answers),
-                // content: "Quelles sont les questions du sujet ?",
+                // content: "Voila les reponses des etudiants, et le sujet du devoir. Peux-tu les associer ? answers:\n" + JSON.stringify(answers),
+                content: "Quelles sont les questions du sujet ?",
                 attachedFile: "./media/subject.pdf"
             },
             tools: [tool]
         });
-        // console.log("response", res);
-        console.log("response", (_b = (_a = res.toolCalls) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.arguments);
+        console.log("response", res.content);
+        // console.log("response", res.toolCalls?.[0]?.arguments);
     });
 }
 function parseSubject() {
@@ -364,7 +363,7 @@ function multiFileSend() {
         console.log("response", res.content);
     });
 }
-basicUsage();
+// basicUsage();
 // Annulation d'une requête chat (côté app consommatrice) :
 // const ac = new AbortController();
 // setTimeout(() => ac.abort(), 500);
@@ -373,6 +372,6 @@ basicUsage();
 // basicUsageWithAudio();
 // basicAudioGeneration();
 // getExercisesBoundaries();
-// exerciseMatching();
+exerciseMatching();
 // parseSubject();
 // multiFileSend();

package/dist/examples/proxy-api-key-resolver-example.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proxy-api-key-resolver-example.d.ts.map

package/dist/examples/proxy-api-key-resolver-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-api-key-resolver-example.d.ts","sourceRoot":"","sources":["../../src/examples/proxy-api-key-resolver-example.ts"],"names":[],"mappings":""}