@jinn-network/client 0.1.7 → 0.1.8-canary.09a3b2f6

package/dist/daemon/spend-cap-gate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pre-claim spend-cap check: skips claims for a credential once today's
+ * spend reaches its daily USD cap; logs on under ↔ over transitions only.
+ *
+ * See docs/superpowers/specs/2026-05-21-per-credential-spend-budget-design.md.
+ */
+import type { GateLogger } from './gate-logger.js';
+/**
+ * Whether today's spend has reached or exceeded the cap. The single source of
+ * the cap predicate — shared by the gate and the `/v1/status` spend block so
+ * the two surfaces cannot disagree.
+ */
+export declare function isOverSpendCap(spentTodayUsd: number, capUsd: number): boolean;
+/**
+ * Decide whether a claim may proceed for a credential given today's spend.
+ * Mirrors `gateClaimByReadiness`. `newlyPaused` is true only on the first skip
+ * of an under->over transition — the daemon emits one event on that edge.
+ */
+export declare function gateClaimBySpendCap(args: {
+    credentialId: string;
+    capUsd: number;
+    spentTodayUsd: number;
+    logger: GateLogger;
+}): {
+    proceed: true;
+} | {
+    proceed: false;
+    reason: string;
+    newlyPaused: boolean;
+};
+/**
+ * Test-only: reset the per-credential paused-state memo between tests.
+ *
+ * IMPORTANT: any test file that imports `gateClaimBySpendCap` must call this
+ * in a `beforeEach` hook — the `lastPausedByCredential` map is module-level
+ * state that persists across tests in the same Vitest worker. Without the
+ * reset, the transition-memo logic will produce false positives based on
+ * prior test runs.
+ */
+export declare function _resetSpendCapGateMemoForTests(): void;

package/dist/daemon/spend-cap-gate.js

@@ -0,0 +1,46 @@
+/** Per-credential paused state, so the warn/info logs fire once per transition. */
+const lastPausedByCredential = new Map();
+/**
+ * Whether today's spend has reached or exceeded the cap. The single source of
+ * the cap predicate — shared by the gate and the `/v1/status` spend block so
+ * the two surfaces cannot disagree.
+ */
+export function isOverSpendCap(spentTodayUsd, capUsd) {
+    return spentTodayUsd >= capUsd;
+}
+/**
+ * Decide whether a claim may proceed for a credential given today's spend.
+ * Mirrors `gateClaimByReadiness`. `newlyPaused` is true only on the first skip
+ * of an under->over transition — the daemon emits one event on that edge.
+ */
+export function gateClaimBySpendCap(args) {
+    const over = isOverSpendCap(args.spentTodayUsd, args.capUsd);
+    const wasPaused = lastPausedByCredential.get(args.credentialId) ?? false;
+    if (!over) {
+        if (wasPaused) {
+            args.logger.info(`[spend-cap] ${args.credentialId} under cap again; resuming claims`);
+        }
+        lastPausedByCredential.set(args.credentialId, false);
+        return { proceed: true };
+    }
+    const reason = `daily spend cap reached for ${args.credentialId} ` +
+        `($${args.spentTodayUsd.toFixed(2)} / $${args.capUsd.toFixed(2)})`;
+    if (!wasPaused) {
+        args.logger.warn(`[spend-cap] ${reason}; pausing claims until 00:00 UTC`);
+    }
+    lastPausedByCredential.set(args.credentialId, true);
+    return { proceed: false, reason, newlyPaused: !wasPaused };
+}
+/**
+ * Test-only: reset the per-credential paused-state memo between tests.
+ *
+ * IMPORTANT: any test file that imports `gateClaimBySpendCap` must call this
+ * in a `beforeEach` hook — the `lastPausedByCredential` map is module-level
+ * state that persists across tests in the same Vitest worker. Without the
+ * reset, the transition-memo logic will produce false positives based on
+ * prior test runs.
+ */
+export function _resetSpendCapGateMemoForTests() {
+    lastPausedByCredential.clear();
+}
+//# sourceMappingURL=spend-cap-gate.js.map

package/dist/daemon/spend-cap-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend-cap-gate.js","sourceRoot":"","sources":["../../src/daemon/spend-cap-gate.ts"],"names":[],"mappings":"AAQA,mFAAmF;AACnF,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,aAAqB,EAAE,MAAc;IAClE,OAAO,aAAa,IAAI,MAAM,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;IAEzE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,mCAAmC,CAAC,CAAC;QACxF,CAAC;QACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GACV,+BAA+B,IAAI,CAAC,YAAY,GAAG;QACnD,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,MAAM,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B;IAC5C,sBAAsB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}