@wopr-network/platform-core 1.13.2 → 1.14.0

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);

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

@@ -1,4 +1,4 @@
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
 import { DrizzleAffiliateFraudRepository } from "./affiliate-fraud-repository.js";
@@ -18,12 +18,17 @@ describe("processAffiliateCreditMatch", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
         affiliateRepo = new DrizzleAffiliateRepository(db);
         fraudRepo = new DrizzleAffiliateFraudRepository(db);
     });
     it("does nothing when tenant has no referral", async () => {
-        await ledger.credit("buyer", Credit.fromCents(1000), "purchase", "first buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(1000), "purchase", {
+            description: "first buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const result = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(1000),
@@ -34,8 +39,16 @@ describe("processAffiliateCreditMatch", () => {
     });
     it("does nothing when tenant already has prior purchases", async () => {
         await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-        await ledger.credit("buyer", Credit.fromCents(500), "purchase", "old buy", "session-0", "stripe");
-        await ledger.credit("buyer", Credit.fromCents(1000), "purchase", "new buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(500), "purchase", {
+            description: "old buy",
+            referenceId: "session-0",
+            fundingSource: "stripe",
+        });
+        await ledger.credit("buyer", Credit.fromCents(1000), "purchase", {
+            description: "new buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const result = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(1000),
@@ -46,7 +59,11 @@ describe("processAffiliateCreditMatch", () => {
     });
     it("credits referrer on first purchase with 100% match", async () => {
         await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", "first buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", {
+            description: "first buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const result = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(2000),
@@ -65,7 +82,11 @@ describe("processAffiliateCreditMatch", () => {
     });
     it("respects custom match rate", async () => {
         await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", "first buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", {
+            description: "first buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const result = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(2000),
@@ -78,7 +99,11 @@ describe("processAffiliateCreditMatch", () => {
     });
     it("is idempotent — second call returns null", async () => {
         await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-        await ledger.credit("buyer", Credit.fromCents(1000), "purchase", "first buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(1000), "purchase", {
+            description: "first buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const first = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(1000),
@@ -99,7 +124,11 @@ describe("processAffiliateCreditMatch", () => {
             signupIp: "1.2.3.4",
             signupEmail: "alice+ref@gmail.com",
         });
-        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", "first buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", {
+            description: "first buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const result = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(2000),
@@ -127,7 +156,11 @@ describe("processAffiliateCreditMatch", () => {
             }
             // New referral
             await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-            await ledger.credit("buyer", Credit.fromCents(1000), "purchase", "first buy", "session-1", "stripe");
+            await ledger.credit("buyer", Credit.fromCents(1000), "purchase", {
+                description: "first buy",
+                referenceId: "session-1",
+                fundingSource: "stripe",
+            });
             const result = await processAffiliateCreditMatch({
                 tenantId: "buyer",
                 purchaseAmount: Credit.fromCents(1000),
@@ -151,7 +184,11 @@ describe("processAffiliateCreditMatch", () => {
             }
             // New referral
             await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-            await ledger.credit("buyer", Credit.fromCents(1000), "purchase", "first buy", "session-1", "stripe");
+            await ledger.credit("buyer", Credit.fromCents(1000), "purchase", {
+                description: "first buy",
+                referenceId: "session-1",
+                fundingSource: "stripe",
+            });
             const result = await processAffiliateCreditMatch({
                 tenantId: "buyer",
                 purchaseAmount: Credit.fromCents(1000),
@@ -167,7 +204,11 @@ describe("processAffiliateCreditMatch", () => {
         });
         it("allows payout when under both caps", async () => {
             await affiliateRepo.recordReferral("referrer", "buyer", "abc123");
-            await ledger.credit("buyer", Credit.fromCents(2000), "purchase", "first buy", "session-1", "stripe");
+            await ledger.credit("buyer", Credit.fromCents(2000), "purchase", {
+                description: "first buy",
+                referenceId: "session-1",
+                fundingSource: "stripe",
+            });
             const result = await processAffiliateCreditMatch({
                 tenantId: "buyer",
                 purchaseAmount: Credit.fromCents(2000),
@@ -184,7 +225,11 @@ describe("processAffiliateCreditMatch", () => {
         await affiliateRepo.recordReferral("referrer", "buyer", "abc123", {
             signupIp: "1.2.3.4",
         });
-        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", "first buy", "session-1", "stripe");
+        await ledger.credit("buyer", Credit.fromCents(2000), "purchase", {
+            description: "first buy",
+            referenceId: "session-1",
+            fundingSource: "stripe",
+        });
         const result = await processAffiliateCreditMatch({
             tenantId: "buyer",
             purchaseAmount: Credit.fromCents(2000),

package/dist/monetization/affiliate/new-user-bonus.d.ts

@@ -1,10 +1,10 @@
-import type { ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { ILedger } from "@wopr-network/platform-core/credits";
 import { Credit } from "@wopr-network/platform-core/credits";
 import type { IAffiliateRepository } from "./drizzle-affiliate-repository.js";
 /** Default bonus rate: 20% of purchase amount. Override with AFFILIATE_NEW_USER_BONUS_RATE env var. */
 export declare const DEFAULT_BONUS_RATE: number;
 export interface NewUserBonusParams {
-    ledger: ICreditLedger;
+    ledger: ILedger;
     affiliateRepo: IAffiliateRepository;
     referredTenantId: string;
     purchaseAmount: Credit;

package/dist/monetization/affiliate/new-user-bonus.js

@@ -34,6 +34,9 @@ export async function grantNewUserBonus(params) {
     // 5. Mark first purchase on the referral row (no-op if already set)
     await affiliateRepo.markFirstPurchase(referredTenantId);
     // 6. Credit the bonus
-    await ledger.credit(referredTenantId, bonus, "affiliate_bonus", `New user first-purchase bonus (${Math.round(rate * 100)}%)`, refId);
+    await ledger.credit(referredTenantId, bonus, "affiliate_bonus", {
+        description: `New user first-purchase bonus (${Math.round(rate * 100)}%)`,
+        referenceId: refId,
+    });
     return { granted: true, bonus };
 }

package/dist/monetization/affiliate/new-user-bonus.test.js

@@ -1,4 +1,4 @@
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
 import { DrizzleAffiliateRepository } from "./drizzle-affiliate-repository.js";
@@ -16,7 +16,8 @@ describe("grantNewUserBonus", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
         affiliateRepo = new DrizzleAffiliateRepository(db);
     });
     it("DEFAULT_BONUS_RATE equals 0.20", () => {
@@ -37,7 +38,7 @@ describe("grantNewUserBonus", () => {
         expect((await ledger.balance("referred-1")).toCents()).toBe(1000);
         const txns = await ledger.history("referred-1");
         expect(txns).toHaveLength(1);
-        expect(txns[0].type).toBe("affiliate_bonus");
+        expect(txns[0].entryType).toBe("affiliate_bonus");
         expect(txns[0].referenceId).toBe("affiliate-bonus:referred-1");
         expect(txns[0].description).toContain("first-purchase bonus");
     });

package/dist/monetization/credits/auto-topup-charge.d.ts

@@ -1,5 +1,5 @@
 import type { ITenantCustomerRepository } from "@wopr-network/platform-core/billing";
-import type { Credit, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { Credit, ILedger } from "@wopr-network/platform-core/credits";
 import Stripe from "stripe";
 import type { IAutoTopupEventLogRepository } from "./auto-topup-event-log-repository.js";
 /** After this many consecutive Stripe failures, the auto-topup mode is disabled. */
@@ -7,7 +7,7 @@ export declare const MAX_CONSECUTIVE_FAILURES = 3;
 export interface AutoTopupChargeDeps {
     stripe: Stripe;
     tenantRepo: ITenantCustomerRepository;
-    creditLedger: ICreditLedger;
+    creditLedger: ILedger;
     eventLogRepo: IAutoTopupEventLogRepository;
 }
 export interface AutoTopupChargeResult {

package/dist/monetization/credits/auto-topup-charge.js

@@ -113,7 +113,11 @@ export async function chargeAutoTopup(deps, tenantId, amount, source) {
     // 5. Credit the ledger (idempotent via referenceId = PI ID)
     try {
         if (!(await deps.creditLedger.hasReferenceId(paymentIntent.id))) {
-            await deps.creditLedger.credit(tenantId, amount, "purchase", `Auto-topup (${source})`, paymentIntent.id, "stripe");
+            await deps.creditLedger.credit(tenantId, amount, "purchase", {
+                description: `Auto-topup (${source})`,
+                referenceId: paymentIntent.id,
+                fundingSource: "stripe",
+            });
         }
     }
     catch (err) {

package/dist/monetization/credits/auto-topup-charge.test.js

@@ -1,5 +1,5 @@
 import crypto from "node:crypto";
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import Stripe from "stripe";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { creditAutoTopup } from "../../db/schema/credit-auto-topup.js";
@@ -46,7 +46,8 @@ describe("chargeAutoTopup", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
     });
     it("charges Stripe and credits ledger on success", async () => {
         const stripe = mockStripe();
@@ -62,8 +63,8 @@ describe("chargeAutoTopup", () => {
         expect(result.paymentReference).toEqual(expect.any(String));
         expect((await ledger.balance("t1")).toCents()).toBe(500);
         const history = await ledger.history("t1");
-        expect(history[0].type).toBe("purchase");
-        expect(history[0].fundingSource).toBe("stripe");
+        expect(history[0].entryType).toBe("purchase");
+        expect(history[0].metadata?.fundingSource).toBe("stripe");
     });
     it("writes success event to credit_auto_topup log", async () => {
         const stripe = mockStripe();

package/dist/monetization/credits/auto-topup-usage.d.ts

@@ -1,8 +1,8 @@
-import type { Credit, IAutoTopupSettingsRepository, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { Credit, IAutoTopupSettingsRepository, ILedger } from "@wopr-network/platform-core/credits";
 import type { AutoTopupChargeResult } from "./auto-topup-charge.js";
 export interface UsageTopupDeps {
     settingsRepo: IAutoTopupSettingsRepository;
-    creditLedger: ICreditLedger;
+    creditLedger: ILedger;
     /** Injected charge function (allows mocking in tests). */
     chargeAutoTopup: (tenantId: string, amount: Credit, source: string) => Promise<AutoTopupChargeResult>;
     /** Optional tenant status check. If provided and returns non-null, skip the charge. */

package/dist/monetization/credits/auto-topup-usage.test.js

@@ -1,4 +1,4 @@
-import { Credit, CreditLedger, DrizzleAutoTopupSettingsRepository } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleAutoTopupSettingsRepository, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
 import { maybeTriggerUsageTopup } from "./auto-topup-usage.js";
@@ -15,7 +15,8 @@ describe("maybeTriggerUsageTopup", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
         settingsRepo = new DrizzleAutoTopupSettingsRepository(db);
     });
     it("does nothing when tenant has no auto-topup settings", async () => {
@@ -26,7 +27,11 @@ describe("maybeTriggerUsageTopup", () => {
     });
     it("does nothing when usage_enabled is false", async () => {
         await settingsRepo.upsert("t1", { usageEnabled: false });
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn();
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");
@@ -38,7 +43,11 @@ describe("maybeTriggerUsageTopup", () => {
             usageThreshold: Credit.fromCents(100),
             usageTopup: Credit.fromCents(500),
         });
-        await ledger.credit("t1", Credit.fromCents(200), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(200), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn();
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");
@@ -50,7 +59,11 @@ describe("maybeTriggerUsageTopup", () => {
             usageThreshold: Credit.fromCents(100),
             usageTopup: Credit.fromCents(500),
         });
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn().mockResolvedValue({ success: true, paymentReference: "pi_123" });
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");
@@ -59,7 +72,11 @@ describe("maybeTriggerUsageTopup", () => {
     it("skips when charge is already in-flight", async () => {
         await settingsRepo.upsert("t1", { usageEnabled: true, usageThreshold: Credit.fromCents(100) });
         await settingsRepo.setUsageChargeInFlight("t1", true);
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn();
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");
@@ -72,7 +89,11 @@ describe("maybeTriggerUsageTopup", () => {
             usageThreshold: Credit.fromCents(500),
             usageTopup: Credit.fromCents(2000),
         });
-        await ledger.credit("t1", Credit.fromCents(100), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(100), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn().mockResolvedValue({ success: true, paymentReference: "pi_race" });
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         // Fire two concurrent calls — both see balance < threshold,
@@ -91,7 +112,11 @@ describe("maybeTriggerUsageTopup", () => {
             usageThreshold: Credit.fromCents(100),
             usageTopup: Credit.fromCents(500),
         });
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn().mockResolvedValue({ success: true, paymentReference: "pi_123" });
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         // First call — triggers charge, flag set then cleared
@@ -109,7 +134,11 @@ describe("maybeTriggerUsageTopup", () => {
             usageThreshold: Credit.fromCents(100),
             usageTopup: Credit.fromCents(500),
         });
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi
             .fn()
             .mockRejectedValueOnce(new Error("Stripe network error"))
@@ -132,7 +161,11 @@ describe("maybeTriggerUsageTopup", () => {
         });
         await settingsRepo.incrementUsageFailures("t1");
         await settingsRepo.incrementUsageFailures("t1");
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn().mockResolvedValue({ success: true });
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");
@@ -144,7 +177,11 @@ describe("maybeTriggerUsageTopup", () => {
             usageThreshold: Credit.fromCents(100),
             usageTopup: Credit.fromCents(500),
         });
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn().mockResolvedValue({ success: false, error: "declined" });
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");
@@ -170,7 +207,11 @@ describe("maybeTriggerUsageTopup", () => {
         });
         await settingsRepo.incrementUsageFailures("t1");
         await settingsRepo.incrementUsageFailures("t1");
-        await ledger.credit("t1", Credit.fromCents(50), "purchase", "buy", "ref-1", "stripe");
+        await ledger.credit("t1", Credit.fromCents(50), "purchase", {
+            description: "buy",
+            referenceId: "ref-1",
+            fundingSource: "stripe",
+        });
         const mockCharge = vi.fn().mockResolvedValue({ success: false, error: "declined" });
         const deps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
         await maybeTriggerUsageTopup(deps, "t1");

package/dist/monetization/credits/bot-billing.d.ts

@@ -1,4 +1,4 @@
-import type { ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { ILedger } from "@wopr-network/platform-core/credits";
 import { Credit } from "@wopr-network/platform-core/credits";
 import type { IBotInstanceRepository } from "../../fleet/bot-instance-repository.js";
 import type { INodeCommandBus } from "../../fleet/node-command-bus.js";
@@ -11,7 +11,7 @@ export interface IBotBilling {
     suspendBot(botId: string): Promise<void>;
     suspendAllForTenant(tenantId: string): Promise<string[]>;
     reactivateBot(botId: string): Promise<void>;
-    checkReactivation(tenantId: string, ledger: ICreditLedger): Promise<string[]>;
+    checkReactivation(tenantId: string, ledger: ILedger): Promise<string[]>;
     destroyBot(botId: string): Promise<void>;
     destroyExpiredBots(): Promise<string[]>;
     getBotBilling(botId: string): Promise<unknown>;
@@ -56,7 +56,7 @@ export declare class DrizzleBotBilling implements IBotBilling {
      *
      * @returns IDs of reactivated bots.
      */
-    checkReactivation(tenantId: string, ledger: ICreditLedger): Promise<string[]>;
+    checkReactivation(tenantId: string, ledger: ILedger): Promise<string[]>;
     /**
      * Mark a bot as destroyed.
      * Sets billingState='destroyed'. Actual Docker cleanup is handled by the caller.

package/dist/monetization/credits/bot-billing.test.js

@@ -1,4 +1,4 @@
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { sql } from "drizzle-orm";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { botInstances } from "../../db/schema/bot-instances.js";
@@ -61,7 +61,8 @@ describe("BotBilling", () => {
     beforeEach(async () => {
         await truncateAllTables(pool);
         billing = new BotBilling(new DrizzleBotInstanceRepository(db));
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
     });
     describe("registerBot", () => {
         it("registers a bot in active billing state", async () => {
@@ -178,7 +179,11 @@ describe("BotBilling", () => {
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
             await billing.suspendBot("bot-1");
             await billing.suspendBot("bot-2");
-            await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "test credit", "ref-1", "stripe");
+            await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", {
+                description: "test credit",
+                referenceId: "ref-1",
+                fundingSource: "stripe",
+            });
             const reactivated = await billing.checkReactivation("tenant-1", ledger);
             expect(reactivated.sort()).toEqual(["bot-1", "bot-2"]);
             expect(await billing.getActiveBotCount("tenant-1")).toBe(2);
@@ -193,12 +198,20 @@ describe("BotBilling", () => {
         it("does not reactivate destroyed bots", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
             await billing.destroyBot("bot-1");
-            await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "test credit", "ref-1", "stripe");
+            await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", {
+                description: "test credit",
+                referenceId: "ref-1",
+                fundingSource: "stripe",
+            });
             const reactivated = await billing.checkReactivation("tenant-1", ledger);
             expect(reactivated).toEqual([]);
         });
         it("returns empty array for tenant with no bots", async () => {
-            await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "test credit", "ref-1", "stripe");
+            await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", {
+                description: "test credit",
+                referenceId: "ref-1",
+                fundingSource: "stripe",
+            });
             const reactivated = await billing.checkReactivation("tenant-1", ledger);
             expect(reactivated).toEqual([]);
         });