ccusage 15.5.2 → 15.6.0

package/README.md

@@ -9,6 +9,7 @@
     <a href="https://packagephobia.com/result?p=ccusage"><img src="https://packagephobia.com/badge?p=ccusage" alt="install size" /></a>
     <a href="https://deepwiki.com/ryoppippi/ccusage"><img src="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==" alt="DeepWiki"></a>
     <!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ -->
+    <a href="https://claudelog.com/"><img src="https://claudelog.com/img/claude_log_badge.svg" alt="ClaudeLog - A comprehensive knowledge base for Claude." /></a>
     <a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code" /></a>
 </p>
 
@@ -113,6 +114,16 @@ Check out these [47 Claude Code ProTips from Greg Baugues.](https://www.youtube.
     </a>
 </p>
 
+## Claude Code Resources
+
+[`ClaudeLog`](https://claudelog.com) &nbsp; by &nbsp; [InventorBlack](https://www.reddit.com/user/inventor_black/)
+A comprehensive knowledge base with detailed breakdowns of advanced topics, including:
+
+- Advanced [mechanics](https://claudelog.com/mechanics/you-are-the-main-thread/) and [CLAUDE.md best practices](https://claudelog.com/mechanics/claude-md-supremacy).
+- Practical technique guides for [plan mode](https://claudelog.com/mechanics/plan-mode), [ultrathink](https://claudelog.com/faqs/what-is-ultrathink/), and [sub-agents](https://claudelog.com/mechanics/task-agent-tools/).
+- Concepts like [agent-first design](https://claudelog.com/mechanics/agent-first-design/), [agent engineering](https://claudelog.com/mechanics/agent-engineering/), and [humanizing agents](https://claudelog.com/mechanics/humanising-agents/).
+- [Configuration guides](https://claudelog.com/configuration).
+
 ## Star History
 
 <a href="https://www.star-history.com/#ryoppippi/ccusage&Date">

package/dist/{_types-BHFM59hI.js → _types-ed8-0BH6.js}

@@ -725,7 +725,7 @@ const ipv6CidrRegex = /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1
 const base64Regex = /^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}=))?$/;
 const base64urlRegex = /^([0-9a-zA-Z-_]{4})*(([0-9a-zA-Z-_]{2}(==)?)|([0-9a-zA-Z-_]{3}(=)?))?$/;
 const dateRegexSource = `((\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\\d|3[01])|(0[469]|11)-(0[1-9]|[12]\\d|30)|(02)-(0[1-9]|1\\d|2[0-8])))`;
-const dateRegex = /* @__PURE__ */ new RegExp(`^${dateRegexSource}$`);
+const dateRegex = new RegExp(`^${dateRegexSource}$`);
 function timeRegexSource(args) {
 	let secondsRegexSource = `[0-5]\\d`;
 	if (args.precision) secondsRegexSource = `${secondsRegexSource}\\.\\d{${args.precision}}`;
@@ -734,7 +734,7 @@ function timeRegexSource(args) {
 	return `([01]\\d|2[0-3]):[0-5]\\d(:${secondsRegexSource})${secondsQuantifier}`;
 }
 function timeRegex(args) {
-	return /* @__PURE__ */ new RegExp(`^${timeRegexSource(args)}$`);
+	return new RegExp(`^${timeRegexSource(args)}$`);
 }
 function datetimeRegex(args) {
 	let regex = `${dateRegexSource}T${timeRegexSource(args)}`;
@@ -742,7 +742,7 @@ function datetimeRegex(args) {
 	opts.push(args.local ? `Z?` : `Z`);
 	if (args.offset) opts.push(`([+-]\\d{2}:?\\d{2})`);
 	regex = `${regex}(${opts.join("|")})`;
-	return /* @__PURE__ */ new RegExp(`^${regex}$`);
+	return new RegExp(`^${regex}$`);
 }
 function isValidIP(ip, version) {
 	if ((version === "v4" || !version) && ipv4Regex.test(ip)) return true;
@@ -2492,7 +2492,7 @@ var ZodDiscriminatedUnion = class ZodDiscriminatedUnion extends ZodType {
 	* @param params
 	*/
 	static create(discriminator, options, params) {
-		const optionsMap = /* @__PURE__ */ new Map();
+		const optionsMap = new Map();
 		for (const type of options) {
 			const discriminatorValues = getDiscriminator(type.shape[discriminator]);
 			if (!discriminatorValues.length) throw new Error(`A discriminator value for key \`${discriminator}\` could not be extracted from all schema options`);
@@ -2730,7 +2730,7 @@ var ZodMap = class extends ZodType {
 			};
 		});
 		if (ctx.common.async) {
-			const finalMap = /* @__PURE__ */ new Map();
+			const finalMap = new Map();
 			return Promise.resolve().then(async () => {
 				for (const pair of pairs) {
 					const key = await pair.key;
@@ -2745,7 +2745,7 @@ var ZodMap = class extends ZodType {
 				};
 			});
 		} else {
-			const finalMap = /* @__PURE__ */ new Map();
+			const finalMap = new Map();
 			for (const pair of pairs) {
 				const key = pair.key;
 				const value = pair.value;
@@ -2808,7 +2808,7 @@ var ZodSet = class ZodSet extends ZodType {
 		}
 		const valueType = this._def.valueType;
 		function finalizeSet(elements$1) {
-			const parsedSet = /* @__PURE__ */ new Set();
+			const parsedSet = new Set();
 			for (const element of elements$1) {
 				if (element.status === "aborted") return INVALID;
 				if (element.status === "dirty") status.dirty();
@@ -3573,13 +3573,19 @@ const isoTimestampSchema = stringType().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d
 const dailyDateSchema = stringType().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format").brand();
 const activityDateSchema = stringType().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format").brand();
 const monthlyDateSchema = stringType().regex(/^\d{4}-\d{2}$/, "Date must be in YYYY-MM format").brand();
+const weeklyDateSchema = stringType().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format").brand();
 const filterDateSchema = stringType().regex(/^\d{8}$/, "Date must be in YYYYMMDD format").brand();
 const projectPathSchema = stringType().min(1, "Project path cannot be empty").brand();
 const versionSchema = stringType().regex(/^\d+\.\d+\.\d+/, "Invalid version format").brand();
 const createSessionId = (value) => sessionIdSchema.parse(value);
 const createDailyDate = (value) => dailyDateSchema.parse(value);
 const createMonthlyDate = (value) => monthlyDateSchema.parse(value);
+const createWeeklyDate = (value) => weeklyDateSchema.parse(value);
 const createProjectPath = (value) => projectPathSchema.parse(value);
+function createBucket(value) {
+	if (weeklyDateSchema.safeParse(value).success) return createWeeklyDate(value);
+	return createMonthlyDate(value);
+}
 /**
 * Available cost calculation modes
 * - auto: Use pre-calculated costs when available, otherwise calculate from tokens
@@ -3604,4 +3610,4 @@ const modelPricingSchema = objectType({
 	cache_creation_input_token_cost: numberType().optional(),
 	cache_read_input_token_cost: numberType().optional()
 });
-export { CostModes, SortOrders, ZodFirstPartyTypeKind, ZodOptional, ZodType, activityDateSchema, arrayType, booleanType, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, dailyDateSchema, discriminatedUnionType, enumType, filterDateSchema, isoTimestampSchema, literalType, messageIdSchema, modelNameSchema, modelPricingSchema, monthlyDateSchema, numberType, objectType, optionalType, projectPathSchema, recordType, requestIdSchema, sessionIdSchema, stringType, unionType, unknownType, versionSchema };
+export { CostModes, SortOrders, ZodFirstPartyTypeKind, ZodOptional, ZodType, activityDateSchema, arrayType, booleanType, createBucket, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, createWeeklyDate, dailyDateSchema, discriminatedUnionType, enumType, filterDateSchema, isoTimestampSchema, literalType, messageIdSchema, modelNameSchema, modelPricingSchema, monthlyDateSchema, numberType, objectType, optionalType, projectPathSchema, recordType, requestIdSchema, sessionIdSchema, stringType, unionType, unknownType, versionSchema, weeklyDateSchema };

package/dist/calculate-cost.d.ts

@@ -1,5 +1,5 @@
-import { DailyUsage, MonthlyUsage, SessionUsage } from "./data-loader-CgvyDaQD.js";
-import "./pricing-fetcher-B3SvKOod.js";
+import "./pricing-fetcher-AYfCy7g-.js";
+import { DailyUsage, MonthlyUsage, SessionUsage, WeeklyUsage } from "./data-loader-DZMUuqrf.js";
 
 //#region src/_token-utils.d.ts
 
@@ -63,7 +63,7 @@ type TotalsObject = TokenTotals & {
  * @param data - Array of daily, monthly, or session usage data
  * @returns Aggregated token totals and cost
  */
-declare function calculateTotals(data: Array<DailyUsage | MonthlyUsage | SessionUsage>): TokenTotals;
+declare function calculateTotals(data: Array<DailyUsage | MonthlyUsage | WeeklyUsage | SessionUsage>): TokenTotals;
 // Re-export getTotalTokens from shared utilities for backward compatibility
 
 /**

package/dist/calculate-cost.js

@@ -1,4 +1,4 @@
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
-import "./_types-BHFM59hI.js";
+import "./_types-ed8-0BH6.js";
 import { calculateTotals, createTotalsObject } from "./calculate-cost-BDqO4yWA.js";
 export { calculateTotals, createTotalsObject, getTotalTokens };

package/dist/{data-loader-CmW1xurn.js → data-loader-CwryIrwx.js}

@@ -1,7 +1,7 @@
-import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx } from "./pricing-fetcher-B5b61mDE.js";
+import { CLAUDE_CONFIG_DIR_ENV, CLAUDE_PROJECTS_DIR_NAME, DEFAULT_CLAUDE_CODE_PATH, DEFAULT_CLAUDE_CONFIG_PATH, DEFAULT_RECENT_DAYS, PricingFetcher, USAGE_DATA_GLOB_PATTERN, USER_HOME_DIR, __commonJSMin, __require, __toESM, isFailure, isPromise, require_usingCtx } from "./pricing-fetcher-CNjC0nXU.js";
 import { getTotalTokens } from "./_token-utils-WjkbrjKv.js";
-import { activityDateSchema, arrayType, booleanType, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, dailyDateSchema, isoTimestampSchema, messageIdSchema, modelNameSchema, monthlyDateSchema, numberType, objectType, projectPathSchema, requestIdSchema, sessionIdSchema, stringType, versionSchema } from "./_types-BHFM59hI.js";
-import { logger } from "./logger-D0z-I-_d.js";
+import { activityDateSchema, arrayType, booleanType, createBucket, createDailyDate, createMonthlyDate, createProjectPath, createSessionId, createWeeklyDate, dailyDateSchema, isoTimestampSchema, messageIdSchema, modelNameSchema, monthlyDateSchema, numberType, objectType, projectPathSchema, requestIdSchema, sessionIdSchema, stringType, unionType, versionSchema, weeklyDateSchema } from "./_types-ed8-0BH6.js";
+import { logger } from "./logger-C35JCduT.js";
 import a, { readFile } from "node:fs/promises";
 import path, { posix } from "node:path";
 import process$1 from "node:process";
@@ -935,7 +935,7 @@ var require_walker = __commonJSMin((exports) => {
 				counts: new counter_1.Counter(),
 				options,
 				queue: new queue_1.Queue((error, state) => this.callbackInvoker(state, error, callback$1)),
-				symlinks: /* @__PURE__ */ new Map(),
+				symlinks: new Map(),
 				visited: [""].slice(0, 0),
 				controller: new AbortController()
 			};
@@ -2931,7 +2931,7 @@ function isDynamicPattern(pattern, options) {
 	return scan$2.isGlob || scan$2.negated;
 }
 function log(...tasks) {
-	console.log(`[tinyglobby ${(/* @__PURE__ */ new Date()).toLocaleTimeString("es")}]`, ...tasks);
+	console.log(`[tinyglobby ${new Date().toLocaleTimeString("es")}]`, ...tasks);
 }
 const PARENT_DIRECTORY = /^(\/?\.\.)+/;
 const ESCAPING_BACKSLASHES = /\\(?=[()[\]{}!*+?@|])/g;
@@ -3118,7 +3118,7 @@ function identifySessionBlocks(entries, sessionDurationHours = DEFAULT_SESSION_D
 	const sortedEntries = [...entries].sort((a$1, b$1) => a$1.timestamp.getTime() - b$1.timestamp.getTime());
 	let currentBlockStart = null;
 	let currentBlockEntries = [];
-	const now = /* @__PURE__ */ new Date();
+	const now = new Date();
 	for (const entry of sortedEntries) {
 		const entryTime = entry.timestamp;
 		if (currentBlockStart == null) {
@@ -3255,7 +3255,7 @@ function projectBlockUsage(block) {
 	if (!block.isActive || (block.isGap ?? false)) return null;
 	const burnRate = calculateBurnRate(block);
 	if (burnRate == null) return null;
-	const now = /* @__PURE__ */ new Date();
+	const now = new Date();
 	const remainingTime = block.endTime.getTime() - now.getTime();
 	const remainingMinutes = Math.max(0, remainingTime / (1e3 * 60));
 	const currentTokens = getTotalTokens(block.tokenCounts);
@@ -3276,21 +3276,22 @@ function projectBlockUsage(block) {
 * @returns Filtered array of recent or active blocks
 */
 function filterRecentBlocks(blocks, days = DEFAULT_RECENT_DAYS) {
-	const now = /* @__PURE__ */ new Date();
-	const cutoffTime = /* @__PURE__ */ new Date(now.getTime() - days * 24 * 60 * 60 * 1e3);
+	const now = new Date();
+	const cutoffTime = new Date(now.getTime() - days * 24 * 60 * 60 * 1e3);
 	return blocks.filter((block) => {
 		return block.startTime >= cutoffTime || block.isActive;
 	});
 }
 var import_usingCtx = __toESM(require_usingCtx(), 1);
 /**
-* 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
 */
 function getClaudePaths() {
 	const paths = [];
-	const normalizedPaths = /* @__PURE__ */ new Set();
+	const normalizedPaths = new Set();
 	const envPaths = (process$1.env[CLAUDE_CONFIG_DIR_ENV] ?? "").trim();
 	if (envPaths !== "") {
 		const envPathList = envPaths.split(",").map((p) => p.trim()).filter((p) => p !== "");
@@ -3306,6 +3307,9 @@ function getClaudePaths() {
 				}
 			}
 		}
+		if (paths.length > 0) return paths;
+		throw new Error(`No valid Claude data directories found in CLAUDE_CONFIG_DIR. Please ensure the following exists:
+- ${envPaths}/${CLAUDE_PROJECTS_DIR_NAME}`.trim());
 	}
 	const defaultPaths = [DEFAULT_CLAUDE_CONFIG_PATH, path.join(USER_HOME_DIR, DEFAULT_CLAUDE_CODE_PATH)];
 	for (const defaultPath of defaultPaths) {
@@ -3416,10 +3420,38 @@ const monthlyUsageSchema = objectType({
 	project: stringType().optional()
 });
 /**
+* Zod schema for weekly usage aggregation data
+*/
+const weeklyUsageSchema = objectType({
+	week: weeklyDateSchema,
+	inputTokens: numberType(),
+	outputTokens: numberType(),
+	cacheCreationTokens: numberType(),
+	cacheReadTokens: numberType(),
+	totalCost: numberType(),
+	modelsUsed: arrayType(modelNameSchema),
+	modelBreakdowns: arrayType(modelBreakdownSchema),
+	project: stringType().optional()
+});
+/**
+* Zod schema for bucket usage aggregation data
+*/
+const bucketUsageSchema = objectType({
+	bucket: unionType([weeklyDateSchema, monthlyDateSchema]),
+	inputTokens: numberType(),
+	outputTokens: numberType(),
+	cacheCreationTokens: numberType(),
+	cacheReadTokens: numberType(),
+	totalCost: numberType(),
+	modelsUsed: arrayType(modelNameSchema),
+	modelBreakdowns: arrayType(modelBreakdownSchema),
+	project: stringType().optional()
+});
+/**
 * Aggregates token counts and costs by model name
 */
 function aggregateByModel(entries, getModel, getUsage, getCost) {
-	const modelAggregates = /* @__PURE__ */ new Map();
+	const modelAggregates = new Map();
 	const defaultStats = {
 		inputTokens: 0,
 		outputTokens: 0,
@@ -3447,7 +3479,7 @@ function aggregateByModel(entries, getModel, getUsage, getCost) {
 * Aggregates model breakdowns from multiple sources
 */
 function aggregateModelBreakdowns(breakdowns) {
-	const modelAggregates = /* @__PURE__ */ new Map();
+	const modelAggregates = new Map();
 	const defaultStats = {
 		inputTokens: 0,
 		outputTokens: 0,
@@ -3543,27 +3575,44 @@ function extractUniqueModels(entries, getModel) {
 	return uniq(entries.map(getModel).filter((m$1) => m$1 != null && m$1 !== "<synthetic>"));
 }
 /**
+* Date formatter using Intl.DateTimeFormat for consistent formatting
+* Using UTC to avoid timezone issues
+*/
+const dateFormatter = new Intl.DateTimeFormat("en-CA", {
+	timeZone: "UTC",
+	year: "numeric",
+	month: "2-digit",
+	day: "2-digit"
+});
+/**
 * Formats a date string to YYYY-MM-DD format
 * @param dateStr - Input date string
 * @returns Formatted date string in YYYY-MM-DD format
 */
 function formatDate(dateStr) {
 	const date = new Date(dateStr);
-	const year = date.getFullYear();
-	const month = String(date.getMonth() + 1).padStart(2, "0");
-	const day = String(date.getDate()).padStart(2, "0");
-	return `${year}-${month}-${day}`;
+	return dateFormatter.format(date);
 }
 /**
+* Date parts formatter for extracting year, month, and day separately
+*/
+const datePartsFormatter = new Intl.DateTimeFormat("en", {
+	timeZone: "UTC",
+	year: "numeric",
+	month: "2-digit",
+	day: "2-digit"
+});
+/**
 * Formats a date string to compact format with year on first line and month-day on second
 * @param dateStr - Input date string
 * @returns Formatted date string with newline separator (YYYY\nMM-DD)
 */
 function formatDateCompact(dateStr) {
 	const date = new Date(dateStr);
-	const year = date.getFullYear();
-	const month = String(date.getMonth() + 1).padStart(2, "0");
-	const day = String(date.getDate()).padStart(2, "0");
+	const parts = datePartsFormatter.formatToParts(date);
+	const year = parts.find((p) => p.type === "year")?.value ?? "";
+	const month = parts.find((p) => p.type === "month")?.value ?? "";
+	const day = parts.find((p) => p.type === "day")?.value ?? "";
 	return `${year}\n${month}-${day}`;
 }
 /**
@@ -3666,7 +3715,7 @@ function getUsageLimitResetTime(data) {
 		const timestampMatch = data.message?.content?.find((c) => c.text != null && c.text.includes("Claude AI usage limit reached"))?.text?.match(/\|(\d+)/) ?? null;
 		if (timestampMatch?.[1] != null) {
 			const resetTimestamp = Number.parseInt(timestampMatch[1]);
-			resetTime = resetTimestamp > 0 ? /* @__PURE__ */ new Date(resetTimestamp * 1e3) : null;
+			resetTime = resetTimestamp > 0 ? new Date(resetTimestamp * 1e3) : null;
 		}
 	}
 	return resetTime;
@@ -3707,7 +3756,7 @@ async function loadDailyUsageData(options) {
 		const sortedFiles = await sortFilesByTimestamp(projectFilteredFiles);
 		const mode = options?.mode ?? "auto";
 		const fetcher = _usingCtx.u(mode === "display" ? null : new PricingFetcher(options?.offline));
-		const processedHashes = /* @__PURE__ */ new Set();
+		const processedHashes = new Set();
 		const allEntries = [];
 		for (const file of sortedFiles) {
 			const content = await readFile(file, "utf-8");
@@ -3781,7 +3830,7 @@ async function loadSessionData(options) {
 		})));
 		const mode = options?.mode ?? "auto";
 		const fetcher = _usingCtx3.u(mode === "display" ? null : new PricingFetcher(options?.offline));
-		const processedHashes = /* @__PURE__ */ new Set();
+		const processedHashes = new Set();
 		const allEntries = [];
 		for (const { file, baseDir } of sortedFilesWithBase) {
 			const relativePath = path.relative(baseDir, file);
@@ -3848,15 +3897,55 @@ async function loadSessionData(options) {
 * @returns Array of monthly usage summaries sorted by month
 */
 async function loadMonthlyUsageData(options) {
+	return loadBucketUsageData((data) => createMonthlyDate(data.date.substring(0, 7)), options).then((usages) => usages.map(({ bucket,...rest }) => ({
+		month: createMonthlyDate(bucket.toString()),
+		...rest
+	})));
+}
+/**
+* @param date - The date to get the week for
+* @param startDay - The day to start the week on (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+* @returns The date of the first day of the week for the given date
+*/
+function getDateWeek(date, startDay) {
+	const d$1 = new Date(date);
+	const day = d$1.getDay();
+	const shift = (day - startDay + 7) % 7;
+	d$1.setDate(d$1.getDate() - shift);
+	return createWeeklyDate(d$1.toISOString().substring(0, 10));
+}
+/**
+* Convert day name to number (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+*/
+function getDayNumber(day) {
+	const dayMap = {
+		sunday: 0,
+		monday: 1,
+		tuesday: 2,
+		wednesday: 3,
+		thursday: 4,
+		friday: 5,
+		saturday: 6
+	};
+	return dayMap[day];
+}
+async function loadWeeklyUsageData(options) {
+	const startDay = options?.startOfWeek != null ? getDayNumber(options.startOfWeek) : getDayNumber("sunday");
+	return loadBucketUsageData((data) => getDateWeek(new Date(data.date), startDay), options).then((usages) => usages.map(({ bucket,...rest }) => ({
+		week: createWeeklyDate(bucket.toString()),
+		...rest
+	})));
+}
+async function loadBucketUsageData(groupingFn, options) {
 	const dailyData = await loadDailyUsageData(options);
 	const needsProjectGrouping = options?.groupByProject === true || options?.project != null;
-	const groupingKey = needsProjectGrouping ? (data) => `${data.date.substring(0, 7)}\x00${data.project ?? "unknown"}` : (data) => data.date.substring(0, 7);
-	const groupedByMonth = groupBy(dailyData, groupingKey);
-	const monthlyArray = [];
-	for (const [groupKey, dailyEntries] of Object.entries(groupedByMonth)) {
+	const groupingKey = needsProjectGrouping ? (data) => `${groupingFn(data)}\x00${data.project ?? "unknown"}` : (data) => `${groupingFn(data)}`;
+	const grouped = groupBy(dailyData, groupingKey);
+	const buckets = [];
+	for (const [groupKey, dailyEntries] of Object.entries(grouped)) {
 		if (dailyEntries == null) continue;
 		const parts = groupKey.split("\0");
-		const month = parts[0] ?? groupKey;
+		const bucket = createBucket(parts[0] ?? groupKey);
 		const project = parts.length > 1 ? parts[1] : void 0;
 		const allBreakdowns = dailyEntries.flatMap((daily) => daily.modelBreakdowns);
 		const modelAggregates = aggregateModelBreakdowns(allBreakdowns);
@@ -3875,8 +3964,8 @@ async function loadMonthlyUsageData(options) {
 			totalCacheReadTokens += daily.cacheReadTokens;
 			totalCost += daily.totalCost;
 		}
-		const monthlyUsage = {
-			month: createMonthlyDate(month),
+		const bucketUsage = {
+			bucket,
 			inputTokens: totalInputTokens,
 			outputTokens: totalOutputTokens,
 			cacheCreationTokens: totalCacheCreationTokens,
@@ -3886,9 +3975,9 @@ async function loadMonthlyUsageData(options) {
 			modelBreakdowns,
 			...project != null && { project }
 		};
-		monthlyArray.push(monthlyUsage);
+		buckets.push(bucketUsage);
 	}
-	return sortByDate(monthlyArray, (item) => `${item.month}-01`, options?.order);
+	return sortByDate(buckets, (item) => item.bucket, options?.order);
 }
 /**
 * Loads usage data and organizes it into session blocks (typically 5-hour billing periods)
@@ -3914,7 +4003,7 @@ async function loadSessionBlockData(options) {
 		const sortedFiles = await sortFilesByTimestamp(blocksFilteredFiles);
 		const mode = options?.mode ?? "auto";
 		const fetcher = _usingCtx4.u(mode === "display" ? null : new PricingFetcher(options?.offline));
-		const processedHashes = /* @__PURE__ */ new Set();
+		const processedHashes = new Set();
 		const allEntries = [];
 		for (const file of sortedFiles) {
 			const content = await readFile(file, "utf-8");
@@ -3960,4 +4049,4 @@ async function loadSessionBlockData(options) {
 		_usingCtx4.d();
 	}
 }
-export { DEFAULT_SESSION_DURATION_HOURS, calculateBurnRate, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, glob, globUsageFiles, identifySessionBlocks, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, uniq, unwrap, usageDataSchema };
+export { DEFAULT_SESSION_DURATION_HOURS, bucketUsageSchema, calculateBurnRate, calculateCostForEntry, createUniqueHash, dailyUsageSchema, extractProjectFromPath, filterRecentBlocks, formatDate, formatDateCompact, getClaudePaths, getEarliestTimestamp, getUsageLimitResetTime, glob, globUsageFiles, identifySessionBlocks, loadBucketUsageData, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, loadWeeklyUsageData, modelBreakdownSchema, monthlyUsageSchema, projectBlockUsage, sessionUsageSchema, sortFilesByTimestamp, uniq, unwrap, usageDataSchema, weeklyUsageSchema };

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 };