@drm3/sdk 0.1.2

package/dist/meter/resolve.js

@@ -0,0 +1,100 @@
+/**
+ * resolve - the OUTER cascade: a wallet is a cascade of meters.
+ *
+ * The inner `cascade()` draws across the BUCKETS of one meter (daily → monthly →
+ * buyup). This layer draws across the METERS of a wallet: the feature meters
+ * first (most-specific), then the generic credits meter as the terminal fallback.
+ * It is the same floor-and-spill idea one level up, with ONE subtlety the inner
+ * cascade doesn't have - the UNIT SEAM.
+ *
+ *   Feature meters count CALLS. The credits meter counts µCREDITS. So when a
+ *   feature call spills past its own meter (the allowance is exhausted), it does
+ *   not carry "calls" into the credits meter - it converts: each unmet call costs
+ *   `creditPricePerUnit` µcredits, and that credit demand flows into the credits
+ *   cascade. "Use the feature allowance first because it's more specific; only
+ *   what it can't cover costs credits."
+ *
+ * Resolution for one request:
+ *   1. Feature demand + a matching feature meter? Draw the calls from its buckets
+ *      (daily → monthly → buyup), FLOORED (overdraft is terminal-only, so a
+ *      feature buyup floors and spills rather than going negative). The unmet
+ *      calls convert to a credit demand.
+ *   2. Feature demand + NO matching meter? The whole call bills credits directly
+ *      (units × creditPricePerUnit) - features without an allowance just cost
+ *      credits.
+ *   3. Generic credit demand? That µcredit amount IS the credit demand.
+ *   4. Draw the credit demand from the credits meter's buckets (daily → monthly →
+ *      buyup), with the buyup OVERDRAFTING (it is the one terminal node).
+ *
+ * Gating (entitlement, "unlimited") and the always-on cost accounting live ABOVE
+ * this: see `creditCost()` for the cost that is logged on every call regardless of
+ * what (if anything) is debited. This module is pure integer math - no I/O, no
+ * storage, no clock. The DB-backed Wallet composes it.
+ */
+import { cascade } from "./cascade.js";
+const pos = (x) => (x > 0n ? x : 0n);
+/** The credit cost of a demand, independent of any balance or meter - the meter
+ *  reading that is ALWAYS logged (accounting ≠ debiting). For a feature call this
+ *  is `units × price` even when an allowance will cover it for free; for a credit
+ *  demand it is the amount itself. */
+export function creditCost(demand) {
+    if ("feature" in demand)
+        return pos(demand.units ?? 1n) * pos(demand.creditPricePerUnit);
+    return pos(demand.ucredits);
+}
+function tally(byBucket, meterKey, draws) {
+    for (const d of draws) {
+        if (d.amount > 0n)
+            byBucket[`${meterKey}.${d.key}`] = (byBucket[`${meterKey}.${d.key}`] ?? 0n) + d.amount;
+    }
+}
+/**
+ * Draw a demand across the wallet's meters. Pure: input meters are never mutated.
+ *
+ * @param meters ordered meters - feature meters first, the terminal credits meter LAST.
+ * @param demand a feature call or a raw credit charge.
+ * @param opts.terminalOverdraft whether the credits buyup may go negative (default
+ *   true - the production rail buys-back-up). false makes the whole wallet floor
+ *   and report the unmet amount as `shortfall` (useful for a dry-run gate check).
+ */
+export function resolveCharge(meters, demand, opts = {}) {
+    if (meters.length === 0)
+        throw new Error("resolveCharge: need at least the terminal credits meter");
+    const lastIdx = meters.length - 1;
+    const credits = meters[lastIdx];
+    const meterDraws = [];
+    const byBucket = {};
+    let creditsDemand;
+    if ("feature" in demand) {
+        const units = pos(demand.units ?? 1n);
+        // A feature meter only counts if it is not the terminal credits meter itself.
+        const fm = meters.find((m, i) => i !== lastIdx && m.key === demand.feature);
+        if (fm) {
+            // Floor (terminalOverdraft:false): even a feature buyup floors and spills -
+            // overdraft is terminal-only, reserved for the credits buyup.
+            const r = cascade(fm.buckets, units, { terminalOverdraft: false });
+            meterDraws.push({ key: fm.key, unit: fm.unit, draws: r.draws, applied: r.applied, overflow: r.shortfall });
+            tally(byBucket, fm.key, r.draws);
+            creditsDemand = r.shortfall * pos(demand.creditPricePerUnit); // unmet calls → credits
+        }
+        else {
+            // No allowance meter for this feature → the whole call bills credits.
+            creditsDemand = units * pos(demand.creditPricePerUnit);
+        }
+    }
+    else {
+        creditsDemand = pos(demand.ucredits);
+    }
+    const terminalOverdraft = opts.terminalOverdraft ?? true;
+    const cr = cascade(credits.buckets, creditsDemand, { terminalOverdraft });
+    meterDraws.push({ key: credits.key, unit: credits.unit, draws: cr.draws, applied: cr.applied, overflow: cr.shortfall });
+    tally(byBucket, credits.key, cr.draws);
+    return {
+        meters: meterDraws,
+        creditsCharged: cr.applied,
+        overdraft: cr.overdraft,
+        shortfall: cr.shortfall,
+        byBucket,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/meter/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/meter/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAAsC,OAAO,EAAE,MAAM,cAAc,CAAC;AA2D3E,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAErD;;;sCAGsC;AACtC,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,IAAI,SAAS,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACzF,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,KAAK,CAAC,QAAgC,EAAE,QAAgB,EAAE,KAA6B;IAC9F,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE;YAAE,QAAQ,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5G,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAA6B,EAAE,MAAc,EAAE,OAAwC,EAAE;IACrH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAe,CAAC;IAE9C,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,IAAI,aAAqB,CAAC;IAE1B,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACtC,8EAA8E;QAC9E,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5E,IAAI,EAAE,EAAE,CAAC;YACP,4EAA4E;YAC5E,8DAA8D;YAC9D,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YAC3G,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACjC,aAAa,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,wBAAwB;QACxF,CAAC;aAAM,CAAC;YACN,sEAAsE;YACtE,aAAa,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC;IACzD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC1E,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;IACxH,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAEvC,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,cAAc,EAAE,EAAE,CAAC,OAAO;QAC1B,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/meter/sink.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SettlementSink - where net spend goes at settlement time. The ONLY place a
+ * chain can ever appear. Default NullSink = pure off-chain; nothing leaves the
+ * box. A Base/Stellar sink is a later drop-in with the same shape. Settlement is
+ * triggered lazily (low-water-mark / batch threshold / schedule), never per call.
+ */
+import type { App, Credits, Tenant } from "./types.js";
+export interface SettlementBatch {
+    tenant: Tenant;
+    app: App;
+    /** net credits spent in this batch */
+    netDebit: Credits;
+    /** opaque batch reference; settlement is idempotent by this */
+    batchRef: string;
+    /** ids of the captured reservations rolled up */
+    captureIds: string[];
+}
+export interface SettlementSink {
+    settle(batch: SettlementBatch): Promise<void>;
+}
+/** Records batches in memory, sends nothing external. The off-chain default. */
+export declare class NullSink implements SettlementSink {
+    readonly batches: SettlementBatch[];
+    settle(batch: SettlementBatch): Promise<void>;
+}
+//# sourceMappingURL=sink.d.ts.map

package/dist/meter/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/meter/sink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;IACT,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,gFAAgF;AAChF,qBAAa,QAAS,YAAW,cAAc;IAC7C,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,CAAM;IACzC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9C"}

package/dist/meter/sink.js

@@ -0,0 +1,9 @@
+/** Records batches in memory, sends nothing external. The off-chain default. */
+export class NullSink {
+    batches = [];
+    settle(batch) {
+        this.batches.push(batch);
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=sink.js.map

package/dist/meter/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../src/meter/sink.ts"],"names":[],"mappings":"AAuBA,gFAAgF;AAChF,MAAM,OAAO,QAAQ;IACV,OAAO,GAAsB,EAAE,CAAC;IACzC,MAAM,CAAC,KAAsB;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/meter/sql/d1.d.ts

@@ -0,0 +1,32 @@
+import type { SqlDriver } from "./driver.js";
+/**
+ * D1 driver + adapter. Cloudflare D1 speaks SQLite, so it consumes the adapter's
+ * `?` placeholders and `MAX(x, 0)` scalar verbatim. Bind bigints as Numbers -
+ * D1 columns are 64-bit INTEGER and credits stay well within Number's safe range
+ * for any realistic balance; reads come back as Number and `toBig` re-widens them.
+ *
+ * Usage in a Worker:
+ *   const meter = new CreditsClient({ adapter: await d1Adapter(env.DB) });
+ */
+import { SqlStorageAdapter } from "./sql-adapter.js";
+/** The slice of Cloudflare's D1Database we use - declared locally so the package
+ *  carries no @cloudflare/workers-types dependency. */
+export interface D1Like {
+    prepare(sql: string): {
+        bind(...params: unknown[]): {
+            run(): Promise<{
+                meta: {
+                    changes: number;
+                };
+            }>;
+            all<T = unknown>(): Promise<{
+                results: T[];
+            }>;
+        };
+    };
+    exec(sql: string): Promise<unknown>;
+}
+export declare function d1Driver(db: D1Like): SqlDriver;
+/** Build + initialize a meter storage adapter over a Cloudflare D1 binding. */
+export declare function d1Adapter(db: D1Like): Promise<SqlStorageAdapter>;
+//# sourceMappingURL=d1.d.ts.map

package/dist/meter/sql/d1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1.d.ts","sourceRoot":"","sources":["../../../src/meter/sql/d1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;uDACuD;AACvD,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QACpB,IAAI,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;YAC1B,GAAG,IAAI,OAAO,CAAC;gBAAE,IAAI,EAAE;oBAAE,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAC,CAAC;YAC9C,GAAG,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC;gBAAE,OAAO,EAAE,CAAC,EAAE,CAAA;aAAE,CAAC,CAAC;SAC/C,CAAC;KACH,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAID,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAsB9C;AAED,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAItE"}

package/dist/meter/sql/d1.js

@@ -0,0 +1,41 @@
+/**
+ * D1 driver + adapter. Cloudflare D1 speaks SQLite, so it consumes the adapter's
+ * `?` placeholders and `MAX(x, 0)` scalar verbatim. Bind bigints as Numbers -
+ * D1 columns are 64-bit INTEGER and credits stay well within Number's safe range
+ * for any realistic balance; reads come back as Number and `toBig` re-widens them.
+ *
+ * Usage in a Worker:
+ *   const meter = new CreditsClient({ adapter: await d1Adapter(env.DB) });
+ */
+import { SqlStorageAdapter } from "./sql-adapter.js";
+const bindable = (params) => params.map((p) => (typeof p === "bigint" ? Number(p) : p));
+export function d1Driver(db) {
+    return {
+        dialect: "sqlite",
+        async all(sql, params = []) {
+            const { results } = await db
+                .prepare(sql)
+                .bind(...bindable(params))
+                .all();
+            return results;
+        },
+        async run(sql, params = []) {
+            const { meta } = await db
+                .prepare(sql)
+                .bind(...bindable(params))
+                .run();
+            return { rowsAffected: meta.changes };
+        },
+        async exec(sql) {
+            // D1.exec runs a single statement; the DDL is split into single statements.
+            await db.prepare(sql).bind().run();
+        },
+    };
+}
+/** Build + initialize a meter storage adapter over a Cloudflare D1 binding. */
+export async function d1Adapter(db) {
+    const a = new SqlStorageAdapter(d1Driver(db));
+    await a.init();
+    return a;
+}
+//# sourceMappingURL=d1.js.map

package/dist/meter/sql/d1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1.js","sourceRoot":"","sources":["../../../src/meter/sql/d1.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAcrD,MAAM,QAAQ,GAAG,CAAC,MAA0B,EAAa,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,SAA6B,EAAE;YACvD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE;iBACzB,OAAO,CAAC,GAAG,CAAC;iBACZ,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACzB,GAAG,EAAK,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,SAA6B,EAAE;YACpD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE;iBACtB,OAAO,CAAC,GAAG,CAAC;iBACZ,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACzB,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAW;YACpB,4EAA4E;YAC5E,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU;IACxC,MAAM,CAAC,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/meter/sql/driver.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SqlDriver - the thin seam between the dialect-neutral SqlStorageAdapter and a
+ * concrete database (Cloudflare D1, node:sqlite, node-postgres, PGlite, …).
+ *
+ * The adapter writes SQL with `?` positional placeholders and dialect-neutral
+ * scalar-max (`MAX(x, 0)` for SQLite, rewritten to `GREATEST(x, 0)` by the
+ * adapter via `dialect`). A Postgres driver rewrites `?` → `$1, $2, …` and
+ * stringifies bigint params (pg has no native bigint binding). A SQLite driver
+ * passes `?` and bigint through unchanged.
+ *
+ * Drivers expose exactly three verbs. There is no interactive transaction here:
+ * every multi-row invariant in the adapter is enforced by a single conditional
+ * UPDATE whose row count tells us whether we won the race, so the engine's own
+ * row lock is the atomicity boundary - identical on SQLite and Postgres, and
+ * the one thing D1 (no interactive transactions) can also do.
+ */
+export type Dialect = "sqlite" | "postgres";
+export interface SqlDriver {
+    readonly dialect: Dialect;
+    /** Run a SELECT; return all rows as plain objects. */
+    all<T = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<T[]>;
+    /** Run an INSERT/UPDATE/DELETE; return how many rows it changed. */
+    run(sql: string, params?: readonly unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
+    /** Run DDL (no params, may contain a single statement). */
+    exec(sql: string): Promise<void>;
+}
+/** Coerce a DB integer (number | bigint | numeric-string | null) to bigint. */
+export declare function toBig(v: unknown): bigint;
+/** Rewrite `?` placeholders to Postgres `$1, $2, …`. Ignores `?` inside literals
+ *  - the adapter never embeds a literal `?`, so a plain counter is safe here. */
+export declare function toPgPlaceholders(sql: string): string;
+//# sourceMappingURL=driver.d.ts.map

package/dist/meter/sql/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/meter/sql/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACzF,oEAAoE;IACpE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,2DAA2D;IAC3D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,+EAA+E;AAC/E,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAKxC;AAED;iFACiF;AACjF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/meter/sql/driver.js

@@ -0,0 +1,17 @@
+/** Coerce a DB integer (number | bigint | numeric-string | null) to bigint. */
+export function toBig(v) {
+    if (typeof v === "bigint")
+        return v;
+    if (typeof v === "number")
+        return BigInt(Math.trunc(v));
+    if (typeof v === "string" && v.length > 0)
+        return BigInt(v);
+    return 0n;
+}
+/** Rewrite `?` placeholders to Postgres `$1, $2, …`. Ignores `?` inside literals
+ *  - the adapter never embeds a literal `?`, so a plain counter is safe here. */
+export function toPgPlaceholders(sql) {
+    let i = 0;
+    return sql.replace(/\?/g, () => `$${++i}`);
+}
+//# sourceMappingURL=driver.js.map

package/dist/meter/sql/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/meter/sql/driver.ts"],"names":[],"mappings":"AA4BA,+EAA+E;AAC/E,MAAM,UAAU,KAAK,CAAC,CAAU;IAC9B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/meter/sql/postgres.d.ts

@@ -0,0 +1,23 @@
+import { type SqlDriver } from "./driver.js";
+/**
+ * Postgres driver + adapter. Rewrites `?` → `$1, $2, …`, swaps `MAX(x, 0)` for
+ * `GREATEST(x, 0)` (handled in the adapter via dialect), and stringifies bigint
+ * params (node-postgres has no native bigint binding; BIGINT comes back as a
+ * numeric string, which `toBig` parses exactly - no precision loss).
+ *
+ * Works with anything exposing node-postgres's `query(text, values)` shape: a
+ * `pg.Pool`, a `pg.Client`, or PGlite. Usage:
+ *   const meter = new CreditsClient({ adapter: await pgAdapter(pool) });
+ */
+import { SqlStorageAdapter } from "./sql-adapter.js";
+/** The slice of a node-postgres connection we use. PGlite matches this too. */
+export interface PgLike {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: unknown[];
+        rowCount: number | null;
+    }>;
+}
+export declare function pgDriver(pool: PgLike): SqlDriver;
+/** Build + initialize a meter storage adapter over a Postgres connection/pool. */
+export declare function pgAdapter(pool: PgLike): Promise<SqlStorageAdapter>;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/meter/sql/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/meter/sql/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAC;AAC/D;;;;;;;;;GASG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,+EAA+E;AAC/E,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAChG;AAID,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAehD;AAED,kFAAkF;AAClF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAIxE"}

package/dist/meter/sql/postgres.js

@@ -0,0 +1,36 @@
+import { toPgPlaceholders } from "./driver.js";
+/**
+ * Postgres driver + adapter. Rewrites `?` → `$1, $2, …`, swaps `MAX(x, 0)` for
+ * `GREATEST(x, 0)` (handled in the adapter via dialect), and stringifies bigint
+ * params (node-postgres has no native bigint binding; BIGINT comes back as a
+ * numeric string, which `toBig` parses exactly - no precision loss).
+ *
+ * Works with anything exposing node-postgres's `query(text, values)` shape: a
+ * `pg.Pool`, a `pg.Client`, or PGlite. Usage:
+ *   const meter = new CreditsClient({ adapter: await pgAdapter(pool) });
+ */
+import { SqlStorageAdapter } from "./sql-adapter.js";
+const bindable = (params) => params.map((p) => (typeof p === "bigint" ? p.toString() : p));
+export function pgDriver(pool) {
+    return {
+        dialect: "postgres",
+        async all(sql, params = []) {
+            const { rows } = await pool.query(toPgPlaceholders(sql), bindable(params));
+            return rows;
+        },
+        async run(sql, params = []) {
+            const { rowCount } = await pool.query(toPgPlaceholders(sql), bindable(params));
+            return { rowsAffected: rowCount ?? 0 };
+        },
+        async exec(sql) {
+            await pool.query(sql);
+        },
+    };
+}
+/** Build + initialize a meter storage adapter over a Postgres connection/pool. */
+export async function pgAdapter(pool) {
+    const a = new SqlStorageAdapter(pgDriver(pool));
+    await a.init();
+    return a;
+}
+//# sourceMappingURL=postgres.js.map

package/dist/meter/sql/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../../src/meter/sql/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D;;;;;;;;;GASG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,QAAQ,GAAG,CAAC,MAA0B,EAAa,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1H,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,SAA6B,EAAE;YACvD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3E,OAAO,IAAW,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,SAA6B,EAAE;YACpD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/E,OAAO,EAAE,YAAY,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAW;YACpB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/meter/sql/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Portable DDL for the two-table ledger, identical in shape on SQLite/D1 and
+ * Postgres. Only the integer type differs (SQLite INTEGER is already 64-bit;
+ * Postgres wants BIGINT). Credits are whole integers mirroring the on-chain
+ * uint64 - never floats. created_at/expires_at are epoch milliseconds.
+ *
+ *  - credits_ledger(tenant_id, app, balance, held)  - app="" is the GLOBAL bucket.
+ *  - credits_reservation(id, …, capture_idem_key)   - UNIQUE idem key so a retried
+ *    capture can never double-charge.
+ */
+import type { Dialect } from "./driver.js";
+export declare function ddl(dialect: Dialect): string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/meter/sql/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/meter/sql/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CA8B9C"}

package/dist/meter/sql/schema.js

@@ -0,0 +1,32 @@
+export function ddl(dialect) {
+    const INT = dialect === "postgres" ? "BIGINT" : "INTEGER";
+    return [
+        `CREATE TABLE IF NOT EXISTS credits_ledger (
+       tenant_id TEXT NOT NULL,
+       app       TEXT NOT NULL,
+       balance   ${INT} NOT NULL DEFAULT 0,
+       held      ${INT} NOT NULL DEFAULT 0,
+       PRIMARY KEY (tenant_id, app)
+     )`,
+        `CREATE TABLE IF NOT EXISTS credits_reservation (
+       id               TEXT PRIMARY KEY,
+       tenant_id        TEXT NOT NULL,
+       app              TEXT NOT NULL,
+       held             ${INT} NOT NULL,
+       charged          ${INT} NOT NULL DEFAULT 0,
+       state            TEXT NOT NULL,
+       created_at       ${INT} NOT NULL,
+       expires_at       ${INT} NOT NULL,
+       capture_idem_key TEXT
+     )`,
+        // A retried capture can never double-charge: the idem key is globally unique.
+        // Partial index so the many NULLs (captures without a key) don't collide.
+        `CREATE UNIQUE INDEX IF NOT EXISTS ux_resv_idem
+       ON credits_reservation (capture_idem_key)
+       WHERE capture_idem_key IS NOT NULL`,
+        // The reclaim sweep scans held holds past their TTL.
+        `CREATE INDEX IF NOT EXISTS ix_resv_reclaim
+       ON credits_reservation (state, expires_at)`,
+    ];
+}
+//# sourceMappingURL=schema.js.map

package/dist/meter/sql/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/meter/sql/schema.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,GAAG,CAAC,OAAgB;IAClC,MAAM,GAAG,GAAG,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,OAAO;QACL;;;mBAGe,GAAG;mBACH,GAAG;;OAEf;QACH;;;;0BAIsB,GAAG;0BACH,GAAG;;0BAEH,GAAG;0BACH,GAAG;;OAEtB;QACH,8EAA8E;QAC9E,0EAA0E;QAC1E;;0CAEsC;QACtC,qDAAqD;QACrD;kDAC8C;KAC/C,CAAC;AACJ,CAAC"}

package/dist/meter/sql/sql-adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SqlStorageAdapter - a single, dialect-neutral StorageAdapter that runs
+ * identically on SQLite/D1 and Postgres. It is the SQL sibling of the in-memory
+ * reference and passes the very same conformance suite.
+ *
+ * Atomicity without interactive transactions (D1 has none): every state change
+ * is a *conditional* UPDATE whose row count is the verdict. `placeHold` makes the
+ * affordability check and the decrement one write, so parallel holds against one
+ * balance serialize on that row and only as many as the balance covers succeed;
+ * capture/void/expire flip a reservation out of 'held' and the row count says who
+ * won. The SQL itself lives in `statements.ts`.
+ */
+import type { StorageAdapter } from "../adapter.js";
+import { type App, type Balance, type Credits, type Reservation, type Result, type Tenant } from "../types.js";
+import { type SqlDriver } from "./driver.js";
+export declare class SqlStorageAdapter implements StorageAdapter {
+    private readonly d;
+    private readonly q;
+    private readied?;
+    constructor(driver: SqlDriver);
+    /** Create the tables/indexes. Idempotent; safe to call on every cold start. */
+    init(): Promise<void>;
+    private ensureLedger;
+    fund(tenant: Tenant, app: App, amount: Credits): Promise<void>;
+    hold(r: Reservation): Promise<boolean>;
+    capture(id: string, quotedActual: Credits, idemKey?: string): Promise<Result<{
+        charged: Credits;
+    }>>;
+    voidHold(id: string): Promise<Result<Record<never, never>>>;
+    private release;
+    balance(tenant: Tenant, app: App): Promise<Balance>;
+    reclaimExpired(now: number): Promise<number>;
+    getReservation(id: string): Promise<Reservation | undefined>;
+    private getRow;
+}
+//# sourceMappingURL=sql-adapter.d.ts.map

package/dist/meter/sql/sql-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-adapter.d.ts","sourceRoot":"","sources":["../../../src/meter/sql/sql-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAyB,KAAK,MAAM,EAAE,KAAK,MAAM,EAAO,MAAM,aAAa,CAAC;AAC3I,OAAO,EAAE,KAAK,SAAS,EAAS,MAAM,aAAa,CAAC;AAgBpD,qBAAa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAgB;gBAEpB,MAAM,EAAE,SAAS;IAK7B,+EAA+E;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,YAAY;IAId,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAetC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAuBzG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAI7C,OAAO;IASf,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnD,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;YAgBpD,MAAM;CAIrB"}

package/dist/meter/sql/sql-adapter.js

@@ -0,0 +1,124 @@
+import { available, captureAmount } from "../core.js";
+import { err } from "../types.js";
+import { toBig } from "./driver.js";
+import { ddl } from "./schema.js";
+import { buildStatements } from "./statements.js";
+export class SqlStorageAdapter {
+    d;
+    q;
+    readied;
+    constructor(driver) {
+        this.d = driver;
+        this.q = buildStatements(driver.dialect === "postgres" ? "GREATEST" : "MAX");
+    }
+    /** Create the tables/indexes. Idempotent; safe to call on every cold start. */
+    async init() {
+        if (!this.readied) {
+            this.readied = (async () => {
+                for (const stmt of ddl(this.d.dialect))
+                    await this.d.exec(stmt);
+            })();
+        }
+        return this.readied;
+    }
+    ensureLedger(tenant, app) {
+        return this.d.run(this.q.ensureLedger, [tenant, app]);
+    }
+    async fund(tenant, app, amount) {
+        if (amount <= 0n)
+            return;
+        await this.ensureLedger(tenant, app);
+        await this.d.run(this.q.fund, [amount, tenant, app]);
+    }
+    async hold(r) {
+        if (r.held < 0n)
+            return false;
+        await this.ensureLedger(r.tenant, r.app);
+        // Insert the reservation first so a crash before the ledger write leaves an
+        // orphan that reclaimExpired cleans up harmlessly (held floor protects it),
+        // never a phantom hold no one can see.
+        await this.d.run(this.q.insertReservation, [r.id, r.tenant, r.app, r.held, r.createdAt, r.expiresAt]);
+        const placed = await this.d.run(this.q.placeHold, [r.held, r.tenant, r.app, r.held]);
+        if (placed.rowsAffected === 1)
+            return true;
+        // Insufficient funds: drop the speculative reservation (its id is private
+        // until we return true, so nothing else can have referenced it).
+        await this.d.run(this.q.dropReservation, [r.id]);
+        return false;
+    }
+    async capture(id, quotedActual, idemKey) {
+        const row = await this.getRow(id);
+        if (!row)
+            return err("RESERVATION_NOT_FOUND", `no reservation ${id}`);
+        // Idempotent replay: a retried capture (same key) returns the original charge.
+        if (idemKey) {
+            const prior = await this.d.all(this.q.selectByIdem, [idemKey]);
+            if (prior.length)
+                return { ok: true, charged: toBig(prior[0]?.charged) };
+        }
+        if (row.state !== "held")
+            return err("ALREADY_FINALIZED", `reservation ${id} is ${row.state}`);
+        const charged = captureAmount(toBig(row.held), quotedActual);
+        const won = await this.d.run(this.q.captureReservation, [charged, idemKey ?? null, id]);
+        if (won.rowsAffected !== 1) {
+            // Lost the race to a concurrent capture/void. Resolve as replay or final.
+            const now = await this.getRow(id);
+            if (idemKey && now?.capture_idem_key === idemKey)
+                return { ok: true, charged: toBig(now.charged) };
+            return err("ALREADY_FINALIZED", `reservation ${id} is ${now?.state ?? "gone"}`);
+        }
+        await this.d.run(this.q.applyLedgerCapture, [charged, toBig(row.held), row.tenant_id, row.app]);
+        return { ok: true, charged };
+    }
+    voidHold(id) {
+        return this.release(id, "voided");
+    }
+    async release(id, to) {
+        const row = await this.getRow(id);
+        if (!row)
+            return err("RESERVATION_NOT_FOUND", `no reservation ${id}`);
+        const won = await this.d.run(this.q.releaseReservation, [to, id]);
+        if (won.rowsAffected !== 1)
+            return err("ALREADY_FINALIZED", `reservation ${id} is not held`);
+        await this.d.run(this.q.releaseLedgerHold, [toBig(row.held), row.tenant_id, row.app]);
+        return { ok: true };
+    }
+    async balance(tenant, app) {
+        const rows = await this.d.all(this.q.selectBalance, [tenant, app]);
+        if (!rows.length)
+            return { balance: 0n, held: 0n, available: 0n };
+        const balance = toBig(rows[0]?.balance);
+        const held = toBig(rows[0]?.held);
+        return { balance, held, available: available(balance, held) };
+    }
+    async reclaimExpired(now) {
+        const stale = await this.d.all(this.q.selectExpired, [now]);
+        let n = 0;
+        for (const { id } of stale) {
+            if ((await this.release(id, "expired")).ok)
+                n++;
+        }
+        return n;
+    }
+    async getReservation(id) {
+        const row = await this.getRow(id);
+        if (!row)
+            return undefined;
+        return {
+            id: row.id,
+            tenant: row.tenant_id,
+            app: row.app,
+            held: toBig(row.held),
+            charged: toBig(row.charged),
+            state: row.state,
+            createdAt: Number(toBig(row.created_at)),
+            expiresAt: Number(toBig(row.expires_at)),
+            ...(row.capture_idem_key != null ? { captureIdemKey: row.capture_idem_key } : {}),
+        };
+    }
+    async getRow(id) {
+        const rows = await this.d.all(this.q.selectById, [id]);
+        return rows[0];
+    }
+}
+//# sourceMappingURL=sql-adapter.js.map

package/dist/meter/sql/sql-adapter.js.map

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

package/dist/meter/sql/statements.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Every SQL statement the adapter issues, in one place, with `?` positional
+ * placeholders (the Postgres driver rewrites these to `$n`). Only two statements
+ * vary by dialect - the scalar floor on hold release is `MAX(x, 0)` on SQLite/D1
+ * and `GREATEST(x, 0)` on Postgres - so the set is built from that one keyword.
+ *
+ * The floor is a belt-and-braces guard: in normal operation `held ≥ release`
+ * always, but a crash-orphaned reservation reclaimed after its TTL must never be
+ * able to drive `held` negative.
+ */
+export interface Statements {
+    ensureLedger: string;
+    fund: string;
+    insertReservation: string;
+    /** The atomic gate: place the hold only if the scope can cover it. */
+    placeHold: string;
+    dropReservation: string;
+    selectByIdem: string;
+    /** Flip a held reservation to captured; row count tells us if we won the race. */
+    captureReservation: string;
+    applyLedgerCapture: string;
+    /** Flip a held reservation to voided/expired; row count tells us if we won. */
+    releaseReservation: string;
+    releaseLedgerHold: string;
+    selectBalance: string;
+    selectExpired: string;
+    selectById: string;
+}
+export declare function buildStatements(greatest: "MAX" | "GREATEST"): Statements;
+//# sourceMappingURL=statements.d.ts.map

package/dist/meter/sql/statements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statements.d.ts","sourceRoot":"","sources":["../../../src/meter/sql/statements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,UAAU,GAAG,UAAU,CAsBxE"}