@antseed/node 0.1.0

package/dist/metering/storage.js

@@ -0,0 +1,446 @@
+import Database from 'better-sqlite3';
+/**
+ * SQLite storage for metering data.
+ * All data is stored locally on the user's machine.
+ */
+export class MeteringStorage {
+    db;
+    /**
+     * Open or create the SQLite database at the given path.
+     * Creates tables if they don't exist.
+     *
+     * @param dbPath - Path to the SQLite database file (or ':memory:' for tests)
+     */
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.initializeSchema();
+    }
+    /**
+     * Create tables and indices if they don't exist.
+     */
+    initializeSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS metering_events (
+        event_id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        provider TEXT NOT NULL,
+        seller_peer_id TEXT NOT NULL,
+        buyer_peer_id TEXT NOT NULL,
+        input_tokens INTEGER NOT NULL,
+        output_tokens INTEGER NOT NULL,
+        total_tokens INTEGER NOT NULL,
+        token_method TEXT NOT NULL,
+        token_confidence TEXT NOT NULL,
+        latency_ms INTEGER NOT NULL,
+        status_code INTEGER NOT NULL,
+        was_streaming INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_events_session ON metering_events(session_id);
+      CREATE INDEX IF NOT EXISTS idx_events_timestamp ON metering_events(timestamp);
+
+      CREATE TABLE IF NOT EXISTS usage_receipts (
+        receipt_id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        event_id TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        provider TEXT NOT NULL,
+        seller_peer_id TEXT NOT NULL,
+        buyer_peer_id TEXT NOT NULL,
+        input_tokens INTEGER NOT NULL,
+        output_tokens INTEGER NOT NULL,
+        total_tokens INTEGER NOT NULL,
+        token_method TEXT NOT NULL,
+        token_confidence TEXT NOT NULL,
+        unit_price_cents_per_thousand_tokens INTEGER NOT NULL,
+        cost_cents INTEGER NOT NULL,
+        signature TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_receipts_session ON usage_receipts(session_id);
+      CREATE INDEX IF NOT EXISTS idx_receipts_timestamp ON usage_receipts(timestamp);
+
+      CREATE TABLE IF NOT EXISTS receipt_verifications (
+        receipt_id TEXT PRIMARY KEY,
+        signature_valid INTEGER NOT NULL,
+        buyer_input_tokens INTEGER NOT NULL,
+        buyer_output_tokens INTEGER NOT NULL,
+        buyer_total_tokens INTEGER NOT NULL,
+        seller_total_tokens INTEGER NOT NULL,
+        token_difference INTEGER NOT NULL,
+        percentage_difference REAL NOT NULL,
+        disputed INTEGER NOT NULL,
+        verified_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS sessions (
+        session_id TEXT PRIMARY KEY,
+        seller_peer_id TEXT NOT NULL,
+        buyer_peer_id TEXT NOT NULL,
+        provider TEXT NOT NULL,
+        started_at INTEGER NOT NULL,
+        ended_at INTEGER,
+        total_requests INTEGER NOT NULL,
+        total_tokens INTEGER NOT NULL,
+        total_cost_cents INTEGER NOT NULL,
+        avg_latency_ms REAL NOT NULL,
+        peer_switches INTEGER NOT NULL,
+        disputed_receipts INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_sessions_started ON sessions(started_at);
+      CREATE INDEX IF NOT EXISTS idx_sessions_provider ON sessions(provider);
+    `);
+    }
+    // --- Metering Events ---
+    /** Insert a metering event. */
+    insertEvent(event) {
+        const stmt = this.db.prepare(`
+      INSERT INTO metering_events (
+        event_id, session_id, timestamp, provider,
+        seller_peer_id, buyer_peer_id,
+        input_tokens, output_tokens, total_tokens,
+        token_method, token_confidence,
+        latency_ms, status_code, was_streaming
+      ) VALUES (
+        @eventId, @sessionId, @timestamp, @provider,
+        @sellerPeerId, @buyerPeerId,
+        @inputTokens, @outputTokens, @totalTokens,
+        @tokenMethod, @tokenConfidence,
+        @latencyMs, @statusCode, @wasStreaming
+      )
+    `);
+        stmt.run({
+            eventId: event.eventId,
+            sessionId: event.sessionId,
+            timestamp: event.timestamp,
+            provider: event.provider,
+            sellerPeerId: event.sellerPeerId,
+            buyerPeerId: event.buyerPeerId,
+            inputTokens: event.tokens.inputTokens,
+            outputTokens: event.tokens.outputTokens,
+            totalTokens: event.tokens.totalTokens,
+            tokenMethod: event.tokens.method,
+            tokenConfidence: event.tokens.confidence,
+            latencyMs: event.latencyMs,
+            statusCode: event.statusCode,
+            wasStreaming: event.wasStreaming ? 1 : 0,
+        });
+    }
+    /** Get events for a session. */
+    getEventsBySession(sessionId) {
+        const stmt = this.db.prepare('SELECT * FROM metering_events WHERE session_id = ? ORDER BY timestamp');
+        const rows = stmt.all(sessionId);
+        return rows.map(rowToEvent);
+    }
+    /** Get events in a time range. */
+    getEventsByTimeRange(startMs, endMs) {
+        const stmt = this.db.prepare('SELECT * FROM metering_events WHERE timestamp >= ? AND timestamp < ? ORDER BY timestamp');
+        const rows = stmt.all(startMs, endMs);
+        return rows.map(rowToEvent);
+    }
+    // --- Usage Receipts ---
+    /** Insert a usage receipt. */
+    insertReceipt(receipt) {
+        const stmt = this.db.prepare(`
+      INSERT INTO usage_receipts (
+        receipt_id, session_id, event_id, timestamp, provider,
+        seller_peer_id, buyer_peer_id,
+        input_tokens, output_tokens, total_tokens,
+        token_method, token_confidence,
+        unit_price_cents_per_thousand_tokens, cost_cents, signature
+      ) VALUES (
+        @receiptId, @sessionId, @eventId, @timestamp, @provider,
+        @sellerPeerId, @buyerPeerId,
+        @inputTokens, @outputTokens, @totalTokens,
+        @tokenMethod, @tokenConfidence,
+        @unitPriceCentsPerThousandTokens, @costCents, @signature
+      )
+    `);
+        stmt.run({
+            receiptId: receipt.receiptId,
+            sessionId: receipt.sessionId,
+            eventId: receipt.eventId,
+            timestamp: receipt.timestamp,
+            provider: receipt.provider,
+            sellerPeerId: receipt.sellerPeerId,
+            buyerPeerId: receipt.buyerPeerId,
+            inputTokens: receipt.tokens.inputTokens,
+            outputTokens: receipt.tokens.outputTokens,
+            totalTokens: receipt.tokens.totalTokens,
+            tokenMethod: receipt.tokens.method,
+            tokenConfidence: receipt.tokens.confidence,
+            unitPriceCentsPerThousandTokens: receipt.unitPriceCentsPerThousandTokens,
+            costCents: receipt.costCents,
+            signature: receipt.signature,
+        });
+    }
+    /** Get receipts for a session. */
+    getReceiptsBySession(sessionId) {
+        const stmt = this.db.prepare('SELECT * FROM usage_receipts WHERE session_id = ? ORDER BY timestamp');
+        const rows = stmt.all(sessionId);
+        return rows.map(rowToReceipt);
+    }
+    /** Get all receipts in a time range. */
+    getReceiptsByTimeRange(startMs, endMs) {
+        const stmt = this.db.prepare('SELECT * FROM usage_receipts WHERE timestamp >= ? AND timestamp < ? ORDER BY timestamp');
+        const rows = stmt.all(startMs, endMs);
+        return rows.map(rowToReceipt);
+    }
+    /** Get total cost in a time range (sum of costCents). */
+    getTotalCost(startMs, endMs) {
+        const stmt = this.db.prepare('SELECT COALESCE(SUM(cost_cents), 0) as total FROM usage_receipts WHERE timestamp >= ? AND timestamp < ?');
+        const row = stmt.get(startMs, endMs);
+        return row.total;
+    }
+    // --- Receipt Verifications ---
+    /** Insert a verification result. */
+    insertVerification(verification) {
+        const stmt = this.db.prepare(`
+      INSERT INTO receipt_verifications (
+        receipt_id, signature_valid,
+        buyer_input_tokens, buyer_output_tokens, buyer_total_tokens,
+        seller_total_tokens,
+        token_difference, percentage_difference,
+        disputed, verified_at
+      ) VALUES (
+        @receiptId, @signatureValid,
+        @buyerInputTokens, @buyerOutputTokens, @buyerTotalTokens,
+        @sellerTotalTokens,
+        @tokenDifference, @percentageDifference,
+        @disputed, @verifiedAt
+      )
+    `);
+        stmt.run({
+            receiptId: verification.receiptId,
+            signatureValid: verification.signatureValid ? 1 : 0,
+            buyerInputTokens: verification.buyerTokenEstimate.inputTokens,
+            buyerOutputTokens: verification.buyerTokenEstimate.outputTokens,
+            buyerTotalTokens: verification.buyerTokenEstimate.totalTokens,
+            sellerTotalTokens: verification.sellerTokenEstimate.totalTokens,
+            tokenDifference: verification.tokenDifference,
+            percentageDifference: verification.percentageDifference,
+            disputed: verification.disputed ? 1 : 0,
+            verifiedAt: verification.verifiedAt,
+        });
+    }
+    /** Get all disputed verifications in a time range. */
+    getDisputedVerifications(startMs, endMs) {
+        const stmt = this.db.prepare('SELECT * FROM receipt_verifications WHERE disputed = 1 AND verified_at >= ? AND verified_at < ? ORDER BY verified_at');
+        const rows = stmt.all(startMs, endMs);
+        return rows.map(rowToVerification);
+    }
+    // --- Sessions ---
+    /** Upsert session metrics (insert or update). */
+    upsertSession(metrics) {
+        const stmt = this.db.prepare(`
+      INSERT INTO sessions (
+        session_id, seller_peer_id, buyer_peer_id, provider,
+        started_at, ended_at,
+        total_requests, total_tokens, total_cost_cents,
+        avg_latency_ms, peer_switches, disputed_receipts
+      ) VALUES (
+        @sessionId, @sellerPeerId, @buyerPeerId, @provider,
+        @startedAt, @endedAt,
+        @totalRequests, @totalTokens, @totalCostCents,
+        @avgLatencyMs, @peerSwitches, @disputedReceipts
+      )
+      ON CONFLICT(session_id) DO UPDATE SET
+        ended_at = @endedAt,
+        total_requests = @totalRequests,
+        total_tokens = @totalTokens,
+        total_cost_cents = @totalCostCents,
+        avg_latency_ms = @avgLatencyMs,
+        peer_switches = @peerSwitches,
+        disputed_receipts = @disputedReceipts
+    `);
+        stmt.run({
+            sessionId: metrics.sessionId,
+            sellerPeerId: metrics.sellerPeerId,
+            buyerPeerId: metrics.buyerPeerId,
+            provider: metrics.provider,
+            startedAt: metrics.startedAt,
+            endedAt: metrics.endedAt,
+            totalRequests: metrics.totalRequests,
+            totalTokens: metrics.totalTokens,
+            totalCostCents: metrics.totalCostCents,
+            avgLatencyMs: metrics.avgLatencyMs,
+            peerSwitches: metrics.peerSwitches,
+            disputedReceipts: metrics.disputedReceipts,
+        });
+    }
+    /** Get a session by ID. */
+    getSession(sessionId) {
+        const stmt = this.db.prepare('SELECT * FROM sessions WHERE session_id = ?');
+        const row = stmt.get(sessionId);
+        return row ? rowToSession(row) : null;
+    }
+    /** Get all sessions in a time range. */
+    getSessionsByTimeRange(startMs, endMs) {
+        const stmt = this.db.prepare('SELECT * FROM sessions WHERE started_at >= ? AND started_at < ? ORDER BY started_at');
+        const rows = stmt.all(startMs, endMs);
+        return rows.map(rowToSession);
+    }
+    /** Get session count and total cost for a time range. */
+    getSessionSummary(startMs, endMs) {
+        const stmt = this.db.prepare(`
+      SELECT
+        COUNT(*) as session_count,
+        COALESCE(SUM(total_requests), 0) as total_requests,
+        COALESCE(SUM(total_tokens), 0) as total_tokens,
+        COALESCE(SUM(total_cost_cents), 0) as total_cost_cents
+      FROM sessions
+      WHERE started_at >= ? AND started_at < ?
+    `);
+        const row = stmt.get(startMs, endMs);
+        return {
+            sessionCount: row.session_count,
+            totalRequests: row.total_requests,
+            totalTokens: row.total_tokens,
+            totalCostCents: row.total_cost_cents,
+        };
+    }
+    /** Get total tokens from metering events in a time range (real-time, per-request). */
+    getEventTokenSummary(startMs, endMs) {
+        const stmt = this.db.prepare(`
+      SELECT
+        COUNT(*) as total_requests,
+        COALESCE(SUM(total_tokens), 0) as total_tokens,
+        COALESCE(SUM(input_tokens), 0) as input_tokens,
+        COALESCE(SUM(output_tokens), 0) as output_tokens
+      FROM metering_events
+      WHERE timestamp >= ? AND timestamp < ?
+    `);
+        const row = stmt.get(startMs, endMs);
+        return {
+            totalRequests: row.total_requests,
+            totalTokens: row.total_tokens,
+            inputTokens: row.input_tokens,
+            outputTokens: row.output_tokens,
+        };
+    }
+    // --- Maintenance ---
+    /**
+     * Delete data older than the given timestamp.
+     * Used for storage maintenance / retention policy.
+     */
+    pruneOlderThan(timestampMs) {
+        const deleteEvents = this.db.prepare('DELETE FROM metering_events WHERE timestamp < ?');
+        const deleteReceipts = this.db.prepare('DELETE FROM usage_receipts WHERE timestamp < ?');
+        const deleteVerifications = this.db.prepare('DELETE FROM receipt_verifications WHERE verified_at < ?');
+        const deleteSessions = this.db.prepare('DELETE FROM sessions WHERE started_at < ?');
+        const eventsResult = deleteEvents.run(timestampMs);
+        const receiptsResult = deleteReceipts.run(timestampMs);
+        const verificationsResult = deleteVerifications.run(timestampMs);
+        const sessionsResult = deleteSessions.run(timestampMs);
+        return {
+            eventsDeleted: eventsResult.changes,
+            receiptsDeleted: receiptsResult.changes,
+            verificationsDeleted: verificationsResult.changes,
+            sessionsDeleted: sessionsResult.changes,
+        };
+    }
+    /**
+     * Close the database connection.
+     */
+    close() {
+        this.db.close();
+    }
+}
+// --- Row mapping functions ---
+const VALID_TOKEN_METHODS = new Set(['content-length', 'chunk-accumulation', 'fallback']);
+const VALID_TOKEN_CONFIDENCES = new Set(['high', 'medium', 'low']);
+function validateTokenMethod(value) {
+    if (VALID_TOKEN_METHODS.has(value))
+        return value;
+    return 'fallback';
+}
+function validateTokenConfidence(value) {
+    if (VALID_TOKEN_CONFIDENCES.has(value))
+        return value;
+    return 'low';
+}
+function rowToEvent(row) {
+    return {
+        eventId: row.event_id,
+        sessionId: row.session_id,
+        timestamp: row.timestamp,
+        provider: row.provider,
+        sellerPeerId: row.seller_peer_id,
+        buyerPeerId: row.buyer_peer_id,
+        tokens: {
+            inputTokens: row.input_tokens,
+            outputTokens: row.output_tokens,
+            totalTokens: row.total_tokens,
+            method: validateTokenMethod(row.token_method),
+            confidence: validateTokenConfidence(row.token_confidence),
+        },
+        latencyMs: row.latency_ms,
+        statusCode: row.status_code,
+        wasStreaming: row.was_streaming === 1,
+    };
+}
+function rowToReceipt(row) {
+    return {
+        receiptId: row.receipt_id,
+        sessionId: row.session_id,
+        eventId: row.event_id,
+        timestamp: row.timestamp,
+        provider: row.provider,
+        sellerPeerId: row.seller_peer_id,
+        buyerPeerId: row.buyer_peer_id,
+        tokens: {
+            inputTokens: row.input_tokens,
+            outputTokens: row.output_tokens,
+            totalTokens: row.total_tokens,
+            method: validateTokenMethod(row.token_method),
+            confidence: validateTokenConfidence(row.token_confidence),
+        },
+        unitPriceCentsPerThousandTokens: row.unit_price_cents_per_thousand_tokens,
+        costCents: row.cost_cents,
+        signature: row.signature,
+    };
+}
+function rowToVerification(row) {
+    return {
+        receiptId: row.receipt_id,
+        signatureValid: row.signature_valid === 1,
+        buyerTokenEstimate: {
+            inputTokens: row.buyer_input_tokens,
+            outputTokens: row.buyer_output_tokens,
+            totalTokens: row.buyer_total_tokens,
+            method: 'content-length',
+            confidence: 'high',
+        },
+        sellerTokenEstimate: {
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: row.seller_total_tokens,
+            method: 'content-length',
+            confidence: 'high',
+        },
+        tokenDifference: row.token_difference,
+        percentageDifference: row.percentage_difference,
+        disputed: row.disputed === 1,
+        verifiedAt: row.verified_at,
+    };
+}
+function rowToSession(row) {
+    return {
+        sessionId: row.session_id,
+        sellerPeerId: row.seller_peer_id,
+        buyerPeerId: row.buyer_peer_id,
+        provider: row.provider,
+        startedAt: row.started_at,
+        endedAt: row.ended_at,
+        totalRequests: row.total_requests,
+        totalTokens: row.total_tokens,
+        totalCostCents: row.total_cost_cents,
+        avgLatencyMs: row.avg_latency_ms,
+        peerSwitches: row.peer_switches,
+        disputedReceipts: row.disputed_receipts,
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/metering/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/metering/storage.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAStC;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,EAAE,CAAoB;IAEvC;;;;;OAKG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwEZ,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAE1B,+BAA+B;IAC/B,WAAW,CAAC,KAAoB;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;KAc5B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC;YACP,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;YACrC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;YACvC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;YACrC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAChC,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YACxC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,kBAAkB,CAAC,SAAiB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,uEAAuE,CACxE,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAe,CAAC;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,kCAAkC;IAClC,oBAAoB,CAAC,OAAe,EAAE,KAAa;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,yFAAyF,CAC1F,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAe,CAAC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,yBAAyB;IAEzB,8BAA8B;IAC9B,aAAa,CAAC,OAAqB;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;KAc5B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;YACvC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY;YACzC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW;YACvC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;YAClC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU;YAC1C,+BAA+B,EAAE,OAAO,CAAC,+BAA+B;YACxE,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,oBAAoB,CAAC,SAAiB;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,sEAAsE,CACvE,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAiB,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,wCAAwC;IACxC,sBAAsB,CAAC,OAAe,EAAE,KAAa;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,wFAAwF,CACzF,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAiB,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,OAAe,EAAE,KAAa;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,yGAAyG,CAC1G,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAsB,CAAC;QAC1D,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,gCAAgC;IAEhC,oCAAoC;IACpC,kBAAkB,CAAC,YAAiC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;KAc5B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,cAAc,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,WAAW;YAC7D,iBAAiB,EAAE,YAAY,CAAC,kBAAkB,CAAC,YAAY;YAC/D,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,WAAW;YAC7D,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,WAAW;YAC/D,eAAe,EAAE,YAAY,CAAC,eAAe;YAC7C,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;YACvD,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,UAAU,EAAE,YAAY,CAAC,UAAU;SACpC,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,wBAAwB,CAAC,OAAe,EAAE,KAAa;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,sHAAsH,CACvH,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAsB,CAAC;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,mBAAmB;IAEnB,iDAAiD;IACjD,aAAa,CAAC,OAAuB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;KAoB5B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC;YACP,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,2BAA2B;IAC3B,UAAU,CAAC,SAAiB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAA2B,CAAC;QAC1D,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,wCAAwC;IACxC,sBAAsB,CAAC,OAAe,EAAE,KAAa;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,qFAAqF,CACtF,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAiB,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,yDAAyD;IACzD,iBAAiB,CAAC,OAAe,EAAE,KAAa;QAM9C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;KAQ5B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAKlC,CAAC;QACF,OAAO;YACL,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,aAAa,EAAE,GAAG,CAAC,cAAc;YACjC,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,cAAc,EAAE,GAAG,CAAC,gBAAgB;SACrC,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,oBAAoB,CAAC,OAAe,EAAE,KAAa;QAMjD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;KAQ5B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAKlC,CAAC;QACF,OAAO;YACL,aAAa,EAAE,GAAG,CAAC,cAAc;YACjC,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,YAAY,EAAE,GAAG,CAAC,aAAa;SAChC,CAAC;IACJ,CAAC;IAED,sBAAsB;IAEtB;;;OAGG;IACH,cAAc,CAAC,WAAmB;QAMhC,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAClC,iDAAiD,CAClD,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACpC,gDAAgD,CACjD,CAAC;QACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACzC,yDAAyD,CAC1D,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACpC,2CAA2C,CAC5C,CAAC;QAEF,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjE,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEvD,OAAO;YACL,aAAa,EAAE,YAAY,CAAC,OAAO;YACnC,eAAe,EAAE,cAAc,CAAC,OAAO;YACvC,oBAAoB,EAAE,mBAAmB,CAAC,OAAO;YACjD,eAAe,EAAE,cAAc,CAAC,OAAO;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAmED,gCAAgC;AAEhC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,UAAU,CAAC,CAAC,CAAC;AAC1F,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnE,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAA6B,CAAC;IACzE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAiC,CAAC;IACjF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,GAAa;IAC/B,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY,EAAE,GAAG,CAAC,cAAc;QAChC,WAAW,EAAE,GAAG,CAAC,aAAa;QAC9B,MAAM,EAAE;YACN,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;YAC7C,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,gBAAgB,CAAC;SAC1D;QACD,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,UAAU,EAAE,GAAG,CAAC,WAAW;QAC3B,YAAY,EAAE,GAAG,CAAC,aAAa,KAAK,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAe;IACnC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY,EAAE,GAAG,CAAC,cAAc;QAChC,WAAW,EAAE,GAAG,CAAC,aAAa;QAC9B,MAAM,EAAE;YACN,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;YAC7C,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,gBAAgB,CAAC;SAC1D;QACD,+BAA+B,EAAE,GAAG,CAAC,oCAAoC;QACzE,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAoB;IAC7C,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,cAAc,EAAE,GAAG,CAAC,eAAe,KAAK,CAAC;QACzC,kBAAkB,EAAE;YAClB,WAAW,EAAE,GAAG,CAAC,kBAAkB;YACnC,YAAY,EAAE,GAAG,CAAC,mBAAmB;YACrC,WAAW,EAAE,GAAG,CAAC,kBAAkB;YACnC,MAAM,EAAE,gBAAgB;YACxB,UAAU,EAAE,MAAM;SACnB;QACD,mBAAmB,EAAE;YACnB,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,GAAG,CAAC,mBAAmB;YACpC,MAAM,EAAE,gBAAgB;YACxB,UAAU,EAAE,MAAM;SACnB;QACD,eAAe,EAAE,GAAG,CAAC,gBAAgB;QACrC,oBAAoB,EAAE,GAAG,CAAC,qBAAqB;QAC/C,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,CAAC;QAC5B,UAAU,EAAE,GAAG,CAAC,WAAW;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAe;IACnC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,YAAY,EAAE,GAAG,CAAC,cAAc;QAChC,WAAW,EAAE,GAAG,CAAC,aAAa;QAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,cAAc,EAAE,GAAG,CAAC,gBAAgB;QACpC,YAAY,EAAE,GAAG,CAAC,cAAc;QAChC,YAAY,EAAE,GAAG,CAAC,aAAa;QAC/B,gBAAgB,EAAE,GAAG,CAAC,iBAAiB;KACxC,CAAC;AACJ,CAAC"}

package/dist/metering/token-counter.d.ts

@@ -0,0 +1,50 @@
+import type { ProviderType, TokenCount } from '../types/metering.js';
+/**
+ * Provider-specific bytes-to-token ratios.
+ *
+ * These are empirical averages. The actual ratio depends on the
+ * tokenizer and content, but for billing estimates they are
+ * sufficiently accurate (typically within 10-15%).
+ *
+ * Rationale:
+ * - English text averages ~4 bytes per token across most tokenizers
+ * - JSON overhead (keys, brackets, quotes) increases the ratio
+ * - Request bodies include system prompts, tool definitions, etc.
+ * - Response bodies include JSON wrapping around the actual content
+ */
+export declare const BYTES_PER_TOKEN: Record<string, number>;
+/**
+ * Minimum token estimate when Content-Length is missing or zero.
+ * LLM API requests always have some tokens (at least a system prompt).
+ */
+export declare const MIN_REQUEST_TOKENS = 100;
+export declare const MIN_RESPONSE_TOKENS = 10;
+/**
+ * Estimate token count from HTTP Content-Length header value.
+ *
+ * @param contentLength - Value of Content-Length header (bytes), or null if absent
+ * @param provider - Provider type for selecting bytes-per-token ratio
+ * @param direction - Whether this is a request (input) or response (output)
+ * @returns Estimated token count
+ */
+export declare function estimateTokensFromContentLength(contentLength: number | null, provider: ProviderType, direction: 'request' | 'response'): number;
+/**
+ * Estimate token count from accumulated SSE stream chunk sizes.
+ * Used when Content-Length is not available (streaming responses).
+ *
+ * @param totalBytes - Total bytes received across all SSE chunks
+ * @param provider - Provider type
+ * @returns Estimated token count
+ */
+export declare function estimateTokensFromStreamBytes(totalBytes: number, provider: ProviderType): number;
+/**
+ * Build a complete TokenCount from request and response metadata.
+ *
+ * @param requestContentLength - Request Content-Length header value (bytes), or null
+ * @param responseContentLength - Response Content-Length header value (bytes), or null
+ * @param provider - Provider type
+ * @param isStreaming - Whether the response was an SSE stream
+ * @param streamTotalBytes - Total bytes from stream chunks (only if isStreaming)
+ */
+export declare function estimateTokens(requestContentLength: number | null, responseContentLength: number | null, provider: ProviderType, isStreaming: boolean, streamTotalBytes?: number): TokenCount;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/metering/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/metering/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMlD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,SAAS,GAAG,UAAU,GAChC,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,GACrB,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI,EACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,OAAO,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,UAAU,CAoCZ"}

package/dist/metering/token-counter.js

@@ -0,0 +1,96 @@
+/**
+ * Provider-specific bytes-to-token ratios.
+ *
+ * These are empirical averages. The actual ratio depends on the
+ * tokenizer and content, but for billing estimates they are
+ * sufficiently accurate (typically within 10-15%).
+ *
+ * Rationale:
+ * - English text averages ~4 bytes per token across most tokenizers
+ * - JSON overhead (keys, brackets, quotes) increases the ratio
+ * - Request bodies include system prompts, tool definitions, etc.
+ * - Response bodies include JSON wrapping around the actual content
+ */
+export const BYTES_PER_TOKEN = {
+    anthropic: 4.2, // Claude tokenizer, JSON Messages API
+    openai: 4.0, // tiktoken cl100k_base, JSON Chat API
+    google: 4.1, // Gemini tokenizer, JSON generateContent API
+    moonshot: 4.0, // Similar to OpenAI tokenizer
+    default: 4.0, // Fallback for unknown providers
+};
+/**
+ * Minimum token estimate when Content-Length is missing or zero.
+ * LLM API requests always have some tokens (at least a system prompt).
+ */
+export const MIN_REQUEST_TOKENS = 100;
+export const MIN_RESPONSE_TOKENS = 10;
+/**
+ * Estimate token count from HTTP Content-Length header value.
+ *
+ * @param contentLength - Value of Content-Length header (bytes), or null if absent
+ * @param provider - Provider type for selecting bytes-per-token ratio
+ * @param direction - Whether this is a request (input) or response (output)
+ * @returns Estimated token count
+ */
+export function estimateTokensFromContentLength(contentLength, provider, direction) {
+    if (contentLength === null || contentLength === 0) {
+        return direction === 'request' ? MIN_REQUEST_TOKENS : MIN_RESPONSE_TOKENS;
+    }
+    const ratio = BYTES_PER_TOKEN[provider] ?? BYTES_PER_TOKEN['default'];
+    return Math.max(Math.ceil(contentLength / ratio), direction === 'request' ? MIN_REQUEST_TOKENS : MIN_RESPONSE_TOKENS);
+}
+/**
+ * Estimate token count from accumulated SSE stream chunk sizes.
+ * Used when Content-Length is not available (streaming responses).
+ *
+ * @param totalBytes - Total bytes received across all SSE chunks
+ * @param provider - Provider type
+ * @returns Estimated token count
+ */
+export function estimateTokensFromStreamBytes(totalBytes, provider) {
+    if (totalBytes === 0)
+        return MIN_RESPONSE_TOKENS;
+    const ratio = BYTES_PER_TOKEN[provider] ?? BYTES_PER_TOKEN['default'];
+    // SSE streams have additional overhead: "data: " prefix, newlines, event framing
+    // Approximately 15-20% of stream bytes are SSE overhead, not content
+    const contentBytes = totalBytes * 0.82;
+    return Math.max(Math.ceil(contentBytes / ratio), MIN_RESPONSE_TOKENS);
+}
+/**
+ * Build a complete TokenCount from request and response metadata.
+ *
+ * @param requestContentLength - Request Content-Length header value (bytes), or null
+ * @param responseContentLength - Response Content-Length header value (bytes), or null
+ * @param provider - Provider type
+ * @param isStreaming - Whether the response was an SSE stream
+ * @param streamTotalBytes - Total bytes from stream chunks (only if isStreaming)
+ */
+export function estimateTokens(requestContentLength, responseContentLength, provider, isStreaming, streamTotalBytes) {
+    const inputTokens = estimateTokensFromContentLength(requestContentLength, provider, 'request');
+    let outputTokens;
+    let method;
+    let confidence;
+    if (isStreaming && streamTotalBytes !== undefined) {
+        outputTokens = estimateTokensFromStreamBytes(streamTotalBytes, provider);
+        method = 'chunk-accumulation';
+        confidence = 'medium';
+    }
+    else if (responseContentLength !== null && responseContentLength > 0) {
+        outputTokens = estimateTokensFromContentLength(responseContentLength, provider, 'response');
+        method = 'content-length';
+        confidence = 'high';
+    }
+    else {
+        outputTokens = MIN_RESPONSE_TOKENS;
+        method = 'fallback';
+        confidence = 'low';
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+        method,
+        confidence,
+    };
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/metering/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../src/metering/token-counter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,SAAS,EAAE,GAAG,EAAI,sCAAsC;IACxD,MAAM,EAAE,GAAG,EAAO,sCAAsC;IACxD,MAAM,EAAE,GAAG,EAAO,6CAA6C;IAC/D,QAAQ,EAAE,GAAG,EAAK,8BAA8B;IAChD,OAAO,EAAE,GAAG,EAAM,iCAAiC;CACpD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAA4B,EAC5B,QAAsB,EACtB,SAAiC;IAEjC,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC5E,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,SAAS,CAAE,CAAC;IACvE,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,EAChC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CACnE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAAkB,EAClB,QAAsB;IAEtB,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAEjD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAC,SAAS,CAAE,CAAC;IACvE,iFAAiF;IACjF,qEAAqE;IACrE,MAAM,YAAY,GAAG,UAAU,GAAG,IAAI,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,oBAAmC,EACnC,qBAAoC,EACpC,QAAsB,EACtB,WAAoB,EACpB,gBAAyB;IAEzB,MAAM,WAAW,GAAG,+BAA+B,CACjD,oBAAoB,EACpB,QAAQ,EACR,SAAS,CACV,CAAC;IAEF,IAAI,YAAoB,CAAC;IACzB,IAAI,MAA4B,CAAC;IACjC,IAAI,UAAoC,CAAC;IAEzC,IAAI,WAAW,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAClD,YAAY,GAAG,6BAA6B,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QACzE,MAAM,GAAG,oBAAoB,CAAC;QAC9B,UAAU,GAAG,QAAQ,CAAC;IACxB,CAAC;SAAM,IAAI,qBAAqB,KAAK,IAAI,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;QACvE,YAAY,GAAG,+BAA+B,CAC5C,qBAAqB,EACrB,QAAQ,EACR,UAAU,CACX,CAAC;QACF,MAAM,GAAG,gBAAgB,CAAC;QAC1B,UAAU,GAAG,MAAM,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,mBAAmB,CAAC;QACnC,MAAM,GAAG,UAAU,CAAC;QACpB,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,WAAW,GAAG,YAAY;QACvC,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/metering/usage-aggregator.d.ts

@@ -0,0 +1,46 @@
+import type { UsageAggregate, SessionMetrics } from '../types/metering.js';
+export type AggregationGranularity = 'daily' | 'weekly' | 'monthly';
+/**
+ * Time period boundaries for aggregation.
+ */
+export interface TimePeriod {
+    start: number;
+    end: number;
+}
+/**
+ * Aggregates session metrics into time-period summaries.
+ */
+export declare class UsageAggregator {
+    /**
+     * Aggregate a list of session metrics into time-period buckets.
+     *
+     * @param sessions - Session metrics to aggregate
+     * @param granularity - Time period granularity
+     * @param topPeerCount - Number of top peers to include (default: 5)
+     * @returns Array of UsageAggregate, one per period that has data
+     */
+    aggregate(sessions: SessionMetrics[], granularity: AggregationGranularity, topPeerCount?: number): UsageAggregate[];
+    /**
+     * Get the time period that a timestamp falls into.
+     */
+    getPeriod(timestamp: number, granularity: AggregationGranularity): TimePeriod;
+    /**
+     * Get aggregates for a specific date range.
+     *
+     * @param sessions - All available session metrics
+     * @param startDate - Start of range (ms since epoch)
+     * @param endDate - End of range (ms since epoch)
+     * @param granularity - Bucket granularity
+     * @param topPeerCount - Number of top peers to include (default: 5)
+     */
+    aggregateRange(sessions: SessionMetrics[], startDate: number, endDate: number, granularity: AggregationGranularity, topPeerCount?: number): UsageAggregate[];
+    /**
+     * Get a single aggregate for all-time usage.
+     */
+    aggregateAll(sessions: SessionMetrics[]): UsageAggregate;
+    /**
+     * Build a single UsageAggregate from a list of sessions.
+     */
+    private buildAggregate;
+}
+//# sourceMappingURL=usage-aggregator.d.ts.map

package/dist/metering/usage-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-aggregator.d.ts","sourceRoot":"","sources":["../../src/metering/usage-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AAEzF,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;;OAOG;IACH,SAAS,CACP,QAAQ,EAAE,cAAc,EAAE,EAC1B,WAAW,EAAE,sBAAsB,EACnC,YAAY,GAAE,MAAU,GACvB,cAAc,EAAE;IA+BnB;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,GAAG,UAAU;IA+C7E;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,cAAc,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,sBAAsB,EACnC,YAAY,GAAE,MAAU,GACvB,cAAc,EAAE;IAOnB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,cAAc;IAgCxD;;OAEG;IACH,OAAO,CAAC,cAAc;CAkEvB"}