primellm 0.1.0 → 0.2.0

package/dist/types.d.ts

@@ -3,139 +3,170 @@
  *
  * This file contains all the TypeScript types used by the PrimeLLM SDK.
  * These types match the response format from the PrimeLLM API.
- *
- * Think of types like "templates" that describe what data looks like.
- * They help catch errors before your code runs!
  */
 /**
  * The role of a message in a conversation.
- * - "system": Instructions for the AI (like "be helpful")
- * - "user": Messages from the human user
- * - "assistant": Messages from the AI
  */
 export type ChatRole = "system" | "user" | "assistant";
 /**
  * A single message in a conversation.
- * Each message has a role (who said it) and content (what they said).
  */
 export interface ChatMessage {
     role: ChatRole;
     content: string;
 }
+/** Alias for ChatMessage */
+export type Message = ChatMessage;
 /**
- * Request body for the /v1/chat and /v1/chat/completions endpoints.
- * This is what you send TO the API.
+ * Request body for the /v1/chat endpoint.
  */
 export interface ChatRequest {
-    /** Model name, e.g. "gpt-5.1", "claude-sonnet-4.5", "gemini-3.0" */
     model: string;
-    /** List of messages in the conversation */
     messages: ChatMessage[];
-    /** Whether to stream the response (not supported yet) */
     stream?: boolean;
-    /** Optional extra data to pass along */
     metadata?: Record<string, unknown>;
-    /** Temperature for randomness (0.0 = focused, 1.0 = creative) */
     temperature?: number;
-    /** Maximum tokens to generate */
     max_tokens?: number;
 }
 /**
  * Request body for the /generate endpoint (legacy).
- * This endpoint uses a simpler "prompt" format instead of messages.
  */
 export interface GenerateRequest {
-    /** Model name, e.g. "gpt-5.1" */
     model: string;
-    /** The messages to send (same as ChatRequest) */
     messages: ChatMessage[];
-    /** Maximum tokens to generate */
     max_tokens?: number;
-    /** Temperature for randomness */
     temperature?: number;
-    /** Whether to stream (not supported yet) */
     stream?: boolean;
-    /** Optional extra data */
     metadata?: Record<string, unknown>;
 }
 /**
- * A single "choice" in the API response.
- * The API can return multiple choices, but usually returns just one.
+ * Request body for embeddings
  */
+export interface EmbeddingsRequest {
+    model?: string;
+    input: string | string[];
+}
 export interface ChatChoice {
-    /** Index of this choice (usually 0) */
     index: number;
-    /** The AI's response message */
     message: ChatMessage;
-    /** Why the AI stopped: "stop" means it finished normally */
     finish_reason?: string | null;
 }
-/**
- * Token usage information.
- * Tokens are like "word pieces" - the AI counts usage in tokens.
- */
 export interface Usage {
-    /** Tokens used by your input (prompt) */
     prompt_tokens: number;
-    /** Tokens used by the AI's response */
     completion_tokens: number;
-    /** Total tokens = prompt + completion */
     total_tokens: number;
 }
-/**
- * Credit information from your PrimeLLM account.
- * Credits are like "money" - each API call costs some credits.
- */
 export interface CreditsInfo {
-    /** How many credits you have left */
     remaining: number;
-    /** How much this request cost */
     cost?: number;
 }
-/**
- * The full response from /v1/chat or /v1/chat/completions.
- * This matches the OpenAI response format.
- */
 export interface ChatResponse {
-    /** Unique ID for this response */
     id: string;
-    /** Which model was used */
     model: string;
-    /** When this was created (Unix timestamp in seconds) */
     created: number;
-    /** Type of object (always "chat.completion") */
     object?: string;
-    /** The AI's response(s) */
     choices: ChatChoice[];
-    /** Token usage information */
     usage: Usage;
-    /** Your credit balance (PrimeLLM-specific) */
     credits?: CreditsInfo;
 }
-/**
- * Response from the /generate endpoint (legacy format).
- */
 export interface GenerateResponse {
-    /** The AI's reply text */
     reply: string;
-    /** Which model was used */
     model: string;
-    /** Total tokens used */
     tokens_used: number;
-    /** Cost of this request */
     cost: number;
-    /** Credits remaining in your account */
     credits_remaining: number;
 }
 /**
- * Options for creating a PrimeLLMClient.
+ * 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 (starts with "primellm_live_") */
+    /** Your PrimeLLM API key */
     apiKey: string;
     /** Base URL for the API (default: "https://api.primellm.in") */
     baseURL?: string;
-    /** Request timeout in milliseconds (default: 60000 = 60 seconds) */
+    /** 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 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IAEd,2CAA2C;IAC3C,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IAEd,iDAAiD;IACjD,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,OAAO,EAAE,WAAW,CAAC;IAErB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IAClB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IAEX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC;IAEb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,WAAW,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -3,8 +3,5 @@
  *
  * This file contains all the TypeScript types used by the PrimeLLM SDK.
  * These types match the response format from the PrimeLLM API.
- *
- * Think of types like "templates" that describe what data looks like.
- * They help catch errors before your code runs!
  */
 export {};

package/package.json

@@ -1,11 +1,14 @@
 {
     "name": "primellm",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "Official JavaScript SDK for PrimeLLM (gpt-5.1, Claude-style AI).",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
     "types": "dist/index.d.ts",
     "type": "module",
+    "bin": {
+        "primellm": "./cli/index.js"
+    },
     "keywords": [
         "ai",
         "llm",
@@ -15,14 +18,17 @@
         "claude",
         "gemini",
         "openai",
-        "sdk"
+        "sdk",
+        "cli",
+        "streaming"
     ],
     "author": "PrimeLLM",
     "license": "MIT",
     "scripts": {
         "build": "tsc -p tsconfig.json",
         "lint": "echo \"no lint configured yet\"",
-        "test": "node ./examples/chat-basic.mjs"
+        "test": "node ./examples/chat-basic.mjs",
+        "test:smoke": "node ./test/smoke.mjs"
     },
     "devDependencies": {
         "typescript": "^5.6.0"
@@ -32,6 +38,7 @@
     },
     "files": [
         "dist",
+        "cli",
         "README.md"
     ],
     "homepage": "https://primellm.in"