@wopr-network/platform-core 1.13.3 → 1.14.1

package/src/monetization/promotions/engine.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, Promotion } from "./promotion-repository.js";
@@ -22,7 +22,7 @@ interface PromotionEngineDeps {
   promotionRepo: IPromotionRepository;
   couponRepo: ICouponRepository;
   redemptionRepo: IRedemptionRepository;
-  ledger: ICreditLedger;
+  ledger: ILedger;
 }
 
 export class PromotionEngine {
@@ -113,7 +113,10 @@ export class PromotionEngine {
     if (!granted) return null;
 
     // Grant credits
-    const tx = await ledger.credit(ctx.tenantId, grantAmount, "promo", `Promotion: ${promo.name}`, refId);
+    const tx = await ledger.credit(ctx.tenantId, grantAmount, "promo", {
+      description: `Promotion: ${promo.name}`,
+      referenceId: refId,
+    });
 
     // Record redemption
     await redemptionRepo.create({

package/src/monetization/repository-types.ts

@@ -5,7 +5,7 @@ export type {
   ITenantCustomerRepository,
   PayRamChargeRecord,
 } from "@wopr-network/platform-core/billing";
-export type { IAutoTopupSettingsRepository, ICreditLedger } from "@wopr-network/platform-core/credits";
+export type { IAutoTopupSettingsRepository, ILedger } from "@wopr-network/platform-core/credits";
 export type { IMeterAggregator, IMeterEmitter } from "@wopr-network/platform-core/metering";
 export type { FraudEvent, FraudEventInput, IAffiliateFraudRepository } from "./affiliate/affiliate-fraud-repository.js";
 export type {

package/src/monetization/stripe/stripe-payment-processor.test.ts

@@ -4,7 +4,7 @@ import type {
   IWebhookSeenRepository,
 } from "@wopr-network/platform-core/billing";
 import { PaymentMethodOwnershipError } from "@wopr-network/platform-core/billing";
-import type { CreditTransaction, ICreditLedger } from "@wopr-network/platform-core/credits";
+import type { ILedger, JournalEntry } from "@wopr-network/platform-core/credits";
 import { Credit } from "@wopr-network/platform-core/credits";
 import type Stripe from "stripe";
 import { beforeEach, describe, expect, it, vi } from "vitest";
@@ -61,7 +61,8 @@ function createMocks() {
     buildCustomerIdMap: vi.fn(),
   };
 
-  const creditLedger: ICreditLedger = {
+  const creditLedger: ILedger = {
+    post: vi.fn(),
     credit: vi.fn(),
     debit: vi.fn(),
     balance: vi.fn(),
@@ -72,6 +73,12 @@ function createMocks() {
     expiredCredits: vi.fn(),
     lifetimeSpend: vi.fn(),
     lifetimeSpendBatch: vi.fn().mockResolvedValue(new Map()),
+    trialBalance: vi.fn(),
+    accountBalance: vi.fn(),
+    seedSystemAccounts: vi.fn(),
+    existsByReferenceIdLike: vi.fn(),
+    sumPurchasesForPeriod: vi.fn(),
+    getActiveTenantIdsInWindow: vi.fn(),
   };
 
   const replayGuard: IWebhookSeenRepository = {
@@ -340,7 +347,7 @@ describe("StripePaymentProcessor", () => {
         status: "succeeded",
       } as unknown as Stripe.Response<Stripe.PaymentIntent>);
       vi.mocked(mocks.creditLedger.hasReferenceId).mockResolvedValue(false);
-      vi.mocked(mocks.creditLedger.credit).mockResolvedValue({} as unknown as CreditTransaction);
+      vi.mocked(mocks.creditLedger.credit).mockResolvedValue({} as unknown as JournalEntry);
       vi.mocked(mocks.autoTopupEventLog.writeEvent).mockResolvedValue(undefined);
 
       const result = await processor.charge({

package/src/monetization/stripe/stripe-payment-processor.ts

@@ -17,7 +17,7 @@ import {
   type SetupResult,
   type WebhookResult,
 } 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 { Credit } from "@wopr-network/platform-core/credits";
 import type Stripe from "stripe";
 import { chargeAutoTopup } from "../credits/auto-topup-charge.js";
@@ -30,7 +30,7 @@ export interface StripePaymentProcessorDeps {
   tenantRepo: ITenantCustomerRepository;
   webhookSecret: string;
   priceMap?: CreditPriceMap;
-  creditLedger: ICreditLedger;
+  creditLedger: ILedger;
   botBilling?: BotBilling;
   replayGuard: IWebhookSeenRepository;
   autoTopupEventLog?: IAutoTopupEventLogRepository;
@@ -43,7 +43,7 @@ export class StripePaymentProcessor implements IPaymentProcessor {
   private readonly tenantRepo: ITenantCustomerRepository;
   private readonly webhookSecret: string;
   private readonly priceMap: CreditPriceMap;
-  private readonly creditLedger: ICreditLedger;
+  private readonly creditLedger: ILedger;
   private readonly botBilling?: BotBilling;
   private readonly replayGuard: IWebhookSeenRepository;
   private readonly autoTopupEventLog?: IAutoTopupEventLogRepository;

package/src/monetization/stripe/webhook.test.ts

@@ -11,7 +11,7 @@ import {
   noOpReplayGuard,
   TenantCustomerRepository,
 } from "@wopr-network/platform-core/billing";
-import { Credit, CreditLedger } from "@wopr-network/platform-core/credits";
+import { Credit, DrizzleLedger } from "@wopr-network/platform-core/credits";
 import type Stripe from "stripe";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { createTestDb, truncateAllTables } from "../../test/db.js";
@@ -28,7 +28,7 @@ function makeReplayGuard() {
 
 describe("handleWebhookEvent (credit model)", () => {
   let tenantRepo: TenantCustomerRepository;
-  let creditLedger: CreditLedger;
+  let creditLedger: DrizzleLedger;
   let deps: WebhookDeps;
 
   beforeAll(async () => {
@@ -44,7 +44,9 @@ describe("handleWebhookEvent (credit model)", () => {
   beforeEach(async () => {
     await truncateAllTables(pool);
     tenantRepo = new TenantCustomerRepository(db);
-    creditLedger = new CreditLedger(db);
+    creditLedger = new DrizzleLedger(db);
+
+    await creditLedger.seedSystemAccounts();
     deps = { tenantRepo, creditLedger, replayGuard: noOpReplayGuard };
   });
 
@@ -227,7 +229,7 @@ describe("handleWebhookEvent (credit model)", () => {
       const txns = await creditLedger.history("tenant-123");
       expect(txns).toHaveLength(1);
       expect(txns[0].description).toContain("cs_test_abc");
-      expect(txns[0].type).toBe("purchase");
+      expect(txns[0].entryType).toBe("purchase");
       expect(txns[0].referenceId).toBe("cs_test_abc");
     });
 
@@ -870,7 +872,7 @@ describe("handleWebhookEvent (credit model)", () => {
       const txns = await creditLedger.history("tenant-renew-ref");
       expect(txns).toHaveLength(1);
       expect(txns[0].referenceId).toBe("in_renewal_abc");
-      expect(txns[0].type).toBe("purchase");
+      expect(txns[0].entryType).toBe("purchase");
       expect(txns[0].description).toContain("in_renewal_abc");
     });
 
@@ -913,7 +915,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("debits the credit ledger for the refunded amount", async () => {
       await tenantRepo.upsert({ tenant: "tenant-ref-1", processorCustomerId: "cus_ref_abc" });
-      await creditLedger.credit("tenant-ref-1", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-ref-1", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       const result = await handleWebhookEvent(deps, makeChargeRefundedEvent());
 
@@ -940,7 +942,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("is idempotent — skips duplicate refund for same charge ID", async () => {
       await tenantRepo.upsert({ tenant: "tenant-ref-idem", processorCustomerId: "cus_ref_idem" });
-      await creditLedger.credit("tenant-ref-idem", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-ref-idem", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       const event = makeChargeRefundedEvent({ customer: "cus_ref_idem" });
 
@@ -973,7 +975,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("handles customer object instead of string", async () => {
       await tenantRepo.upsert({ tenant: "tenant-ref-obj", processorCustomerId: "cus_ref_obj" });
-      await creditLedger.credit("tenant-ref-obj", Credit.fromCents(3000), "purchase", "seed");
+      await creditLedger.credit("tenant-ref-obj", Credit.fromCents(3000), "purchase", { description: "seed" });
 
       const result = await handleWebhookEvent(
         deps,
@@ -986,14 +988,14 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("records event ID as referenceId in the ledger transaction", async () => {
       await tenantRepo.upsert({ tenant: "tenant-ref-txn", processorCustomerId: "cus_ref_txn" });
-      await creditLedger.credit("tenant-ref-txn", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-ref-txn", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       await handleWebhookEvent(deps, makeChargeRefundedEvent({ customer: "cus_ref_txn", id: "ch_ref_txn_123" }));
 
       const txns = await creditLedger.history("tenant-ref-txn", { type: "refund" });
       expect(txns).toHaveLength(1);
       expect(txns[0].referenceId).toBe("evt_charge_ref_1");
-      expect(txns[0].type).toBe("refund");
+      expect(txns[0].entryType).toBe("refund");
       expect(txns[0].description).toContain("ch_ref_txn_123");
     });
   });
@@ -1076,7 +1078,11 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("skips credit when referenceId already exists (inline grant ran first)", async () => {
       // Simulate inline grant already happened
-      await creditLedger.credit("t1", Credit.fromCents(500), "purchase", "Auto-topup", "pi_already_granted", "stripe");
+      await creditLedger.credit("t1", Credit.fromCents(500), "purchase", {
+        description: "Auto-topup",
+        referenceId: "pi_already_granted",
+        fundingSource: "stripe",
+      });
 
       const event = {
         id: "evt_pi_success_2",
@@ -1172,7 +1178,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("freezes tenant credits and suspends bots on dispute", async () => {
       await tenantRepo.upsert({ tenant: "tenant-dispute-1", processorCustomerId: "cus_dispute_abc" });
-      await creditLedger.credit("tenant-dispute-1", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-dispute-1", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       const botBilling = {
         suspendAllForTenant: vi.fn(async () => ["bot-d1"]),
@@ -1201,7 +1207,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("is idempotent — skips duplicate debit for same dispute ID", async () => {
       await tenantRepo.upsert({ tenant: "tenant-dispute-idem", processorCustomerId: "cus_dispute_idem" });
-      await creditLedger.credit("tenant-dispute-idem", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-dispute-idem", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       const event = makeDisputeCreatedEvent("cus_dispute_idem");
 
@@ -1214,7 +1220,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("sends admin notification when notificationService is available", async () => {
       await tenantRepo.upsert({ tenant: "tenant-dispute-notify", processorCustomerId: "cus_dispute_notify" });
-      await creditLedger.credit("tenant-dispute-notify", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-dispute-notify", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       const notifyFn = vi.fn();
       const notificationService = {
@@ -1267,7 +1273,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("handles customer object (expanded) inside charge", async () => {
       await tenantRepo.upsert({ tenant: "tenant-dispute-obj", processorCustomerId: "cus_dispute_obj" });
-      await creditLedger.credit("tenant-dispute-obj", Credit.fromCents(3000), "purchase", "seed");
+      await creditLedger.credit("tenant-dispute-obj", Credit.fromCents(3000), "purchase", { description: "seed" });
 
       const result = await handleWebhookEvent(deps, makeDisputeCreatedEvent({ id: "cus_dispute_obj" }));
 
@@ -1277,7 +1283,7 @@ describe("handleWebhookEvent (credit model)", () => {
 
     it("works without botBilling (no suspension, still handled)", async () => {
       await tenantRepo.upsert({ tenant: "tenant-dispute-no-bb", processorCustomerId: "cus_dispute_no_bb" });
-      await creditLedger.credit("tenant-dispute-no-bb", Credit.fromCents(5000), "purchase", "seed");
+      await creditLedger.credit("tenant-dispute-no-bb", Credit.fromCents(5000), "purchase", { description: "seed" });
 
       const result = await handleWebhookEvent(deps, makeDisputeCreatedEvent("cus_dispute_no_bb"));
 

package/src/monetization/stripe/webhook.ts

@@ -3,7 +3,7 @@ import type {
   IWebhookSeenRepository,
   TenantCustomerRepository,
 } from "@wopr-network/platform-core/billing";
-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 { NotificationService } from "@wopr-network/platform-core/email";
 import type Stripe from "stripe";
@@ -43,7 +43,7 @@ export interface WebhookResult {
  */
 export interface WebhookDeps {
   tenantRepo: TenantCustomerRepository;
-  creditLedger: CreditLedger;
+  creditLedger: ILedger;
   /** Map of Stripe Price ID -> CreditPricePoint for bonus calculation. */
   priceMap?: CreditPriceMap;
   /** Bot billing manager for reactivation after credit purchase (WOP-447). */
@@ -62,6 +62,46 @@ export interface WebhookDeps {
   promotionEngine?: PromotionEngine;
 }
 
+/**
+ * Extract the card fingerprint from a Stripe webhook payload object.
+ * Works for PaymentIntent (via latest_charge or charges.data[0]) and
+ * Invoice (via charge) objects where the Charge is expanded.
+ * Returns undefined when the nested object is only a string ID (not expanded).
+ */
+function extractStripeFingerprint(obj: unknown): string | undefined {
+  if (!obj || typeof obj !== "object") return undefined;
+  const o = obj as Record<string, unknown>;
+
+  // PaymentIntent: pi.latest_charge expanded → Charge.payment_method_details.card.fingerprint
+  const latestCharge = o.latest_charge;
+  if (latestCharge && typeof latestCharge === "object") {
+    const pmd = (latestCharge as Record<string, unknown>).payment_method_details as Record<string, unknown> | undefined;
+    const fp = (pmd?.card as Record<string, unknown> | undefined)?.fingerprint;
+    if (typeof fp === "string") return fp;
+  }
+
+  // PaymentIntent (older API): pi.charges.data[0].payment_method_details.card.fingerprint
+  const charges = o.charges as { data?: Array<Record<string, unknown>> } | undefined;
+  const charge0 = charges?.data?.[0];
+  if (charge0) {
+    const pmd = charge0.payment_method_details as Record<string, unknown> | undefined;
+    const fp = (pmd?.card as Record<string, unknown> | undefined)?.fingerprint;
+    if (typeof fp === "string") return fp;
+  }
+
+  // Invoice: invoice.charge expanded → Charge.payment_method_details.card.fingerprint
+  const invoiceCharge = o.charge;
+  if (invoiceCharge && typeof invoiceCharge === "object") {
+    const pmd = (invoiceCharge as Record<string, unknown>).payment_method_details as
+      | Record<string, unknown>
+      | undefined;
+    const fp = (pmd?.card as Record<string, unknown> | undefined)?.fingerprint;
+    if (typeof fp === "string") return fp;
+  }
+
+  return undefined;
+}
+
 /**
  * Process a Stripe webhook event.
  *
@@ -133,14 +173,12 @@ export async function handleWebhookEvent(deps: WebhookDeps, event: Stripe.Event)
       }
 
       // Credit the ledger with session ID as reference for idempotency.
-      await deps.creditLedger.credit(
-        tenant,
-        Credit.fromCents(creditCents),
-        "purchase",
-        `Stripe credit purchase (session: ${stripeSessionId})`,
-        stripeSessionId,
-        "stripe",
-      );
+      await deps.creditLedger.credit(tenant, Credit.fromCents(creditCents), "purchase", {
+        description: `Stripe credit purchase (session: ${stripeSessionId})`,
+        referenceId: stripeSessionId,
+        fundingSource: "stripe",
+        stripeFingerprint: extractStripeFingerprint(session),
+      });
 
       // New-user first-purchase bonus for referred users (WOP-950).
       // Must run before credit match so markFirstPurchase hasn't been called yet.
@@ -292,14 +330,12 @@ export async function handleWebhookEvent(deps: WebhookDeps, event: Stripe.Event)
 
       // Fallback grant — inline path failed or process crashed before granting.
       const source = pi.metadata?.wopr_source ?? "auto_topup_webhook_fallback";
-      await deps.creditLedger.credit(
-        tenant,
-        Credit.fromCents(pi.amount),
-        "purchase",
-        `Auto-topup webhook fallback (${source})`,
-        pi.id,
-        "stripe",
-      );
+      await deps.creditLedger.credit(tenant, Credit.fromCents(pi.amount), "purchase", {
+        description: `Auto-topup webhook fallback (${source})`,
+        referenceId: pi.id,
+        fundingSource: "stripe",
+        stripeFingerprint: extractStripeFingerprint(pi),
+      });
 
       result = {
         handled: true,
@@ -379,14 +415,12 @@ export async function handleWebhookEvent(deps: WebhookDeps, event: Stripe.Event)
         break;
       }
 
-      await deps.creditLedger.credit(
-        tenant,
-        Credit.fromCents(amountPaid),
-        "purchase",
-        `Stripe subscription renewal (invoice: ${invoice.id})`,
-        invoice.id,
-        "stripe",
-      );
+      await deps.creditLedger.credit(tenant, Credit.fromCents(amountPaid), "purchase", {
+        description: `Stripe subscription renewal (invoice: ${invoice.id})`,
+        referenceId: invoice.id,
+        fundingSource: "stripe",
+        stripeFingerprint: extractStripeFingerprint(invoice),
+      });
 
       // Reactivate suspended bots now that balance is positive (WOP-447).
       let reactivatedBots: string[] | undefined;
@@ -437,14 +471,11 @@ export async function handleWebhookEvent(deps: WebhookDeps, event: Stripe.Event)
       }
 
       // Debit the ledger. Allow negative balance — refund must always succeed.
-      await deps.creditLedger.debit(
-        tenant,
-        Credit.fromCents(refundedCents),
-        "refund",
-        `Stripe refund (charge: ${charge.id})`,
-        event.id,
-        true, // allowNegative
-      );
+      await deps.creditLedger.debit(tenant, Credit.fromCents(refundedCents), "refund", {
+        description: `Stripe refund (charge: ${charge.id})`,
+        referenceId: event.id,
+        allowNegative: true,
+      });
 
       logger.warn("Charge refunded — credits debited", { tenant, customerId, chargeId: charge.id, refundedCents });
 
@@ -483,14 +514,11 @@ export async function handleWebhookEvent(deps: WebhookDeps, event: Stripe.Event)
 
       // Debit disputed amount (allow negative). Idempotent via disputeId.
       if (disputedCents > 0 && !(await deps.creditLedger.hasReferenceId(disputeId))) {
-        await deps.creditLedger.debit(
-          tenant,
-          Credit.fromCents(disputedCents),
-          "correction",
-          `Stripe dispute (dispute: ${disputeId}, reason: ${dispute.reason})`,
-          disputeId,
-          true, // allowNegative
-        );
+        await deps.creditLedger.debit(tenant, Credit.fromCents(disputedCents), "correction", {
+          description: `Stripe dispute (dispute: ${disputeId}, reason: ${dispute.reason})`,
+          referenceId: disputeId,
+          allowNegative: true,
+        });
       }
 
       // Suspend all bots (non-fatal if botBilling not provided).
@@ -554,14 +582,11 @@ export async function handleWebhookEvent(deps: WebhookDeps, event: Stripe.Event)
         // Re-credit the disputed amount. Idempotent via reversal referenceId.
         const reversalRef = `${disputeId}:reversal`;
         if (disputedCents > 0 && !(await deps.creditLedger.hasReferenceId(reversalRef))) {
-          await deps.creditLedger.credit(
-            tenant,
-            Credit.fromCents(disputedCents),
-            "correction",
-            `Stripe dispute won — credits restored (dispute: ${disputeId})`,
-            reversalRef,
-            "stripe",
-          );
+          await deps.creditLedger.credit(tenant, Credit.fromCents(disputedCents), "correction", {
+            description: `Stripe dispute won — credits restored (dispute: ${disputeId})`,
+            referenceId: reversalRef,
+            fundingSource: "stripe",
+          });
         }
 
         // Reactivate bots (non-fatal).

package/src/onboarding/onboarding-service.ts

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-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 { BudgetTier } from "../inference/budget-guard.js";
 import { checkSessionBudget } from "../inference/budget-guard.js";
@@ -30,7 +30,7 @@ export class OnboardingService {
     private readonly daemon: IDaemonManager,
     private readonly usageRepo?: ISessionUsageRepository,
     private readonly scriptRepo: IOnboardingScriptRepository = OnboardingService.DEFAULT_SCRIPT_REPO,
-    private readonly creditLedger?: ICreditLedger,
+    private readonly creditLedger?: ILedger,
     private readonly resolveTenantId?: (userId: string) => Promise<string | null>,
   ) {}
 
@@ -137,15 +137,12 @@ export class OnboardingService {
         if (costCents > 0) {
           const tenantId = await this.resolveTenantId(session.userId);
           if (tenantId) {
-            await this.creditLedger.debit(
-              tenantId,
-              Credit.fromCents(costCents),
-              "onboarding_llm",
-              `Onboarding session ${sessionId}`,
-              `onboarding-${sessionId}-${Date.now()}`,
-              true, // allowNegative — don't block onboarding mid-conversation
-              session.userId,
-            );
+            await this.creditLedger.debit(tenantId, Credit.fromCents(costCents), "onboarding_llm", {
+              description: `Onboarding session ${sessionId}`,
+              referenceId: `onboarding-${sessionId}-${Date.now()}`,
+              allowNegative: true,
+              attributedUserId: session.userId,
+            });
           }
         }
       }

package/dist/credits/credit-ledger-extra.test.js

@@ -1,40 +0,0 @@
-import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
-import { beginTestTransaction, createTestDb, endTestTransaction, rollbackTestTransaction } from "../test/db.js";
-import { Credit } from "./credit.js";
-import { CreditLedger, InsufficientBalanceError } from "./credit-ledger.js";
-let pool;
-let db;
-beforeAll(async () => {
-    ({ db, pool } = await createTestDb());
-    await beginTestTransaction(pool);
-});
-afterAll(async () => {
-    await endTestTransaction(pool);
-    await pool.close();
-});
-describe("CreditLedger concurrent debit safety", () => {
-    let ledger;
-    beforeEach(async () => {
-        await rollbackTestTransaction(pool);
-        ledger = new CreditLedger(db);
-    });
-    it("concurrent debits do not overdraw — at least one should fail with InsufficientBalanceError", async () => {
-        // Fund with exactly 100 cents
-        await ledger.credit("t1", Credit.fromCents(100), "purchase");
-        // Fire two 100-cent debits concurrently — only one can succeed
-        const results = await Promise.allSettled([
-            ledger.debit("t1", Credit.fromCents(100), "bot_runtime", "debit-1"),
-            ledger.debit("t1", Credit.fromCents(100), "bot_runtime", "debit-2"),
-        ]);
-        const fulfilled = results.filter((r) => r.status === "fulfilled");
-        const rejected = results.filter((r) => r.status === "rejected");
-        // Exactly one succeeds, one fails (PGlite serializes transactions so this is deterministic)
-        expect(fulfilled).toHaveLength(1);
-        expect(rejected).toHaveLength(1);
-        const err = rejected[0].reason;
-        expect(err).toBeInstanceOf(InsufficientBalanceError);
-        // Final balance must be exactly 0, not negative
-        const bal = await ledger.balance("t1");
-        expect(bal.toCents()).toBe(0);
-    });
-});

package/dist/credits/credit-ledger.bench.js

@@ -1,33 +0,0 @@
-import { afterAll, beforeAll, beforeEach, bench, describe } from "vitest";
-import { createTestDb, truncateAllTables } from "../test/db.js";
-import { Credit } from "./credit.js";
-import { CreditLedger } from "./credit-ledger.js";
-let db;
-let pool;
-beforeAll(async () => {
-    ({ db, pool } = await createTestDb());
-});
-afterAll(async () => {
-    await pool.close();
-});
-describe("CreditLedger throughput", () => {
-    let ledger;
-    beforeEach(async () => {
-        await truncateAllTables(pool);
-        ledger = new CreditLedger(db);
-    });
-    let creditIdx = 0;
-    let debitIdx = 0;
-    bench("credit operation", async () => {
-        const tenant = `tenant-${creditIdx++ % 100}`;
-        await ledger.credit(tenant, Credit.fromCents(100), "purchase", "bench");
-    }, { iterations: 1_000 });
-    bench("debit operation", async () => {
-        const tenant = `tenant-${debitIdx++ % 100}`;
-        await ledger.debit(tenant, Credit.fromCents(1), "adapter_usage", "bench");
-    }, { iterations: 1_000 });
-    bench("balance query", async () => {
-        const tenant = `tenant-${debitIdx++ % 100}`;
-        await ledger.balance(tenant);
-    }, { iterations: 5_000 });
-});

package/dist/credits/credit-ledger.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * Tests for CreditLedger — including the allowNegative debit parameter (WOP-821).
- */
-export {};