@routerxjs/core 0.0.1

package/dist/chunk-PQO5XDOQ.js

@@ -0,0 +1,71 @@
+// src/router/Router.ts
+var Router = class {
+  providers;
+  defaultProviderId;
+  constructor(config) {
+    this.providers = config.providers;
+    this.defaultProviderId = config.defaultProviderId;
+  }
+  /**
+   * Find the best provider for a given model
+   */
+  route(model) {
+    const candidates = this.providers.filter((p) => p.enabled !== false).filter((p) => p.models.includes(model)).sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+    if (candidates.length > 0) {
+      return { provider: candidates[0], model };
+    }
+    if (this.defaultProviderId) {
+      const defaultProvider = this.providers.find(
+        (p) => p.id === this.defaultProviderId && p.enabled !== false
+      );
+      if (defaultProvider) {
+        return { provider: defaultProvider, model };
+      }
+    }
+    return null;
+  }
+  /**
+   * List all available models across all providers
+   */
+  listModels() {
+    const models = [];
+    for (const provider of this.providers) {
+      if (provider.enabled === false) continue;
+      for (const model of provider.models) {
+        models.push({
+          model,
+          providerId: provider.id,
+          protocol: provider.protocol
+        });
+      }
+    }
+    return models;
+  }
+  /**
+   * Add a provider at runtime
+   */
+  addProvider(provider) {
+    const existing = this.providers.findIndex((p) => p.id === provider.id);
+    if (existing >= 0) {
+      this.providers[existing] = provider;
+    } else {
+      this.providers.push(provider);
+    }
+  }
+  /**
+   * Remove a provider
+   */
+  removeProvider(id) {
+    const idx = this.providers.findIndex((p) => p.id === id);
+    if (idx >= 0) {
+      this.providers.splice(idx, 1);
+      return true;
+    }
+    return false;
+  }
+};
+
+export {
+  Router
+};
+//# sourceMappingURL=chunk-PQO5XDOQ.js.map

package/dist/chunk-PQO5XDOQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router/Router.ts"],"sourcesContent":["/**\n * Router — model matching and provider selection\n *\n * Given a model name, find the best provider to serve it.\n */\n\nimport type { RegisteredProvider, RouteResult, RouterConfig } from \"./types\";\n\nexport class Router {\n  private providers: RegisteredProvider[];\n  private defaultProviderId?: string;\n\n  constructor(config: RouterConfig) {\n    this.providers = config.providers;\n    this.defaultProviderId = config.defaultProviderId;\n  }\n\n  /**\n   * Find the best provider for a given model\n   */\n  route(model: string): RouteResult | null {\n    // Find providers that explicitly list this model\n    const candidates = this.providers\n      .filter((p) => p.enabled !== false)\n      .filter((p) => p.models.includes(model))\n      .sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));\n\n    if (candidates.length > 0) {\n      return { provider: candidates[0], model };\n    }\n\n    // Fallback to default provider\n    if (this.defaultProviderId) {\n      const defaultProvider = this.providers.find(\n        (p) => p.id === this.defaultProviderId && p.enabled !== false\n      );\n      if (defaultProvider) {\n        return { provider: defaultProvider, model };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * List all available models across all providers\n   */\n  listModels(): Array<{ model: string; providerId: string; protocol: string }> {\n    const models: Array<{ model: string; providerId: string; protocol: string }> = [];\n    for (const provider of this.providers) {\n      if (provider.enabled === false) continue;\n      for (const model of provider.models) {\n        models.push({\n          model,\n          providerId: provider.id,\n          protocol: provider.protocol,\n        });\n      }\n    }\n    return models;\n  }\n\n  /**\n   * Add a provider at runtime\n   */\n  addProvider(provider: RegisteredProvider): void {\n    const existing = this.providers.findIndex((p) => p.id === provider.id);\n    if (existing >= 0) {\n      this.providers[existing] = provider;\n    } else {\n      this.providers.push(provider);\n    }\n  }\n\n  /**\n   * Remove a provider\n   */\n  removeProvider(id: string): boolean {\n    const idx = this.providers.findIndex((p) => p.id === id);\n    if (idx >= 0) {\n      this.providers.splice(idx, 1);\n      return true;\n    }\n    return false;\n  }\n}\n"],"mappings":";AAQO,IAAM,SAAN,MAAa;AAAA,EACV;AAAA,EACA;AAAA,EAER,YAAY,QAAsB;AAChC,SAAK,YAAY,OAAO;AACxB,SAAK,oBAAoB,OAAO;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAmC;AAEvC,UAAM,aAAa,KAAK,UACrB,OAAO,CAAC,MAAM,EAAE,YAAY,KAAK,EACjC,OAAO,CAAC,MAAM,EAAE,OAAO,SAAS,KAAK,CAAC,EACtC,KAAK,CAAC,GAAG,OAAO,EAAE,YAAY,QAAQ,EAAE,YAAY,IAAI;AAE3D,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO,EAAE,UAAU,WAAW,CAAC,GAAG,MAAM;AAAA,IAC1C;AAGA,QAAI,KAAK,mBAAmB;AAC1B,YAAM,kBAAkB,KAAK,UAAU;AAAA,QACrC,CAAC,MAAM,EAAE,OAAO,KAAK,qBAAqB,EAAE,YAAY;AAAA,MAC1D;AACA,UAAI,iBAAiB;AACnB,eAAO,EAAE,UAAU,iBAAiB,MAAM;AAAA,MAC5C;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,aAA6E;AAC3E,UAAM,SAAyE,CAAC;AAChF,eAAW,YAAY,KAAK,WAAW;AACrC,UAAI,SAAS,YAAY,MAAO;AAChC,iBAAW,SAAS,SAAS,QAAQ;AACnC,eAAO,KAAK;AAAA,UACV;AAAA,UACA,YAAY,SAAS;AAAA,UACrB,UAAU,SAAS;AAAA,QACrB,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,UAAoC;AAC9C,UAAM,WAAW,KAAK,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE;AACrE,QAAI,YAAY,GAAG;AACjB,WAAK,UAAU,QAAQ,IAAI;AAAA,IAC7B,OAAO;AACL,WAAK,UAAU,KAAK,QAAQ;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,IAAqB;AAClC,UAAM,MAAM,KAAK,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE;AACvD,QAAI,OAAO,GAAG;AACZ,WAAK,UAAU,OAAO,KAAK,CAAC;AAC5B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { ProviderProtocol, RegisteredProvider, RouteResult, Router, RouterConfig } from './router/index.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+import {
+  Router
+} from "./chunk-PQO5XDOQ.js";
+export {
+  Router
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/router/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Router Types — routing configuration and model matching
+ */
+/**
+ * Supported upstream provider protocols
+ */
+type ProviderProtocol = "openai-compatible" | "anthropic";
+/**
+ * A registered upstream provider with its capabilities
+ */
+interface RegisteredProvider {
+    /** Unique provider ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Protocol this provider speaks */
+    protocol: ProviderProtocol;
+    /** API key */
+    apiKey: string;
+    /** Custom base URL */
+    baseUrl?: string;
+    /** Models this provider can serve */
+    models: string[];
+    /** Priority for model matching (lower = higher priority) */
+    priority?: number;
+    /** Whether this provider is enabled */
+    enabled?: boolean;
+}
+/**
+ * The result of routing a request to a provider
+ */
+interface RouteResult {
+    /** The matched provider */
+    provider: RegisteredProvider;
+    /** The model to use (may be remapped) */
+    model: string;
+}
+/**
+ * Router configuration
+ */
+interface RouterConfig {
+    /** Registered providers */
+    providers: RegisteredProvider[];
+    /** Default provider ID (fallback when no model match) */
+    defaultProviderId?: string;
+}
+
+/**
+ * Router — model matching and provider selection
+ *
+ * Given a model name, find the best provider to serve it.
+ */
+
+declare class Router {
+    private providers;
+    private defaultProviderId?;
+    constructor(config: RouterConfig);
+    /**
+     * Find the best provider for a given model
+     */
+    route(model: string): RouteResult | null;
+    /**
+     * List all available models across all providers
+     */
+    listModels(): Array<{
+        model: string;
+        providerId: string;
+        protocol: string;
+    }>;
+    /**
+     * Add a provider at runtime
+     */
+    addProvider(provider: RegisteredProvider): void;
+    /**
+     * Remove a provider
+     */
+    removeProvider(id: string): boolean;
+}
+
+export { type ProviderProtocol, type RegisteredProvider, type RouteResult, Router, type RouterConfig };

package/dist/router/index.js

@@ -0,0 +1,7 @@
+import {
+  Router
+} from "../chunk-PQO5XDOQ.js";
+export {
+  Router
+};
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@routerxjs/core",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "import": "./dist/router/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+// Router
+
+export type {
+  ProviderProtocol,
+  RegisteredProvider,
+  RouteResult,
+  RouterConfig,
+} from "./router/index";
+export { Router } from "./router/index";

package/src/router/Router.ts

@@ -0,0 +1,86 @@
+/**
+ * Router — model matching and provider selection
+ *
+ * Given a model name, find the best provider to serve it.
+ */
+
+import type { RegisteredProvider, RouteResult, RouterConfig } from "./types";
+
+export class Router {
+  private providers: RegisteredProvider[];
+  private defaultProviderId?: string;
+
+  constructor(config: RouterConfig) {
+    this.providers = config.providers;
+    this.defaultProviderId = config.defaultProviderId;
+  }
+
+  /**
+   * Find the best provider for a given model
+   */
+  route(model: string): RouteResult | null {
+    // Find providers that explicitly list this model
+    const candidates = this.providers
+      .filter((p) => p.enabled !== false)
+      .filter((p) => p.models.includes(model))
+      .sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+
+    if (candidates.length > 0) {
+      return { provider: candidates[0], model };
+    }
+
+    // Fallback to default provider
+    if (this.defaultProviderId) {
+      const defaultProvider = this.providers.find(
+        (p) => p.id === this.defaultProviderId && p.enabled !== false
+      );
+      if (defaultProvider) {
+        return { provider: defaultProvider, model };
+      }
+    }
+
+    return null;
+  }
+
+  /**
+   * List all available models across all providers
+   */
+  listModels(): Array<{ model: string; providerId: string; protocol: string }> {
+    const models: Array<{ model: string; providerId: string; protocol: string }> = [];
+    for (const provider of this.providers) {
+      if (provider.enabled === false) continue;
+      for (const model of provider.models) {
+        models.push({
+          model,
+          providerId: provider.id,
+          protocol: provider.protocol,
+        });
+      }
+    }
+    return models;
+  }
+
+  /**
+   * Add a provider at runtime
+   */
+  addProvider(provider: RegisteredProvider): void {
+    const existing = this.providers.findIndex((p) => p.id === provider.id);
+    if (existing >= 0) {
+      this.providers[existing] = provider;
+    } else {
+      this.providers.push(provider);
+    }
+  }
+
+  /**
+   * Remove a provider
+   */
+  removeProvider(id: string): boolean {
+    const idx = this.providers.findIndex((p) => p.id === id);
+    if (idx >= 0) {
+      this.providers.splice(idx, 1);
+      return true;
+    }
+    return false;
+  }
+}

package/src/router/index.ts

@@ -0,0 +1,7 @@
+export { Router } from "./Router";
+export type {
+  ProviderProtocol,
+  RegisteredProvider,
+  RouteResult,
+  RouterConfig,
+} from "./types";

package/src/router/types.ts

@@ -0,0 +1,59 @@
+/**
+ * Router Types — routing configuration and model matching
+ */
+
+/**
+ * Supported upstream provider protocols
+ */
+export type ProviderProtocol = "openai-compatible" | "anthropic";
+
+/**
+ * A registered upstream provider with its capabilities
+ */
+export interface RegisteredProvider {
+  /** Unique provider ID */
+  id: string;
+
+  /** Display name */
+  name: string;
+
+  /** Protocol this provider speaks */
+  protocol: ProviderProtocol;
+
+  /** API key */
+  apiKey: string;
+
+  /** Custom base URL */
+  baseUrl?: string;
+
+  /** Models this provider can serve */
+  models: string[];
+
+  /** Priority for model matching (lower = higher priority) */
+  priority?: number;
+
+  /** Whether this provider is enabled */
+  enabled?: boolean;
+}
+
+/**
+ * The result of routing a request to a provider
+ */
+export interface RouteResult {
+  /** The matched provider */
+  provider: RegisteredProvider;
+
+  /** The model to use (may be remapped) */
+  model: string;
+}
+
+/**
+ * Router configuration
+ */
+export interface RouterConfig {
+  /** Registered providers */
+  providers: RegisteredProvider[];
+
+  /** Default provider ID (fallback when no model match) */
+  defaultProviderId?: string;
+}