claude-pricing 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiangnuans
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# claude-pricing
+
+> Calculate and track Claude API costs from token usage. Bundled pricing table + custom overrides. **Zero dependencies.**
+
+```ts
+import { calculateCost, formatUSD, CostTracker } from "claude-pricing";
+
+// One-shot cost calculation
+const cost = calculateCost("claude-opus-4-7", {
+  input_tokens: 1500,
+  output_tokens: 800,
+  cache_read_input_tokens: 5000,
+});
+console.log(formatUSD(cost.total));  // "$0.0900"
+
+// Session tracker with budget alert
+const tracker = new CostTracker({
+  budgetUSD: 1.0,
+  onBudgetExceeded: (total, budget) =>
+    alert(`Budget blown: ${formatUSD(total)} > ${formatUSD(budget)}`),
+});
+
+tracker.add("claude-opus-4-7", usage, { label: "planning" });
+tracker.add("claude-sonnet-4-6", usage, { label: "draft" });
+
+console.log(formatUSD(tracker.total().total));
+console.log(tracker.byModel());
+```
+
+## Why this exists
+
+You're running Claude API in production. You want to know:
+
+- **What did this one call cost?** The SDK returns `usage` but doesn't tell you the dollars.
+- **Did this session blow my budget?** You want a running total across an agent loop.
+- **Where's my money going?** Per-model breakdown for cost optimization.
+- **What about cache and batch?** The pricing math is non-obvious (1.25× input for cache write, 50% off for batch).
+
+This package is ~180 lines of TypeScript. Zero deps. Bundled with up-to-date Anthropic pricing, but **everything is overridable** because list prices change and you may have a custom contract.
+
+## Install
+
+```bash
+npm install claude-pricing
+```
+
+## API
+
+### `calculateCost(model, usage, options?)`
+
+```ts
+function calculateCost(
+  model: string,
+  usage: TokenUsage,
+  options?: { pricing?: ModelPricing | Record<string, ModelPricing>; batch?: boolean }
+): CostBreakdown;
+```
+
+Returns `{ input, output, cacheWrite, cacheRead, total }` — all in USD.
+
+### `CostTracker`
+
+```ts
+const tracker = new CostTracker({
+  pricing?: customTable,
+  budgetUSD?: 5.00,
+  onBudgetExceeded?: (total, budget) => ...,
+});
+
+tracker.add(model, usage, { label?: 'step-1', batch?: true });
+tracker.total();      // { input, output, cacheWrite, cacheRead, total }
+tracker.byModel();    // { 'claude-opus-4-7': { calls, usage, breakdown }, ... }
+tracker.reset();
+tracker.getEntries(); // readonly array of { model, usage, breakdown, timestamp, label }
+```
+
+### `formatUSD(amount)`
+
+Smart-precision formatter:
+- `$1.23` for amounts ≥ $1
+- `$0.0123` for amounts ≥ $0.01
+- `$0.000123` for sub-cent
+
+### `ANTHROPIC_PRICING`
+
+The bundled default table (USD per million tokens):
+
+| Model | Input | Output | Cache write | Cache read |
+|---|---|---|---|---|
+| claude-opus-4-7 | $15 | $75 | $18.75 | $1.50 |
+| claude-sonnet-4-6 | $3 | $15 | $3.75 | $0.30 |
+| claude-haiku-4-5 | $0.80 | $4 | $1.00 | $0.08 |
+
+⚠️ **Snapshot taken 2026-05. Verify against [Anthropic pricing](https://docs.anthropic.com/en/docs/about-claude/pricing) for production.** Pass your own table via `options.pricing` for current rates.
+
+## Recipes
+
+### Override pricing for current rates
+
+```ts
+const myPricing = {
+  "claude-opus-4-7": { input: 14, output: 70 },  // discounted contract
+};
+const cost = calculateCost(model, usage, { pricing: myPricing });
+```
+
+### Use for any custom/fine-tuned model
+
+```ts
+const cost = calculateCost(
+  "my-fine-tune",
+  usage,
+  { pricing: { input: 8, output: 24 } }  // single ModelPricing
+);
+```
+
+### Pair with `claude-stream-collector`
+
+```ts
+import { collectStream } from "claude-stream-collector";
+import { calculateCost, formatUSD } from "claude-pricing";
+
+const result = await collectStream(stream);
+const cost = calculateCost(result.model, result.usage);
+console.log(formatUSD(cost.total));
+```
+
+The `TokenUsage` shape is compatible — pass result.usage directly.
+
+### Track an agent loop with budget cap
+
+```ts
+const tracker = new CostTracker({
+  budgetUSD: 0.10,
+  onBudgetExceeded: () => { throw new Error("Cost limit reached"); }
+});
+
+for (const step of agent.run()) {
+  tracker.add(step.model, step.usage, { label: step.name });
+  // throws automatically when total > $0.10
+}
+
+console.log(tracker.byModel());
+```
+
+### Batch API (50% off)
+
+```ts
+calculateCost(model, usage, { batch: true });
+// Or per add():
+tracker.add(model, usage, { batch: true });
+```
+
+## Tests & build
+
+```bash
+npm install
+npm test       # vitest run
+npm run build  # tsc
+```
+
+## License
+
+MIT — © 2026 xiangnuans
+
+## Part of a series
+
+The **3rd** package in small, focused Claude SDK helpers built in public.
+
+- ✅ [`claude-stream-collector`](https://github.com/xiangnuans/claude-stream-collector) — Consume streaming events into typed result
+- ✅ [`claude-retry`](https://github.com/xiangnuans/claude-retry) — Smart retry with backoff
+- ✅ `claude-pricing` — Cost calculation + session tracker (this package)
+- 🚧 `claude-prompt-toolkit` — Prompt templating, versioning
+
+Follow the journey: [ship-log-2026](https://github.com/xiangnuans/ship-log-2026).

package/dist/calculate.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Convert a `TokenUsage` record into a typed `CostBreakdown` (USD).
+ */
+import type { CostBreakdown, ModelPricing, TokenUsage } from "./types.js";
+export interface CalculateCostOptions {
+    /**
+     * Override the entire pricing table OR pass a single `ModelPricing` to use
+     * regardless of `model`.
+     */
+    pricing?: Record<string, ModelPricing> | ModelPricing;
+    /**
+     * Apply Anthropic batch API discount (50% off both input and output).
+     * Default: false
+     */
+    batch?: boolean;
+}
+/**
+ * Calculate cost in USD for a single Claude API call.
+ *
+ * @example
+ * ```ts
+ * const cost = calculateCost("claude-opus-4-7", {
+ *   input_tokens: 1000,
+ *   output_tokens: 500,
+ *   cache_read_input_tokens: 5000,
+ * });
+ * console.log(cost.total); // 0.0525
+ * ```
+ *
+ * @example Custom pricing override
+ * ```ts
+ * const cost = calculateCost("my-fine-tuned-model", usage, {
+ *   pricing: { input: 5, output: 20 },
+ * });
+ * ```
+ */
+export declare function calculateCost(model: string, usage: TokenUsage, options?: CalculateCostOptions): CostBreakdown;
+/**
+ * Format a cost amount as a USD string with reasonable precision.
+ *
+ * - amounts ≥ $1.00 → 2 decimals ($1.23)
+ * - amounts ≥ $0.01 → 4 decimals ($0.0123)
+ * - smaller → 6 decimals ($0.000123)
+ */
+export declare function formatUSD(amount: number): string;
+//# sourceMappingURL=calculate.d.ts.map

package/dist/calculate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate.d.ts","sourceRoot":"","sources":["../src/calculate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI1E,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAyBf;AAkBD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/calculate.js

@@ -0,0 +1,75 @@
+/**
+ * Convert a `TokenUsage` record into a typed `CostBreakdown` (USD).
+ */
+import { ANTHROPIC_PRICING, resolveModelAlias } from "./pricing-table.js";
+const MILLION = 1_000_000;
+/**
+ * Calculate cost in USD for a single Claude API call.
+ *
+ * @example
+ * ```ts
+ * const cost = calculateCost("claude-opus-4-7", {
+ *   input_tokens: 1000,
+ *   output_tokens: 500,
+ *   cache_read_input_tokens: 5000,
+ * });
+ * console.log(cost.total); // 0.0525
+ * ```
+ *
+ * @example Custom pricing override
+ * ```ts
+ * const cost = calculateCost("my-fine-tuned-model", usage, {
+ *   pricing: { input: 5, output: 20 },
+ * });
+ * ```
+ */
+export function calculateCost(model, usage, options = {}) {
+    const price = resolvePricing(model, options.pricing);
+    if (!price) {
+        const available = Object.keys(ANTHROPIC_PRICING).join(", ");
+        throw new Error(`claude-pricing: no pricing for model "${model}". Available defaults: ${available}. Pass an explicit pricing override via options.pricing.`);
+    }
+    const discount = options.batch ? 0.5 : 1;
+    const cacheWritePrice = price.cacheWrite ?? price.input * 1.25;
+    const cacheReadPrice = price.cacheRead ?? price.input * 0.1;
+    const input = (usage.input_tokens * price.input * discount) / MILLION;
+    const output = (usage.output_tokens * price.output * discount) / MILLION;
+    const cacheWrite = ((usage.cache_creation_input_tokens ?? 0) * cacheWritePrice) / MILLION;
+    const cacheRead = ((usage.cache_read_input_tokens ?? 0) * cacheReadPrice) / MILLION;
+    return {
+        input,
+        output,
+        cacheWrite,
+        cacheRead,
+        total: input + output + cacheWrite + cacheRead,
+    };
+}
+function resolvePricing(model, override) {
+    if (override) {
+        // Single ModelPricing — has `input` field directly
+        if ("input" in override && typeof override.input === "number") {
+            return override;
+        }
+        // Custom table
+        const table = override;
+        return resolveModelAlias(model, table) ?? table[model];
+    }
+    return resolveModelAlias(model);
+}
+/**
+ * Format a cost amount as a USD string with reasonable precision.
+ *
+ * - amounts ≥ $1.00 → 2 decimals ($1.23)
+ * - amounts ≥ $0.01 → 4 decimals ($0.0123)
+ * - smaller → 6 decimals ($0.000123)
+ */
+export function formatUSD(amount) {
+    const abs = Math.abs(amount);
+    let precision = 6;
+    if (abs >= 1)
+        precision = 2;
+    else if (abs >= 0.01)
+        precision = 4;
+    return `$${amount.toFixed(precision)}`;
+}
+//# sourceMappingURL=calculate.js.map

package/dist/calculate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate.js","sourceRoot":"","sources":["../src/calculate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG1E,MAAM,OAAO,GAAG,SAAS,CAAC;AAgB1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,KAAiB,EACjB,UAAgC,EAAE;IAElC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,yCAAyC,KAAK,0BAA0B,SAAS,0DAA0D,CAC5I,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IAC/D,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC;IAE5D,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC;IACtE,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC;IACzE,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,CAAC,GAAG,eAAe,CAAC,GAAG,OAAO,CAAC;IAC1F,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,CAAC,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC;IAEpF,OAAO;QACL,KAAK;QACL,MAAM;QACN,UAAU;QACV,SAAS;QACT,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS;KAC/C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAAa,EACb,QAAsD;IAEtD,IAAI,QAAQ,EAAE,CAAC;QACb,mDAAmD;QACnD,IAAI,OAAO,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9D,OAAO,QAAwB,CAAC;QAClC,CAAC;QACD,eAAe;QACf,MAAM,KAAK,GAAG,QAAwC,CAAC;QACvD,OAAO,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,GAAG,IAAI,CAAC;QAAE,SAAS,GAAG,CAAC,CAAC;SACvB,IAAI,GAAG,IAAI,IAAI;QAAE,SAAS,GAAG,CAAC,CAAC;IACpC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * claude-pricing
+ *
+ * Calculate and track Claude API costs from token usage.
+ * Bundled pricing table + custom overrides. Zero dependencies.
+ */
+export { calculateCost, formatUSD, type CalculateCostOptions } from "./calculate.js";
+export { CostTracker, type CostTrackerOptions } from "./tracker.js";
+export { ANTHROPIC_PRICING, resolveModelAlias } from "./pricing-table.js";
+export type { CostBreakdown, CostEntry, ModelPricing, ModelSummary, TokenUsage, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,YAAY,EACV,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * claude-pricing
+ *
+ * Calculate and track Claude API costs from token usage.
+ * Bundled pricing table + custom overrides. Zero dependencies.
+ */
+export { calculateCost, formatUSD } from "./calculate.js";
+export { CostTracker } from "./tracker.js";
+export { ANTHROPIC_PRICING, resolveModelAlias } from "./pricing-table.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAA6B,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pricing-table.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Default Anthropic pricing table — USD per million tokens (MTok).
+ *
+ * ⚠️ Snapshot taken 2026-05 from Anthropic's public pricing page. Prices change.
+ * For production use, pass your own `ModelPricing` override and verify against
+ * https://docs.anthropic.com/en/docs/about-claude/pricing.
+ *
+ * Cache pricing assumes the 5-minute ephemeral cache:
+ *   - cacheWrite = 1.25× input
+ *   - cacheRead  = 0.10× input
+ *
+ * For the 1-hour cache (Opus / Sonnet only): cacheWrite = 2× input.
+ */
+import type { ModelPricing } from "./types.js";
+export declare const ANTHROPIC_PRICING: Record<string, ModelPricing>;
+/**
+ * Best-effort model alias resolution.
+ *
+ * Strips date suffixes (`-20251001`) and `-latest` to find a base model entry.
+ * E.g. `claude-opus-4-7-20260301` → looks up `claude-opus-4-7`.
+ */
+export declare function resolveModelAlias(model: string, table?: Record<string, ModelPricing>): ModelPricing | undefined;
+//# sourceMappingURL=pricing-table.d.ts.map

package/dist/pricing-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-table.d.ts","sourceRoot":"","sources":["../src/pricing-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAkD1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAqB,GACtD,YAAY,GAAG,SAAS,CAY1B"}

package/dist/pricing-table.js

@@ -0,0 +1,81 @@
+/**
+ * Default Anthropic pricing table — USD per million tokens (MTok).
+ *
+ * ⚠️ Snapshot taken 2026-05 from Anthropic's public pricing page. Prices change.
+ * For production use, pass your own `ModelPricing` override and verify against
+ * https://docs.anthropic.com/en/docs/about-claude/pricing.
+ *
+ * Cache pricing assumes the 5-minute ephemeral cache:
+ *   - cacheWrite = 1.25× input
+ *   - cacheRead  = 0.10× input
+ *
+ * For the 1-hour cache (Opus / Sonnet only): cacheWrite = 2× input.
+ */
+export const ANTHROPIC_PRICING = {
+    // Claude Opus 4.7
+    "claude-opus-4-7": {
+        input: 15,
+        output: 75,
+        cacheWrite: 18.75,
+        cacheRead: 1.5,
+    },
+    // Claude Sonnet 4.6
+    "claude-sonnet-4-6": {
+        input: 3,
+        output: 15,
+        cacheWrite: 3.75,
+        cacheRead: 0.3,
+    },
+    // Claude Haiku 4.5
+    "claude-haiku-4-5": {
+        input: 0.8,
+        output: 4,
+        cacheWrite: 1,
+        cacheRead: 0.08,
+    },
+    "claude-haiku-4-5-20251001": {
+        input: 0.8,
+        output: 4,
+        cacheWrite: 1,
+        cacheRead: 0.08,
+    },
+    // Legacy / older — for users still on these
+    "claude-3-5-sonnet-latest": {
+        input: 3,
+        output: 15,
+        cacheWrite: 3.75,
+        cacheRead: 0.3,
+    },
+    "claude-3-5-haiku-latest": {
+        input: 0.8,
+        output: 4,
+        cacheWrite: 1,
+        cacheRead: 0.08,
+    },
+    "claude-3-opus-latest": {
+        input: 15,
+        output: 75,
+        cacheWrite: 18.75,
+        cacheRead: 1.5,
+    },
+};
+/**
+ * Best-effort model alias resolution.
+ *
+ * Strips date suffixes (`-20251001`) and `-latest` to find a base model entry.
+ * E.g. `claude-opus-4-7-20260301` → looks up `claude-opus-4-7`.
+ */
+export function resolveModelAlias(model, table = ANTHROPIC_PRICING) {
+    if (table[model])
+        return table[model];
+    // Strip trailing date (-YYYYMMDD)
+    const stripped = model.replace(/-\d{8}$/, "");
+    if (table[stripped])
+        return table[stripped];
+    // Strip -latest
+    const noLatest = model.replace(/-latest$/, "");
+    if (table[noLatest])
+        return table[noLatest];
+    return undefined;
+}
+//# sourceMappingURL=pricing-table.js.map

package/dist/pricing-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-table.js","sourceRoot":"","sources":["../src/pricing-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAiC;IAC7D,kBAAkB;IAClB,iBAAiB,EAAE;QACjB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,GAAG;KACf;IAED,oBAAoB;IACpB,mBAAmB,EAAE;QACnB,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,GAAG;KACf;IAED,mBAAmB;IACnB,kBAAkB,EAAE;QAClB,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,CAAC;QACT,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,IAAI;KAChB;IACD,2BAA2B,EAAE;QAC3B,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,CAAC;QACT,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,IAAI;KAChB;IAED,4CAA4C;IAC5C,0BAA0B,EAAE;QAC1B,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,GAAG;KACf;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,CAAC;QACT,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,IAAI;KAChB;IACD,sBAAsB,EAAE;QACtB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,GAAG;KACf;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,QAAsC,iBAAiB;IAEvD,IAAI,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtC,kCAAkC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE5C,gBAAgB;IAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE5C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/tracker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `CostTracker` — accumulate per-call costs across a session.
+ *
+ * Useful for long-running agents, multi-step pipelines, or anywhere you want
+ * a running budget total + per-model breakdown.
+ */
+import type { CostBreakdown, CostEntry, ModelPricing, ModelSummary, TokenUsage } from "./types.js";
+export interface CostTrackerOptions {
+    /** Pricing override applied to every `add()` call */
+    pricing?: Record<string, ModelPricing>;
+    /** Optional cost ceiling in USD; tracker emits a warning past this */
+    budgetUSD?: number;
+    /** Called when budget is exceeded (only fires once per add that crosses) */
+    onBudgetExceeded?: (total: number, budget: number) => void;
+}
+export declare class CostTracker {
+    private entries;
+    private opts;
+    private alertedBudget;
+    constructor(opts?: CostTrackerOptions);
+    /**
+     * Record a single call and return its computed breakdown.
+     */
+    add(model: string, usage: TokenUsage, options?: {
+        label?: string;
+        batch?: boolean;
+    }): CostBreakdown;
+    /**
+     * Total cost across all entries.
+     */
+    total(): CostBreakdown;
+    /**
+     * Per-model summary — call count, summed usage, summed cost.
+     */
+    byModel(): Record<string, ModelSummary>;
+    /** Number of recorded calls */
+    get callCount(): number;
+    /** Read-only access to entries */
+    getEntries(): readonly CostEntry[];
+    /** Reset all state */
+    reset(): void;
+    private checkBudget;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AAepB,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEvC,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,aAAa,CAAS;gBAElB,IAAI,GAAE,kBAAuB;IAIzC;;OAEG;IACH,GAAG,CACD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAChD,aAAa;IAmBhB;;OAEG;IACH,KAAK,IAAI,aAAa;IAatB;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAkCvC,+BAA+B;IAC/B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kCAAkC;IAClC,UAAU,IAAI,SAAS,SAAS,EAAE;IAIlC,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,WAAW;CASpB"}

package/dist/tracker.js

@@ -0,0 +1,112 @@
+/**
+ * `CostTracker` — accumulate per-call costs across a session.
+ *
+ * Useful for long-running agents, multi-step pipelines, or anywhere you want
+ * a running budget total + per-model breakdown.
+ */
+import { calculateCost } from "./calculate.js";
+const EMPTY_BREAKDOWN = {
+    input: 0,
+    output: 0,
+    cacheWrite: 0,
+    cacheRead: 0,
+    total: 0,
+};
+const EMPTY_USAGE = {
+    input_tokens: 0,
+    output_tokens: 0,
+};
+export class CostTracker {
+    entries = [];
+    opts;
+    alertedBudget = false;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    /**
+     * Record a single call and return its computed breakdown.
+     */
+    add(model, usage, options = {}) {
+        const calcOpts = {
+            pricing: this.opts.pricing,
+            batch: options.batch,
+        };
+        const breakdown = calculateCost(model, usage, calcOpts);
+        this.entries.push({
+            model,
+            usage,
+            breakdown,
+            timestamp: Date.now(),
+            label: options.label,
+        });
+        this.checkBudget();
+        return breakdown;
+    }
+    /**
+     * Total cost across all entries.
+     */
+    total() {
+        return this.entries.reduce((acc, e) => ({
+            input: acc.input + e.breakdown.input,
+            output: acc.output + e.breakdown.output,
+            cacheWrite: acc.cacheWrite + e.breakdown.cacheWrite,
+            cacheRead: acc.cacheRead + e.breakdown.cacheRead,
+            total: acc.total + e.breakdown.total,
+        }), { ...EMPTY_BREAKDOWN });
+    }
+    /**
+     * Per-model summary — call count, summed usage, summed cost.
+     */
+    byModel() {
+        const result = {};
+        for (const e of this.entries) {
+            const summary = result[e.model] ?? {
+                calls: 0,
+                usage: { ...EMPTY_USAGE },
+                breakdown: { ...EMPTY_BREAKDOWN },
+            };
+            summary.calls += 1;
+            summary.usage.input_tokens += e.usage.input_tokens;
+            summary.usage.output_tokens += e.usage.output_tokens;
+            if (e.usage.cache_creation_input_tokens !== undefined) {
+                summary.usage.cache_creation_input_tokens =
+                    (summary.usage.cache_creation_input_tokens ?? 0) + e.usage.cache_creation_input_tokens;
+            }
+            if (e.usage.cache_read_input_tokens !== undefined) {
+                summary.usage.cache_read_input_tokens =
+                    (summary.usage.cache_read_input_tokens ?? 0) + e.usage.cache_read_input_tokens;
+            }
+            summary.breakdown.input += e.breakdown.input;
+            summary.breakdown.output += e.breakdown.output;
+            summary.breakdown.cacheWrite += e.breakdown.cacheWrite;
+            summary.breakdown.cacheRead += e.breakdown.cacheRead;
+            summary.breakdown.total += e.breakdown.total;
+            result[e.model] = summary;
+        }
+        return result;
+    }
+    /** Number of recorded calls */
+    get callCount() {
+        return this.entries.length;
+    }
+    /** Read-only access to entries */
+    getEntries() {
+        return this.entries;
+    }
+    /** Reset all state */
+    reset() {
+        this.entries = [];
+        this.alertedBudget = false;
+    }
+    checkBudget() {
+        const budget = this.opts.budgetUSD;
+        if (budget === undefined || this.alertedBudget)
+            return;
+        const total = this.total().total;
+        if (total >= budget) {
+            this.alertedBudget = true;
+            this.opts.onBudgetExceeded?.(total, budget);
+        }
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Token usage shape — compatible with `@anthropic-ai/sdk` and `claude-stream-collector`.
+ */
+export interface TokenUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+/**
+ * Pricing for a single model, in USD per million tokens (MTok).
+ *
+ * `cacheWrite` defaults to 1.25× input price (5-minute cache) when omitted.
+ * `cacheRead` defaults to 0.1× input price (10% of input) when omitted.
+ */
+export interface ModelPricing {
+    /** USD per million input tokens */
+    input: number;
+    /** USD per million output tokens */
+    output: number;
+    /** USD per million tokens for cache creation (write). Default: input × 1.25 */
+    cacheWrite?: number;
+    /** USD per million tokens for cache reads. Default: input × 0.1 */
+    cacheRead?: number;
+}
+/**
+ * Cost breakdown in USD.
+ */
+export interface CostBreakdown {
+    input: number;
+    output: number;
+    cacheWrite: number;
+    cacheRead: number;
+    total: number;
+}
+/**
+ * A single recorded entry in a `CostTracker`.
+ */
+export interface CostEntry {
+    model: string;
+    usage: TokenUsage;
+    breakdown: CostBreakdown;
+    timestamp: number;
+    label?: string;
+}
+/**
+ * Per-model aggregate stats in a tracker.
+ */
+export interface ModelSummary {
+    calls: number;
+    usage: TokenUsage;
+    breakdown: CostBreakdown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IAEf,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,aAAa,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "claude-pricing",
+  "version": "0.1.0",
+  "description": "Calculate and track Claude API costs from token usage. Bundled pricing table + custom override. Zero dependencies.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "claude",
+    "anthropic",
+    "pricing",
+    "cost",
+    "tokens",
+    "usage",
+    "budget",
+    "llm",
+    "ai"
+  ],
+  "author": "xiangnuans",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xiangnuans/claude-pricing.git"
+  },
+  "homepage": "https://github.com/xiangnuans/claude-pricing",
+  "bugs": "https://github.com/xiangnuans/claude-pricing/issues",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}