@cendor/tokenguard 0.2.0

package/dist/sinks.d.ts

@@ -0,0 +1,82 @@
+import type { Sink } from '@cendor/core';
+/** A spend row as delivered to a sink's `write`. */
+export interface SpendEntry {
+    tags: Record<string, unknown>;
+    usd: string;
+    input_tokens: number;
+    output_tokens: number;
+    reasoning_tokens?: number;
+    model: string;
+}
+/** A row read back from {@link SQLiteSink.rows}: `[tags, usd, input, output, reasoning, model]`. */
+export type SQLiteRow = [string, string, number, number, number, string];
+/**
+ * Persist each spend row to a local SQLite database via `better-sqlite3` (synchronous; no network).
+ * `better-sqlite3` is a synchronous binding, so — unlike the Python `sqlite3` original — no
+ * cross-thread lock is needed (JS is single-threaded). `usd` is stored as TEXT (the Decimal string);
+ * `tags` as JSON with sorted keys.
+ */
+export declare class SQLiteSink {
+    private readonly db;
+    constructor(path: string);
+    write(entry: SpendEntry): void;
+    /** All rows: `[tags_json, usd, input_tokens, output_tokens, reasoning_tokens, model]`. */
+    rows(): SQLiteRow[];
+    close(): void;
+}
+/** Options for {@link QueueSink}. */
+export interface QueueSinkOptions {
+    /** Bound the in-flight queue; when full, `write()` awaits room (back-pressure — never drops a
+     * row). `null`/omitted is unbounded. */
+    maxQueue?: number | null;
+}
+/**
+ * Wrap any `Sink` so its writes drain off the hot path. The bus fans out to subscribers inline, so a
+ * durable sink otherwise adds its I/O latency to every model call. `QueueSink` decouples that:
+ * `write()` enqueues and returns immediately (a single async drain loop writes into the inner sink
+ * in FIFO order), and `flush()` / `close()` guarantee durability at shutdown.
+ *
+ * Node is single-threaded, so — unlike the Python daemon-thread original — this is an in-memory FIFO
+ * plus an async drain loop. Observable semantics are preserved: FIFO order, no dropped rows under
+ * bounded back-pressure (`write` returns a Promise when it must await room), `write`-after-`close`
+ * throws, idempotent `close`, inner `flush`→`close` ordering at close, and a bad inner-write does
+ * not kill the drainer.
+ */
+export declare class QueueSink {
+    private readonly inner;
+    private readonly maxQueue;
+    private readonly items;
+    private closed;
+    private shutdownRequested;
+    private idle;
+    private wakeup;
+    private readonly roomWaiters;
+    private idleWaiters;
+    private readonly worker;
+    constructor(inner: Sink, opts?: QueueSinkOptions);
+    private wake;
+    private resolveIdle;
+    private run;
+    /** Enqueue a record for the drain loop. Returns synchronously unless a bounded queue is full, in
+     * which case it returns a Promise that resolves once room frees (back-pressure). */
+    write(entry: unknown): void | Promise<void>;
+    /** Block until every queued record is written and the inner sink is flushed. */
+    flush(): Promise<void>;
+    /** Drain the queue, stop the drain loop, and flush + close the inner sink (idempotent). */
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Emit OpenTelemetry counters per spend row if `@opentelemetry/api` is installed, else a no-op.
+ * Loading is attempted synchronously via `createRequire` to mirror Python's synchronous
+ * `from opentelemetry import metrics`; when the package is absent, `write` is a no-op. The three
+ * metric names are byte-identical to the Python original.
+ */
+export declare class OTelSink {
+    private tokensCounter;
+    private costCounter;
+    private reasoningCounter;
+    constructor();
+    write(entry: SpendEntry): void;
+}
+//# sourceMappingURL=sinks.d.ts.map

package/dist/sinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.d.ts","sourceRoot":"","sources":["../src/sinks.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAKzC,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AASD,oGAAoG;AACpG,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAWzE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;gBAE1B,IAAI,EAAE,MAAM;IASxB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAiB9B,0FAA0F;IAC1F,IAAI,IAAI,SAAS,EAAE;IAiBnB,KAAK,IAAI,IAAI;CAGd;AAaD,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B;4CACwC;IACxC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,KAAK,EAAE,IAAI,EAAE,IAAI,GAAE,gBAAqB;IAMpD,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,WAAW;YAML,GAAG;IAuBjB;wFACoF;IACpF,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3C,gFAAgF;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,2FAA2F;IACrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C;AAID;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,aAAa,CACd;IACP,OAAO,CAAC,WAAW,CACZ;IACP,OAAO,CAAC,gBAAgB,CAER;;IAehB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAc/B"}

package/dist/sinks.js

@@ -0,0 +1,219 @@
+/**
+ * Pluggable spend sinks for tokenguard (the `@cendor/tokenguard/sinks` subpath). A sink satisfies
+ * `@cendor/core`'s `Sink` protocol (`write(entry)`; optional `flush()` / `close()`). tokenguard's
+ * default is in-memory (`report()` aggregation); attach one of these to also persist each spend row.
+ *
+ * Each `write` receives `{ tags, usd, input_tokens, output_tokens, reasoning_tokens, model }` —
+ * `usd` is the Decimal as a string (never a float), and `reasoning_tokens` is a subset of
+ * `output_tokens`.
+ */
+import { createRequire } from 'node:module';
+import Database from 'better-sqlite3';
+/** `JSON.stringify` with top-level keys sorted (parity with Python's `json.dumps(sort_keys=True)`). */
+function stableJson(obj) {
+    const sorted = {};
+    for (const key of Object.keys(obj).sort())
+        sorted[key] = obj[key];
+    return JSON.stringify(sorted);
+}
+/**
+ * Persist each spend row to a local SQLite database via `better-sqlite3` (synchronous; no network).
+ * `better-sqlite3` is a synchronous binding, so — unlike the Python `sqlite3` original — no
+ * cross-thread lock is needed (JS is single-threaded). `usd` is stored as TEXT (the Decimal string);
+ * `tags` as JSON with sorted keys.
+ */
+export class SQLiteSink {
+    db;
+    constructor(path) {
+        this.db = new Database(path);
+        this.db.exec('CREATE TABLE IF NOT EXISTS spend (' +
+            'tags TEXT, usd TEXT, input_tokens INTEGER, output_tokens INTEGER, ' +
+            'reasoning_tokens INTEGER, model TEXT)');
+    }
+    write(entry) {
+        this.db
+            .prepare('INSERT INTO spend ' +
+            '(tags, usd, input_tokens, output_tokens, reasoning_tokens, model) ' +
+            'VALUES (?, ?, ?, ?, ?, ?)')
+            .run(stableJson(entry.tags ?? {}), String(entry.usd), Number(entry.input_tokens), Number(entry.output_tokens), Number(entry.reasoning_tokens ?? 0), String(entry.model));
+    }
+    /** All rows: `[tags_json, usd, input_tokens, output_tokens, reasoning_tokens, model]`. */
+    rows() {
+        const raw = this.db
+            .prepare('SELECT tags, usd, input_tokens, output_tokens, reasoning_tokens, model ' +
+            'FROM spend ORDER BY rowid')
+            .all();
+        return raw.map((r) => [
+            r.tags,
+            r.usd,
+            r.input_tokens,
+            r.output_tokens,
+            r.reasoning_tokens,
+            r.model,
+        ]);
+    }
+    close() {
+        this.db.close();
+    }
+}
+// --------------------------------------------------------------------------- QueueSink
+/** Sentinel enqueued by {@link QueueSink.close} to tell the drain loop to stop. */
+const SHUTDOWN = Symbol('cendor.tokenguard.queuesink.shutdown');
+function optionalMethod(obj, name) {
+    if (obj == null || typeof obj !== 'object')
+        return null;
+    const fn = obj[name];
+    return typeof fn === 'function' ? fn.bind(obj) : null;
+}
+/**
+ * Wrap any `Sink` so its writes drain off the hot path. The bus fans out to subscribers inline, so a
+ * durable sink otherwise adds its I/O latency to every model call. `QueueSink` decouples that:
+ * `write()` enqueues and returns immediately (a single async drain loop writes into the inner sink
+ * in FIFO order), and `flush()` / `close()` guarantee durability at shutdown.
+ *
+ * Node is single-threaded, so — unlike the Python daemon-thread original — this is an in-memory FIFO
+ * plus an async drain loop. Observable semantics are preserved: FIFO order, no dropped rows under
+ * bounded back-pressure (`write` returns a Promise when it must await room), `write`-after-`close`
+ * throws, idempotent `close`, inner `flush`→`close` ordering at close, and a bad inner-write does
+ * not kill the drainer.
+ */
+export class QueueSink {
+    inner;
+    maxQueue;
+    items = [];
+    closed = false;
+    shutdownRequested = false;
+    idle = false;
+    wakeup = null;
+    roomWaiters = [];
+    idleWaiters = [];
+    worker;
+    constructor(inner, opts = {}) {
+        this.inner = inner;
+        this.maxQueue = opts.maxQueue && opts.maxQueue > 0 ? opts.maxQueue : null;
+        this.worker = this.run();
+    }
+    wake() {
+        if (this.wakeup) {
+            const w = this.wakeup;
+            this.wakeup = null;
+            w();
+        }
+    }
+    resolveIdle() {
+        const waiters = this.idleWaiters;
+        this.idleWaiters = [];
+        for (const w of waiters)
+            w();
+    }
+    async run() {
+        for (;;) {
+            while (this.items.length === 0) {
+                this.idle = true;
+                this.resolveIdle();
+                if (this.shutdownRequested)
+                    return;
+                await new Promise((resolve) => {
+                    this.wakeup = resolve;
+                });
+                this.idle = false;
+            }
+            const item = this.items.shift();
+            const rw = this.roomWaiters.shift(); // a slot freed → release one back-pressure waiter
+            if (rw)
+                rw();
+            if (item === SHUTDOWN)
+                return;
+            try {
+                await Promise.resolve(this.inner.write(item));
+            }
+            catch {
+                // a bad row must not kill the worker — drop it and carry on
+            }
+        }
+    }
+    /** Enqueue a record for the drain loop. Returns synchronously unless a bounded queue is full, in
+     * which case it returns a Promise that resolves once room frees (back-pressure). */
+    write(entry) {
+        if (this.closed)
+            throw new Error('QueueSink.write() after close()');
+        if (this.maxQueue !== null && this.items.length >= this.maxQueue) {
+            return new Promise((resolve) => {
+                this.roomWaiters.push(() => {
+                    this.items.push(entry);
+                    this.wake();
+                    resolve();
+                });
+            });
+        }
+        this.items.push(entry);
+        this.wake();
+    }
+    /** Block until every queued record is written and the inner sink is flushed. */
+    async flush() {
+        if (!(this.items.length === 0 && this.idle)) {
+            await new Promise((resolve) => {
+                this.idleWaiters.push(resolve);
+            });
+        }
+        const innerFlush = optionalMethod(this.inner, 'flush');
+        if (innerFlush)
+            await innerFlush();
+    }
+    /** Drain the queue, stop the drain loop, and flush + close the inner sink (idempotent). */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.shutdownRequested = true;
+        this.items.push(SHUTDOWN); // after all enqueued rows (FIFO) — the loop drains them, then exits
+        this.wake();
+        await this.worker;
+        for (const name of ['flush', 'close']) {
+            const fn = optionalMethod(this.inner, name);
+            if (fn)
+                await fn();
+        }
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+}
+// --------------------------------------------------------------------------- OTelSink
+/**
+ * Emit OpenTelemetry counters per spend row if `@opentelemetry/api` is installed, else a no-op.
+ * Loading is attempted synchronously via `createRequire` to mirror Python's synchronous
+ * `from opentelemetry import metrics`; when the package is absent, `write` is a no-op. The three
+ * metric names are byte-identical to the Python original.
+ */
+export class OTelSink {
+    tokensCounter = null;
+    costCounter = null;
+    reasoningCounter = null;
+    constructor() {
+        try {
+            const req = createRequire(import.meta.url);
+            const otel = req('@opentelemetry/api');
+            const meter = otel.metrics.getMeter('cendor.tokenguard');
+            this.tokensCounter = meter.createCounter('gen_ai.client.token.usage');
+            this.costCounter = meter.createCounter('gen_ai.client.cost.usd');
+            this.reasoningCounter = meter.createCounter('gen_ai.client.reasoning.token.usage');
+        }
+        catch {
+            // OpenTelemetry not installed — stay in no-op mode
+        }
+    }
+    write(entry) {
+        if (this.tokensCounter === null ||
+            this.costCounter === null ||
+            this.reasoningCounter === null) {
+            return; // OTel not installed — silently skip
+        }
+        const attrs = { model: entry.model ?? '' };
+        // reasoning is a subset of output — reported as its own counter, not added into the total.
+        this.tokensCounter.add(Number(entry.input_tokens) + Number(entry.output_tokens), attrs);
+        this.reasoningCounter.add(Number(entry.reasoning_tokens ?? 0), attrs);
+        this.costCounter.add(Number(entry.usd), attrs);
+    }
+}
+//# sourceMappingURL=sinks.js.map

package/dist/sinks.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@cendor/tokenguard",
+  "version": "0.2.0",
+  "description": "Pre-flight cost caps + per-tag spend attribution for LLM calls. The TypeScript port of cendor.tokenguard.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./sinks": {
+      "types": "./dist/sinks.d.ts",
+      "default": "./dist/sinks.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@cendor/core": "^0.2.0"
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "^12.11.1"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "llm",
+    "budget",
+    "cost",
+    "governance",
+    "cendor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cendorhq/cendor-libs-js.git",
+    "directory": "packages/tokenguard"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}