proxitor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,200 @@
+# proxitor
+
+> Lightweight proxy for routing CLI requests (claude-code, codex) to [OpenRouter](https://openrouter.ai)
+
+## Why
+
+When using AI CLI tools like Claude Code or Codex, you may want to route requests through OpenRouter for model selection, cost control, or unified API access. Proxitor sits between your CLI tools and OpenRouter, injecting [provider routing](https://openrouter.ai/docs/api/reference/streaming) into requests and streaming responses back unchanged — including SSE streams from LLM models.
+
+## Install
+
+```bash
+# npm
+npm install -g proxitor
+
+# bun
+bun install -g proxitor
+
+# npx (no install)
+npx proxitor
+```
+
+## Usage
+
+### Start the proxy
+
+```bash
+# With env var
+OPENROUTER_API_KEY=sk-... proxitor
+
+# With CLI flag
+proxitor --openrouter-key sk-...
+
+# With config file
+proxitor --config ./proxitor.config.yaml
+```
+
+### Configure CLI tools
+
+Point your AI CLI tools at the proxy:
+
+```bash
+# Claude Code
+ANTHROPIC_BASE_URL=http://localhost:8080/v1 claude
+
+# Codex
+OPENAI_BASE_URL=http://localhost:8080/v1 codex
+```
+
+## Configuration
+
+Proxitor looks for config files in this order:
+
+1. `proxitor.config.yaml`
+2. `proxitor.config.yml`
+3. `proxitor.config.json`
+4. `.proxitor.yaml`
+5. `.proxitor.yml`
+6. `.proxitor.json`
+
+See [`proxitor.config.example.yaml`](./proxitor.config.example.yaml) for a full example.
+
+### Priority
+
+CLI flags > config file > environment variables > defaults
+
+### Provider routing
+
+Control which upstream provider handles your requests. Both `only` and `order` accept a single string or an array:
+
+```yaml
+# Use a single provider exclusively (no fallbacks)
+provider:
+  only: "deepinfra"
+
+# Use multiple providers exclusively
+provider:
+  only:
+    - "openai"
+    - "azure"
+
+# Prefer a provider, allow fallbacks
+provider:
+  order: "anthropic"
+  allowFallbacks: true
+
+# Try providers in order
+provider:
+  order:
+    - "anthropic"
+    - "deepinfra"
+  allowFallbacks: false
+```
+
+Without `provider` configured, the proxy forwards requests unchanged.  
+See the [OpenRouter provider routing docs](https://openrouter.ai/docs/guides/routing/provider-selection) for the full list of supported providers.
+
+### Per-model overrides
+
+Route different models to different providers using `modelOverrides`. Keys are exact model names or prefix patterns (e.g. `claude-*`). Overrides layer on top of global settings — `provider` replaces the global value, `headers` merge:
+
+```yaml
+provider:
+  order: "deepinfra"
+
+modelOverrides:
+  # Exact match — force Anthropic models to Anthropic's own infrastructure
+  "claude-sonnet-4-6":
+    provider:
+      only: "anthropic"
+
+  # Wildcard — all Claude models prefer Anthropic with fallback
+  "claude-*":
+    provider:
+      order:
+        - "anthropic"
+        - "deepinfra"
+
+  # Wildcard — GPT models to OpenAI/Azure, plus a custom header
+  "gpt-*":
+    provider:
+      only:
+        - "openai"
+        - "azure"
+    headers:
+      X-Model-Family: "gpt"
+```
+
+When a model name matches multiple patterns, the most specific match wins (exact name > longer prefix > shorter prefix).
+
+### Custom headers
+
+Add custom headers to all proxied requests, or per-model via `modelOverrides`:
+
+```yaml
+# Global custom headers
+headers:
+  X-Custom-Header: "my-value"
+  X-Environment: "production"
+
+# Per-model headers (merged on top of global)
+modelOverrides:
+  "claude-*":
+    headers:
+      X-Custom-Header: "claude-override"  # overrides global value
+      X-Extra: "only-for-claude"          # added only for this model
+```
+
+### Health check
+
+```bash
+curl http://localhost:8080/health
+```
+
+## CLI Options
+
+```text
+proxitor [options]
+
+Options:
+  -p, --port <port>             Proxy server port (default: 8080)
+  -h, --host <host>             Proxy server host (default: 0.0.0.0)
+  -c, --config <path>           Path to config file
+  --openrouter-key <key>        OpenRouter API key
+  --verbose                     Enable verbose logging
+  -v, --version                 Display version
+  --help                        Display help
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run in dev mode with watch
+pnpm run dev
+
+# Run tests
+pnpm run test
+
+# Type check
+pnpm run typecheck
+
+# Lint + format (Biome)
+pnpm run check:biome
+
+# Auto-fix lint + format issues
+pnpm run lint:fix
+pnpm run format
+
+# Build
+pnpm run build
+
+# Full check (typecheck + biome + test)
+pnpm run check
+```
+
+## License
+
+[MIT](./LICENSE)

package/dist/cli.cjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+const require_proxy = require("./proxy.cjs");
+let cac = require("cac");
+let dotenv = require("dotenv");
+//#region src/version.ts
+const version = "0.1.0";
+//#endregion
+//#region src/cli.ts
+(0, dotenv.config)();
+const cli = (0, cac.cac)("proxitor");
+cli.version(version).usage("[options]").help();
+cli.option("-p, --port <port>", "Proxy server port", { default: 8080 }).option("-h, --host <host>", "Proxy server host", { default: "0.0.0.0" }).option("-c, --config <path>", "Path to config file").option("--no-config", "Skip config file discovery").option("--openrouter-key <key>", "OpenRouter API key").option("--verbose", "Enable verbose logging");
+const parsed = cli.parse();
+async function main() {
+	try {
+		const config = await require_proxy.loadConfig({
+			configPath: typeof parsed.options.config === "string" ? parsed.options.config : void 0,
+			noConfig: parsed.options.config === false,
+			port: parsed.options.port,
+			host: parsed.options.host,
+			openrouterKey: parsed.options.openrouterKey,
+			verbose: parsed.options.verbose
+		});
+		require_proxy.startProxyServer(config, () => {
+			require_proxy.logger.ready(`Proxitor proxy listening on ${config.host}:${config.port}`);
+			require_proxy.logger.info(`Routing requests to OpenRouter`);
+		});
+	} catch (error) {
+		require_proxy.logger.error("Failed to start proxy:", error);
+		process.exit(1);
+	}
+}
+main();
+//#endregion
+
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["loadConfig"],"sources":["../src/version.ts","../src/cli.ts"],"sourcesContent":["export const version = '0.1.0'\n","#!/usr/bin/env node\nimport { cac } from 'cac'\nimport { config as loadDotenv } from 'dotenv'\nimport { loadConfig } from './config.js'\nimport { logger } from './logger.js'\nimport { startProxyServer } from './proxy.js'\nimport { version } from './version.js'\n\nloadDotenv()\n\nconst cli = cac('proxitor')\n\ncli.version(version).usage('[options]').help()\n\ncli\n  .option('-p, --port <port>', 'Proxy server port', { default: 8080 })\n  .option('-h, --host <host>', 'Proxy server host', { default: '0.0.0.0' })\n  .option('-c, --config <path>', 'Path to config file')\n  .option('--no-config', 'Skip config file discovery')\n  .option('--openrouter-key <key>', 'OpenRouter API key')\n  .option('--verbose', 'Enable verbose logging')\n\nconst parsed = cli.parse()\n\nasync function main() {\n  try {\n    const config = await loadConfig({\n      configPath:\n        typeof parsed.options.config === 'string' ? parsed.options.config : undefined,\n      noConfig: parsed.options.config === false,\n      port: parsed.options.port,\n      host: parsed.options.host,\n      openrouterKey: parsed.options.openrouterKey,\n      verbose: parsed.options.verbose,\n    })\n\n    startProxyServer(config, () => {\n      logger.ready(`Proxitor proxy listening on ${config.host}:${config.port}`)\n      logger.info(`Routing requests to OpenRouter`)\n    })\n  } catch (error) {\n    logger.error('Failed to start proxy:', error)\n    process.exit(1)\n  }\n}\n\nvoid main()\n"],"mappings":";;;;;AAAA,MAAa,UAAU;;;mBCQZ;AAEX,MAAM,OAAA,GAAA,IAAA,KAAU,UAAU;AAE1B,IAAI,QAAQ,OAAO,EAAE,MAAM,WAAW,EAAE,KAAK;AAE7C,IACG,OAAO,qBAAqB,qBAAqB,EAAE,SAAS,KAAK,CAAC,EAClE,OAAO,qBAAqB,qBAAqB,EAAE,SAAS,UAAU,CAAC,EACvE,OAAO,uBAAuB,qBAAqB,EACnD,OAAO,eAAe,4BAA4B,EAClD,OAAO,0BAA0B,oBAAoB,EACrD,OAAO,aAAa,wBAAwB;AAE/C,MAAM,SAAS,IAAI,MAAM;AAEzB,eAAe,OAAO;CACpB,IAAI;EACF,MAAM,SAAS,MAAMA,cAAAA,WAAW;GAC9B,YACE,OAAO,OAAO,QAAQ,WAAW,WAAW,OAAO,QAAQ,SAAS,KAAA;GACtE,UAAU,OAAO,QAAQ,WAAW;GACpC,MAAM,OAAO,QAAQ;GACrB,MAAM,OAAO,QAAQ;GACrB,eAAe,OAAO,QAAQ;GAC9B,SAAS,OAAO,QAAQ;EAC1B,CAAC;EAED,cAAA,iBAAiB,cAAc;GAC7B,cAAA,OAAO,MAAM,+BAA+B,OAAO,KAAK,GAAG,OAAO,MAAM;GACxE,cAAA,OAAO,KAAK,gCAAgC;EAC9C,CAAC;CACH,SAAS,OAAO;EACd,cAAA,OAAO,MAAM,0BAA0B,KAAK;EAC5C,QAAQ,KAAK,CAAC;CAChB;AACF;AAEK,KAAK"}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { i as logger, n as startProxyServer, o as loadConfig } from "./proxy.mjs";
+import { cac } from "cac";
+import { config } from "dotenv";
+//#region src/version.ts
+const version = "0.1.0";
+//#endregion
+//#region src/cli.ts
+config();
+const cli = cac("proxitor");
+cli.version(version).usage("[options]").help();
+cli.option("-p, --port <port>", "Proxy server port", { default: 8080 }).option("-h, --host <host>", "Proxy server host", { default: "0.0.0.0" }).option("-c, --config <path>", "Path to config file").option("--no-config", "Skip config file discovery").option("--openrouter-key <key>", "OpenRouter API key").option("--verbose", "Enable verbose logging");
+const parsed = cli.parse();
+async function main() {
+	try {
+		const config = await loadConfig({
+			configPath: typeof parsed.options.config === "string" ? parsed.options.config : void 0,
+			noConfig: parsed.options.config === false,
+			port: parsed.options.port,
+			host: parsed.options.host,
+			openrouterKey: parsed.options.openrouterKey,
+			verbose: parsed.options.verbose
+		});
+		startProxyServer(config, () => {
+			logger.ready(`Proxitor proxy listening on ${config.host}:${config.port}`);
+			logger.info(`Routing requests to OpenRouter`);
+		});
+	} catch (error) {
+		logger.error("Failed to start proxy:", error);
+		process.exit(1);
+	}
+}
+main();
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["loadDotenv"],"sources":["../src/version.ts","../src/cli.ts"],"sourcesContent":["export const version = '0.1.0'\n","#!/usr/bin/env node\nimport { cac } from 'cac'\nimport { config as loadDotenv } from 'dotenv'\nimport { loadConfig } from './config.js'\nimport { logger } from './logger.js'\nimport { startProxyServer } from './proxy.js'\nimport { version } from './version.js'\n\nloadDotenv()\n\nconst cli = cac('proxitor')\n\ncli.version(version).usage('[options]').help()\n\ncli\n  .option('-p, --port <port>', 'Proxy server port', { default: 8080 })\n  .option('-h, --host <host>', 'Proxy server host', { default: '0.0.0.0' })\n  .option('-c, --config <path>', 'Path to config file')\n  .option('--no-config', 'Skip config file discovery')\n  .option('--openrouter-key <key>', 'OpenRouter API key')\n  .option('--verbose', 'Enable verbose logging')\n\nconst parsed = cli.parse()\n\nasync function main() {\n  try {\n    const config = await loadConfig({\n      configPath:\n        typeof parsed.options.config === 'string' ? parsed.options.config : undefined,\n      noConfig: parsed.options.config === false,\n      port: parsed.options.port,\n      host: parsed.options.host,\n      openrouterKey: parsed.options.openrouterKey,\n      verbose: parsed.options.verbose,\n    })\n\n    startProxyServer(config, () => {\n      logger.ready(`Proxitor proxy listening on ${config.host}:${config.port}`)\n      logger.info(`Routing requests to OpenRouter`)\n    })\n  } catch (error) {\n    logger.error('Failed to start proxy:', error)\n    process.exit(1)\n  }\n}\n\nvoid main()\n"],"mappings":";;;;;AAAA,MAAa,UAAU;;;ACQvBA,OAAW;AAEX,MAAM,MAAM,IAAI,UAAU;AAE1B,IAAI,QAAQ,OAAO,EAAE,MAAM,WAAW,EAAE,KAAK;AAE7C,IACG,OAAO,qBAAqB,qBAAqB,EAAE,SAAS,KAAK,CAAC,EAClE,OAAO,qBAAqB,qBAAqB,EAAE,SAAS,UAAU,CAAC,EACvE,OAAO,uBAAuB,qBAAqB,EACnD,OAAO,eAAe,4BAA4B,EAClD,OAAO,0BAA0B,oBAAoB,EACrD,OAAO,aAAa,wBAAwB;AAE/C,MAAM,SAAS,IAAI,MAAM;AAEzB,eAAe,OAAO;CACpB,IAAI;EACF,MAAM,SAAS,MAAM,WAAW;GAC9B,YACE,OAAO,OAAO,QAAQ,WAAW,WAAW,OAAO,QAAQ,SAAS,KAAA;GACtE,UAAU,OAAO,QAAQ,WAAW;GACpC,MAAM,OAAO,QAAQ;GACrB,MAAM,OAAO,QAAQ;GACrB,eAAe,OAAO,QAAQ;GAC9B,SAAS,OAAO,QAAQ;EAC1B,CAAC;EAED,iBAAiB,cAAc;GAC7B,OAAO,MAAM,+BAA+B,OAAO,KAAK,GAAG,OAAO,MAAM;GACxE,OAAO,KAAK,gCAAgC;EAC9C,CAAC;CACH,SAAS,OAAO;EACd,OAAO,MAAM,0BAA0B,KAAK;EAC5C,QAAQ,KAAK,CAAC;CAChB;AACF;AAEK,KAAK"}

package/dist/index.cjs

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_proxy = require("./proxy.cjs");
+exports.buildProviderRouting = require_proxy.buildProviderRouting;
+exports.createProxyServer = require_proxy.createProxyServer;
+exports.extractModel = require_proxy.extractModel;
+exports.loadConfig = require_proxy.loadConfig;
+exports.matchScore = require_proxy.matchScore;
+exports.resolveModelConfig = require_proxy.resolveModelConfig;
+exports.toArray = require_proxy.toArray;
+exports.tryParseBody = require_proxy.tryParseBody;

package/dist/index.d.cts

@@ -0,0 +1,91 @@
+import { ServerType } from "@hono/node-server";
+
+//#region src/config.d.ts
+/** Percentile cutoffs for performance thresholds */
+type PercentileCutoffs = {
+  p50?: number;
+  p75?: number;
+  p90?: number;
+  p99?: number;
+};
+/** Provider sorting options */
+type ProviderSort = 'price' | 'throughput' | 'latency' | {
+  by: 'price' | 'throughput' | 'latency';
+  partition?: 'model' | 'none';
+};
+/** Maximum pricing for a request */
+type MaxPrice = {
+  prompt?: number;
+  completion?: number;
+  request?: number;
+  image?: number;
+};
+type ProviderConfig = {
+  /** Allow only these providers (e.g. "deepinfra" or ["anthropic", "openai"]) */only?: string | string[]; /** Try providers in this order (e.g. "anthropic" or ["openai", "together"]) */
+  order?: string | string[]; /** Ignore these providers (mirror of only — skip specific providers) */
+  ignore?: string | string[]; /** Allow fallback to other providers (default: true) */
+  allowFallbacks?: boolean; /** Sort providers by price, throughput, or latency */
+  sort?: ProviderSort; /** Filter by quantization levels (e.g. ["fp8", "int4"]) */
+  quantizations?: string[]; /** Maximum pricing to accept */
+  maxPrice?: MaxPrice; /** Only use providers that support all request parameters (default: false) */
+  requireParameters?: boolean; /** Control data collection policy: "allow" or "deny" (default: "allow") */
+  dataCollection?: 'allow' | 'deny'; /** Restrict routing to Zero Data Retention endpoints */
+  zdr?: boolean; /** Restrict routing to models that allow text distillation */
+  enforceDistillableText?: boolean; /** Preferred minimum throughput (tokens/sec) */
+  preferredMinThroughput?: number | PercentileCutoffs; /** Preferred maximum latency (seconds) */
+  preferredMaxLatency?: number | PercentileCutoffs;
+};
+/** Per-model override: layers on top of global config */
+type ModelOverride = {
+  /** Override provider routing for matching models */provider?: ProviderConfig; /** Additional headers to merge for matching models */
+  headers?: Record<string, string>;
+};
+/** Result of merging global config with a model-specific override */
+type ResolvedModelConfig = {
+  provider?: ProviderConfig;
+  headers?: Record<string, string>;
+};
+type ProxyConfig = {
+  host: string;
+  port: number;
+  openrouterKey: string;
+  openrouterBaseUrl: string;
+  verbose: boolean; /** Request body size limit (default: "50mb") */
+  bodyLimit: string; /** Provider routing configuration (global default) */
+  provider?: ProviderConfig; /** HTTP-Referer for OpenRouter attribution */
+  attributionReferer: string; /** X-Title for OpenRouter attribution */
+  attributionTitle: string; /** Custom headers to add to proxied requests (global default) */
+  headers?: Record<string, string>; /** Per-model config overrides. Keys are exact model names or prefix patterns (e.g. "claude-*") */
+  modelOverrides?: Record<string, ModelOverride>;
+};
+type LoadConfigOptions = {
+  configPath?: string;
+  noConfig?: boolean;
+  host?: string;
+  openrouterKey?: string;
+  port?: number;
+  verbose?: boolean;
+};
+/** Build the provider routing object for OpenRouter request body injection */
+declare function buildProviderRouting(provider?: ProviderConfig): Record<string, unknown> | undefined;
+/** Score a pattern against a model name. Higher = better match. -1 = no match. */
+declare function matchScore(pattern: string, modelName: string): number;
+/** Resolve the effective config for a given model by merging global defaults with the best-matching override */
+declare function resolveModelConfig(config: ProxyConfig, modelName?: string): ResolvedModelConfig;
+declare function loadConfig(options: LoadConfigOptions): Promise<ProxyConfig>;
+//#endregion
+//#region src/proxy/inject.d.ts
+/** Extract the model name from a raw request body. Returns undefined if not parseable or absent. */
+declare function extractModel(rawBody: ArrayBuffer): string | undefined;
+//#endregion
+//#region src/proxy.d.ts
+declare function createProxyServer(config: ProxyConfig, onReady?: () => void): ServerType;
+//#endregion
+//#region src/utils.d.ts
+/** Normalize a single string or array of strings to an array. Returns undefined for empty arrays. */
+declare function toArray(value: string | string[] | undefined): string[] | undefined;
+/** Try to parse an ArrayBuffer as JSON. Returns undefined on failure or empty body. */
+declare function tryParseBody(raw: ArrayBuffer): Record<string, unknown> | undefined;
+//#endregion
+export { type ModelOverride, type ProviderConfig, type ProxyConfig, type ResolvedModelConfig, buildProviderRouting, createProxyServer, extractModel, loadConfig, matchScore, resolveModelConfig, toArray, tryParseBody };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config.ts","../src/proxy/inject.ts","../src/proxy.ts","../src/utils.ts"],"mappings":";;;;KAOY,iBAAA;EACV,GAAA;EACA,GAAA;EACA,GAAA;EACA,GAAA;AAAA;;KAIU,YAAA;EAIN,EAAA;EAAwC,SAAS;AAAA;AARlD;AAAA,KAWO,QAAA;EACV,MAAA;EACA,UAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,KAGU,cAAA;iFAEV,IAAA,sBARA;EAUA,KAAA,sBARA;EAUA,MAAA,sBATK;EAWL,cAAA,YARU;EAUV,IAAA,GAAO,YAAA;EAEP,aAAA,aAEW;EAAX,QAAA,GAAW,QAAA,EAYoB;EAV/B,iBAAA,YAUgD;EARhD,cAAA,qBAdA;EAgBA,GAAA,YAZA;EAcA,sBAAA,YAZO;EAcP,sBAAA,YAAkC,iBAAA,EAVlC;EAYA,mBAAA,YAA+B,iBAAA;AAAA;;KAIrB,aAAA;EARV,oDAUA,QAAA,GAAW,cAAA,EARuB;EAUlC,OAAA,GAAU,MAAM;AAAA;;KAIN,mBAAA;EACV,QAAA,GAAW,cAAA;EACX,OAAA,GAAU,MAAM;AAAA;AAAA,KAGN,WAAA;EACV,IAAA;EACA,IAAA;EACA,aAAA;EACA,iBAAA;EACA,OAAA,WAdgB;EAgBhB,SAAA,UAZ6B;EAc7B,QAAA,GAAW,cAAA,EAZK;EAchB,kBAAA,UAfW;EAiBX,gBAAA,UAhBU;EAkBV,OAAA,GAAU,MAAA,kBAlBM;EAoBhB,cAAA,GAAiB,MAAA,SAAe,aAAA;AAAA;AAAA,KAc7B,iBAAA;EACH,UAAA;EACA,QAAA;EACA,IAAA;EACA,aAAA;EACA,IAAA;EACA,OAAA;AAAA;;iBAwBc,oBAAA,CACd,QAAA,GAAW,cAAA,GACV,MAAM;;iBA0BO,UAAA,CAAW,OAAA,UAAiB,SAAiB;;iBAW7C,kBAAA,CACd,MAAA,EAAQ,WAAA,EACR,SAAA,YACC,mBAAmB;AAAA,iBAgCA,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,WAAA;;;;iBC5MtD,YAAA,CAAa,OAAoB,EAAX,WAAW;;;iBC0JjC,iBAAA,CAAkB,MAAA,EAAQ,WAAA,EAAa,OAAA,gBAAuB,UAAU;;;;iBC5JxE,OAAA,CAAQ,KAAoC;;iBAO5C,YAAA,CAAa,GAAA,EAAK,WAAA,GAAc,MAAM"}

package/dist/index.d.mts

@@ -0,0 +1,91 @@
+import { ServerType } from "@hono/node-server";
+
+//#region src/config.d.ts
+/** Percentile cutoffs for performance thresholds */
+type PercentileCutoffs = {
+  p50?: number;
+  p75?: number;
+  p90?: number;
+  p99?: number;
+};
+/** Provider sorting options */
+type ProviderSort = 'price' | 'throughput' | 'latency' | {
+  by: 'price' | 'throughput' | 'latency';
+  partition?: 'model' | 'none';
+};
+/** Maximum pricing for a request */
+type MaxPrice = {
+  prompt?: number;
+  completion?: number;
+  request?: number;
+  image?: number;
+};
+type ProviderConfig = {
+  /** Allow only these providers (e.g. "deepinfra" or ["anthropic", "openai"]) */only?: string | string[]; /** Try providers in this order (e.g. "anthropic" or ["openai", "together"]) */
+  order?: string | string[]; /** Ignore these providers (mirror of only — skip specific providers) */
+  ignore?: string | string[]; /** Allow fallback to other providers (default: true) */
+  allowFallbacks?: boolean; /** Sort providers by price, throughput, or latency */
+  sort?: ProviderSort; /** Filter by quantization levels (e.g. ["fp8", "int4"]) */
+  quantizations?: string[]; /** Maximum pricing to accept */
+  maxPrice?: MaxPrice; /** Only use providers that support all request parameters (default: false) */
+  requireParameters?: boolean; /** Control data collection policy: "allow" or "deny" (default: "allow") */
+  dataCollection?: 'allow' | 'deny'; /** Restrict routing to Zero Data Retention endpoints */
+  zdr?: boolean; /** Restrict routing to models that allow text distillation */
+  enforceDistillableText?: boolean; /** Preferred minimum throughput (tokens/sec) */
+  preferredMinThroughput?: number | PercentileCutoffs; /** Preferred maximum latency (seconds) */
+  preferredMaxLatency?: number | PercentileCutoffs;
+};
+/** Per-model override: layers on top of global config */
+type ModelOverride = {
+  /** Override provider routing for matching models */provider?: ProviderConfig; /** Additional headers to merge for matching models */
+  headers?: Record<string, string>;
+};
+/** Result of merging global config with a model-specific override */
+type ResolvedModelConfig = {
+  provider?: ProviderConfig;
+  headers?: Record<string, string>;
+};
+type ProxyConfig = {
+  host: string;
+  port: number;
+  openrouterKey: string;
+  openrouterBaseUrl: string;
+  verbose: boolean; /** Request body size limit (default: "50mb") */
+  bodyLimit: string; /** Provider routing configuration (global default) */
+  provider?: ProviderConfig; /** HTTP-Referer for OpenRouter attribution */
+  attributionReferer: string; /** X-Title for OpenRouter attribution */
+  attributionTitle: string; /** Custom headers to add to proxied requests (global default) */
+  headers?: Record<string, string>; /** Per-model config overrides. Keys are exact model names or prefix patterns (e.g. "claude-*") */
+  modelOverrides?: Record<string, ModelOverride>;
+};
+type LoadConfigOptions = {
+  configPath?: string;
+  noConfig?: boolean;
+  host?: string;
+  openrouterKey?: string;
+  port?: number;
+  verbose?: boolean;
+};
+/** Build the provider routing object for OpenRouter request body injection */
+declare function buildProviderRouting(provider?: ProviderConfig): Record<string, unknown> | undefined;
+/** Score a pattern against a model name. Higher = better match. -1 = no match. */
+declare function matchScore(pattern: string, modelName: string): number;
+/** Resolve the effective config for a given model by merging global defaults with the best-matching override */
+declare function resolveModelConfig(config: ProxyConfig, modelName?: string): ResolvedModelConfig;
+declare function loadConfig(options: LoadConfigOptions): Promise<ProxyConfig>;
+//#endregion
+//#region src/proxy/inject.d.ts
+/** Extract the model name from a raw request body. Returns undefined if not parseable or absent. */
+declare function extractModel(rawBody: ArrayBuffer): string | undefined;
+//#endregion
+//#region src/proxy.d.ts
+declare function createProxyServer(config: ProxyConfig, onReady?: () => void): ServerType;
+//#endregion
+//#region src/utils.d.ts
+/** Normalize a single string or array of strings to an array. Returns undefined for empty arrays. */
+declare function toArray(value: string | string[] | undefined): string[] | undefined;
+/** Try to parse an ArrayBuffer as JSON. Returns undefined on failure or empty body. */
+declare function tryParseBody(raw: ArrayBuffer): Record<string, unknown> | undefined;
+//#endregion
+export { type ModelOverride, type ProviderConfig, type ProxyConfig, type ResolvedModelConfig, buildProviderRouting, createProxyServer, extractModel, loadConfig, matchScore, resolveModelConfig, toArray, tryParseBody };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config.ts","../src/proxy/inject.ts","../src/proxy.ts","../src/utils.ts"],"mappings":";;;;KAOY,iBAAA;EACV,GAAA;EACA,GAAA;EACA,GAAA;EACA,GAAA;AAAA;;KAIU,YAAA;EAIN,EAAA;EAAwC,SAAS;AAAA;AARlD;AAAA,KAWO,QAAA;EACV,MAAA;EACA,UAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,KAGU,cAAA;iFAEV,IAAA,sBARA;EAUA,KAAA,sBARA;EAUA,MAAA,sBATK;EAWL,cAAA,YARU;EAUV,IAAA,GAAO,YAAA;EAEP,aAAA,aAEW;EAAX,QAAA,GAAW,QAAA,EAYoB;EAV/B,iBAAA,YAUgD;EARhD,cAAA,qBAdA;EAgBA,GAAA,YAZA;EAcA,sBAAA,YAZO;EAcP,sBAAA,YAAkC,iBAAA,EAVlC;EAYA,mBAAA,YAA+B,iBAAA;AAAA;;KAIrB,aAAA;EARV,oDAUA,QAAA,GAAW,cAAA,EARuB;EAUlC,OAAA,GAAU,MAAM;AAAA;;KAIN,mBAAA;EACV,QAAA,GAAW,cAAA;EACX,OAAA,GAAU,MAAM;AAAA;AAAA,KAGN,WAAA;EACV,IAAA;EACA,IAAA;EACA,aAAA;EACA,iBAAA;EACA,OAAA,WAdgB;EAgBhB,SAAA,UAZ6B;EAc7B,QAAA,GAAW,cAAA,EAZK;EAchB,kBAAA,UAfW;EAiBX,gBAAA,UAhBU;EAkBV,OAAA,GAAU,MAAA,kBAlBM;EAoBhB,cAAA,GAAiB,MAAA,SAAe,aAAA;AAAA;AAAA,KAc7B,iBAAA;EACH,UAAA;EACA,QAAA;EACA,IAAA;EACA,aAAA;EACA,IAAA;EACA,OAAA;AAAA;;iBAwBc,oBAAA,CACd,QAAA,GAAW,cAAA,GACV,MAAM;;iBA0BO,UAAA,CAAW,OAAA,UAAiB,SAAiB;;iBAW7C,kBAAA,CACd,MAAA,EAAQ,WAAA,EACR,SAAA,YACC,mBAAmB;AAAA,iBAgCA,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,WAAA;;;;iBC5MtD,YAAA,CAAa,OAAoB,EAAX,WAAW;;;iBC0JjC,iBAAA,CAAkB,MAAA,EAAQ,WAAA,EAAa,OAAA,gBAAuB,UAAU;;;;iBC5JxE,OAAA,CAAQ,KAAoC;;iBAO5C,YAAA,CAAa,GAAA,EAAK,WAAA,GAAc,MAAM"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as buildProviderRouting, c as resolveModelConfig, l as toArray, o as loadConfig, r as extractModel, s as matchScore, t as createProxyServer, u as tryParseBody } from "./proxy.mjs";
+export { buildProviderRouting, createProxyServer, extractModel, loadConfig, matchScore, resolveModelConfig, toArray, tryParseBody };