ccusage 0.6.0 → 0.6.2

package/README.md

@@ -3,9 +3,9 @@
 > **ccusage(claude-code-usage)**
 
 [![npm version](https://img.shields.io/npm/v/ccusage?color=yellow)](https://npmjs.com/package/ccusage)
-[![NPM Downloads](https://img.shields.io/npm/dy/ccusage)](https://www.npmjs.com/package/ccusage)
-[![DeepWiki](https://img.shields.io/badge/DeepWiki-ryoppippi%2Fccusage-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/ryoppippi/ccusage)
-<!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ -->
+[![NPM Downloads](https://img.shields.io/npm/dy/ccusage)](https://tanstack.com/stats/npm?packageGroups=%5B%7B%22packages%22:%5B%7B%22name%22:%22ccusage%22%7D%5D%7D%5D&range=30-days&transform=none&binType=daily&showDataMode=all&height=400)
+[![DeepWiki](https://img.shields.io/badge/DeepWiki-ryoppippi%2Fccusage-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/ryoppippi/ccusage)<!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ -->
+[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)
 
 <div align="center">
   <img src="https://github.com/ryoppippi/ccusage/blob/main/docs/screenshot.png?raw=true">
@@ -16,22 +16,23 @@ A CLI tool for analyzing Claude Code usage from local JSONL files.
 Inspired by [this article](https://note.com/milliondev/n/n1d018da2d769) about tracking Claude Code usage costs.
 
 ## What is `ccusage` (by NotebookLM)
+
 <details>
  <summary>Podcact</summary>
 
 # English
-https://github.com/user-attachments/assets/7a00f2f3-82a7-41b6-a8da-e04b76b5e35a
 
+https://github.com/user-attachments/assets/7a00f2f3-82a7-41b6-a8da-e04b76b5e35a
 
 # 日本語
+
 https://github.com/user-attachments/assets/db09fc06-bf57-4d37-9b06-514851bcc1d0
 
 </details>
 
-
 ## Motivation
 
-Claude Code's Max plan offers unlimited usage - but wouldn't it be interesting to know how much you'd be paying if you were on a pay-per-use plan? 
+Claude Code's Max plan offers unlimited usage - but wouldn't it be interesting to know how much you'd be paying if you were on a pay-per-use plan?
 
 This tool helps you understand the value you're getting from your subscription by calculating the equivalent costs of your actual usage. See how much you're saving and enjoy that satisfying feeling of getting great value! 😊
 
@@ -52,6 +53,7 @@ This tool helps you understand the value you're getting from your subscription b
 ⚠️ **This is NOT an official Claude tool** - it's an independent community project that analyzes locally stored usage data.
 
 **Cost calculations are estimates only** and may not reflect actual billing:
+
 - Costs shown are virtual/estimated based on token counts and model pricing data
 - Actual costs may vary due to pricing changes, special rates, or billing adjustments
 - We do not guarantee the accuracy of calculated costs
@@ -202,7 +204,7 @@ ccusage session --order desc      # Show newest sessions first (default)
 All commands support the following options:
 
 - `-s, --since <date>`: Filter from date (YYYYMMDD format)
-- `-u, --until <date>`: Filter until date (YYYYMMDD format)  
+- `-u, --until <date>`: Filter until date (YYYYMMDD format)
 - `-p, --path <path>`: Custom path to Claude data directory (default: `~/.claude`)
 - `-j, --json`: Output results in JSON format instead of table
 - `-m, --mode <mode>`: Cost calculation mode: `auto` (default), `calculate`, or `display`
@@ -234,10 +236,12 @@ ccusage mcp --mode calculate
 ```
 
 The MCP server supports both **stdio** and **HTTP stream** transports:
+
 - **stdio** (default): Best for local integration where the client directly spawns the process
 - **HTTP stream**: Best for remote access when you need to call the server from another machine or network location
 
 Available MCP tools:
+
 - `daily`: Returns daily usage reports (accepts `since`, `until`, `mode` parameters)
 - `session`: Returns session usage reports (accepts `since`, `until`, `mode` parameters)
 
@@ -249,18 +253,18 @@ Available MCP tools:
 
 To use ccusage MCP with Claude Desktop, add this to your Claude Desktop configuration file:
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
-  "mcpServers": {
-    "ccusage": {
-      "command": "npx",
-      "args": ["ccusage@latest", "mcp"],
-      "env": {}
-    }
-  }
+	"mcpServers": {
+		"ccusage": {
+			"command": "npx",
+			"args": ["ccusage@latest", "mcp"],
+			"env": {}
+		}
+	}
 }
 ```
 
@@ -268,13 +272,13 @@ Or if you have ccusage installed globally:
 
 ```json
 {
-  "mcpServers": {
-    "ccusage": {
-      "command": "ccusage",
-      "args": ["mcp"],
-      "env": {}
-    }
-  }
+	"mcpServers": {
+		"ccusage": {
+			"command": "ccusage",
+			"args": ["mcp"],
+			"env": {}
+		}
+	}
 }
 ```
 
@@ -283,6 +287,7 @@ After adding this configuration, restart Claude Desktop. You'll then be able to
 ## Output Example
 
 ### Daily Report
+
 ```
 ╭──────────────────────────────────────────╮
 │                                          │
@@ -302,6 +307,7 @@ After adding this configuration, restart Claude Desktop. You'll then be able to
 ```
 
 ### Session Report
+
 ```
 ╭───────────────────────────────────────────────╮
 │                                               │
@@ -321,6 +327,7 @@ After adding this configuration, restart Claude Desktop. You'll then be able to
 ```
 
 ## Requirements
+
 - Claude Code usage history files (`~/.claude/projects/**/*.jsonl`)
 
 ## License

package/dist/calculate-cost.d.ts

@@ -1,18 +1,21 @@
-import "./index-BurjgCfW.js";
-import "./pricing-fetcher-DygIroMj.js";
-import { TokenData, TokenTotals } from "./types-y1JQzaKZ.js";
-import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-aUOjeZ06.js";
+import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-B0tJZeHI.js";
+import "./pricing-fetcher-Dq-OLBp4.js";
 
 //#region src/calculate-cost.d.ts
-declare function calculateTotals(data: Array<DailyUsage | MonthlyUsage | SessionUsage>): TokenTotals;
-declare function getTotalTokens(tokens: TokenData): number;
-declare function createTotalsObject(totals: TokenTotals): {
+type TokenData = {
   inputTokens: number;
   outputTokens: number;
   cacheCreationTokens: number;
   cacheReadTokens: number;
-  totalTokens: number;
+};
+type TokenTotals = TokenData & {
   totalCost: number;
 };
+type TotalsObject = TokenTotals & {
+  totalTokens: number;
+};
+declare function calculateTotals(data: Array<DailyUsage | MonthlyUsage | SessionUsage>): TokenTotals;
+declare function getTotalTokens(tokens: TokenData): number;
+declare function createTotalsObject(totals: TokenTotals): TotalsObject;
 //#endregion
 export { calculateTotals, createTotalsObject, getTotalTokens };

package/dist/{core-BgFXUe_h.js → core-B0ovMhJe.js}

@@ -38,8 +38,8 @@ const $output = Symbol("ZodOutput");
 const $input = Symbol("ZodInput");
 var $ZodRegistry = class {
 	constructor() {
-		this._map = new WeakMap();
-		this._idmap = new Map();
+		this._map = /* @__PURE__ */ new WeakMap();
+		this._idmap = /* @__PURE__ */ new Map();
 	}
 	add(schema, ..._meta) {
 		const meta = _meta[0];
@@ -85,7 +85,7 @@ var JSONSchemaGenerator = class {
 		this.unrepresentable = params?.unrepresentable ?? "throw";
 		this.override = params?.override ?? (() => {});
 		this.io = params?.io ?? "output";
-		this.seen = new Map();
+		this.seen = /* @__PURE__ */ new Map();
 	}
 	process(schema, _params = {
 		path: [],
@@ -630,7 +630,7 @@ function toJSONSchema(input, _params) {
 	return gen.emit(input, _params);
 }
 function isTransforming(_schema, _ctx) {
-	const ctx = _ctx ?? { seen: new Set() };
+	const ctx = _ctx ?? { seen: /* @__PURE__ */ new Set() };
 	if (ctx.seen.has(_schema)) return false;
 	ctx.seen.add(_schema);
 	const schema = _schema;

package/dist/data-loader-B0tJZeHI.d.ts

@@ -0,0 +1,144 @@
+import { ArraySchema, InferOutput, NumberSchema, ObjectSchema, OptionalSchema, PricingFetcher, RegexAction, SchemaWithPipe, StringSchema } from "./pricing-fetcher-Dq-OLBp4.js";
+
+//#region node_modules/type-fest/source/observable-like.d.ts
+declare global {
+  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
+  interface SymbolConstructor {
+    readonly observable: symbol;
+  }
+}
+
+/**
+@remarks
+The TC39 observable proposal defines a `closed` property, but some implementations (such as xstream) do not as of 10/08/2021.
+As well, some guidance on making an `Observable` to not include `closed` property.
+@see https://github.com/tc39/proposal-observable/blob/master/src/Observable.js#L129-L130
+@see https://github.com/staltz/xstream/blob/6c22580c1d84d69773ee4b0905df44ad464955b3/src/index.ts#L79-L85
+@see https://github.com/benlesh/symbol-observable#making-an-object-observable
+
+@category Observable
+*/
+
+//#endregion
+//#region node_modules/type-fest/source/tuple-to-union.d.ts
+/**
+Convert a tuple/array into a union type of its elements.
+
+This can be useful when you have a fixed set of allowed values and want a type defining only the allowed values, but do not want to repeat yourself.
+
+@example
+```
+import type {TupleToUnion} from 'type-fest';
+
+const destinations = ['a', 'b', 'c'] as const;
+
+type Destination = TupleToUnion<typeof destinations>;
+//=> 'a' | 'b' | 'c'
+
+function verifyDestination(destination: unknown): destination is Destination {
+	return destinations.includes(destination as any);
+}
+
+type RequestBody = {
+	deliverTo: Destination;
+};
+
+function verifyRequestBody(body: unknown): body is RequestBody {
+	const deliverTo = (body as any).deliverTo;
+	return typeof body === 'object' && body !== null && verifyDestination(deliverTo);
+}
+```
+
+Alternatively, you may use `typeof destinations[number]`. If `destinations` is a tuple, there is no difference. However if `destinations` is a string, the resulting type will the union of the characters in the string. Other types of `destinations` may result in a compile error. In comparison, TupleToUnion will return `never` if a tuple is not provided.
+
+@example
+```
+const destinations = ['a', 'b', 'c'] as const;
+
+type Destination = typeof destinations[number];
+//=> 'a' | 'b' | 'c'
+
+const erroringType = new Set(['a', 'b', 'c']);
+
+type ErroringType = typeof erroringType[number];
+//=> Type 'Set<string>' has no matching index signature for type 'number'. ts(2537)
+
+const numberBool: { [n: number]: boolean } = { 1: true };
+
+type NumberBool = typeof numberBool[number];
+//=> boolean
+```
+
+@category Array
+*/
+type TupleToUnion<ArrayType> = ArrayType extends readonly unknown[] ? ArrayType[number] : never;
+//#endregion
+//#region src/types.internal.d.ts
+declare const CostModes: readonly ["auto", "calculate", "display"];
+type CostMode = TupleToUnion<typeof CostModes>;
+declare const SortOrders: readonly ["desc", "asc"];
+type SortOrder = TupleToUnion<typeof SortOrders>;
+//#endregion
+//#region src/data-loader.d.ts
+declare function getDefaultClaudePath(): string;
+declare const UsageDataSchema: ObjectSchema<{
+  readonly timestamp: StringSchema<undefined>;
+  readonly version: OptionalSchema<StringSchema<undefined>, undefined>;
+  readonly message: ObjectSchema<{
+    readonly usage: ObjectSchema<{
+      readonly input_tokens: NumberSchema<undefined>;
+      readonly output_tokens: NumberSchema<undefined>;
+      readonly cache_creation_input_tokens: OptionalSchema<NumberSchema<undefined>, undefined>;
+      readonly cache_read_input_tokens: OptionalSchema<NumberSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly model: OptionalSchema<StringSchema<undefined>, undefined>;
+  }, undefined>;
+  readonly costUSD: OptionalSchema<NumberSchema<undefined>, undefined>;
+}, undefined>;
+type UsageData = InferOutput<typeof UsageDataSchema>;
+declare const DailyUsageSchema: ObjectSchema<{
+  readonly date: SchemaWithPipe<readonly [StringSchema<undefined>, RegexAction<string, undefined>]>;
+  readonly inputTokens: NumberSchema<undefined>;
+  readonly outputTokens: NumberSchema<undefined>;
+  readonly cacheCreationTokens: NumberSchema<undefined>;
+  readonly cacheReadTokens: NumberSchema<undefined>;
+  readonly totalCost: NumberSchema<undefined>;
+}, undefined>;
+type DailyUsage = InferOutput<typeof DailyUsageSchema>;
+declare const SessionUsageSchema: ObjectSchema<{
+  readonly sessionId: StringSchema<undefined>;
+  readonly projectPath: StringSchema<undefined>;
+  readonly inputTokens: NumberSchema<undefined>;
+  readonly outputTokens: NumberSchema<undefined>;
+  readonly cacheCreationTokens: NumberSchema<undefined>;
+  readonly cacheReadTokens: NumberSchema<undefined>;
+  readonly totalCost: NumberSchema<undefined>;
+  readonly lastActivity: StringSchema<undefined>;
+  readonly versions: ArraySchema<StringSchema<undefined>, undefined>;
+}, undefined>;
+type SessionUsage = InferOutput<typeof SessionUsageSchema>;
+declare const MonthlyUsageSchema: ObjectSchema<{
+  readonly month: SchemaWithPipe<readonly [StringSchema<undefined>, RegexAction<string, undefined>]>;
+  readonly inputTokens: NumberSchema<undefined>;
+  readonly outputTokens: NumberSchema<undefined>;
+  readonly cacheCreationTokens: NumberSchema<undefined>;
+  readonly cacheReadTokens: NumberSchema<undefined>;
+  readonly totalCost: NumberSchema<undefined>;
+}, undefined>;
+type MonthlyUsage = InferOutput<typeof MonthlyUsageSchema>;
+declare function formatDate(dateStr: string): string;
+declare function calculateCostForEntry(data: UsageData, mode: CostMode, fetcher: PricingFetcher): Promise<number>;
+type DateFilter = {
+  since?: string;
+  until?: string;
+};
+type LoadOptions = {
+  claudePath?: string;
+  mode?: CostMode;
+  order?: SortOrder;
+} & DateFilter;
+declare function loadDailyUsageData(options?: LoadOptions): Promise<DailyUsage[]>;
+declare function loadSessionData(options?: LoadOptions): Promise<SessionUsage[]>;
+declare function loadMonthlyUsageData(options?: LoadOptions): Promise<MonthlyUsage[]>;
+//#endregion
+export { DailyUsage, DailyUsageSchema, DateFilter, LoadOptions, MonthlyUsage, MonthlyUsageSchema, SessionUsage, SessionUsageSchema, UsageData, UsageDataSchema, calculateCostForEntry, formatDate, getDefaultClaudePath, loadDailyUsageData, loadMonthlyUsageData, loadSessionData };