cencori 0.1.0

package/README.md

@@ -0,0 +1,140 @@
+# Cencori SDK
+
+Official TypeScript SDK for the Cencori AI Gateway and Infrastructure Platform.
+
+## Installation
+
+```bash
+npm install cencori
+# or
+yarn add cencori
+```
+
+## Quick Start
+
+```typescript
+import { CencoriClient } from 'cencori';
+
+const cencori = new CencoriClient({
+  apiKey: process.env.CENCORI_API_KEY!
+});
+
+const response = await cencori.ai.chat({
+  messages: [
+    { role: 'user', content: 'Hello, AI!' }
+  ]
+});
+
+console.log(response.content);
+```
+
+## Authentication
+
+Get your API key from the [Cencori Dashboard](https://cencori.com/dashboard):
+
+1. Create a project
+2. Navigate to API Keys
+3. Generate a new key
+4. Copy and store it securely
+
+## API Reference
+
+### CencoriClient
+
+Initialize the SDK client.
+
+```typescript
+const cencori = new CencoriClient({
+  apiKey: 'your_api_key_here',
+  baseUrl: 'https://cencori.com' // Optional, defaults to production
+});
+```
+
+### AI Module
+
+#### `ai.chat(params)`
+
+Send a chat message to the AI.
+
+**Parameters:**
+- `messages`: Array of message objects with `role` ('user' | 'assistant') and `content`
+- `model`: Optional AI model (defaults to 'gemini-1.5-pro')
+- `temperature`: Optional temperature (0-1)
+- `maxOutputTokens`: Optional max tokens for response
+
+**Example:**
+
+```typescript
+const response = await cencori.ai.chat({
+  messages: [
+    { role: 'user', content: 'Explain quantum computing' }
+  ],
+  temperature: 0.7
+});
+
+console.log(response.content);
+console.log(response.usage); // Token usage stats
+```
+
+## Error Handling
+
+The SDK includes custom error classes for common scenarios:
+
+```typescript
+import {
+  CencoriClient,
+  AuthenticationError,
+  RateLimitError,
+  SafetyError
+} from 'cencori';
+
+try {
+  const response = await cencori.ai.chat({ messages: [...] });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Invalid API key');
+  } else if (error instanceof RateLimitError) {
+    console.error('Too many requests, please slow down');
+  } else if (error instanceof SafetyError) {
+    console.error('Content blocked:', error.reasons);
+  }
+}
+```
+
+## TypeScript Support
+
+The SDK is written in TypeScript and includes full type definitions.
+
+```typescript
+import type { ChatParams, ChatResponse, Message } from 'cencori';
+```
+
+## Features
+
+- ✨ Full TypeScript support with type definitions
+- 🔒 Built-in authentication
+- 🔄 Automatic retry logic with exponential backoff
+- 🚨 Custom error classes
+- 🛡️ Content safety filtering
+- ⚡ Rate limiting protection
+
+## Local Development
+
+For local development or testing:
+
+```typescript
+const cencori = new CencoriClient({
+  apiKey: 'cen_test_...',
+  baseUrl: 'http://localhost:3000'
+});
+```
+
+## Support
+
+- **Documentation**: [docs.cencori.com](https://docs.cencori.com)
+- **Dashboard**: [cencori.com/dashboard](https://cencori.com/dashboard)
+- **GitHub**: [github.com/bolaabanjo/cencori](https://github.com/bolaabanjo/cencori)
+
+## License
+
+MIT © FohnAI

package/dist/index.d.mts

@@ -0,0 +1,61 @@
+interface CencoriConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: string;
+    headers?: Record<string, string>;
+}
+
+interface ChatParams {
+    messages: Message[];
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+}
+interface Message {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface ChatResponse {
+    role: string;
+    content: string;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+
+declare class AIModule {
+    private client;
+    constructor(client: CencoriClient);
+    chat(params: ChatParams): Promise<ChatResponse>;
+}
+
+declare class CencoriClient {
+    private apiKey;
+    private baseUrl;
+    ai: AIModule;
+    constructor(config: CencoriConfig);
+    request<T>(endpoint: string, options: RequestOptions): Promise<T>;
+}
+
+declare class CencoriError extends Error {
+    statusCode?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, code?: string | undefined);
+}
+declare class AuthenticationError extends CencoriError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends CencoriError {
+    constructor(message?: string);
+}
+declare class SafetyError extends CencoriError {
+    reasons?: string[] | undefined;
+    constructor(message?: string, reasons?: string[] | undefined);
+}
+
+export { AuthenticationError, CencoriClient, type CencoriConfig, CencoriError, type ChatParams, type ChatResponse, type Message, RateLimitError, type RequestOptions, SafetyError };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+interface CencoriConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: string;
+    headers?: Record<string, string>;
+}
+
+interface ChatParams {
+    messages: Message[];
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+}
+interface Message {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface ChatResponse {
+    role: string;
+    content: string;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+
+declare class AIModule {
+    private client;
+    constructor(client: CencoriClient);
+    chat(params: ChatParams): Promise<ChatResponse>;
+}
+
+declare class CencoriClient {
+    private apiKey;
+    private baseUrl;
+    ai: AIModule;
+    constructor(config: CencoriConfig);
+    request<T>(endpoint: string, options: RequestOptions): Promise<T>;
+}
+
+declare class CencoriError extends Error {
+    statusCode?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, code?: string | undefined);
+}
+declare class AuthenticationError extends CencoriError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends CencoriError {
+    constructor(message?: string);
+}
+declare class SafetyError extends CencoriError {
+    reasons?: string[] | undefined;
+    constructor(message?: string, reasons?: string[] | undefined);
+}
+
+export { AuthenticationError, CencoriClient, type CencoriConfig, CencoriError, type ChatParams, type ChatResponse, type Message, RateLimitError, type RequestOptions, SafetyError };

package/dist/index.js

@@ -0,0 +1,164 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthenticationError: () => AuthenticationError,
+  CencoriClient: () => CencoriClient,
+  CencoriError: () => CencoriError,
+  RateLimitError: () => RateLimitError,
+  SafetyError: () => SafetyError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/modules/ai.ts
+var AIModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async chat(params) {
+    return this.client.request("/api/ai/chat", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+};
+
+// src/utils.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function fetchWithRetry(url, options, maxRetries = 3) {
+  let lastError = null;
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      const response = await fetch(url, options);
+      if (response.ok || response.status >= 400 && response.status < 500) {
+        return response;
+      }
+      lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
+      if (attempt === maxRetries - 1) {
+        return response;
+      }
+      await sleep(Math.pow(2, attempt) * 1e3);
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt === maxRetries - 1) {
+        throw lastError;
+      }
+      await sleep(Math.pow(2, attempt) * 1e3);
+    }
+  }
+  throw lastError || new Error("Max retries reached");
+}
+
+// src/errors.ts
+var CencoriError = class _CencoriError extends Error {
+  constructor(message, statusCode, code) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "CencoriError";
+    Object.setPrototypeOf(this, _CencoriError.prototype);
+  }
+};
+var AuthenticationError = class _AuthenticationError extends CencoriError {
+  constructor(message = "Invalid API key") {
+    super(message, 401, "INVALID_API_KEY");
+    this.name = "AuthenticationError";
+    Object.setPrototypeOf(this, _AuthenticationError.prototype);
+  }
+};
+var RateLimitError = class _RateLimitError extends CencoriError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429, "RATE_LIMIT_EXCEEDED");
+    this.name = "RateLimitError";
+    Object.setPrototypeOf(this, _RateLimitError.prototype);
+  }
+};
+var SafetyError = class _SafetyError extends CencoriError {
+  constructor(message = "Content safety violation", reasons) {
+    super(message, 400, "SAFETY_VIOLATION");
+    this.reasons = reasons;
+    this.name = "SafetyError";
+    Object.setPrototypeOf(this, _SafetyError.prototype);
+  }
+};
+
+// src/client.ts
+var CencoriClient = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || "https://cencori.com";
+    this.ai = new AIModule(this);
+  }
+  async request(endpoint, options) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "CENCORI_API_KEY": this.apiKey,
+      ...options.headers
+    };
+    try {
+      const response = await fetchWithRetry(url, {
+        method: options.method,
+        headers,
+        body: options.body
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        const errorData = data;
+        if (response.status === 401) {
+          throw new AuthenticationError(errorData.error || "Invalid API key");
+        }
+        if (response.status === 429) {
+          throw new RateLimitError(errorData.error || "Rate limit exceeded");
+        }
+        if (response.status === 400 && errorData.reasons) {
+          throw new SafetyError(errorData.error, errorData.reasons);
+        }
+        throw new CencoriError(
+          errorData.error || "Request failed",
+          response.status
+        );
+      }
+      return data;
+    } catch (error) {
+      if (error instanceof CencoriError) {
+        throw error;
+      }
+      throw new CencoriError(
+        error instanceof Error ? error.message : "Unknown error occurred"
+      );
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  CencoriClient,
+  CencoriError,
+  RateLimitError,
+  SafetyError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/modules/ai.ts","../src/utils.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { CencoriClient } from './client';\r\nexport * from './types';\r\nexport * from './errors';\r\n","import type { ChatParams, ChatResponse } from '../types/ai';\r\nimport type { CencoriClient } from '../client';\r\n\r\nexport class AIModule {\r\n    constructor(private client: CencoriClient) { }\r\n\r\n    async chat(params: ChatParams): Promise<ChatResponse> {\r\n        return this.client.request<ChatResponse>('/api/ai/chat', {\r\n            method: 'POST',\r\n            body: JSON.stringify(params)\r\n        });\r\n    }\r\n}\r\n","function sleep(ms: number): Promise<void> {\r\n    return new Promise(resolve => setTimeout(resolve, ms));\r\n}\r\n\r\nexport async function fetchWithRetry(\r\n    url: string,\r\n    options: RequestInit,\r\n    maxRetries = 3\r\n): Promise<Response> {\r\n    let lastError: Error | null = null;\r\n\r\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\r\n        try {\r\n            const response = await fetch(url, options);\r\n\r\n            // Return immediately if request succeeded or if it's a client error (4xx)\r\n            if (response.ok || (response.status >= 400 && response.status < 500)) {\r\n                return response;\r\n            }\r\n\r\n            // Retry on 5xx errors\r\n            lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);\r\n\r\n            // Don't retry on last attempt\r\n            if (attempt === maxRetries - 1) {\r\n                return response;\r\n            }\r\n\r\n            // Exponential backoff: 1s, 2s, 4s\r\n            await sleep(Math.pow(2, attempt) * 1000);\r\n        } catch (error) {\r\n            lastError = error instanceof Error ? error : new Error(String(error));\r\n\r\n            // Don't retry on last attempt\r\n            if (attempt === maxRetries - 1) {\r\n                throw lastError;\r\n            }\r\n\r\n            // Exponential backoff\r\n            await sleep(Math.pow(2, attempt) * 1000);\r\n        }\r\n    }\r\n\r\n    throw lastError || new Error('Max retries reached');\r\n}\r\n","export class CencoriError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public statusCode?: number,\r\n        public code?: string\r\n    ) {\r\n        super(message);\r\n        this.name = 'CencoriError';\r\n        Object.setPrototypeOf(this, CencoriError.prototype);\r\n    }\r\n}\r\n\r\nexport class AuthenticationError extends CencoriError {\r\n    constructor(message = 'Invalid API key') {\r\n        super(message, 401, 'INVALID_API_KEY');\r\n        this.name = 'AuthenticationError';\r\n        Object.setPrototypeOf(this, AuthenticationError.prototype);\r\n    }\r\n}\r\n\r\nexport class RateLimitError extends CencoriError {\r\n    constructor(message = 'Rate limit exceeded') {\r\n        super(message, 429, 'RATE_LIMIT_EXCEEDED');\r\n        this.name = 'RateLimitError';\r\n        Object.setPrototypeOf(this, RateLimitError.prototype);\r\n    }\r\n}\r\n\r\nexport class SafetyError extends CencoriError {\r\n    constructor(message = 'Content safety violation', public reasons?: string[]) {\r\n        super(message, 400, 'SAFETY_VIOLATION');\r\n        this.name = 'SafetyError';\r\n        Object.setPrototypeOf(this, SafetyError.prototype);\r\n    }\r\n}\r\n","import type { CencoriConfig, RequestOptions } from './types/common';\nimport { AIModule } from './modules/ai';\nimport { fetchWithRetry } from './utils';\nimport {\n    CencoriError,\n    AuthenticationError,\n    RateLimitError,\n    SafetyError\n} from './errors';\n\ninterface ErrorResponse {\n    error?: string;\n    reasons?: string[];\n}\n\nexport class CencoriClient {\n    private apiKey: string;\n    private baseUrl: string;\n\n    public ai: AIModule;\n\n    constructor(config: CencoriConfig) {\n        if (!config.apiKey) {\n            throw new Error('API key is required');\n        }\n\n        this.apiKey = config.apiKey;\n        this.baseUrl = config.baseUrl || 'https://cencori.com';\n\n        this.ai = new AIModule(this);\n    }\n\n    async request<T>(endpoint: string, options: RequestOptions): Promise<T> {\n        const url = `${this.baseUrl}${endpoint}`;\n\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n            'CENCORI_API_KEY': this.apiKey,\n            ...options.headers\n        };\n\n        try {\n            const response = await fetchWithRetry(url, {\n                method: options.method,\n                headers,\n                body: options.body\n            });\n\n            const data: unknown = await response.json();\n\n            // Handle API errors\n            if (!response.ok) {\n                const errorData = data as ErrorResponse;\n                \n                if (response.status === 401) {\n                    throw new AuthenticationError(errorData.error || 'Invalid API key');\n                }\n                if (response.status === 429) {\n                    throw new RateLimitError(errorData.error || 'Rate limit exceeded');\n                }\n                if (response.status === 400 && errorData.reasons) {\n                    throw new SafetyError(errorData.error, errorData.reasons);\n                }\n                throw new CencoriError(\n                    errorData.error || 'Request failed',\n                    response.status\n                );\n            }\n\n            return data as T;\n        } catch (error) {\n            // Re-throw custom errors\n            if (error instanceof CencoriError) {\n                throw error;\n            }\n\n            // Wrap unknown errors\n            throw new CencoriError(\n                error instanceof Error ? error.message : 'Unknown error occurred'\n            );\n        }\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,133 @@
+// src/modules/ai.ts
+var AIModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async chat(params) {
+    return this.client.request("/api/ai/chat", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+};
+
+// src/utils.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function fetchWithRetry(url, options, maxRetries = 3) {
+  let lastError = null;
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      const response = await fetch(url, options);
+      if (response.ok || response.status >= 400 && response.status < 500) {
+        return response;
+      }
+      lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
+      if (attempt === maxRetries - 1) {
+        return response;
+      }
+      await sleep(Math.pow(2, attempt) * 1e3);
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt === maxRetries - 1) {
+        throw lastError;
+      }
+      await sleep(Math.pow(2, attempt) * 1e3);
+    }
+  }
+  throw lastError || new Error("Max retries reached");
+}
+
+// src/errors.ts
+var CencoriError = class _CencoriError extends Error {
+  constructor(message, statusCode, code) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "CencoriError";
+    Object.setPrototypeOf(this, _CencoriError.prototype);
+  }
+};
+var AuthenticationError = class _AuthenticationError extends CencoriError {
+  constructor(message = "Invalid API key") {
+    super(message, 401, "INVALID_API_KEY");
+    this.name = "AuthenticationError";
+    Object.setPrototypeOf(this, _AuthenticationError.prototype);
+  }
+};
+var RateLimitError = class _RateLimitError extends CencoriError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429, "RATE_LIMIT_EXCEEDED");
+    this.name = "RateLimitError";
+    Object.setPrototypeOf(this, _RateLimitError.prototype);
+  }
+};
+var SafetyError = class _SafetyError extends CencoriError {
+  constructor(message = "Content safety violation", reasons) {
+    super(message, 400, "SAFETY_VIOLATION");
+    this.reasons = reasons;
+    this.name = "SafetyError";
+    Object.setPrototypeOf(this, _SafetyError.prototype);
+  }
+};
+
+// src/client.ts
+var CencoriClient = class {
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl || "https://cencori.com";
+    this.ai = new AIModule(this);
+  }
+  async request(endpoint, options) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "CENCORI_API_KEY": this.apiKey,
+      ...options.headers
+    };
+    try {
+      const response = await fetchWithRetry(url, {
+        method: options.method,
+        headers,
+        body: options.body
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        const errorData = data;
+        if (response.status === 401) {
+          throw new AuthenticationError(errorData.error || "Invalid API key");
+        }
+        if (response.status === 429) {
+          throw new RateLimitError(errorData.error || "Rate limit exceeded");
+        }
+        if (response.status === 400 && errorData.reasons) {
+          throw new SafetyError(errorData.error, errorData.reasons);
+        }
+        throw new CencoriError(
+          errorData.error || "Request failed",
+          response.status
+        );
+      }
+      return data;
+    } catch (error) {
+      if (error instanceof CencoriError) {
+        throw error;
+      }
+      throw new CencoriError(
+        error instanceof Error ? error.message : "Unknown error occurred"
+      );
+    }
+  }
+};
+export {
+  AuthenticationError,
+  CencoriClient,
+  CencoriError,
+  RateLimitError,
+  SafetyError
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/ai.ts","../src/utils.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { ChatParams, ChatResponse } from '../types/ai';\r\nimport type { CencoriClient } from '../client';\r\n\r\nexport class AIModule {\r\n    constructor(private client: CencoriClient) { }\r\n\r\n    async chat(params: ChatParams): Promise<ChatResponse> {\r\n        return this.client.request<ChatResponse>('/api/ai/chat', {\r\n            method: 'POST',\r\n            body: JSON.stringify(params)\r\n        });\r\n    }\r\n}\r\n","function sleep(ms: number): Promise<void> {\r\n    return new Promise(resolve => setTimeout(resolve, ms));\r\n}\r\n\r\nexport async function fetchWithRetry(\r\n    url: string,\r\n    options: RequestInit,\r\n    maxRetries = 3\r\n): Promise<Response> {\r\n    let lastError: Error | null = null;\r\n\r\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\r\n        try {\r\n            const response = await fetch(url, options);\r\n\r\n            // Return immediately if request succeeded or if it's a client error (4xx)\r\n            if (response.ok || (response.status >= 400 && response.status < 500)) {\r\n                return response;\r\n            }\r\n\r\n            // Retry on 5xx errors\r\n            lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);\r\n\r\n            // Don't retry on last attempt\r\n            if (attempt === maxRetries - 1) {\r\n                return response;\r\n            }\r\n\r\n            // Exponential backoff: 1s, 2s, 4s\r\n            await sleep(Math.pow(2, attempt) * 1000);\r\n        } catch (error) {\r\n            lastError = error instanceof Error ? error : new Error(String(error));\r\n\r\n            // Don't retry on last attempt\r\n            if (attempt === maxRetries - 1) {\r\n                throw lastError;\r\n            }\r\n\r\n            // Exponential backoff\r\n            await sleep(Math.pow(2, attempt) * 1000);\r\n        }\r\n    }\r\n\r\n    throw lastError || new Error('Max retries reached');\r\n}\r\n","export class CencoriError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public statusCode?: number,\r\n        public code?: string\r\n    ) {\r\n        super(message);\r\n        this.name = 'CencoriError';\r\n        Object.setPrototypeOf(this, CencoriError.prototype);\r\n    }\r\n}\r\n\r\nexport class AuthenticationError extends CencoriError {\r\n    constructor(message = 'Invalid API key') {\r\n        super(message, 401, 'INVALID_API_KEY');\r\n        this.name = 'AuthenticationError';\r\n        Object.setPrototypeOf(this, AuthenticationError.prototype);\r\n    }\r\n}\r\n\r\nexport class RateLimitError extends CencoriError {\r\n    constructor(message = 'Rate limit exceeded') {\r\n        super(message, 429, 'RATE_LIMIT_EXCEEDED');\r\n        this.name = 'RateLimitError';\r\n        Object.setPrototypeOf(this, RateLimitError.prototype);\r\n    }\r\n}\r\n\r\nexport class SafetyError extends CencoriError {\r\n    constructor(message = 'Content safety violation', public reasons?: string[]) {\r\n        super(message, 400, 'SAFETY_VIOLATION');\r\n        this.name = 'SafetyError';\r\n        Object.setPrototypeOf(this, SafetyError.prototype);\r\n    }\r\n}\r\n","import type { CencoriConfig, RequestOptions } from './types/common';\nimport { AIModule } from './modules/ai';\nimport { fetchWithRetry } from './utils';\nimport {\n    CencoriError,\n    AuthenticationError,\n    RateLimitError,\n    SafetyError\n} from './errors';\n\ninterface ErrorResponse {\n    error?: string;\n    reasons?: string[];\n}\n\nexport class CencoriClient {\n    private apiKey: string;\n    private baseUrl: string;\n\n    public ai: AIModule;\n\n    constructor(config: CencoriConfig) {\n        if (!config.apiKey) {\n            throw new Error('API key is required');\n        }\n\n        this.apiKey = config.apiKey;\n        this.baseUrl = config.baseUrl || 'https://cencori.com';\n\n        this.ai = new AIModule(this);\n    }\n\n    async request<T>(endpoint: string, options: RequestOptions): Promise<T> {\n        const url = `${this.baseUrl}${endpoint}`;\n\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n            'CENCORI_API_KEY': this.apiKey,\n            ...options.headers\n        };\n\n        try {\n            const response = await fetchWithRetry(url, {\n                method: options.method,\n                headers,\n                body: options.body\n            });\n\n            const data: unknown = await response.json();\n\n            // Handle API errors\n            if (!response.ok) {\n                const errorData = data as ErrorResponse;\n                \n                if (response.status === 401) {\n                    throw new AuthenticationError(errorData.error || 'Invalid API key');\n                }\n                if (response.status === 429) {\n                    throw new RateLimitError(errorData.error || 'Rate limit exceeded');\n                }\n                if (response.status === 400 && errorData.reasons) {\n                    throw new SafetyError(errorData.error, errorData.reasons);\n                }\n                throw new CencoriError(\n                    errorData.error || 'Request failed',\n                    response.status\n                );\n            }\n\n            return data as T;\n        } catch (error) {\n            // Re-throw custom errors\n            if (error instanceof CencoriError) {\n                throw error;\n            }\n\n            // Wrap unknown errors\n            throw new CencoriError(\n                error instanceof Error ? error.message : 'Unknown error occurred'\n            );\n        }\n    }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "cencori",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for Cencori AI Gateway and Infrastructure Platform",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "ai",
+    "gateway",
+    "cencori",
+    "sdk",
+    "typescript"
+  ],
+  "author": "FohnAI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bolaabanjo/cencori"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}