primellm 0.2.0 → 1.0.0

package/package.json

@@ -1,45 +1,46 @@
 {
     "name": "primellm",
-    "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",
+    "version": "1.0.0",
+    "description": "Configure Claude Code and Codex to use PrimeLLM as the backend",
     "bin": {
-        "primellm": "./cli/index.js"
+        "primellm": "./dist/index.js"
+    },
+    "main": "./dist/index.js",
+    "scripts": {
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "dev": "npx ts-node src/index.ts",
+        "prepublishOnly": "npm run build"
     },
     "keywords": [
-        "ai",
-        "llm",
-        "chat",
         "primellm",
-        "gpt-5.1",
         "claude",
-        "gemini",
-        "openai",
-        "sdk",
+        "codex",
+        "ai",
+        "llm",
         "cli",
-        "streaming"
+        "configuration"
     ],
     "author": "PrimeLLM",
     "license": "MIT",
-    "scripts": {
-        "build": "tsc -p tsconfig.json",
-        "lint": "echo \"no lint configured yet\"",
-        "test": "node ./examples/chat-basic.mjs",
-        "test:smoke": "node ./test/smoke.mjs"
-    },
-    "devDependencies": {
-        "typescript": "^5.6.0"
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/rishuuu-codesss/primellm-backend"
     },
+    "homepage": "https://primellm.in",
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=16.0.0"
     },
-    "files": [
-        "dist",
-        "cli",
-        "README.md"
-    ],
-    "homepage": "https://primellm.in"
+    "dependencies": {
+        "chalk": "^4.1.2",
+        "enquirer": "^2.4.1",
+        "figlet": "^1.7.0",
+        "ora": "^5.4.1",
+        "open": "^8.4.2"
+    },
+    "devDependencies": {
+        "@types/figlet": "^1.5.8",
+        "@types/node": "^20.11.0",
+        "typescript": "^5.3.0"
+    }
 }

package/src/index.ts

@@ -0,0 +1,411 @@
+#!/usr/bin/env node
+
+import chalk from 'chalk';
+import figlet from 'figlet';
+import ora from 'ora';
+import { execSync, spawnSync } from 'child_process';
+import { platform, homedir } from 'os';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import open from 'open';
+import Enquirer from 'enquirer';
+
+const { prompt } = Enquirer;
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+const PRIMELLM_BASE_URL = 'https://api.primellm.in/v1';
+const PRIMELLM_DASHBOARD_URL = 'https://primellm.in/dashboard/api-keys';
+
+// Tool installation packages
+const TOOLS = {
+    'Claude Code': {
+        command: 'claude',
+        package: '@anthropic-ai/claude-code',
+        configName: 'claude',
+    },
+    'Codex': {
+        command: 'codex',
+        package: '@openai/codex',
+        configName: 'codex',
+    },
+} as const;
+
+type ToolName = keyof typeof TOOLS;
+
+// ============================================================================
+// SYSTEM DETECTION
+// ============================================================================
+
+function getOS(): string {
+    const os = platform();
+    switch (os) {
+        case 'darwin': return 'macOS';
+        case 'linux': return 'Linux';
+        case 'win32': return 'Windows';
+        default: return os;
+    }
+}
+
+function getShell(): string {
+    const shell = process.env.SHELL || process.env.COMSPEC || 'unknown';
+    const shellName = shell.split(/[/\\]/).pop() || 'unknown';
+    return shellName;
+}
+
+function getNodeVersion(): string {
+    return process.version;
+}
+
+function commandExists(cmd: string): boolean {
+    try {
+        const isWindows = platform() === 'win32';
+        const checkCmd = isWindows ? `where ${cmd}` : `which ${cmd}`;
+        execSync(checkCmd, { stdio: 'ignore' });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+// ============================================================================
+// ASCII ART & DISPLAY
+// ============================================================================
+
+function displayBanner(): void {
+    console.clear();
+
+    const banner = figlet.textSync('PrimeLLM', {
+        font: 'Big',
+        horizontalLayout: 'default',
+    });
+
+    console.log(chalk.cyan(banner));
+    console.log(chalk.gray('━'.repeat(60)));
+    console.log(chalk.white.bold('  Configure AI coding tools with PrimeLLM'));
+    console.log(chalk.gray('━'.repeat(60)));
+    console.log();
+}
+
+function displaySystemInfo(): void {
+    console.log(chalk.white.bold('📊 System Information\n'));
+
+    const os = getOS();
+    const shell = getShell();
+    const nodeVersion = getNodeVersion();
+
+    console.log(`  ${chalk.gray('OS:')}      ${chalk.green(os)}`);
+    console.log(`  ${chalk.gray('Shell:')}   ${chalk.green(shell)}`);
+    console.log(`  ${chalk.gray('Node:')}    ${chalk.green(nodeVersion)}`);
+    console.log();
+}
+
+// ============================================================================
+// CONFIGURATION PATHS
+// ============================================================================
+
+function getConfigPaths(tool: ToolName, scope: 'system' | 'project'): { dir: string; file: string } {
+    const home = homedir();
+
+    if (tool === 'Claude Code') {
+        if (scope === 'system') {
+            return {
+                dir: join(home, '.claude'),
+                file: join(home, '.claude', 'config.json'),
+            };
+        } else {
+            return {
+                dir: '.claude',
+                file: join('.claude', 'config.json'),
+            };
+        }
+    } else {
+        // Codex uses OpenAI-compatible config
+        if (scope === 'system') {
+            return {
+                dir: join(home, '.codex'),
+                file: join(home, '.codex', 'config.json'),
+            };
+        } else {
+            return {
+                dir: '.codex',
+                file: join('.codex', 'config.json'),
+            };
+        }
+    }
+}
+
+interface Config {
+    baseUrl?: string;
+    apiKey?: string;
+    [key: string]: unknown;
+}
+
+function readExistingConfig(configPath: string): Config | null {
+    try {
+        if (existsSync(configPath)) {
+            const content = readFileSync(configPath, 'utf8');
+            return JSON.parse(content);
+        }
+    } catch {
+        // Config doesn't exist or is invalid
+    }
+    return null;
+}
+
+function writeConfig(tool: ToolName, scope: 'system' | 'project', apiKey: string): void {
+    const { dir, file } = getConfigPaths(tool, scope);
+
+    // Create directory if it doesn't exist
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+
+    let config: Config;
+
+    if (tool === 'Claude Code') {
+        // Claude Code configuration format
+        config = {
+            apiKey: apiKey,
+            baseUrl: PRIMELLM_BASE_URL,
+            model: 'claude-sonnet-4-20250514', // Default model
+        };
+    } else {
+        // Codex (OpenAI-compatible) configuration format
+        config = {
+            apiKey: apiKey,
+            baseUrl: PRIMELLM_BASE_URL,
+            model: 'gpt-4.1', // Default model
+        };
+    }
+
+    // Preserve existing config values
+    const existing = readExistingConfig(file);
+    if (existing) {
+        config = { ...existing, ...config };
+    }
+
+    writeFileSync(file, JSON.stringify(config, null, 2));
+}
+
+// ============================================================================
+// TOOL INSTALLATION
+// ============================================================================
+
+async function installTool(tool: ToolName): Promise<boolean> {
+    const toolInfo = TOOLS[tool];
+    const spinner = ora(`Installing ${tool}...`).start();
+
+    try {
+        const isWindows = platform() === 'win32';
+        const npmCmd = isWindows ? 'npm.cmd' : 'npm';
+
+        const result = spawnSync(npmCmd, ['install', '-g', toolInfo.package], {
+            stdio: 'pipe',
+            shell: true,
+        });
+
+        if (result.status !== 0) {
+            spinner.fail(chalk.red(`Failed to install ${tool}`));
+            console.error(chalk.gray(result.stderr?.toString() || 'Unknown error'));
+            return false;
+        }
+
+        spinner.succeed(chalk.green(`${tool} installed successfully`));
+        return true;
+    } catch (error) {
+        spinner.fail(chalk.red(`Failed to install ${tool}`));
+        console.error(chalk.gray(String(error)));
+        return false;
+    }
+}
+
+// ============================================================================
+// VALIDATION
+// ============================================================================
+
+function validateApiKey(key: string): boolean {
+    return key.startsWith('primellm_') && key.length > 15;
+}
+
+function maskApiKey(key: string): string {
+    if (key.length <= 12) return '***';
+    return key.substring(0, 12) + '...' + key.substring(key.length - 4);
+}
+
+// ============================================================================
+// MAIN FLOW
+// ============================================================================
+
+async function main(): Promise<void> {
+    displayBanner();
+    displaySystemInfo();
+
+    const spinner = ora('Initializing...').start();
+    await new Promise(resolve => setTimeout(resolve, 500));
+    spinner.succeed('Ready');
+    console.log();
+
+    // ============ STEP 1: Tool Selection ============
+    console.log(chalk.white.bold('🔧 Tool Selection\n'));
+
+    const { selectedTool } = await prompt<{ selectedTool: ToolName }>({
+        type: 'select',
+        name: 'selectedTool',
+        message: 'Which tool would you like to configure?',
+        choices: ['Claude Code', 'Codex'],
+    });
+
+    console.log();
+
+    // ============ STEP 2: Tool Detection & Installation ============
+    const toolInfo = TOOLS[selectedTool];
+    const toolExists = commandExists(toolInfo.command);
+
+    if (toolExists) {
+        console.log(chalk.green(`✓ ${selectedTool} is already installed`));
+    } else {
+        console.log(chalk.yellow(`⚠ ${selectedTool} is not installed`));
+
+        const { confirmInstall } = await prompt<{ confirmInstall: boolean }>({
+            type: 'confirm',
+            name: 'confirmInstall',
+            message: `Would you like to install ${selectedTool}?`,
+            initial: true,
+        });
+
+        if (!confirmInstall) {
+            console.log(chalk.yellow('\n⚠ Installation cancelled. Please install manually and run again.'));
+            process.exit(0);
+        }
+
+        const installed = await installTool(selectedTool);
+        if (!installed) {
+            console.log(chalk.red('\n❌ Installation failed. Please install manually and run again.'));
+            process.exit(1);
+        }
+    }
+
+    console.log();
+
+    // ============ STEP 3: API Key ============
+    console.log(chalk.white.bold('🔑 API Key Configuration\n'));
+
+    const { hasApiKey } = await prompt<{ hasApiKey: string }>({
+        type: 'select',
+        name: 'hasApiKey',
+        message: 'Do you already have a PrimeLLM API key?',
+        choices: [
+            { name: 'yes', message: 'Yes, I have an API key' },
+            { name: 'no', message: 'No, I need to create one' },
+        ],
+    });
+
+    let apiKey: string;
+
+    if (hasApiKey === 'no') {
+        console.log(chalk.cyan('\n📝 Opening PrimeLLM dashboard to create an API key...\n'));
+
+        await open(PRIMELLM_DASHBOARD_URL);
+
+        await prompt({
+            type: 'confirm',
+            name: 'ready',
+            message: 'Press Enter when you have created your API key...',
+        });
+    }
+
+    // Prompt for API key
+    const { inputApiKey } = await prompt<{ inputApiKey: string }>({
+        type: 'password',
+        name: 'inputApiKey',
+        message: 'Enter your PrimeLLM API key:',
+        validate: (value: string) => {
+            if (!value) return 'API key is required';
+            if (!validateApiKey(value)) return 'API key must start with "primellm_"';
+            return true;
+        },
+    });
+
+    apiKey = inputApiKey;
+    console.log(chalk.green(`✓ API key validated: ${maskApiKey(apiKey)}`));
+    console.log();
+
+    // ============ STEP 4: Configuration Scope ============
+    console.log(chalk.white.bold('📁 Configuration Scope\n'));
+
+    const { configScope } = await prompt<{ configScope: 'system' | 'project' }>({
+        type: 'select',
+        name: 'configScope',
+        message: 'Choose configuration scope:',
+        choices: [
+            { name: 'system', message: 'System-level (applies to all projects)' },
+            { name: 'project', message: 'Project-level (current project only)' },
+        ],
+    });
+
+    console.log();
+
+    // ============ STEP 5: Check Existing Config ============
+    const { file: configFile } = getConfigPaths(selectedTool, configScope);
+    const existingConfig = readExistingConfig(configFile);
+
+    if (existingConfig) {
+        console.log(chalk.yellow('⚠ Existing configuration found:\n'));
+        console.log(chalk.gray(`  Base URL: ${existingConfig.baseUrl || '(not set)'}`));
+        console.log(chalk.gray(`  API Key:  ${existingConfig.apiKey ? maskApiKey(existingConfig.apiKey) : '(not set)'}`));
+        console.log();
+
+        const { confirmOverwrite } = await prompt<{ confirmOverwrite: boolean }>({
+            type: 'confirm',
+            name: 'confirmOverwrite',
+            message: 'Do you want to overwrite this configuration?',
+            initial: true,
+        });
+
+        if (!confirmOverwrite) {
+            console.log(chalk.yellow('\n⚠ Configuration cancelled.'));
+            process.exit(0);
+        }
+        console.log();
+    }
+
+    // ============ STEP 6: Write Configuration ============
+    const writeSpinner = ora('Writing configuration...').start();
+
+    try {
+        writeConfig(selectedTool, configScope, apiKey);
+        writeSpinner.succeed(chalk.green('Configuration saved'));
+    } catch (error) {
+        writeSpinner.fail(chalk.red('Failed to write configuration'));
+        console.error(chalk.gray(String(error)));
+        process.exit(1);
+    }
+
+    // ============ SUCCESS ============
+    console.log();
+    console.log(chalk.gray('━'.repeat(60)));
+    console.log();
+    console.log(chalk.green.bold('✅ PrimeLLM configured successfully!'));
+    console.log();
+    console.log(chalk.white('You can now use:'));
+    console.log(chalk.cyan(`  ${toolInfo.command}`));
+    console.log(chalk.white('with PrimeLLM as the backend.'));
+    console.log();
+    console.log(chalk.gray(`Config location: ${configFile}`));
+    console.log(chalk.gray(`Base URL: ${PRIMELLM_BASE_URL}`));
+    console.log();
+    console.log(chalk.gray('━'.repeat(60)));
+    console.log();
+    console.log(chalk.white('Need help? Visit ') + chalk.cyan('https://primellm.in/docs'));
+    console.log();
+}
+
+// Run the CLI
+main().catch((error) => {
+    console.error(chalk.red('An unexpected error occurred:'));
+    console.error(chalk.gray(String(error)));
+    process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "lib": [
+            "ES2022"
+        ],
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/cli/index.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-
-import PrimeLLM from "../dist/index.js";
-
-const args = process.argv.slice(2);
-if (args.length === 0) {
-    console.log("Usage: npx primellm \"your question here\"");
-    process.exit(1);
-}
-
-const prompt = args.join(" ");
-
-const apiKey = process.env.PRIMELLM_API_KEY;
-if (!apiKey) {
-    console.error("Error: Set PRIMELLM_API_KEY environment variable before using npx primellm");
-    process.exit(1);
-}
-
-const client = new PrimeLLM({ apiKey });
-
-const run = async () => {
-    try {
-        const res = await client.chat({
-            model: "gpt-5.1",
-            messages: [{ role: "user", content: prompt }]
-        });
-
-        console.log("\n" + res.choices[0].message.content + "\n");
-    } catch (err) {
-        console.error("Error:", err.message);
-    }
-};
-
-run();

package/dist/errors.d.ts

@@ -1,59 +0,0 @@
-/**
- * PrimeLLM SDK Error Classes
- *
- * Typed errors for better error handling in applications.
- */
-export interface ErrorMeta {
-    status?: number;
-    detail?: string;
-    [key: string]: unknown;
-}
-/**
- * Base error class for all PrimeLLM SDK errors
- */
-export declare class PrimeLLMError extends Error {
-    meta?: ErrorMeta;
-    constructor(message: string, meta?: ErrorMeta);
-}
-/**
- * Authentication failed (401)
- */
-export declare class AuthenticationError extends PrimeLLMError {
-    constructor(message?: string, meta?: ErrorMeta);
-}
-/**
- * Insufficient credits (402)
- */
-export declare class InsufficientCreditsError extends PrimeLLMError {
-    constructor(message?: string, meta?: ErrorMeta);
-}
-/**
- * Rate limit exceeded (429)
- */
-export declare class RateLimitError extends PrimeLLMError {
-    retryAfter?: number;
-    constructor(message?: string, meta?: ErrorMeta, retryAfter?: number);
-}
-/**
- * Resource not found (404)
- */
-export declare class NotFoundError extends PrimeLLMError {
-    constructor(message?: string, meta?: ErrorMeta);
-}
-/**
- * Validation error (400)
- */
-export declare class ValidationError extends PrimeLLMError {
-    constructor(message?: string, meta?: ErrorMeta);
-}
-/**
- * Server error (5xx)
- */
-export declare class ServerError extends PrimeLLMError {
-    constructor(message?: string, meta?: ErrorMeta);
-}
-/**
- * Map HTTP status code to appropriate error class
- */
-export declare function createErrorFromStatus(status: number, message: string, detail?: string): PrimeLLMError;
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS;CAKhD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACtC,OAAO,SAA+B,EAAE,IAAI,CAAC,EAAE,SAAS;CAIvE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC3C,OAAO,SAAyB,EAAE,IAAI,CAAC,EAAE,SAAS;CAIjE;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEf,OAAO,SAAwB,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM;CAKrF;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAChC,OAAO,SAAuB,EAAE,IAAI,CAAC,EAAE,SAAS;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAClC,OAAO,SAAoB,EAAE,IAAI,CAAC,EAAE,SAAS;CAI5D;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,aAAa;gBAC9B,OAAO,SAAiB,EAAE,IAAI,CAAC,EAAE,SAAS;CAIzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAoBrG"}