@wopr-network/platform-core 1.13.3 → 1.14.1

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([]);
         });

package/dist/monetization/credits/credit-expiry-cron.test.js

@@ -1,4 +1,4 @@
-import { Credit, DrizzleCreditLedger, runCreditExpiryCron } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger, runCreditExpiryCron } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
 describe("runCreditExpiryCron", () => {
@@ -7,13 +7,14 @@ describe("runCreditExpiryCron", () => {
     beforeAll(async () => {
         const { db, pool: p } = await createTestDb();
         pool = p;
-        ledger = new DrizzleCreditLedger(db);
+        ledger = new DrizzleLedger(db);
     });
     afterAll(async () => {
         await pool.close();
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
+        await ledger.seedSystemAccounts();
     });
     // All tests pass an explicit `now` parameter — hardcoded dates are time-independent
     // because runCreditExpiryCron never reads the system clock.
@@ -24,7 +25,11 @@ describe("runCreditExpiryCron", () => {
         expect(result.errors).toEqual([]);
     });
     it("debits expired promotional credit grant", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", "New user bonus", "promo:tenant-1", undefined, undefined, "2026-01-10T00:00:00Z");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", {
+            description: "New user bonus",
+            referenceId: "promo:tenant-1",
+            expiresAt: "2026-01-10T00:00:00Z",
+        });
         const result = await runCreditExpiryCron({ ledger, now: "2026-01-15T00:00:00Z" });
         expect(result.processed).toBe(1);
         expect(result.expired).toContain("tenant-1");
@@ -32,29 +37,41 @@ describe("runCreditExpiryCron", () => {
         expect(balance.toCents()).toBe(0);
     });
     it("does not debit non-expired credits", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", "Future bonus", "promo:tenant-1-future", undefined, undefined, "2026-02-01T00:00:00Z");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", {
+            description: "Future bonus",
+            referenceId: "promo:tenant-1-future",
+            expiresAt: "2026-02-01T00:00:00Z",
+        });
         const result = await runCreditExpiryCron({ ledger, now: "2026-01-15T00:00:00Z" });
         expect(result.processed).toBe(0);
         const balance = await ledger.balance("tenant-1");
         expect(balance.toCents()).toBe(500);
     });
     it("does not debit credits without expires_at", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "Top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", { description: "Top-up" });
         const result = await runCreditExpiryCron({ ledger, now: "2026-01-15T00:00:00Z" });
         expect(result.processed).toBe(0);
         const balance = await ledger.balance("tenant-1");
         expect(balance.toCents()).toBe(500);
     });
     it("only debits up to available balance when partially consumed", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", "Promo", "promo:partial", undefined, undefined, "2026-01-10T00:00:00Z");
-        await ledger.debit("tenant-1", Credit.fromCents(300), "bot_runtime", "Runtime");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", {
+            description: "Promo",
+            referenceId: "promo:partial",
+            expiresAt: "2026-01-10T00:00:00Z",
+        });
+        await ledger.debit("tenant-1", Credit.fromCents(300), "bot_runtime", { description: "Runtime" });
         const result = await runCreditExpiryCron({ ledger, now: "2026-01-15T00:00:00Z" });
         expect(result.processed).toBe(1);
         const balance = await ledger.balance("tenant-1");
         expect(balance.toCents()).toBe(0);
     });
     it("is idempotent -- does not double-debit on second run", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", "Promo", "promo:idemp", undefined, undefined, "2026-01-10T00:00:00Z");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "promo", {
+            description: "Promo",
+            referenceId: "promo:idemp",
+            expiresAt: "2026-01-10T00:00:00Z",
+        });
         await runCreditExpiryCron({ ledger, now: "2026-01-15T00:00:00Z" });
         const balanceAfterFirst = await ledger.balance("tenant-1");
         const result2 = await runCreditExpiryCron({ ledger, now: "2026-01-15T00:00:00Z" });

package/dist/monetization/credits/dividend-cron.d.ts

@@ -1,9 +1,7 @@
-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 { ICreditTransactionRepository } from "./credit-transaction-repository.js";
 export interface DividendCronConfig {
-    creditTransactionRepo: ICreditTransactionRepository;
-    ledger: ICreditLedger;
+    ledger: ILedger;
     /** Fraction of daily purchases matched as dividend pool. Default 1.0 (100%). */
     matchRate: number;
     /** The date to compute dividend for, as YYYY-MM-DD string. Typically yesterday. */

package/dist/monetization/credits/dividend-cron.js

@@ -21,7 +21,7 @@ export async function runDividendCron(cfg) {
     // Idempotency: check if any per-tenant dividend was already distributed for this date.
     // We look for any referenceId matching "dividend:YYYY-MM-DD:*".
     const sentinelPrefix = `dividend:${cfg.targetDate}:`;
-    const alreadyRan = await cfg.creditTransactionRepo.existsByReferenceIdLike(`${sentinelPrefix}%`);
+    const alreadyRan = await cfg.ledger.existsByReferenceIdLike(`${sentinelPrefix}%`);
     if (alreadyRan) {
         result.skippedAlreadyRun = true;
         logger.info("Dividend cron already ran for this date", { targetDate: cfg.targetDate });
@@ -30,14 +30,14 @@ export async function runDividendCron(cfg) {
     // Step 1: Sum all purchase amounts for the target date.
     const dayStart = `${cfg.targetDate} 00:00:00`;
     const dayEnd = `${cfg.targetDate} 24:00:00`;
-    const dailyPurchaseTotalCredit = await cfg.creditTransactionRepo.sumPurchasesForPeriod(dayStart, dayEnd);
+    const dailyPurchaseTotalCredit = await cfg.ledger.sumPurchasesForPeriod(dayStart, dayEnd);
     result.pool = dailyPurchaseTotalCredit.multiply(cfg.matchRate);
     // Step 2: Find all active tenants (purchased in last 7 days from target date).
     // The 7-day window is: [targetDate - 6 days 00:00:00, targetDate 24:00:00)
     // This gives a full 7-day range ending at the end of targetDate.
     const windowStart = subtractDays(cfg.targetDate, 6);
     const windowStartTs = `${windowStart} 00:00:00`;
-    const activeTenantIds = await cfg.creditTransactionRepo.getActiveTenantIdsInWindow(windowStartTs, dayEnd);
+    const activeTenantIds = await cfg.ledger.getActiveTenantIdsInWindow(windowStartTs, dayEnd);
     result.activeCount = activeTenantIds.length;
     // Step 3: Compute per-user share.
     if (result.pool.isZero() || result.activeCount <= 0) {
@@ -61,7 +61,10 @@ export async function runDividendCron(cfg) {
     for (const tenantId of activeTenantIds) {
         const perUserRef = `dividend:${cfg.targetDate}:${tenantId}`;
         try {
-            await cfg.ledger.credit(tenantId, result.perUser, "community_dividend", `Community dividend for ${cfg.targetDate}: pool ${result.pool.toCents()}c / ${result.activeCount} users`, perUserRef);
+            await cfg.ledger.credit(tenantId, result.perUser, "community_dividend", {
+                description: `Community dividend for ${cfg.targetDate}: pool ${result.pool.toCents()}c / ${result.activeCount} users`,
+                referenceId: perUserRef,
+            });
             result.distributed++;
         }
         catch (err) {

package/dist/monetization/credits/dividend-cron.test.js

@@ -1,40 +1,25 @@
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { CREDIT_TYPE_ACCOUNT, Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
-import { creditBalances, creditTransactions } from "../../db/schema/credits.js";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
-import { DrizzleCreditTransactionRepository } from "./credit-transaction-repository.js";
 import { runDividendCron } from "./dividend-cron.js";
-async function insertPurchase(db, tenantId, amountCents, createdAt) {
-    const id = `test-${tenantId}-${Date.now()}-${Math.random()}`;
+async function insertPurchase(ledger, tenantId, amountCents, postedAt) {
     const amount = Credit.fromCents(amountCents);
-    await db.insert(creditTransactions).values({
-        id,
+    await ledger.post({
+        entryType: "purchase",
         tenantId,
-        amount,
-        balanceAfter: amount,
-        type: "purchase",
-        createdAt,
+        description: `Test purchase ${amountCents}¢`,
+        referenceId: `test-purchase:${tenantId}:${postedAt}:${Math.random()}`,
+        postedAt,
+        lines: [
+            { accountCode: CREDIT_TYPE_ACCOUNT.purchase, amount, side: "debit" },
+            { accountCode: `2000:${tenantId}`, amount, side: "credit" },
+        ],
     });
-    // Upsert credit_balances
-    const existing = await db
-        .select()
-        .from(creditBalances)
-        .where((await import("drizzle-orm")).eq(creditBalances.tenantId, tenantId));
-    if (existing.length > 0) {
-        await db
-            .update(creditBalances)
-            .set({ balance: existing[0].balance.add(amount) })
-            .where((await import("drizzle-orm")).eq(creditBalances.tenantId, tenantId));
-    }
-    else {
-        await db.insert(creditBalances).values({ tenantId, balance: amount });
-    }
 }
 describe("runDividendCron", () => {
     let pool;
     let db;
     let ledger;
-    let creditTransactionRepo;
     beforeAll(async () => {
         ({ db, pool } = await createTestDb());
     });
@@ -43,12 +28,11 @@ describe("runDividendCron", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
-        creditTransactionRepo = new DrizzleCreditTransactionRepository(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
     });
     function makeConfig(overrides) {
         return {
-            creditTransactionRepo,
             ledger,
             matchRate: 1.0,
             targetDate: "2026-02-20",
@@ -56,7 +40,7 @@ describe("runDividendCron", () => {
         };
     }
     it("distributes dividend to eligible tenants", async () => {
-        await insertPurchase(db, "t1", 1000, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t1", 1000, "2026-02-20 12:00:00");
         const result = await runDividendCron(makeConfig());
         expect(result.distributed).toBe(1);
         expect(result.pool.toCents()).toBe(1000);
@@ -64,7 +48,7 @@ describe("runDividendCron", () => {
         expect(result.activeCount).toBe(1);
     });
     it("is idempotent — skips if already ran for the date", async () => {
-        await insertPurchase(db, "t1", 1000, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t1", 1000, "2026-02-20 12:00:00");
         const result1 = await runDividendCron(makeConfig());
         expect(result1.distributed).toBe(1);
         expect(result1.skippedAlreadyRun).toBe(false);
@@ -75,20 +59,19 @@ describe("runDividendCron", () => {
         expect((await ledger.balance("t1")).equals(balanceAfterFirst)).toBe(true);
     });
     it("handles floor rounding — remainder is not distributed", async () => {
-        await insertPurchase(db, "t1", 50, "2026-02-20 12:00:00");
-        await insertPurchase(db, "t2", 30, "2026-02-20 12:00:00");
-        await insertPurchase(db, "t3", 20, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t1", 50, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t2", 30, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t3", 20, "2026-02-20 12:00:00");
         const result = await runDividendCron(makeConfig());
         expect(result.pool.toCents()).toBe(100);
         expect(result.activeCount).toBe(3);
         // Nanodollar precision: floor(1_000_000_000 raw / 3) = 333_333_333 raw each
-        // Remainder = 1 nanodollar (not 1 cent — far less wasted with higher scale)
         expect(result.perUser.toRaw()).toBe(333_333_333);
         expect(result.distributed).toBe(3);
     });
     it("skips distribution when pool is zero", async () => {
         // Tenant purchased within 7 days but NOT on target date -> pool = 0
-        await insertPurchase(db, "t1", 500, "2026-02-18 12:00:00");
+        await insertPurchase(ledger, "t1", 500, "2026-02-18 12:00:00");
         const result = await runDividendCron(makeConfig());
         expect(result.pool.toCents()).toBe(0);
         expect(result.activeCount).toBe(1);
@@ -96,11 +79,9 @@ describe("runDividendCron", () => {
         expect(result.distributed).toBe(0);
     });
     it("distributes sub-cent amounts at nanodollar precision", async () => {
-        // 1 cent purchase, 3 active users: pool = 10_000_000 raw
-        // floor(10_000_000 / 3) = 3_333_333 raw each — non-zero, gets distributed
-        await insertPurchase(db, "t1", 1, "2026-02-20 12:00:00");
-        await insertPurchase(db, "t2", 500, "2026-02-18 12:00:00");
-        await insertPurchase(db, "t3", 500, "2026-02-17 12:00:00");
+        await insertPurchase(ledger, "t1", 1, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t2", 500, "2026-02-18 12:00:00");
+        await insertPurchase(ledger, "t3", 500, "2026-02-17 12:00:00");
         const result = await runDividendCron(makeConfig({ matchRate: 1.0 }));
         expect(result.pool.toCents()).toBe(1);
         expect(result.activeCount).toBe(3);
@@ -108,18 +89,17 @@ describe("runDividendCron", () => {
         expect(result.distributed).toBe(3);
     });
     it("records transactions with correct type and referenceId", async () => {
-        await insertPurchase(db, "t1", 1000, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t1", 1000, "2026-02-20 12:00:00");
         await runDividendCron(makeConfig());
         const history = await ledger.history("t1", { type: "community_dividend" });
         expect(history).toHaveLength(1);
-        expect(history[0].type).toBe("community_dividend");
+        expect(history[0].entryType).toBe("community_dividend");
         expect(history[0].referenceId).toBe("dividend:2026-02-20:t1");
-        expect(history[0].amount.toCents()).toBe(1000);
         expect(history[0].description).toContain("Community dividend");
     });
     it("collects errors without stopping distribution to other tenants", async () => {
-        await insertPurchase(db, "t1", 500, "2026-02-20 12:00:00");
-        await insertPurchase(db, "t2", 500, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t1", 500, "2026-02-20 12:00:00");
+        await insertPurchase(ledger, "t2", 500, "2026-02-20 12:00:00");
         const result = await runDividendCron(makeConfig());
         expect(result.distributed).toBe(2);
         expect(result.errors).toEqual([]);

package/dist/monetization/credits/dividend-repository.js

@@ -1,32 +1,26 @@
 import { Credit } from "@wopr-network/platform-core/credits";
 import { and, desc, eq, gte, lt, sql } from "drizzle-orm";
 import { adminUsers } from "../../db/schema/admin-users.js";
-import { creditTransactions } from "../../db/schema/credits.js";
 import { dividendDistributions } from "../../db/schema/dividend-distributions.js";
+import { journalEntries, journalLines } from "../../db/schema/ledger.js";
 export class DrizzleDividendRepository {
     db;
     constructor(db) {
         this.db = db;
     }
     async getStats(tenantId) {
-        // 1. Pool = sum of purchase amounts from yesterday UTC
+        // 1. Pool = sum of purchase credit amounts from yesterday UTC
         const poolRow = (await this.db
-            // raw SQL: Drizzle cannot express COALESCE(SUM(...), 0) aggregate
-            .select({ total: sql `COALESCE(SUM(${creditTransactions.amount}), 0)` })
-            .from(creditTransactions)
-            .where(and(eq(creditTransactions.type, "purchase"), 
-        // raw SQL: Drizzle cannot express date_trunc with interval arithmetic
-        sql `${creditTransactions.createdAt}::timestamp >= date_trunc('day', timezone('UTC', now())) - INTERVAL '1 day'`, sql `${creditTransactions.createdAt}::timestamp < date_trunc('day', timezone('UTC', now()))`)))[0];
-        const poolCents = poolRow?.total ?? 0;
-        const pool = Credit.fromCents(poolCents);
+            .select({ total: sql `COALESCE(SUM(${journalLines.amount}), 0)` })
+            .from(journalLines)
+            .innerJoin(journalEntries, eq(journalEntries.id, journalLines.journalEntryId))
+            .where(and(eq(journalEntries.entryType, "purchase"), eq(journalLines.side, "credit"), sql `${journalEntries.postedAt}::timestamp >= date_trunc('day', timezone('UTC', now())) - INTERVAL '1 day'`, sql `${journalEntries.postedAt}::timestamp < date_trunc('day', timezone('UTC', now()))`)))[0];
+        const pool = Credit.fromRaw(Number(poolRow?.total ?? 0));
         // 2. Active users = distinct tenants with a purchase in the last 7 days
         const activeRow = (await this.db
-            // raw SQL: Drizzle cannot express COUNT(DISTINCT col)
-            .select({ count: sql `COUNT(DISTINCT ${creditTransactions.tenantId})` })
-            .from(creditTransactions)
-            .where(and(eq(creditTransactions.type, "purchase"), 
-        // raw SQL: Drizzle cannot express timestamp comparison with interval arithmetic
-        sql `${creditTransactions.createdAt}::timestamp >= timezone('UTC', now()) - INTERVAL '7 days'`)))[0];
+            .select({ count: sql `COUNT(DISTINCT ${journalEntries.tenantId})` })
+            .from(journalEntries)
+            .where(and(eq(journalEntries.entryType, "purchase"), sql `${journalEntries.postedAt}::timestamp >= timezone('UTC', now()) - INTERVAL '7 days'`)))[0];
         const activeUsers = activeRow?.count ?? 0;
         // 3. Per-user projection (avoid division by zero)
         const perUser = activeUsers > 0 ? Credit.fromRaw(Math.floor(pool.toRaw() / activeUsers)) : Credit.ZERO;
@@ -36,19 +30,16 @@ export class DrizzleDividendRepository {
         const nextDistributionAt = nextMidnight.toISOString();
         // 5. User eligibility — last purchase within 7 days
         const userPurchaseRow = (await this.db
-            .select({ createdAt: creditTransactions.createdAt })
-            .from(creditTransactions)
-            .where(and(eq(creditTransactions.tenantId, tenantId), eq(creditTransactions.type, "purchase")))
-            .orderBy(desc(creditTransactions.createdAt))
+            .select({ postedAt: journalEntries.postedAt })
+            .from(journalEntries)
+            .where(and(eq(journalEntries.tenantId, tenantId), eq(journalEntries.entryType, "purchase")))
+            .orderBy(desc(journalEntries.postedAt))
             .limit(1))[0];
         let userEligible = false;
         let userLastPurchaseAt = null;
         let userWindowExpiresAt = null;
         if (userPurchaseRow) {
-            const rawTs = userPurchaseRow.createdAt;
-            // Parse the timestamp directly. PGlite may return ISO strings with or without
-            // timezone suffix. JavaScript's Date constructor handles ISO 8601 strings natively.
-            const lastPurchase = new Date(rawTs);
+            const lastPurchase = new Date(userPurchaseRow.postedAt);
             userLastPurchaseAt = lastPurchase.toISOString();
             const windowExpiry = new Date(lastPurchase.getTime() + 7 * 24 * 60 * 60 * 1000);
             userWindowExpiresAt = windowExpiry.toISOString();

package/dist/monetization/credits/dividend-repository.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 { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { adminUsers } from "../../db/schema/admin-users.js";
 import { dividendDistributions } from "../../db/schema/dividend-distributions.js";
@@ -39,6 +39,7 @@ describe("DrizzleDividendRepository", () => {
     let repo;
     beforeEach(async () => {
         await truncateAllTables(pool);
+        await new DrizzleLedger(db).seedSystemAccounts();
         repo = new DrizzleDividendRepository(db);
     });
     // --- getHistory() ---
@@ -152,8 +153,8 @@ describe("DrizzleDividendRepository", () => {
             expect(stats.nextDistributionAt).toEqual(expect.any(String));
         });
         it("marks user as eligible when they have a recent purchase", async () => {
-            const ledger = new CreditLedger(db);
-            await ledger.credit("t1", Credit.fromCents(100), "purchase", "recent buy");
+            const ledger = new DrizzleLedger(db);
+            await ledger.credit("t1", Credit.fromCents(100), "purchase", { description: "recent buy" });
             const stats = await repo.getStats("t1");
             expect(stats.userEligible).toBe(true);
             expect(stats.userLastPurchaseAt).toEqual(expect.any(String));

package/dist/monetization/credits/index.d.ts

@@ -1,5 +1,5 @@
-export type { AutoTopupSettings, CreditExpiryCronConfig, CreditExpiryCronResult, CreditTransaction, CreditType, DebitType, HistoryOptions, IAutoTopupSettingsRepository, ICreditLedger, TransactionType, } from "@wopr-network/platform-core/credits";
-export { ALLOWED_SCHEDULE_INTERVALS, ALLOWED_THRESHOLDS, ALLOWED_TOPUP_AMOUNTS, CreditLedger, computeNextScheduleAt, DrizzleAutoTopupSettingsRepository, DrizzleCreditLedger, grantSignupCredits, InsufficientBalanceError, runCreditExpiryCron, SIGNUP_GRANT, } from "@wopr-network/platform-core/credits";
+export type { AutoTopupSettings, CreditExpiryCronConfig, CreditExpiryCronResult, CreditType, DebitType, HistoryOptions, IAutoTopupSettingsRepository, ILedger, JournalEntry, TransactionType, } from "@wopr-network/platform-core/credits";
+export { ALLOWED_SCHEDULE_INTERVALS, ALLOWED_THRESHOLDS, ALLOWED_TOPUP_AMOUNTS, computeNextScheduleAt, DrizzleAutoTopupSettingsRepository, DrizzleLedger, grantSignupCredits, InsufficientBalanceError, Ledger, runCreditExpiryCron, SIGNUP_GRANT, } from "@wopr-network/platform-core/credits";
 export type { BillingState, IBotBilling } from "./bot-billing.js";
 export { BotBilling, DrizzleBotBilling, SUSPENSION_GRACE_DAYS } from "./bot-billing.js";
 export type { DividendDigestConfig, DividendDigestResult } from "./dividend-digest-cron.js";

package/dist/monetization/credits/index.js

@@ -1,4 +1,4 @@
-export { ALLOWED_SCHEDULE_INTERVALS, ALLOWED_THRESHOLDS, ALLOWED_TOPUP_AMOUNTS, CreditLedger, computeNextScheduleAt, DrizzleAutoTopupSettingsRepository, DrizzleCreditLedger, grantSignupCredits, InsufficientBalanceError, runCreditExpiryCron, SIGNUP_GRANT, } from "@wopr-network/platform-core/credits";
+export { ALLOWED_SCHEDULE_INTERVALS, ALLOWED_THRESHOLDS, ALLOWED_TOPUP_AMOUNTS, computeNextScheduleAt, DrizzleAutoTopupSettingsRepository, DrizzleLedger, grantSignupCredits, InsufficientBalanceError, Ledger, runCreditExpiryCron, SIGNUP_GRANT, } from "@wopr-network/platform-core/credits";
 export { BotBilling, DrizzleBotBilling, SUSPENSION_GRACE_DAYS } from "./bot-billing.js";
 export { runDividendDigestCron } from "./dividend-digest-cron.js";
 export { buildResourceTierCosts, DAILY_BOT_COST, runRuntimeDeductions } from "./runtime-cron.js";