@x12i/ai-tools 1.0.2

package/dist/chunk-ML2FRR4L.js

@@ -0,0 +1,105 @@
+// 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

@@ -0,0 +1 @@
+{"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":";AAIA,IAAM,KAAK;AACX,IAAM,eAAe;AAEd,SAAS,0BAA0B,SAAyB;AACjE,MAAI,CAAC,QAAQ,SAAS,GAAG,EAAG,QAAO;AACnC,SAAO,GAAG,EAAE,GAAG,YAAY,GAAG,OAAO,KAAK,SAAS,MAAM,EAAE,SAAS,WAAW,CAAC;AAClF;AAEO,SAAS,0BAA0B,OAAuB;AAC/D,QAAM,SAAS,GAAG,EAAE,GAAG,YAAY;AACnC,MAAI,MAAM,WAAW,MAAM,GAAG;AAC5B,WAAO,OAAO,KAAK,MAAM,MAAM,OAAO,MAAM,GAAG,WAAW,EAAE,SAAS,MAAM;AAAA,EAC7E;AACA,SAAO;AACT;;;AChBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKA,SAAS,qBAAwB,OAAa;AACnD,SAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC;AAEA,SAAS,aAAa,QAAkE;AACtF,SAAO;AAAA,IACL,SAAS,OAAO;AAAA,IAChB,YAAY,OAAO;AAAA,IACnB,MAAM,OAAO;AAAA,IACb,eAAe,OAAO;AAAA,IACtB,eAAe,OAAO;AAAA,IACtB,QAAQ,OAAO;AAAA,IACf,uBAAuB,OAAO;AAAA,IAC9B,eAAe,OAAO;AAAA,IACtB,mBAAmB,OAAO;AAAA,IAC1B,mBAAmB,OAAO;AAAA,IAC1B,aAAa,OAAO;AAAA,IACpB,UAAU,OAAO;AAAA,EACnB;AACF;AAYA,eAAsB,oBAAoB,SAAoD;AAC5F,QAAM,EAAE,QAAQ,WAAW,SAAS,UAAU,IAAI;AAClD,QAAM,QAAQ,QAAQ,SAAS;AAE/B,QAAM,SAAS,MAAM,yBAAyB,WAAW,SAAS;AAClE,QAAM,MACJ,WAAW,WACP,+BAA+B,WAAW,SAAS,IACnD,6BAA6B,WAAW,SAAS;AAEvD,QAAM,eAAe,0BAA0B,OAAO,OAAO;AAC7D,QAAM,WAAW,MAAM,IAAI,IAAI,YAAY,EAAE,IAAI;AACjD,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,QAAM,OAAO,qBAAqB,MAAM;AAExC,QAAM,UAAU,qBAAqB;AAAA,IACnC,QAAQ,OAAO;AAAA,IACf;AAAA,IACA,kBAAkB;AAAA,IAClB,SAAS,aAAa,MAAM;AAAA,IAC5B;AAAA,IACA,UAAU;AAAA,MACR,WAAW,OAAO,SAAS,KAAK,GAAG,UAAU,aAAa,GAAG;AAAA,MAC7D,YAAY;AAAA,MACZ,WAAW,CAAC;AAAA,MACZ,UAAU,CAAC;AAAA,IACb;AAAA,IACA,UAAU,SAAS,KAAK,GAAG,WAAW,KAAK;AAAA,EAC7C,CAAC;AAED,QAAM,IAAI,IAAI,YAAY,EAAE,IAAI,SAAS,EAAE,OAAO,KAAK,CAAC;AAC1D;AAEA,IAAM,aAAa;AAEnB,eAAsB,0BACpB,WACA,WACA,SACA,SACe;AACf,QAAM,SAAS,MAAM,yBAAyB,WAAW,SAAS;AAClE,QAAM,MACJ,WAAW,WACP,+BAA+B,WAAW,SAAS,IACnD,6BAA6B,WAAW,SAAS;AAEvD,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AAEnC,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,YAAY;AACnD,UAAM,QAAQ,QAAQ,MAAM,GAAG,IAAI,UAAU;AAC7C,UAAM,QAAQ,UAAU,MAAM;AAE9B,eAAW,UAAU,OAAO;AAC1B,YAAM,eAAe,0BAA0B,OAAO,OAAO;AAC7D,YAAM,OAAO,qBAAqB,MAAM;AACxC,YAAM,UAAU,qBAAqB;AAAA,QACnC,QAAQ,OAAO;AAAA,QACf;AAAA,QACA,kBAAkB;AAAA,QAClB,SAAS,aAAa,MAAM;AAAA,QAC5B;AAAA,QACA,UAAU;AAAA,UACR,WAAW;AAAA,UACX,YAAY;AAAA,UACZ,WAAW,CAAC;AAAA,UACZ,UAAU,CAAC;AAAA,QACb;AAAA,QACA,SAAS;AAAA,MACX,CAAC;AACD,YAAM,IAAI,IAAI,IAAI,YAAY,GAAG,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,IAC3D;AAEA,UAAM,MAAM,OAAO;AAAA,EACrB;AACF;","names":[]}

package/dist/chunk-MLRHYOCD.js

@@ -0,0 +1,160 @@
+import {
+  batchUpsertAiModelRecords
+} from "./chunk-ML2FRR4L.js";
+import {
+  normalizeOpenRouterModel
+} from "./chunk-6QGDZTGH.js";
+import {
+  AI_MODELS_CATALOG_ID,
+  AI_MODELS_DESCRIPTOR,
+  AI_TOOLS_APP_ID,
+  invalidateModelsCache
+} from "./chunk-DJ5SWJDY.js";
+import {
+  AiToolsError,
+  SyncError
+} from "./chunk-AJEKEWWB.js";
+
+// src/catalog/ensureAiModelsCatalog.ts
+async function ensureAiModelsCatalog(catalox, options = {}) {
+  const appId = options.appId ?? AI_TOOLS_APP_ID;
+  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;
+  const ctx = { appId, superAdmin: true };
+  try {
+    await catalox.ensureCatalog(ctx, {
+      catalogId,
+      name: AI_MODELS_DESCRIPTOR.label,
+      status: "active"
+    });
+    await catalox.bindCatalogToApp(ctx, {
+      appId,
+      catalogId,
+      access: { canRead: true, canWrite: true, canAdmin: true }
+    });
+    await catalox.upsertCatalogDescriptor(ctx, catalogId, {
+      descriptorVersion: "1.0.0",
+      descriptor: AI_MODELS_DESCRIPTOR
+    });
+  } catch (cause) {
+    throw new AiToolsError(
+      "CATALOG_BOOTSTRAP_FAILED",
+      `Failed to bootstrap catalog "${catalogId}" for app "${appId}".`,
+      cause
+    );
+  }
+}
+
+// src/sync/OpenRouterSyncProvider.ts
+function buildFetchHeaders(apiKey) {
+  const headers = { Accept: "application/json" };
+  if (apiKey?.trim()) headers.Authorization = `Bearer ${apiKey.trim()}`;
+  return headers;
+}
+function buildModelsUrl(baseUrl, query) {
+  const url = new URL(`${baseUrl.replace(/\/$/, "")}/models`);
+  const q = { output_modalities: "all", ...query };
+  for (const [key, value] of Object.entries(q)) {
+    if (value !== void 0 && value !== "") url.searchParams.set(key, value);
+  }
+  return url.toString();
+}
+var OpenRouterSyncProvider = class {
+  apiKey;
+  baseUrl;
+  query;
+  constructor(options = {}) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl ?? "https://openrouter.ai/api/v1";
+    this.query = options.query ?? { output_modalities: "all" };
+  }
+  /**
+   * Fetches the full OpenRouter model catalog (public, no API key required).
+   * @see https://openrouter.ai/api/v1/models
+   */
+  async fetchModels() {
+    const url = buildModelsUrl(this.baseUrl, this.query);
+    let response;
+    try {
+      response = await fetch(url, { headers: buildFetchHeaders(this.apiKey) });
+    } catch (cause) {
+      throw new SyncError("OPENROUTER_MODELS_FETCH_FAILED", `Failed to fetch OpenRouter models from ${url}`, cause);
+    }
+    if (response.status === 401 || response.status === 403) {
+      throw new SyncError(
+        "OPENROUTER_AUTH_FAILED",
+        this.apiKey ? "OpenRouter API key is invalid or unauthorized." : "OpenRouter returned unauthorized \u2014 remove OPENROUTER_API_KEY to use the public models endpoint."
+      );
+    }
+    if (!response.ok) {
+      const body = await response.text().catch(() => "");
+      throw new SyncError(
+        "OPENROUTER_MODELS_FETCH_FAILED",
+        `OpenRouter models fetch failed (${response.status}): ${body.slice(0, 200)}`
+      );
+    }
+    const json = await response.json();
+    const syncedAt = (/* @__PURE__ */ new Date()).toISOString();
+    return (json.data ?? []).map((row) => normalizeOpenRouterModel(row, syncedAt));
+  }
+  /** Build the URL used for the last fetch pattern (for debugging). */
+  getModelsUrl() {
+    return buildModelsUrl(this.baseUrl, this.query);
+  }
+};
+
+// src/sync/syncAiModelsCatalog.ts
+async function syncAiModelsCatalog(options) {
+  const start = Date.now();
+  const appId = options.appId ?? AI_TOOLS_APP_ID;
+  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;
+  const ctx = { appId, superAdmin: true };
+  if (options.forceCache) {
+    invalidateModelsCache(appId);
+  }
+  await ensureAiModelsCatalog(options.catalox, { appId, catalogId });
+  const provider = new OpenRouterSyncProvider({
+    apiKey: options.openRouterApiKey,
+    query: options.openRouterQuery ?? { output_modalities: "all" }
+  });
+  let models;
+  try {
+    models = await provider.fetchModels();
+  } catch (error) {
+    if (error instanceof SyncError) throw error;
+    throw new SyncError("SYNC_FETCH_FAILED", "Failed to fetch models from OpenRouter.", error);
+  }
+  if (options.verbose) {
+    console.log(`[sync] fetched ${models.length} models from ${provider.getModelsUrl()}`);
+  }
+  if (options.dryRun) {
+    return {
+      fetched: models.length,
+      upserted: 0,
+      skipped: models.length,
+      errors: [],
+      durationMs: Date.now() - start
+    };
+  }
+  const errors = [];
+  try {
+    await batchUpsertAiModelRecords(options.firestore, catalogId, ctx, models);
+  } catch (cause) {
+    const message = cause instanceof Error ? cause.message : String(cause);
+    throw new SyncError("SYNC_UPSERT_FAILED", `Batch upsert failed: ${message}`, cause);
+  }
+  invalidateModelsCache(appId);
+  return {
+    fetched: models.length,
+    upserted: models.length,
+    skipped: 0,
+    errors,
+    durationMs: Date.now() - start
+  };
+}
+
+export {
+  ensureAiModelsCatalog,
+  OpenRouterSyncProvider,
+  syncAiModelsCatalog
+};
+//# sourceMappingURL=chunk-MLRHYOCD.js.map

package/dist/chunk-MLRHYOCD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog/ensureAiModelsCatalog.ts","../src/sync/OpenRouterSyncProvider.ts","../src/sync/syncAiModelsCatalog.ts"],"sourcesContent":["import type { Catalox, CataloxContext } from \"@x12i/catalox\";\nimport { AiToolsError } from \"../errors.js\";\nimport {\n  AI_MODELS_CATALOG_ID,\n  AI_MODELS_DESCRIPTOR,\n  AI_TOOLS_APP_ID,\n} from \"./aiModelsCatalogDescriptor.js\";\n\nexport type EnsureAiModelsCatalogOptions = {\n  appId?: string;\n  catalogId?: string;\n};\n\nexport async function ensureAiModelsCatalog(\n  catalox: Catalox,\n  options: EnsureAiModelsCatalogOptions = {},\n): Promise<void> {\n  const appId = options.appId ?? AI_TOOLS_APP_ID;\n  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;\n\n  const ctx: CataloxContext = { appId, superAdmin: true };\n\n  try {\n    await catalox.ensureCatalog(ctx, {\n      catalogId,\n      name: AI_MODELS_DESCRIPTOR.label,\n      status: \"active\",\n    });\n\n    await catalox.bindCatalogToApp(ctx, {\n      appId,\n      catalogId,\n      access: { canRead: true, canWrite: true, canAdmin: true },\n    });\n\n    await catalox.upsertCatalogDescriptor(ctx, catalogId, {\n      descriptorVersion: \"1.0.0\",\n      descriptor: AI_MODELS_DESCRIPTOR,\n    });\n  } catch (cause) {\n    throw new AiToolsError(\n      \"CATALOG_BOOTSTRAP_FAILED\",\n      `Failed to bootstrap catalog \"${catalogId}\" for app \"${appId}\".`,\n      cause,\n    );\n  }\n}\n","import { SyncError } from \"../errors.js\";\nimport { normalizeOpenRouterModel } from \"../models/normalizeOpenRouterModel.js\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport type {\n  OpenRouterModelsQuery,\n  OpenRouterModelsResponse,\n} from \"../models/openrouter.types.js\";\n\nexport type OpenRouterSyncProviderOptions = {\n  /** Optional — public GET /models needs no key. */\n  apiKey?: string;\n  baseUrl?: string;\n  /** Query params passed to OpenRouter (default: all modalities). */\n  query?: OpenRouterModelsQuery;\n};\n\nfunction buildFetchHeaders(apiKey?: string): Record<string, string> {\n  const headers: Record<string, string> = { Accept: \"application/json\" };\n  if (apiKey?.trim()) headers.Authorization = `Bearer ${apiKey.trim()}`;\n  return headers;\n}\n\nfunction buildModelsUrl(baseUrl: string, query?: OpenRouterModelsQuery): string {\n  const url = new URL(`${baseUrl.replace(/\\/$/, \"\")}/models`);\n  const q = { output_modalities: \"all\", ...query };\n  for (const [key, value] of Object.entries(q)) {\n    if (value !== undefined && value !== \"\") url.searchParams.set(key, value);\n  }\n  return url.toString();\n}\n\nexport class OpenRouterSyncProvider {\n  private readonly apiKey?: string;\n  private readonly baseUrl: string;\n  private readonly query?: OpenRouterModelsQuery;\n\n  constructor(options: OpenRouterSyncProviderOptions = {}) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl ?? \"https://openrouter.ai/api/v1\";\n    this.query = options.query ?? { output_modalities: \"all\" };\n  }\n\n  /**\n   * Fetches the full OpenRouter model catalog (public, no API key required).\n   * @see https://openrouter.ai/api/v1/models\n   */\n  async fetchModels(): Promise<AiModelRecord[]> {\n    const url = buildModelsUrl(this.baseUrl, this.query);\n    let response: Response;\n\n    try {\n      response = await fetch(url, { headers: buildFetchHeaders(this.apiKey) });\n    } catch (cause) {\n      throw new SyncError(\"OPENROUTER_MODELS_FETCH_FAILED\", `Failed to fetch OpenRouter models from ${url}`, cause);\n    }\n\n    if (response.status === 401 || response.status === 403) {\n      throw new SyncError(\n        \"OPENROUTER_AUTH_FAILED\",\n        this.apiKey\n          ? \"OpenRouter API key is invalid or unauthorized.\"\n          : \"OpenRouter returned unauthorized — remove OPENROUTER_API_KEY to use the public models endpoint.\",\n      );\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => \"\");\n      throw new SyncError(\n        \"OPENROUTER_MODELS_FETCH_FAILED\",\n        `OpenRouter models fetch failed (${response.status}): ${body.slice(0, 200)}`,\n      );\n    }\n\n    const json = (await response.json()) as OpenRouterModelsResponse;\n    const syncedAt = new Date().toISOString();\n    return (json.data ?? []).map((row) => normalizeOpenRouterModel(row, syncedAt));\n  }\n\n  /** Build the URL used for the last fetch pattern (for debugging). */\n  getModelsUrl(): string {\n    return buildModelsUrl(this.baseUrl, this.query);\n  }\n}\n","import type { Catalox, CataloxContext } from \"@x12i/catalox\";\nimport type { Firestore } from \"firebase-admin/firestore\";\nimport { ensureAiModelsCatalog } from \"../catalog/ensureAiModelsCatalog.js\";\nimport { AI_MODELS_CATALOG_ID, AI_TOOLS_APP_ID } from \"../catalog/aiModelsCatalogDescriptor.js\";\nimport { invalidateModelsCache } from \"../cache/modelCache.js\";\nimport { batchUpsertAiModelRecords } from \"../catalox/upsertAiModelRecord.js\";\nimport { SyncError } from \"../errors.js\";\nimport type { AiModelRecord } from \"../models/types.js\";\nimport type { OpenRouterModelsQuery } from \"../models/openrouter.types.js\";\nimport { OpenRouterSyncProvider } from \"./OpenRouterSyncProvider.js\";\n\nexport type SyncOptions = {\n  catalox: Catalox;\n  firestore: Firestore;\n  openRouterApiKey?: string;\n  openRouterQuery?: OpenRouterModelsQuery;\n  appId?: string;\n  catalogId?: string;\n  dryRun?: boolean;\n  verbose?: boolean;\n  forceCache?: boolean;\n};\n\nexport type SyncResult = {\n  fetched: number;\n  upserted: number;\n  skipped: number;\n  errors: Array<{ modelId: string; error: string }>;\n  durationMs: number;\n};\n\nexport async function syncAiModelsCatalog(options: SyncOptions): Promise<SyncResult> {\n  const start = Date.now();\n  const appId = options.appId ?? AI_TOOLS_APP_ID;\n  const catalogId = options.catalogId ?? AI_MODELS_CATALOG_ID;\n  const ctx: CataloxContext = { appId, superAdmin: true };\n\n  if (options.forceCache) {\n    invalidateModelsCache(appId);\n  }\n\n  await ensureAiModelsCatalog(options.catalox, { appId, catalogId });\n\n  const provider = new OpenRouterSyncProvider({\n    apiKey: options.openRouterApiKey,\n    query: options.openRouterQuery ?? { output_modalities: \"all\" },\n  });\n\n  let models: AiModelRecord[];\n  try {\n    models = await provider.fetchModels();\n  } catch (error) {\n    if (error instanceof SyncError) throw error;\n    throw new SyncError(\"SYNC_FETCH_FAILED\", \"Failed to fetch models from OpenRouter.\", error);\n  }\n\n  if (options.verbose) {\n    console.log(`[sync] fetched ${models.length} models from ${provider.getModelsUrl()}`);\n  }\n\n  if (options.dryRun) {\n    return {\n      fetched: models.length,\n      upserted: 0,\n      skipped: models.length,\n      errors: [],\n      durationMs: Date.now() - start,\n    };\n  }\n\n  const errors: SyncResult[\"errors\"] = [];\n  try {\n    await batchUpsertAiModelRecords(options.firestore, catalogId, ctx, models);\n  } catch (cause) {\n    const message = cause instanceof Error ? cause.message : String(cause);\n    throw new SyncError(\"SYNC_UPSERT_FAILED\", `Batch upsert failed: ${message}`, cause);\n  }\n\n  invalidateModelsCache(appId);\n\n  return {\n    fetched: models.length,\n    upserted: models.length,\n    skipped: 0,\n    errors,\n    durationMs: Date.now() - start,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-O2A6OVEH.js

@@ -0,0 +1,240 @@
+import {
+  AliasConflictError,
+  AliasFileParseError,
+  AliasFileWriteError,
+  AliasInvalidNameError,
+  AliasNotFoundError
+} from "./chunk-AJEKEWWB.js";
+
+// src/aliases/AliasRegistry.ts
+import fs from "fs";
+import path from "path";
+import { z } from "zod";
+var ALIAS_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+var aliasEntrySchema = z.object({
+  modelId: z.string().min(1),
+  provider: z.string().min(1),
+  description: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+  addedAt: z.string(),
+  updatedAt: z.string()
+});
+var aliasFileSchema = z.object({
+  $schema: z.string().optional(),
+  version: z.literal(1),
+  updatedAt: z.string(),
+  aliases: z.record(aliasEntrySchema)
+});
+function defaultAliasesPath() {
+  if (process.env.AI_TOOLS_ALIASES_PATH) {
+    return path.resolve(process.env.AI_TOOLS_ALIASES_PATH);
+  }
+  return path.resolve(process.cwd(), "ai-tools/aliases.json");
+}
+function emptySchema() {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    $schema: "https://unpkg.com/@x12i/ai-tools/schemas/aliases.json",
+    version: 1,
+    updatedAt: now,
+    aliases: {}
+  };
+}
+var AliasRegistry = class {
+  aliasesPath;
+  constructor(options = {}) {
+    this.aliasesPath = options.aliasesPath ?? defaultAliasesPath();
+  }
+  get path() {
+    return this.aliasesPath;
+  }
+  exists() {
+    return fs.existsSync(this.aliasesPath);
+  }
+  init() {
+    if (this.exists()) return;
+    fs.mkdirSync(path.dirname(this.aliasesPath), { recursive: true });
+    this.writeFile(emptySchema());
+  }
+  load() {
+    if (!this.exists()) return emptySchema();
+    let raw;
+    try {
+      raw = fs.readFileSync(this.aliasesPath, "utf8");
+    } catch (cause) {
+      throw new AliasFileParseError(this.aliasesPath, cause);
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch (cause) {
+      throw new AliasFileParseError(this.aliasesPath, cause);
+    }
+    const result = aliasFileSchema.safeParse(parsed);
+    if (!result.success) {
+      throw new AliasFileParseError(this.aliasesPath, result.error);
+    }
+    return result.data;
+  }
+  get(aliasName) {
+    const schema = this.load();
+    return schema.aliases[aliasName] ?? null;
+  }
+  list(filter) {
+    const schema = this.load();
+    return Object.entries(schema.aliases).filter(([, entry]) => !filter?.tag || (entry.tags ?? []).includes(filter.tag)).map(([name, entry]) => ({ name, ...entry }));
+  }
+  set(aliasName, entry) {
+    if (!ALIAS_NAME_RE.test(aliasName)) {
+      throw new AliasInvalidNameError(aliasName);
+    }
+    if (!this.exists()) this.init();
+    const schema = this.load();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const existing = schema.aliases[aliasName];
+    const full = {
+      ...entry,
+      addedAt: existing?.addedAt ?? now,
+      updatedAt: now
+    };
+    schema.aliases[aliasName] = full;
+    schema.updatedAt = now;
+    this.writeFile(schema);
+    return full;
+  }
+  remove(aliasName) {
+    if (!this.exists()) return false;
+    const schema = this.load();
+    if (!schema.aliases[aliasName]) return false;
+    delete schema.aliases[aliasName];
+    schema.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.writeFile(schema);
+    return true;
+  }
+  rename(from, to, options) {
+    if (!ALIAS_NAME_RE.test(to)) {
+      throw new AliasInvalidNameError(to);
+    }
+    const schema = this.load();
+    const entry = schema.aliases[from];
+    if (!entry) {
+      throw new AliasNotFoundError(from);
+    }
+    if (schema.aliases[to] && !options?.force) {
+      throw new AliasConflictError(to);
+    }
+    delete schema.aliases[from];
+    entry.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    schema.aliases[to] = entry;
+    schema.updatedAt = entry.updatedAt;
+    this.writeFile(schema);
+  }
+  writeFile(schema) {
+    const tmp = `${this.aliasesPath}.tmp`;
+    try {
+      fs.mkdirSync(path.dirname(this.aliasesPath), { recursive: true });
+      fs.writeFileSync(tmp, JSON.stringify(schema, null, 2), "utf8");
+      fs.renameSync(tmp, this.aliasesPath);
+    } catch (cause) {
+      throw new AliasFileWriteError(this.aliasesPath, cause);
+    }
+  }
+};
+
+// src/aliases/AliasResolver.ts
+var ALIAS_NAME_RE2 = /^[a-z0-9][a-z0-9-]*$/;
+var AliasResolver = class {
+  registry;
+  catalogClient;
+  constructor(options) {
+    this.registry = options.registry;
+    this.catalogClient = options.catalogClient;
+  }
+  async getModel(aliasName) {
+    const entry = this.registry.get(aliasName);
+    if (!entry) {
+      throw new AliasNotFoundError(aliasName);
+    }
+    return this.resolveEntry(aliasName, entry);
+  }
+  async getModels(aliasNames) {
+    const results = [];
+    for (const name of aliasNames) {
+      const entry = this.registry.get(name);
+      if (!entry) {
+        console.warn(`[ai-tools] Unknown alias "${name}" \u2014 skipped.`);
+        continue;
+      }
+      results.push(await this.resolveEntry(name, entry));
+    }
+    return results;
+  }
+  async getAllResolved() {
+    const list = this.registry.list();
+    return Promise.all(list.map(({ name, ...entry }) => this.resolveEntry(name, entry)));
+  }
+  async validate() {
+    const list = this.registry.list();
+    const entries = [];
+    let ok = 0;
+    let unknown = 0;
+    let broken = 0;
+    for (const { name, modelId } of list) {
+      if (!ALIAS_NAME_RE2.test(name) || !modelId) {
+        broken++;
+        entries.push({
+          name,
+          status: "broken",
+          modelId: modelId ?? "",
+          issue: "Invalid alias name or empty modelId"
+        });
+        continue;
+      }
+      const ref = await this.resolveEntry(name, this.registry.get(name));
+      if (ref.modelRecord) {
+        ok++;
+        entries.push({
+          name,
+          status: "ok",
+          modelId: ref.modelId,
+          resolvedName: ref.name
+        });
+      } else {
+        unknown++;
+        entries.push({
+          name,
+          status: "unknown",
+          modelId: ref.modelId,
+          issue: "Model not found in catalog"
+        });
+      }
+    }
+    return {
+      total: list.length,
+      ok,
+      unknown,
+      broken,
+      entries
+    };
+  }
+  async resolveEntry(alias, entry) {
+    const result = await this.catalogClient.resolveModel({
+      model: entry.modelId,
+      provider: entry.provider
+    });
+    return {
+      alias,
+      entry,
+      modelRecord: result.found ? result.record : null,
+      modelId: result.found ? result.modelId : entry.modelId,
+      provider: entry.provider,
+      name: result.record?.name ?? entry.modelId
+    };
+  }
+};
+
+export {
+  AliasRegistry,
+  AliasResolver
+};
+//# sourceMappingURL=chunk-O2A6OVEH.js.map

package/dist/chunk-O2A6OVEH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/aliases/AliasRegistry.ts","../src/aliases/AliasResolver.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport {\n  AliasConflictError,\n  AliasFileParseError,\n  AliasFileWriteError,\n  AliasInvalidNameError,\n  AliasNotFoundError,\n} from \"../errors.js\";\nimport type { AliasEntry, AliasFileSchema } from \"./types.js\";\n\nconst ALIAS_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;\n\nconst aliasEntrySchema = z.object({\n  modelId: z.string().min(1),\n  provider: z.string().min(1),\n  description: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  addedAt: z.string(),\n  updatedAt: z.string(),\n});\n\nconst aliasFileSchema = z.object({\n  $schema: z.string().optional(),\n  version: z.literal(1),\n  updatedAt: z.string(),\n  aliases: z.record(aliasEntrySchema),\n});\n\nexport type AliasRegistryOptions = {\n  aliasesPath?: string;\n};\n\nfunction defaultAliasesPath(): string {\n  if (process.env.AI_TOOLS_ALIASES_PATH) {\n    return path.resolve(process.env.AI_TOOLS_ALIASES_PATH);\n  }\n  return path.resolve(process.cwd(), \"ai-tools/aliases.json\");\n}\n\nfunction emptySchema(): AliasFileSchema {\n  const now = new Date().toISOString();\n  return {\n    $schema: \"https://unpkg.com/@x12i/ai-tools/schemas/aliases.json\",\n    version: 1,\n    updatedAt: now,\n    aliases: {},\n  };\n}\n\nexport class AliasRegistry {\n  private readonly aliasesPath: string;\n\n  constructor(options: AliasRegistryOptions = {}) {\n    this.aliasesPath = options.aliasesPath ?? defaultAliasesPath();\n  }\n\n  get path(): string {\n    return this.aliasesPath;\n  }\n\n  exists(): boolean {\n    return fs.existsSync(this.aliasesPath);\n  }\n\n  init(): void {\n    if (this.exists()) return;\n    fs.mkdirSync(path.dirname(this.aliasesPath), { recursive: true });\n    this.writeFile(emptySchema());\n  }\n\n  load(): AliasFileSchema {\n    if (!this.exists()) return emptySchema();\n\n    let raw: string;\n    try {\n      raw = fs.readFileSync(this.aliasesPath, \"utf8\");\n    } catch (cause) {\n      throw new AliasFileParseError(this.aliasesPath, cause);\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch (cause) {\n      throw new AliasFileParseError(this.aliasesPath, cause);\n    }\n\n    const result = aliasFileSchema.safeParse(parsed);\n    if (!result.success) {\n      throw new AliasFileParseError(this.aliasesPath, result.error);\n    }\n\n    return result.data;\n  }\n\n  get(aliasName: string): AliasEntry | null {\n    const schema = this.load();\n    return schema.aliases[aliasName] ?? null;\n  }\n\n  list(filter?: { tag?: string }): Array<{ name: string } & AliasEntry> {\n    const schema = this.load();\n    return Object.entries(schema.aliases)\n      .filter(([, entry]) => !filter?.tag || (entry.tags ?? []).includes(filter.tag))\n      .map(([name, entry]) => ({ name, ...entry }));\n  }\n\n  set(\n    aliasName: string,\n    entry: Omit<AliasEntry, \"addedAt\" | \"updatedAt\">,\n  ): AliasEntry {\n    if (!ALIAS_NAME_RE.test(aliasName)) {\n      throw new AliasInvalidNameError(aliasName);\n    }\n\n    if (!this.exists()) this.init();\n\n    const schema = this.load();\n    const now = new Date().toISOString();\n    const existing = schema.aliases[aliasName];\n\n    const full: AliasEntry = {\n      ...entry,\n      addedAt: existing?.addedAt ?? now,\n      updatedAt: now,\n    };\n\n    schema.aliases[aliasName] = full;\n    schema.updatedAt = now;\n    this.writeFile(schema);\n    return full;\n  }\n\n  remove(aliasName: string): boolean {\n    if (!this.exists()) return false;\n    const schema = this.load();\n    if (!schema.aliases[aliasName]) return false;\n    delete schema.aliases[aliasName];\n    schema.updatedAt = new Date().toISOString();\n    this.writeFile(schema);\n    return true;\n  }\n\n  rename(from: string, to: string, options?: { force?: boolean }): void {\n    if (!ALIAS_NAME_RE.test(to)) {\n      throw new AliasInvalidNameError(to);\n    }\n\n    const schema = this.load();\n    const entry = schema.aliases[from];\n    if (!entry) {\n      throw new AliasNotFoundError(from);\n    }\n    if (schema.aliases[to] && !options?.force) {\n      throw new AliasConflictError(to);\n    }\n\n    delete schema.aliases[from];\n    entry.updatedAt = new Date().toISOString();\n    schema.aliases[to] = entry;\n    schema.updatedAt = entry.updatedAt;\n    this.writeFile(schema);\n  }\n\n  private writeFile(schema: AliasFileSchema): void {\n    const tmp = `${this.aliasesPath}.tmp`;\n    try {\n      fs.mkdirSync(path.dirname(this.aliasesPath), { recursive: true });\n      fs.writeFileSync(tmp, JSON.stringify(schema, null, 2), \"utf8\");\n      fs.renameSync(tmp, this.aliasesPath);\n    } catch (cause) {\n      throw new AliasFileWriteError(this.aliasesPath, cause);\n    }\n  }\n}\n","import { AliasNotFoundError } from \"../errors.js\";\nimport type { AiModelsCatalogClient } from \"../catalox/AiModelsCatalogClient.js\";\nimport type { AliasRegistry } from \"./AliasRegistry.js\";\nimport type { AliasValidationReport, ResolvedModelRef } from \"./types.js\";\n\nconst ALIAS_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;\n\nexport type AliasResolverOptions = {\n  registry: AliasRegistry;\n  catalogClient: AiModelsCatalogClient;\n};\n\nexport class AliasResolver {\n  private readonly registry: AliasRegistry;\n  private readonly catalogClient: AiModelsCatalogClient;\n\n  constructor(options: AliasResolverOptions) {\n    this.registry = options.registry;\n    this.catalogClient = options.catalogClient;\n  }\n\n  async getModel(aliasName: string): Promise<ResolvedModelRef> {\n    const entry = this.registry.get(aliasName);\n    if (!entry) {\n      throw new AliasNotFoundError(aliasName);\n    }\n    return this.resolveEntry(aliasName, entry);\n  }\n\n  async getModels(aliasNames: string[]): Promise<ResolvedModelRef[]> {\n    const results: ResolvedModelRef[] = [];\n    for (const name of aliasNames) {\n      const entry = this.registry.get(name);\n      if (!entry) {\n        console.warn(`[ai-tools] Unknown alias \"${name}\" — skipped.`);\n        continue;\n      }\n      results.push(await this.resolveEntry(name, entry));\n    }\n    return results;\n  }\n\n  async getAllResolved(): Promise<ResolvedModelRef[]> {\n    const list = this.registry.list();\n    return Promise.all(list.map(({ name, ...entry }) => this.resolveEntry(name, entry)));\n  }\n\n  async validate(): Promise<AliasValidationReport> {\n    const list = this.registry.list();\n    const entries: AliasValidationReport[\"entries\"] = [];\n    let ok = 0;\n    let unknown = 0;\n    let broken = 0;\n\n    for (const { name, modelId } of list) {\n      if (!ALIAS_NAME_RE.test(name) || !modelId) {\n        broken++;\n        entries.push({\n          name,\n          status: \"broken\",\n          modelId: modelId ?? \"\",\n          issue: \"Invalid alias name or empty modelId\",\n        });\n        continue;\n      }\n\n      const ref = await this.resolveEntry(name, this.registry.get(name)!);\n      if (ref.modelRecord) {\n        ok++;\n        entries.push({\n          name,\n          status: \"ok\",\n          modelId: ref.modelId,\n          resolvedName: ref.name,\n        });\n      } else {\n        unknown++;\n        entries.push({\n          name,\n          status: \"unknown\",\n          modelId: ref.modelId,\n          issue: \"Model not found in catalog\",\n        });\n      }\n    }\n\n    return {\n      total: list.length,\n      ok,\n      unknown,\n      broken,\n      entries,\n    };\n  }\n\n  private async resolveEntry(\n    alias: string,\n    entry: import(\"./types.js\").AliasEntry,\n  ): Promise<ResolvedModelRef> {\n    const result = await this.catalogClient.resolveModel({\n      model: entry.modelId,\n      provider: entry.provider,\n    });\n\n    return {\n      alias,\n      entry,\n      modelRecord: result.found ? result.record : null,\n      modelId: result.found ? result.modelId : entry.modelId,\n      provider: entry.provider,\n      name: result.record?.name ?? entry.modelId,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,SAAS;AAUlB,IAAM,gBAAgB;AAEtB,IAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACzB,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC1B,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnC,SAAS,EAAE,OAAO;AAAA,EAClB,WAAW,EAAE,OAAO;AACtB,CAAC;AAED,IAAM,kBAAkB,EAAE,OAAO;AAAA,EAC/B,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,SAAS,EAAE,QAAQ,CAAC;AAAA,EACpB,WAAW,EAAE,OAAO;AAAA,EACpB,SAAS,EAAE,OAAO,gBAAgB;AACpC,CAAC;AAMD,SAAS,qBAA6B;AACpC,MAAI,QAAQ,IAAI,uBAAuB;AACrC,WAAO,KAAK,QAAQ,QAAQ,IAAI,qBAAqB;AAAA,EACvD;AACA,SAAO,KAAK,QAAQ,QAAQ,IAAI,GAAG,uBAAuB;AAC5D;AAEA,SAAS,cAA+B;AACtC,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SAAS;AAAA,IACT,WAAW;AAAA,IACX,SAAS,CAAC;AAAA,EACZ;AACF;AAEO,IAAM,gBAAN,MAAoB;AAAA,EACR;AAAA,EAEjB,YAAY,UAAgC,CAAC,GAAG;AAC9C,SAAK,cAAc,QAAQ,eAAe,mBAAmB;AAAA,EAC/D;AAAA,EAEA,IAAI,OAAe;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,SAAkB;AAChB,WAAO,GAAG,WAAW,KAAK,WAAW;AAAA,EACvC;AAAA,EAEA,OAAa;AACX,QAAI,KAAK,OAAO,EAAG;AACnB,OAAG,UAAU,KAAK,QAAQ,KAAK,WAAW,GAAG,EAAE,WAAW,KAAK,CAAC;AAChE,SAAK,UAAU,YAAY,CAAC;AAAA,EAC9B;AAAA,EAEA,OAAwB;AACtB,QAAI,CAAC,KAAK,OAAO,EAAG,QAAO,YAAY;AAEvC,QAAI;AACJ,QAAI;AACF,YAAM,GAAG,aAAa,KAAK,aAAa,MAAM;AAAA,IAChD,SAAS,OAAO;AACd,YAAM,IAAI,oBAAoB,KAAK,aAAa,KAAK;AAAA,IACvD;AAEA,QAAI;AACJ,QAAI;AACF,eAAS,KAAK,MAAM,GAAG;AAAA,IACzB,SAAS,OAAO;AACd,YAAM,IAAI,oBAAoB,KAAK,aAAa,KAAK;AAAA,IACvD;AAEA,UAAM,SAAS,gBAAgB,UAAU,MAAM;AAC/C,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI,oBAAoB,KAAK,aAAa,OAAO,KAAK;AAAA,IAC9D;AAEA,WAAO,OAAO;AAAA,EAChB;AAAA,EAEA,IAAI,WAAsC;AACxC,UAAM,SAAS,KAAK,KAAK;AACzB,WAAO,OAAO,QAAQ,SAAS,KAAK;AAAA,EACtC;AAAA,EAEA,KAAK,QAAiE;AACpE,UAAM,SAAS,KAAK,KAAK;AACzB,WAAO,OAAO,QAAQ,OAAO,OAAO,EACjC,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,QAAQ,QAAQ,MAAM,QAAQ,CAAC,GAAG,SAAS,OAAO,GAAG,CAAC,EAC7E,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;AAAA,EAChD;AAAA,EAEA,IACE,WACA,OACY;AACZ,QAAI,CAAC,cAAc,KAAK,SAAS,GAAG;AAClC,YAAM,IAAI,sBAAsB,SAAS;AAAA,IAC3C;AAEA,QAAI,CAAC,KAAK,OAAO,EAAG,MAAK,KAAK;AAE9B,UAAM,SAAS,KAAK,KAAK;AACzB,UAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,UAAM,WAAW,OAAO,QAAQ,SAAS;AAEzC,UAAM,OAAmB;AAAA,MACvB,GAAG;AAAA,MACH,SAAS,UAAU,WAAW;AAAA,MAC9B,WAAW;AAAA,IACb;AAEA,WAAO,QAAQ,SAAS,IAAI;AAC5B,WAAO,YAAY;AACnB,SAAK,UAAU,MAAM;AACrB,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,WAA4B;AACjC,QAAI,CAAC,KAAK,OAAO,EAAG,QAAO;AAC3B,UAAM,SAAS,KAAK,KAAK;AACzB,QAAI,CAAC,OAAO,QAAQ,SAAS,EAAG,QAAO;AACvC,WAAO,OAAO,QAAQ,SAAS;AAC/B,WAAO,aAAY,oBAAI,KAAK,GAAE,YAAY;AAC1C,SAAK,UAAU,MAAM;AACrB,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAc,IAAY,SAAqC;AACpE,QAAI,CAAC,cAAc,KAAK,EAAE,GAAG;AAC3B,YAAM,IAAI,sBAAsB,EAAE;AAAA,IACpC;AAEA,UAAM,SAAS,KAAK,KAAK;AACzB,UAAM,QAAQ,OAAO,QAAQ,IAAI;AACjC,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,mBAAmB,IAAI;AAAA,IACnC;AACA,QAAI,OAAO,QAAQ,EAAE,KAAK,CAAC,SAAS,OAAO;AACzC,YAAM,IAAI,mBAAmB,EAAE;AAAA,IACjC;AAEA,WAAO,OAAO,QAAQ,IAAI;AAC1B,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,WAAO,QAAQ,EAAE,IAAI;AACrB,WAAO,YAAY,MAAM;AACzB,SAAK,UAAU,MAAM;AAAA,EACvB;AAAA,EAEQ,UAAU,QAA+B;AAC/C,UAAM,MAAM,GAAG,KAAK,WAAW;AAC/B,QAAI;AACF,SAAG,UAAU,KAAK,QAAQ,KAAK,WAAW,GAAG,EAAE,WAAW,KAAK,CAAC;AAChE,SAAG,cAAc,KAAK,KAAK,UAAU,QAAQ,MAAM,CAAC,GAAG,MAAM;AAC7D,SAAG,WAAW,KAAK,KAAK,WAAW;AAAA,IACrC,SAAS,OAAO;AACd,YAAM,IAAI,oBAAoB,KAAK,aAAa,KAAK;AAAA,IACvD;AAAA,EACF;AACF;;;AC3KA,IAAMA,iBAAgB;AAOf,IAAM,gBAAN,MAAoB;AAAA,EACR;AAAA,EACA;AAAA,EAEjB,YAAY,SAA+B;AACzC,SAAK,WAAW,QAAQ;AACxB,SAAK,gBAAgB,QAAQ;AAAA,EAC/B;AAAA,EAEA,MAAM,SAAS,WAA8C;AAC3D,UAAM,QAAQ,KAAK,SAAS,IAAI,SAAS;AACzC,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,mBAAmB,SAAS;AAAA,IACxC;AACA,WAAO,KAAK,aAAa,WAAW,KAAK;AAAA,EAC3C;AAAA,EAEA,MAAM,UAAU,YAAmD;AACjE,UAAM,UAA8B,CAAC;AACrC,eAAW,QAAQ,YAAY;AAC7B,YAAM,QAAQ,KAAK,SAAS,IAAI,IAAI;AACpC,UAAI,CAAC,OAAO;AACV,gBAAQ,KAAK,6BAA6B,IAAI,mBAAc;AAC5D;AAAA,MACF;AACA,cAAQ,KAAK,MAAM,KAAK,aAAa,MAAM,KAAK,CAAC;AAAA,IACnD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,iBAA8C;AAClD,UAAM,OAAO,KAAK,SAAS,KAAK;AAChC,WAAO,QAAQ,IAAI,KAAK,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,MAAM,KAAK,aAAa,MAAM,KAAK,CAAC,CAAC;AAAA,EACrF;AAAA,EAEA,MAAM,WAA2C;AAC/C,UAAM,OAAO,KAAK,SAAS,KAAK;AAChC,UAAM,UAA4C,CAAC;AACnD,QAAI,KAAK;AACT,QAAI,UAAU;AACd,QAAI,SAAS;AAEb,eAAW,EAAE,MAAM,QAAQ,KAAK,MAAM;AACpC,UAAI,CAACA,eAAc,KAAK,IAAI,KAAK,CAAC,SAAS;AACzC;AACA,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,SAAS,WAAW;AAAA,UACpB,OAAO;AAAA,QACT,CAAC;AACD;AAAA,MACF;AAEA,YAAM,MAAM,MAAM,KAAK,aAAa,MAAM,KAAK,SAAS,IAAI,IAAI,CAAE;AAClE,UAAI,IAAI,aAAa;AACnB;AACA,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,SAAS,IAAI;AAAA,UACb,cAAc,IAAI;AAAA,QACpB,CAAC;AAAA,MACH,OAAO;AACL;AACA,gBAAQ,KAAK;AAAA,UACX;AAAA,UACA,QAAQ;AAAA,UACR,SAAS,IAAI;AAAA,UACb,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO;AAAA,MACL,OAAO,KAAK;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,aACZ,OACA,OAC2B;AAC3B,UAAM,SAAS,MAAM,KAAK,cAAc,aAAa;AAAA,MACnD,OAAO,MAAM;AAAA,MACb,UAAU,MAAM;AAAA,IAClB,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,aAAa,OAAO,QAAQ,OAAO,SAAS;AAAA,MAC5C,SAAS,OAAO,QAAQ,OAAO,UAAU,MAAM;AAAA,MAC/C,UAAU,MAAM;AAAA,MAChB,MAAM,OAAO,QAAQ,QAAQ,MAAM;AAAA,IACrC;AAAA,EACF;AACF;","names":["ALIAS_NAME_RE"]}