@routerxjs/core 0.0.0-dev-20260318021459

package/dist/chunk-VPPWHNGZ.js

@@ -0,0 +1,91 @@
+// src/router/Router.ts
+function modelName(entry) {
+  return typeof entry === "string" ? entry : entry.name;
+}
+function upstreamModelName(entry) {
+  return typeof entry === "string" ? entry : entry.upstreamModel;
+}
+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 = [];
+    for (const provider of this.providers) {
+      if (provider.enabled === false) continue;
+      const entry = provider.models.find((m) => modelName(m) === model);
+      if (entry) {
+        candidates.push({ provider, entry });
+      }
+    }
+    candidates.sort((a, b) => (a.provider.priority ?? 100) - (b.provider.priority ?? 100));
+    if (candidates.length > 0) {
+      const { provider, entry } = candidates[0];
+      return {
+        provider,
+        model,
+        upstreamModel: upstreamModelName(entry)
+      };
+    }
+    if (this.defaultProviderId) {
+      const defaultProvider = this.providers.find(
+        (p) => p.id === this.defaultProviderId && p.enabled !== false
+      );
+      if (defaultProvider) {
+        return { provider: defaultProvider, model, upstreamModel: 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 entry of provider.models) {
+        models.push({
+          model: modelName(entry),
+          upstreamModel: upstreamModelName(entry),
+          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-VPPWHNGZ.js.map

package/dist/chunk-VPPWHNGZ.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 * Supports model name mapping (client name → upstream provider name).\n */\n\nimport type { ModelEntry, RegisteredProvider, RouteResult, RouterConfig } from \"./types\";\n\n/** Resolve a ModelEntry to its client-facing name */\nfunction modelName(entry: ModelEntry): string {\n  return typeof entry === \"string\" ? entry : entry.name;\n}\n\n/** Resolve a ModelEntry to its upstream name */\nfunction upstreamModelName(entry: ModelEntry): string {\n  return typeof entry === \"string\" ? entry : entry.upstreamModel;\n}\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 have this model (by client-facing name)\n    const candidates: Array<{ provider: RegisteredProvider; entry: ModelEntry }> = [];\n\n    for (const provider of this.providers) {\n      if (provider.enabled === false) continue;\n      const entry = provider.models.find((m) => modelName(m) === model);\n      if (entry) {\n        candidates.push({ provider, entry });\n      }\n    }\n\n    // Sort by priority\n    candidates.sort((a, b) => (a.provider.priority ?? 100) - (b.provider.priority ?? 100));\n\n    if (candidates.length > 0) {\n      const { provider, entry } = candidates[0];\n      return {\n        provider,\n        model,\n        upstreamModel: upstreamModelName(entry),\n      };\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, upstreamModel: model };\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * List all available models across all providers\n   */\n  listModels(): Array<{\n    model: string;\n    upstreamModel: string;\n    providerId: string;\n    protocol: string;\n  }> {\n    const models: Array<{\n      model: string;\n      upstreamModel: string;\n      providerId: string;\n      protocol: string;\n    }> = [];\n    for (const provider of this.providers) {\n      if (provider.enabled === false) continue;\n      for (const entry of provider.models) {\n        models.push({\n          model: modelName(entry),\n          upstreamModel: upstreamModelName(entry),\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":";AAUA,SAAS,UAAU,OAA2B;AAC5C,SAAO,OAAO,UAAU,WAAW,QAAQ,MAAM;AACnD;AAGA,SAAS,kBAAkB,OAA2B;AACpD,SAAO,OAAO,UAAU,WAAW,QAAQ,MAAM;AACnD;AAEO,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,aAAyE,CAAC;AAEhF,eAAW,YAAY,KAAK,WAAW;AACrC,UAAI,SAAS,YAAY,MAAO;AAChC,YAAM,QAAQ,SAAS,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC,MAAM,KAAK;AAChE,UAAI,OAAO;AACT,mBAAW,KAAK,EAAE,UAAU,MAAM,CAAC;AAAA,MACrC;AAAA,IACF;AAGA,eAAW,KAAK,CAAC,GAAG,OAAO,EAAE,SAAS,YAAY,QAAQ,EAAE,SAAS,YAAY,IAAI;AAErF,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,EAAE,UAAU,MAAM,IAAI,WAAW,CAAC;AACxC,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,eAAe,kBAAkB,KAAK;AAAA,MACxC;AAAA,IACF;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,OAAO,eAAe,MAAM;AAAA,MAClE;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,aAKG;AACD,UAAM,SAKD,CAAC;AACN,eAAW,YAAY,KAAK,WAAW;AACrC,UAAI,SAAS,YAAY,MAAO;AAChC,iBAAW,SAAS,SAAS,QAAQ;AACnC,eAAO,KAAK;AAAA,UACV,OAAO,UAAU,KAAK;AAAA,UACtB,eAAe,kBAAkB,KAAK;AAAA,UACtC,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 { ModelEntry, ProviderProtocol, RegisteredProvider, RouteResult, Router, RouterConfig } from './router/index.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+import {
+  Router
+} from "./chunk-VPPWHNGZ.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,101 @@
+/**
+ * Router Types — routing configuration and model matching
+ */
+/**
+ * Supported upstream provider protocols
+ */
+type ProviderProtocol = "openai-compatible" | "anthropic";
+/**
+ * Model entry — either a plain string or an object with upstream mapping
+ *
+ * Plain string: model name is the same on both sides
+ * Object: name is what clients request, upstreamModel is what the provider expects
+ *
+ * @example
+ * // Simple — same name both sides
+ * "gpt-4o"
+ *
+ * // Mapped — "deepseek-v3" externally, "ep-xxx" at the provider
+ * { name: "deepseek-v3", upstreamModel: "ep-20250101-xxx" }
+ */
+type ModelEntry = string | {
+    name: string;
+    upstreamModel: string;
+};
+/**
+ * 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: ModelEntry[];
+    /** 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 name as requested by the client */
+    model: string;
+    /** The model name to send to the upstream provider (may differ from model) */
+    upstreamModel: 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.
+ * Supports model name mapping (client name → upstream provider name).
+ */
+
+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;
+        upstreamModel: string;
+        providerId: string;
+        protocol: string;
+    }>;
+    /**
+     * Add a provider at runtime
+     */
+    addProvider(provider: RegisteredProvider): void;
+    /**
+     * Remove a provider
+     */
+    removeProvider(id: string): boolean;
+}
+
+export { type ModelEntry, type ProviderProtocol, type RegisteredProvider, type RouteResult, Router, type RouterConfig };

package/dist/router/index.js

@@ -0,0 +1,7 @@
+import {
+  Router
+} from "../chunk-VPPWHNGZ.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.0-dev-20260318021459",
+  "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,10 @@
+// Router
+
+export type {
+  ModelEntry,
+  ProviderProtocol,
+  RegisteredProvider,
+  RouteResult,
+  RouterConfig,
+} from "./router/index";
+export { Router } from "./router/index";

package/src/router/Router.ts

@@ -0,0 +1,121 @@
+/**
+ * Router — model matching and provider selection
+ *
+ * Given a model name, find the best provider to serve it.
+ * Supports model name mapping (client name → upstream provider name).
+ */
+
+import type { ModelEntry, RegisteredProvider, RouteResult, RouterConfig } from "./types";
+
+/** Resolve a ModelEntry to its client-facing name */
+function modelName(entry: ModelEntry): string {
+  return typeof entry === "string" ? entry : entry.name;
+}
+
+/** Resolve a ModelEntry to its upstream name */
+function upstreamModelName(entry: ModelEntry): string {
+  return typeof entry === "string" ? entry : entry.upstreamModel;
+}
+
+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 have this model (by client-facing name)
+    const candidates: Array<{ provider: RegisteredProvider; entry: ModelEntry }> = [];
+
+    for (const provider of this.providers) {
+      if (provider.enabled === false) continue;
+      const entry = provider.models.find((m) => modelName(m) === model);
+      if (entry) {
+        candidates.push({ provider, entry });
+      }
+    }
+
+    // Sort by priority
+    candidates.sort((a, b) => (a.provider.priority ?? 100) - (b.provider.priority ?? 100));
+
+    if (candidates.length > 0) {
+      const { provider, entry } = candidates[0];
+      return {
+        provider,
+        model,
+        upstreamModel: upstreamModelName(entry),
+      };
+    }
+
+    // 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, upstreamModel: model };
+      }
+    }
+
+    return null;
+  }
+
+  /**
+   * List all available models across all providers
+   */
+  listModels(): Array<{
+    model: string;
+    upstreamModel: string;
+    providerId: string;
+    protocol: string;
+  }> {
+    const models: Array<{
+      model: string;
+      upstreamModel: string;
+      providerId: string;
+      protocol: string;
+    }> = [];
+    for (const provider of this.providers) {
+      if (provider.enabled === false) continue;
+      for (const entry of provider.models) {
+        models.push({
+          model: modelName(entry),
+          upstreamModel: upstreamModelName(entry),
+          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,8 @@
+export { Router } from "./Router";
+export type {
+  ModelEntry,
+  ProviderProtocol,
+  RegisteredProvider,
+  RouteResult,
+  RouterConfig,
+} from "./types";

package/src/router/types.ts

@@ -0,0 +1,77 @@
+/**
+ * Router Types — routing configuration and model matching
+ */
+
+/**
+ * Supported upstream provider protocols
+ */
+export type ProviderProtocol = "openai-compatible" | "anthropic";
+
+/**
+ * Model entry — either a plain string or an object with upstream mapping
+ *
+ * Plain string: model name is the same on both sides
+ * Object: name is what clients request, upstreamModel is what the provider expects
+ *
+ * @example
+ * // Simple — same name both sides
+ * "gpt-4o"
+ *
+ * // Mapped — "deepseek-v3" externally, "ep-xxx" at the provider
+ * { name: "deepseek-v3", upstreamModel: "ep-20250101-xxx" }
+ */
+export type ModelEntry = string | { name: string; upstreamModel: string };
+
+/**
+ * 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: ModelEntry[];
+
+  /** 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 name as requested by the client */
+  model: string;
+
+  /** The model name to send to the upstream provider (may differ from model) */
+  upstreamModel: string;
+}
+
+/**
+ * Router configuration
+ */
+export interface RouterConfig {
+  /** Registered providers */
+  providers: RegisteredProvider[];
+
+  /** Default provider ID (fallback when no model match) */
+  defaultProviderId?: string;
+}