estela 0.1.0

package/dist/pricing/cost.test.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const cost_js_1 = require("./cost.js");
+const catalog_js_1 = require("./catalog.js");
+const AT = new Date("2026-08-21T12:27:42.626Z");
+/**
+ * Caso dorado, medido sobre un transcript real de Claude Code (445 líneas,
+ * 186 filas `assistant`, 65 turnos únicos). Estos totales son los deduplicados.
+ *
+ * Si este test se cae, o cambió el catálogo de precios o cambió el parser: en
+ * ambos casos hay que revisarlo antes de emitir una factura.
+ */
+const GOLDEN = {
+    input: 130,
+    output: 59_962,
+    cacheRead: 5_713_309,
+    cacheWrite5m: 0,
+    cacheWrite1h: 366_030,
+};
+(0, node_test_1.test)("coste dorado de una sesión real de Opus 5", () => {
+    const cost = (0, cost_js_1.costOfTurn)(GOLDEN, "claude-opus-5", AT);
+    strict_1.default.ok(cost);
+    // input 130 * $5/1M                  = $0.0006500
+    // output 59.962 * $25/1M             = $1.4990500
+    // cacheRead 5.713.309 * $5/1M * 0.1  = $2.8566545
+    // cacheWrite1h 366.030 * $5/1M * 2   = $3.6603000
+    //                                    = $8.0166545
+    strict_1.default.equal(cost.microUsd, 8_016_655);
+    strict_1.default.equal((cost.microUsd / 1e6).toFixed(2), "8.02");
+});
+(0, node_test_1.test)("ignorar la caché infravalora el coste más de 5x", () => {
+    const real = (0, cost_js_1.costOfTurn)(GOLDEN, "claude-opus-5", AT);
+    const naive = (0, cost_js_1.costOfTurn)({ ...GOLDEN, cacheRead: 0, cacheWrite5m: 0, cacheWrite1h: 0 }, "claude-opus-5", AT);
+    strict_1.default.equal((naive.microUsd / 1e6).toFixed(2), "1.50");
+    strict_1.default.ok(real.microUsd / naive.microUsd > 5, `esperado >5x, obtenido ${(real.microUsd / naive.microUsd).toFixed(1)}x`);
+});
+(0, node_test_1.test)("la caché es la mayor parte del gasto", () => {
+    const b = (0, cost_js_1.breakdownOfTurn)(GOLDEN, "claude-opus-5", AT);
+    strict_1.default.ok(b);
+    strict_1.default.ok(b.cacheShare > 0.8, `esperado >80%, obtenido ${(b.cacheShare * 100).toFixed(1)}%`);
+    strict_1.default.equal(b.total.microUsd, b.input.microUsd + b.output.microUsd + b.cacheRead.microUsd + b.cacheWrite.microUsd);
+});
+(0, node_test_1.test)("escribir caché a 1h cuesta el doble que a 5m", () => {
+    const base = { input: 0, output: 0, cacheRead: 0 };
+    const w5m = (0, cost_js_1.costOfTurn)({ ...base, cacheWrite5m: 1_000_000, cacheWrite1h: 0 }, "claude-opus-5", AT);
+    const w1h = (0, cost_js_1.costOfTurn)({ ...base, cacheWrite5m: 0, cacheWrite1h: 1_000_000 }, "claude-opus-5", AT);
+    strict_1.default.equal(w5m.microUsd, 6_250_000); // $5 * 1.25
+    strict_1.default.equal(w1h.microUsd, 10_000_000); // $5 * 2
+    strict_1.default.equal(w1h.microUsd, w5m.microUsd * 1.6);
+});
+(0, node_test_1.test)("un modelo desconocido devuelve null en vez de inventar un precio", () => {
+    strict_1.default.equal((0, cost_js_1.costOfTurn)(GOLDEN, "modelo-que-no-existe", AT), null);
+    strict_1.default.equal((0, catalog_js_1.resolvePrice)("modelo-que-no-existe", AT), null);
+});
+(0, node_test_1.test)("gana el prefijo más específico", () => {
+    const opus5 = (0, catalog_js_1.resolvePrice)("claude-opus-5", AT);
+    const sonnet46 = (0, catalog_js_1.resolvePrice)("claude-sonnet-4-6", AT);
+    strict_1.default.equal(opus5?.modelPrefix, "claude-opus-5");
+    strict_1.default.equal(opus5?.inputPerMTok, 5);
+    strict_1.default.equal(sonnet46?.modelPrefix, "claude-sonnet-4-6");
+    strict_1.default.equal(sonnet46?.inputPerMTok, 3);
+});
+(0, node_test_1.test)("precios distintos por familia de modelo", () => {
+    const usage = { input: 1_000_000, output: 0, cacheRead: 0, cacheWrite5m: 0, cacheWrite1h: 0 };
+    strict_1.default.equal((0, cost_js_1.costOfTurn)(usage, "claude-opus-5", AT).microUsd, 5_000_000);
+    strict_1.default.equal((0, cost_js_1.costOfTurn)(usage, "claude-sonnet-5", AT).microUsd, 2_000_000);
+    strict_1.default.equal((0, cost_js_1.costOfTurn)(usage, "claude-haiku-4-5", AT).microUsd, 1_000_000);
+});
+//# sourceMappingURL=cost.test.js.map

package/dist/pricing/cost.test.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+export interface ServerOptions {
+    readonly port?: number;
+    readonly dbPath?: string;
+    /** Cada cuánto reimportar. 0 lo desactiva. */
+    readonly autoImportMinutes?: number;
+}
+export interface ImportStatus {
+    readonly at: string;
+    readonly ok: boolean;
+    readonly blocks: number;
+    readonly error: string | null;
+}
+export declare function getImportStatus(): ImportStatus | null;
+export declare function startServer(options?: ServerOptions): Promise<string>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAgEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAuED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAcD,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAqCD,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBxE"}