@ericdahl.dev/openai-and-claude-usage-report-generator 1.0.3

package/README.md

@@ -0,0 +1,246 @@
+# OpenAI and Claude Usage Report Generator
+
+A CLI tool and library for generating billing reports from the **OpenAI** or **Claude (Anthropic)** cost APIs. Outputs Markdown (readable) and CSV (data) reports.
+
+Can be used as:
+- **CLI tool**: Run reports from the command line
+- **Library**: Import functions programmatically in your Node.js/TypeScript projects
+
+## Features
+
+- Fetches usage/cost data from OpenAI's organization costs API or Anthropic's [Usage and Cost API](https://platform.claude.com/docs/en/build-with-claude/usage-cost-api)
+- Generates detailed Markdown reports with summaries and breakdowns
+- Exports CSV data for further analysis
+- Exports JSON data for programmatic consumption
+- Daily and line-item cost breakdowns
+
+## Prerequisites
+
+- Node.js 18+ and Yarn (`.nvmrc` specifies 22)
+- **OpenAI**: **Admin API key** (not a standard API key), Organization ID, and Project ID
+  - ⚠️ **Important**: Standard API keys do not work. You need an admin key with organization access.
+  - Create one in [OpenAI Platform → Settings → Organization → API keys](https://platform.openai.com/api-keys)
+- **Claude**: Anthropic **Admin API key** (`sk-ant-admin...`)
+  - ⚠️ **Important**: Standard API keys do not work. You need an admin key.
+  - Create one in [Console → Settings → Admin keys](https://console.anthropic.com/settings/admin-keys)
+
+## Installation
+
+### As a CLI Tool (Development)
+
+```bash
+git clone <repository-url>
+cd openai-and-claude-usage-report-generator
+yarn install
+```
+
+### As an npm Package (Library)
+
+```bash
+yarn add @ericdahl.dev/openai-and-claude-usage-report-generator
+# or
+npm install @ericdahl.dev/openai-and-claude-usage-report-generator
+```
+
+## Configuration
+
+Create a `.env` file in the root directory (see `.env.example` for a template).
+
+⚠️ **Important**: Both platforms require **admin/administrative API keys**. Standard API keys will not work.
+
+**OpenAI** (default):
+
+```env
+OPENAI_ADMIN_KEY=sk-...          # Must be an admin key, not a standard API key
+OPENAI_ORG_ID=org-...
+OPENAI_PROJECT_ID=proj_...
+```
+
+**Claude**:
+
+```env
+ANTHROPIC_ADMIN_API_KEY=sk-ant-admin-...  # Must be an admin key (starts with sk-ant-admin), not a standard API key
+```
+
+## Usage
+
+### CLI Usage
+
+Generate a report for a date range. Default provider is OpenAI.
+
+```bash
+yarn report 2024-01-01 2024-01-31
+yarn report 2024-01-01 2024-01-31 --provider openai
+yarn report 2024-01-01 2024-01-31 --provider claude
+```
+
+### Library Usage
+
+Import and use the functions programmatically in your code:
+
+```typescript
+import {
+  fetchOpenAICosts,
+  fetchClaudeCosts,
+  aggregateCosts,
+  generateMarkdownReport,
+  generateCSVReport,
+  generateJSONReport,
+  writeReports,
+  parseDate,
+  validateDateRange,
+  loadConfig,
+} from '@ericdahl.dev/openai-and-claude-usage-report-generator';
+import type { OpenAIReportConfig, ClaudeReportConfig } from '@ericdahl.dev/openai-and-claude-usage-report-generator';
+
+// Example: Fetch and process OpenAI costs
+// Note: OPENAI_ADMIN_KEY must be an admin key, not a standard API key
+async function generateOpenAIReport() {
+  const config: OpenAIReportConfig = {
+    provider: 'openai',
+    startDate: '2024-01-01',
+    endDate: '2024-01-31',
+    apiKey: process.env.OPENAI_ADMIN_KEY!,  // Must be an admin key
+    orgId: process.env.OPENAI_ORG_ID!,
+    projectId: process.env.OPENAI_PROJECT_ID!,
+  };
+
+  // Fetch cost data
+  const buckets = await fetchOpenAICosts(config);
+  
+  // Aggregate the data
+  const aggregated = aggregateCosts(
+    buckets,
+    config.startDate,
+    config.endDate,
+    config.projectId
+  );
+  
+  // Generate reports
+  const markdown = generateMarkdownReport(aggregated, config.orgId, 'openai');
+  const csv = generateCSVReport(aggregated);
+  const json = generateJSONReport(aggregated, config.orgId, 'openai');
+  
+  // Or write directly to files
+  const { mdPath, csvPath, jsonPath } = writeReports(aggregated, config.orgId, 'openai');
+  
+  console.log(`Reports written to ${mdPath}, ${csvPath}, and ${jsonPath}`);
+}
+
+// Example: Fetch and process Claude costs
+// Note: ANTHROPIC_ADMIN_API_KEY must be an admin key (sk-ant-admin...), not a standard API key
+async function generateClaudeReport() {
+  const config: ClaudeReportConfig = {
+    provider: 'claude',
+    startDate: '2024-01-01',
+    endDate: '2024-01-31',
+    apiKey: process.env.ANTHROPIC_ADMIN_API_KEY!,  // Must be an admin key (starts with sk-ant-admin)
+  };
+
+  const buckets = await fetchClaudeCosts(config);
+  const aggregated = aggregateCosts(buckets, config.startDate, config.endDate, 'default');
+  const markdown = generateMarkdownReport(aggregated, 'default', 'claude');
+  
+  console.log(markdown);
+}
+```
+
+**Note**: When using as a library, you need to handle environment variables yourself. The `loadConfig` function is available but requires environment variables to be set, or you can construct the config objects directly as shown above.
+
+⚠️ **Important Reminder**: Both platforms require **admin/administrative API keys**. Standard API keys will not work for accessing cost/usage data.
+
+## Output
+
+- **OpenAI**: `reports/openai/`
+- **Claude**: `reports/claude/`
+
+Each run produces:
+
+- `usage-YYYY-MM-DD-to-YYYY-MM-DD.md` – Human-readable Markdown report
+- `usage-YYYY-MM-DD-to-YYYY-MM-DD.csv` – CSV data export
+- `usage-YYYY-MM-DD-to-YYYY-MM-DD.json` – JSON data export for programmatic consumption
+
+## Report Contents
+
+The Markdown report includes:
+
+- **Summary**: Total cost, billing days, average daily cost
+- **Cost by Model/Service**: Breakdown by line item with percentages
+- **Daily Usage Breakdown**: Detailed daily costs by model/service
+- **Total by Day**: Daily totals for quick overview
+
+The CSV export contains:
+- Date, line item, cost (USD), and project ID for each entry
+
+The JSON export contains:
+- Metadata (provider, billing period, project/organization IDs, generation timestamp)
+- Summary (total cost, billing days, average daily cost)
+- Costs by line item (sorted by cost, includes percentages)
+- Daily breakdown (all daily costs by date and line item)
+- Daily totals (aggregated totals per day)
+
+## API Reference
+
+### Core Functions
+
+#### `fetchOpenAICosts(config: OpenAIReportConfig): Promise<CostBucket[]>`
+Fetches cost data from OpenAI's organization costs API. Returns an array of cost buckets.
+
+#### `fetchClaudeCosts(config: ClaudeReportConfig): Promise<CostBucket[]>`
+Fetches cost data from Anthropic's cost report API. Returns an array of cost buckets (normalized to match OpenAI format).
+
+#### `aggregateCosts(buckets: CostBucket[], startDate: string, endDate: string, projectId: string): AggregatedCosts`
+Aggregates cost buckets into a structured format with totals, daily breakdowns, and line item summaries.
+
+#### `generateMarkdownReport(aggregated: AggregatedCosts, orgId: string, provider: 'openai' | 'claude'): string`
+Generates a human-readable Markdown report from aggregated costs.
+
+#### `generateCSVReport(aggregated: AggregatedCosts): string`
+Generates a CSV report from aggregated costs.
+
+#### `generateJSONReport(aggregated: AggregatedCosts, orgId: string, provider: 'openai' | 'claude'): string`
+Generates a JSON report from aggregated costs. Returns a formatted JSON string with metadata, summary, costs by line item, daily breakdown, and daily totals.
+
+#### `writeReports(aggregated: AggregatedCosts, orgId: string, provider: Provider, baseDir?: string): { mdPath: string; csvPath: string; jsonPath: string }`
+Writes Markdown, CSV, and JSON reports to disk. Returns paths to the generated files.
+
+### Utility Functions
+
+#### `parseDate(dateStr: string): Date`
+Parses a date string in YYYY-MM-DD format and returns a Date object.
+
+#### `validateDateRange(start: Date, end: Date): void`
+Validates that the end date is after the start date. Throws an error if invalid.
+
+#### `loadConfig(startDate: string, endDate: string, provider: Provider): ReportConfig`
+Loads configuration from environment variables. Requires appropriate env vars to be set based on provider.
+
+### Types
+
+All TypeScript types are exported. Key types include:
+- `OpenAIReportConfig` - Configuration for OpenAI API
+- `ClaudeReportConfig` - Configuration for Claude API
+- `AggregatedCosts` - Aggregated cost data structure
+- `CostBucket` - Individual cost bucket from API
+- `DailyCost` - Daily cost entry
+- `Provider` - Union type: `'openai' | 'claude'`
+
+## Development
+
+### Running Tests
+
+```bash
+yarn test        # watch mode
+yarn test:run    # single run (used by CI)
+```
+
+### Building
+
+```bash
+yarn build
+```
+
+### CI
+
+GitHub Actions runs on push and pull requests to `main`: `yarn install --frozen-lockfile`, `yarn test:run`, then `yarn build`. See [.github/workflows/ci.yml](.github/workflows/ci.yml).
+

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env tsx
+/**
+ * CLI Entry Point
+ *
+ * Command-line interface for generating usage reports.
+ * Imports functionality from the library entry point.
+ *
+ * Usage: yarn report YYYY-MM-DD YYYY-MM-DD [--provider openai|claude]
+ */
+import 'dotenv/config';
+import { type Provider } from './index.js';
+export declare function parseArguments(): {
+    startDate: string;
+    endDate: string;
+    provider: Provider;
+};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EASL,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAOpB,wBAAgB,cAAc,IAAI;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAyB3F"}

package/dist/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ *
+ * Command-line interface for generating usage reports.
+ * Imports functionality from the library entry point.
+ *
+ * Usage: yarn report YYYY-MM-DD YYYY-MM-DD [--provider openai|claude]
+ */
+import 'dotenv/config';
+import { fetchOpenAICosts, fetchClaudeCosts, aggregateCosts, writeReports, loadConfig, parseDate, validateDateRange, } from './index.js';
+const USAGE = 'Usage: yarn report YYYY-MM-DD YYYY-MM-DD [--provider openai|claude]\n' +
+    'Example: yarn report 2024-01-01 2024-01-31\n' +
+    'Example: yarn report 2024-01-01 2024-01-31 --provider claude';
+export function parseArguments() {
+    const args = process.argv.slice(2);
+    const providerIdx = args.indexOf('--provider');
+    const providerArg = providerIdx >= 0 && args[providerIdx + 1] != null ? args[providerIdx + 1] : null;
+    const filtered = providerIdx < 0
+        ? args
+        : args.filter((_, i) => i !== providerIdx && i !== providerIdx + 1);
+    if (filtered.length !== 2) {
+        throw new Error(`Invalid arguments\n${USAGE}`);
+    }
+    const provider = providerArg === 'claude' ? 'claude' : providerArg === 'openai' ? 'openai' : 'openai';
+    if (providerArg != null && providerArg !== 'openai' && providerArg !== 'claude') {
+        throw new Error(`Invalid --provider: ${providerArg}. Use openai or claude.\n${USAGE}`);
+    }
+    const [startDate, endDate] = filtered;
+    const start = parseDate(startDate);
+    const end = parseDate(endDate);
+    validateDateRange(start, end);
+    return { startDate, endDate, provider };
+}
+function displayTerminalSummary(aggregated, mdPath, csvPath, jsonPath, provider) {
+    const title = provider === 'claude' ? 'Claude API Usage Report' : 'OpenAI API Usage Report';
+    console.log(title);
+    console.log('=======================');
+    console.log(`Period: ${aggregated.startDate} to ${aggregated.endDate}`);
+    console.log(`Project: ${aggregated.projectId}\n`);
+    console.log(`Total Cost: $${aggregated.totalCost.toFixed(2)} USD`);
+    console.log(`Total Days: ${aggregated.billingDays}`);
+    console.log(`Average Daily Cost: $${aggregated.averageDailyCost.toFixed(2)}\n`);
+    if (aggregated.costsByLineItem.size > 0) {
+        console.log('Top Models/Services:');
+        const sortedLineItems = Array.from(aggregated.costsByLineItem.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        for (const [lineItem, cost] of sortedLineItems) {
+            console.log(`  ${lineItem}: $${cost.toFixed(2)}`);
+        }
+        console.log('');
+    }
+    console.log('Reports generated:');
+    console.log(`  - ${mdPath}`);
+    console.log(`  - ${csvPath}`);
+    console.log(`  - ${jsonPath}`);
+}
+async function main() {
+    try {
+        const { startDate, endDate, provider } = parseArguments();
+        const config = loadConfig(startDate, endDate, provider);
+        const title = provider === 'claude' ? 'Claude API Usage Report' : 'OpenAI API Usage Report';
+        console.log(title);
+        console.log('=======================\n');
+        console.log(`Fetching costs from ${startDate} to ${endDate}...`);
+        const buckets = config.provider === 'openai'
+            ? await fetchOpenAICosts(config)
+            : await fetchClaudeCosts(config);
+        console.log(`Received ${buckets.length} daily buckets\n`);
+        const projectId = config.provider === 'openai' ? config.projectId : 'default';
+        const orgId = config.provider === 'openai' ? config.orgId : 'default';
+        const aggregated = aggregateCosts(buckets, startDate, endDate, projectId);
+        const { mdPath, csvPath, jsonPath } = writeReports(aggregated, orgId, provider);
+        console.log('');
+        displayTerminalSummary(aggregated, mdPath, csvPath, jsonPath, provider);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error('Error:', error.message);
+            if (error.message.includes('OPENAI_ADMIN_KEY')) {
+                console.error('\nHint: Make sure OPENAI_ADMIN_KEY is set in your environment.');
+            }
+            else if (error.message.includes('OPENAI_ORG_ID')) {
+                console.error('\nHint: Make sure OPENAI_ORG_ID is set in your environment.');
+            }
+            else if (error.message.includes('OPENAI_PROJECT_ID')) {
+                console.error('\nHint: Make sure OPENAI_PROJECT_ID is set in your environment.');
+            }
+            else if (error.message.includes('ANTHROPIC_ADMIN_API_KEY')) {
+                console.error('\nHint: Make sure ANTHROPIC_ADMIN_API_KEY is set in your environment.');
+            }
+        }
+        process.exit(1);
+    }
+}
+if (!process.env.VITEST) {
+    main().catch((error) => {
+        console.error('Unexpected error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Library Entry Point
+ *
+ * Exports all public API functions and types for programmatic use.
+ * This is the main entry point when using this package as a library.
+ */
+export type { AggregatedCosts, ClaudeCostBucket, ClaudeCostReport, ClaudeCostResult, ClaudeReportConfig, CostBucket, CostsResponse, DailyCost, OpenAIReportConfig, Provider, ReportConfig, } from './types.js';
+export { parseDate, validateDateRange, loadConfig, aggregateCosts, generateMarkdownReport, generateCSVReport, generateJSONReport, writeReports, fetchOpenAICosts, fetchClaudeCosts, } from './usage-report.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Library Entry Point
+ *
+ * Exports all public API functions and types for programmatic use.
+ * This is the main entry point when using this package as a library.
+ */
+// Re-export public utility functions
+export { parseDate, validateDateRange, loadConfig, aggregateCosts, generateMarkdownReport, generateCSVReport, generateJSONReport, writeReports, fetchOpenAICosts, fetchClaudeCosts, } from './usage-report.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,qCAAqC;AACrC,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from 'vitest';
+// Test that the library entry point exists and exports all expected functions
+describe('Library Entry Point (index.ts)', () => {
+    it('should export all public API functions', async () => {
+        // Dynamic import to test the library entry point
+        const lib = await import('./index.js');
+        // Core functions
+        expect(typeof lib.parseDate).toBe('function');
+        expect(typeof lib.validateDateRange).toBe('function');
+        expect(typeof lib.loadConfig).toBe('function');
+        expect(typeof lib.fetchOpenAICosts).toBe('function');
+        expect(typeof lib.fetchClaudeCosts).toBe('function');
+        expect(typeof lib.aggregateCosts).toBe('function');
+        expect(typeof lib.generateMarkdownReport).toBe('function');
+        expect(typeof lib.generateCSVReport).toBe('function');
+        expect(typeof lib.writeReports).toBe('function');
+    });
+    it('should export all types', async () => {
+        const lib = await import('./index.js');
+        // Types should be available (as TypeScript types, not runtime values)
+        // We can't directly test types at runtime, but we can verify the module exports
+        expect(lib).toBeDefined();
+    });
+    it('should NOT export CLI-specific functions', async () => {
+        const lib = await import('./index.js');
+        // CLI-specific functions should not be exported
+        expect('parseArguments' in lib).toBe(false);
+        expect('main' in lib).toBe(false);
+    });
+    it('should allow importing without CLI dependencies', async () => {
+        // This test verifies the library can be imported without dotenv/config
+        // which is only needed for CLI
+        const lib = await import('./index.js');
+        expect(lib).toBeDefined();
+        expect(typeof lib.fetchOpenAICosts).toBe('function');
+        expect(typeof lib.fetchClaudeCosts).toBe('function');
+    });
+    it('should export fetchOpenAICosts (renamed from fetchCosts)', async () => {
+        const lib = await import('./index.js');
+        // Verify the renamed function exists
+        expect(typeof lib.fetchOpenAICosts).toBe('function');
+        // Verify old name doesn't exist
+        expect('fetchCosts' in lib).toBe(false);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAS9C,8EAA8E;AAC9E,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,iDAAiD;QACjD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,iBAAiB;QACjB,MAAM,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,GAAG,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,sEAAsE;QACtE,gFAAgF;QAChF,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,gDAAgD;QAChD,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,uEAAuE;QACvE,+BAA+B;QAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,qCAAqC;QACrC,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,gCAAgC;QAChC,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../src/integration.test.ts"],"names":[],"mappings":""}

package/dist/integration.test.js

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest';
+/**
+ * Integration tests to verify both CLI and library usage patterns work
+ */
+describe('Integration: CLI and Library Usage', () => {
+    it('should allow importing CLI functions', async () => {
+        const cli = await import('./cli.js');
+        // Verify CLI-specific functions are available
+        expect(typeof cli.parseArguments).toBe('function');
+    });
+    it('should allow importing library functions', async () => {
+        const lib = await import('./index.js');
+        // Verify core library functions are available
+        expect(typeof lib.fetchOpenAICosts).toBe('function');
+        expect(typeof lib.fetchClaudeCosts).toBe('function');
+        expect(typeof lib.aggregateCosts).toBe('function');
+        expect(typeof lib.generateMarkdownReport).toBe('function');
+        expect(typeof lib.generateCSVReport).toBe('function');
+        expect(typeof lib.writeReports).toBe('function');
+        expect(typeof lib.parseDate).toBe('function');
+        expect(typeof lib.validateDateRange).toBe('function');
+        expect(typeof lib.loadConfig).toBe('function');
+    });
+    it('should allow importing types from library', async () => {
+        const lib = await import('./index.js');
+        // Types are available at compile time, but we can verify the module exports
+        expect(lib).toBeDefined();
+    });
+    it('should have CLI import from library (verify separation)', async () => {
+        // This test verifies that cli.ts imports from index.ts (the library)
+        // We can't directly test imports, but we can verify both modules work
+        const cli = await import('./cli.js');
+        const lib = await import('./index.js');
+        // Both should be importable
+        expect(cli).toBeDefined();
+        expect(lib).toBeDefined();
+        // CLI should have parseArguments (CLI-specific)
+        expect(typeof cli.parseArguments).toBe('function');
+        // Library should have core functions but NOT CLI functions
+        expect(typeof lib.fetchOpenAICosts).toBe('function');
+        expect('parseArguments' in lib).toBe(false);
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../src/integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C;;GAEG;AAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAErC,8CAA8C;QAC9C,MAAM,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,8CAA8C;QAC9C,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,GAAG,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtD,MAAM,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,4EAA4E;QAC5E,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAEvC,4BAA4B;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAE1B,gDAAgD;QAChD,MAAM,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnD,2DAA2D;QAC3D,MAAM,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OpenAI Organization Costs API Types
+ * https://platform.openai.com/docs/api-reference/usage
+ *
+ * Claude (Anthropic) Cost API Types
+ * https://platform.claude.com/docs/en/build-with-claude/usage-cost-api
+ */
+export type Provider = 'openai' | 'claude';
+export interface CostsResponse {
+    object: 'page';
+    data: CostBucket[];
+    has_more: boolean;
+    next_page: string | null;
+}
+export interface CostBucket {
+    object: 'bucket';
+    start_time: number;
+    end_time: number;
+    results: CostResult[];
+}
+export interface CostResult {
+    object: 'organization.costs.result';
+    amount: {
+        value: number | string;
+        currency: string;
+    };
+    line_item: string | null;
+    project_id: string | null;
+}
+/** Anthropic cost_report API response (raw). */
+export interface ClaudeCostReport {
+    data: ClaudeCostBucket[];
+    has_more: boolean;
+    next_page: string | null;
+}
+export interface ClaudeCostBucket {
+    starting_at: string;
+    ending_at: string;
+    results: ClaudeCostResult[];
+}
+export interface ClaudeCostResult {
+    amount: string;
+    currency: string;
+    description: string | null;
+    model: string | null;
+    cost_type: string | null;
+    context_window: string | null;
+    token_type: string | null;
+    service_tier: string | null;
+    workspace_id: string | null;
+}
+export interface AggregatedCosts {
+    totalCost: number;
+    startDate: string;
+    endDate: string;
+    projectId: string;
+    dailyCosts: DailyCost[];
+    costsByLineItem: Map<string, number>;
+    billingDays: number;
+    averageDailyCost: number;
+}
+export interface DailyCost {
+    date: string;
+    lineItem: string;
+    cost: number;
+}
+export interface OpenAIReportConfig {
+    provider: 'openai';
+    startDate: string;
+    endDate: string;
+    apiKey: string;
+    orgId: string;
+    projectId: string;
+}
+export interface ClaudeReportConfig {
+    provider: 'claude';
+    startDate: string;
+    endDate: string;
+    apiKey: string;
+}
+export type ReportConfig = OpenAIReportConfig | ClaudeReportConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,2BAA2B,CAAC;IACpC,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,CAAC"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * OpenAI Organization Costs API Types
+ * https://platform.openai.com/docs/api-reference/usage
+ *
+ * Claude (Anthropic) Cost API Types
+ * https://platform.claude.com/docs/en/build-with-claude/usage-cost-api
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/usage-report.d.ts

@@ -0,0 +1,17 @@
+import { AggregatedCosts, CostBucket, type ClaudeReportConfig, type OpenAIReportConfig, type ReportConfig, type Provider } from './types.js';
+export declare function parseDate(dateStr: string): Date;
+export declare function validateDateRange(start: Date, end: Date): void;
+export declare function toUnixTimestamp(date: Date): number;
+export declare function loadConfig(startDate: string, endDate: string, provider: Provider): ReportConfig;
+export declare function fetchOpenAICosts(config: OpenAIReportConfig): Promise<CostBucket[]>;
+export declare function fetchClaudeCosts(config: ClaudeReportConfig): Promise<CostBucket[]>;
+export declare function aggregateCosts(buckets: CostBucket[], startDate: string, endDate: string, projectId: string): AggregatedCosts;
+export declare function generateMarkdownReport(aggregated: AggregatedCosts, orgId: string, provider: 'openai' | 'claude'): string;
+export declare function generateCSVReport(aggregated: AggregatedCosts): string;
+export declare function generateJSONReport(aggregated: AggregatedCosts, orgId: string, provider: 'openai' | 'claude'): string;
+export declare function writeReports(aggregated: AggregatedCosts, orgId: string, provider: Provider, baseDir?: string): {
+    mdPath: string;
+    csvPath: string;
+    jsonPath: string;
+};
+//# sourceMappingURL=usage-report.d.ts.map

package/dist/usage-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-report.d.ts","sourceRoot":"","sources":["../src/usage-report.ts"],"names":[],"mappings":"AASA,OAAO,EACL,eAAe,EAGf,UAAU,EAGV,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAOpB,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAkB/C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAI9D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GACjB,YAAY,CAyBd;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAsCxF;AA2BD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoCxF;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,eAAe,CA2CjB;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,eAAe,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAC5B,MAAM,CAgFR;AAaD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAoBrE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAqDpH;AAmBD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,eAAe,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAiBvD"}