ccusage 15.5.1 → 15.6.0

package/dist/{data-loader-CgvyDaQD.d.ts → data-loader-DZMUuqrf.d.ts}

@@ -1,8 +1,14 @@
-import { CostMode, PricingFetcher, SortOrder } from "./pricing-fetcher-B3SvKOod.js";
+import { Bucket, CostMode, PricingFetcher$1 as PricingFetcher, SortOrder, TupleToUnion } from "./pricing-fetcher-AYfCy7g-.js";
 import { z } from "zod";
 
-//#region src/_session-blocks.d.ts
+//#region src/_consts.d.ts
 
+/**
+ * Days of the week for weekly aggregation
+ */
+declare const WEEK_DAYS: readonly ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+//#endregion
+//#region src/_session-blocks.d.ts
 /**
  * Represents a single usage data entry loaded from JSONL files
  */
@@ -50,8 +56,9 @@ type SessionBlock = {
 //#endregion
 //#region src/data-loader.d.ts
 /**
- * Get all Claude data directories to search for usage data
- * Supports multiple paths: environment variable (comma-separated), new default, and old default
+ * Get Claude data directories to search for usage data
+ * When CLAUDE_CONFIG_DIR is set: uses only those paths
+ * When not set: uses default paths (~/.config/claude and ~/.claude)
  * @returns Array of valid Claude data directory paths
  */
 declare function getClaudePaths(): string[];
@@ -418,6 +425,152 @@ declare const monthlyUsageSchema: z.ZodObject<{
  * Type definition for monthly usage aggregation
  */
 type MonthlyUsage = z.infer<typeof monthlyUsageSchema>;
+/**
+ * Zod schema for weekly usage aggregation data
+ */
+declare const weeklyUsageSchema: z.ZodObject<{
+  week: z.ZodBranded<z.ZodString, "WeeklyDate">;
+  inputTokens: z.ZodNumber;
+  outputTokens: z.ZodNumber;
+  cacheCreationTokens: z.ZodNumber;
+  cacheReadTokens: z.ZodNumber;
+  totalCost: z.ZodNumber;
+  modelsUsed: z.ZodArray<z.ZodBranded<z.ZodString, "ModelName">, "many">;
+  modelBreakdowns: z.ZodArray<z.ZodObject<{
+    modelName: z.ZodBranded<z.ZodString, "ModelName">;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    cacheCreationTokens: z.ZodNumber;
+    cacheReadTokens: z.ZodNumber;
+    cost: z.ZodNumber;
+  }, "strip", z.ZodTypeAny, {
+    modelName: string & z.BRAND<"ModelName">;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }, {
+    modelName: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }>, "many">;
+  project: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  week: string & z.BRAND<"WeeklyDate">;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  totalCost: number;
+  modelsUsed: (string & z.BRAND<"ModelName">)[];
+  modelBreakdowns: {
+    modelName: string & z.BRAND<"ModelName">;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }[];
+  project?: string | undefined;
+}, {
+  week: string;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  totalCost: number;
+  modelsUsed: string[];
+  modelBreakdowns: {
+    modelName: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }[];
+  project?: string | undefined;
+}>;
+/**
+ * Type definition for weekly usage aggregation
+ */
+type WeeklyUsage = z.infer<typeof weeklyUsageSchema>;
+/**
+ * Zod schema for bucket usage aggregation data
+ */
+declare const bucketUsageSchema: z.ZodObject<{
+  bucket: z.ZodUnion<[z.ZodBranded<z.ZodString, "WeeklyDate">, z.ZodBranded<z.ZodString, "MonthlyDate">]>;
+  inputTokens: z.ZodNumber;
+  outputTokens: z.ZodNumber;
+  cacheCreationTokens: z.ZodNumber;
+  cacheReadTokens: z.ZodNumber;
+  totalCost: z.ZodNumber;
+  modelsUsed: z.ZodArray<z.ZodBranded<z.ZodString, "ModelName">, "many">;
+  modelBreakdowns: z.ZodArray<z.ZodObject<{
+    modelName: z.ZodBranded<z.ZodString, "ModelName">;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    cacheCreationTokens: z.ZodNumber;
+    cacheReadTokens: z.ZodNumber;
+    cost: z.ZodNumber;
+  }, "strip", z.ZodTypeAny, {
+    modelName: string & z.BRAND<"ModelName">;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }, {
+    modelName: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }>, "many">;
+  project: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  bucket: (string & z.BRAND<"MonthlyDate">) | (string & z.BRAND<"WeeklyDate">);
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  totalCost: number;
+  modelsUsed: (string & z.BRAND<"ModelName">)[];
+  modelBreakdowns: {
+    modelName: string & z.BRAND<"ModelName">;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }[];
+  project?: string | undefined;
+}, {
+  bucket: string;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreationTokens: number;
+  cacheReadTokens: number;
+  totalCost: number;
+  modelsUsed: string[];
+  modelBreakdowns: {
+    modelName: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    cost: number;
+  }[];
+  project?: string | undefined;
+}>;
+/**
+ * Type definition for bucket usage aggregation
+ */
+type BucketUsage = z.infer<typeof bucketUsageSchema>;
 /**
  * Formats a date string to YYYY-MM-DD format
  * @param dateStr - Input date string
@@ -478,6 +631,7 @@ type DateFilter = {
   since?: string; // YYYYMMDD format
   until?: string; // YYYYMMDD format
 };
+type WeekDay = TupleToUnion<typeof WEEK_DAYS>;
 /**
  * Configuration options for loading usage data
  */
@@ -489,6 +643,7 @@ type LoadOptions = {
   sessionDurationHours?: number; // Session block duration in hours
   groupByProject?: boolean; // Group data by project instead of aggregating
   project?: string; // Filter to specific project name
+  startOfWeek?: WeekDay; // Start of week for weekly aggregation
 } & DateFilter;
 /**
  * Loads and aggregates Claude usage data by day
@@ -511,6 +666,8 @@ declare function loadSessionData(options?: LoadOptions): Promise<SessionUsage[]>
  * @returns Array of monthly usage summaries sorted by month
  */
 declare function loadMonthlyUsageData(options?: LoadOptions): Promise<MonthlyUsage[]>;
+declare function loadWeeklyUsageData(options?: LoadOptions): Promise<WeeklyUsage[]>;
+declare function loadBucketUsageData(groupingFn: (data: DailyUsage) => Bucket, options?: LoadOptions): Promise<BucketUsage[]>;
 /**
  * Loads usage data and organizes it into session blocks (typically 5-hour billing periods)
  * Processes all usage data and groups it into time-based blocks for billing analysis
@@ -519,4 +676,4 @@ declare function loadMonthlyUsageData(options?: LoadOptions): Promise<MonthlyUsa
  */
 declare function loadSessionBlockData(options?: LoadOptions): Promise<SessionBlock[]>;
 //#endregion
-export { DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema };
+export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema as bucketUsageSchema$1, calculateCostForEntry as calculateCostForEntry$1, createUniqueHash as createUniqueHash$1, dailyUsageSchema as dailyUsageSchema$1, extractProjectFromPath as extractProjectFromPath$1, formatDate as formatDate$1, formatDateCompact as formatDateCompact$1, getClaudePaths as getClaudePaths$1, getEarliestTimestamp as getEarliestTimestamp$1, getUsageLimitResetTime as getUsageLimitResetTime$1, globUsageFiles as globUsageFiles$1, loadBucketUsageData as loadBucketUsageData$1, loadDailyUsageData as loadDailyUsageData$1, loadMonthlyUsageData as loadMonthlyUsageData$1, loadSessionBlockData as loadSessionBlockData$1, loadSessionData as loadSessionData$1, loadWeeklyUsageData as loadWeeklyUsageData$1, modelBreakdownSchema as modelBreakdownSchema$1, monthlyUsageSchema as monthlyUsageSchema$1, sessionUsageSchema as sessionUsageSchema$1, sortFilesByTimestamp as sortFilesByTimestamp$1, usageDataSchema as usageDataSchema$1, weeklyUsageSchema as weeklyUsageSchema$1 };

package/dist/data-loader.d.ts

@@ -1,3 +1,3 @@
-import { DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema } from "./data-loader-CgvyDaQD.js";
-import "./pricing-fetcher-B3SvKOod.js";
-export { DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema };
+import "./pricing-fetcher-AYfCy7g-.js";
+import { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema$1 as bucketUsageSchema, calculateCostForEntry$1 as calculateCostForEntry, createUniqueHash$1 as createUniqueHash, dailyUsageSchema$1 as dailyUsageSchema, extractProjectFromPath$1 as extractProjectFromPath, formatDate$1 as formatDate, formatDateCompact$1 as formatDateCompact, getClaudePaths$1 as getClaudePaths, getEarliestTimestamp$1 as getEarliestTimestamp, getUsageLimitResetTime$1 as getUsageLimitResetTime, globUsageFiles$1 as globUsageFiles, loadBucketUsageData$1 as loadBucketUsageData, loadDailyUsageData$1 as loadDailyUsageData, loadMonthlyUsageData$1 as loadMonthlyUsageData, loadSessionBlockData$1 as loadSessionBlockData, loadSessionData$1 as loadSessionData, loadWeeklyUsageData$1 as loadWeeklyUsageData, modelBreakdownSchema$1 as modelBreakdownSchema, monthlyUsageSchema$1 as monthlyUsageSchema, sessionUsageSchema$1 as sessionUsageSchema, sortFilesByTimestamp$1 as sortFilesByTimestamp, usageDataSchema$1 as usageDataSchema, weeklyUsageSchema$1 as weeklyUsageSchema } from "./data-loader-DZMUuqrf.js";
+export { BucketUsage, DailyUsage, DateFilter, GlobResult, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, WeeklyUsage, bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema };

package/dist/data-loader.js

@@ -1,6 +1,6 @@
-import "./pricing-fetcher-eNV76BjF.js";
+import "./pricing-fetcher-CNjC0nXU.js";
 import "./_token-utils-WjkbrjKv.js";
-import "./_types-BHFM59hI.js";
-import { calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema } from "./data-loader-BAp4u-7e.js";
-import "./logger-COLgmk2z.js";
-export { calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema };
+import "./_types-ed8-0BH6.js";
+import { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema } from "./data-loader-CwryIrwx.js";
+import "./logger-C35JCduT.js";
+export { bucketUsageSchema, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, globUsageFiles, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema, weeklyUsageSchema };

package/dist/{debug-IQBgd8CJ.js → debug-C8bVFK5q.js}

@@ -1,6 +1,6 @@
-import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-eNV76BjF.js";
-import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-BAp4u-7e.js";
-import { logger } from "./logger-COLgmk2z.js";
+import { CLAUDE_PROJECTS_DIR_NAME, DEBUG_MATCH_THRESHOLD_PERCENT, PricingFetcher, USAGE_DATA_GLOB_PATTERN, __toESM, isFailure, require_usingCtx, try_ } from "./pricing-fetcher-CNjC0nXU.js";
+import { getClaudePaths, glob, unwrap, usageDataSchema } from "./data-loader-CwryIrwx.js";
+import { logger } from "./logger-C35JCduT.js";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 var import_usingCtx = __toESM(require_usingCtx(), 1);
@@ -31,8 +31,8 @@ async function detectMismatches(claudePath) {
 			matches: 0,
 			mismatches: 0,
 			discrepancies: [],
-			modelStats: /* @__PURE__ */ new Map(),
-			versionStats: /* @__PURE__ */ new Map()
+			modelStats: new Map(),
+			versionStats: new Map()
 		};
 		for (const file of files) {
 			const content = await readFile(file, "utf-8");
@@ -40,7 +40,7 @@ async function detectMismatches(claudePath) {
 			for (const line of lines) {
 				const parseParser = try_({
 					try: () => JSON.parse(line),
-					catch: () => /* @__PURE__ */ new Error("Invalid JSON")
+					catch: () => new Error("Invalid JSON")
 				});
 				const parseResult = parseParser();
 				if (isFailure(parseResult)) continue;

package/dist/debug.js

@@ -1,7 +1,7 @@
-import "./pricing-fetcher-eNV76BjF.js";
+import "./pricing-fetcher-CNjC0nXU.js";
 import "./_token-utils-WjkbrjKv.js";
-import "./_types-BHFM59hI.js";
-import "./data-loader-BAp4u-7e.js";
-import "./logger-COLgmk2z.js";
-import { detectMismatches, printMismatchReport } from "./debug-IQBgd8CJ.js";
+import "./_types-ed8-0BH6.js";
+import "./data-loader-CwryIrwx.js";
+import "./logger-C35JCduT.js";
+import { detectMismatches, printMismatchReport } from "./debug-C8bVFK5q.js";
 export { detectMismatches, printMismatchReport };