multivendor-wallet 0.0.4 → 0.0.6

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { e as WalletPluginConfig, f as WalletPlugin, I as IWalletPaymentProvider } from './types-D46FcrKZ.mjs';
-export { D as DeliveredContext, O as OrderPaidContext, P as PaymentProviderWallet, R as RefundContext, S as SettlementDebitContext, g as WALLET_PLUGIN_TOKEN, h as WalletAdminMutationEvent, i as WalletConfig, C as WalletCreatePaymentInput, j as WalletFeatureFlags, k as WalletHttpConfig, l as WalletLedgerClient, W as WalletLifecycleHooks, b as WalletOrderPaidLine, m as WalletReconciliationConfig } from './types-D46FcrKZ.mjs';
-import { W as WalletAccountType } from './store-By30oqos.mjs';
-export { B as BalanceDeltas, d as CancelHoldParams, C as CreditParams, D as DebitParams, G as GetTransactionsParams, H as HoldParams, f as HoldStatus, I as IWalletStore, g as IWalletStoreTx, h as LedgerEntryType, L as LedgerMutationResult, R as ReleaseParams, T as TransferParams, b as WalletAccount, c as WalletBalance, i as WalletHold, e as WalletLedgerEntry, j as WalletReference, a as WalletStoreContext } from './store-By30oqos.mjs';
-export { CreateWalletTables1790000000000, TypeOrmWalletStore, WalletAccountEntity, WalletHoldEntity, WalletLedgerEntryEntity, getWalletOrmMetadata } from './typeorm/index.mjs';
+import { e as WalletPluginConfig, f as WalletPlugin, I as IWalletPaymentProvider } from './types-D1Q4XCwx.mjs';
+export { D as DeliveredContext, O as OrderPaidContext, P as PaymentProviderWallet, R as RefundContext, S as SettlementDebitContext, g as WALLET_PLUGIN_TOKEN, h as WalletAdminMutationEvent, i as WalletConfig, C as WalletCreatePaymentInput, j as WalletDuplicateOrderDebitInfo, k as WalletDuplicateOrderDebitKind, l as WalletFeatureFlags, m as WalletHttpConfig, n as WalletLedgerClient, W as WalletLifecycleHooks, b as WalletOrderPaidLine, o as WalletReconciliationConfig } from './types-D1Q4XCwx.mjs';
+import { W as WalletAccountType } from './store-nWCfzvwf.mjs';
+export { B as BalanceDeltas, d as CancelHoldParams, C as CreditParams, D as DebitParams, G as GetTransactionsParams, H as HoldParams, f as HoldStatus, I as IWalletStore, g as IWalletStoreTx, h as LedgerEntryType, L as LedgerMutationResult, R as ReleaseParams, T as TransferParams, b as WalletAccount, c as WalletBalance, i as WalletHold, e as WalletLedgerEntry, j as WalletReference, a as WalletStoreContext } from './store-nWCfzvwf.mjs';
+export { AddOrderCustomerDebitUnique1790000001000, CreateWalletTables1790000000000, TypeOrmWalletStore, WalletAccountEntity, WalletHoldEntity, WalletLedgerEntryEntity, getWalletOrmMetadata } from './typeorm/index.mjs';
 import { Router } from 'express';
 import 'typeorm';
 
@@ -39,6 +39,41 @@ declare function registerWalletPlugin(config: WalletPluginConfig): WalletPlugin;
 
 declare function createWalletPaymentAdapter(plugin: WalletPlugin): IWalletPaymentProvider;
 
+/** Server-local wall clock `YYYY-MM-DD HH:mm:ss` (matches host order paidDate, not UTC ISO). */
+declare function nowTimestamp(date?: Date): string;
+/** Parse naive datetime as local wall clock (do not treat as UTC). */
+declare function parseLedgerDate(value: string | Date): Date;
+
+declare const CUSTOMER_CHECKOUT_DEBIT_PURPOSE = "customer_checkout_debit";
+declare const CUSTOMER_CHECKOUT_DEBIT_REVERSAL_PURPOSE = "customer_checkout_debit_reversal";
+declare const BACKFILL_SENTINEL_KEY = "customer_checkout_debit_backfill";
+declare const WALLET_OPS_TABLE = "wallet_ops";
+declare function orderCustomerDebitIdempotencyKey(orderId: number | string): string;
+declare function paymentReversalIdempotencyKey(paymentNumber: string): string;
+declare function paymentNumberFromWalletPaymentKey(idempotencyKey: string): string | null;
+/**
+ * True when this debit is a customer checkout (product-amount) debit for an order.
+ * Settlement/vendor/affiliate debits must not use these keys or purpose.
+ */
+declare function isCustomerCheckoutDebit(params: {
+    idempotencyKey: string;
+    referenceType?: string;
+    purpose?: unknown;
+}): boolean;
+/**
+ * Legacy keys accepted during rollout only.
+ * Sunset: `npm run wallet:legacy-order-debit-sunset` — drop this helper when LEGACY_ORDER_DEBIT_SUNSET_SQL returns 0 on prod.
+ */
+declare function isLegacyCustomerCheckoutDebitKey(key: string): boolean;
+/** Unreimbursed full/split + wallet:payment twins (duplicate customer checkout debits). */
+declare const UNREIMBURSED_TWIN_COUNT_SQL = "\nSELECT COUNT(*) AS c\nFROM wallet_ledger_entry f\nJOIN wallet_ledger_entry p\n  ON p.account_id = f.account_id\n AND p.reference_type = 'order'\n AND p.reference_id = f.reference_id\n AND p.entry_type = 'debit'\n AND p.idempotency_key LIKE 'wallet:payment:%'\nWHERE f.entry_type = 'debit'\n  AND f.reference_type = 'order'\n  AND (\n    f.idempotency_key LIKE 'wallet:full:%'\n    OR f.idempotency_key LIKE 'wallet:split:%'\n  )\n  AND NOT EXISTS (\n    SELECT 1 FROM wallet_ledger_entry r\n    WHERE r.entry_type = 'credit'\n      AND r.account_id = p.account_id\n      AND r.reference_type = 'order'\n      AND r.reference_id = p.reference_id\n      AND (\n        r.idempotency_key = CONCAT('wallet:payment-reversal:', SUBSTRING(p.idempotency_key, 17))\n        OR JSON_UNQUOTE(JSON_EXTRACT(r.metadata, '$.purpose')) = 'customer_checkout_debit_reversal'\n      )\n  )\n";
+declare const UNREIMBURSED_TWIN_DETAIL_SQL = "\nSELECT\n  f.reference_id AS order_id,\n  f.account_id,\n  f.amount AS first_paise,\n  p.amount AS second_paise,\n  f.idempotency_key AS kept_key,\n  p.idempotency_key AS duplicate_key,\n  f.created_date AS first_at,\n  p.created_date AS duplicate_at,\n  f.id AS kept_id,\n  p.id AS duplicate_id\nFROM wallet_ledger_entry f\nJOIN wallet_ledger_entry p\n  ON p.account_id = f.account_id\n AND p.reference_type = 'order'\n AND p.reference_id = f.reference_id\n AND p.entry_type = 'debit'\n AND p.idempotency_key LIKE 'wallet:payment:%'\nWHERE f.entry_type = 'debit'\n  AND f.reference_type = 'order'\n  AND (\n    f.idempotency_key LIKE 'wallet:full:%'\n    OR f.idempotency_key LIKE 'wallet:split:%'\n  )\n  AND NOT EXISTS (\n    SELECT 1 FROM wallet_ledger_entry r\n    WHERE r.entry_type = 'credit'\n      AND r.account_id = p.account_id\n      AND r.reference_type = 'order'\n      AND r.reference_id = p.reference_id\n      AND (\n        r.idempotency_key = CONCAT('wallet:payment-reversal:', SUBSTRING(p.idempotency_key, 17))\n        OR JSON_UNQUOTE(JSON_EXTRACT(r.metadata, '$.purpose')) = 'customer_checkout_debit_reversal'\n      )\n  )\n";
+/**
+ * Exit condition for removing isLegacyCustomerCheckoutDebitKey from debit lookup.
+ * File the sunset PR the same week this count hits 0 on prod.
+ */
+declare const LEGACY_ORDER_DEBIT_SUNSET_SQL = "\nSELECT COUNT(*) AS c\nFROM wallet_ledger_entry\nWHERE entry_type = 'debit'\n  AND reference_type = 'order'\n  AND (\n    idempotency_key LIKE 'wallet:full:%'\n    OR idempotency_key LIKE 'wallet:split:%'\n    OR idempotency_key LIKE 'wallet:payment:%'\n  )\n";
+
 declare class WalletCreditDebitRequest {
     ownerType: WalletAccountType;
     ownerId: number;
@@ -128,4 +163,4 @@ declare class VendorWalletController {
 
 declare function createExpressWalletRouter(plugin: WalletPlugin, _basePath?: string): Router;
 
-export { AdminWalletController, CustomerWalletController, DuplicateOperationError, HoldNotFoundError, IWalletPaymentProvider, InsufficientBalanceError, InvalidAmountError, VendorWalletController, WalletAccountType, WalletConfigError, WalletError, WalletPlugin, WalletPluginConfig, createExpressWalletRouter, createWalletPaymentAdapter, fromMinorUnit, registerWalletPlugin, toMinorUnit };
+export { AdminWalletController, BACKFILL_SENTINEL_KEY, CUSTOMER_CHECKOUT_DEBIT_PURPOSE, CUSTOMER_CHECKOUT_DEBIT_REVERSAL_PURPOSE, CustomerWalletController, DuplicateOperationError, HoldNotFoundError, IWalletPaymentProvider, InsufficientBalanceError, InvalidAmountError, LEGACY_ORDER_DEBIT_SUNSET_SQL, UNREIMBURSED_TWIN_COUNT_SQL, UNREIMBURSED_TWIN_DETAIL_SQL, VendorWalletController, WALLET_OPS_TABLE, WalletAccountType, WalletConfigError, WalletError, WalletPlugin, WalletPluginConfig, createExpressWalletRouter, createWalletPaymentAdapter, fromMinorUnit, isCustomerCheckoutDebit, isLegacyCustomerCheckoutDebitKey, nowTimestamp, orderCustomerDebitIdempotencyKey, parseLedgerDate, paymentNumberFromWalletPaymentKey, paymentReversalIdempotencyKey, registerWalletPlugin, toMinorUnit };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { e as WalletPluginConfig, f as WalletPlugin, I as IWalletPaymentProvider } from './types-BzaT7Aqh.js';
-export { D as DeliveredContext, O as OrderPaidContext, P as PaymentProviderWallet, R as RefundContext, S as SettlementDebitContext, g as WALLET_PLUGIN_TOKEN, h as WalletAdminMutationEvent, i as WalletConfig, C as WalletCreatePaymentInput, j as WalletFeatureFlags, k as WalletHttpConfig, l as WalletLedgerClient, W as WalletLifecycleHooks, b as WalletOrderPaidLine, m as WalletReconciliationConfig } from './types-BzaT7Aqh.js';
-import { W as WalletAccountType } from './store-By30oqos.js';
-export { B as BalanceDeltas, d as CancelHoldParams, C as CreditParams, D as DebitParams, G as GetTransactionsParams, H as HoldParams, f as HoldStatus, I as IWalletStore, g as IWalletStoreTx, h as LedgerEntryType, L as LedgerMutationResult, R as ReleaseParams, T as TransferParams, b as WalletAccount, c as WalletBalance, i as WalletHold, e as WalletLedgerEntry, j as WalletReference, a as WalletStoreContext } from './store-By30oqos.js';
-export { CreateWalletTables1790000000000, TypeOrmWalletStore, WalletAccountEntity, WalletHoldEntity, WalletLedgerEntryEntity, getWalletOrmMetadata } from './typeorm/index.js';
+import { e as WalletPluginConfig, f as WalletPlugin, I as IWalletPaymentProvider } from './types-B4R1zaTK.js';
+export { D as DeliveredContext, O as OrderPaidContext, P as PaymentProviderWallet, R as RefundContext, S as SettlementDebitContext, g as WALLET_PLUGIN_TOKEN, h as WalletAdminMutationEvent, i as WalletConfig, C as WalletCreatePaymentInput, j as WalletDuplicateOrderDebitInfo, k as WalletDuplicateOrderDebitKind, l as WalletFeatureFlags, m as WalletHttpConfig, n as WalletLedgerClient, W as WalletLifecycleHooks, b as WalletOrderPaidLine, o as WalletReconciliationConfig } from './types-B4R1zaTK.js';
+import { W as WalletAccountType } from './store-nWCfzvwf.js';
+export { B as BalanceDeltas, d as CancelHoldParams, C as CreditParams, D as DebitParams, G as GetTransactionsParams, H as HoldParams, f as HoldStatus, I as IWalletStore, g as IWalletStoreTx, h as LedgerEntryType, L as LedgerMutationResult, R as ReleaseParams, T as TransferParams, b as WalletAccount, c as WalletBalance, i as WalletHold, e as WalletLedgerEntry, j as WalletReference, a as WalletStoreContext } from './store-nWCfzvwf.js';
+export { AddOrderCustomerDebitUnique1790000001000, CreateWalletTables1790000000000, TypeOrmWalletStore, WalletAccountEntity, WalletHoldEntity, WalletLedgerEntryEntity, getWalletOrmMetadata } from './typeorm/index.js';
 import { Router } from 'express';
 import 'typeorm';
 
@@ -39,6 +39,41 @@ declare function registerWalletPlugin(config: WalletPluginConfig): WalletPlugin;
 
 declare function createWalletPaymentAdapter(plugin: WalletPlugin): IWalletPaymentProvider;
 
+/** Server-local wall clock `YYYY-MM-DD HH:mm:ss` (matches host order paidDate, not UTC ISO). */
+declare function nowTimestamp(date?: Date): string;
+/** Parse naive datetime as local wall clock (do not treat as UTC). */
+declare function parseLedgerDate(value: string | Date): Date;
+
+declare const CUSTOMER_CHECKOUT_DEBIT_PURPOSE = "customer_checkout_debit";
+declare const CUSTOMER_CHECKOUT_DEBIT_REVERSAL_PURPOSE = "customer_checkout_debit_reversal";
+declare const BACKFILL_SENTINEL_KEY = "customer_checkout_debit_backfill";
+declare const WALLET_OPS_TABLE = "wallet_ops";
+declare function orderCustomerDebitIdempotencyKey(orderId: number | string): string;
+declare function paymentReversalIdempotencyKey(paymentNumber: string): string;
+declare function paymentNumberFromWalletPaymentKey(idempotencyKey: string): string | null;
+/**
+ * True when this debit is a customer checkout (product-amount) debit for an order.
+ * Settlement/vendor/affiliate debits must not use these keys or purpose.
+ */
+declare function isCustomerCheckoutDebit(params: {
+    idempotencyKey: string;
+    referenceType?: string;
+    purpose?: unknown;
+}): boolean;
+/**
+ * Legacy keys accepted during rollout only.
+ * Sunset: `npm run wallet:legacy-order-debit-sunset` — drop this helper when LEGACY_ORDER_DEBIT_SUNSET_SQL returns 0 on prod.
+ */
+declare function isLegacyCustomerCheckoutDebitKey(key: string): boolean;
+/** Unreimbursed full/split + wallet:payment twins (duplicate customer checkout debits). */
+declare const UNREIMBURSED_TWIN_COUNT_SQL = "\nSELECT COUNT(*) AS c\nFROM wallet_ledger_entry f\nJOIN wallet_ledger_entry p\n  ON p.account_id = f.account_id\n AND p.reference_type = 'order'\n AND p.reference_id = f.reference_id\n AND p.entry_type = 'debit'\n AND p.idempotency_key LIKE 'wallet:payment:%'\nWHERE f.entry_type = 'debit'\n  AND f.reference_type = 'order'\n  AND (\n    f.idempotency_key LIKE 'wallet:full:%'\n    OR f.idempotency_key LIKE 'wallet:split:%'\n  )\n  AND NOT EXISTS (\n    SELECT 1 FROM wallet_ledger_entry r\n    WHERE r.entry_type = 'credit'\n      AND r.account_id = p.account_id\n      AND r.reference_type = 'order'\n      AND r.reference_id = p.reference_id\n      AND (\n        r.idempotency_key = CONCAT('wallet:payment-reversal:', SUBSTRING(p.idempotency_key, 17))\n        OR JSON_UNQUOTE(JSON_EXTRACT(r.metadata, '$.purpose')) = 'customer_checkout_debit_reversal'\n      )\n  )\n";
+declare const UNREIMBURSED_TWIN_DETAIL_SQL = "\nSELECT\n  f.reference_id AS order_id,\n  f.account_id,\n  f.amount AS first_paise,\n  p.amount AS second_paise,\n  f.idempotency_key AS kept_key,\n  p.idempotency_key AS duplicate_key,\n  f.created_date AS first_at,\n  p.created_date AS duplicate_at,\n  f.id AS kept_id,\n  p.id AS duplicate_id\nFROM wallet_ledger_entry f\nJOIN wallet_ledger_entry p\n  ON p.account_id = f.account_id\n AND p.reference_type = 'order'\n AND p.reference_id = f.reference_id\n AND p.entry_type = 'debit'\n AND p.idempotency_key LIKE 'wallet:payment:%'\nWHERE f.entry_type = 'debit'\n  AND f.reference_type = 'order'\n  AND (\n    f.idempotency_key LIKE 'wallet:full:%'\n    OR f.idempotency_key LIKE 'wallet:split:%'\n  )\n  AND NOT EXISTS (\n    SELECT 1 FROM wallet_ledger_entry r\n    WHERE r.entry_type = 'credit'\n      AND r.account_id = p.account_id\n      AND r.reference_type = 'order'\n      AND r.reference_id = p.reference_id\n      AND (\n        r.idempotency_key = CONCAT('wallet:payment-reversal:', SUBSTRING(p.idempotency_key, 17))\n        OR JSON_UNQUOTE(JSON_EXTRACT(r.metadata, '$.purpose')) = 'customer_checkout_debit_reversal'\n      )\n  )\n";
+/**
+ * Exit condition for removing isLegacyCustomerCheckoutDebitKey from debit lookup.
+ * File the sunset PR the same week this count hits 0 on prod.
+ */
+declare const LEGACY_ORDER_DEBIT_SUNSET_SQL = "\nSELECT COUNT(*) AS c\nFROM wallet_ledger_entry\nWHERE entry_type = 'debit'\n  AND reference_type = 'order'\n  AND (\n    idempotency_key LIKE 'wallet:full:%'\n    OR idempotency_key LIKE 'wallet:split:%'\n    OR idempotency_key LIKE 'wallet:payment:%'\n  )\n";
+
 declare class WalletCreditDebitRequest {
     ownerType: WalletAccountType;
     ownerId: number;
@@ -128,4 +163,4 @@ declare class VendorWalletController {
 
 declare function createExpressWalletRouter(plugin: WalletPlugin, _basePath?: string): Router;
 
-export { AdminWalletController, CustomerWalletController, DuplicateOperationError, HoldNotFoundError, IWalletPaymentProvider, InsufficientBalanceError, InvalidAmountError, VendorWalletController, WalletAccountType, WalletConfigError, WalletError, WalletPlugin, WalletPluginConfig, createExpressWalletRouter, createWalletPaymentAdapter, fromMinorUnit, registerWalletPlugin, toMinorUnit };
+export { AdminWalletController, BACKFILL_SENTINEL_KEY, CUSTOMER_CHECKOUT_DEBIT_PURPOSE, CUSTOMER_CHECKOUT_DEBIT_REVERSAL_PURPOSE, CustomerWalletController, DuplicateOperationError, HoldNotFoundError, IWalletPaymentProvider, InsufficientBalanceError, InvalidAmountError, LEGACY_ORDER_DEBIT_SUNSET_SQL, UNREIMBURSED_TWIN_COUNT_SQL, UNREIMBURSED_TWIN_DETAIL_SQL, VendorWalletController, WALLET_OPS_TABLE, WalletAccountType, WalletConfigError, WalletError, WalletPlugin, WalletPluginConfig, createExpressWalletRouter, createWalletPaymentAdapter, fromMinorUnit, isCustomerCheckoutDebit, isLegacyCustomerCheckoutDebitKey, nowTimestamp, orderCustomerDebitIdempotencyKey, parseLedgerDate, paymentNumberFromWalletPaymentKey, paymentReversalIdempotencyKey, registerWalletPlugin, toMinorUnit };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { PrimaryGeneratedColumn, Column, BeforeInsert, BeforeUpdate, Entity } from 'typeorm';
+import { PrimaryGeneratedColumn, Column, BeforeInsert, BeforeUpdate, Entity, Brackets } from 'typeorm';
 import 'reflect-metadata';
 import { Get, Authorized, QueryParam, Res, Param, Post, Body, Req, JsonController } from 'routing-controllers';
 import { IsString, IsNotEmpty, IsInt, Min, IsNumber, IsOptional } from 'class-validator';
@@ -67,6 +67,121 @@ var _InvalidAmountError = class _InvalidAmountError extends WalletError {
 __name(_InvalidAmountError, "InvalidAmountError");
 var InvalidAmountError = _InvalidAmountError;
 
+// src/orderCustomerDebit.ts
+var CUSTOMER_CHECKOUT_DEBIT_PURPOSE = "customer_checkout_debit";
+var CUSTOMER_CHECKOUT_DEBIT_REVERSAL_PURPOSE = "customer_checkout_debit_reversal";
+var BACKFILL_SENTINEL_KEY = "customer_checkout_debit_backfill";
+var WALLET_OPS_TABLE = "wallet_ops";
+function orderCustomerDebitIdempotencyKey(orderId) {
+  return `wallet:order:${orderId}:customer_debit`;
+}
+__name(orderCustomerDebitIdempotencyKey, "orderCustomerDebitIdempotencyKey");
+function paymentReversalIdempotencyKey(paymentNumber) {
+  return `wallet:payment-reversal:${paymentNumber}`;
+}
+__name(paymentReversalIdempotencyKey, "paymentReversalIdempotencyKey");
+function paymentNumberFromWalletPaymentKey(idempotencyKey) {
+  const prefix = "wallet:payment:";
+  if (!idempotencyKey.startsWith(prefix)) {
+    return null;
+  }
+  return idempotencyKey.slice(prefix.length);
+}
+__name(paymentNumberFromWalletPaymentKey, "paymentNumberFromWalletPaymentKey");
+function isCustomerCheckoutDebit(params) {
+  if (params.purpose === CUSTOMER_CHECKOUT_DEBIT_PURPOSE) {
+    return true;
+  }
+  const key = params.idempotencyKey;
+  if (key.startsWith("wallet:order:") && key.endsWith(":customer_debit")) {
+    return true;
+  }
+  if (params.referenceType !== "order") {
+    return false;
+  }
+  return isLegacyCustomerCheckoutDebitKey(key);
+}
+__name(isCustomerCheckoutDebit, "isCustomerCheckoutDebit");
+function isLegacyCustomerCheckoutDebitKey(key) {
+  return key.startsWith("wallet:full:") || key.startsWith("wallet:split:") || key.startsWith("wallet:payment:");
+}
+__name(isLegacyCustomerCheckoutDebitKey, "isLegacyCustomerCheckoutDebitKey");
+var UNREIMBURSED_TWIN_COUNT_SQL = `
+SELECT COUNT(*) AS c
+FROM wallet_ledger_entry f
+JOIN wallet_ledger_entry p
+  ON p.account_id = f.account_id
+ AND p.reference_type = 'order'
+ AND p.reference_id = f.reference_id
+ AND p.entry_type = 'debit'
+ AND p.idempotency_key LIKE 'wallet:payment:%'
+WHERE f.entry_type = 'debit'
+  AND f.reference_type = 'order'
+  AND (
+    f.idempotency_key LIKE 'wallet:full:%'
+    OR f.idempotency_key LIKE 'wallet:split:%'
+  )
+  AND NOT EXISTS (
+    SELECT 1 FROM wallet_ledger_entry r
+    WHERE r.entry_type = 'credit'
+      AND r.account_id = p.account_id
+      AND r.reference_type = 'order'
+      AND r.reference_id = p.reference_id
+      AND (
+        r.idempotency_key = CONCAT('wallet:payment-reversal:', SUBSTRING(p.idempotency_key, 17))
+        OR JSON_UNQUOTE(JSON_EXTRACT(r.metadata, '$.purpose')) = 'customer_checkout_debit_reversal'
+      )
+  )
+`;
+var UNREIMBURSED_TWIN_DETAIL_SQL = `
+SELECT
+  f.reference_id AS order_id,
+  f.account_id,
+  f.amount AS first_paise,
+  p.amount AS second_paise,
+  f.idempotency_key AS kept_key,
+  p.idempotency_key AS duplicate_key,
+  f.created_date AS first_at,
+  p.created_date AS duplicate_at,
+  f.id AS kept_id,
+  p.id AS duplicate_id
+FROM wallet_ledger_entry f
+JOIN wallet_ledger_entry p
+  ON p.account_id = f.account_id
+ AND p.reference_type = 'order'
+ AND p.reference_id = f.reference_id
+ AND p.entry_type = 'debit'
+ AND p.idempotency_key LIKE 'wallet:payment:%'
+WHERE f.entry_type = 'debit'
+  AND f.reference_type = 'order'
+  AND (
+    f.idempotency_key LIKE 'wallet:full:%'
+    OR f.idempotency_key LIKE 'wallet:split:%'
+  )
+  AND NOT EXISTS (
+    SELECT 1 FROM wallet_ledger_entry r
+    WHERE r.entry_type = 'credit'
+      AND r.account_id = p.account_id
+      AND r.reference_type = 'order'
+      AND r.reference_id = p.reference_id
+      AND (
+        r.idempotency_key = CONCAT('wallet:payment-reversal:', SUBSTRING(p.idempotency_key, 17))
+        OR JSON_UNQUOTE(JSON_EXTRACT(r.metadata, '$.purpose')) = 'customer_checkout_debit_reversal'
+      )
+  )
+`;
+var LEGACY_ORDER_DEBIT_SUNSET_SQL = `
+SELECT COUNT(*) AS c
+FROM wallet_ledger_entry
+WHERE entry_type = 'debit'
+  AND reference_type = 'order'
+  AND (
+    idempotency_key LIKE 'wallet:full:%'
+    OR idempotency_key LIKE 'wallet:split:%'
+    OR idempotency_key LIKE 'wallet:payment:%'
+  )
+`;
+
 // src/types.ts
 var WalletAccountType = /* @__PURE__ */ (function(WalletAccountType2) {
   WalletAccountType2["CUSTOMER"] = "customer";
@@ -194,6 +309,7 @@ var _WalletLedgerClient = class _WalletLedgerClient {
   async debitInTx(tx, params) {
     const existing = await tx.findLedgerByIdempotencyKey(params.idempotencyKey);
     if (existing) {
+      this.notifyDuplicateOrderDebit(params, existing, "idempotent_retry");
       const account = await tx.getAccountById(existing.accountId);
       if (!account) {
         throw new Error(`Wallet account ${existing.accountId} not found`);
@@ -204,27 +320,85 @@ var _WalletLedgerClient = class _WalletLedgerClient {
       };
     }
     const locked = await tx.lockAccount(params.accountId);
+    const orderId = params.reference?.referenceId;
+    const checkoutDebit = isCustomerCheckoutDebit({
+      idempotencyKey: params.idempotencyKey,
+      referenceType: params.reference?.referenceType,
+      purpose: params.metadata?.purpose
+    });
+    if (checkoutDebit && orderId) {
+      const existingPurpose = await tx.findOrderCustomerCheckoutDebit(params.accountId, orderId);
+      if (existingPurpose) {
+        const kind = existingPurpose.idempotencyKey === params.idempotencyKey ? "idempotent_retry" : "cross_key_collision";
+        this.notifyDuplicateOrderDebit(params, existingPurpose, kind);
+        return {
+          entry: existingPurpose,
+          account: locked
+        };
+      }
+    }
     if (locked.availableBalance < params.amount) {
       throw new InsufficientBalanceError();
     }
     const updated = await tx.updateBalances(params.accountId, {
       availableDelta: -params.amount
     });
-    const entry = await tx.appendLedgerEntry({
-      accountId: params.accountId,
-      entryType: LedgerEntryType.DEBIT,
-      amount: params.amount,
-      balanceAfterAvailable: updated.availableBalance,
-      balanceAfterHeld: updated.heldBalance,
+    try {
+      const entry = await tx.appendLedgerEntry({
+        accountId: params.accountId,
+        entryType: LedgerEntryType.DEBIT,
+        amount: params.amount,
+        balanceAfterAvailable: updated.availableBalance,
+        balanceAfterHeld: updated.heldBalance,
+        idempotencyKey: params.idempotencyKey,
+        referenceType: params.reference?.referenceType,
+        referenceId: params.reference?.referenceId,
+        metadata: params.metadata
+      });
+      return {
+        entry,
+        account: updated
+      };
+    } catch (error) {
+      if (error instanceof DuplicateOperationError && checkoutDebit && orderId) {
+        const dup = await tx.findOrderCustomerCheckoutDebit(params.accountId, orderId);
+        if (dup) {
+          const restored = await tx.updateBalances(params.accountId, {
+            availableDelta: params.amount
+          });
+          this.notifyDuplicateOrderDebit(params, dup, "cross_key_collision");
+          return {
+            entry: dup,
+            account: restored
+          };
+        }
+      }
+      throw error;
+    }
+  }
+  notifyDuplicateOrderDebit(params, existing, kind) {
+    const orderId = params.reference?.referenceId ?? existing.referenceId;
+    if (!orderId) {
+      return;
+    }
+    const checkoutDebit = isCustomerCheckoutDebit({
       idempotencyKey: params.idempotencyKey,
-      referenceType: params.reference?.referenceType,
-      referenceId: params.reference?.referenceId,
-      metadata: params.metadata
+      referenceType: params.reference?.referenceType ?? existing.referenceType,
+      purpose: params.metadata?.purpose ?? existing.metadata?.purpose
     });
-    return {
-      entry,
-      account: updated
-    };
+    if (!checkoutDebit) {
+      return;
+    }
+    try {
+      this.config.onDuplicateOrderDebit?.({
+        orderId,
+        accountId: params.accountId,
+        requestedKey: params.idempotencyKey,
+        existingKey: existing.idempotencyKey,
+        kind
+      });
+    } catch {
+    }
   }
   async holdInTx(tx, params) {
     const existing = await tx.findLedgerByIdempotencyKey(params.idempotencyKey);
@@ -448,10 +622,14 @@ function createOrderHooks(runtime) {
         await client.debit({
           accountId: customer.id,
           amount: toMinorUnit(debitRupees),
-          idempotencyKey: `wallet:payment:${ctx.paymentNumber}`,
+          idempotencyKey: orderCustomerDebitIdempotencyKey(ctx.orderId),
           reference: {
             referenceType: "order",
             referenceId: String(ctx.orderId)
+          },
+          metadata: {
+            purpose: CUSTOMER_CHECKOUT_DEBIT_PURPOSE,
+            paymentNumber: ctx.paymentNumber
           }
         }, txCtx);
       }
@@ -465,7 +643,7 @@ function createOrderHooks(runtime) {
         }
       }, txCtx);
       for (const line of ctx.lines) {
-        const vendorNetRupees = line.commissionBaseRupees - line.commissionRupees;
+        const vendorNetRupees = line.sellerNetRupees != null && Number.isFinite(Number(line.sellerNetRupees)) ? Number(line.sellerNetRupees) : line.commissionBaseRupees - line.commissionRupees;
         if (vendorNetRupees <= 0) {
           continue;
         }
@@ -606,6 +784,29 @@ function resolveWalletConnection() {
   return activeConnection;
 }
 __name(resolveWalletConnection, "resolveWalletConnection");
+
+// src/timestamps.ts
+function pad2(value) {
+  return String(value).padStart(2, "0");
+}
+__name(pad2, "pad2");
+function nowTimestamp(date = /* @__PURE__ */ new Date()) {
+  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())} ${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`;
+}
+__name(nowTimestamp, "nowTimestamp");
+function parseLedgerDate(value) {
+  if (value instanceof Date) {
+    return value;
+  }
+  const match = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})/.exec(String(value));
+  if (!match) {
+    return new Date(value);
+  }
+  return new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3]), Number(match[4]), Number(match[5]), Number(match[6]));
+}
+__name(parseLedgerDate, "parseLedgerDate");
+
+// src/typeorm/entities.ts
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -617,10 +818,6 @@ function _ts_metadata(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata, "_ts_metadata");
-function nowTimestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-}
-__name(nowTimestamp, "nowTimestamp");
 var _WalletAccountEntity = class _WalletAccountEntity {
   constructor() {
     __publicField(this, "id");
@@ -1702,8 +1899,6 @@ function createWalletPaymentAdapter(plugin) {
   };
 }
 __name(createWalletPaymentAdapter, "createWalletPaymentAdapter");
-
-// src/typeorm/store.ts
 function toNumber(value) {
   if (value == null) {
     return 0;
@@ -1732,7 +1927,7 @@ function toLedgerHold(row) {
     referenceType: row.referenceType,
     referenceId: row.referenceId,
     idempotencyKey: row.idempotencyKey,
-    createdAt: new Date(row.createdDate)
+    createdAt: parseLedgerDate(row.createdDate)
   };
 }
 __name(toLedgerHold, "toLedgerHold");
@@ -1748,7 +1943,7 @@ function toLedgerEntry(row) {
     referenceType: row.referenceType,
     referenceId: row.referenceId,
     metadata: row.metadata,
-    createdAt: new Date(row.createdDate)
+    createdAt: parseLedgerDate(row.createdDate)
   };
 }
 __name(toLedgerEntry, "toLedgerEntry");
@@ -1886,7 +2081,7 @@ var TypeOrmWalletStoreTx = (_a2 = class {
         where: {
           id: hold.id
         }
-      });
+      }) ?? void 0;
     }
     if (!row) {
       row = await repo.findOne({
@@ -1894,7 +2089,7 @@ var TypeOrmWalletStoreTx = (_a2 = class {
           referenceType: hold.referenceType,
           referenceId: hold.referenceId
         }
-      });
+      }) ?? void 0;
     }
     if (!row) {
       row = repo.create({
@@ -1924,6 +2119,36 @@ var TypeOrmWalletStoreTx = (_a2 = class {
     });
     return row ? toLedgerEntry(row) : null;
   }
+  async findOrderCustomerCheckoutDebit(accountId, orderId) {
+    const canonical = orderCustomerDebitIdempotencyKey(orderId);
+    const row = await this.em.getRepository(WalletLedgerEntryEntity).createQueryBuilder("e").where("e.account_id = :accountId", {
+      accountId
+    }).andWhere("e.entry_type = :entryType", {
+      entryType: "debit"
+    }).andWhere("e.reference_type = :referenceType", {
+      referenceType: "order"
+    }).andWhere("e.reference_id = :orderId", {
+      orderId
+    }).andWhere(new Brackets((qb) => {
+      qb.where(`JSON_UNQUOTE(JSON_EXTRACT(e.metadata, '$.purpose')) = :purpose`, {
+        purpose: CUSTOMER_CHECKOUT_DEBIT_PURPOSE
+      }).orWhere("e.idempotency_key = :canonical", {
+        canonical
+      }).orWhere("e.idempotency_key LIKE :fullPrefix", {
+        fullPrefix: "wallet:full:%"
+      }).orWhere("e.idempotency_key LIKE :splitPrefix", {
+        splitPrefix: "wallet:split:%"
+      }).orWhere("e.idempotency_key LIKE :paymentPrefix", {
+        paymentPrefix: "wallet:payment:%"
+      });
+    })).orderBy(`CASE
+          WHEN JSON_UNQUOTE(JSON_EXTRACT(e.metadata, '$.purpose')) = :purpose THEN 0
+          WHEN e.idempotency_key = :canonical THEN 1
+          WHEN e.idempotency_key LIKE 'wallet:full:%' OR e.idempotency_key LIKE 'wallet:split:%' THEN 2
+          ELSE 3
+        END`, "ASC").addOrderBy("e.id", "ASC").setParameter("purpose", CUSTOMER_CHECKOUT_DEBIT_PURPOSE).setParameter("canonical", canonical).getOne();
+    return row ? toLedgerEntry(row) : null;
+  }
   async listLedgerEntries(accountId, limit, offset) {
     const rows = await this.em.getRepository(WalletLedgerEntryEntity).find({
       where: {
@@ -2060,6 +2285,84 @@ var _CreateWalletTables1790000000000 = class _CreateWalletTables1790000000000 {
 __name(_CreateWalletTables1790000000000, "CreateWalletTables1790000000000");
 var CreateWalletTables1790000000000 = _CreateWalletTables1790000000000;
 
+// src/typeorm/migrations/AddOrderCustomerDebitUnique.ts
+var _AddOrderCustomerDebitUnique1790000001000 = class _AddOrderCustomerDebitUnique1790000001000 {
+  async up(queryRunner) {
+    const opsTables = await queryRunner.query(`SELECT COUNT(*) AS c
+       FROM information_schema.tables
+       WHERE table_schema = DATABASE()
+         AND table_name = ?`, [
+      WALLET_OPS_TABLE
+    ]);
+    if (Number(opsTables[0]?.c ?? 0) === 0) {
+      throw new Error(`Wallet unique-index gate: ${WALLET_OPS_TABLE} is missing. Run npm run wallet:credit-duplicate-order-debits`);
+    }
+    const sentinel = await queryRunner.query(`SELECT status FROM \`${WALLET_OPS_TABLE}\` WHERE ops_key = ? LIMIT 1`, [
+      BACKFILL_SENTINEL_KEY
+    ]);
+    if (!sentinel[0] || sentinel[0].status !== "complete") {
+      throw new Error(`Wallet unique-index gate: sentinel ${BACKFILL_SENTINEL_KEY} is missing. Run npm run wallet:credit-duplicate-order-debits`);
+    }
+    const twins = await queryRunner.query(UNREIMBURSED_TWIN_COUNT_SQL);
+    const twinCount = Number(twins[0]?.c ?? 0);
+    if (twinCount > 0) {
+      throw new Error(`Wallet unique-index gate: unreimbursed twin COUNT is ${twinCount}. Run npm run wallet:credit-duplicate-order-debits`);
+    }
+    const columns = await queryRunner.query(`SELECT COUNT(*) AS c
+       FROM information_schema.columns
+       WHERE table_schema = DATABASE()
+         AND table_name = 'wallet_ledger_entry'
+         AND column_name = 'order_customer_debit_key'`);
+    if (Number(columns[0]?.c ?? 0) === 0) {
+      await queryRunner.query(`
+        ALTER TABLE \`wallet_ledger_entry\`
+        ADD COLUMN \`order_customer_debit_key\` VARCHAR(191)
+          GENERATED ALWAYS AS (
+            CASE
+              WHEN \`entry_type\` = 'debit'
+               AND \`reference_type\` = 'order'
+               AND \`reference_id\` IS NOT NULL
+               AND JSON_UNQUOTE(JSON_EXTRACT(\`metadata\`, '$.purpose')) = 'customer_checkout_debit'
+              THEN CONCAT(\`account_id\`, ':', \`reference_id\`)
+              ELSE NULL
+            END
+          ) STORED
+      `);
+    }
+    const indexes = await queryRunner.query(`SELECT COUNT(*) AS c
+       FROM information_schema.statistics
+       WHERE table_schema = DATABASE()
+         AND table_name = 'wallet_ledger_entry'
+         AND index_name = 'UQ_wallet_order_customer_debit'`);
+    if (Number(indexes[0]?.c ?? 0) === 0) {
+      await queryRunner.query(`
+        CREATE UNIQUE INDEX \`UQ_wallet_order_customer_debit\`
+        ON \`wallet_ledger_entry\` (\`order_customer_debit_key\`)
+      `);
+    }
+  }
+  async down(queryRunner) {
+    const indexes = await queryRunner.query(`SELECT COUNT(*) AS c
+       FROM information_schema.statistics
+       WHERE table_schema = DATABASE()
+         AND table_name = 'wallet_ledger_entry'
+         AND index_name = 'UQ_wallet_order_customer_debit'`);
+    if (Number(indexes[0]?.c ?? 0) > 0) {
+      await queryRunner.query(`DROP INDEX \`UQ_wallet_order_customer_debit\` ON \`wallet_ledger_entry\``);
+    }
+    const columns = await queryRunner.query(`SELECT COUNT(*) AS c
+       FROM information_schema.columns
+       WHERE table_schema = DATABASE()
+         AND table_name = 'wallet_ledger_entry'
+         AND column_name = 'order_customer_debit_key'`);
+    if (Number(columns[0]?.c ?? 0) > 0) {
+      await queryRunner.query(`ALTER TABLE \`wallet_ledger_entry\` DROP COLUMN \`order_customer_debit_key\``);
+    }
+  }
+};
+__name(_AddOrderCustomerDebitUnique1790000001000, "AddOrderCustomerDebitUnique1790000001000");
+var AddOrderCustomerDebitUnique1790000001000 = _AddOrderCustomerDebitUnique1790000001000;
+
 // src/typeorm/metadata.ts
 function getWalletOrmMetadata() {
   return {
@@ -2069,7 +2372,8 @@ function getWalletOrmMetadata() {
       WalletHoldEntity
     ],
     migrations: [
-      CreateWalletTables1790000000000
+      CreateWalletTables1790000000000,
+      AddOrderCustomerDebitUnique1790000001000
     ]
   };
 }
@@ -2116,7 +2420,8 @@ var WalletPluginImpl = (_a3 = class {
     this.resolveOrderCustomerId = config.resolveOrderCustomerId;
     this.client = new WalletLedgerClient(store, {
       defaultCurrency: config.defaultCurrency ?? "INR",
-      platformOwnerId: config.platformOwnerId
+      platformOwnerId: config.platformOwnerId,
+      onDuplicateOrderDebit: config.onDuplicateOrderDebit
     });
     this.hooks = createLifecycleHooks({
       client: this.client,
@@ -2168,6 +2473,6 @@ function registerWalletPlugin(config) {
 }
 __name(registerWalletPlugin, "registerWalletPlugin");
 
-export { AdminWalletController, CreateWalletTables1790000000000, CustomerWalletController, DuplicateOperationError, HoldNotFoundError, HoldStatus, InsufficientBalanceError, InvalidAmountError, LedgerEntryType, PaymentProviderWallet, TypeOrmWalletStore, VendorWalletController, WALLET_PLUGIN_TOKEN, WalletAccountEntity, WalletAccountType, WalletConfigError, WalletError, WalletHoldEntity, WalletLedgerClient, WalletLedgerEntryEntity, createExpressWalletRouter, createWalletPaymentAdapter, fromMinorUnit, getWalletOrmMetadata, registerWalletPlugin, toMinorUnit };
+export { AddOrderCustomerDebitUnique1790000001000, AdminWalletController, BACKFILL_SENTINEL_KEY, CUSTOMER_CHECKOUT_DEBIT_PURPOSE, CUSTOMER_CHECKOUT_DEBIT_REVERSAL_PURPOSE, CreateWalletTables1790000000000, CustomerWalletController, DuplicateOperationError, HoldNotFoundError, HoldStatus, InsufficientBalanceError, InvalidAmountError, LEGACY_ORDER_DEBIT_SUNSET_SQL, LedgerEntryType, PaymentProviderWallet, TypeOrmWalletStore, UNREIMBURSED_TWIN_COUNT_SQL, UNREIMBURSED_TWIN_DETAIL_SQL, VendorWalletController, WALLET_OPS_TABLE, WALLET_PLUGIN_TOKEN, WalletAccountEntity, WalletAccountType, WalletConfigError, WalletError, WalletHoldEntity, WalletLedgerClient, WalletLedgerEntryEntity, createExpressWalletRouter, createWalletPaymentAdapter, fromMinorUnit, getWalletOrmMetadata, isCustomerCheckoutDebit, isLegacyCustomerCheckoutDebitKey, nowTimestamp, orderCustomerDebitIdempotencyKey, parseLedgerDate, paymentNumberFromWalletPaymentKey, paymentReversalIdempotencyKey, registerWalletPlugin, toMinorUnit };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map