@rouvanpm/rouva 0.1.0 → 0.1.2

package/README.md

@@ -5,13 +5,13 @@ Official Node.js SDK for [Rouva](https://rouva.io) — managed AI gateway with i
 ## Installation
 
 ```bash
-npm install rouva
+npm install @rouvanpm/rouva
 ```
 
 ## Quick Start
 
 ```typescript
-import { Rouva } from 'rouva'
+import { Rouva } from '@rouvanpm/rouva'
 
 const rouva = new Rouva({ apiKey: 'rva_...' })
 
@@ -22,6 +22,29 @@ const response = await rouva.chat.completions.create({
 console.log(response.choices[0].message.content)
 ```
 
+## Provider agnostic
+
+Rouva works with all connected providers — Anthropic and OpenAI today, more coming. You can request a specific model or omit it entirely and let Rouva route to the cheapest capable model automatically.
+
+```typescript
+// Request a specific model
+const res = await rouva.chat.completions.create({
+  model: 'gpt-4o',
+  messages,
+})
+
+// Request a specific Anthropic model
+const res = await rouva.chat.completions.create({
+  model: 'claude-sonnet-4-6',
+  messages,
+})
+
+// Let Rouva decide — routes to cheapest model for the task
+const res = await rouva.chat.completions.create({
+  messages,
+})
+```
+
 ## Drop-in replacement for OpenAI
 
 ```typescript
@@ -31,7 +54,7 @@ const openai = new OpenAI({ apiKey: '...' })
 const res = await openai.chat.completions.create({ messages, model: 'gpt-4o' })
 
 // After — Rouva routes to the cheapest capable model automatically
-import { Rouva } from 'rouva'
+import { Rouva } from '@rouvanpm/rouva'
 const rouva = new Rouva({ apiKey: 'rva_...' })
 const res = await rouva.chat.completions.create({ messages })
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rouvanpm/rouva",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Official Node.js SDK for Rouva — managed AI gateway with intelligent routing and spend tracking",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -38,4 +38,4 @@
     "typescript": "^5.0.0",
     "vitest": "^1.0.0"
   }
-}
+}

package/dist/index.d.mts

@@ -1,67 +0,0 @@
-interface RouvaOptions {
-    /** Your Rouva gateway API key (rva_...) */
-    apiKey: string;
-    /** Override the default gateway URL — useful for self-hosted or testing */
-    baseURL?: string;
-}
-interface Message {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-interface ChatCompletionParams {
-    messages: Message[];
-    /** Target model — omit to let Rouva route intelligently */
-    model?: string;
-    /** Maximum tokens to generate */
-    max_tokens?: number;
-    /** Sampling temperature 0–1 */
-    temperature?: number;
-    /** Stream the response */
-    stream?: boolean;
-}
-interface ChatCompletionChoice {
-    index: number;
-    message: Message;
-    finish_reason: string | null;
-}
-interface ChatCompletionUsage {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-}
-interface ChatCompletion {
-    id: string;
-    object: 'chat.completion';
-    created: number;
-    model: string;
-    choices: ChatCompletionChoice[];
-    usage: ChatCompletionUsage;
-    /** Rouva metadata — cost, savings, routing decision */
-    _rouva?: RouvaResponseMeta;
-}
-interface RouvaResponseMeta {
-    /** Actual model used (may differ from requested when intelligently routed) */
-    model_used: string;
-    /** USD cost for this request */
-    cost: number;
-    /** USD saved vs your baseline model */
-    savings: number;
-    /** Whether intelligent routing selected the model */
-    intelligently_routed: boolean;
-    /** Task type classified by Rouva */
-    task_type: string;
-}
-
-declare class Rouva {
-    private apiKey;
-    private baseURL;
-    readonly chat: {
-        completions: {
-            create(params: ChatCompletionParams): Promise<ChatCompletion | ReadableStream>;
-        };
-    };
-    constructor(options: RouvaOptions);
-    private _createChatCompletion;
-}
-
-export { type ChatCompletion, type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionUsage, type Message, Rouva, type RouvaOptions, type RouvaResponseMeta };

package/dist/index.d.ts

@@ -1,67 +0,0 @@
-interface RouvaOptions {
-    /** Your Rouva gateway API key (rva_...) */
-    apiKey: string;
-    /** Override the default gateway URL — useful for self-hosted or testing */
-    baseURL?: string;
-}
-interface Message {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-interface ChatCompletionParams {
-    messages: Message[];
-    /** Target model — omit to let Rouva route intelligently */
-    model?: string;
-    /** Maximum tokens to generate */
-    max_tokens?: number;
-    /** Sampling temperature 0–1 */
-    temperature?: number;
-    /** Stream the response */
-    stream?: boolean;
-}
-interface ChatCompletionChoice {
-    index: number;
-    message: Message;
-    finish_reason: string | null;
-}
-interface ChatCompletionUsage {
-    prompt_tokens: number;
-    completion_tokens: number;
-    total_tokens: number;
-}
-interface ChatCompletion {
-    id: string;
-    object: 'chat.completion';
-    created: number;
-    model: string;
-    choices: ChatCompletionChoice[];
-    usage: ChatCompletionUsage;
-    /** Rouva metadata — cost, savings, routing decision */
-    _rouva?: RouvaResponseMeta;
-}
-interface RouvaResponseMeta {
-    /** Actual model used (may differ from requested when intelligently routed) */
-    model_used: string;
-    /** USD cost for this request */
-    cost: number;
-    /** USD saved vs your baseline model */
-    savings: number;
-    /** Whether intelligent routing selected the model */
-    intelligently_routed: boolean;
-    /** Task type classified by Rouva */
-    task_type: string;
-}
-
-declare class Rouva {
-    private apiKey;
-    private baseURL;
-    readonly chat: {
-        completions: {
-            create(params: ChatCompletionParams): Promise<ChatCompletion | ReadableStream>;
-        };
-    };
-    constructor(options: RouvaOptions);
-    private _createChatCompletion;
-}
-
-export { type ChatCompletion, type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionUsage, type Message, Rouva, type RouvaOptions, type RouvaResponseMeta };

package/dist/index.js

@@ -1,67 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  Rouva: () => Rouva
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/client.ts
-var DEFAULT_BASE_URL = "https://app.rouva.io";
-var Rouva = class {
-  constructor(options) {
-    if (!options.apiKey) throw new Error("[Rouva] apiKey is required");
-    if (!options.apiKey.startsWith("rva_")) {
-      throw new Error("[Rouva] apiKey must start with rva_");
-    }
-    this.apiKey = options.apiKey;
-    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-    this.chat = {
-      completions: {
-        create: (params) => this._createChatCompletion(params)
-      }
-    };
-  }
-  async _createChatCompletion(params) {
-    const url = `${this.baseURL}/api/gateway/messages`;
-    const res = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": this.apiKey
-      },
-      body: JSON.stringify(params)
-    });
-    if (!res.ok) {
-      const body = await res.text().catch(() => res.statusText);
-      throw new Error(`[Rouva] Gateway error ${res.status}: ${body}`);
-    }
-    if (params.stream) {
-      if (!res.body) throw new Error("[Rouva] No response body for streaming request");
-      return res.body;
-    }
-    return res.json();
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Rouva
-});

package/dist/index.mjs

@@ -1,40 +0,0 @@
-// src/client.ts
-var DEFAULT_BASE_URL = "https://app.rouva.io";
-var Rouva = class {
-  constructor(options) {
-    if (!options.apiKey) throw new Error("[Rouva] apiKey is required");
-    if (!options.apiKey.startsWith("rva_")) {
-      throw new Error("[Rouva] apiKey must start with rva_");
-    }
-    this.apiKey = options.apiKey;
-    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-    this.chat = {
-      completions: {
-        create: (params) => this._createChatCompletion(params)
-      }
-    };
-  }
-  async _createChatCompletion(params) {
-    const url = `${this.baseURL}/api/gateway/messages`;
-    const res = await fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": this.apiKey
-      },
-      body: JSON.stringify(params)
-    });
-    if (!res.ok) {
-      const body = await res.text().catch(() => res.statusText);
-      throw new Error(`[Rouva] Gateway error ${res.status}: ${body}`);
-    }
-    if (params.stream) {
-      if (!res.body) throw new Error("[Rouva] No response body for streaming request");
-      return res.body;
-    }
-    return res.json();
-  }
-};
-export {
-  Rouva
-};