import { n as CostMode, r as SortOrder, t as PricingFetcher } from "./pricing-fetcher-CG7OMen6.mjs"; import { z } from "zod"; //#region src/_session-blocks.d.ts /** * Represents a single usage data entry loaded from JSONL files */ type LoadedUsageEntry = { timestamp: Date; usage: { inputTokens: number; outputTokens: number; cacheCreationInputTokens: number; cacheReadInputTokens: number; }; costUSD: number | null; model: string; version?: string; usageLimitResetTime?: Date; }; /** * Aggregated token counts for different token types */ type TokenCounts = { inputTokens: number; outputTokens: number; cacheCreationInputTokens: number; cacheReadInputTokens: number; }; /** * Represents a session block (typically 5-hour billing period) with usage data */ type SessionBlock = { id: string; startTime: Date; endTime: Date; actualEndTime?: Date; isActive: boolean; isGap?: boolean; entries: LoadedUsageEntry[]; tokenCounts: TokenCounts; costUSD: number; models: string[]; usageLimitResetTime?: Date; }; //#endregion //#region src/data-loader.d.ts /** * 清理全局共享的PricingFetcher缓存(用于强制刷新价格数据) */ declare function clearGlobalPricingCache(): void; /** * Get all Claude data directories to search for usage data * Supports multiple paths: environment variable (comma-separated), new default, and old default * @returns Array of valid Claude data directory paths */ declare function getClaudePaths(): string[]; /** * Extract project name from Claude JSONL file path * @param jsonlPath - Absolute path to JSONL file * @returns Project name extracted from path, or "unknown" if malformed */ declare function extractProjectFromPath(jsonlPath: string): string; /** * Zod schema for validating Claude usage data from JSONL files */ declare const usageDataSchema: z.ZodObject<{ timestamp: z.ZodBranded; version: z.ZodOptional>; message: z.ZodObject<{ usage: z.ZodObject<{ input_tokens: z.ZodNumber; output_tokens: z.ZodNumber; cache_creation_input_tokens: z.ZodOptional; cache_read_input_tokens: z.ZodOptional; }, "strip", z.ZodTypeAny, { input_tokens: number; output_tokens: number; cache_creation_input_tokens?: number | undefined; cache_read_input_tokens?: number | undefined; }, { input_tokens: number; output_tokens: number; cache_creation_input_tokens?: number | undefined; cache_read_input_tokens?: number | undefined; }>; model: z.ZodOptional>; id: z.ZodOptional>; content: z.ZodOptional; }, "strip", z.ZodTypeAny, { text?: string | undefined; }, { text?: string | undefined; }>, "many">>; }, "strip", z.ZodTypeAny, { usage: { input_tokens: number; output_tokens: number; cache_creation_input_tokens?: number | undefined; cache_read_input_tokens?: number | undefined; }; model?: (string & z.BRAND<"ModelName">) | undefined; id?: (string & z.BRAND<"MessageId">) | undefined; content?: { text?: string | undefined; }[] | undefined; }, { usage: { input_tokens: number; output_tokens: number; cache_creation_input_tokens?: number | undefined; cache_read_input_tokens?: number | undefined; }; model?: string | undefined; id?: string | undefined; content?: { text?: string | undefined; }[] | undefined; }>; costUSD: z.ZodOptional; requestId: z.ZodOptional>; isApiErrorMessage: z.ZodOptional; }, "strip", z.ZodTypeAny, { timestamp: string & z.BRAND<"ISOTimestamp">; version?: (string & z.BRAND<"Version">) | undefined; message: { usage: { input_tokens: number; output_tokens: number; cache_creation_input_tokens?: number | undefined; cache_read_input_tokens?: number | undefined; }; model?: (string & z.BRAND<"ModelName">) | undefined; id?: (string & z.BRAND<"MessageId">) | undefined; content?: { text?: string | undefined; }[] | undefined; }; costUSD?: number | undefined; requestId?: (string & z.BRAND<"RequestId">) | undefined; isApiErrorMessage?: boolean | undefined; }, { timestamp: string; version?: string | undefined; message: { usage: { input_tokens: number; output_tokens: number; cache_creation_input_tokens?: number | undefined; cache_read_input_tokens?: number | undefined; }; model?: string | undefined; id?: string | undefined; content?: { text?: string | undefined; }[] | undefined; }; costUSD?: number | undefined; requestId?: string | undefined; isApiErrorMessage?: boolean | undefined; }>; /** * Type definition for Claude usage data entries from JSONL files */ type UsageData = z.infer; /** * Zod schema for model-specific usage breakdown data */ declare const modelBreakdownSchema: z.ZodObject<{ modelName: z.ZodBranded; 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; }>; /** * Type definition for model-specific usage breakdown */ type ModelBreakdown = z.infer; /** * Zod schema for daily usage aggregation data */ declare const dailyUsageSchema: z.ZodObject<{ date: z.ZodBranded; inputTokens: z.ZodNumber; outputTokens: z.ZodNumber; cacheCreationTokens: z.ZodNumber; cacheReadTokens: z.ZodNumber; totalCost: z.ZodNumber; modelsUsed: z.ZodArray, "many">; modelBreakdowns: z.ZodArray; 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; }, "strip", z.ZodTypeAny, { date: string & z.BRAND<"DailyDate">; 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; }, { date: 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 daily usage aggregation */ type DailyUsage = z.infer; /** * Zod schema for session-based usage aggregation data */ declare const sessionUsageSchema: z.ZodObject<{ sessionId: z.ZodBranded; projectPath: z.ZodBranded; inputTokens: z.ZodNumber; outputTokens: z.ZodNumber; cacheCreationTokens: z.ZodNumber; cacheReadTokens: z.ZodNumber; totalCost: z.ZodNumber; lastActivity: z.ZodBranded; versions: z.ZodArray, "many">; modelsUsed: z.ZodArray, "many">; modelBreakdowns: z.ZodArray; 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">; }, "strip", z.ZodTypeAny, { sessionId: string & z.BRAND<"SessionId">; projectPath: string & z.BRAND<"ProjectPath">; inputTokens: number; outputTokens: number; cacheCreationTokens: number; cacheReadTokens: number; totalCost: number; lastActivity: string & z.BRAND<"ActivityDate">; versions: (string & z.BRAND<"Version">)[]; modelsUsed: (string & z.BRAND<"ModelName">)[]; modelBreakdowns: { modelName: string & z.BRAND<"ModelName">; inputTokens: number; outputTokens: number; cacheCreationTokens: number; cacheReadTokens: number; cost: number; }[]; }, { sessionId: string; projectPath: string; inputTokens: number; outputTokens: number; cacheCreationTokens: number; cacheReadTokens: number; totalCost: number; lastActivity: string; versions: string[]; modelsUsed: string[]; modelBreakdowns: { modelName: string; inputTokens: number; outputTokens: number; cacheCreationTokens: number; cacheReadTokens: number; cost: number; }[]; }>; /** * Type definition for session-based usage aggregation */ type SessionUsage = z.infer; /** * Zod schema for monthly usage aggregation data */ declare const monthlyUsageSchema: z.ZodObject<{ month: z.ZodBranded; inputTokens: z.ZodNumber; outputTokens: z.ZodNumber; cacheCreationTokens: z.ZodNumber; cacheReadTokens: z.ZodNumber; totalCost: z.ZodNumber; modelsUsed: z.ZodArray, "many">; modelBreakdowns: z.ZodArray; 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; }, "strip", z.ZodTypeAny, { month: string & z.BRAND<"MonthlyDate">; 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; }, { month: 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 monthly usage aggregation */ type MonthlyUsage = z.infer; /** * Formats a date string to YYYY-MM-DD format * @param dateStr - Input date string * @returns Formatted date string in YYYY-MM-DD format */ declare function formatDate(dateStr: string): string; /** * 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) */ declare function formatDateCompact(dateStr: string): string; /** * Create a unique identifier for deduplication using message ID and request ID */ declare function createUniqueHash(data: UsageData): string | null; /** * Extract the earliest timestamp from a JSONL file * Scans through the file until it finds a valid timestamp */ declare function getEarliestTimestamp(filePath: string): Promise; /** * Sort files by their earliest timestamp * Files without valid timestamps are placed at the end */ declare function sortFilesByTimestamp(files: string[]): Promise; /** * Calculates cost for a single usage data entry based on the specified cost calculation mode * @param data - Usage data entry * @param mode - Cost calculation mode (auto, calculate, or display) * @param fetcher - Pricing fetcher instance for calculating costs from tokens * @returns Calculated cost in USD */ declare function calculateCostForEntry(data: UsageData, mode: CostMode, fetcher: PricingFetcher): Promise; /** * Get Claude Code usage limit expiration date * @param data - Usage data entry * @returns Usage limit expiration date */ declare function getUsageLimitResetTime(data: UsageData): Date | null; /** * Result of glob operation with base directory information */ type GlobResult = { file: string; baseDir: string; }; /** * Glob files from multiple Claude paths in parallel * @param claudePaths - Array of Claude base paths * @returns Array of file paths with their base directories */ declare function globUsageFiles(claudePaths: string[]): Promise; /** * Date range filter for limiting usage data by date */ type DateFilter = { since?: string; until?: string; }; /** * Configuration options for loading usage data */ type LoadOptions = { claudePath?: string; mode?: CostMode; order?: SortOrder; offline?: boolean; sessionDurationHours?: number; groupByProject?: boolean; project?: string; } & DateFilter; /** * Loads and aggregates Claude usage data by day * Processes all JSONL files in the Claude projects directory and groups usage by date * @param options - Optional configuration for loading and filtering data * @returns Array of daily usage summaries sorted by date */ declare function loadDailyUsageData(options?: LoadOptions): Promise; /** * Loads and aggregates Claude usage data by session * Groups usage data by project path and session ID based on file structure * @param options - Optional configuration for loading and filtering data * @returns Array of session usage summaries sorted by last activity */ declare function loadSessionData(options?: LoadOptions): Promise; /** * Loads and aggregates Claude usage data by month * Uses daily usage data as the source and groups by month * @param options - Optional configuration for loading and filtering data * @returns Array of monthly usage summaries sorted by month */ declare function loadMonthlyUsageData(options?: LoadOptions): Promise; /** * 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 * @param options - Optional configuration including session duration and filtering * @returns Array of session blocks with usage and cost information */ declare function loadSessionBlockData(options?: LoadOptions): Promise; //#endregion export { loadSessionData as C, sortFilesByTimestamp as D, sessionUsageSchema as E, usageDataSchema as O, loadSessionBlockData as S, monthlyUsageSchema as T, getEarliestTimestamp as _, ModelBreakdown as a, loadDailyUsageData as b, UsageData as c, createUniqueHash as d, dailyUsageSchema as f, getClaudePaths as g, formatDateCompact as h, LoadOptions as i, calculateCostForEntry as l, formatDate as m, DateFilter as n, MonthlyUsage as o, extractProjectFromPath as p, GlobResult as r, SessionUsage as s, DailyUsage as t, clearGlobalPricingCache as u, getUsageLimitResetTime as v, modelBreakdownSchema as w, loadMonthlyUsageData as x, globUsageFiles as y };