@revenium/claude-code-metering 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/CHANGELOG.md +22 -28
  2. package/README.md +321 -139
  3. package/dist/cli/commands/backfill.d.ts +98 -1
  4. package/dist/cli/commands/backfill.d.ts.map +1 -1
  5. package/dist/cli/commands/backfill.js +356 -146
  6. package/dist/cli/commands/backfill.js.map +1 -1
  7. package/dist/cli/commands/setup.d.ts +2 -0
  8. package/dist/cli/commands/setup.d.ts.map +1 -1
  9. package/dist/cli/commands/setup.js +55 -49
  10. package/dist/cli/commands/setup.js.map +1 -1
  11. package/dist/cli/commands/status.d.ts.map +1 -1
  12. package/dist/cli/commands/status.js +2 -11
  13. package/dist/cli/commands/status.js.map +1 -1
  14. package/dist/cli/commands/test.d.ts.map +1 -1
  15. package/dist/cli/commands/test.js +23 -22
  16. package/dist/cli/commands/test.js.map +1 -1
  17. package/dist/cli/index.d.ts +2 -1
  18. package/dist/cli/index.d.ts.map +1 -1
  19. package/dist/cli/index.js +44 -30
  20. package/dist/cli/index.js.map +1 -1
  21. package/dist/core/api/client.d.ts +7 -6
  22. package/dist/core/api/client.d.ts.map +1 -1
  23. package/dist/core/api/client.js +52 -47
  24. package/dist/core/api/client.js.map +1 -1
  25. package/dist/core/config/loader.d.ts +5 -13
  26. package/dist/core/config/loader.d.ts.map +1 -1
  27. package/dist/core/config/loader.js +67 -46
  28. package/dist/core/config/loader.js.map +1 -1
  29. package/dist/core/config/validator.d.ts +5 -1
  30. package/dist/core/config/validator.d.ts.map +1 -1
  31. package/dist/core/config/validator.js +37 -22
  32. package/dist/core/config/validator.js.map +1 -1
  33. package/dist/core/config/writer.d.ts +1 -1
  34. package/dist/core/config/writer.d.ts.map +1 -1
  35. package/dist/core/config/writer.js +76 -72
  36. package/dist/core/config/writer.js.map +1 -1
  37. package/dist/core/shell/detector.d.ts +8 -1
  38. package/dist/core/shell/detector.d.ts.map +1 -1
  39. package/dist/core/shell/detector.js +38 -24
  40. package/dist/core/shell/detector.js.map +1 -1
  41. package/dist/core/shell/profile-updater.d.ts +1 -1
  42. package/dist/core/shell/profile-updater.d.ts.map +1 -1
  43. package/dist/core/shell/profile-updater.js +40 -27
  44. package/dist/core/shell/profile-updater.js.map +1 -1
  45. package/dist/index.d.ts +9 -8
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +1 -0
  48. package/dist/index.js.map +1 -1
  49. package/dist/types/index.d.ts +18 -23
  50. package/dist/types/index.d.ts.map +1 -1
  51. package/dist/utils/constants.d.ts +2 -2
  52. package/dist/utils/constants.d.ts.map +1 -1
  53. package/dist/utils/constants.js +21 -21
  54. package/dist/utils/constants.js.map +1 -1
  55. package/dist/utils/hashing.d.ts +18 -0
  56. package/dist/utils/hashing.d.ts.map +1 -0
  57. package/dist/utils/hashing.js +27 -0
  58. package/dist/utils/hashing.js.map +1 -0
  59. package/package.json +6 -3
@@ -1,11 +1,108 @@
1
+ import { homedir } from "node:os";
2
+ import { loadConfig } from "../../core/config/loader.js";
3
+ import type { OTLPLogsPayload } from "../../types/index.js";
1
4
  export interface BackfillOptions {
2
5
  since?: string;
3
6
  dryRun?: boolean;
4
7
  batchSize?: number;
8
+ delay?: number;
5
9
  verbose?: boolean;
6
10
  }
11
+ export interface BackfillDependencies {
12
+ loadConfig: typeof loadConfig;
13
+ findJsonlFiles: typeof findJsonlFiles;
14
+ streamJsonlRecords: typeof streamJsonlRecords;
15
+ sendBatchWithRetry: typeof sendBatchWithRetry;
16
+ homedir: typeof homedir;
17
+ }
18
+ interface ParsedRecord {
19
+ sessionId: string;
20
+ timestamp: string;
21
+ model: string;
22
+ inputTokens: number;
23
+ outputTokens: number;
24
+ cacheReadTokens: number;
25
+ cacheCreationTokens: number;
26
+ }
27
+ interface RetryResult {
28
+ success: boolean;
29
+ attempts: number;
30
+ error?: string;
31
+ }
32
+ /**
33
+ * Sleep for a specified number of milliseconds.
34
+ */
35
+ export declare function sleep(ms: number): Promise<void>;
36
+ /**
37
+ * Sanitize error message to prevent API key leakage.
38
+ * Truncates long messages and removes potential sensitive data.
39
+ */
40
+ export declare function sanitizeErrorMessage(errorMsg: string): string;
41
+ /**
42
+ * Check if an error is retryable based on HTTP status code.
43
+ * 4xx errors (except 429) are not retryable as they indicate client errors.
44
+ */
45
+ export declare function isRetryableError(errorMsg: string): boolean;
46
+ /**
47
+ * Send a batch with retry logic and exponential backoff.
48
+ */
49
+ export declare function sendBatchWithRetry(endpoint: string, apiKey: string, payload: OTLPLogsPayload, maxRetries: number, verbose: boolean): Promise<RetryResult>;
50
+ /**
51
+ * Parses a relative date string like "7d" or "1m" into a Date.
52
+ */
53
+ export declare function parseRelativeDate(input: string): Date | null;
54
+ /**
55
+ * Parses the --since option into a Date.
56
+ */
57
+ export declare function parseSinceDate(since: string): Date | null;
58
+ /**
59
+ * Recursively finds all .jsonl files in a directory.
60
+ * Returns an object with found files and any errors encountered.
61
+ */
62
+ export declare function findJsonlFiles(dir: string, errors?: string[]): Promise<{
63
+ files: string[];
64
+ errors: string[];
65
+ }>;
66
+ interface StreamResult {
67
+ record?: ParsedRecord;
68
+ parseError?: boolean;
69
+ missingFields?: boolean;
70
+ }
71
+ export interface RecordStatistics {
72
+ totalRecords: number;
73
+ oldestTimestamp: string;
74
+ newestTimestamp: string;
75
+ totalInputTokens: number;
76
+ totalOutputTokens: number;
77
+ totalCacheReadTokens: number;
78
+ totalCacheCreationTokens: number;
79
+ }
80
+ export declare function calculateStatistics(records: ParsedRecord[]): RecordStatistics;
81
+ export declare function parseJsonlLine(line: string, sinceDate: Date | null): StreamResult;
82
+ /**
83
+ * Streams a JSONL file and extracts records with usage data.
84
+ * Yields objects indicating either a valid record or a parse error.
85
+ */
86
+ export declare function streamJsonlRecords(filePath: string, sinceDate: Date | null): AsyncGenerator<StreamResult>;
87
+ /**
88
+ * Converts a timestamp to nanoseconds since Unix epoch.
89
+ * Returns null if the timestamp is invalid.
90
+ */
91
+ export declare function toUnixNano(timestamp: string): string | null;
92
+ /**
93
+ * Creates an OTLP logs payload from parsed records.
94
+ * Filters out records with invalid timestamps as a safety measure.
95
+ */
96
+ export interface PayloadOptions {
97
+ costMultiplier: number;
98
+ email?: string;
99
+ organizationId?: string;
100
+ productId?: string;
101
+ }
102
+ export declare function createOtlpPayload(records: ParsedRecord[], options: PayloadOptions): OTLPLogsPayload;
7
103
  /**
8
104
  * Backfill command - imports historical Claude Code usage data.
9
105
  */
10
- export declare function backfillCommand(options?: BackfillOptions): Promise<void>;
106
+ export declare function backfillCommand(options?: BackfillOptions, deps?: Partial<BackfillDependencies>): Promise<void>;
107
+ export {};
11
108
  //# sourceMappingURL=backfill.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backfill.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgRD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8LlF"}
1
+ {"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backfill.ts"],"names":[],"mappings":"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"}