ccusage 11.0.1 → 12.0.0

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

@@ -1,247 +0,0 @@
-import { ArraySchema, CostMode, InferOutput, NumberSchema, ObjectSchema, OptionalSchema, PricingFetcher, RegexAction, SchemaWithPipe, SortOrder, StringSchema } from "./pricing-fetcher-DHaTs-k2.js";
-
-//#region src/session-blocks.internal.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;
-};
-/**
- * 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; // ISO string of block start time
-  startTime: Date;
-  endTime: Date; // startTime + 5 hours (for normal blocks) or gap end time (for gap blocks)
-  actualEndTime?: Date; // Last activity in block
-  isActive: boolean;
-  isGap?: boolean; // True if this is a gap block
-  entries: LoadedUsageEntry[];
-  tokenCounts: TokenCounts;
-  costUSD: number;
-  models: string[];
-};
-/**
- * Represents usage burn rate calculations
- */
-//#endregion
-//#region src/data-loader.d.ts
-/**
- * Default path for Claude data directory
- * Uses environment variable CLAUDE_CONFIG_DIR if set, otherwise defaults to ~/.claude
- */
-declare function getDefaultClaudePath(): string;
-/**
- * Valibot schema for validating Claude usage data from JSONL files
- */
-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>;
-    readonly id: OptionalSchema<StringSchema<undefined>, undefined>;
-  }, undefined>;
-  readonly costUSD: OptionalSchema<NumberSchema<undefined>, undefined>;
-  readonly requestId: OptionalSchema<StringSchema<undefined>, undefined>;
-}, undefined>;
-/**
- * Type definition for Claude usage data entries from JSONL files
- */
-type UsageData = InferOutput<typeof usageDataSchema>;
-/**
- * Valibot schema for model-specific usage breakdown data
- */
-declare const modelBreakdownSchema: ObjectSchema<{
-  readonly modelName: StringSchema<undefined>;
-  readonly inputTokens: NumberSchema<undefined>;
-  readonly outputTokens: NumberSchema<undefined>;
-  readonly cacheCreationTokens: NumberSchema<undefined>;
-  readonly cacheReadTokens: NumberSchema<undefined>;
-  readonly cost: NumberSchema<undefined>;
-}, undefined>;
-/**
- * Type definition for model-specific usage breakdown
- */
-type ModelBreakdown = InferOutput<typeof modelBreakdownSchema>;
-/**
- * Valibot schema for daily usage aggregation data
- */
-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>;
-  readonly modelsUsed: ArraySchema<StringSchema<undefined>, undefined>;
-  readonly modelBreakdowns: ArraySchema<ObjectSchema<{
-    readonly modelName: StringSchema<undefined>;
-    readonly inputTokens: NumberSchema<undefined>;
-    readonly outputTokens: NumberSchema<undefined>;
-    readonly cacheCreationTokens: NumberSchema<undefined>;
-    readonly cacheReadTokens: NumberSchema<undefined>;
-    readonly cost: NumberSchema<undefined>;
-  }, undefined>, undefined>;
-}, undefined>;
-/**
- * Type definition for daily usage aggregation
- */
-type DailyUsage = InferOutput<typeof dailyUsageSchema>;
-/**
- * Valibot schema for session-based usage aggregation data
- */
-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>;
-  readonly modelsUsed: ArraySchema<StringSchema<undefined>, undefined>;
-  readonly modelBreakdowns: ArraySchema<ObjectSchema<{
-    readonly modelName: StringSchema<undefined>;
-    readonly inputTokens: NumberSchema<undefined>;
-    readonly outputTokens: NumberSchema<undefined>;
-    readonly cacheCreationTokens: NumberSchema<undefined>;
-    readonly cacheReadTokens: NumberSchema<undefined>;
-    readonly cost: NumberSchema<undefined>;
-  }, undefined>, undefined>;
-}, undefined>;
-/**
- * Type definition for session-based usage aggregation
- */
-type SessionUsage = InferOutput<typeof sessionUsageSchema>;
-/**
- * Valibot schema for monthly usage aggregation data
- */
-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>;
-  readonly modelsUsed: ArraySchema<StringSchema<undefined>, undefined>;
-  readonly modelBreakdowns: ArraySchema<ObjectSchema<{
-    readonly modelName: StringSchema<undefined>;
-    readonly inputTokens: NumberSchema<undefined>;
-    readonly outputTokens: NumberSchema<undefined>;
-    readonly cacheCreationTokens: NumberSchema<undefined>;
-    readonly cacheReadTokens: NumberSchema<undefined>;
-    readonly cost: NumberSchema<undefined>;
-  }, undefined>, undefined>;
-}, undefined>;
-/**
- * Type definition for monthly usage aggregation
- */
-type MonthlyUsage = InferOutput<typeof monthlyUsageSchema>;
-/**
- * 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<Date | null>;
-/**
- * Sort files by their earliest timestamp
- * Files without valid timestamps are placed at the end
- */
-declare function sortFilesByTimestamp(files: string[]): Promise<string[]>;
-/**
- * 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<number>;
-/**
- * Date range filter for limiting usage data by date
- */
-type DateFilter = {
-  since?: string; // YYYYMMDD format
-  until?: string; // YYYYMMDD format
-};
-/**
- * Configuration options for loading usage data
- */
-type LoadOptions = {
-  claudePath?: string; // Custom path to Claude data directory
-  mode?: CostMode; // Cost calculation mode
-  order?: SortOrder; // Sort order for dates
-  offline?: boolean; // Use offline mode for pricing
-  sessionDurationHours?: number; // Session block duration in hours
-} & 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<DailyUsage[]>;
-/**
- * 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<SessionUsage[]>;
-/**
- * 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<MonthlyUsage[]>;
-/**
- * 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<SessionBlock[]>;
-//#endregion
-export { DailyUsage, DateFilter, LoadOptions, ModelBreakdown, MonthlyUsage, SessionUsage, UsageData, calculateCostForEntry, createUniqueHash, dailyUsageSchema, formatDate, formatDateCompact, getDefaultClaudePath, getEarliestTimestamp, loadDailyUsageData, loadMonthlyUsageData, loadSessionBlockData, loadSessionData, modelBreakdownSchema, monthlyUsageSchema, sessionUsageSchema, sortFilesByTimestamp, usageDataSchema };