@company786/meridian-blue-sdk 0.1.0

package/README.md

@@ -0,0 +1,378 @@
+# @meridian-blue-SDK
+
+[![npm version](https://img.shields.io/npm/v/@company786/meridian-blue-sdk)](https://www.npmjs.com/package/@company786/meridian-blue-sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
+
+Official TypeScript/JavaScript SDK for the **MeridianBlue API** — a unified AI proxy that routes your requests across multiple providers (OpenAI, Groq, Mistral, and more) through a single API key, with automatic fallback, billing, and rate limiting built in.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Configuration](#configuration)
+- [Chat Completions](#chat-completions)
+  - [Basic Usage](#basic-usage)
+  - [With System Prompt](#with-system-prompt)
+  - [With Parameters](#with-parameters)
+  - [Multi-turn Conversation](#multi-turn-conversation)
+  - [Response Shape](#response-shape)
+- [Error Handling](#error-handling)
+  - [Error Classes](#error-classes)
+  - [Full Error Handling Example](#full-error-handling-example)
+- [TypeScript Support](#typescript-support)
+- [How It Works](#how-it-works)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Features
+
+- ✅ **Single API key** — access OpenAI, Groq, Mistral, and more through one key
+- ✅ **Automatic fallback** — if your primary provider fails, the next one picks up silently
+- ✅ **Built-in billing** — every response includes cost and balance information
+- ✅ **TypeScript-first** — full type definitions included.
+- ✅ **Typed errors** — every HTTP error maps to a specific error class
+- ✅ **Lightweight** — single dependency (axios)
+
+---
+
+## Requirements
+
+- Node.js **18.0.0** or higher
+- An MeridianBlue API key (`kp_live_...`)
+
+---
+
+## Installation
+
+```bash
+# npm
+npm install @company786/meridian-blue-sdk
+
+# yarn
+yarn add @company786/meridian-blue-sdk
+
+# pnpm
+pnpm add @company786/meridian-blue-sdk
+```
+
+---
+
+## Quick Start
+
+```typescript
+import { MeridianBlue } from '@company786/meridian-blue-sdk';
+
+const meridianBlue = new MeridianBlue({
+  apiKey: 'kp_live_your_key_here',
+});
+
+const response = await meridianBlue.chat.completions({
+  slug: 'omni/gpt-4o',
+  messages: [
+    { role: 'user', content: 'What is the capital of Pakistan?' }
+  ],
+});
+
+console.log(response.choices[0].message.content);
+// → "The capital of Pakistan is Islamabad."
+```
+
+---
+
+## Configuration
+
+Create an `MeridianBlue` instance with your configuration:
+
+```typescript
+import { MeridianBlue } from '@company786/meridian-blue-sdk';
+
+const meridianBlue = new MeridianBlue({
+  apiKey: 'kp_live_...',          // Required — your MeridianBlue API key
+  baseUrl: 'https://...',         // Optional — defaults to https://api.omniprompt.dev
+  timeout: 30000,                 // Optional — request timeout in ms (default: 30000)
+});
+```
+
+### Configuration Options
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `apiKey` | `string` | ✅ Yes | — | Your `kp_live_` API key |
+| `baseUrl` | `string` | No | `https://api.omniprompt.dev` | MeridianBlue server URL |
+| `timeout` | `number` | No | `30000` | Request timeout in milliseconds |
+
+---
+
+## Chat Completions
+
+### Basic Usage
+
+```typescript
+const response = await meridianBlue.chat.completions({
+  slug: 'omni/gpt-4o',
+  messages: [
+    { role: 'user', content: 'Hello!' }
+  ],
+});
+
+console.log(response.choices[0].message.content);
+```
+
+### With System Prompt
+
+```typescript
+const response = await meridianBlue.chat.completions({
+  slug: 'omni/gpt-4o',
+  messages: [
+    { role: 'system', content: 'You are a helpful coding assistant.' },
+    { role: 'user', content: 'Write a function to reverse a string in Python.' },
+  ],
+});
+```
+
+### With Parameters
+
+```typescript
+const response = await meridianBlue.chat.completions({
+  slug: 'omni/gpt-4o',
+  messages: [
+    { role: 'user', content: 'Write a short poem about the ocean.' }
+  ],
+  temperature: 0.9,     // 0.0 – 2.0 — higher = more creative
+  max_tokens: 200,      // limit response length
+});
+```
+
+### Multi-turn Conversation
+
+```typescript
+const messages = [
+  { role: 'system', content: 'You are a helpful assistant.' },
+  { role: 'user', content: 'My name is Ali.' },
+];
+
+const first = await meridianBlue.chat.completions({ slug: 'omni/gpt-4o', messages });
+
+// Append assistant reply and continue the conversation
+messages.push(first.choices[0].message);
+messages.push({ role: 'user', content: 'What is my name?' });
+
+const second = await meridianBlue.chat.completions({ slug: 'omni/gpt-4o', messages });
+console.log(second.choices[0].message.content);
+// → "Your name is Ali."
+```
+
+### Response Shape
+
+Every `chat.completions()` call returns a `ChatCompletionResponse`:
+
+```typescript
+{
+  id: "64f3a...",               // Conversation ID for debugging
+  model: "omni/gpt-4o",         // The slug that was routed
+
+  choices: [
+    {
+      index: 0,
+      message: {
+        role: "assistant",
+        content: "The capital of Pakistan is Islamabad."
+      },
+      finish_reason: "stop"
+    }
+  ],
+
+  usage: {
+    prompt_tokens: 49,
+    completion_tokens: 8,
+    total_tokens: 57
+  },
+
+  billing: {
+    cost: 0.0024,               // Credits deducted for this request
+    balanceAfter: 997.9976,     // Your credit balance after this request
+    isFallback: false,          // true if a fallback provider was used
+    latencyMs: 1243             // Total request latency in milliseconds
+  }
+}
+```
+
+#### `billing.isFallback`
+
+When `isFallback: true` it means your primary provider (e.g. OpenAI) failed and MeridianBlue automatically retried with the next available provider (e.g. Groq). Your request succeeded — this is informational only.
+
+---
+
+## Error Handling
+
+The SDK maps every HTTP error to a specific typed class so you can handle them precisely.
+
+### Error Classes
+
+| Class | HTTP Status | When it's thrown |
+|-------|-------------|-----------------|
+| `AuthenticationError` | 401 | API key is missing, malformed, or invalid |
+| `InsufficientBalanceError` | 402 | Credit balance is at or below the debt limit (-$10.00) |
+| `PermissionError` | 403 | API key has been revoked |
+| `NotFoundError` | 404 | The requested slug doesn't exist |
+| `RateLimitError` | 429 | Too many requests — check `retryAfterSeconds` |
+| `APIError` | 500 | Server error or all providers exhausted |
+| `MeridianBlueError` | any | Base class — all errors extend this |
+
+### Error Properties
+
+```typescript
+// All errors have:
+error.message          // Human-readable description
+error.status           // HTTP status code
+error.code             // Machine-readable code string
+
+// InsufficientBalanceError also has:
+error.currentBalance   // number — your current credit balance
+error.debtLimit        // number — the limit (e.g. -1000)
+
+// RateLimitError also has:
+error.retryAfterSeconds  // number — seconds until you can retry
+```
+
+### Full Error Handling Example
+
+```typescript
+import {
+  MeridianBlue,
+  AuthenticationError,
+  InsufficientBalanceError,
+  PermissionError,
+  NotFoundError,
+  RateLimitError,
+  APIError,
+} from '@company786/meridian-blue-sdk';
+
+const meridianBlue = new MeridianBlue({ apiKey: 'kp_live_...' });
+
+try {
+  const response = await meridianBlue.chat.completions({
+    slug: 'omni/gpt-4o',
+    messages: [{ role: 'user', content: 'Hello' }],
+  });
+
+  console.log(response.choices[0].message.content);
+
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    // Invalid or missing API key
+    console.error('Check your API key:', error.message);
+
+  } else if (error instanceof InsufficientBalanceError) {
+    // Out of credits
+    console.error(`Out of credits.`);
+    console.error(`Current balance: ${error.currentBalance}`);
+    console.error(`Debt limit: ${error.debtLimit}`);
+    // → Redirect user to top-up page
+
+  } else if (error instanceof RateLimitError) {
+    // Too many requests
+    console.error(`Rate limited. Retry in ${error.retryAfterSeconds} seconds.`);
+    // → Implement exponential backoff
+
+  } else if (error instanceof NotFoundError) {
+    // Wrong slug
+    console.error('Model slug not found:', error.message);
+
+  } else if (error instanceof PermissionError) {
+    // Key revoked
+    console.error('API key has been revoked.');
+
+  } else if (error instanceof APIError) {
+    // Server-side failure
+    console.error('Server error:', error.message);
+
+  } else {
+    // Unknown error — rethrow
+    throw error;
+  }
+}
+```
+
+---
+
+## TypeScript Support
+
+The SDK is written in TypeScript and ships with full type definitions. No `@types/` package needed.
+
+```typescript
+import type {
+  MeridianBlueConfig,
+  ChatMessage,
+  ChatRole,
+  ChatCompletionRequest,
+  ChatCompletionResponse,
+  ChatChoice,
+  ChatUsage,
+  ChatBilling,
+} from '@company786/meridian-blue-sdk';
+
+// All types are available for use in your own code
+const messages: ChatMessage[] = [
+  { role: 'user' as ChatRole, content: 'Hello' }
+];
+
+const request: ChatCompletionRequest = {
+  slug: 'omni/gpt-4o',
+  messages,
+  temperature: 0.7,
+};
+```
+
+---
+
+## How It Works
+
+```
+Your Application
+      │
+      │  meridianBlue.chat.completions({ slug: 'omni/gpt-4o', ... })
+      ▼
+@company786/meridian-blue-sdk
+  - Attaches your kp_live_ key as Bearer token
+  - POST /api/v1/chat/completions
+      │
+      ▼
+MeridianBlue Server
+  - Validates your API key
+  - Checks your credit balance
+  - Routes request to the best available provider
+  - On failure → automatically retries with fallback provider
+  - Deducts credits and logs the transaction
+      │
+      ▼
+AI Provider (OpenAI / Groq / Mistral / ...)
+      │
+      ▼
+Response flows back through MeridianBlue → SDK → Your App
+```
+
+Your API key never touches the AI providers directly. All routing, fallbacks, and billing happen on the MeridianBlue server.
+
+---
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feat/your-feature`
+3. Make your changes
+4. Build: `npm run build`
+5. Submit a pull request
+
+---
+
+## License
+
+MIT © MeridianBlue

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+import { Chat } from "./resources/chat.js";
+import type { MeridianBlueConfig } from "./types/requests.js";
+export declare class MeridianBlue {
+    /** Chat completions resource */
+    readonly chat: Chat;
+    private readonly http;
+    constructor(config: MeridianBlueConfig);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAe9D,qBAAa,YAAY;IACvB,gCAAgC;IAChC,SAAgB,IAAI,EAAE,IAAI,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,MAAM,EAAE,kBAAkB;CA0DvC"}

package/dist/client.js

@@ -0,0 +1,52 @@
+import axios, { isAxiosError } from "axios";
+import { Chat } from "./resources/chat.js";
+import { APIError, AuthenticationError, InsufficientBalanceError, NotFoundError, MeridianBlueError, PermissionError, RateLimitError, } from "./errors.js";
+const DEFAULT_BASE_URL = "http://localhost:3000";
+// const DEFAULT_BASE_URL = "https://api.meridian-blue.dev";
+const DEFAULT_TIMEOUT = 30000;
+export class MeridianBlue {
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new AuthenticationError("apiKey is required. Pass it as: new MeridianBlue({ apiKey: 'kp_live_...' })");
+        }
+        this.http = axios.create({
+            baseURL: config.baseUrl ?? DEFAULT_BASE_URL,
+            timeout: config.timeout ?? DEFAULT_TIMEOUT,
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                "Content-Type": "application/json",
+                "User-Agent": "@meridian-blue/sdk",
+            },
+        });
+        // ── Response interceptor: map HTTP errors to typed SDK errors ────────────
+        this.http.interceptors.response.use((res) => res, (error) => {
+            if (isAxiosError(error) && error.response) {
+                const { status, data, headers } = error.response;
+                const message = data?.error ?? error.message;
+                switch (status) {
+                    case 401:
+                        throw new AuthenticationError(message);
+                    case 402:
+                        throw new InsufficientBalanceError(message, data?.currentBalance, data?.debtLimit);
+                    case 403:
+                        throw new PermissionError(message);
+                    case 404:
+                        throw new NotFoundError(message);
+                    case 429: {
+                        const retryAfter = headers["retry-after"]
+                            ? parseInt(headers["retry-after"], 10)
+                            : undefined;
+                        throw new RateLimitError(message, retryAfter);
+                    }
+                    default:
+                        throw new APIError(message);
+                }
+            }
+            // Network error or no response
+            const msg = error instanceof Error ? error.message : "Unknown network error";
+            throw new MeridianBlueError(msg, 0, "NETWORK_ERROR");
+        });
+        this.chat = new Chat(this.http);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsB,YAAY,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,4DAA4D;AAC5D,MAAM,eAAe,GAAG,KAAM,CAAC;AAE/B,MAAM,OAAO,YAAY;IAMvB,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,mBAAmB,CAC3B,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;YAC3C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,eAAe;YAC1C,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;gBACxC,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,oBAAoB;aACnC;SACF,CAAC,CAAC;QAEH,4EAA4E;QAC5E,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACjC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EACZ,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;gBACjD,MAAM,OAAO,GACV,IAA2B,EAAE,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;gBAEvD,QAAQ,MAAM,EAAE,CAAC;oBACf,KAAK,GAAG;wBACN,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;oBACzC,KAAK,GAAG;wBACN,MAAM,IAAI,wBAAwB,CAChC,OAAO,EACN,IAAoC,EAAE,cAAc,EACpD,IAA+B,EAAE,SAAS,CAC5C,CAAC;oBACJ,KAAK,GAAG;wBACN,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;oBACrC,KAAK,GAAG;wBACN,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;oBACnC,KAAK,GAAG,CAAC,CAAC,CAAC;wBACT,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;4BACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAW,EAAE,EAAE,CAAC;4BAChD,CAAC,CAAC,SAAS,CAAC;wBACd,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;oBAChD,CAAC;oBACD;wBACE,MAAM,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YACD,+BAA+B;YAC/B,MAAM,GAAG,GACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;YACnE,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QACvD,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Base error class for all MeridianBlue SDK errors.
+ * Always check `error.status` to handle specific HTTP error codes.
+ */
+export declare class MeridianBlueError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(message: string, status: number, code?: string);
+}
+/** 401 — API key missing or malformed */
+export declare class AuthenticationError extends MeridianBlueError {
+    constructor(message?: string);
+}
+/** 402 — Credit balance below the debt limit */
+export declare class InsufficientBalanceError extends MeridianBlueError {
+    readonly currentBalance?: number;
+    readonly debtLimit?: number;
+    constructor(message: string, currentBalance?: number, debtLimit?: number);
+}
+/** 403 — API key revoked */
+export declare class PermissionError extends MeridianBlueError {
+    constructor(message?: string);
+}
+/** 404 — Resource not found (e.g. unknown slug) */
+export declare class NotFoundError extends MeridianBlueError {
+    constructor(message: string);
+}
+/** 429 — Rate limit exceeded */
+export declare class RateLimitError extends MeridianBlueError {
+    readonly retryAfterSeconds?: number;
+    constructor(message: string, retryAfterSeconds?: number);
+}
+/** 500 — Server or all-providers failure */
+export declare class APIError extends MeridianBlueError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM3D;AAED,yCAAyC;AACzC,qBAAa,mBAAoB,SAAQ,iBAAiB;gBAC5C,OAAO,SAAgC;CAIpD;AAED,gDAAgD;AAChD,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM;CAOrB;AAED,4BAA4B;AAC5B,qBAAa,eAAgB,SAAQ,iBAAiB;gBACxC,OAAO,SAA8B;CAIlD;AAED,mDAAmD;AACnD,qBAAa,aAAc,SAAQ,iBAAiB;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,gCAAgC;AAChC,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,SAAgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM;CAKxD;AAED,4CAA4C;AAC5C,qBAAa,QAAS,SAAQ,iBAAiB;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,58 @@
+/**
+ * Base error class for all MeridianBlue SDK errors.
+ * Always check `error.status` to handle specific HTTP error codes.
+ */
+export class MeridianBlueError extends Error {
+    constructor(message, status, code) {
+        super(message);
+        this.name = "MeridianBlueError";
+        this.status = status;
+        this.code = code;
+    }
+}
+/** 401 — API key missing or malformed */
+export class AuthenticationError extends MeridianBlueError {
+    constructor(message = "Invalid or missing API key.") {
+        super(message, 401, "AUTHENTICATION_ERROR");
+        this.name = "AuthenticationError";
+    }
+}
+/** 402 — Credit balance below the debt limit */
+export class InsufficientBalanceError extends MeridianBlueError {
+    constructor(message, currentBalance, debtLimit) {
+        super(message, 402, "INSUFFICIENT_BALANCE");
+        this.name = "InsufficientBalanceError";
+        this.currentBalance = currentBalance;
+        this.debtLimit = debtLimit;
+    }
+}
+/** 403 — API key revoked */
+export class PermissionError extends MeridianBlueError {
+    constructor(message = "API key has been revoked.") {
+        super(message, 403, "PERMISSION_ERROR");
+        this.name = "PermissionError";
+    }
+}
+/** 404 — Resource not found (e.g. unknown slug) */
+export class NotFoundError extends MeridianBlueError {
+    constructor(message) {
+        super(message, 404, "NOT_FOUND");
+        this.name = "NotFoundError";
+    }
+}
+/** 429 — Rate limit exceeded */
+export class RateLimitError extends MeridianBlueError {
+    constructor(message, retryAfterSeconds) {
+        super(message, 429, "RATE_LIMIT_EXCEEDED");
+        this.name = "RateLimitError";
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/** 500 — Server or all-providers failure */
+export class APIError extends MeridianBlueError {
+    constructor(message) {
+        super(message, 500, "API_ERROR");
+        this.name = "APIError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI1C,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAO,GAAG,6BAA6B;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,gDAAgD;AAChD,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAI7D,YACE,OAAe,EACf,cAAuB,EACvB,SAAkB;QAElB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,YAAY,OAAO,GAAG,2BAA2B;QAC/C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,gCAAgC;AAChC,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IAGnD,YAAY,OAAe,EAAE,iBAA0B;QACrD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,OAAO,QAAS,SAAQ,iBAAiB;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { MeridianBlue } from "./client.js";
+export { MeridianBlueError, AuthenticationError, InsufficientBalanceError, PermissionError, NotFoundError, RateLimitError, APIError, } from "./errors.js";
+export type { MeridianBlueConfig, ChatRole, ChatMessage, ChatCompletionRequest, } from "./types/requests.js";
+export type { ChatChoice, ChatUsage, ChatBilling, ChatCompletionResponse, } from "./types/responses.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Main client
+export { MeridianBlue } from "./client.js";
+// Error classes — export so users can do `catch (e) { if (e instanceof RateLimitError) }`
+export { MeridianBlueError, AuthenticationError, InsufficientBalanceError, PermissionError, NotFoundError, RateLimitError, APIError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,0FAA0F;AAC1F,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/resources/chat.d.ts

@@ -0,0 +1,20 @@
+import type { AxiosInstance } from "axios";
+import type { ChatCompletionRequest } from "../types/requests.js";
+import type { ChatCompletionResponse } from "../types/responses.js";
+export declare class Chat {
+    private readonly http;
+    constructor(http: AxiosInstance);
+    /**
+     * Send a chat completion request through the MeridianBlue proxy.
+     *
+     * @example
+     * const response = await meridianBlue.chat.completions({
+     *   slug: 'meridian-blue/gpt-4o',
+     *   messages: [{ role: 'user', content: 'Hello!' }],
+     * });
+     * console.log(response.choices[0].message.content);
+     * console.log(`Cost: ${response.billing.cost} credits`);
+     */
+    completions(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/resources/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,qBAAa,IAAI;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;;;;;OAUG;IACU,WAAW,CACtB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;CAOnC"}

package/dist/resources/chat.js

@@ -0,0 +1,21 @@
+export class Chat {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Send a chat completion request through the MeridianBlue proxy.
+     *
+     * @example
+     * const response = await meridianBlue.chat.completions({
+     *   slug: 'meridian-blue/gpt-4o',
+     *   messages: [{ role: 'user', content: 'Hello!' }],
+     * });
+     * console.log(response.choices[0].message.content);
+     * console.log(`Cost: ${response.billing.cost} credits`);
+     */
+    async completions(request) {
+        const response = await this.http.post("/api/v1/chat/completions", request);
+        return response.data;
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/resources/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/resources/chat.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,IAAI;IACf,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;;;;;;OAUG;IACI,KAAK,CAAC,WAAW,CACtB,OAA8B;QAE9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CACnC,0BAA0B,EAC1B,OAAO,CACR,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/types/requests.d.ts

@@ -0,0 +1,25 @@
+export interface MeridianBlueConfig {
+    /** Your kp_live_ API key */
+    apiKey: string;
+    /**
+     * Base URL of your MeridianBlue server.
+     * Defaults to https://api.meridian-blue.dev if not provided.
+     */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 30000 (30s). */
+    timeout?: number;
+}
+export type ChatRole = "user" | "assistant" | "system";
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+export interface ChatCompletionRequest {
+    /** The MeridianBlue model slug e.g. "omni/gpt-4o" */
+    slug: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=requests.d.ts.map

package/dist/types/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../../src/types/requests.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/requests.js

@@ -0,0 +1,3 @@
+// ── SDK Configuration ──────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=requests.js.map

package/dist/types/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../src/types/requests.ts"],"names":[],"mappings":"AAAA,kFAAkF"}

package/dist/types/responses.d.ts

@@ -0,0 +1,31 @@
+import { ChatMessage } from "./requests.js";
+export interface ChatChoice {
+    message: ChatMessage;
+    finish_reason?: string;
+    index: number;
+}
+export interface ChatUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface ChatBilling {
+    /** Credits deducted for this request */
+    cost: number;
+    /** Your credit balance after this request */
+    balanceAfter: number;
+    /** True if a fallback provider was used instead of the primary */
+    isFallback: boolean;
+    /** Total request latency in milliseconds */
+    latencyMs: number;
+}
+export interface ChatCompletionResponse {
+    /** Conversation ID for debugging and usage logs */
+    id: string;
+    /** The slug that was routed e.g. "meridian-blue/gpt-4o" */
+    model: string;
+    choices: ChatChoice[];
+    usage: ChatUsage;
+    billing: ChatBilling;
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/types/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/types/responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/types/responses.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=responses.js.map

package/dist/types/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/types/responses.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@company786/meridian-blue-sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript/JavaScript SDK for the Meridian-Blue API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "meridian-blue",
+    "ai",
+    "llm",
+    "sdk",
+    "openai",
+    "groq",
+    "mistral"
+  ],
+  "author": "Meridian Blue",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.7.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}