@wopr-network/platform-core 1.13.3 → 1.14.1

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

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. */