@wopr-network/platform-core 1.13.3 → 1.14.0

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;

package/dist/gateway/proxy.d.ts

@@ -9,7 +9,7 @@
  * 4. Emit meter event
  * 5. Return response to bot
  */
-import type { ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { ILedger } from "@wopr-network/platform-core/credits";
 import type { MeterEmitter } from "@wopr-network/platform-core/metering";
 import type { Context } from "hono";
 import type { IBudgetChecker } from "../monetization/budget/budget-checker.js";
@@ -20,7 +20,7 @@ import type { FetchFn, GatewayConfig, ProviderConfig } from "./types.js";
 export interface ProxyDeps {
     meter: MeterEmitter;
     budgetChecker: IBudgetChecker;
-    creditLedger?: ICreditLedger;
+    creditLedger?: ILedger;
     topUpUrl: string;
     graceBufferCents?: number;
     providers: ProviderConfig;

package/dist/gateway/types.d.ts

@@ -5,7 +5,7 @@
  * /v1/... endpoints using WOPR service keys. The gateway authenticates,
  * budget-checks, proxies to upstream providers, meters usage, and responds.
  */
-import type { ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { 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, SpendLimits } from "../monetization/budget/budget-checker.js";
@@ -103,7 +103,7 @@ export interface GatewayConfig {
     /** BudgetChecker instance for pre-call budget validation */
     budgetChecker: IBudgetChecker;
     /** CreditLedger instance for deducting credits after proxy calls (optional — if absent, credit deduction is skipped) */
-    creditLedger?: ICreditLedger;
+    creditLedger?: ILedger;
     /** URL to direct users to when they need to add credits (default: "/dashboard/credits") */
     topUpUrl?: string;
     /** Maximum negative credit balance (in cents) before hard-stop. Default: 50 (-$0.50). */

package/dist/metering/reconciliation-cron.test.js

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { Credit } from "../credits/credit.js";
-import { CreditLedger } from "../credits/credit-ledger.js";
+import { DrizzleLedger } from "../credits/ledger.js";
 import { usageSummaries } from "../db/schema/meter-events.js";
 import { createTestDb, truncateAllTables } from "../test/db.js";
 import { runReconciliation } from "./reconciliation-cron.js";
@@ -21,7 +21,7 @@ describe("runReconciliation", () => {
         const t = await createTestDb();
         pool = t.pool;
         db = t.db;
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
         usageSummaryRepo = new DrizzleUsageSummaryRepository(db);
         adapterUsageRepo = new DrizzleAdapterUsageRepository(db);
     });
@@ -30,6 +30,7 @@ describe("runReconciliation", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
+        await ledger.seedSystemAccounts();
     });
     /** Insert a usage_summaries row directly. */
     async function insertSummary(opts) {
@@ -57,7 +58,7 @@ describe("runReconciliation", () => {
         const charge = Credit.fromCents(50);
         await insertSummary({ tenant: "t1", totalCharge: charge.toRaw() });
         await ledger.credit("t1", Credit.fromCents(500), "purchase");
-        await ledger.debit("t1", charge, "adapter_usage", "chat usage");
+        await ledger.debit("t1", charge, "adapter_usage", { description: "chat usage" });
         const result = await runReconciliation({ usageSummaryRepo, adapterUsageRepo, targetDate: TODAY });
         expect(result.tenantsChecked).toBe(1);
         expect(result.discrepancies).toEqual([]);
@@ -65,7 +66,7 @@ describe("runReconciliation", () => {
     it("detects drift when metered charge exceeds ledger debit", async () => {
         await insertSummary({ tenant: "t1", totalCharge: Credit.fromCents(100).toRaw() });
         await ledger.credit("t1", Credit.fromCents(500), "purchase");
-        await ledger.debit("t1", Credit.fromCents(80), "adapter_usage", "chat usage");
+        await ledger.debit("t1", Credit.fromCents(80), "adapter_usage", { description: "chat usage" });
         const result = await runReconciliation({ usageSummaryRepo, adapterUsageRepo, targetDate: TODAY });
         expect(result.tenantsChecked).toBe(1);
         expect(result.discrepancies).toHaveLength(1);
@@ -91,7 +92,7 @@ describe("runReconciliation", () => {
         await insertSummary({ tenant: "t1", totalCharge: Credit.fromCents(20).toRaw() });
         await ledger.credit("t1", Credit.fromCents(500), "purchase");
         // Debit as bot_runtime — should NOT count toward reconciliation
-        await ledger.debit("t1", Credit.fromCents(20), "bot_runtime", "daily runtime");
+        await ledger.debit("t1", Credit.fromCents(20), "bot_runtime", { description: "daily runtime" });
         const result = await runReconciliation({ usageSummaryRepo, adapterUsageRepo, targetDate: TODAY });
         // Metered 20c, ledger adapter_usage = 0 => drift = 20c
         expect(result.discrepancies).toHaveLength(1);
@@ -119,11 +120,11 @@ describe("runReconciliation", () => {
         // t1: balanced
         await insertSummary({ tenant: "t1", totalCharge: Credit.fromCents(50).toRaw() });
         await ledger.credit("t1", Credit.fromCents(500), "purchase");
-        await ledger.debit("t1", Credit.fromCents(50), "adapter_usage", "chat");
+        await ledger.debit("t1", Credit.fromCents(50), "adapter_usage", { description: "chat" });
         // t2: drifted
         await insertSummary({ tenant: "t2", totalCharge: Credit.fromCents(100).toRaw() });
         await ledger.credit("t2", Credit.fromCents(500), "purchase");
-        await ledger.debit("t2", Credit.fromCents(60), "adapter_usage", "chat");
+        await ledger.debit("t2", Credit.fromCents(60), "adapter_usage", { description: "chat" });
         const result = await runReconciliation({ usageSummaryRepo, adapterUsageRepo, targetDate: TODAY });
         expect(result.tenantsChecked).toBe(2);
         expect(result.discrepancies).toHaveLength(1);
@@ -154,7 +155,7 @@ describe("runReconciliation", () => {
         // Metered 50c but debited 80c (over-billed)
         await insertSummary({ tenant: "t1", totalCharge: Credit.fromCents(50).toRaw() });
         await ledger.credit("t1", Credit.fromCents(500), "purchase");
-        await ledger.debit("t1", Credit.fromCents(80), "adapter_usage", "chat usage");
+        await ledger.debit("t1", Credit.fromCents(80), "adapter_usage", { description: "chat usage" });
         const result = await runReconciliation({ usageSummaryRepo, adapterUsageRepo, targetDate: TODAY });
         expect(result.discrepancies).toHaveLength(1);
         expect(result.discrepancies[0].driftRaw).toBe(Credit.fromCents(-30).toRaw());

package/dist/metering/reconciliation-repository.js

@@ -1,5 +1,5 @@
 import { and, eq, gte, lt, ne, sql } from "drizzle-orm";
-import { creditTransactions } from "../db/schema/credits.js";
+import { journalEntries, journalLines } from "../db/schema/ledger.js";
 import { usageSummaries } from "../db/schema/meter-events.js";
 export class DrizzleUsageSummaryRepository {
     db;
@@ -25,19 +25,21 @@ export class DrizzleAdapterUsageRepository {
         this.db = db;
     }
     async getAggregatedAdapterUsageDebits(startIso, endIso) {
+        // Sum the debit-side journal line amounts for adapter_usage entries.
+        // In double-entry: DR tenant liability (2000:<tenantId>), CR revenue:adapter_usage (4010).
+        // The debit line on the tenant account represents the charge amount.
         const rows = await this.db
             .select({
-            tenantId: creditTransactions.tenantId,
-            // amount_credits stores negative values for debits; ABS gives the raw positive debit amount.
-            // Use the raw column name in sql to bypass the custom creditColumn type serializer.
-            // raw SQL: Drizzle cannot express ABS with COALESCE and SUM
-            totalDebitRaw: sql `COALESCE(SUM(ABS(amount_credits)), 0)`,
+            tenantId: journalEntries.tenantId,
+            // raw SQL: Drizzle cannot express COALESCE with SUM aggregation
+            totalDebitRaw: sql `COALESCE(SUM(${journalLines.amount}), 0)`,
         })
-            .from(creditTransactions)
-            .where(and(eq(creditTransactions.type, "adapter_usage"), 
+            .from(journalLines)
+            .innerJoin(journalEntries, eq(journalEntries.id, journalLines.journalEntryId))
+            .where(and(eq(journalEntries.entryType, "adapter_usage"), eq(journalLines.side, "debit"), 
         // raw SQL: Drizzle cannot express timestamptz cast for text column date comparison
-        sql `${creditTransactions.createdAt}::timestamptz >= ${startIso}::timestamptz`, sql `${creditTransactions.createdAt}::timestamptz < ${endIso}::timestamptz`))
-            .groupBy(creditTransactions.tenantId);
+        sql `${journalEntries.postedAt}::timestamptz >= ${startIso}::timestamptz`, sql `${journalEntries.postedAt}::timestamptz < ${endIso}::timestamptz`))
+            .groupBy(journalEntries.tenantId);
         return rows.map((r) => ({ tenantId: r.tenantId, totalDebitRaw: Number(r.totalDebitRaw) }));
     }
 }

package/dist/metering/reconciliation-repository.test.js

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { Credit } from "../credits/credit.js";
-import { CreditLedger } from "../credits/credit-ledger.js";
+import { DrizzleLedger } from "../credits/ledger.js";
 import { createTestDb, seedUsageSummary, truncateAllTables } from "../test/db.js";
 import { DrizzleAdapterUsageRepository, DrizzleUsageSummaryRepository } from "./reconciliation-repository.js";
 let pool;
@@ -108,7 +108,8 @@ describe("DrizzleAdapterUsageRepository", () => {
     beforeEach(async () => {
         await truncateAllTables(pool);
         repo = new DrizzleAdapterUsageRepository(db);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
     });
     it("returns empty array when no adapter_usage debits exist", async () => {
         const today = new Date().toISOString().slice(0, 10);
@@ -121,9 +122,9 @@ describe("DrizzleAdapterUsageRepository", () => {
         // Fund tenants
         await ledger.credit("t1", Credit.fromCents(1000), "purchase");
         await ledger.credit("t2", Credit.fromCents(1000), "purchase");
-        await ledger.debit("t1", Credit.fromCents(30), "adapter_usage", "t1-debit-1");
-        await ledger.debit("t1", Credit.fromCents(20), "adapter_usage", "t1-debit-2");
-        await ledger.debit("t2", Credit.fromCents(50), "adapter_usage", "t2-debit-1");
+        await ledger.debit("t1", Credit.fromCents(30), "adapter_usage", { description: "t1-debit-1" });
+        await ledger.debit("t1", Credit.fromCents(20), "adapter_usage", { description: "t1-debit-2" });
+        await ledger.debit("t2", Credit.fromCents(50), "adapter_usage", { description: "t2-debit-1" });
         // Query window covering today
         const today = new Date().toISOString().slice(0, 10);
         const startIso = `${today}T00:00:00Z`;
@@ -137,8 +138,8 @@ describe("DrizzleAdapterUsageRepository", () => {
     });
     it("excludes non-adapter_usage debit types", async () => {
         await ledger.credit("t1", Credit.fromCents(1000), "purchase");
-        await ledger.debit("t1", Credit.fromCents(30), "adapter_usage", "adapter debit");
-        await ledger.debit("t1", Credit.fromCents(20), "bot_runtime", "runtime debit");
+        await ledger.debit("t1", Credit.fromCents(30), "adapter_usage", { description: "adapter debit" });
+        await ledger.debit("t1", Credit.fromCents(20), "bot_runtime", { description: "runtime debit" });
         const today = new Date().toISOString().slice(0, 10);
         const startIso = `${today}T00:00:00Z`;
         const endIso = new Date(new Date(startIso).getTime() + 86400000).toISOString();
@@ -148,7 +149,7 @@ describe("DrizzleAdapterUsageRepository", () => {
     });
     it("excludes credit transactions (positive amounts are not debits)", async () => {
         await ledger.credit("t1", Credit.fromCents(1000), "purchase");
-        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", "real debit");
+        await ledger.debit("t1", Credit.fromCents(10), "adapter_usage", { description: "real debit" });
         const today = new Date().toISOString().slice(0, 10);
         const startIso = `${today}T00:00:00Z`;
         const endIso = new Date(new Date(startIso).getTime() + 86400000).toISOString();

package/dist/monetization/affiliate/affiliate-admin-repository.js

@@ -3,7 +3,7 @@ import { and, count, desc, eq, gte, isNotNull, sql } from "drizzle-orm";
 import { logger } from "../../config/logger.js";
 import { affiliateReferrals } from "../../db/schema/affiliate.js";
 import { affiliateFraudEvents } from "../../db/schema/affiliate-fraud.js";
-import { creditTransactions } from "../../db/schema/credits.js";
+import { journalEntries } from "../../db/schema/ledger.js";
 function parseSignals(raw) {
     try {
         const parsed = JSON.parse(raw);
@@ -84,10 +84,12 @@ export class DrizzleAffiliateFraudAdminRepository {
     }
     async listFingerprintClusters() {
         const rows = (await this.db.execute(sql `
-      SELECT stripe_fingerprint, array_agg(DISTINCT tenant_id ORDER BY tenant_id) AS tenant_ids
-      FROM credit_transactions
-      WHERE stripe_fingerprint IS NOT NULL
-      GROUP BY stripe_fingerprint
+      SELECT metadata->>'stripeFingerprint' AS stripe_fingerprint,
+             array_agg(DISTINCT tenant_id ORDER BY tenant_id) AS tenant_ids
+      FROM journal_entries
+      WHERE metadata->>'stripeFingerprint' IS NOT NULL
+        AND entry_type = 'purchase'
+      GROUP BY metadata->>'stripeFingerprint'
       HAVING COUNT(DISTINCT tenant_id) > 1
       ORDER BY COUNT(DISTINCT tenant_id) DESC
     `));
@@ -98,9 +100,9 @@ export class DrizzleAffiliateFraudAdminRepository {
     }
     async blockFingerprint(fingerprint, adminUserId) {
         const rows = await this.db
-            .selectDistinct({ tenantId: creditTransactions.tenantId })
-            .from(creditTransactions)
-            .where(eq(creditTransactions.stripeFingerprint, fingerprint));
+            .selectDistinct({ tenantId: journalEntries.tenantId })
+            .from(journalEntries)
+            .where(and(eq(journalEntries.entryType, "purchase"), sql `${journalEntries.metadata}->>'stripeFingerprint' = ${fingerprint}`));
         const tenantIds = rows.map((r) => r.tenantId);
         const now = new Date().toISOString();
         for (const tenantId of tenantIds) {

package/dist/monetization/affiliate/affiliate-admin-repository.test.js

@@ -1,8 +1,8 @@
-import { sql } from "drizzle-orm";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { affiliateReferrals } from "../../db/schema/affiliate.js";
 import { affiliateFraudEvents } from "../../db/schema/affiliate-fraud.js";
-import { beginTestTransaction, createTestDb, endTestTransaction, rollbackTestTransaction } from "../../test/db.js";
+import { createTestDb, truncateAllTables } from "../../test/db.js";
 import { ADMIN_BLOCK_SENTINEL, DrizzleAffiliateFraudAdminRepository } from "./affiliate-admin-repository.js";
 describe("DrizzleAffiliateFraudAdminRepository", () => {
     let pool;
@@ -10,14 +10,13 @@ describe("DrizzleAffiliateFraudAdminRepository", () => {
     let repo;
     beforeAll(async () => {
         ({ db, pool } = await createTestDb());
-        await beginTestTransaction(pool);
     });
     afterAll(async () => {
-        await endTestTransaction(pool);
         await pool.close();
     });
     beforeEach(async () => {
-        await rollbackTestTransaction(pool);
+        await truncateAllTables(pool);
+        await new DrizzleLedger(db).seedSystemAccounts();
         repo = new DrizzleAffiliateFraudAdminRepository(db);
     });
     describe("listSuppressions", () => {
@@ -140,9 +139,17 @@ describe("DrizzleAffiliateFraudAdminRepository", () => {
     });
     describe("blockFingerprint", () => {
         it("should insert fraud events with ADMIN_BLOCK as referredTenantId", async () => {
-            await db.execute(sql `INSERT INTO credit_transactions (id, tenant_id, amount_credits, balance_after_credits, type, created_at, stripe_fingerprint)
-            VALUES ('ct-1', 't-alice', 0, 0, 'purchase', now(), 'fp_abc123'),
-                   ('ct-2', 't-bob', 0, 0, 'purchase', now(), 'fp_abc123')`);
+            const ledger = new DrizzleLedger(db);
+            await ledger.credit("t-alice", Credit.fromCents(1), "purchase", {
+                description: "test purchase",
+                referenceId: "ref-alice-fp_abc123",
+                stripeFingerprint: "fp_abc123",
+            });
+            await ledger.credit("t-bob", Credit.fromCents(1), "purchase", {
+                description: "test purchase",
+                referenceId: "ref-bob-fp_abc123",
+                stripeFingerprint: "fp_abc123",
+            });
             await repo.blockFingerprint("fp_abc123", "admin-user-1");
             const result = await repo.listSuppressions(50, 0);
             expect(result.events).toHaveLength(2);
@@ -156,9 +163,17 @@ describe("DrizzleAffiliateFraudAdminRepository", () => {
             expect(tenantIds).toEqual(["t-alice", "t-bob"]);
         });
         it("should use unique referralId per tenant to avoid unique constraint conflicts", async () => {
-            await db.execute(sql `INSERT INTO credit_transactions (id, tenant_id, amount_credits, balance_after_credits, type, created_at, stripe_fingerprint)
-            VALUES ('ct-3', 't-carol', 0, 0, 'purchase', now(), 'fp_def456'),
-                   ('ct-4', 't-dave', 0, 0, 'purchase', now(), 'fp_def456')`);
+            const ledger = new DrizzleLedger(db);
+            await ledger.credit("t-carol", Credit.fromCents(1), "purchase", {
+                description: "test purchase",
+                referenceId: "ref-carol-fp_def456",
+                stripeFingerprint: "fp_def456",
+            });
+            await ledger.credit("t-dave", Credit.fromCents(1), "purchase", {
+                description: "test purchase",
+                referenceId: "ref-dave-fp_def456",
+                stripeFingerprint: "fp_def456",
+            });
             await repo.blockFingerprint("fp_def456", "admin-user-2");
             const result = await repo.listSuppressions(50, 0);
             expect(result.events).toHaveLength(2);
@@ -169,8 +184,12 @@ describe("DrizzleAffiliateFraudAdminRepository", () => {
             expect(new Set(referralIds).size).toBe(2);
         });
         it("should be idempotent via onConflictDoNothing", async () => {
-            await db.execute(sql `INSERT INTO credit_transactions (id, tenant_id, amount_credits, balance_after_credits, type, created_at, stripe_fingerprint)
-            VALUES ('ct-5', 't-eve', 0, 0, 'purchase', now(), 'fp_ghi789')`);
+            const ledger = new DrizzleLedger(db);
+            await ledger.credit("t-eve", Credit.fromCents(1), "purchase", {
+                description: "test purchase",
+                referenceId: "ref-eve-fp_ghi789",
+                stripeFingerprint: "fp_ghi789",
+            });
             await repo.blockFingerprint("fp_ghi789", "admin-user-3");
             await repo.blockFingerprint("fp_ghi789", "admin-user-3");
             const result = await repo.listSuppressions(50, 0);

package/dist/monetization/affiliate/credit-match.d.ts

@@ -1,10 +1,10 @@
-import type { Credit, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { Credit, ILedger } from "@wopr-network/platform-core/credits";
 import type { IAffiliateFraudRepository } from "./affiliate-fraud-repository.js";
 import type { IAffiliateRepository } from "./drizzle-affiliate-repository.js";
 export interface AffiliateCreditMatchDeps {
     tenantId: string;
     purchaseAmount: Credit;
-    ledger: ICreditLedger;
+    ledger: ILedger;
     affiliateRepo: IAffiliateRepository;
     matchRate?: number;
     fraudRepo?: IAffiliateFraudRepository;

package/dist/monetization/affiliate/credit-match.js

@@ -85,7 +85,10 @@ export async function processAffiliateCreditMatch(deps) {
     if (matchAmount.isZero() || matchAmount.isNegative())
         return null;
     // 6. Credit the referrer
-    await ledger.credit(referral.referrerTenantId, matchAmount, "affiliate_match", `Affiliate match for referred tenant ${tenantId}`, refId);
+    await ledger.credit(referral.referrerTenantId, matchAmount, "affiliate_match", {
+        description: `Affiliate match for referred tenant ${tenantId}`,
+        referenceId: refId,
+    });
     // 7. Update referral record
     await affiliateRepo.markFirstPurchase(tenantId);
     await affiliateRepo.recordMatch(tenantId, matchAmount);