offrouter-core 0.5.0 → 0.6.0

package/dist/provider-health.d.ts

@@ -0,0 +1,129 @@
+import { chmod, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+/** Failures older than this window stop counting toward the score. */
+export declare const FAILURE_DECAY_MS: number;
+/** Baseline score for unknown / never-seen provider+model pairs. */
+export declare const NEUTRAL_HEALTH_SCORE = 0;
+/** Penalty applied per recent (non-decayed) failure. Dominates the score. */
+export declare const FAILURE_PENALTY = 100;
+/** Small bonus per recent success; capped so successes can't bury failures. */
+export declare const SUCCESS_BONUS = 1;
+/** Max successes counted toward the bonus (prevents long-run inflation). */
+export declare const MAX_SUCCESS_BONUS_COUNT = 20;
+/**
+ * EWMA smoothing factor for latency (0..1). Higher = more weight on the
+ * newest sample. 0.3 is a conservative default.
+ */
+export declare const LATENCY_EWMA_ALPHA = 0.3;
+/**
+ * Latency tie-break coefficient. Subtracted as
+ *   (ewmaLatencyMs / LATENCY_TIEBREAK_MS) * LATENCY_TIEBREAK_WEIGHT
+ * so a 1s difference moves the score by ~0.01 — never enough to override a
+ * failure penalty.
+ */
+export declare const LATENCY_TIEBREAK_MS = 1000;
+export declare const LATENCY_TIEBREAK_WEIGHT = 0.01;
+/** Successes older than this window stop contributing the success bonus. */
+export declare const SUCCESS_DECAY_MS: number;
+export interface OutcomeInput {
+    ok: boolean;
+    /** Observed end-to-end latency in milliseconds, when known. */
+    latencyMs?: number;
+    /** Override clock for tests. Defaults to Date.now(). */
+    at?: Date | number;
+}
+export interface ProviderModelHealth {
+    providerId: string;
+    modelId: string;
+    successCount: number;
+    failureCount: number;
+    /** Epoch ms of the most recent failure, if any. */
+    lastFailureAt?: number;
+    /** Epoch ms of the most recent success, if any. */
+    lastSuccessAt?: number;
+    /** Exponentially-weighted moving average of observed latency, ms. */
+    ewmaLatencyMs?: number;
+    /**
+     * Epoch-ms timestamps of recent failures still inside the decay window.
+     * Pruned lazily on read/score.
+     */
+    recentFailureAts: number[];
+    /**
+     * Epoch-ms timestamps of recent successes still inside the decay window.
+     * Pruned lazily on read/score.
+     */
+    recentSuccessAts: number[];
+    updatedAt: number;
+}
+/** Narrow surface the router/delegation depend on. */
+export interface ProviderHealthTracker {
+    recordOutcome(providerId: string, modelId: string, outcome: OutcomeInput): void;
+    healthScore(providerId: string, modelId: string): number;
+    get(providerId: string, modelId: string): ProviderModelHealth | undefined;
+    /** Optional async flush for file-backed trackers. No-op in memory. */
+    flush?(): Promise<void>;
+}
+export interface InMemoryProviderHealthTrackerOptions {
+    now?: () => number;
+}
+/**
+ * Pure scoring function over a (possibly missing) health record.
+ * Exported for unit tests so they can pin the formula without a tracker.
+ */
+export declare function scoreHealthRecord(record: ProviderModelHealth | undefined, nowMs: number): number;
+export declare class InMemoryProviderHealthTracker implements ProviderHealthTracker {
+    #private;
+    constructor(options?: InMemoryProviderHealthTrackerOptions);
+    recordOutcome(providerId: string, modelId: string, outcome: OutcomeInput): void;
+    healthScore(providerId: string, modelId: string): number;
+    get(providerId: string, modelId: string): ProviderModelHealth | undefined;
+    /** Snapshot of all known records (for persistence / tests). */
+    list(): ProviderModelHealth[];
+    /** Replace internal state (used by file-backed load). */
+    loadRecords(records: Iterable<ProviderModelHealth>): void;
+    toJSON(): Record<string, unknown>;
+}
+export interface FileProviderHealthTrackerFileSystem {
+    mkdir: typeof mkdir;
+    readFile: typeof readFile;
+    rename: typeof rename;
+    unlink: typeof unlink;
+    writeFile: typeof writeFile;
+    chmod: typeof chmod;
+}
+export interface FileProviderHealthTrackerOptions {
+    /** Absolute path (typically `$OFFROUTER_HOME/state/provider-health.json`). */
+    filePath: string;
+    fileSystem?: Partial<FileProviderHealthTrackerFileSystem>;
+    now?: () => number;
+    /** Flush to disk after every recordOutcome. Default true. */
+    autoSave?: boolean;
+}
+interface PersistedHealthDocument {
+    version: 1;
+    records: ProviderModelHealth[];
+}
+/**
+ * Parse a persisted health document leniently. Missing/corrupt => empty.
+ */
+export declare function parseHealthDocument(raw: string): PersistedHealthDocument;
+/**
+ * File-backed tracker. Mirrors FileUsageStore safety:
+ * - atomic write via temp + rename
+ * - chmod 0600 on POSIX
+ * - missing/corrupt file => empty state, never throws on load
+ */
+export declare class FileProviderHealthTracker implements ProviderHealthTracker {
+    #private;
+    readonly filePath: string;
+    constructor(options: FileProviderHealthTrackerOptions);
+    /** Load once. Never throws. */
+    load(): Promise<void>;
+    recordOutcome(providerId: string, modelId: string, outcome: OutcomeInput): void;
+    healthScore(providerId: string, modelId: string): number;
+    get(providerId: string, modelId: string): ProviderModelHealth | undefined;
+    flush(): Promise<void>;
+    /** Explicit save alias used by tests. */
+    save(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=provider-health.d.ts.map

package/dist/provider-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-health.d.ts","sourceRoot":"","sources":["../src/provider-health.ts"],"names":[],"mappings":"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"}

package/dist/provider-health.js

@@ -0,0 +1,423 @@
+/**
+ * Recent-outcome health tracker for same-tier candidate re-ordering.
+ *
+ * Keeps a small per-(provider, model) record of successes, failures, and an
+ * EWMA of observed latency. Used by the router to stable-sort candidates
+ * *within* the same auth tier only — tier order is never crossed.
+ *
+ * Scoring (documented constants below):
+ *   1. Failures older than FAILURE_DECAY_MS stop counting (hard cut-off).
+ *   2. Each recent failure subtracts FAILURE_PENALTY from a neutral baseline.
+ *   3. Recent successes add SUCCESS_BONUS (capped) so a recovering provider
+ *      climbs back above peers that are merely unknown.
+ *   4. EWMA latency is a tiny tie-break only (higher latency -> lower score).
+ *
+ * Unknown providers (never recorded) score NEUTRAL_HEALTH_SCORE — they are
+ * not penalized. That keeps brand-new candidates competitive.
+ *
+ * Persistence (optional): JSON file at `state/provider-health.json` following
+ * the FileUsageStore pattern (atomic write, 0600, corrupt => empty).
+ */
+import { readFileSync } from "node:fs";
+import { chmod, mkdir, readFile, rename, unlink, writeFile, } from "node:fs/promises";
+import { dirname } from "node:path";
+import { randomBytes } from "node:crypto";
+// ---------------------------------------------------------------------------
+// Documented scoring constants (ponytail-style: named, not magic numbers)
+// ---------------------------------------------------------------------------
+/** Failures older than this window stop counting toward the score. */
+export const FAILURE_DECAY_MS = 10 * 60 * 1000; // 10 minutes
+/** Baseline score for unknown / never-seen provider+model pairs. */
+export const NEUTRAL_HEALTH_SCORE = 0;
+/** Penalty applied per recent (non-decayed) failure. Dominates the score. */
+export const FAILURE_PENALTY = 100;
+/** Small bonus per recent success; capped so successes can't bury failures. */
+export const SUCCESS_BONUS = 1;
+/** Max successes counted toward the bonus (prevents long-run inflation). */
+export const MAX_SUCCESS_BONUS_COUNT = 20;
+/**
+ * EWMA smoothing factor for latency (0..1). Higher = more weight on the
+ * newest sample. 0.3 is a conservative default.
+ */
+export const LATENCY_EWMA_ALPHA = 0.3;
+/**
+ * Latency tie-break coefficient. Subtracted as
+ *   (ewmaLatencyMs / LATENCY_TIEBREAK_MS) * LATENCY_TIEBREAK_WEIGHT
+ * so a 1s difference moves the score by ~0.01 — never enough to override a
+ * failure penalty.
+ */
+export const LATENCY_TIEBREAK_MS = 1000;
+export const LATENCY_TIEBREAK_WEIGHT = 0.01;
+/** Successes older than this window stop contributing the success bonus. */
+export const SUCCESS_DECAY_MS = FAILURE_DECAY_MS;
+// ---------------------------------------------------------------------------
+// Scoring
+// ---------------------------------------------------------------------------
+function keyOf(providerId, modelId) {
+    return `${providerId}\0${modelId}`;
+}
+/**
+ * Pure scoring function over a (possibly missing) health record.
+ * Exported for unit tests so they can pin the formula without a tracker.
+ */
+export function scoreHealthRecord(record, nowMs) {
+    if (!record)
+        return NEUTRAL_HEALTH_SCORE;
+    const failureCutoff = nowMs - FAILURE_DECAY_MS;
+    const successCutoff = nowMs - SUCCESS_DECAY_MS;
+    const recentFailures = record.recentFailureAts.filter((t) => t >= failureCutoff).length;
+    const recentSuccesses = record.recentSuccessAts.filter((t) => t >= successCutoff).length;
+    // No observations currently in the window => treat as neutral:
+    // long-idle providers shouldn't keep a permanent rust penalty/bonus.
+    if (recentFailures === 0 && recentSuccesses === 0) {
+        // If we have never seen anything either, this is still neutral.
+        // Having historical totals outside the window also decays to neutral.
+        return NEUTRAL_HEALTH_SCORE;
+    }
+    const successBonus = Math.min(recentSuccesses, MAX_SUCCESS_BONUS_COUNT) * SUCCESS_BONUS;
+    const failurePenalty = recentFailures * FAILURE_PENALTY;
+    let latencyPenalty = 0;
+    if (record.ewmaLatencyMs !== undefined &&
+        Number.isFinite(record.ewmaLatencyMs) &&
+        record.ewmaLatencyMs > 0) {
+        latencyPenalty =
+            (record.ewmaLatencyMs / LATENCY_TIEBREAK_MS) * LATENCY_TIEBREAK_WEIGHT;
+    }
+    return NEUTRAL_HEALTH_SCORE + successBonus - failurePenalty - latencyPenalty;
+}
+// ---------------------------------------------------------------------------
+// In-memory tracker
+// ---------------------------------------------------------------------------
+export class InMemoryProviderHealthTracker {
+    #records = new Map();
+    #now;
+    constructor(options = {}) {
+        this.#now = options.now ?? (() => Date.now());
+    }
+    recordOutcome(providerId, modelId, outcome) {
+        const atMs = toEpochMs(outcome.at) ?? this.#now();
+        const key = keyOf(providerId, modelId);
+        let record = this.#records.get(key);
+        if (!record) {
+            record = {
+                providerId,
+                modelId,
+                successCount: 0,
+                failureCount: 0,
+                recentFailureAts: [],
+                recentSuccessAts: [],
+                updatedAt: atMs,
+            };
+            this.#records.set(key, record);
+        }
+        this.#prune(record, atMs);
+        if (outcome.ok) {
+            record.successCount += 1;
+            record.lastSuccessAt = atMs;
+            record.recentSuccessAts.push(atMs);
+        }
+        else {
+            record.failureCount += 1;
+            record.lastFailureAt = atMs;
+            record.recentFailureAts.push(atMs);
+        }
+        if (outcome.latencyMs !== undefined &&
+            Number.isFinite(outcome.latencyMs) &&
+            outcome.latencyMs >= 0) {
+            if (record.ewmaLatencyMs === undefined) {
+                record.ewmaLatencyMs = outcome.latencyMs;
+            }
+            else {
+                record.ewmaLatencyMs =
+                    LATENCY_EWMA_ALPHA * outcome.latencyMs +
+                        (1 - LATENCY_EWMA_ALPHA) * record.ewmaLatencyMs;
+            }
+        }
+        record.updatedAt = atMs;
+    }
+    healthScore(providerId, modelId) {
+        const nowMs = this.#now();
+        const record = this.#records.get(keyOf(providerId, modelId));
+        if (record)
+            this.#prune(record, nowMs);
+        return scoreHealthRecord(record, nowMs);
+    }
+    get(providerId, modelId) {
+        const record = this.#records.get(keyOf(providerId, modelId));
+        if (!record)
+            return undefined;
+        this.#prune(record, this.#now());
+        return cloneRecord(record);
+    }
+    /** Snapshot of all known records (for persistence / tests). */
+    list() {
+        const nowMs = this.#now();
+        const out = [];
+        for (const record of this.#records.values()) {
+            this.#prune(record, nowMs);
+            out.push(cloneRecord(record));
+        }
+        return out.sort((a, b) => {
+            if (a.providerId !== b.providerId) {
+                return a.providerId.localeCompare(b.providerId);
+            }
+            return a.modelId.localeCompare(b.modelId);
+        });
+    }
+    /** Replace internal state (used by file-backed load). */
+    loadRecords(records) {
+        this.#records.clear();
+        for (const raw of records) {
+            if (typeof raw.providerId !== "string" ||
+                typeof raw.modelId !== "string") {
+                continue;
+            }
+            const record = {
+                providerId: raw.providerId,
+                modelId: raw.modelId,
+                successCount: typeof raw.successCount === "number" ? raw.successCount : 0,
+                failureCount: typeof raw.failureCount === "number" ? raw.failureCount : 0,
+                lastFailureAt: typeof raw.lastFailureAt === "number" ? raw.lastFailureAt : undefined,
+                lastSuccessAt: typeof raw.lastSuccessAt === "number" ? raw.lastSuccessAt : undefined,
+                ewmaLatencyMs: typeof raw.ewmaLatencyMs === "number" ? raw.ewmaLatencyMs : undefined,
+                recentFailureAts: Array.isArray(raw.recentFailureAts)
+                    ? raw.recentFailureAts.filter((t) => typeof t === "number")
+                    : [],
+                recentSuccessAts: Array.isArray(raw.recentSuccessAts)
+                    ? raw.recentSuccessAts.filter((t) => typeof t === "number")
+                    : [],
+                updatedAt: typeof raw.updatedAt === "number" ? raw.updatedAt : 0,
+            };
+            this.#records.set(keyOf(record.providerId, record.modelId), record);
+        }
+    }
+    toJSON() {
+        return {
+            kind: "in-memory-provider-health",
+            records: this.list(),
+        };
+    }
+    #prune(record, nowMs) {
+        const failureCutoff = nowMs - FAILURE_DECAY_MS;
+        const successCutoff = nowMs - SUCCESS_DECAY_MS;
+        record.recentFailureAts = record.recentFailureAts.filter((t) => t >= failureCutoff);
+        record.recentSuccessAts = record.recentSuccessAts.filter((t) => t >= successCutoff);
+    }
+}
+const EMPTY_DOC = { version: 1, records: [] };
+/**
+ * Parse a persisted health document leniently. Missing/corrupt => empty.
+ */
+export function parseHealthDocument(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { ...EMPTY_DOC, records: [] };
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return { ...EMPTY_DOC, records: [] };
+    }
+    const record = parsed;
+    const recordsRaw = record.records;
+    if (!Array.isArray(recordsRaw)) {
+        return { ...EMPTY_DOC, records: [] };
+    }
+    const records = [];
+    for (const value of recordsRaw) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            continue;
+        }
+        const entry = value;
+        if (typeof entry.providerId !== "string" ||
+            typeof entry.modelId !== "string") {
+            continue;
+        }
+        records.push({
+            providerId: entry.providerId,
+            modelId: entry.modelId,
+            successCount: typeof entry.successCount === "number" ? entry.successCount : 0,
+            failureCount: typeof entry.failureCount === "number" ? entry.failureCount : 0,
+            lastFailureAt: typeof entry.lastFailureAt === "number"
+                ? entry.lastFailureAt
+                : undefined,
+            lastSuccessAt: typeof entry.lastSuccessAt === "number"
+                ? entry.lastSuccessAt
+                : undefined,
+            ewmaLatencyMs: typeof entry.ewmaLatencyMs === "number"
+                ? entry.ewmaLatencyMs
+                : undefined,
+            recentFailureAts: Array.isArray(entry.recentFailureAts)
+                ? entry.recentFailureAts.filter((t) => typeof t === "number")
+                : [],
+            recentSuccessAts: Array.isArray(entry.recentSuccessAts)
+                ? entry.recentSuccessAts.filter((t) => typeof t === "number")
+                : [],
+            updatedAt: typeof entry.updatedAt === "number" ? entry.updatedAt : 0,
+        });
+    }
+    return { version: 1, records };
+}
+/**
+ * File-backed tracker. Mirrors FileUsageStore safety:
+ * - atomic write via temp + rename
+ * - chmod 0600 on POSIX
+ * - missing/corrupt file => empty state, never throws on load
+ */
+export class FileProviderHealthTracker {
+    filePath;
+    #fs;
+    #delegate;
+    #autoSave;
+    #loaded = false;
+    #chain = Promise.resolve();
+    constructor(options) {
+        if (!options?.filePath || typeof options.filePath !== "string") {
+            throw new TypeError("FileProviderHealthTracker requires options.filePath");
+        }
+        this.filePath = options.filePath;
+        this.#delegate = new InMemoryProviderHealthTracker({ now: options.now });
+        this.#autoSave = options.autoSave !== false;
+        this.#fs = {
+            mkdir,
+            readFile,
+            rename,
+            unlink,
+            writeFile,
+            chmod,
+            ...options.fileSystem,
+        };
+    }
+    #exclusive(fn) {
+        const run = this.#chain.then(fn, fn);
+        this.#chain = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    /** Load once. Never throws. */
+    async load() {
+        if (this.#loaded)
+            return;
+        try {
+            const raw = await this.#fs.readFile(this.filePath, "utf8");
+            const doc = parseHealthDocument(raw);
+            this.#delegate.loadRecords(doc.records);
+        }
+        catch (err) {
+            if (err &&
+                typeof err === "object" &&
+                "code" in err &&
+                err.code === "ENOENT") {
+                // missing file => empty
+            }
+            else {
+                // Any other read failure is treated as empty so a bad write can never
+                // wedge the CLI.
+            }
+            this.#delegate.loadRecords([]);
+        }
+        this.#loaded = true;
+    }
+    /** Synchronous load (used by healthScore/get before first async load). */
+    #loadSync() {
+        if (this.#loaded)
+            return;
+        try {
+            const raw = readFileSync(this.filePath, "utf8");
+            const doc = parseHealthDocument(raw);
+            this.#delegate.loadRecords(doc.records);
+        }
+        catch {
+            this.#delegate.loadRecords([]);
+        }
+        this.#loaded = true;
+    }
+    recordOutcome(providerId, modelId, outcome) {
+        this.#loadSync();
+        this.#delegate.recordOutcome(providerId, modelId, outcome);
+        if (this.#autoSave) {
+            // Fire-and-forget save serialized through the chain; errors swallowed so
+            // recording never breaks delegation.
+            void this.#exclusive(async () => {
+                try {
+                    await this.#persist();
+                }
+                catch {
+                    // non-fatal
+                }
+            });
+        }
+    }
+    healthScore(providerId, modelId) {
+        this.#loadSync();
+        return this.#delegate.healthScore(providerId, modelId);
+    }
+    get(providerId, modelId) {
+        this.#loadSync();
+        return this.#delegate.get(providerId, modelId);
+    }
+    async flush() {
+        this.#loadSync();
+        await this.#exclusive(async () => {
+            await this.#persist();
+        });
+    }
+    /** Explicit save alias used by tests. */
+    async save() {
+        await this.flush();
+    }
+    async #persist() {
+        const payload = `${JSON.stringify({
+            version: 1,
+            records: this.#delegate.list(),
+        }, null, 2)}\n`;
+        await this.#fs.mkdir(dirname(this.filePath), { recursive: true });
+        const tmp = `${this.filePath}.${randomBytes(8).toString("hex")}.tmp`;
+        try {
+            await this.#fs.writeFile(tmp, payload, {
+                encoding: "utf8",
+                mode: 0o600,
+            });
+            await this.#fs.chmod(tmp, 0o600);
+            await this.#fs.rename(tmp, this.filePath);
+            await this.#fs.chmod(this.filePath, 0o600);
+        }
+        catch (err) {
+            await this.#fs.unlink(tmp).catch((unlinkErr) => {
+                if (unlinkErr &&
+                    typeof unlinkErr === "object" &&
+                    "code" in unlinkErr &&
+                    unlinkErr.code === "ENOENT") {
+                    return;
+                }
+                throw unlinkErr;
+            });
+            throw err;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function toEpochMs(at) {
+    if (at === undefined)
+        return undefined;
+    if (typeof at === "number")
+        return at;
+    return at.getTime();
+}
+function cloneRecord(record) {
+    return {
+        providerId: record.providerId,
+        modelId: record.modelId,
+        successCount: record.successCount,
+        failureCount: record.failureCount,
+        lastFailureAt: record.lastFailureAt,
+        lastSuccessAt: record.lastSuccessAt,
+        ewmaLatencyMs: record.ewmaLatencyMs,
+        recentFailureAts: [...record.recentFailureAts],
+        recentSuccessAts: [...record.recentSuccessAts],
+        updatedAt: record.updatedAt,
+    };
+}
+//# sourceMappingURL=provider-health.js.map

package/dist/provider-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-health.js","sourceRoot":"","sources":["../src/provider-health.ts"],"names":[],"mappings":"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"}

package/dist/providers/catalog-data.d.ts

@@ -15,6 +15,7 @@
  * by these OpenAI-compatible provider entries.
  */
 import { z } from "zod";
+import type { ConfiguredProvider } from "../config.js";
 import type { AuthScope, AuthTier } from "../types.js";
 import type { LogicalModelFamily } from "./catalog.js";
 import type { OpenAiCompatibleFlavor } from "./openai-compatible.js";
@@ -108,6 +109,12 @@ export declare const BuiltinCatalogConfigSchema: z.ZodRecord<z.ZodString, z.ZodO
  * Lets callers validate provider catalog overrides at runtime.
  */
 export declare function parseBuiltinCatalogConfig(input: unknown): BuiltinCatalogConfig;
+/**
+ * Derive a BuiltinCatalogConfig from the parsed user config providers map.
+ * Only `enabled` and `baseUrl` carry over; configured accounts are orthogonal
+ * to the static provider/model metadata.
+ */
+export declare function builtinCatalogConfigFromProviders(providers: Record<string, ConfiguredProvider>): BuiltinCatalogConfig;
 /**
  * Built-in providers. Subscription-backed first-party login happens through the
  * harness adapters (claude/codex/gemini/grok), not these api endpoints, so each

package/dist/providers/catalog-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-data.d.ts","sourceRoot":"","sources":["../../src/providers/catalog-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,MAAM,EAAE,sBAAsB,CAAC;IAC/B,iEAAiE;IACjE,eAAe,EAAE,QAAQ,CAAC;IAC1B,kEAAkE;IAClE,gBAAgB,EAAE,SAAS,CAAC;IAC5B;;;;OAIG;IACH,2BAA2B,EAAE,OAAO,CAAC;IACrC,oEAAoE;IACpE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAazE,eAAO,MAAM,2BAA2B;;;;;;;;;EAE7B,CAAC;AAEZ,qDAAqD;AACrD,eAAO,MAAM,0BAA0B;;;;;;;;;GAGtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,oBAAoB,CAEtB;AAcD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,oBAAoB,EAgU5D,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAEjD,CAAC;AAEF,yCAAyC;AACzC,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GACjB,oBAAoB,GAAG,SAAS,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,oBAAyB,GAChC,oBAAoB,EAAE,CAgBxB"}
+{"version":3,"file":"catalog-data.d.ts","sourceRoot":"","sources":["../../src/providers/catalog-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,MAAM,EAAE,sBAAsB,CAAC;IAC/B,iEAAiE;IACjE,eAAe,EAAE,QAAQ,CAAC;IAC1B,kEAAkE;IAClE,gBAAgB,EAAE,SAAS,CAAC;IAC5B;;;;OAIG;IACH,2BAA2B,EAAE,OAAO,CAAC;IACrC,oEAAoE;IACpE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAazE,eAAO,MAAM,2BAA2B;;;;;;;;;EAE7B,CAAC;AAEZ,qDAAqD;AACrD,eAAO,MAAM,0BAA0B;;;;;;;;;GAGtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,oBAAoB,CAEtB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC5C,oBAAoB,CAUtB;AASD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,oBAAoB,EA2Y5D,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAEjD,CAAC;AAEF,yCAAyC;AACzC,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GACjB,oBAAoB,GAAG,SAAS,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,oBAAyB,GAChC,oBAAoB,EAAE,CAgBxB"}