@x12i/ai-tools 1.0.2 → 1.0.3

package/dist/types-BYXnCvKx.d.ts

@@ -0,0 +1,137 @@
+/** OpenRouter Models API — https://openrouter.ai/api/v1/models */
+type OpenRouterOutputModality = "text" | "image" | "audio" | "embeddings" | "video" | "speech" | "transcription" | "all";
+type OpenRouterModelsQuery = {
+    /** Comma-separated or "all" — default on our sync is "all". */
+    output_modalities?: string;
+    supported_parameters?: string;
+};
+type OpenRouterPricingApi = {
+    prompt: string;
+    completion: string;
+    request: string;
+    image: string;
+    web_search?: string;
+    internal_reasoning?: string;
+    input_cache_read?: string;
+    input_cache_write?: string;
+};
+type OpenRouterArchitectureApi = {
+    modality?: string;
+    input_modalities: string[];
+    output_modalities: string[];
+    tokenizer: string;
+    instruct_type: string | null;
+};
+type OpenRouterTopProviderApi = {
+    context_length: number;
+    max_completion_tokens: number | null;
+    is_moderated: boolean;
+};
+type OpenRouterDefaultParametersApi = {
+    temperature?: number | null;
+    top_p?: number | null;
+    top_k?: number | null;
+    frequency_penalty?: number | null;
+    presence_penalty?: number | null;
+    repetition_penalty?: number | null;
+};
+type OpenRouterModelApi = {
+    id: string;
+    canonical_slug: string;
+    hugging_face_id?: string | null;
+    name: string;
+    created: number;
+    description: string;
+    context_length: number;
+    architecture: OpenRouterArchitectureApi;
+    pricing: OpenRouterPricingApi;
+    top_provider: OpenRouterTopProviderApi;
+    per_request_limits: unknown | null;
+    supported_parameters: string[];
+    default_parameters: OpenRouterDefaultParametersApi | null;
+    supported_voices?: unknown | null;
+    knowledge_cutoff?: string | null;
+    expiration_date?: string | null;
+    links?: {
+        details?: string;
+    } | null;
+};
+type OpenRouterModelsResponse = {
+    data: OpenRouterModelApi[];
+};
+
+type AiModelPricing = {
+    promptUsdPerToken: number;
+    completionUsdPerToken: number;
+    imageUsdPerUnit: number;
+    requestUsdPerRequest: number;
+    cacheReadUsdPerToken?: number;
+    cacheWriteUsdPerToken?: number;
+    reasoningUsdPerToken?: number;
+    webSearchUsdPerRequest?: number;
+    openRouterMarkupUsdPerInputToken?: number;
+    openRouterMarkupUsdPerOutputToken?: number;
+    pricedAt: string;
+    source: "openrouter" | "direct" | "manual";
+};
+/**
+ * Canonical catalog record — mirrors OpenRouter Models API fields plus normalized pricing.
+ * Stored as-is in Catalox `data`; scalar fields duplicated in `indexed` for queries.
+ */
+type AiModelRecord = {
+    modelId: string;
+    name: string;
+    providerId: string;
+    canonicalSlug: string;
+    status: "active" | "deprecated" | "unknown";
+    description: string;
+    created: number;
+    expirationDate: string | null;
+    contextLength: number;
+    maxCompletionTokens: number | null;
+    isModerated: boolean;
+    modality: string;
+    inputModalities: string[];
+    outputModalities: string[];
+    tokenizer: string;
+    instructType: string | null;
+    supportedParameters: string[];
+    defaultParameters: OpenRouterDefaultParametersApi | null;
+    perRequestLimits: unknown | null;
+    pricing: AiModelPricing;
+    /** Raw OpenRouter pricing strings (USD per token/request/unit). */
+    openRouterPricing: OpenRouterPricingApi;
+    architecture: OpenRouterArchitectureApi;
+    topProvider: OpenRouterTopProviderApi;
+    /** Full OpenRouter API object — complete mirror for forward compatibility. */
+    openRouter: OpenRouterModelApi;
+    aliases: string[];
+    availableOnOpenRouter: boolean;
+    supportsStreaming: boolean;
+    supportsTools: boolean;
+    /** Exposes reasoning/thinking tokens (OpenRouter `reasoning` param and/or `internal_reasoning` pricing). */
+    supportsReasoning: boolean;
+    primaryOutputModality: string;
+    syncedAt: string;
+    syncSource: "openrouter" | "manual";
+};
+type ModelListFilters = {
+    providerId?: string;
+    status?: AiModelRecord["status"];
+    outputModality?: string;
+    inputModality?: string;
+    supportedParameter?: string;
+    supportsTools?: boolean;
+    supportsReasoning?: boolean;
+    search?: string;
+    limit?: number;
+    offset?: number;
+};
+type ModelListResult = {
+    models: AiModelRecord[];
+    total: number;
+    limit: number;
+    offset: number;
+};
+
+export type { AiModelPricing as A, ModelListFilters as M, OpenRouterArchitectureApi as O, AiModelRecord as a, ModelListResult as b, OpenRouterModelApi as c, OpenRouterModelsQuery as d, OpenRouterModelsResponse as e, OpenRouterOutputModality as f, OpenRouterPricingApi as g, OpenRouterTopProviderApi as h };

package/dist/types-CX6QFNNy.d.cts

@@ -0,0 +1,144 @@
+import { a as AiModelRecord } from './types-BYXnCvKx.cjs';
+
+type AliasEntry = {
+    modelId: string;
+    provider: string;
+    description?: string;
+    tags?: string[];
+    addedAt: string;
+    updatedAt: string;
+};
+type AliasFileSchema = {
+    $schema?: string;
+    version: 1;
+    updatedAt: string;
+    aliases: Record<string, AliasEntry>;
+};
+type ResolvedModelRef = {
+    alias: string;
+    entry: AliasEntry;
+    modelRecord: AiModelRecord | null;
+    modelId: string;
+    provider: string;
+    name: string;
+};
+type AliasValidationReport = {
+    total: number;
+    ok: number;
+    unknown: number;
+    broken: number;
+    entries: Array<{
+        name: string;
+        status: "ok" | "unknown" | "broken";
+        modelId: string;
+        resolvedName?: string;
+        issue?: string;
+    }>;
+};
+
+type AliasRegistryOptions = {
+    aliasesPath?: string;
+};
+declare class AliasRegistry {
+    private readonly aliasesPath;
+    constructor(options?: AliasRegistryOptions);
+    get path(): string;
+    exists(): boolean;
+    init(): void;
+    load(): AliasFileSchema;
+    get(aliasName: string): AliasEntry | null;
+    list(filter?: {
+        tag?: string;
+    }): Array<{
+        name: string;
+    } & AliasEntry>;
+    set(aliasName: string, entry: Omit<AliasEntry, "addedAt" | "updatedAt">): AliasEntry;
+    remove(aliasName: string): boolean;
+    rename(from: string, to: string, options?: {
+        force?: boolean;
+    }): void;
+    private writeFile;
+}
+
+/**
+ * Env naming for vendor direct API keys: `{VENDOR}_API_KEY`
+ * where VENDOR is the provider id in UPPER_SNAKE (hyphens → underscores).
+ *
+ * Examples: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `META_LLAMA_API_KEY`, `X_AI_API_KEY`
+ */
+declare function providerIdToEnvKeyPrefix(providerId: string): string;
+declare function vendorApiKeyEnvName(providerId: string): string;
+type OpenRouterRoutingConfig = {
+    /** OPENROUTER_API_KEY is set and non-empty */
+    hasOpenRouterKey: boolean;
+    /** USE_OPENROUTER=true or USE_OPENROUTER=1 */
+    useOpenRouterExplicit: boolean;
+    /** Read `{PROVIDER}_API_KEY` for a catalog provider id */
+    getVendorApiKey(providerId: string): string | undefined;
+};
+/**
+ * Load routing hints from process env and optional `.env` (via @x12/env).
+ */
+declare function loadOpenRouterRoutingEnv(env?: Record<string, string | undefined>): OpenRouterRoutingConfig;
+/**
+ * Default route via OpenRouter when:
+ * 1. OPENROUTER_API_KEY is set AND USE_OPENROUTER=true|1, or
+ * 2. OPENROUTER_API_KEY is set AND the vendor's `{VENDOR}_API_KEY` is missing.
+ */
+declare function shouldDefaultRouteViaOpenRouter(providerId: string | undefined, config: OpenRouterRoutingConfig): boolean;
+
+type ModelResolutionInput = {
+    /** Provider hint (openrouter, openai, anthropic, …). May be omitted. */
+    provider?: string;
+    /** Model id, alias, shorthand, or partial name. Required. */
+    model: string;
+};
+type ResolutionStrategy = "alias-registry" | "alias-as-provider-correction" | "exact-match" | "catalog-alias-match" | "canonical-slug-match" | "provider-prefix-injection" | "cross-provider-correction" | "version-suffix-strip" | "date-suffix-strip" | "shorthand-expansion" | "partial-name-match" | "local-provider-passthrough";
+type ModelResolutionSuccess = {
+    found: true;
+    modelId: string;
+    record: AiModelRecord | null;
+    routedViaOpenRouter: boolean;
+    confidence: number;
+    resolvedVia: ResolutionStrategy[];
+    resolvedReason: string;
+    normalisedInput: string;
+};
+type ModelResolutionNotFound = {
+    found: false;
+    modelId: null;
+    record: null;
+    attemptedStrategies: ResolutionStrategy[];
+    bestRejectedCandidate?: {
+        modelId: string;
+        confidence: number;
+        reason: string;
+    };
+    reason: string;
+};
+type ModelResolutionResult = ModelResolutionSuccess | ModelResolutionNotFound;
+type ModelResolverOptions = {
+    confidenceThreshold?: number;
+    aliasRegistry?: AliasRegistry;
+    additionalShorthands?: Record<string, string>;
+    additionalProviderPatterns?: Array<{
+        pattern: RegExp;
+        provider: string;
+    }>;
+    additionalLocalProviders?: string[];
+    /** Env-based OpenRouter vs direct routing. Defaults to loadOpenRouterRoutingEnv(). */
+    routingEnv?: OpenRouterRoutingConfig;
+};
+type CatalogIndexes = {
+    aliasIndex: Map<string, string>;
+    slugIndex: Map<string, string>;
+    providerPrefixesBySize: string[];
+};
+/** @deprecated Use ModelResolutionSuccess via ModelNameResolver */
+type ResolvedModel = {
+    catalogModel: AiModelRecord;
+    matchedAlias: string;
+    routedViaOpenRouter: boolean;
+};
+
+export { type AliasEntry as A, type CatalogIndexes as C, type ModelResolutionInput as M, type OpenRouterRoutingConfig as O, type ResolutionStrategy as R, type AliasFileSchema as a, AliasRegistry as b, type AliasRegistryOptions as c, type AliasValidationReport as d, type ModelResolutionNotFound as e, type ModelResolutionResult as f, type ModelResolutionSuccess as g, type ModelResolverOptions as h, type ResolvedModel as i, type ResolvedModelRef as j, loadOpenRouterRoutingEnv as l, providerIdToEnvKeyPrefix as p, shouldDefaultRouteViaOpenRouter as s, vendorApiKeyEnvName as v };

package/dist/types-CuiPDcVs.d.ts

@@ -0,0 +1,144 @@
+import { a as AiModelRecord } from './types-BYXnCvKx.js';
+
+type AliasEntry = {
+    modelId: string;
+    provider: string;
+    description?: string;
+    tags?: string[];
+    addedAt: string;
+    updatedAt: string;
+};
+type AliasFileSchema = {
+    $schema?: string;
+    version: 1;
+    updatedAt: string;
+    aliases: Record<string, AliasEntry>;
+};
+type ResolvedModelRef = {
+    alias: string;
+    entry: AliasEntry;
+    modelRecord: AiModelRecord | null;
+    modelId: string;
+    provider: string;
+    name: string;
+};
+type AliasValidationReport = {
+    total: number;
+    ok: number;
+    unknown: number;
+    broken: number;
+    entries: Array<{
+        name: string;
+        status: "ok" | "unknown" | "broken";
+        modelId: string;
+        resolvedName?: string;
+        issue?: string;
+    }>;
+};
+
+type AliasRegistryOptions = {
+    aliasesPath?: string;
+};
+declare class AliasRegistry {
+    private readonly aliasesPath;
+    constructor(options?: AliasRegistryOptions);
+    get path(): string;
+    exists(): boolean;
+    init(): void;
+    load(): AliasFileSchema;
+    get(aliasName: string): AliasEntry | null;
+    list(filter?: {
+        tag?: string;
+    }): Array<{
+        name: string;
+    } & AliasEntry>;
+    set(aliasName: string, entry: Omit<AliasEntry, "addedAt" | "updatedAt">): AliasEntry;
+    remove(aliasName: string): boolean;
+    rename(from: string, to: string, options?: {
+        force?: boolean;
+    }): void;
+    private writeFile;
+}
+
+/**
+ * Env naming for vendor direct API keys: `{VENDOR}_API_KEY`
+ * where VENDOR is the provider id in UPPER_SNAKE (hyphens → underscores).
+ *
+ * Examples: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `META_LLAMA_API_KEY`, `X_AI_API_KEY`
+ */
+declare function providerIdToEnvKeyPrefix(providerId: string): string;
+declare function vendorApiKeyEnvName(providerId: string): string;
+type OpenRouterRoutingConfig = {
+    /** OPENROUTER_API_KEY is set and non-empty */
+    hasOpenRouterKey: boolean;
+    /** USE_OPENROUTER=true or USE_OPENROUTER=1 */
+    useOpenRouterExplicit: boolean;
+    /** Read `{PROVIDER}_API_KEY` for a catalog provider id */
+    getVendorApiKey(providerId: string): string | undefined;
+};
+/**
+ * Load routing hints from process env and optional `.env` (via @x12/env).
+ */
+declare function loadOpenRouterRoutingEnv(env?: Record<string, string | undefined>): OpenRouterRoutingConfig;
+/**
+ * Default route via OpenRouter when:
+ * 1. OPENROUTER_API_KEY is set AND USE_OPENROUTER=true|1, or
+ * 2. OPENROUTER_API_KEY is set AND the vendor's `{VENDOR}_API_KEY` is missing.
+ */
+declare function shouldDefaultRouteViaOpenRouter(providerId: string | undefined, config: OpenRouterRoutingConfig): boolean;
+
+type ModelResolutionInput = {
+    /** Provider hint (openrouter, openai, anthropic, …). May be omitted. */
+    provider?: string;
+    /** Model id, alias, shorthand, or partial name. Required. */
+    model: string;
+};
+type ResolutionStrategy = "alias-registry" | "alias-as-provider-correction" | "exact-match" | "catalog-alias-match" | "canonical-slug-match" | "provider-prefix-injection" | "cross-provider-correction" | "version-suffix-strip" | "date-suffix-strip" | "shorthand-expansion" | "partial-name-match" | "local-provider-passthrough";
+type ModelResolutionSuccess = {
+    found: true;
+    modelId: string;
+    record: AiModelRecord | null;
+    routedViaOpenRouter: boolean;
+    confidence: number;
+    resolvedVia: ResolutionStrategy[];
+    resolvedReason: string;
+    normalisedInput: string;
+};
+type ModelResolutionNotFound = {
+    found: false;
+    modelId: null;
+    record: null;
+    attemptedStrategies: ResolutionStrategy[];
+    bestRejectedCandidate?: {
+        modelId: string;
+        confidence: number;
+        reason: string;
+    };
+    reason: string;
+};
+type ModelResolutionResult = ModelResolutionSuccess | ModelResolutionNotFound;
+type ModelResolverOptions = {
+    confidenceThreshold?: number;
+    aliasRegistry?: AliasRegistry;
+    additionalShorthands?: Record<string, string>;
+    additionalProviderPatterns?: Array<{
+        pattern: RegExp;
+        provider: string;
+    }>;
+    additionalLocalProviders?: string[];
+    /** Env-based OpenRouter vs direct routing. Defaults to loadOpenRouterRoutingEnv(). */
+    routingEnv?: OpenRouterRoutingConfig;
+};
+type CatalogIndexes = {
+    aliasIndex: Map<string, string>;
+    slugIndex: Map<string, string>;
+    providerPrefixesBySize: string[];
+};
+/** @deprecated Use ModelResolutionSuccess via ModelNameResolver */
+type ResolvedModel = {
+    catalogModel: AiModelRecord;
+    matchedAlias: string;
+    routedViaOpenRouter: boolean;
+};
+
+export { type AliasEntry as A, type CatalogIndexes as C, type ModelResolutionInput as M, type OpenRouterRoutingConfig as O, type ResolutionStrategy as R, type AliasFileSchema as a, AliasRegistry as b, type AliasRegistryOptions as c, type AliasValidationReport as d, type ModelResolutionNotFound as e, type ModelResolutionResult as f, type ModelResolutionSuccess as g, type ModelResolverOptions as h, type ResolvedModel as i, type ResolvedModelRef as j, loadOpenRouterRoutingEnv as l, providerIdToEnvKeyPrefix as p, shouldDefaultRouteViaOpenRouter as s, vendorApiKeyEnvName as v };

package/dist/upsertAiModelRecord-C831wOIF.d.ts

@@ -0,0 +1,35 @@
+import { Firestore } from 'firebase-admin/firestore';
+import { CataloxContext } from '@x12i/catalox';
+import { a as AiModelRecord } from './types-BYXnCvKx.js';
+
+/** Firestore rejects `undefined` — strip before write. */
+declare function sanitizeForFirestore<T>(value: T): T;
+type UpsertAiModelRecordOptions = {
+    firestore: Firestore;
+    context: CataloxContext;
+    catalogId: string;
+    record: AiModelRecord;
+};
+/**
+ * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).
+ */
+declare function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void>;
+type BatchUpsertProgress = {
+    completed: number;
+    total: number;
+    phase: "loading-existing" | "writing";
+};
+type BatchUpsertAiModelRecordsOptions = {
+    onProgress?: (progress: BatchUpsertProgress) => void;
+    maxChunkRetries?: number;
+};
+type BatchUpsertResult = {
+    upserted: number;
+    failed: Array<{
+        modelId: string;
+        error: string;
+    }>;
+};
+declare function batchUpsertAiModelRecords(firestore: Firestore, catalogId: string, context: CataloxContext, records: AiModelRecord[], batchOptions?: BatchUpsertAiModelRecordsOptions): Promise<BatchUpsertResult>;
+
+export { type BatchUpsertProgress as B, batchUpsertAiModelRecords as b, sanitizeForFirestore as s, upsertAiModelRecord as u };

package/dist/upsertAiModelRecord-CjY-sny0.d.cts

@@ -0,0 +1,35 @@
+import { Firestore } from 'firebase-admin/firestore';
+import { CataloxContext } from '@x12i/catalox';
+import { a as AiModelRecord } from './types-BYXnCvKx.cjs';
+
+/** Firestore rejects `undefined` — strip before write. */
+declare function sanitizeForFirestore<T>(value: T): T;
+type UpsertAiModelRecordOptions = {
+    firestore: Firestore;
+    context: CataloxContext;
+    catalogId: string;
+    record: AiModelRecord;
+};
+/**
+ * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).
+ */
+declare function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void>;
+type BatchUpsertProgress = {
+    completed: number;
+    total: number;
+    phase: "loading-existing" | "writing";
+};
+type BatchUpsertAiModelRecordsOptions = {
+    onProgress?: (progress: BatchUpsertProgress) => void;
+    maxChunkRetries?: number;
+};
+type BatchUpsertResult = {
+    upserted: number;
+    failed: Array<{
+        modelId: string;
+        error: string;
+    }>;
+};
+declare function batchUpsertAiModelRecords(firestore: Firestore, catalogId: string, context: CataloxContext, records: AiModelRecord[], batchOptions?: BatchUpsertAiModelRecordsOptions): Promise<BatchUpsertResult>;
+
+export { type BatchUpsertProgress as B, batchUpsertAiModelRecords as b, sanitizeForFirestore as s, upsertAiModelRecord as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-tools",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "AI model catalog, cost calculation, and LLM utility belt backed by Catalox",
   "license": "MIT",
   "type": "module",
@@ -45,6 +45,11 @@
       "types": "./dist/models/index.d.ts",
       "import": "./dist/models/index.js",
       "require": "./dist/models/index.cjs"
+    },
+    "./catalog": {
+      "types": "./dist/catalog/index.d.ts",
+      "import": "./dist/catalog/index.js",
+      "require": "./dist/catalog/index.cjs"
     }
   },
   "files": [
@@ -63,6 +68,8 @@
     "test:coverage": "vitest run --coverage",
     "seed": "tsx scripts/seed.ts",
     "seed:verbose": "tsx scripts/seed.ts --verbose",
+    "verify:sync": "tsx scripts/verify-catalog-sync.ts",
+    "verify:seed": "tsx scripts/verify-catalog-sync.ts --sync",
     "prepublishOnly": "npm run build && npm test"
   },
   "peerDependencies": {

package/dist/chunk-HHNHWYTP.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/ami/Documents/prometheus/x12i/ai-tools/dist/chunk-HHNHWYTP.cjs","../src/catalox/modelDocId.ts","../src/catalox/upsertAiModelRecord.ts"],"names":[],"mappings":"AAAA;ACIA,IAAM,GAAA,EAAK,KAAA;AACX,IAAM,aAAA,EAAe,IAAA;AAEd,SAAS,yBAAA,CAA0B,OAAA,EAAyB;AACjE,EAAA,GAAA,CAAI,CAAC,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,EAAG,OAAO,OAAA;AACnC,EAAA,OAAO,CAAA,EAAA;AACT;AAEgB;AACR,EAAA;AACF,EAAA;AACF,IAAA;AACF,EAAA;AACO,EAAA;AACT;ADJU;AACA;AEbV;AACE;AACA;AACA;AACK;AAKS;AACP,EAAA;AACT;AAES;AACA,EAAA;AACL,IAAA;AACA,IAAA;AACM,IAAA;AACN,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACF,EAAA;AACF;AAYA;AACU,EAAA;AACF,EAAA;AAEA,EAAA;AACA,EAAA;AAKA,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AAEA,EAAA;AACJ,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACF,IAAA;AACA,IAAA;AACD,EAAA;AAEK,EAAA;AACR;AAEM;AAEN;AAMQ,EAAA;AACA,EAAA;AAKA,EAAA;AACA,EAAA;AAEN,EAAA;AACQ,IAAA;AACA,IAAA;AAEN,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACE,UAAA;AACA,UAAA;AACA,UAAA;AACA,UAAA;AACF,QAAA;AACA,QAAA;AACD,MAAA;AACD,MAAA;AACF,IAAA;AAEM,IAAA;AACR,EAAA;AACF;AFtBU;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/ami/Documents/prometheus/x12i/ai-tools/dist/chunk-HHNHWYTP.cjs","sourcesContent":[null,"/**\n * Firestore document ids cannot contain `/`. OpenRouter model ids use `provider/model`.\n * We encode global item doc ids as `cx~m~<base64url(modelId)>` while keeping logical `modelId` in data.\n */\nconst CX = \"cx~\";\nconst MODEL_MARKER = \"m~\";\n\nexport function encodeModelFirestoreDocId(modelId: string): string {\n  if (!modelId.includes(\"/\")) return modelId;\n  return `${CX}${MODEL_MARKER}${Buffer.from(modelId, \"utf8\").toString(\"base64url\")}`;\n}\n\nexport function decodeModelFirestoreDocId(docId: string): string {\n  const prefix = `${CX}${MODEL_MARKER}`;\n  if (docId.startsWith(prefix)) {\n    return Buffer.from(docId.slice(prefix.length), \"base64url\").toString(\"utf8\");\n  }\n  return docId;\n}\n\nexport function modelIdNeedsEncodedDocId(modelId: string): boolean {\n  return modelId.includes(\"/\");\n}\n","import type { Firestore } from \"firebase-admin/firestore\";\nimport type { CataloxContext } from \"@x12i/catalox\";\nimport {\n  flatNativeItemsCollectionRef,\n  legacyNativeItemsCollectionRef,\n  resolveNativeItemsLayout,\n} from \"@x12i/catalox/firebase\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport { encodeModelFirestoreDocId } from \"./modelDocId.js\";\n\n/** Firestore rejects `undefined` — strip before write. */\nexport function sanitizeForFirestore<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction buildIndexed(record: AiModelRecord): Record<string, string | number | boolean> {\n  return {\n    modelId: record.modelId,\n    providerId: record.providerId,\n    name: record.name,\n    canonicalSlug: record.canonicalSlug,\n    contextLength: record.contextLength,\n    status: record.status,\n    primaryOutputModality: record.primaryOutputModality,\n    supportsTools: record.supportsTools,\n    supportsReasoning: record.supportsReasoning,\n    supportsStreaming: record.supportsStreaming,\n    isModerated: record.isModerated,\n    syncedAt: record.syncedAt,\n  };\n}\n\nexport type UpsertAiModelRecordOptions = {\n  firestore: Firestore;\n  context: CataloxContext;\n  catalogId: string;\n  record: AiModelRecord;\n};\n\n/**\n * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).\n */\nexport async function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void> {\n  const { record, catalogId, context, firestore } = options;\n  const appId = context.appId ?? \"ai-tools\";\n\n  const layout = await resolveNativeItemsLayout(firestore, catalogId);\n  const col =\n    layout === \"legacy\"\n      ? legacyNativeItemsCollectionRef(firestore, catalogId)\n      : flatNativeItemsCollectionRef(firestore, catalogId);\n\n  const storageDocId = encodeModelFirestoreDocId(record.modelId);\n  const existing = await col.doc(storageDocId).get();\n  const now = new Date().toISOString();\n  const data = sanitizeForFirestore(record);\n\n  const payload = sanitizeForFirestore({\n    itemId: record.modelId,\n    catalogId,\n    appScopedOwnerId: appId,\n    indexed: buildIndexed(record),\n    data,\n    metadata: {\n      createdAt: String(existing.data()?.metadata?.createdAt ?? now),\n      lastUpdate: now,\n      domainIds: [],\n      agentIds: [],\n    },\n    version: (existing.data()?.version ?? 0) + 1,\n  });\n\n  await col.doc(storageDocId).set(payload, { merge: true });\n}\n\nconst BATCH_SIZE = 400;\n\nexport async function batchUpsertAiModelRecords(\n  firestore: Firestore,\n  catalogId: string,\n  context: CataloxContext,\n  records: AiModelRecord[],\n): Promise<void> {\n  const layout = await resolveNativeItemsLayout(firestore, catalogId);\n  const col =\n    layout === \"legacy\"\n      ? legacyNativeItemsCollectionRef(firestore, catalogId)\n      : flatNativeItemsCollectionRef(firestore, catalogId);\n\n  const appId = context.appId ?? \"ai-tools\";\n  const now = new Date().toISOString();\n\n  for (let i = 0; i < records.length; i += BATCH_SIZE) {\n    const chunk = records.slice(i, i + BATCH_SIZE);\n    const batch = firestore.batch();\n\n    for (const record of chunk) {\n      const storageDocId = encodeModelFirestoreDocId(record.modelId);\n      const data = sanitizeForFirestore(record);\n      const payload = sanitizeForFirestore({\n        itemId: record.modelId,\n        catalogId,\n        appScopedOwnerId: appId,\n        indexed: buildIndexed(record),\n        data,\n        metadata: {\n          createdAt: now,\n          lastUpdate: now,\n          domainIds: [],\n          agentIds: [],\n        },\n        version: 1,\n      });\n      batch.set(col.doc(storageDocId), payload, { merge: true });\n    }\n\n    await batch.commit();\n  }\n}\n"]}

package/dist/chunk-ML2FRR4L.js

@@ -1,105 +0,0 @@
-// src/catalox/modelDocId.ts
-var CX = "cx~";
-var MODEL_MARKER = "m~";
-function encodeModelFirestoreDocId(modelId) {
-  if (!modelId.includes("/")) return modelId;
-  return `${CX}${MODEL_MARKER}${Buffer.from(modelId, "utf8").toString("base64url")}`;
-}
-function decodeModelFirestoreDocId(docId) {
-  const prefix = `${CX}${MODEL_MARKER}`;
-  if (docId.startsWith(prefix)) {
-    return Buffer.from(docId.slice(prefix.length), "base64url").toString("utf8");
-  }
-  return docId;
-}
-
-// src/catalox/upsertAiModelRecord.ts
-import {
-  flatNativeItemsCollectionRef,
-  legacyNativeItemsCollectionRef,
-  resolveNativeItemsLayout
-} from "@x12i/catalox/firebase";
-function sanitizeForFirestore(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-function buildIndexed(record) {
-  return {
-    modelId: record.modelId,
-    providerId: record.providerId,
-    name: record.name,
-    canonicalSlug: record.canonicalSlug,
-    contextLength: record.contextLength,
-    status: record.status,
-    primaryOutputModality: record.primaryOutputModality,
-    supportsTools: record.supportsTools,
-    supportsReasoning: record.supportsReasoning,
-    supportsStreaming: record.supportsStreaming,
-    isModerated: record.isModerated,
-    syncedAt: record.syncedAt
-  };
-}
-async function upsertAiModelRecord(options) {
-  const { record, catalogId, context, firestore } = options;
-  const appId = context.appId ?? "ai-tools";
-  const layout = await resolveNativeItemsLayout(firestore, catalogId);
-  const col = layout === "legacy" ? legacyNativeItemsCollectionRef(firestore, catalogId) : flatNativeItemsCollectionRef(firestore, catalogId);
-  const storageDocId = encodeModelFirestoreDocId(record.modelId);
-  const existing = await col.doc(storageDocId).get();
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const data = sanitizeForFirestore(record);
-  const payload = sanitizeForFirestore({
-    itemId: record.modelId,
-    catalogId,
-    appScopedOwnerId: appId,
-    indexed: buildIndexed(record),
-    data,
-    metadata: {
-      createdAt: String(existing.data()?.metadata?.createdAt ?? now),
-      lastUpdate: now,
-      domainIds: [],
-      agentIds: []
-    },
-    version: (existing.data()?.version ?? 0) + 1
-  });
-  await col.doc(storageDocId).set(payload, { merge: true });
-}
-var BATCH_SIZE = 400;
-async function batchUpsertAiModelRecords(firestore, catalogId, context, records) {
-  const layout = await resolveNativeItemsLayout(firestore, catalogId);
-  const col = layout === "legacy" ? legacyNativeItemsCollectionRef(firestore, catalogId) : flatNativeItemsCollectionRef(firestore, catalogId);
-  const appId = context.appId ?? "ai-tools";
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  for (let i = 0; i < records.length; i += BATCH_SIZE) {
-    const chunk = records.slice(i, i + BATCH_SIZE);
-    const batch = firestore.batch();
-    for (const record of chunk) {
-      const storageDocId = encodeModelFirestoreDocId(record.modelId);
-      const data = sanitizeForFirestore(record);
-      const payload = sanitizeForFirestore({
-        itemId: record.modelId,
-        catalogId,
-        appScopedOwnerId: appId,
-        indexed: buildIndexed(record),
-        data,
-        metadata: {
-          createdAt: now,
-          lastUpdate: now,
-          domainIds: [],
-          agentIds: []
-        },
-        version: 1
-      });
-      batch.set(col.doc(storageDocId), payload, { merge: true });
-    }
-    await batch.commit();
-  }
-}
-
-export {
-  encodeModelFirestoreDocId,
-  decodeModelFirestoreDocId,
-  sanitizeForFirestore,
-  upsertAiModelRecord,
-  batchUpsertAiModelRecords
-};
-//# sourceMappingURL=chunk-ML2FRR4L.js.map

package/dist/chunk-ML2FRR4L.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/catalox/modelDocId.ts","../src/catalox/upsertAiModelRecord.ts"],"sourcesContent":["/**\n * Firestore document ids cannot contain `/`. OpenRouter model ids use `provider/model`.\n * We encode global item doc ids as `cx~m~<base64url(modelId)>` while keeping logical `modelId` in data.\n */\nconst CX = \"cx~\";\nconst MODEL_MARKER = \"m~\";\n\nexport function encodeModelFirestoreDocId(modelId: string): string {\n  if (!modelId.includes(\"/\")) return modelId;\n  return `${CX}${MODEL_MARKER}${Buffer.from(modelId, \"utf8\").toString(\"base64url\")}`;\n}\n\nexport function decodeModelFirestoreDocId(docId: string): string {\n  const prefix = `${CX}${MODEL_MARKER}`;\n  if (docId.startsWith(prefix)) {\n    return Buffer.from(docId.slice(prefix.length), \"base64url\").toString(\"utf8\");\n  }\n  return docId;\n}\n\nexport function modelIdNeedsEncodedDocId(modelId: string): boolean {\n  return modelId.includes(\"/\");\n}\n","import type { Firestore } from \"firebase-admin/firestore\";\nimport type { CataloxContext } from \"@x12i/catalox\";\nimport {\n  flatNativeItemsCollectionRef,\n  legacyNativeItemsCollectionRef,\n  resolveNativeItemsLayout,\n} from \"@x12i/catalox/firebase\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport { encodeModelFirestoreDocId } from \"./modelDocId.js\";\n\n/** Firestore rejects `undefined` — strip before write. */\nexport function sanitizeForFirestore<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction buildIndexed(record: AiModelRecord): Record<string, string | number | boolean> {\n  return {\n    modelId: record.modelId,\n    providerId: record.providerId,\n    name: record.name,\n    canonicalSlug: record.canonicalSlug,\n    contextLength: record.contextLength,\n    status: record.status,\n    primaryOutputModality: record.primaryOutputModality,\n    supportsTools: record.supportsTools,\n    supportsReasoning: record.supportsReasoning,\n    supportsStreaming: record.supportsStreaming,\n    isModerated: record.isModerated,\n    syncedAt: record.syncedAt,\n  };\n}\n\nexport type UpsertAiModelRecordOptions = {\n  firestore: Firestore;\n  context: CataloxContext;\n  catalogId: string;\n  record: AiModelRecord;\n};\n\n/**\n * Upserts one ai-models row via Firestore (safe doc ids for `provider/model` ids).\n */\nexport async function upsertAiModelRecord(options: UpsertAiModelRecordOptions): Promise<void> {\n  const { record, catalogId, context, firestore } = options;\n  const appId = context.appId ?? \"ai-tools\";\n\n  const layout = await resolveNativeItemsLayout(firestore, catalogId);\n  const col =\n    layout === \"legacy\"\n      ? legacyNativeItemsCollectionRef(firestore, catalogId)\n      : flatNativeItemsCollectionRef(firestore, catalogId);\n\n  const storageDocId = encodeModelFirestoreDocId(record.modelId);\n  const existing = await col.doc(storageDocId).get();\n  const now = new Date().toISOString();\n  const data = sanitizeForFirestore(record);\n\n  const payload = sanitizeForFirestore({\n    itemId: record.modelId,\n    catalogId,\n    appScopedOwnerId: appId,\n    indexed: buildIndexed(record),\n    data,\n    metadata: {\n      createdAt: String(existing.data()?.metadata?.createdAt ?? now),\n      lastUpdate: now,\n      domainIds: [],\n      agentIds: [],\n    },\n    version: (existing.data()?.version ?? 0) + 1,\n  });\n\n  await col.doc(storageDocId).set(payload, { merge: true });\n}\n\nconst BATCH_SIZE = 400;\n\nexport async function batchUpsertAiModelRecords(\n  firestore: Firestore,\n  catalogId: string,\n  context: CataloxContext,\n  records: AiModelRecord[],\n): Promise<void> {\n  const layout = await resolveNativeItemsLayout(firestore, catalogId);\n  const col =\n    layout === \"legacy\"\n      ? legacyNativeItemsCollectionRef(firestore, catalogId)\n      : flatNativeItemsCollectionRef(firestore, catalogId);\n\n  const appId = context.appId ?? \"ai-tools\";\n  const now = new Date().toISOString();\n\n  for (let i = 0; i < records.length; i += BATCH_SIZE) {\n    const chunk = records.slice(i, i + BATCH_SIZE);\n    const batch = firestore.batch();\n\n    for (const record of chunk) {\n      const storageDocId = encodeModelFirestoreDocId(record.modelId);\n      const data = sanitizeForFirestore(record);\n      const payload = sanitizeForFirestore({\n        itemId: record.modelId,\n        catalogId,\n        appScopedOwnerId: appId,\n        indexed: buildIndexed(record),\n        data,\n        metadata: {\n          createdAt: now,\n          lastUpdate: now,\n          domainIds: [],\n          agentIds: [],\n        },\n        version: 1,\n      });\n      batch.set(col.doc(storageDocId), payload, { merge: true });\n    }\n\n    await batch.commit();\n  }\n}\n"],"mappings":"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","names":[]}