@wopr-network/platform-core 1.13.2 → 1.14.0

package/src/monetization/affiliate/credit-match.test.ts

@@ -1,5 +1,5 @@
 import type { PGlite } from "@electric-sql/pglite";
-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 type { DrizzleDb } from "../../db/index.js";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
@@ -10,7 +10,7 @@ import { DrizzleAffiliateRepository } from "./drizzle-affiliate-repository.js";
 describe("processAffiliateCreditMatch", () => {
   let pool: PGlite;
   let db: DrizzleDb;
-  let ledger: CreditLedger;
+  let ledger: DrizzleLedger;
   let affiliateRepo: DrizzleAffiliateRepository;
   let fraudRepo: DrizzleAffiliateFraudRepository;
 
@@ -24,13 +24,19 @@ 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",
@@ -45,8 +51,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",
@@ -60,7 +74,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",
@@ -83,7 +101,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",
@@ -99,7 +121,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",
@@ -123,7 +149,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",
@@ -156,7 +186,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",
@@ -184,7 +218,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",
@@ -203,7 +241,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",
@@ -223,7 +265,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",

package/src/monetization/affiliate/credit-match.ts

@@ -1,4 +1,4 @@
-import type { Credit, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { Credit, ILedger } from "@wopr-network/platform-core/credits";
 import { config } from "../../config/index.js";
 import type { IAffiliateFraudRepository } from "./affiliate-fraud-repository.js";
 import type { IAffiliateRepository } from "./drizzle-affiliate-repository.js";
@@ -11,7 +11,7 @@ const DEFAULT_MAX_MATCH_CREDITS_30D = config.billing.affiliateMaxMatchCredits30d
 export interface AffiliateCreditMatchDeps {
   tenantId: string;
   purchaseAmount: Credit;
-  ledger: ICreditLedger;
+  ledger: ILedger;
   affiliateRepo: IAffiliateRepository;
   matchRate?: number;
   fraudRepo?: IAffiliateFraudRepository;
@@ -122,13 +122,10 @@ export async function processAffiliateCreditMatch(
   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);

package/src/monetization/affiliate/new-user-bonus.test.ts

@@ -1,5 +1,5 @@
 import type { PGlite } from "@electric-sql/pglite";
-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 type { DrizzleDb } from "../../db/index.js";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
@@ -9,7 +9,7 @@ import { DEFAULT_BONUS_RATE, grantNewUserBonus } from "./new-user-bonus.js";
 describe("grantNewUserBonus", () => {
   let pool: PGlite;
   let db: DrizzleDb;
-  let ledger: CreditLedger;
+  let ledger: DrizzleLedger;
   let affiliateRepo: DrizzleAffiliateRepository;
 
   beforeAll(async () => {
@@ -22,7 +22,9 @@ describe("grantNewUserBonus", () => {
 
   beforeEach(async () => {
     await truncateAllTables(pool);
-    ledger = new CreditLedger(db);
+    ledger = new DrizzleLedger(db);
+
+    await ledger.seedSystemAccounts();
     affiliateRepo = new DrizzleAffiliateRepository(db);
   });
 
@@ -48,7 +50,7 @@ describe("grantNewUserBonus", () => {
 
     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/src/monetization/affiliate/new-user-bonus.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 { config } from "../../config/index.js";
 import type { IAffiliateRepository } from "./drizzle-affiliate-repository.js";
@@ -7,7 +7,7 @@ import type { IAffiliateRepository } from "./drizzle-affiliate-repository.js";
 export const DEFAULT_BONUS_RATE = config.billing.affiliateNewUserBonusRate;
 
 export interface NewUserBonusParams {
-  ledger: ICreditLedger;
+  ledger: ILedger;
   affiliateRepo: IAffiliateRepository;
   referredTenantId: string;
   purchaseAmount: Credit;
@@ -57,13 +57,10 @@ export async function grantNewUserBonus(params: NewUserBonusParams): Promise<New
   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/src/monetization/credits/auto-topup-charge.test.ts

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import type { PGlite } from "@electric-sql/pglite";
 import type { ITenantCustomerRepository } from "@wopr-network/platform-core/billing";
-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 type { DrizzleDb } from "../../db/index.js";
@@ -48,7 +48,7 @@ function mockTenantStore(stripeCustomerId = "cus_123") {
 describe("chargeAutoTopup", () => {
   let pool: PGlite;
   let db: DrizzleDb;
-  let ledger: CreditLedger;
+  let ledger: DrizzleLedger;
 
   beforeAll(async () => {
     ({ db, pool } = await createTestDb());
@@ -60,7 +60,9 @@ 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 () => {
@@ -79,8 +81,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 () => {

package/src/monetization/credits/auto-topup-charge.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 { logger } from "../../config/logger.js";
 import type { IAutoTopupEventLogRepository } from "./auto-topup-event-log-repository.js";
@@ -10,7 +10,7 @@ export const MAX_CONSECUTIVE_FAILURES = 3;
 export interface AutoTopupChargeDeps {
   stripe: Stripe;
   tenantRepo: ITenantCustomerRepository;
-  creditLedger: ICreditLedger;
+  creditLedger: ILedger;
   eventLogRepo: IAutoTopupEventLogRepository;
 }
 
@@ -136,14 +136,11 @@ export async function chargeAutoTopup(
   // 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) {
     const message = `Stripe charge ${paymentIntent.id} succeeded but credit grant failed: ${err instanceof Error ? err.message : String(err)}`;

package/src/monetization/credits/auto-topup-usage.test.ts

@@ -1,5 +1,5 @@
 import type { PGlite } from "@electric-sql/pglite";
-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 type { DrizzleDb } from "../../db/index.js";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
@@ -8,7 +8,7 @@ import { maybeTriggerUsageTopup, type UsageTopupDeps } from "./auto-topup-usage.
 describe("maybeTriggerUsageTopup", () => {
   let pool: PGlite;
   let db: DrizzleDb;
-  let ledger: CreditLedger;
+  let ledger: DrizzleLedger;
   let settingsRepo: DrizzleAutoTopupSettingsRepository;
 
   beforeAll(async () => {
@@ -21,7 +21,9 @@ describe("maybeTriggerUsageTopup", () => {
 
   beforeEach(async () => {
     await truncateAllTables(pool);
-    ledger = new CreditLedger(db);
+    ledger = new DrizzleLedger(db);
+
+    await ledger.seedSystemAccounts();
     settingsRepo = new DrizzleAutoTopupSettingsRepository(db);
   });
 
@@ -35,7 +37,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -49,7 +55,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -63,7 +73,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -74,7 +88,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -89,7 +107,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
@@ -113,7 +135,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -135,7 +161,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"))
@@ -162,7 +192,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -176,7 +210,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 
@@ -208,7 +246,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: UsageTopupDeps = { settingsRepo, creditLedger: ledger, chargeAutoTopup: mockCharge };
 

package/src/monetization/credits/auto-topup-usage.ts

@@ -1,11 +1,11 @@
-import type { Credit, IAutoTopupSettingsRepository, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { Credit, IAutoTopupSettingsRepository, ILedger } from "@wopr-network/platform-core/credits";
 import { logger } from "../../config/logger.js";
 import type { AutoTopupChargeResult } from "./auto-topup-charge.js";
 import { MAX_CONSECUTIVE_FAILURES } 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/src/monetization/credits/bot-billing.test.ts

@@ -1,5 +1,5 @@
 import type { PGlite } from "@electric-sql/pglite";
-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 type { DrizzleDb } from "../../db/index.js";
@@ -57,7 +57,7 @@ describe("BotBilling", () => {
   let pool: PGlite;
   let db: DrizzleDb;
   let billing: BotBilling;
-  let ledger: CreditLedger;
+  let ledger: DrizzleLedger;
 
   beforeAll(async () => {
     ({ db, pool } = await createTestDb());
@@ -70,7 +70,9 @@ 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", () => {
@@ -211,7 +213,11 @@ describe("BotBilling", () => {
       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"]);
@@ -231,14 +237,22 @@ describe("BotBilling", () => {
       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([]);
     });

package/src/monetization/credits/bot-billing.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 { logger } from "../../config/logger.js";
 import type { IBotInstanceRepository } from "../../fleet/bot-instance-repository.js";
@@ -16,7 +16,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>;
@@ -98,7 +98,7 @@ export class DrizzleBotBilling implements IBotBilling {
    *
    * @returns IDs of reactivated bots.
    */
-  async checkReactivation(tenantId: string, ledger: ICreditLedger): Promise<string[]> {
+  async checkReactivation(tenantId: string, ledger: ILedger): Promise<string[]> {
     const balance = await ledger.balance(tenantId);
     if (balance.isNegative() || balance.isZero()) return [];