@cappasoft/openrouter-models 1.0.0

package/README.md

@@ -0,0 +1,24 @@
+# @cappasoft/openrouter-models
+
+Headless client for fetching and grouping OpenRouter models.
+
+## Installation
+
+```bash
+npm install @cappasoft/openrouter-models
+```
+
+## Usage
+
+```ts
+import { createOpenRouterModelsClient } from '@cappasoft/openrouter-models'
+
+const client = createOpenRouterModelsClient({
+  apiKey: 'sk-or-v1-...',
+})
+
+const { models, categories } = await client.listModels()
+console.log(models.length, categories.map((c) => c.name))
+```
+
+

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+interface OpenRouterModel {
+    id: string;
+    name: string;
+    description?: string;
+    context_length: number;
+    pricing: {
+        prompt: string;
+        completion: string;
+    };
+    top_provider?: {
+        max_completion_tokens?: number;
+    };
+    architecture?: {
+        modality: string;
+        tokenizer: string;
+        instruct_type?: string;
+    };
+}
+interface ModelCategory {
+    name: string;
+    models: OpenRouterModel[];
+}
+
+declare const DEFAULT_ENDPOINT = "https://openrouter.ai/api/v1/models";
+declare const CATEGORY_MAP: Record<string, string>;
+declare const RECOMMENDED_MODELS: readonly ["google/gemini-3-pro-preview", "openai/gpt-4o", "openai/gpt-4o-mini", "anthropic/claude-sonnet-4-20250514", "anthropic/claude-3.5-sonnet", "x-ai/grok-2-1212", "x-ai/grok-3-mini-beta", "google/gemini-2.0-flash-001", "deepseek/deepseek-chat", "deepseek/deepseek-r1", "meta-llama/llama-3.3-70b-instruct", "mistralai/mistral-large-2411"];
+declare const DEFAULT_CACHE_KEY = "openrouter_models_cache_v1";
+declare const DEFAULT_CACHE_TTL_MS: number;
+declare const DEFAULT_EXCLUDED_PATTERNS: RegExp[];
+declare const DEFAULT_CATEGORY_ORDER: readonly ["OpenAI", "Anthropic", "Google", "Meta", "Mistral", "DeepSeek", "Qwen", "xAI", "Cohere", "Perplexity", "NVIDIA", "Other"];
+
+declare function getCategory(modelId: string): string;
+declare function isModelExcluded(model: OpenRouterModel, excludedPatterns?: RegExp[]): boolean;
+declare function buildCategories(models: OpenRouterModel[], options?: {
+    includeAllCategories?: boolean;
+    categoryOrder?: readonly string[];
+}): ModelCategory[];
+declare function filterAndGroup(allModels: OpenRouterModel[], options?: {
+    filterToRecommended?: boolean;
+    includeAllCategories?: boolean;
+    recommendedModels?: readonly string[];
+    excludedPatterns?: RegExp[];
+}): {
+    filteredModels: OpenRouterModel[];
+    categoriesArray: ModelCategory[];
+};
+
+interface OpenRouterModelsClient {
+    listModels(): Promise<{
+        models: OpenRouterModel[];
+        categories: ModelCategory[];
+        lastUpdated: number | null;
+    }>;
+    refresh(): Promise<{
+        models: OpenRouterModel[];
+        categories: ModelCategory[];
+        lastUpdated: number | null;
+    }>;
+}
+interface CacheProvider {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    ttlMs?: number;
+    cacheKey?: string;
+}
+interface CreateOpenRouterModelsClientOptions {
+    apiKey: string;
+    endpoint?: string;
+    fetcher?: typeof fetch;
+    cache?: CacheProvider;
+}
+declare function createOpenRouterModelsClient(options: CreateOpenRouterModelsClientOptions): OpenRouterModelsClient;
+
+export { CATEGORY_MAP, type CacheProvider, type CreateOpenRouterModelsClientOptions, DEFAULT_CACHE_KEY, DEFAULT_CACHE_TTL_MS, DEFAULT_CATEGORY_ORDER, DEFAULT_ENDPOINT, DEFAULT_EXCLUDED_PATTERNS, type ModelCategory, type OpenRouterModel, type OpenRouterModelsClient, RECOMMENDED_MODELS, buildCategories, createOpenRouterModelsClient, filterAndGroup, getCategory, isModelExcluded };

package/dist/index.js

@@ -0,0 +1,192 @@
+// src/constants.ts
+var DEFAULT_ENDPOINT = "https://openrouter.ai/api/v1/models";
+var CATEGORY_MAP = {
+  openai: "OpenAI",
+  anthropic: "Anthropic",
+  google: "Google",
+  "meta-llama": "Meta",
+  mistralai: "Mistral",
+  deepseek: "DeepSeek",
+  cohere: "Cohere",
+  qwen: "Qwen",
+  "x-ai": "xAI",
+  perplexity: "Perplexity",
+  nvidia: "NVIDIA"
+};
+var RECOMMENDED_MODELS = [
+  "google/gemini-3-pro-preview",
+  "openai/gpt-4o",
+  "openai/gpt-4o-mini",
+  "anthropic/claude-sonnet-4-20250514",
+  "anthropic/claude-3.5-sonnet",
+  "x-ai/grok-2-1212",
+  "x-ai/grok-3-mini-beta",
+  "google/gemini-2.0-flash-001",
+  "deepseek/deepseek-chat",
+  "deepseek/deepseek-r1",
+  "meta-llama/llama-3.3-70b-instruct",
+  "mistralai/mistral-large-2411"
+];
+var DEFAULT_CACHE_KEY = "openrouter_models_cache_v1";
+var DEFAULT_CACHE_TTL_MS = 60 * 60 * 1e3;
+var DEFAULT_EXCLUDED_PATTERNS = [
+  /vision/i,
+  /image/i,
+  /audio/i,
+  // :free models are now allowed as some are high quality previews
+  /:beta$/,
+  /extended$/
+];
+var DEFAULT_CATEGORY_ORDER = [
+  "OpenAI",
+  "Anthropic",
+  "Google",
+  "Meta",
+  "Mistral",
+  "DeepSeek",
+  "Qwen",
+  "xAI",
+  "Cohere",
+  "Perplexity",
+  "NVIDIA",
+  "Other"
+];
+
+// src/grouping.ts
+function getCategory(modelId) {
+  const prefix = modelId.split("/")[0];
+  return CATEGORY_MAP[prefix] || "Other";
+}
+function isModelExcluded(model, excludedPatterns = DEFAULT_EXCLUDED_PATTERNS) {
+  return excludedPatterns.some((pattern) => pattern.test(model.id));
+}
+function buildCategories(models, options) {
+  const categoryMap = /* @__PURE__ */ new Map();
+  const categoryOrder = options?.categoryOrder ?? DEFAULT_CATEGORY_ORDER;
+  for (const model of models) {
+    const category = getCategory(model.id);
+    if (!options?.includeAllCategories && !Object.values(CATEGORY_MAP).includes(category)) {
+      continue;
+    }
+    if (!categoryMap.has(category)) categoryMap.set(category, []);
+    categoryMap.get(category).push(model);
+  }
+  const categoriesArray = [];
+  for (const catName of categoryOrder) {
+    const catModels = categoryMap.get(catName);
+    if (catModels && catModels.length > 0) {
+      categoriesArray.push({ name: catName, models: catModels });
+    }
+  }
+  for (const [catName, catModels] of categoryMap) {
+    if (!categoryOrder.includes(catName) && catModels.length > 0) {
+      categoriesArray.push({ name: catName, models: catModels });
+    }
+  }
+  return categoriesArray;
+}
+function filterAndGroup(allModels, options) {
+  const excludedPatterns = options?.excludedPatterns ?? DEFAULT_EXCLUDED_PATTERNS;
+  let filteredModels = allModels.filter((m) => !isModelExcluded(m, excludedPatterns));
+  const recommendedList = options?.recommendedModels ?? RECOMMENDED_MODELS;
+  if (options?.filterToRecommended) {
+    const recommendedSet = new Set(recommendedList);
+    filteredModels = filteredModels.filter((m) => recommendedSet.has(m.id));
+    filteredModels.sort((a, b) => recommendedList.indexOf(a.id) - recommendedList.indexOf(b.id));
+  } else {
+    filteredModels.sort((a, b) => a.name.localeCompare(b.name));
+  }
+  const categoriesArray = buildCategories(filteredModels, { includeAllCategories: options?.includeAllCategories });
+  return { filteredModels, categoriesArray };
+}
+
+// src/client.ts
+function defaultCacheProvider() {
+  try {
+    if (typeof window === "undefined") return null;
+    if (!("localStorage" in window)) return null;
+    return {
+      get: (key) => window.localStorage.getItem(key),
+      set: (key, value) => window.localStorage.setItem(key, value),
+      ttlMs: DEFAULT_CACHE_TTL_MS,
+      cacheKey: DEFAULT_CACHE_KEY
+    };
+  } catch {
+    return null;
+  }
+}
+function getRecommendedHeaders() {
+  const headers = {};
+  try {
+    if (typeof window !== "undefined") {
+      headers["HTTP-Referer"] = window.location.origin;
+      headers["X-Title"] = document.title || "App";
+    }
+  } catch {
+  }
+  return headers;
+}
+function createOpenRouterModelsClient(options) {
+  const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;
+  const fetcher = options.fetcher ?? fetch;
+  const cache = options.cache ?? defaultCacheProvider();
+  const cacheKey = cache?.cacheKey ?? DEFAULT_CACHE_KEY;
+  const ttlMs = cache?.ttlMs ?? DEFAULT_CACHE_TTL_MS;
+  const readCache = () => {
+    if (!cache) return null;
+    try {
+      const raw = cache.get(cacheKey);
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      if (!parsed?.ts || !Array.isArray(parsed.data)) return null;
+      if (Date.now() - parsed.ts > ttlMs) return null;
+      return parsed;
+    } catch {
+      return null;
+    }
+  };
+  const writeCache = (models) => {
+    if (!cache) return;
+    try {
+      cache.set(cacheKey, JSON.stringify({ data: models, ts: Date.now() }));
+    } catch {
+    }
+  };
+  const fetchModels = async (force) => {
+    if (!force) {
+      const cached = readCache();
+      if (cached) return { models: cached.data, lastUpdated: cached.ts };
+    }
+    const headers = {
+      Authorization: `Bearer ${options.apiKey}`,
+      ...getRecommendedHeaders()
+    };
+    const response = await fetcher(endpoint, { headers });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new Error(`Failed to fetch models: ${response.status}${text ? ` - ${text}` : ""}`);
+    }
+    const json = await response.json();
+    const models = json.data ?? [];
+    writeCache(models);
+    return { models, lastUpdated: Date.now() };
+  };
+  const toResult = (models, lastUpdated) => {
+    const { categoriesArray } = filterAndGroup(models, { filterToRecommended: false, includeAllCategories: true });
+    return { models, categories: categoriesArray, lastUpdated };
+  };
+  return {
+    async listModels() {
+      const { models, lastUpdated } = await fetchModels(false);
+      return toResult(models, lastUpdated);
+    },
+    async refresh() {
+      const { models, lastUpdated } = await fetchModels(true);
+      return toResult(models, lastUpdated);
+    }
+  };
+}
+
+export { CATEGORY_MAP, DEFAULT_CACHE_KEY, DEFAULT_CACHE_TTL_MS, DEFAULT_CATEGORY_ORDER, DEFAULT_ENDPOINT, DEFAULT_EXCLUDED_PATTERNS, RECOMMENDED_MODELS, buildCategories, createOpenRouterModelsClient, filterAndGroup, getCategory, isModelExcluded };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/grouping.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const DEFAULT_ENDPOINT = \"https://openrouter.ai/api/v1/models\"\n\n// Mapping from model ID prefix to category\nexport const CATEGORY_MAP: Record<string, string> = {\n  openai: \"OpenAI\",\n  anthropic: \"Anthropic\",\n  google: \"Google\",\n  \"meta-llama\": \"Meta\",\n  mistralai: \"Mistral\",\n  deepseek: \"DeepSeek\",\n  cohere: \"Cohere\",\n  qwen: \"Qwen\",\n  \"x-ai\": \"xAI\",\n  perplexity: \"Perplexity\",\n  nvidia: \"NVIDIA\",\n}\n\n// Recommended models to show first (in order of preference)\nexport const RECOMMENDED_MODELS = [\n  \"google/gemini-3-pro-preview\",\n  \"openai/gpt-4o\",\n  \"openai/gpt-4o-mini\",\n  \"anthropic/claude-sonnet-4-20250514\",\n  \"anthropic/claude-3.5-sonnet\",\n  \"x-ai/grok-2-1212\",\n  \"x-ai/grok-3-mini-beta\",\n  \"google/gemini-2.0-flash-001\",\n  \"deepseek/deepseek-chat\",\n  \"deepseek/deepseek-r1\",\n  \"meta-llama/llama-3.3-70b-instruct\",\n  \"mistralai/mistral-large-2411\",\n] as const\n\nexport const DEFAULT_CACHE_KEY = \"openrouter_models_cache_v1\"\nexport const DEFAULT_CACHE_TTL_MS = 60 * 60 * 1000 // 1h\n\n// Models to exclude (deprecated, vision-only, etc.)\nexport const DEFAULT_EXCLUDED_PATTERNS: RegExp[] = [\n  /vision/i,\n  /image/i,\n  /audio/i,\n  // :free models are now allowed as some are high quality previews\n  /:beta$/,\n  /extended$/,\n]\n\nexport const DEFAULT_CATEGORY_ORDER = [\n  \"OpenAI\",\n  \"Anthropic\",\n  \"Google\",\n  \"Meta\",\n  \"Mistral\",\n  \"DeepSeek\",\n  \"Qwen\",\n  \"xAI\",\n  \"Cohere\",\n  \"Perplexity\",\n  \"NVIDIA\",\n  \"Other\",\n] as const\n\n\n","import type { ModelCategory, OpenRouterModel } from \"./types\"\nimport { CATEGORY_MAP, DEFAULT_CATEGORY_ORDER, DEFAULT_EXCLUDED_PATTERNS, RECOMMENDED_MODELS } from \"./constants\"\n\nexport function getCategory(modelId: string): string {\n  const prefix = modelId.split(\"/\")[0]\n  return CATEGORY_MAP[prefix] || \"Other\"\n}\n\nexport function isModelExcluded(model: OpenRouterModel, excludedPatterns: RegExp[] = DEFAULT_EXCLUDED_PATTERNS): boolean {\n  return excludedPatterns.some((pattern) => pattern.test(model.id))\n}\n\nexport function buildCategories(\n  models: OpenRouterModel[],\n  options?: { includeAllCategories?: boolean; categoryOrder?: readonly string[] }\n): ModelCategory[] {\n  const categoryMap = new Map<string, OpenRouterModel[]>()\n  const categoryOrder = options?.categoryOrder ?? DEFAULT_CATEGORY_ORDER\n\n  for (const model of models) {\n    const category = getCategory(model.id)\n\n    if (!options?.includeAllCategories && !Object.values(CATEGORY_MAP).includes(category)) {\n      continue\n    }\n\n    if (!categoryMap.has(category)) categoryMap.set(category, [])\n    categoryMap.get(category)!.push(model)\n  }\n\n  // Convert to array and sort by predefined order\n  const categoriesArray: ModelCategory[] = []\n  for (const catName of categoryOrder) {\n    const catModels = categoryMap.get(catName)\n    if (catModels && catModels.length > 0) {\n      categoriesArray.push({ name: catName, models: catModels })\n    }\n  }\n\n  // Add any remaining categories not in the predefined order\n  for (const [catName, catModels] of categoryMap) {\n    if (!categoryOrder.includes(catName) && catModels.length > 0) {\n      categoriesArray.push({ name: catName, models: catModels })\n    }\n  }\n\n  return categoriesArray\n}\n\nexport function filterAndGroup(\n  allModels: OpenRouterModel[],\n  options?: {\n    filterToRecommended?: boolean\n    includeAllCategories?: boolean\n    recommendedModels?: readonly string[]\n    excludedPatterns?: RegExp[]\n  }\n) {\n  const excludedPatterns = options?.excludedPatterns ?? DEFAULT_EXCLUDED_PATTERNS\n\n  let filteredModels = allModels.filter((m) => !isModelExcluded(m, excludedPatterns))\n\n  const recommendedList = options?.recommendedModels ?? RECOMMENDED_MODELS\n  if (options?.filterToRecommended) {\n    const recommendedSet = new Set(recommendedList)\n    filteredModels = filteredModels.filter((m) => recommendedSet.has(m.id))\n    filteredModels.sort((a, b) => recommendedList.indexOf(a.id) - recommendedList.indexOf(b.id))\n  } else {\n    filteredModels.sort((a, b) => a.name.localeCompare(b.name))\n  }\n\n  const categoriesArray = buildCategories(filteredModels, { includeAllCategories: options?.includeAllCategories })\n  return { filteredModels, categoriesArray }\n}\n\n\n","import type { ModelCategory, OpenRouterModel } from \"./types\"\nimport { DEFAULT_CACHE_KEY, DEFAULT_CACHE_TTL_MS, DEFAULT_ENDPOINT } from \"./constants\"\nimport { filterAndGroup } from \"./grouping\"\n\nexport interface OpenRouterModelsClient {\n  listModels(): Promise<{\n    models: OpenRouterModel[]\n    categories: ModelCategory[]\n    lastUpdated: number | null\n  }>\n  refresh(): Promise<{\n    models: OpenRouterModel[]\n    categories: ModelCategory[]\n    lastUpdated: number | null\n  }>\n}\n\nexport interface CacheProvider {\n  get(key: string): string | null\n  set(key: string, value: string): void\n  ttlMs?: number\n  cacheKey?: string\n}\n\nexport interface CreateOpenRouterModelsClientOptions {\n  apiKey: string\n  endpoint?: string\n  fetcher?: typeof fetch\n  cache?: CacheProvider\n}\n\nfunction defaultCacheProvider(): CacheProvider | null {\n  try {\n    if (typeof window === \"undefined\") return null\n    if (!(\"localStorage\" in window)) return null\n    return {\n      get: (key) => window.localStorage.getItem(key),\n      set: (key, value) => window.localStorage.setItem(key, value),\n      ttlMs: DEFAULT_CACHE_TTL_MS,\n      cacheKey: DEFAULT_CACHE_KEY,\n    }\n  } catch {\n    return null\n  }\n}\n\nfunction getRecommendedHeaders(): Record<string, string> {\n  const headers: Record<string, string> = {}\n  try {\n    if (typeof window !== \"undefined\") {\n      headers[\"HTTP-Referer\"] = window.location.origin\n      headers[\"X-Title\"] = document.title || \"App\"\n    }\n  } catch {\n    // ignore\n  }\n  return headers\n}\n\nexport function createOpenRouterModelsClient(options: CreateOpenRouterModelsClientOptions): OpenRouterModelsClient {\n  const endpoint = options.endpoint ?? DEFAULT_ENDPOINT\n  const fetcher = options.fetcher ?? fetch\n  const cache = options.cache ?? defaultCacheProvider()\n  const cacheKey = cache?.cacheKey ?? DEFAULT_CACHE_KEY\n  const ttlMs = cache?.ttlMs ?? DEFAULT_CACHE_TTL_MS\n\n  const readCache = (): { data: OpenRouterModel[]; ts: number } | null => {\n    if (!cache) return null\n    try {\n      const raw = cache.get(cacheKey)\n      if (!raw) return null\n      const parsed = JSON.parse(raw) as { data: OpenRouterModel[]; ts: number }\n      if (!parsed?.ts || !Array.isArray(parsed.data)) return null\n      if (Date.now() - parsed.ts > ttlMs) return null\n      return parsed\n    } catch {\n      return null\n    }\n  }\n\n  const writeCache = (models: OpenRouterModel[]) => {\n    if (!cache) return\n    try {\n      cache.set(cacheKey, JSON.stringify({ data: models, ts: Date.now() }))\n    } catch {\n      // ignore cache write failures\n    }\n  }\n\n  const fetchModels = async (force: boolean): Promise<{ models: OpenRouterModel[]; lastUpdated: number | null }> => {\n    if (!force) {\n      const cached = readCache()\n      if (cached) return { models: cached.data, lastUpdated: cached.ts }\n    }\n\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${options.apiKey}`,\n      ...getRecommendedHeaders(),\n    }\n\n    const response = await fetcher(endpoint, { headers })\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\")\n      throw new Error(`Failed to fetch models: ${response.status}${text ? ` - ${text}` : \"\"}`)\n    }\n\n    const json = (await response.json()) as { data?: OpenRouterModel[] }\n    const models = json.data ?? []\n    writeCache(models)\n    return { models, lastUpdated: Date.now() }\n  }\n\n  const toResult = (models: OpenRouterModel[], lastUpdated: number | null) => {\n    const { categoriesArray } = filterAndGroup(models, { filterToRecommended: false, includeAllCategories: true })\n    return { models, categories: categoriesArray, lastUpdated }\n  }\n\n  return {\n    async listModels() {\n      const { models, lastUpdated } = await fetchModels(false)\n      return toResult(models, lastUpdated)\n    },\n    async refresh() {\n      const { models, lastUpdated } = await fetchModels(true)\n      return toResult(models, lastUpdated)\n    },\n  }\n}\n\n\n"]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@cappasoft/openrouter-models",
+  "version": "1.0.0",
+  "description": "Headless client for fetching and managing OpenRouter models",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": [
+    "openrouter",
+    "llm",
+    "models",
+    "api"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ecappa/openrouter-model-selector.git",
+    "directory": "packages/openrouter-models"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3"
+  }
+}