multivendor-wallet

Framework-agnostic wallet ledger engine for multi-vendor marketplaces.

Changelog

0.0.7

• onOrderPaid customer debit is capped at orderTotalRupees when walletAmountRupees over-reports.

0.0.6

• Customer checkout debit uses canonical key wallet:order:{orderId}:customer_debit and metadata.purpose=customer_checkout_debit. A second debit for the same order is a no-op (lock-then-lookup + unique generated column).
• Unique-index migration AddOrderCustomerDebitUnique throws before DDL unless backfill sentinel customer_checkout_debit_backfill is complete and unreimbursed twin COUNT is 0. Run npm run wallet:credit-duplicate-order-debits on the host before migrate.
• Ledger created_date is written as server-local wall clock (not UTC toISOString()). Existing UTC-naive rows stay as stored.
• onDuplicateOrderDebit plugin callback for idempotent retry vs cross-key collision.

Operations

• credit / debit — adjust available balance (integer minor units / paise)
• hold / release / cancelHold — escrow lifecycle
• transfer — atomic debit + credit
• getBalance — { available, held, total } where total = available + held

Host integration

Implement IWalletStore with your persistence layer (TypeORM adapter ships in Myownbazaar_server). Pass { nativeTx: entityManager } to join an existing database transaction.

Publish

pnpm run build && pnpm run test
# tag: wallet-v0.0.1