@lockllm/sdk 1.0.0

package/dist/utils.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Utility functions for HTTP requests and common operations
+ */
+import type { RequestOptions } from './types/common';
+import type { ProviderName } from './types/providers';
+/**
+ * Get the proxy URL for a specific provider
+ *
+ * @param provider - The provider name
+ * @returns The full proxy URL for the provider
+ *
+ * @example
+ * ```typescript
+ * const url = getProxyURL('openai');
+ * // Returns: 'https://api.lockllm.com/v1/proxy/openai'
+ * ```
+ */
+export declare function getProxyURL(provider: ProviderName): string;
+/**
+ * Get all available proxy URLs
+ *
+ * @returns Record of all provider proxy URLs
+ *
+ * @example
+ * ```typescript
+ * const urls = getAllProxyURLs();
+ * console.log(urls.openai); // 'https://api.lockllm.com/v1/proxy/openai'
+ * console.log(urls.anthropic); // 'https://api.lockllm.com/v1/proxy/anthropic'
+ * ```
+ */
+export declare function getAllProxyURLs(): Record<ProviderName, string>;
+/**
+ * Generate a unique request ID
+ */
+export declare function generateRequestId(): string;
+/**
+ * Sleep for a specified number of milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Parse Retry-After header value to milliseconds
+ */
+export declare function parseRetryAfter(retryAfter: string | null): number | undefined;
+/**
+ * Exponential backoff delay calculation
+ */
+export declare function calculateBackoff(attempt: number, baseDelay?: number): number;
+/**
+ * HTTP client for making requests to LockLLM API
+ */
+export declare class HttpClient {
+    private baseURL;
+    private apiKey;
+    private timeout;
+    private maxRetries;
+    constructor(baseURL: string, apiKey: string, timeout?: number, maxRetries?: number);
+    /**
+     * Make a GET request
+     */
+    get<T = any>(path: string, options?: RequestOptions): Promise<{
+        data: T;
+        requestId: string;
+    }>;
+    /**
+     * Make a POST request
+     */
+    post<T = any>(path: string, body?: any, options?: RequestOptions): Promise<{
+        data: T;
+        requestId: string;
+    }>;
+    /**
+     * Make an HTTP request with retry logic
+     */
+    private request;
+    /**
+     * Make a single HTTP request
+     */
+    private makeRequest;
+    /**
+     * Check if an error is retryable
+     */
+    private isRetryableError;
+}
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAoB9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAgB7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM,CAElF;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAGzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAc,EACvB,UAAU,GAAE,MAAU;IAQxB;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1C;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1C;;OAEG;YACW,OAAO;IAoFrB;;OAEG;YACW,WAAW;IAqCzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkBzB"}

package/dist/utils.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Utility functions for HTTP requests and common operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+exports.getProxyURL = getProxyURL;
+exports.getAllProxyURLs = getAllProxyURLs;
+exports.generateRequestId = generateRequestId;
+exports.sleep = sleep;
+exports.parseRetryAfter = parseRetryAfter;
+exports.calculateBackoff = calculateBackoff;
+const errors_1 = require("./errors");
+const LOCKLLM_PROXY_BASE = 'https://api.lockllm.com/v1/proxy';
+/**
+ * Get the proxy URL for a specific provider
+ *
+ * @param provider - The provider name
+ * @returns The full proxy URL for the provider
+ *
+ * @example
+ * ```typescript
+ * const url = getProxyURL('openai');
+ * // Returns: 'https://api.lockllm.com/v1/proxy/openai'
+ * ```
+ */
+function getProxyURL(provider) {
+    return `${LOCKLLM_PROXY_BASE}/${provider}`;
+}
+/**
+ * Get all available proxy URLs
+ *
+ * @returns Record of all provider proxy URLs
+ *
+ * @example
+ * ```typescript
+ * const urls = getAllProxyURLs();
+ * console.log(urls.openai); // 'https://api.lockllm.com/v1/proxy/openai'
+ * console.log(urls.anthropic); // 'https://api.lockllm.com/v1/proxy/anthropic'
+ * ```
+ */
+function getAllProxyURLs() {
+    return {
+        openai: getProxyURL('openai'),
+        anthropic: getProxyURL('anthropic'),
+        gemini: getProxyURL('gemini'),
+        cohere: getProxyURL('cohere'),
+        openrouter: getProxyURL('openrouter'),
+        perplexity: getProxyURL('perplexity'),
+        mistral: getProxyURL('mistral'),
+        groq: getProxyURL('groq'),
+        deepseek: getProxyURL('deepseek'),
+        together: getProxyURL('together'),
+        xai: getProxyURL('xai'),
+        fireworks: getProxyURL('fireworks'),
+        anyscale: getProxyURL('anyscale'),
+        huggingface: getProxyURL('huggingface'),
+        azure: getProxyURL('azure'),
+        bedrock: getProxyURL('bedrock'),
+        'vertex-ai': getProxyURL('vertex-ai'),
+    };
+}
+/**
+ * Generate a unique request ID
+ */
+function generateRequestId() {
+    return `req_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
+}
+/**
+ * Sleep for a specified number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Parse Retry-After header value to milliseconds
+ */
+function parseRetryAfter(retryAfter) {
+    if (!retryAfter)
+        return undefined;
+    // If it's a number, it's seconds
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+        return seconds * 1000;
+    }
+    // If it's a date string, calculate diff
+    const date = new Date(retryAfter);
+    if (!isNaN(date.getTime())) {
+        return Math.max(0, date.getTime() - Date.now());
+    }
+    return undefined;
+}
+/**
+ * Exponential backoff delay calculation
+ */
+function calculateBackoff(attempt, baseDelay = 1000) {
+    return Math.min(baseDelay * Math.pow(2, attempt), 30000);
+}
+/**
+ * HTTP client for making requests to LockLLM API
+ */
+class HttpClient {
+    constructor(baseURL, apiKey, timeout = 60000, maxRetries = 3) {
+        this.baseURL = baseURL.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = apiKey;
+        this.timeout = timeout;
+        this.maxRetries = maxRetries;
+    }
+    /**
+     * Make a GET request
+     */
+    async get(path, options) {
+        return this.request('GET', path, undefined, options);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(path, body, options) {
+        return this.request('POST', path, body, options);
+    }
+    /**
+     * Make an HTTP request with retry logic
+     */
+    async request(method, path, body, options) {
+        const url = `${this.baseURL}${path}`;
+        const requestId = generateRequestId();
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const response = await this.makeRequest(method, url, body, requestId, options);
+                const responseRequestId = response.headers.get('X-Request-Id') || requestId;
+                // Success
+                if (response.ok) {
+                    const data = await response.json();
+                    return {
+                        data: data,
+                        requestId: responseRequestId,
+                    };
+                }
+                // Handle rate limiting with retry
+                if (response.status === 429) {
+                    const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
+                    if (attempt < this.maxRetries) {
+                        const delay = retryAfter || calculateBackoff(attempt);
+                        await sleep(delay);
+                        continue;
+                    }
+                    const errorData = await response.json().catch(() => ({}));
+                    throw new errors_1.RateLimitError(errorData.error?.message || 'Rate limit exceeded', retryAfter, responseRequestId);
+                }
+                // Handle other errors
+                const errorData = await response.json().catch(() => ({}));
+                throw (0, errors_1.parseError)(errorData, responseRequestId);
+            }
+            catch (error) {
+                // If it's already a LockLLMError, rethrow immediately (don't retry)
+                if (error instanceof errors_1.LockLLMError && !(error instanceof errors_1.RateLimitError)) {
+                    throw error;
+                }
+                lastError = error;
+                // Retry on network errors
+                if (attempt < this.maxRetries && this.isRetryableError(error)) {
+                    await sleep(calculateBackoff(attempt));
+                    continue;
+                }
+                // No more retries
+                break;
+            }
+        }
+        // All retries exhausted
+        if (lastError instanceof errors_1.LockLLMError) {
+            throw lastError;
+        }
+        throw new errors_1.NetworkError(lastError?.message || 'Network request failed', lastError, requestId);
+    }
+    /**
+     * Make a single HTTP request
+     */
+    async makeRequest(method, url, body, requestId, options) {
+        const controller = new AbortController();
+        const timeoutMs = options?.timeout || this.timeout;
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+                'X-Request-Id': requestId,
+                ...options?.headers,
+            };
+            // Use user's signal if provided, otherwise use timeout controller
+            // If user provides a signal, they're responsible for timeout
+            const signal = options?.signal || controller.signal;
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal,
+            });
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Check if an error is retryable
+     */
+    isRetryableError(error) {
+        // Retry on network errors
+        if (error instanceof TypeError && error.message.includes('fetch')) {
+            return true;
+        }
+        // Retry on timeout
+        if (error.name === 'AbortError') {
+            return true;
+        }
+        // Retry on rate limit (handled separately)
+        if (error instanceof errors_1.RateLimitError) {
+            return true;
+        }
+        return false;
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/utils.mjs

@@ -0,0 +1,215 @@
+/**
+ * Utility functions for HTTP requests and common operations
+ */
+import { LockLLMError, NetworkError, RateLimitError, parseError, } from './errors';
+const LOCKLLM_PROXY_BASE = 'https://api.lockllm.com/v1/proxy';
+/**
+ * Get the proxy URL for a specific provider
+ *
+ * @param provider - The provider name
+ * @returns The full proxy URL for the provider
+ *
+ * @example
+ * ```typescript
+ * const url = getProxyURL('openai');
+ * // Returns: 'https://api.lockllm.com/v1/proxy/openai'
+ * ```
+ */
+export function getProxyURL(provider) {
+    return `${LOCKLLM_PROXY_BASE}/${provider}`;
+}
+/**
+ * Get all available proxy URLs
+ *
+ * @returns Record of all provider proxy URLs
+ *
+ * @example
+ * ```typescript
+ * const urls = getAllProxyURLs();
+ * console.log(urls.openai); // 'https://api.lockllm.com/v1/proxy/openai'
+ * console.log(urls.anthropic); // 'https://api.lockllm.com/v1/proxy/anthropic'
+ * ```
+ */
+export function getAllProxyURLs() {
+    return {
+        openai: getProxyURL('openai'),
+        anthropic: getProxyURL('anthropic'),
+        gemini: getProxyURL('gemini'),
+        cohere: getProxyURL('cohere'),
+        openrouter: getProxyURL('openrouter'),
+        perplexity: getProxyURL('perplexity'),
+        mistral: getProxyURL('mistral'),
+        groq: getProxyURL('groq'),
+        deepseek: getProxyURL('deepseek'),
+        together: getProxyURL('together'),
+        xai: getProxyURL('xai'),
+        fireworks: getProxyURL('fireworks'),
+        anyscale: getProxyURL('anyscale'),
+        huggingface: getProxyURL('huggingface'),
+        azure: getProxyURL('azure'),
+        bedrock: getProxyURL('bedrock'),
+        'vertex-ai': getProxyURL('vertex-ai'),
+    };
+}
+/**
+ * Generate a unique request ID
+ */
+export function generateRequestId() {
+    return `req_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
+}
+/**
+ * Sleep for a specified number of milliseconds
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Parse Retry-After header value to milliseconds
+ */
+export function parseRetryAfter(retryAfter) {
+    if (!retryAfter)
+        return undefined;
+    // If it's a number, it's seconds
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+        return seconds * 1000;
+    }
+    // If it's a date string, calculate diff
+    const date = new Date(retryAfter);
+    if (!isNaN(date.getTime())) {
+        return Math.max(0, date.getTime() - Date.now());
+    }
+    return undefined;
+}
+/**
+ * Exponential backoff delay calculation
+ */
+export function calculateBackoff(attempt, baseDelay = 1000) {
+    return Math.min(baseDelay * Math.pow(2, attempt), 30000);
+}
+/**
+ * HTTP client for making requests to LockLLM API
+ */
+export class HttpClient {
+    constructor(baseURL, apiKey, timeout = 60000, maxRetries = 3) {
+        this.baseURL = baseURL.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = apiKey;
+        this.timeout = timeout;
+        this.maxRetries = maxRetries;
+    }
+    /**
+     * Make a GET request
+     */
+    async get(path, options) {
+        return this.request('GET', path, undefined, options);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(path, body, options) {
+        return this.request('POST', path, body, options);
+    }
+    /**
+     * Make an HTTP request with retry logic
+     */
+    async request(method, path, body, options) {
+        const url = `${this.baseURL}${path}`;
+        const requestId = generateRequestId();
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const response = await this.makeRequest(method, url, body, requestId, options);
+                const responseRequestId = response.headers.get('X-Request-Id') || requestId;
+                // Success
+                if (response.ok) {
+                    const data = await response.json();
+                    return {
+                        data: data,
+                        requestId: responseRequestId,
+                    };
+                }
+                // Handle rate limiting with retry
+                if (response.status === 429) {
+                    const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
+                    if (attempt < this.maxRetries) {
+                        const delay = retryAfter || calculateBackoff(attempt);
+                        await sleep(delay);
+                        continue;
+                    }
+                    const errorData = await response.json().catch(() => ({}));
+                    throw new RateLimitError(errorData.error?.message || 'Rate limit exceeded', retryAfter, responseRequestId);
+                }
+                // Handle other errors
+                const errorData = await response.json().catch(() => ({}));
+                throw parseError(errorData, responseRequestId);
+            }
+            catch (error) {
+                // If it's already a LockLLMError, rethrow immediately (don't retry)
+                if (error instanceof LockLLMError && !(error instanceof RateLimitError)) {
+                    throw error;
+                }
+                lastError = error;
+                // Retry on network errors
+                if (attempt < this.maxRetries && this.isRetryableError(error)) {
+                    await sleep(calculateBackoff(attempt));
+                    continue;
+                }
+                // No more retries
+                break;
+            }
+        }
+        // All retries exhausted
+        if (lastError instanceof LockLLMError) {
+            throw lastError;
+        }
+        throw new NetworkError(lastError?.message || 'Network request failed', lastError, requestId);
+    }
+    /**
+     * Make a single HTTP request
+     */
+    async makeRequest(method, url, body, requestId, options) {
+        const controller = new AbortController();
+        const timeoutMs = options?.timeout || this.timeout;
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+                'X-Request-Id': requestId,
+                ...options?.headers,
+            };
+            // Use user's signal if provided, otherwise use timeout controller
+            // If user provides a signal, they're responsible for timeout
+            const signal = options?.signal || controller.signal;
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal,
+            });
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Check if an error is retryable
+     */
+    isRetryableError(error) {
+        // Retry on network errors
+        if (error instanceof TypeError && error.message.includes('fetch')) {
+            return true;
+        }
+        // Retry on timeout
+        if (error.name === 'AbortError') {
+            return true;
+        }
+        // Retry on rate limit (handled separately)
+        if (error instanceof RateLimitError) {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/wrappers/anthropic-wrapper.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Anthropic SDK wrapper - Drop-in replacement
+ *
+ * This wrapper allows you to use the official Anthropic SDK with LockLLM protection
+ * by simply changing how you initialize the client.
+ *
+ * @example
+ * ```typescript
+ * // Replace this:
+ * // import Anthropic from '@anthropic-ai/sdk';
+ * // const anthropic = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
+ *
+ * // With this:
+ * import { createAnthropic } from '@lockllm/sdk/wrappers';
+ * const anthropic = createAnthropic({
+ *   apiKey: process.env.LOCKLLM_API_KEY
+ * });
+ *
+ * // Everything else stays the same!
+ * const message = await anthropic.messages.create({
+ *   model: "claude-3-5-sonnet-20241022",
+ *   max_tokens: 1024,
+ *   messages: [{ role: "user", content: "Hello!" }]
+ * });
+ * ```
+ */
+export interface CreateAnthropicConfig {
+    /**
+     * Your LockLLM API key
+     * Get it from: https://www.lockllm.com/dashboard
+     */
+    apiKey: string;
+    /**
+     * Base URL for LockLLM proxy (default: https://api.lockllm.com/v1/proxy/anthropic)
+     * Override this only if you're using a custom LockLLM endpoint
+     */
+    baseURL?: string;
+    /**
+     * Other Anthropic client options
+     */
+    [key: string]: any;
+}
+/**
+ * Create an Anthropic client that routes through LockLLM proxy
+ *
+ * All requests are automatically scanned for prompt injection before being
+ * forwarded to Anthropic. Your Anthropic API key should be configured in the
+ * LockLLM dashboard at https://www.lockllm.com/dashboard
+ *
+ * @param config - Configuration options
+ * @returns Anthropic client instance
+ *
+ * @example
+ * ```typescript
+ * const anthropic = createAnthropic({
+ *   apiKey: process.env.LOCKLLM_API_KEY
+ * });
+ *
+ * const message = await anthropic.messages.create({
+ *   model: "claude-3-5-sonnet-20241022",
+ *   max_tokens: 1024,
+ *   messages: [{ role: "user", content: "Hello!" }]
+ * });
+ * ```
+ */
+/**
+ * Lazy-load Anthropic SDK constructor
+ * @internal - exposed for testing purposes
+ */
+export declare function getAnthropicConstructor(requireFn?: NodeJS.Require): any;
+export declare function createAnthropic(config: CreateAnthropicConfig): any;
+//# sourceMappingURL=anthropic-wrapper.d.ts.map

package/dist/wrappers/anthropic-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-wrapper.d.ts","sourceRoot":"","sources":["../../src/wrappers/anthropic-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,iBAAU,GAAG,GAAG,CAShE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,GAAG,CAYlE"}