ai-requests-adapter 1.0.0

package/README.md

@@ -0,0 +1,171 @@
+# AI Requests Adapter
+
+A flexible and extensible SDK for handling AI API requests across multiple providers. This adapter provides a unified interface for interacting with different AI services, making it easy to switch between providers or use multiple providers in the same application.
+
+## Installation
+
+```bash
+npm install ai-requests-adapter
+```
+
+## Quick Start
+
+```typescript
+import { AIRequestsAdapter, createAIAdapter } from 'ai-requests-adapter';
+
+// Create an adapter instance
+const adapter = createAIAdapter();
+
+// Register a provider (you'll need to implement the AIProvider interface)
+adapter.registerProvider('my-provider', myProviderImplementation, true);
+
+// Send a request
+const response = await adapter.sendRequest({
+  messages: [
+    { role: 'user', content: 'Hello, how are you?' }
+  ],
+  model: 'gpt-3.5-turbo',
+  temperature: 0.7
+});
+
+console.log(response.content);
+```
+
+## API Reference
+
+### AIRequestsAdapter
+
+The main class for managing AI providers and sending requests.
+
+#### Methods
+
+- `registerProvider(name: string, provider: AIProvider, setAsDefault?: boolean)`: Register an AI provider
+- `sendRequest(request: AIRequest): Promise<AIResponse>`: Send a request using the default provider
+- `sendRequestWithProvider(providerName: string, request: AIRequest): Promise<AIResponse>`: Send a request using a specific provider
+- `getProviders(): string[]`: Get list of registered provider names
+- `setDefaultProvider(name: string)`: Set the default provider
+- `getDefaultProvider(): string | undefined`: Get the current default provider
+
+### Interfaces
+
+#### AIRequest
+
+```typescript
+interface AIRequest {
+  messages: Array<{
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+  }>;
+  model?: string;
+  temperature?: number;
+  maxTokens?: number;
+  [key: string]: any; // Allow additional provider-specific options
+}
+```
+
+#### AIResponse
+
+```typescript
+interface AIResponse {
+  content: string;
+  model: string;
+  usage?: {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+  };
+  metadata?: Record<string, any>;
+}
+```
+
+#### AIProvider
+
+```typescript
+interface AIProvider {
+  name: string;
+  sendRequest(request: AIRequest): Promise<AIResponse>;
+}
+```
+
+## Implementing a Provider
+
+To integrate with a specific AI provider, implement the `AIProvider` interface:
+
+```typescript
+import { AIProvider, AIRequest, AIResponse } from 'ai-requests-adapter';
+
+class OpenAIProvider implements AIProvider {
+  name = 'openai';
+
+  async sendRequest(request: AIRequest): Promise<AIResponse> {
+    // Your OpenAI API implementation here
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        model: request.model || 'gpt-3.5-turbo',
+        messages: request.messages,
+        temperature: request.temperature,
+        max_tokens: request.maxTokens,
+      }),
+    });
+
+    const data = await response.json();
+
+    return {
+      content: data.choices[0].message.content,
+      model: data.model,
+      usage: {
+        promptTokens: data.usage.prompt_tokens,
+        completionTokens: data.usage.completion_tokens,
+        totalTokens: data.usage.total_tokens,
+      },
+    };
+  }
+}
+
+// Register the provider
+const adapter = createAIAdapter();
+adapter.registerProvider('openai', new OpenAIProvider());
+```
+
+## Advanced Usage
+
+### Multiple Providers
+
+```typescript
+const adapter = createAIAdapter();
+
+// Register multiple providers
+adapter.registerProvider('openai', openAIProvider);
+adapter.registerProvider('anthropic', anthropicProvider, true); // Set as default
+
+// Use specific provider
+const openAIResponse = await adapter.sendRequestWithProvider('openai', request);
+const anthropicResponse = await adapter.sendRequest(request); // Uses default (anthropic)
+```
+
+### Switching Providers Dynamically
+
+```typescript
+const adapter = createAIAdapter();
+adapter.registerProvider('openai', openAIProvider);
+adapter.registerProvider('anthropic', anthropicProvider);
+
+// Switch default provider
+adapter.setDefaultProvider('anthropic');
+
+// All subsequent requests use anthropic
+const response = await adapter.sendRequest(request);
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export interface AIRequest {
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    [key: string]: any;
+}
+export interface AIResponse {
+    content: string;
+    model: string;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    metadata?: Record<string, any>;
+}
+export interface AIProvider {
+    name: string;
+    sendRequest(request: AIRequest): Promise<AIResponse>;
+}
+export declare class AIRequestsAdapter {
+    private providers;
+    private defaultProvider?;
+    registerProvider(name: string, provider: AIProvider, setAsDefault?: boolean): void;
+    sendRequest(request: AIRequest): Promise<AIResponse>;
+    sendRequestWithProvider(providerName: string, request: AIRequest): Promise<AIResponse>;
+    getProviders(): string[];
+    setDefaultProvider(name: string): void;
+    getDefaultProvider(): string | undefined;
+}
+export default AIRequestsAdapter;
+export declare function createAIAdapter(): AIRequestsAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtD;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,eAAe,CAAC,CAAS;IAKjC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,UAAQ,GAAG,IAAI;IAU1E,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAUpD,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAW5F,YAAY,IAAI,MAAM,EAAE;IAOxB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUtC,kBAAkB,IAAI,MAAM,GAAG,SAAS;CAGzC;AAGD,eAAe,iBAAiB,CAAC;AAGjC,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD"}

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIRequestsAdapter = void 0;
+exports.createAIAdapter = createAIAdapter;
+class AIRequestsAdapter {
+    constructor() {
+        this.providers = new Map();
+    }
+    registerProvider(name, provider, setAsDefault = false) {
+        this.providers.set(name, provider);
+        if (setAsDefault || !this.defaultProvider) {
+            this.defaultProvider = name;
+        }
+    }
+    async sendRequest(request) {
+        if (!this.defaultProvider) {
+            throw new Error('No default provider set. Register a provider first.');
+        }
+        return this.sendRequestWithProvider(this.defaultProvider, request);
+    }
+    async sendRequestWithProvider(providerName, request) {
+        const provider = this.providers.get(providerName);
+        if (!provider) {
+            throw new Error(`Provider '${providerName}' not found. Available providers: ${Array.from(this.providers.keys()).join(', ')}`);
+        }
+        return provider.sendRequest(request);
+    }
+    getProviders() {
+        return Array.from(this.providers.keys());
+    }
+    setDefaultProvider(name) {
+        if (!this.providers.has(name)) {
+            throw new Error(`Provider '${name}' not found.`);
+        }
+        this.defaultProvider = name;
+    }
+    getDefaultProvider() {
+        return this.defaultProvider;
+    }
+}
+exports.AIRequestsAdapter = AIRequestsAdapter;
+exports.default = AIRequestsAdapter;
+function createAIAdapter() {
+    return new AIRequestsAdapter();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AA2FA,0CAEC;AAlED,MAAa,iBAAiB;IAA9B;QACU,cAAS,GAA4B,IAAI,GAAG,EAAE,CAAC;IAyDzD,CAAC;IAnDC,gBAAgB,CAAC,IAAY,EAAE,QAAoB,EAAE,YAAY,GAAG,KAAK;QACvE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,IAAI,YAAY,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;IAKD,KAAK,CAAC,WAAW,CAAC,OAAkB;QAClC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAKD,KAAK,CAAC,uBAAuB,CAAC,YAAoB,EAAE,OAAkB;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,qCAAqC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChI,CAAC;QACD,OAAO,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAKD,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAKD,kBAAkB,CAAC,IAAY;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,cAAc,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;IAKD,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF;AA1DD,8CA0DC;AAGD,kBAAe,iBAAiB,CAAC;AAGjC,SAAgB,eAAe;IAC7B,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "ai-requests-adapter",
+  "version": "1.0.0",
+  "description": "A flexible adapter SDK for handling AI API requests across multiple providers",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "ai",
+    "api",
+    "adapter",
+    "requests",
+    "openai",
+    "anthropic",
+    "sdk"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yourusername/ai-requests-adapter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/ai-requests-adapter/issues"
+  },
+  "homepage": "https://github.com/yourusername/ai-requests-adapter#readme"
+}