tokenmeter 0.9.0

package/dist/pricing/index.js

@@ -0,0 +1,251 @@
+/**
+ * Pricing Module
+ *
+ * Loads and provides access to standardized pricing data for all providers.
+ * Pricing files are JSON and can be contributed via PRs.
+ */
+import { getCurrentPricing, getPricingAtDate, getDefaultUnitSize, } from "./schema.js";
+// Import provider pricing files
+import openaiPricing from "./providers/openai.json" with { type: "json" };
+import anthropicPricing from "./providers/anthropic.json" with { type: "json" };
+import elevenlabsPricing from "./providers/elevenlabs.json" with { type: "json" };
+import falPricing from "./providers/fal.json" with { type: "json" };
+export { getCurrentPricing, getPricingAtDate, getDefaultUnitSize };
+/**
+ * All provider pricing data
+ */
+export const providers = {
+    openai: openaiPricing,
+    anthropic: anthropicPricing,
+    elevenlabs: elevenlabsPricing,
+    fal: falPricing,
+};
+/**
+ * Build a flat PricingConfig from the JSON provider files
+ * This provides backward compatibility with the old pricing format
+ */
+function buildDefaultPricing() {
+    const pricing = {};
+    for (const [providerId, providerData] of Object.entries(providers)) {
+        for (const [modelId, model] of Object.entries(providerData.models)) {
+            const currentPricing = getCurrentPricing(model);
+            if (!currentPricing)
+                continue;
+            const unitSize = model.unitSize ?? getDefaultUnitSize(model.unit);
+            // For token/character-based pricing, convert to per-1K
+            // For image/video/request-based pricing, keep as-is (unitSize is 1)
+            // JSON files store prices per unitSize, old format uses per 1K for tokens
+            let inputPrice = currentPricing.input ?? 0;
+            let outputPrice = currentPricing.output ?? 0;
+            let cachedInputPrice = currentPricing.cachedInput;
+            // Only apply conversion for token/character based models
+            if (model.unit === "tokens" || model.unit === "characters") {
+                const multiplier = unitSize / 1000;
+                inputPrice = inputPrice / multiplier;
+                outputPrice = outputPrice / multiplier;
+                if (cachedInputPrice !== undefined) {
+                    cachedInputPrice = cachedInputPrice / multiplier;
+                }
+            }
+            const modelPricing = {
+                input: inputPrice,
+                output: outputPrice,
+            };
+            if (cachedInputPrice !== undefined) {
+                modelPricing.cachedInput = cachedInputPrice;
+            }
+            // Add with provider prefix
+            pricing[`${providerId}/${modelId}`] = modelPricing;
+            // Add without prefix
+            pricing[modelId] = modelPricing;
+            // Add aliases
+            if (model.aliases) {
+                for (const alias of model.aliases) {
+                    pricing[alias] = modelPricing;
+                }
+            }
+        }
+    }
+    return pricing;
+}
+/**
+ * Default pricing in flat format (backward compatible)
+ */
+export const defaultPricing = buildDefaultPricing();
+/**
+ * Merge custom pricing with defaults
+ */
+export function mergePricing(base, overrides) {
+    return { ...base, ...overrides };
+}
+/**
+ * Calculate cost for a model (backward compatible API)
+ *
+ * @param model - Model identifier
+ * @param inputTokens - Number of input tokens
+ * @param outputTokens - Number of output tokens
+ * @param pricing - Pricing configuration
+ * @param cachedInputTokens - Optional number of cached input tokens
+ * @returns Cost in USD
+ */
+export function calculateCost(model, inputTokens, outputTokens, pricing, cachedInputTokens) {
+    const modelPricing = pricing[model];
+    if (!modelPricing) {
+        console.warn(`[tokenmeter] No pricing found for model: ${model}`);
+        return 0;
+    }
+    let cost = 0;
+    // Calculate input cost (per 1K tokens)
+    cost += (inputTokens / 1000) * modelPricing.input;
+    // Calculate output cost (per 1K tokens)
+    cost += (outputTokens / 1000) * modelPricing.output;
+    // Calculate cached input cost if applicable
+    if (cachedInputTokens && modelPricing.cachedInput) {
+        cost += (cachedInputTokens / 1000) * modelPricing.cachedInput;
+    }
+    return cost;
+}
+/**
+ * Build a flat lookup map from model ID to pricing info
+ * Includes aliases and provider-prefixed versions
+ */
+function buildPricingLookup() {
+    const lookup = new Map();
+    for (const [providerId, providerData] of Object.entries(providers)) {
+        for (const [modelId, model] of Object.entries(providerData.models)) {
+            const entry = { provider: providerId, modelId, model };
+            // Add base model ID
+            lookup.set(modelId, entry);
+            // Add provider-prefixed version
+            lookup.set(`${providerId}/${modelId}`, entry);
+            // Add aliases
+            if (model.aliases) {
+                for (const alias of model.aliases) {
+                    lookup.set(alias, entry);
+                    // Also add without provider prefix if it has one
+                    if (alias.includes("/")) {
+                        const withoutPrefix = alias.split("/").slice(1).join("/");
+                        if (withoutPrefix && !lookup.has(withoutPrefix)) {
+                            lookup.set(withoutPrefix, entry);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return lookup;
+}
+// Cached lookup map
+let pricingLookup = null;
+/**
+ * Get the pricing lookup map (lazily built and cached)
+ */
+function getLookup() {
+    if (!pricingLookup) {
+        pricingLookup = buildPricingLookup();
+    }
+    return pricingLookup;
+}
+/**
+ * Clear the pricing lookup cache (useful for testing or dynamic updates)
+ */
+export function clearPricingCache() {
+    pricingLookup = null;
+}
+/**
+ * Get pricing for a specific model (new API)
+ *
+ * @param modelId - Model identifier (e.g., "gpt-4o", "openai/gpt-4o", "claude-3.5-sonnet")
+ * @param date - Optional date to get historical pricing (defaults to current)
+ * @returns Resolved pricing or null if not found
+ */
+export function getModelPricing(modelId, date) {
+    const lookup = getLookup();
+    const entry = lookup.get(modelId);
+    if (!entry) {
+        return null;
+    }
+    const pricingEntry = date
+        ? getPricingAtDate(entry.model, date)
+        : getCurrentPricing(entry.model);
+    if (!pricingEntry) {
+        return null;
+    }
+    const unitSize = entry.model.unitSize ?? getDefaultUnitSize(entry.model.unit);
+    return {
+        provider: entry.provider,
+        model: entry.modelId,
+        unit: entry.model.unit,
+        unitSize,
+        input: pricingEntry.input ?? 0,
+        output: pricingEntry.output ?? 0,
+        cachedInput: pricingEntry.cachedInput,
+        cacheWrite: pricingEntry.cacheWrite,
+        effectiveDate: pricingEntry.effectiveDate,
+    };
+}
+/**
+ * Calculate cost based on usage (new API with usage object)
+ *
+ * @param modelId - Model identifier
+ * @param usage - Usage data (tokens, characters, images, etc.)
+ * @param date - Optional date for historical pricing
+ * @returns Cost in USD or null if pricing not found
+ */
+export function calculateCostFromUsage(modelId, usage, date) {
+    const pricing = getModelPricing(modelId, date);
+    if (!pricing) {
+        return null;
+    }
+    let cost = 0;
+    // Calculate input cost
+    if (usage.inputUnits && pricing.input) {
+        cost += (usage.inputUnits / pricing.unitSize) * pricing.input;
+    }
+    // Calculate output cost
+    if (usage.outputUnits && pricing.output) {
+        cost += (usage.outputUnits / pricing.unitSize) * pricing.output;
+    }
+    // Calculate cached input cost
+    if (usage.cachedInputUnits && pricing.cachedInput) {
+        cost += (usage.cachedInputUnits / pricing.unitSize) * pricing.cachedInput;
+    }
+    // Calculate cache write cost
+    if (usage.cacheWriteUnits && pricing.cacheWrite) {
+        cost += (usage.cacheWriteUnits / pricing.unitSize) * pricing.cacheWrite;
+    }
+    return cost;
+}
+/**
+ * Get all models for a provider
+ */
+export function getProviderModels(providerId) {
+    const provider = providers[providerId];
+    if (!provider) {
+        return [];
+    }
+    return Object.keys(provider.models);
+}
+/**
+ * Get all supported providers
+ */
+export function getSupportedProviders() {
+    return Object.keys(providers);
+}
+/**
+ * Check if a model is deprecated
+ */
+export function isModelDeprecated(modelId) {
+    const lookup = getLookup();
+    const entry = lookup.get(modelId);
+    return entry?.model.deprecated ?? false;
+}
+/**
+ * Get replacement model for a deprecated model
+ */
+export function getReplacementModel(modelId) {
+    const lookup = getLookup();
+    const entry = lookup.get(modelId);
+    return entry?.model.replacedBy ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

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

package/dist/pricing/manifest.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Pricing Manifest Fetcher
+ *
+ * Remote-first pricing with local fallback for reliability.
+ * Fetches latest pricing from CDN, falls back to bundled data if unavailable.
+ */
+import type { PricingManifest, ModelPricing } from "../types.js";
+/**
+ * Model alias mapping for custom model names
+ */
+export interface ModelAlias {
+    /** Target provider for pricing lookup */
+    provider: string;
+    /** Target model ID for pricing lookup */
+    model: string;
+}
+/**
+ * Configuration for pricing manifest loading
+ */
+export interface PricingConfig {
+    /**
+     * URL to fetch the pricing manifest from the API.
+     * @default https://pricing.tokenmeter.dev/api/v1
+     */
+    apiUrl?: string;
+    /**
+     * Fallback CDN URL if API is unavailable.
+     * @default jsdelivr CDN URL
+     */
+    cdnUrl?: string;
+    /**
+     * Legacy: URL to fetch the pricing manifest from.
+     * @deprecated Use apiUrl instead
+     */
+    manifestUrl?: string;
+    /**
+     * If true, skip remote fetching and only use bundled local pricing.
+     * Useful for offline environments or when you want predictable pricing.
+     * @default false
+     */
+    offlineMode?: boolean;
+    /**
+     * Timeout for remote manifest fetch in milliseconds.
+     * @default 5000
+     */
+    fetchTimeout?: number;
+    /**
+     * Cache timeout in milliseconds. Manifest will be refetched after this duration.
+     * @default 300000 (5 minutes)
+     */
+    cacheTimeout?: number;
+    /**
+     * Custom model aliases for pricing lookup.
+     * Maps custom model names to their canonical provider/model for pricing.
+     *
+     * @example
+     * ```typescript
+     * configurePricing({
+     *   modelAliases: {
+     *     "bedrock-claude-4-5-sonnet": { provider: "bedrock", model: "anthropic.claude-sonnet-4-5" },
+     *     "my-gpt": { provider: "openai", model: "gpt-4o" },
+     *   }
+     * });
+     * ```
+     */
+    modelAliases?: Record<string, ModelAlias>;
+}
+/**
+ * Configure global pricing settings.
+ *
+ * @example
+ * ```typescript
+ * import { configurePricing } from 'tokenmeter';
+ *
+ * // Use custom CDN
+ * configurePricing({ manifestUrl: 'https://your-cdn.com/manifest.json' });
+ *
+ * // Offline mode (bundled pricing only)
+ * configurePricing({ offlineMode: true });
+ *
+ * // Custom model aliases
+ * configurePricing({
+ *   modelAliases: {
+ *     "bedrock-claude-4-5-sonnet": { provider: "bedrock", model: "anthropic.claude-sonnet-4-5" },
+ *   }
+ * });
+ * ```
+ */
+export declare function configurePricing(config: PricingConfig): void;
+/**
+ * Get the current pricing configuration.
+ */
+export declare function getPricingConfig(): PricingConfig;
+/**
+ * Load the pricing manifest.
+ *
+ * Fetches from Pricing API first, then CDN, with automatic fallback
+ * to bundled local data if all remote sources are unavailable.
+ *
+ * @param options.apiUrl - Override the API URL
+ * @param options.cdnUrl - Override the CDN URL
+ * @param options.manifestUrl - Legacy: Override the manifest URL (deprecated)
+ * @param options.forceRefresh - Force reload even if cached
+ * @param options.offlineMode - Skip remote fetch, use local only
+ */
+export declare function loadManifest(options?: {
+    apiUrl?: string;
+    cdnUrl?: string;
+    manifestUrl?: string;
+    forceRefresh?: boolean;
+    offlineMode?: boolean;
+}): Promise<PricingManifest>;
+/**
+ * Get pricing for a specific model
+ */
+export declare function getModelPricing(provider: string, model: string, manifest: PricingManifest): ModelPricing | null;
+/**
+ * Calculate cost based on usage and pricing
+ */
+export declare function calculateCost(usage: {
+    inputUnits?: number;
+    outputUnits?: number;
+    cachedInputUnits?: number;
+}, pricing: ModelPricing): number;
+/**
+ * Get the cached manifest (or null if not loaded)
+ */
+export declare function getCachedManifest(): PricingManifest | null;
+/**
+ * Clear the manifest cache
+ */
+export declare function clearManifestCache(): void;
+/**
+ * Set model aliases for pricing lookup.
+ * Merges with existing aliases.
+ *
+ * @example
+ * ```typescript
+ * import { setModelAliases } from 'tokenmeter';
+ *
+ * setModelAliases({
+ *   "bedrock-claude-4-5-sonnet": { provider: "bedrock", model: "anthropic.claude-sonnet-4-5" },
+ *   "my-custom-gpt": { provider: "openai", model: "gpt-4o" },
+ * });
+ * ```
+ */
+export declare function setModelAliases(aliases: Record<string, ModelAlias>): void;
+/**
+ * Clear all model aliases
+ */
+export declare function clearModelAliases(): void;
+/**
+ * Get current model aliases
+ */
+export declare function getModelAliases(): Record<string, ModelAlias>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/pricing/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/pricing/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAGb,MAAM,aAAa,CAAC;AAgBrB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC3C;AAaD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAU5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AA8ND;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CAClB,GACL,OAAO,CAAC,eAAe,CAAC,CA8D1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,eAAe,GACxB,YAAY,GAAG,IAAI,CAiCrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE;IACL,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,EACD,OAAO,EAAE,YAAY,GACpB,MAAM,CA0CR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAClC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAE5D"}