@wopr-network/platform-core 1.13.3 → 1.14.1

package/dist/gateway/credit-gate.test.js

@@ -1,7 +1,7 @@
 /**
  * Tests for gateway credit gate — grace buffer and credits_exhausted behavior (WOP-821).
  */
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { Hono } from "hono";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { createTestDb, truncateAllTables } from "../test/db.js";
@@ -39,35 +39,36 @@ afterAll(async () => {
 describe("creditBalanceCheck grace buffer", () => {
     beforeEach(async () => {
         await truncateAllTables(pool);
+        await new DrizzleLedger(db).seedSystemAccounts();
     });
     it("returns null when balance is above estimated cost (passes)", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(500), "purchase", "setup");
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(500), "purchase", { description: "setup" });
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing" };
         expect(await creditBalanceCheck(c, deps, 1)).toBeNull();
     });
     it("returns null when balance is zero but within default grace buffer (passes)", async () => {
         // Balance at exactly 0 — within the -50 grace buffer
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(10), "purchase", "setup");
-        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", "drain");
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(10), "purchase", { description: "setup" });
+        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", { description: "drain" });
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing" };
         expect(await creditBalanceCheck(c, deps, 0)).toBeNull();
     });
     it("returns null when balance is -49 (within 50-cent grace buffer)", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(1), "purchase", "setup");
-        await ledger.debit("t1", Credit.fromCents(50), "adapter_usage", "drain", undefined, true); // balance = -49
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(1), "purchase", { description: "setup" });
+        await ledger.debit("t1", Credit.fromCents(50), "adapter_usage", { description: "drain", allowNegative: true }); // balance = -49
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing" };
         expect(await creditBalanceCheck(c, deps, 0)).toBeNull();
     });
     it("returns credits_exhausted when balance is at -50 (at grace buffer limit)", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(1), "purchase", "setup");
-        await ledger.debit("t1", Credit.fromCents(51), "adapter_usage", "drain", undefined, true); // balance = -50
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(1), "purchase", { description: "setup" });
+        await ledger.debit("t1", Credit.fromCents(51), "adapter_usage", { description: "drain", allowNegative: true }); // balance = -50
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing" };
         const result = await creditBalanceCheck(c, deps, 0);
@@ -75,9 +76,9 @@ describe("creditBalanceCheck grace buffer", () => {
         expect(result?.code).toBe("credits_exhausted");
     });
     it("returns credits_exhausted when balance is at -51 (beyond grace buffer)", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(1), "purchase", "setup");
-        await ledger.debit("t1", Credit.fromCents(52), "adapter_usage", "drain", undefined, true); // balance = -51
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(1), "purchase", { description: "setup" });
+        await ledger.debit("t1", Credit.fromCents(52), "adapter_usage", { description: "drain", allowNegative: true }); // balance = -51
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing" };
         const result = await creditBalanceCheck(c, deps, 0);
@@ -85,9 +86,9 @@ describe("creditBalanceCheck grace buffer", () => {
         expect(result?.code).toBe("credits_exhausted");
     });
     it("returns credits_exhausted when custom graceBufferCents=0 and balance is 0", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(10), "purchase", "setup");
-        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", "drain"); // balance = 0
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(10), "purchase", { description: "setup" });
+        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", { description: "drain" }); // balance = 0
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing", graceBufferCents: 0 };
         const result = await creditBalanceCheck(c, deps, 0);
@@ -95,8 +96,8 @@ describe("creditBalanceCheck grace buffer", () => {
         expect(result?.code).toBe("credits_exhausted");
     });
     it("returns insufficient_credits when balance positive but below estimated cost", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(5), "purchase", "setup");
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(5), "purchase", { description: "setup" });
         const c = await buildHonoContext("t1");
         const deps = { creditLedger: ledger, topUpUrl: "/billing" };
         const result = await creditBalanceCheck(c, deps, 10);
@@ -110,26 +111,27 @@ describe("creditBalanceCheck grace buffer", () => {
 describe("debitCredits with allowNegative and onBalanceExhausted", () => {
     beforeEach(async () => {
         await truncateAllTables(pool);
+        await new DrizzleLedger(db).seedSystemAccounts();
     });
     it("debit with cost that would exceed balance succeeds (allowNegative=true)", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(5), "purchase", "setup"); // balance = 5 cents
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(5), "purchase", { description: "setup" }); // balance = 5 cents
         // costUsd = $0.10 = 10 cents, margin = 1.0
         // This should push balance negative without throwing
         await expect(debitCredits({ creditLedger: ledger, topUpUrl: "/billing" }, "t1", 0.1, 1.0, "chat-completions", "openrouter")).resolves.not.toThrow();
         expect((await ledger.balance("t1")).isNegative()).toBe(true);
     });
     it("fires onBalanceExhausted when debit causes balance to cross zero", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(5), "purchase", "setup"); // balance = 5 cents
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(5), "purchase", { description: "setup" }); // balance = 5 cents
         const onBalanceExhausted = vi.fn();
         // costUsd = $0.10 = 10 cents with margin 1.0 → chargeCents = 10, pushes balance to -5
         await debitCredits({ creditLedger: ledger, topUpUrl: "/billing", onBalanceExhausted }, "t1", 0.1, 1.0, "chat-completions", "openrouter");
         expect(onBalanceExhausted).toHaveBeenCalledWith("t1", -5);
     });
     it("does NOT fire onBalanceExhausted when balance stays positive after debit", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(500), "purchase", "setup"); // balance = 500 cents
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(500), "purchase", { description: "setup" }); // balance = 500 cents
         const onBalanceExhausted = vi.fn();
         // costUsd = $0.01 = 1 cent → balance stays at 499
         await debitCredits({ creditLedger: ledger, topUpUrl: "/billing", onBalanceExhausted }, "t1", 0.01, 1.0, "chat-completions", "openrouter");
@@ -137,8 +139,8 @@ describe("debitCredits with allowNegative and onBalanceExhausted", () => {
         expect((await ledger.balance("t1")).greaterThan(Credit.ZERO)).toBe(true);
     });
     it("onBalanceExhausted callback receives correct tenantId and negative balance", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(3), "purchase", "setup"); // balance = 3 cents
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(3), "purchase", { description: "setup" }); // balance = 3 cents
         const onBalanceExhausted = vi.fn();
         // costUsd = $0.05 = 5 cents with margin 1.0 → pushes balance to -2
         await debitCredits({ creditLedger: ledger, topUpUrl: "/billing", onBalanceExhausted }, "t1", 0.05, 1.0, "chat-completions", "openrouter");
@@ -146,17 +148,17 @@ describe("debitCredits with allowNegative and onBalanceExhausted", () => {
         expect(onBalanceExhausted).toHaveBeenCalledWith("t1", -2);
     });
     it("calls onSpendAlertCrossed after successful debit", async () => {
-        const ledger = new CreditLedger(db);
-        await ledger.credit("t1", Credit.fromCents(500), "purchase", "setup");
+        const ledger = new DrizzleLedger(db);
+        await ledger.credit("t1", Credit.fromCents(500), "purchase", { description: "setup" });
         const onSpendAlertCrossed = vi.fn();
         await debitCredits({ creditLedger: ledger, topUpUrl: "/billing", onSpendAlertCrossed }, "t1", 0.05, 1.0, "chat-completions", "openrouter");
         expect(onSpendAlertCrossed).toHaveBeenCalledWith("t1");
     });
     it("does NOT fire onBalanceExhausted when balance was already negative before debit", async () => {
-        const ledger = new CreditLedger(db);
+        const ledger = new DrizzleLedger(db);
         // Start with negative balance: credit 5, debit 10 → balance = -5
-        await ledger.credit("t1", Credit.fromCents(5), "purchase", "setup");
-        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", "drain", undefined, true);
+        await ledger.credit("t1", Credit.fromCents(5), "purchase", { description: "setup" });
+        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", { description: "drain", allowNegative: true });
         const onBalanceExhausted = vi.fn();
         // Another debit of 1 cent — balance goes from -5 to -6, but was already negative
         await debitCredits({ creditLedger: ledger, topUpUrl: "/billing", onBalanceExhausted }, "t1", 0.01, 1.0, "chat-completions", "openrouter");

package/dist/gateway/protocol/deps.d.ts

@@ -4,7 +4,7 @@
  * Both the Anthropic and OpenAI handlers need the same set of services:
  * budget checking, metering, provider configs, fetch, and service key resolution.
  */
-import type { Credit, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { Credit, ILedger } from "@wopr-network/platform-core/credits";
 import type { MeterEmitter } from "@wopr-network/platform-core/metering";
 import type { IRateLimitRepository } from "../../api/rate-limit-repository.js";
 import type { IBudgetChecker } from "../../monetization/budget/budget-checker.js";
@@ -16,7 +16,7 @@ import type { FetchFn, GatewayTenant, ProviderConfig } from "../types.js";
 export interface ProtocolDeps {
     meter: MeterEmitter;
     budgetChecker: IBudgetChecker;
-    creditLedger?: ICreditLedger;
+    creditLedger?: ILedger;
     topUpUrl: string;
     graceBufferCents?: number;
     providers: ProviderConfig;