primellm 0.2.0 → 1.0.1

package/dist/errors.js

@@ -1,93 +0,0 @@
-/**
- * PrimeLLM SDK Error Classes
- *
- * Typed errors for better error handling in applications.
- */
-/**
- * Base error class for all PrimeLLM SDK errors
- */
-export class PrimeLLMError extends Error {
-    constructor(message, meta) {
-        super(message);
-        this.name = 'PrimeLLMError';
-        this.meta = meta;
-    }
-}
-/**
- * Authentication failed (401)
- */
-export class AuthenticationError extends PrimeLLMError {
-    constructor(message = 'Invalid or missing API key', meta) {
-        super(message, meta);
-        this.name = 'AuthenticationError';
-    }
-}
-/**
- * Insufficient credits (402)
- */
-export class InsufficientCreditsError extends PrimeLLMError {
-    constructor(message = 'Insufficient credits', meta) {
-        super(message, meta);
-        this.name = 'InsufficientCreditsError';
-    }
-}
-/**
- * Rate limit exceeded (429)
- */
-export class RateLimitError extends PrimeLLMError {
-    constructor(message = 'Rate limit exceeded', meta, retryAfter) {
-        super(message, meta);
-        this.name = 'RateLimitError';
-        this.retryAfter = retryAfter;
-    }
-}
-/**
- * Resource not found (404)
- */
-export class NotFoundError extends PrimeLLMError {
-    constructor(message = 'Resource not found', meta) {
-        super(message, meta);
-        this.name = 'NotFoundError';
-    }
-}
-/**
- * Validation error (400)
- */
-export class ValidationError extends PrimeLLMError {
-    constructor(message = 'Invalid request', meta) {
-        super(message, meta);
-        this.name = 'ValidationError';
-    }
-}
-/**
- * Server error (5xx)
- */
-export class ServerError extends PrimeLLMError {
-    constructor(message = 'Server error', meta) {
-        super(message, meta);
-        this.name = 'ServerError';
-    }
-}
-/**
- * Map HTTP status code to appropriate error class
- */
-export function createErrorFromStatus(status, message, detail) {
-    const meta = { status, detail };
-    switch (status) {
-        case 400:
-            return new ValidationError(message, meta);
-        case 401:
-            return new AuthenticationError(message, meta);
-        case 402:
-            return new InsufficientCreditsError(message, meta);
-        case 404:
-            return new NotFoundError(message, meta);
-        case 429:
-            return new RateLimitError(message, meta);
-        default:
-            if (status >= 500) {
-                return new ServerError(message, meta);
-            }
-            return new PrimeLLMError(message, meta);
-    }
-}

package/dist/streaming.d.ts

@@ -1,29 +0,0 @@
-/**
- * PrimeLLM Streaming Utilities
- *
- * Async iterator for streaming chat completions.
- */
-/**
- * Chat stream chunk from SSE
- */
-export interface StreamChunk {
-    id: string;
-    object: string;
-    delta?: {
-        role?: string;
-        content?: string;
-    };
-    done?: boolean;
-    finish_reason?: string;
-}
-/**
- * Parse SSE data line to chunk object
- */
-export declare function parseSSELine(line: string): StreamChunk | null;
-/**
- * Create async iterator from SSE response stream
- *
- * @param reader - ReadableStreamDefaultReader from fetch response
- */
-export declare function streamReader(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<StreamChunk, void, unknown>;
-//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAe7D;AAED;;;;GAIG;AACH,wBAAuB,YAAY,CAC/B,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAChD,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAyC5C"}

package/dist/streaming.js

@@ -1,64 +0,0 @@
-/**
- * PrimeLLM Streaming Utilities
- *
- * Async iterator for streaming chat completions.
- */
-/**
- * Parse SSE data line to chunk object
- */
-export function parseSSELine(line) {
-    if (!line.startsWith('data:')) {
-        return null;
-    }
-    const data = line.slice(5).trim();
-    if (!data || data === '[DONE]') {
-        return null;
-    }
-    try {
-        return JSON.parse(data);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Create async iterator from SSE response stream
- *
- * @param reader - ReadableStreamDefaultReader from fetch response
- */
-export async function* streamReader(reader) {
-    const decoder = new TextDecoder();
-    let buffer = '';
-    try {
-        while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-                break;
-            }
-            buffer += decoder.decode(value, { stream: true });
-            // Process complete lines
-            const lines = buffer.split('\n');
-            buffer = lines.pop() || ''; // Keep incomplete line in buffer
-            for (const line of lines) {
-                const chunk = parseSSELine(line);
-                if (chunk) {
-                    yield chunk;
-                    // Check for done
-                    if (chunk.object === 'chat.completion.done' || chunk.done) {
-                        return;
-                    }
-                }
-            }
-        }
-        // Process remaining buffer
-        if (buffer) {
-            const chunk = parseSSELine(buffer);
-            if (chunk) {
-                yield chunk;
-            }
-        }
-    }
-    finally {
-        reader.releaseLock();
-    }
-}

package/dist/tokenizer.d.ts

@@ -1,42 +0,0 @@
-/**
- * PrimeLLM Token Counter
- *
- * Simple token estimation using chars/4 approximation.
- * Provides adapter point for future tiktoken integration.
- */
-import { Message } from './types.js';
-/**
- * Token counter adapter function type
- */
-export type TokenizerAdapter = (text: string) => number;
-/**
- * Count tokens in text or messages array
- *
- * @param input - Text string or array of messages
- * @returns Estimated token count
- *
- * @example
- * countTokens("Hello world") // ~3
- * countTokens([{role:"user", content:"Hello"}]) // ~2
- */
-export declare function countTokens(input: string | Message[]): number;
-/**
- * Set custom tokenizer adapter (for tiktoken or other)
- *
- * @param adapter - Function that takes text and returns token count
- *
- * @example
- * import { encoding_for_model } from 'tiktoken';
- * const enc = encoding_for_model('gpt-4');
- * setTokenizerAdapter((text) => enc.encode(text).length);
- */
-export declare function setTokenizerAdapter(adapter: TokenizerAdapter | null): void;
-/**
- * Get current tokenizer adapter
- */
-export declare function getTokenizerAdapter(): TokenizerAdapter | null;
-/**
- * Reset tokenizer to default (chars/4)
- */
-export declare function resetTokenizer(): void;
-//# sourceMappingURL=tokenizer.d.ts.map

package/dist/tokenizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAOxD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,MAAM,CAiB7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/tokenizer.js

@@ -1,61 +0,0 @@
-/**
- * PrimeLLM Token Counter
- *
- * Simple token estimation using chars/4 approximation.
- * Provides adapter point for future tiktoken integration.
- */
-/**
- * Current tokenizer adapter (defaults to simple chars/4)
- */
-let tokenizerAdapter = null;
-/**
- * Count tokens in text or messages array
- *
- * @param input - Text string or array of messages
- * @returns Estimated token count
- *
- * @example
- * countTokens("Hello world") // ~3
- * countTokens([{role:"user", content:"Hello"}]) // ~2
- */
-export function countTokens(input) {
-    let text;
-    if (Array.isArray(input)) {
-        text = input.map(m => m.content).join(' ');
-    }
-    else {
-        text = input;
-    }
-    // Use custom adapter if set
-    if (tokenizerAdapter) {
-        return tokenizerAdapter(text);
-    }
-    // Default: chars / 4 (simple approximation)
-    const chars = text.length;
-    return Math.max(1, Math.ceil(chars / 4));
-}
-/**
- * Set custom tokenizer adapter (for tiktoken or other)
- *
- * @param adapter - Function that takes text and returns token count
- *
- * @example
- * import { encoding_for_model } from 'tiktoken';
- * const enc = encoding_for_model('gpt-4');
- * setTokenizerAdapter((text) => enc.encode(text).length);
- */
-export function setTokenizerAdapter(adapter) {
-    tokenizerAdapter = adapter;
-}
-/**
- * Get current tokenizer adapter
- */
-export function getTokenizerAdapter() {
-    return tokenizerAdapter;
-}
-/**
- * Reset tokenizer to default (chars/4)
- */
-export function resetTokenizer() {
-    tokenizerAdapter = null;
-}

package/dist/types.d.ts

@@ -1,172 +0,0 @@
-/**
- * PrimeLLM SDK Types
- *
- * This file contains all the TypeScript types used by the PrimeLLM SDK.
- * These types match the response format from the PrimeLLM API.
- */
-/**
- * The role of a message in a conversation.
- */
-export type ChatRole = "system" | "user" | "assistant";
-/**
- * A single message in a conversation.
- */
-export interface ChatMessage {
-    role: ChatRole;
-    content: string;
-}
-/** Alias for ChatMessage */
-export type Message = ChatMessage;
-/**
- * Request body for the /v1/chat endpoint.
- */
-export interface ChatRequest {
-    model: string;
-    messages: ChatMessage[];
-    stream?: boolean;
-    metadata?: Record<string, unknown>;
-    temperature?: number;
-    max_tokens?: number;
-}
-/**
- * Request body for the /generate endpoint (legacy).
- */
-export interface GenerateRequest {
-    model: string;
-    messages: ChatMessage[];
-    max_tokens?: number;
-    temperature?: number;
-    stream?: boolean;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Request body for embeddings
- */
-export interface EmbeddingsRequest {
-    model?: string;
-    input: string | string[];
-}
-export interface ChatChoice {
-    index: number;
-    message: ChatMessage;
-    finish_reason?: string | null;
-}
-export interface Usage {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-}
-export interface CreditsInfo {
-    remaining: number;
-    cost?: number;
-}
-export interface ChatResponse {
-    id: string;
-    model: string;
-    created: number;
-    object?: string;
-    choices: ChatChoice[];
-    usage: Usage;
-    credits?: CreditsInfo;
-}
-export interface GenerateResponse {
-    reply: string;
-    model: string;
-    tokens_used: number;
-    cost: number;
-    credits_remaining: number;
-}
-/**
- * Embedding data item
- */
-export interface EmbeddingData {
-    object: string;
-    embedding: number[];
-    index: number;
-}
-/**
- * Embeddings response
- */
-export interface EmbeddingsResponse {
-    object: string;
-    data: EmbeddingData[];
-    model: string;
-    usage: {
-        prompt_tokens: number;
-        total_tokens: number;
-    };
-    cost?: number;
-    credits_remaining?: number;
-}
-/**
- * Model info
- */
-export interface ModelInfo {
-    id: string;
-    object: string;
-    owned_by: string;
-    label: string;
-    description: string;
-    pricing: {
-        per_1k_tokens: number;
-        currency: string;
-    };
-    capabilities: string[];
-}
-/**
- * Models list response
- */
-export interface ModelsResponse {
-    object: string;
-    data: ModelInfo[];
-}
-/**
- * Credits response
- */
-export interface CreditsResponse {
-    credits: number;
-    currency: string;
-    user_id?: number;
-}
-/**
- * API Key info
- */
-export interface KeyInfo {
-    id: number;
-    key_prefix: string;
-    created_at: number;
-    revoked: boolean;
-    active: boolean;
-}
-/**
- * Keys list response
- */
-export interface KeysResponse {
-    object: string;
-    data: KeyInfo[];
-    max_allowed: number;
-}
-/**
- * Key create response
- */
-export interface KeyCreateResponse {
-    id: number;
-    key: string;
-    created_at: number;
-    label?: string;
-    message: string;
-}
-/**
- * Options for creating a PrimeLLM client.
- */
-export interface PrimeLLMClientOptions {
-    /** Your PrimeLLM API key */
-    apiKey: string;
-    /** Base URL for the API (default: "https://api.primellm.in") */
-    baseURL?: string;
-    /** Request timeout in milliseconds (default: 60000) */
-    timeoutMs?: number;
-    /** Max retry attempts for failed requests (default: 3) */
-    maxRetries?: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,4BAA4B;AAC5B,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC;AAMlC;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B;AAMD,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,KAAK;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACH,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types.js

@@ -1,7 +0,0 @@
-/**
- * PrimeLLM SDK Types
- *
- * This file contains all the TypeScript types used by the PrimeLLM SDK.
- * These types match the response format from the PrimeLLM API.
- */
-export {};