@wopr-network/platform-core 1.13.2 → 1.14.0

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

@@ -1,4 +1,4 @@
-import { Credit, CreditLedger, InsufficientBalanceError } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger, InsufficientBalanceError } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { RESOURCE_TIERS } from "../../fleet/resource-tiers.js";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
@@ -10,13 +10,14 @@ describe("runRuntimeDeductions", () => {
     beforeAll(async () => {
         const { db, pool: p } = await createTestDb();
         pool = p;
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
     });
     afterAll(async () => {
         await pool.close();
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
+        await ledger.seedSystemAccounts();
     });
     it("DAILY_BOT_COST equals 17 cents", () => {
         expect(DAILY_BOT_COST.toCents()).toBe(17);
@@ -32,7 +33,7 @@ describe("runRuntimeDeductions", () => {
         expect(result.errors).toEqual([]);
     });
     it("skips tenants with zero active bots", 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 runRuntimeDeductions({
             ledger,
             date: TODAY,
@@ -42,7 +43,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(500);
     });
     it("deducts full amount when balance is sufficient", 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 runRuntimeDeductions({
             ledger,
             date: TODAY,
@@ -53,7 +54,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(500 - 2 * 17);
     });
     it("partial deduction and suspension when balance is insufficient", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(10), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(10), "purchase", { description: "top-up" });
         const onSuspend = vi.fn();
         const result = await runRuntimeDeductions({
             ledger,
@@ -67,9 +68,9 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(0);
     });
     it("suspends with zero partial when balance exactly zero", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(100), "purchase", "top-up");
-        await ledger.debit("tenant-1", Credit.fromCents(100), "bot_runtime", "drain");
-        await ledger.credit("tenant-1", Credit.fromCents(1), "purchase", "tiny");
+        await ledger.credit("tenant-1", Credit.fromCents(100), "purchase", { description: "top-up" });
+        await ledger.debit("tenant-1", Credit.fromCents(100), "bot_runtime", { description: "drain" });
+        await ledger.credit("tenant-1", Credit.fromCents(1), "purchase", { description: "tiny" });
         const onSuspend = vi.fn();
         const result = await runRuntimeDeductions({
             ledger,
@@ -82,7 +83,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(0);
     });
     it("suspends without onSuspend callback", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(5), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(5), "purchase", { description: "top-up" });
         const result = await runRuntimeDeductions({
             ledger,
             date: TODAY,
@@ -92,7 +93,7 @@ describe("runRuntimeDeductions", () => {
         expect(result.processed).toBe(1);
     });
     it("handles errors from getActiveBotCount gracefully", 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 runRuntimeDeductions({
             ledger,
             date: TODAY,
@@ -105,8 +106,8 @@ describe("runRuntimeDeductions", () => {
         expect(result.errors[0]).toContain("db connection failed");
     });
     it("handles InsufficientBalanceError from ledger.debit", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "top-up");
-        await ledger.debit("tenant-1", Credit.fromCents(499), "bot_runtime", "drain");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", { description: "top-up" });
+        await ledger.debit("tenant-1", Credit.fromCents(499), "bot_runtime", { description: "drain" });
         const onSuspend = vi.fn();
         const result = await runRuntimeDeductions({
             ledger,
@@ -118,7 +119,7 @@ describe("runRuntimeDeductions", () => {
         expect(onSuspend).toHaveBeenCalledWith("tenant-1");
     });
     it("catches InsufficientBalanceError from debit and suspends", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", { description: "top-up" });
         vi.spyOn(ledger, "debit").mockRejectedValue(new InsufficientBalanceError(Credit.fromCents(0), Credit.fromCents(17)));
         const onSuspend = vi.fn();
         const result = await runRuntimeDeductions({
@@ -133,7 +134,7 @@ describe("runRuntimeDeductions", () => {
         vi.restoreAllMocks();
     });
     it("catches InsufficientBalanceError without onSuspend callback", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", { description: "top-up" });
         vi.spyOn(ledger, "debit").mockRejectedValue(new InsufficientBalanceError(Credit.fromCents(0), Credit.fromCents(17)));
         const result = await runRuntimeDeductions({
             ledger,
@@ -145,8 +146,8 @@ describe("runRuntimeDeductions", () => {
         vi.restoreAllMocks();
     });
     it("processes multiple tenants", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", "top-up");
-        await ledger.credit("tenant-2", Credit.fromCents(10), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", { description: "top-up" });
+        await ledger.credit("tenant-2", Credit.fromCents(10), "purchase", { description: "top-up" });
         const onSuspend = vi.fn();
         const result = await runRuntimeDeductions({
             ledger,
@@ -159,7 +160,7 @@ describe("runRuntimeDeductions", () => {
         expect(result.suspended).not.toContain("tenant-1");
     });
     it("fires onLowBalance when balance drops below 100 cents threshold", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(110), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(110), "purchase", { description: "top-up" });
         const onLowBalance = vi.fn();
         await runRuntimeDeductions({
             ledger,
@@ -173,7 +174,7 @@ describe("runRuntimeDeductions", () => {
         expect(calledBalance.toCents()).toBe(93);
     });
     it("does NOT fire onLowBalance when balance was already below threshold before deduction", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(90), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(90), "purchase", { description: "top-up" });
         const onLowBalance = vi.fn();
         await runRuntimeDeductions({
             ledger,
@@ -184,7 +185,7 @@ describe("runRuntimeDeductions", () => {
         expect(onLowBalance).not.toHaveBeenCalled();
     });
     it("fires onCreditsExhausted when full deduction causes balance to drop to 0", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", { description: "top-up" });
         const onCreditsExhausted = vi.fn();
         await runRuntimeDeductions({
             ledger,
@@ -197,7 +198,7 @@ describe("runRuntimeDeductions", () => {
     });
     it("suspends tenant when full deduction causes balance to drop to exactly 0", async () => {
         // Balance = exactly 1 bot * DAILY_BOT_COST = 17 cents → full deduction → 0
-        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", { description: "top-up" });
         const onSuspend = vi.fn();
         const onCreditsExhausted = vi.fn();
         const result = await runRuntimeDeductions({
@@ -213,7 +214,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(0);
     });
     it("fires onCreditsExhausted on partial deduction when balance hits 0", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(10), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(10), "purchase", { description: "top-up" });
         const onCreditsExhausted = vi.fn();
         await runRuntimeDeductions({
             ledger,
@@ -225,7 +226,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(0);
     });
     it("partially debits resource tier surcharge when balance is positive but insufficient", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(30), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(30), "purchase", { description: "top-up" });
         const result = await runRuntimeDeductions({
             ledger,
             date: TODAY,
@@ -236,7 +237,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(0);
     });
     it("skips resource tier partial debit when balance is exactly 0 after runtime", async () => {
-        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", { description: "top-up" });
         const onCreditsExhausted = vi.fn();
         const result = await runRuntimeDeductions({
             ledger,
@@ -254,7 +255,7 @@ describe("runRuntimeDeductions", () => {
         // triggering the zero-crossing suspend in the runtime block.
         // Storage cost (5 cents) then tries to suspend again via its else-branch (balance 0 < 5).
         // The !result.suspended.includes(tenantId) guard must prevent onSuspend being called twice.
-        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(17), "purchase", { description: "top-up" });
         const onSuspend = vi.fn();
         const result = await runRuntimeDeductions({
             ledger,
@@ -270,7 +271,7 @@ describe("runRuntimeDeductions", () => {
     it("buildResourceTierCosts: deducts pro tier surcharge via getResourceTierCosts", async () => {
         const proTierCost = RESOURCE_TIERS.pro.dailyCost.toCents();
         const startBalance = 17 + proTierCost + 10;
-        await ledger.credit("tenant-1", Credit.fromCents(startBalance), "purchase", "top-up");
+        await ledger.credit("tenant-1", Credit.fromCents(startBalance), "purchase", { description: "top-up" });
         const mockRepo = {
             getResourceTier: async (_botId) => "pro",
         };
@@ -285,7 +286,7 @@ describe("runRuntimeDeductions", () => {
         expect((await ledger.balance("tenant-1")).toCents()).toBe(expected);
     });
     it("treats unique constraint violation from concurrent debit as already-billed (skip, not error)", 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 uniqueErr = Object.assign(new Error("duplicate key value violates unique constraint"), { code: "23505" });
         vi.spyOn(ledger, "debit").mockRejectedValueOnce(uniqueErr);
         const result = await runRuntimeDeductions({
@@ -298,7 +299,7 @@ describe("runRuntimeDeductions", () => {
         vi.restoreAllMocks();
     });
     it("is idempotent — second run on same date does not double-deduct", 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 cfg = {
             ledger,
             getActiveBotCount: async () => 1,

package/dist/monetization/credits/runtime-scheduler.d.ts

@@ -1,8 +1,8 @@
-import type { ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { ILedger } from "@wopr-network/platform-core/credits";
 import type { IBotInstanceRepository } from "../../fleet/bot-instance-repository.js";
 import type { ITenantAddonRepository } from "../addons/addon-repository.js";
 export interface RuntimeSchedulerDeps {
-    ledger: ICreditLedger;
+    ledger: ILedger;
     botInstanceRepo: IBotInstanceRepository;
     tenantAddonRepo: ITenantAddonRepository;
     onSuspend?: (tenantId: string) => void;

package/dist/monetization/credits/runtime-scheduler.test.js

@@ -1,6 +1,6 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { RUNTIME_INTERVAL_MS, startRuntimeScheduler } from "./runtime-scheduler.js";
-// Minimal ICreditLedger stub — only the methods runRuntimeDeductions calls.
+// Minimal ILedger stub — only the methods runRuntimeDeductions calls.
 function makeLedger() {
     return {
         tenantsWithBalance: vi.fn().mockResolvedValue([]),

package/dist/monetization/credits/signup-grant.test.js

@@ -1,4 +1,4 @@
-import { CreditLedger, grantSignupCredits, SIGNUP_GRANT } from "@wopr-network/platform-core/credits";
+import { DrizzleLedger, grantSignupCredits, SIGNUP_GRANT } from "@wopr-network/platform-core/credits";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
 describe("grantSignupCredits", () => {
@@ -13,7 +13,8 @@ describe("grantSignupCredits", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
     });
     it("grants credits to a new tenant and returns true", async () => {
         const result = await grantSignupCredits(ledger, "tenant-1");
@@ -41,7 +42,8 @@ describe("grantSignupCredits", () => {
         const uniqueErr = Object.assign(new Error("duplicate key value violates unique constraint"), {
             code: "23505",
         });
-        const racingLedger = new CreditLedger(db);
+        const racingLedger = new DrizzleLedger(db);
+        await racingLedger.seedSystemAccounts();
         vi.spyOn(racingLedger, "hasReferenceId").mockResolvedValue(false);
         vi.spyOn(racingLedger, "credit").mockRejectedValue(uniqueErr);
         const result = await grantSignupCredits(racingLedger, "tenant-race");

package/dist/monetization/credits/storage-tier-cron.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 { runRuntimeDeductions } from "./runtime-cron.js";
@@ -15,7 +15,8 @@ describe("runtime cron with storage tiers", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
+        ledger = new DrizzleLedger(db);
+        await ledger.seedSystemAccounts();
     });
     it("debits base cost plus storage surcharge for pro tier", async () => {
         await ledger.credit("t1", Credit.fromCents(1000), "purchase");

package/dist/monetization/credits/trial-balance-cron.test.js

@@ -0,0 +1,42 @@
+import { Credit, DrizzleLedger, runTrialBalanceCron } from "@wopr-network/platform-core/credits";
+import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { createTestDb, truncateAllTables } from "../../test/db.js";
+describe("runTrialBalanceCron", () => {
+    let pool;
+    let ledger;
+    beforeAll(async () => {
+        const { db, pool: p } = await createTestDb();
+        pool = p;
+        ledger = new DrizzleLedger(db);
+    });
+    afterAll(async () => {
+        await pool.close();
+    });
+    beforeEach(async () => {
+        await truncateAllTables(pool);
+        await ledger.seedSystemAccounts();
+    });
+    it("returns balanced when no entries exist", async () => {
+        const result = await runTrialBalanceCron({ ledger });
+        expect(result.balanced).toBe(true);
+        expect(result.differenceRaw).toBe(0);
+    });
+    it("returns balanced after normal credit and debit", async () => {
+        await ledger.credit("t1", Credit.fromCents(500), "purchase");
+        await ledger.debit("t1", Credit.fromCents(200), "bot_runtime");
+        const result = await runTrialBalanceCron({ ledger });
+        expect(result.balanced).toBe(true);
+        expect(result.differenceRaw).toBe(0);
+    });
+    it("logs an error on imbalance without throwing", async () => {
+        vi.spyOn(ledger, "trialBalance").mockResolvedValueOnce({
+            totalDebits: Credit.fromCents(1000),
+            totalCredits: Credit.fromCents(900),
+            balanced: false,
+            difference: Credit.fromCents(100),
+        });
+        const result = await runTrialBalanceCron({ ledger });
+        expect(result.balanced).toBe(false);
+        expect(result.differenceRaw).toBe(Credit.fromCents(100).toRaw());
+    });
+});

package/dist/monetization/feature-gate.d.ts

@@ -1,4 +1,4 @@
-import type { CreditLedger } 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 { Context, Next } from "hono";
 /**
@@ -37,7 +37,7 @@ export declare function createFeatureGate(cfg: FeatureGateConfig): {
 /**
  * Convenience factory that creates a requireBalance middleware from a CreditLedger instance.
  */
-export declare function createBalanceGate(ledger: CreditLedger, userKey?: string, userIdField?: string): {
+export declare function createBalanceGate(ledger: ILedger, userKey?: string, userIdField?: string): {
     requireBalance: (minBalance?: Credit) => (c: Context, next: Next) => Promise<void | (Response & import("hono").TypedResponse<{
         error: string;
     }, 401, "json">) | (Response & import("hono").TypedResponse<{
@@ -54,7 +54,7 @@ export declare function createBalanceGate(ledger: CreditLedger, userKey?: string
 export type ResolveTenantId = (c: Context) => string | undefined | Promise<string | undefined>;
 export interface CreditGateConfig {
     /** CreditLedger instance used to check balance. */
-    ledger: CreditLedger;
+    ledger: ILedger;
     /** Resolve the tenant ID from the request context. */
     resolveTenantId: ResolveTenantId;
 }

package/dist/monetization/index.d.ts

@@ -39,8 +39,8 @@ export { type AdapterCapability, type AdapterResult, type EmbeddingsInput, type
 export { type ArbitrageRequest, ArbitrageRouter, type ArbitrageRouterConfig, type MarginRecord, type ModelProviderEntry, NoProviderAvailableError, ProviderRegistry, type ProviderRegistryConfig, type RoutingDecision, } from "./arbitrage/index.js";
 export type { BudgetCheckerConfig, BudgetCheckResult, SpendLimits } from "./budget/index.js";
 export { BudgetChecker, DrizzleBudgetChecker } from "./budget/index.js";
-export type { BillingState, CreditTransaction, CreditType, DebitType, GetActiveBotCount, HistoryOptions, OnSuspend, RuntimeCronConfig, RuntimeCronResult, TransactionType, } from "./credits/index.js";
-export { BotBilling, buildResourceTierCosts, CreditLedger, DAILY_BOT_COST, DrizzleBotBilling, DrizzleCreditLedger, grantSignupCredits, InsufficientBalanceError, runRuntimeDeductions, SIGNUP_GRANT, SUSPENSION_GRACE_DAYS, } from "./credits/index.js";
+export type { BillingState, CreditType, DebitType, GetActiveBotCount, HistoryOptions, ILedger, JournalEntry, OnSuspend, RuntimeCronConfig, RuntimeCronResult, TransactionType, } from "./credits/index.js";
+export { BotBilling, buildResourceTierCosts, DAILY_BOT_COST, DrizzleBotBilling, DrizzleLedger, grantSignupCredits, InsufficientBalanceError, Ledger, runRuntimeDeductions, SIGNUP_GRANT, SUSPENSION_GRACE_DAYS, } from "./credits/index.js";
 export { type CreditGateConfig, createBalanceGate, createCreditGate, createFeatureGate, type FeatureGateConfig, type GetUserBalance, type ResolveTenantId, } from "./feature-gate.js";
 export type { BillingPeriod, BillingPeriodSummary, MeterEventRow, UsageSummary, } from "./metering/index.js";
 export { DrizzleMeterAggregator, DrizzleMeterEmitter, MeterAggregator, MeterEmitter, } from "./metering/index.js";
@@ -48,7 +48,7 @@ export type { PayRamBillingConfig, PayRamCheckoutOpts, PayRamConfig, PayRamPayme
 export { createPayRamCheckout, createPayRamClient, DrizzlePayRamChargeRepository, handlePayRamWebhook, loadPayRamConfig, MIN_PAYMENT_USD, PayRamChargeRepository, } from "./payram/index.js";
 export { checkInstanceQuota, DEFAULT_INSTANCE_LIMITS, type InstanceLimits, type QuotaCheckResult, } from "./quotas/quota-check.js";
 export { buildResourceLimits, type ContainerResourceLimits, DEFAULT_RESOURCE_CONFIG, type ResourceConfig, } from "./quotas/resource-limits.js";
-export type { IBotBilling, IBudgetChecker, ICreditLedger, IMeterAggregator, IMeterEmitter, IPayRamChargeRepository, ITenantCustomerRepository, PayRamChargeRecord, } from "./repository-types.js";
+export type { IBotBilling, IBudgetChecker, IMeterAggregator, IMeterEmitter, IPayRamChargeRepository, ITenantCustomerRepository, PayRamChargeRecord, } from "./repository-types.js";
 export { AdapterSocket, type SocketConfig, type SocketRequest } from "./socket/socket.js";
 export type { CreditCheckoutOpts, CreditPriceMap, CreditPricePoint, PortalSessionOpts, StripeBillingConfig, TenantCustomerRow, WebhookDeps, WebhookResult, } from "./stripe/index.js";
 export { CREDIT_PRICE_POINTS, createCreditCheckoutSession, createPortalSession, createStripeClient, DrizzleTenantCustomerRepository, getConfiguredPriceIds, getCreditAmountForPurchase, handleWebhookEvent, loadCreditPriceMap, loadStripeConfig, lookupCreditPrice, TenantCustomerRepository, } from "./stripe/index.js";

package/dist/monetization/index.js

@@ -49,7 +49,7 @@ export { withMargin, } from "./adapters/types.js";
 // Arbitrage router — multi-provider routing for maximum margin (WOP-463)
 export { ArbitrageRouter, NoProviderAvailableError, ProviderRegistry, } from "./arbitrage/index.js";
 export { BudgetChecker, DrizzleBudgetChecker } from "./budget/index.js";
-export { BotBilling, buildResourceTierCosts, CreditLedger, DAILY_BOT_COST, DrizzleBotBilling, DrizzleCreditLedger, grantSignupCredits, InsufficientBalanceError, runRuntimeDeductions, SIGNUP_GRANT, SUSPENSION_GRACE_DAYS, } from "./credits/index.js";
+export { BotBilling, buildResourceTierCosts, DAILY_BOT_COST, DrizzleBotBilling, DrizzleLedger, grantSignupCredits, InsufficientBalanceError, Ledger, runRuntimeDeductions, SIGNUP_GRANT, SUSPENSION_GRACE_DAYS, } from "./credits/index.js";
 // Feature gating middleware (WOP-384 — replaced tier gates with balance gates)
 export { createBalanceGate, createCreditGate, createFeatureGate, } from "./feature-gate.js";
 export { DrizzleMeterAggregator, DrizzleMeterEmitter, MeterAggregator, MeterEmitter, } from "./metering/index.js";

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

package/dist/monetization/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,20 @@ 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).
         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/monetization/metering/reconciliation-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 { createTestDb, seedUsageSummary, truncateAllTables } from "../../test/db.js";
 import { DrizzleAdapterUsageRepository, DrizzleUsageSummaryRepository } from "./reconciliation-repository.js";
@@ -107,7 +107,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);
@@ -120,9 +121,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`;
@@ -136,8 +137,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();
@@ -147,7 +148,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/payram/webhook.d.ts

@@ -1,9 +1,9 @@
 import type { IWebhookSeenRepository, PayRamChargeRepository, PayRamWebhookPayload, PayRamWebhookResult } from "@wopr-network/platform-core/billing";
-import type { ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { ILedger } from "@wopr-network/platform-core/credits";
 import type { BotBilling } from "../credits/bot-billing.js";
 export interface PayRamWebhookDeps {
     chargeStore: PayRamChargeRepository;
-    creditLedger: ICreditLedger;
+    creditLedger: ILedger;
     botBilling?: BotBilling;
     replayGuard: IWebhookSeenRepository;
 }

package/dist/monetization/payram/webhook.js

@@ -36,7 +36,11 @@ export async function handlePayRamWebhook(deps, payload) {
             // For OVER_FILLED, we still credit the requested amount — the
             // overpayment stays in the PayRam wallet as a buffer.
             const creditCents = charge.amountUsdCents;
-            await creditLedger.credit(charge.tenantId, Credit.fromCents(creditCents), "purchase", `Crypto credit purchase via PayRam (ref: ${payload.reference_id}, ${payload.currency ?? "crypto"})`, `payram:${payload.reference_id}`, "payram");
+            await creditLedger.credit(charge.tenantId, Credit.fromCents(creditCents), "purchase", {
+                description: `Crypto credit purchase via PayRam (ref: ${payload.reference_id}, ${payload.currency ?? "crypto"})`,
+                referenceId: `payram:${payload.reference_id}`,
+                fundingSource: "payram",
+            });
             await chargeStore.markCredited(payload.reference_id);
             // Reactivate suspended bots (same as Stripe webhook, WOP-447).
             let reactivatedBots;

package/dist/monetization/payram/webhook.test.js

@@ -5,7 +5,7 @@
  * no-op status, idempotency, replay guard, and bot reactivation.
  */
 import { DrizzleWebhookSeenRepository, noOpReplayGuard, PayRamChargeRepository, } from "@wopr-network/platform-core/billing";
-import { CreditLedger } from "@wopr-network/platform-core/credits";
+import { 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 { handlePayRamWebhook } from "./webhook.js";
@@ -35,7 +35,8 @@ describe("handlePayRamWebhook", () => {
     beforeEach(async () => {
         await truncateAllTables(pool);
         chargeStore = new PayRamChargeRepository(db);
-        creditLedger = new CreditLedger(db);
+        creditLedger = new DrizzleLedger(db);
+        await creditLedger.seedSystemAccounts();
         deps = { chargeStore, creditLedger, replayGuard: noOpReplayGuard };
         // Create a default test charge
         await chargeStore.create("ref-test-001", "tenant-a", 2500);
@@ -58,12 +59,12 @@ describe("handlePayRamWebhook", () => {
             const history = await creditLedger.history("tenant-a");
             expect(history).toHaveLength(1);
             expect(history[0].referenceId).toBe("payram:ref-test-001");
-            expect(history[0].type).toBe("purchase");
+            expect(history[0].entryType).toBe("purchase");
         });
         it("records fundingSource as payram", async () => {
             await handlePayRamWebhook(deps, makePayload({ status: "FILLED" }));
             const history = await creditLedger.history("tenant-a");
-            expect(history[0].fundingSource).toBe("payram");
+            expect(history[0].metadata?.fundingSource).toBe("payram");
         });
         it("marks the charge as credited after FILLED", async () => {
             await handlePayRamWebhook(deps, makePayload({ status: "FILLED" }));

package/dist/monetization/promotions/engine.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 { ICouponRepository } from "./coupon-repository.js";
 import type { IPromotionRepository } from "./promotion-repository.js";
@@ -19,7 +19,7 @@ interface PromotionEngineDeps {
     promotionRepo: IPromotionRepository;
     couponRepo: ICouponRepository;
     redemptionRepo: IRedemptionRepository;
-    ledger: ICreditLedger;
+    ledger: ILedger;
 }
 export declare class PromotionEngine {
     #private;