@splashcodex/api-key-manager 5.0.0 → 5.0.2

package/README.md

@@ -11,6 +11,7 @@
 - **Built-in Persistence** — `FileStorage` (survives restarts) and `MemoryStorage` included.
 - **Singleton Pattern** — Thread-safe singletons with `getInstance()` and `Result<T>` pattern.
 - **Multi-Provider Vault** — Manage multiple providers (`gemini`, `openai`, `anthropic`) from a single entry point.
+- **Centralized API Gateway** — Built-in Fastify proxy server to centralize AI requests for multiple apps securely.
 
 ## Features
 
@@ -30,6 +31,13 @@
 npm install @splashcodex/api-key-manager
 ```
 
+### 🚀 Auto-Scaffold (New!)
+The fastest way to get started is to run the `init` command in your project directory:
+```bash
+npx @splashcodex/api-key-manager init
+```
+This will automatically create a `.env` template and a `demo.ts` file showing the Gemini Preset in action.
+
 ## Quick Start (v5 Presets)
 
 The fastest way to get started in any CodeDex repository.
@@ -50,8 +58,34 @@ const response = await gemini.execute(async (key) => {
 });
 ```
 
+### Centralized API Gateway (New!)
+
+Run a standalone proxy server that acts as a single point of entry for all your microservices or repositories. It centralizes key management, circuit breaking, and rate limiting across applications.
+
+1. Install global/local and export your keys:
+```bash
+export GOOGLE_GEMINI_API_KEY="AIzaSy...1,AIzaSy...2"
+```
+
+2. Start the gateway:
+```bash
+npm run gateway
+# Server runs on http://localhost:9000
+```
+
+3. Call the proxy from ANY language without managing keys in the client app:
+```bash
+curl -X POST http://localhost:9000/v1/generate \
+  -H "Content-Type: application/json" \
+  -d '{"provider": "gemini", "prompt": "Hello!"}'
+```
+Route supports both `/v1/generate` (Standard JSON) and `/v1/stream` (Server-Sent Events). Monitoring available at `/v1/health` and `/v1/providers`.
+
+---
+
 ### Multi-Provider Vault
-Perfect for gateways or complex bots handling multiple models.
+
+Manage ALL your provider keys across your system from one pool.Perfect for gateways or complex bots handling multiple models.
 
 ```typescript
 import { MultiManager } from '@splashcodex/api-key-manager/presets/multi';

package/bin/cli.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function printDocs() {
+    console.log(`\x1b[92m🌟 @splashcodex/api-key-manager v5.0\x1b[0m`);
+    console.log(`\x1b[96m📚 Documentation: https://www.npmjs.com/package/@splashcodex/ApiKeyManager\x1b[0m\n`);
+    console.log(`\x1b[93m🚀 Commands:\x1b[0m`);
+    console.log(`   npx @splashcodex/api-key-manager init   \x1b[90m# Scaffold a demo project in the current directory\x1b[0m`);
+    console.log(`\n\x1b[95m💡 Tip: Need help? Run init to see it in action!\x1b[0m\n`);
+}
+
+function initProject() {
+    const cwd = process.cwd();
+    const envPath = path.join(cwd, '.env');
+    const demoPath = path.join(cwd, 'demo.ts');
+
+    console.log(`\n\x1b[96m🚀 Initializing @splashcodex/api-key-manager environment...\x1b[0m\n`);
+
+    // Create .env
+    if (!fs.existsSync(envPath)) {
+        fs.writeFileSync(envPath, `GOOGLE_GEMINI_API_KEY="your_api_key_1,your_api_key_2"\nOPENAI_API_KEY="sk-..."\n`);
+        console.log(`\x1b[92m[✔] Created .env file\x1b[0m`);
+    } else {
+        console.log(`\x1b[90m[-] .env already exists. Remember to add GOOGLE_GEMINI_API_KEY!\x1b[0m`);
+    }
+
+    // Create demo.ts
+    if (!fs.existsSync(demoPath)) {
+        const tsCode = `import 'dotenv/config';\nimport { GeminiManager } from '@splashcodex/api-key-manager/presets/gemini';\n\nasync function main() {\n    console.log("Initialize GeminiManager...");\n    // Automatically parse GOOGLE_GEMINI_API_KEY from env\n    const result = GeminiManager.getInstance();\n    if (!result.success) {\n        console.error("Failed to initialize:", result.error);\n        return;\n    }\n    \n    const gemini = result.data;\n    \n    console.log("Executing resilient request...");\n    // Automatically handles key rotation and 429 quota limits\n    try {\n        const response = await gemini.execute(async (key) => {\n            console.log(\`[Network] Sending request with key: \${key.substring(0, 8)}...\`);\n            // Replace with actual fetch: await fetch(..., { headers: { 'x-goog-api-key': key } })\n            return "Success: Simulated API Response!";\n        });\n        console.log("Result:", response);\n    } catch (e) {\n        console.error("All keys exhausted or network failed.", e.message);\n    }\n}\n\nmain();\n`;
+        fs.writeFileSync(demoPath, tsCode);
+        console.log(`\x1b[92m[✔] Created demo.ts\x1b[0m`);
+    } else {
+        console.log(`\x1b[90m[-] demo.ts already exists.\x1b[0m`);
+    }
+
+    console.log(`\n\x1b[93m🎉 Setup Complete!\x1b[0m`);
+    console.log(`To run the demo:`);
+    console.log(`\x1b[36m   npm install dotenv\x1b[0m`);
+    console.log(`\x1b[36m   npx ts-node demo.ts\x1b[0m\n`);
+}
+
+if (command === 'init') {
+    initProject();
+} else {
+    printDocs();
+}

package/package.json

@@ -1,7 +1,10 @@
 {
     "name": "@splashcodex/api-key-manager",
-    "version": "5.0.0",
+    "version": "5.0.2",
     "description": "Universal API Key Management Gateway with provider presets, persistence, and multi-provider vault",
+    "bin": {
+        "api-key-manager": "./bin/cli.js"
+    },
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "exports": {
@@ -72,12 +75,16 @@
     },
     "files": [
         "dist",
-        "src"
+        "src",
+        "bin"
     ],
     "scripts": {
         "build": "tsc",
         "test": "jest --verbose",
-        "prepublishOnly": "npm run build"
+        "prepublishOnly": "npm run build",
+        "postinstall": "node -e \"console.log('\\n\\x1b[32m🌟 Successfully installed @splashcodex/api-key-manager v5.0!\\x1b[0m\\n\\x1b[36m📚 Documentation: https://www.npmjs.com/package/@splashcodex/ApiKeyManager\\x1b[0m\\n\\x1b[33m🚀 Quick Start:\\x1b[0m\\n   import { GeminiManager } from \\'@splashcodex/api-key-manager/presets/gemini\\';\\n   const gemini = GeminiManager.getInstance().data;\\n')\"",
+        "gateway": "ts-node gateway/server.ts",
+        "gateway:dev": "npx nodemon --watch gateway/ --ext ts --exec ts-node gateway/server.ts"
     },
     "keywords": [
         "api",
@@ -108,5 +115,9 @@
         "ts-jest": "^29.4.6",
         "ts-node": "^10.9.2",
         "typescript": "^5.3.3"
+    },
+    "dependencies": {
+        "@fastify/cors": "^11.2.0",
+        "fastify": "^5.7.4"
     }
 }