@konplit-services/common 1.30.0 → 1.30.1

package/build/events/refund-events/inteterfaces/index.d.ts

@@ -16,3 +16,9 @@ export * from "./refund-settlement-ledger-reserve-fund.interface";
 export * from "./refund-settlement-ledger-reserve-res.interface";
 export * from "./refund-settlement-ledger-reverse.interface";
 export * from "./refund-settlement-ledger-notfound.interface";
+export * from "./refund-created.interface";
+export * from "./refund-webhook.interface";
+export * from "./refund-customer-account-requested.interface";
+export * from "./refund-customer-account-updated.interface";
+export * from "./refund-debit-retry-scheduled.interface";
+export * from "./refund-debit-retry-triggered.interface";

package/build/events/refund-events/inteterfaces/index.js

@@ -32,4 +32,10 @@ __exportStar(require("./refund-settlement-ledger-reserve-fund.interface"), expor
 __exportStar(require("./refund-settlement-ledger-reserve-res.interface"), exports);
 __exportStar(require("./refund-settlement-ledger-reverse.interface"), exports);
 __exportStar(require("./refund-settlement-ledger-notfound.interface"), exports);
-//commit changed
+// New lifecycle events
+__exportStar(require("./refund-created.interface"), exports);
+__exportStar(require("./refund-webhook.interface"), exports);
+__exportStar(require("./refund-customer-account-requested.interface"), exports);
+__exportStar(require("./refund-customer-account-updated.interface"), exports);
+__exportStar(require("./refund-debit-retry-scheduled.interface"), exports);
+__exportStar(require("./refund-debit-retry-triggered.interface"), exports);

package/build/events/refund-events/inteterfaces/refund-created.interface.d.ts

@@ -0,0 +1,21 @@
+import { REFUND_TYPE, REFUND_DEBIT_STATUS } from "../../../helper";
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface RefundCreatedEvent {
+    subject: Subjects.RefundCreated;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        refundId: string;
+        merchantId: string;
+        transactionId: string;
+        transactionRef: string;
+        amount: number;
+        currency: string;
+        refundType: REFUND_TYPE;
+        reason?: string;
+        createdBy: string;
+        idempotencyKey?: string;
+        debitStatus: REFUND_DEBIT_STATUS;
+        createdAt: string;
+    };
+}

package/build/events/refund-events/inteterfaces/refund-created.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/refund-events/inteterfaces/refund-customer-account-requested.interface.d.ts

@@ -0,0 +1,16 @@
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface RefundCustomerAccountRequestedEvent {
+    subject: Subjects.RefundCustomerAccountRequested;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        refundId: string;
+        merchantId: string;
+        transactionId: string;
+        transactionRef: string;
+        amount: number;
+        currency: string;
+        requestedBy: string;
+        requestedAt: string;
+    };
+}

package/build/events/refund-events/inteterfaces/refund-customer-account-requested.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/refund-events/inteterfaces/refund-customer-account-updated.interface.d.ts

@@ -0,0 +1,15 @@
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface RefundCustomerAccountUpdatedEvent {
+    subject: Subjects.RefundCustomerAccountUpdated;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        refundId: string;
+        merchantId: string;
+        transactionId: string;
+        transactionRef: string;
+        bankAccountId: string;
+        updatedBy: string;
+        updatedAt: string;
+    };
+}

package/build/events/refund-events/inteterfaces/refund-customer-account-updated.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/refund-events/inteterfaces/refund-debit-retry-scheduled.interface.d.ts

@@ -0,0 +1,22 @@
+import { REFUND_SOURCE, REFUND_TYPE } from "../../../helper";
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface RefundDebitRetryScheduledEvent {
+    subject: Subjects.RefundDebitRetryScheduled;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        refundId: string;
+        merchantId: string;
+        transactionId: string;
+        transactionRef: string;
+        amount: number;
+        fees: number;
+        refundType: REFUND_TYPE;
+        refundSource?: REFUND_SOURCE;
+        reason?: string;
+        debitAttempts: number;
+        nextRetryAt: string;
+        transactionDate: Date;
+        settlementId?: string;
+    };
+}

package/build/events/refund-events/inteterfaces/refund-debit-retry-scheduled.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/refund-events/inteterfaces/refund-debit-retry-triggered.interface.d.ts

@@ -0,0 +1,10 @@
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface RefundDebitRetryTriggeredEvent {
+    subject: Subjects.RefundDebitRetryTriggered;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        refundId: string;
+        merchantId: string;
+    };
+}

package/build/events/refund-events/inteterfaces/refund-debit-retry-triggered.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/refund-events/inteterfaces/refund-settlement-ledger-release.interface.d.ts

@@ -16,5 +16,6 @@ export interface RefundFundSettlementLedgerReleaseFundEvent {
         reason?: string;
         transactionDate: Date;
         fees: number;
+        skipLedgerReverse?: boolean;
     };
 }

package/build/events/refund-events/inteterfaces/refund-settlement-ledger-reserve-fund.interface.d.ts

@@ -8,6 +8,7 @@ export interface RefundFundSettlementLedgerReserveFundEvent {
         merchantId: string;
         refundId: string;
         transactionId: string;
+        settlementId: string;
         amount: number;
         totalAmount: number;
         refundType: REFUND_TYPE;

package/build/events/refund-events/inteterfaces/refund-settlement-ledger-reserve-res.interface.d.ts

@@ -8,6 +8,7 @@ export interface RefundFundSettlementLedgerReserveFundEventResponseEvent {
         merchantId: string;
         refundId: string;
         transactionId: string;
+        settlementId: string;
         responseType: REFUND_WALLET_RESPONSE;
         refundSource: REFUND_SOURCE;
         totalAmount: number;

package/build/events/refund-events/inteterfaces/refund-webhook.interface.d.ts

@@ -0,0 +1,24 @@
+import { REFUND_STATUS, REFUND_WEBHOOK_TYPES, REFUND_DEBIT_STATUS } from "../../../helper";
+import { StreamEvent, StreamName, Subjects } from "../../subjects";
+export interface RefundWebhookEvent {
+    subject: Subjects.RefundWebhook;
+    streamName: StreamName.name;
+    streamEvents: StreamEvent.Event;
+    data: {
+        event: REFUND_WEBHOOK_TYPES;
+        refundId: string;
+        merchantId: string;
+        transactionId: string;
+        transactionRef: string;
+        amount: number;
+        currency: string;
+        status: REFUND_STATUS;
+        previousStatus?: REFUND_STATUS;
+        debitStatus?: REFUND_DEBIT_STATUS;
+        reason?: string;
+        usage: string;
+        createdAt?: string;
+        updatedAt?: string;
+        [key: string]: any;
+    };
+}

package/build/events/refund-events/inteterfaces/refund-webhook.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/events/subjects.d.ts

@@ -98,6 +98,17 @@ export declare enum Subjects {
     RefundSettlementLedgerReserveFund = "events.refund.settlement.ledger.reserve.fund",
     RefundSettlementLedgerReserveFundResponse = "events.refund.settlement.ledger.reserve.fund.response",
     RefundSettlementLedgerReverseFundToLedger = "events.refund.settlement.ledger.reverse.fund.to.ledger",
+    RefundCreated = "events.refund.created",
+    RefundDeclined = "events.refund.declined",
+    RefundCancelled = "events.refund.cancelled",
+    RefundWebhook = "events.refund.webhook",
+    RefundDebitRetryScheduled = "events.refund.debit.retry.scheduled",
+    RefundCustomerAccountRequested = "events.refund.customer.account.requested",
+    RefundCustomerAccountUpdated = "events.refund.customer.account.updated",
+    RefundWalletDebitRequested = "events.refund.wallet.debit.requested",
+    RefundWalletDebitCompleted = "events.refund.wallet.debit.completed",
+    RefundWalletDebitFailed = "events.refund.wallet.debit.failed",
+    RefundDebitRetryTriggered = "events.refund.debit.retry.triggered",
     BANKACCOUNT_CREATED = "events.bank.account.created",
     BANKACCOUNT_UPDATED = "events.bank.account.updated",
     BANKACCOUNT_DELETED = "events.bank.account.deleted",

package/build/events/subjects.js

@@ -119,6 +119,18 @@ var Subjects;
     Subjects["RefundSettlementLedgerReserveFund"] = "events.refund.settlement.ledger.reserve.fund";
     Subjects["RefundSettlementLedgerReserveFundResponse"] = "events.refund.settlement.ledger.reserve.fund.response";
     Subjects["RefundSettlementLedgerReverseFundToLedger"] = "events.refund.settlement.ledger.reverse.fund.to.ledger";
+    // REFUND lifecycle events (new)
+    Subjects["RefundCreated"] = "events.refund.created";
+    Subjects["RefundDeclined"] = "events.refund.declined";
+    Subjects["RefundCancelled"] = "events.refund.cancelled";
+    Subjects["RefundWebhook"] = "events.refund.webhook";
+    Subjects["RefundDebitRetryScheduled"] = "events.refund.debit.retry.scheduled";
+    Subjects["RefundCustomerAccountRequested"] = "events.refund.customer.account.requested";
+    Subjects["RefundCustomerAccountUpdated"] = "events.refund.customer.account.updated";
+    Subjects["RefundWalletDebitRequested"] = "events.refund.wallet.debit.requested";
+    Subjects["RefundWalletDebitCompleted"] = "events.refund.wallet.debit.completed";
+    Subjects["RefundWalletDebitFailed"] = "events.refund.wallet.debit.failed";
+    Subjects["RefundDebitRetryTriggered"] = "events.refund.debit.retry.triggered";
     //APICONFIG
     Subjects["BANKACCOUNT_CREATED"] = "events.bank.account.created";
     Subjects["BANKACCOUNT_UPDATED"] = "events.bank.account.updated";

package/build/helper/refund.d.ts

@@ -4,8 +4,6 @@ export declare enum REFUND_STATUS {
     PROCESSING = "PROCESSING",
     PENDING = "PENDING",
     FAILED = "FAILED",
-    RETRY = "RETRY",
-    APPROVED = "APPROVED",// configured by merchant to only rufund customers when approved
     CANCELLED = "CANCELLED"
 }
 export declare enum REFUND_WALLET_RESPONSE {
@@ -32,3 +30,22 @@ export declare enum REFUND_CHANNEL {
     original = "original",
     bank_transfer = "bank_transfer"
 }
+/** Tracks the state of the merchant debit used to fund the refund */
+export declare enum REFUND_DEBIT_STATUS {
+    NOT_REQUIRED = "NOT_REQUIRED",
+    PENDING = "PENDING",
+    SUCCESS = "SUCCESS",
+    FAILED = "FAILED",
+    RETRYING = "RETRYING"
+}
+/** Webhook event types emitted to merchants for refund lifecycle */
+export declare enum REFUND_WEBHOOK_TYPES {
+    created = "refund.created",
+    declined = "refund.declined",
+    cancelled = "refund.cancelled",
+    failed = "refund.failed",
+    completed = "refund.completed",
+    processing = "refund.processing",
+    customer_account_needed = "refund.customer_account_needed",
+    customer_account_updated = "refund.customer_account_updated"
+}

package/build/helper/refund.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REFUND_CHANNEL = exports.REFUND_TYPE = exports.REFUND_STATUS_INTERSWITCH = exports.REFUND_SOURCE = exports.REFUND_WALLET_RESPONSE = exports.REFUND_STATUS = void 0;
+exports.REFUND_WEBHOOK_TYPES = exports.REFUND_DEBIT_STATUS = exports.REFUND_CHANNEL = exports.REFUND_TYPE = exports.REFUND_STATUS_INTERSWITCH = exports.REFUND_SOURCE = exports.REFUND_WALLET_RESPONSE = exports.REFUND_STATUS = void 0;
 var REFUND_STATUS;
 (function (REFUND_STATUS) {
     REFUND_STATUS["COMPLETED"] = "COMPLETED";
@@ -8,8 +8,6 @@ var REFUND_STATUS;
     REFUND_STATUS["PROCESSING"] = "PROCESSING";
     REFUND_STATUS["PENDING"] = "PENDING";
     REFUND_STATUS["FAILED"] = "FAILED";
-    REFUND_STATUS["RETRY"] = "RETRY";
-    REFUND_STATUS["APPROVED"] = "APPROVED";
     REFUND_STATUS["CANCELLED"] = "CANCELLED";
 })(REFUND_STATUS || (exports.REFUND_STATUS = REFUND_STATUS = {}));
 var REFUND_WALLET_RESPONSE;
@@ -43,4 +41,24 @@ var REFUND_CHANNEL;
     REFUND_CHANNEL["original"] = "original";
     REFUND_CHANNEL["bank_transfer"] = "bank_transfer";
 })(REFUND_CHANNEL || (exports.REFUND_CHANNEL = REFUND_CHANNEL = {}));
-//nothing
+/** Tracks the state of the merchant debit used to fund the refund */
+var REFUND_DEBIT_STATUS;
+(function (REFUND_DEBIT_STATUS) {
+    REFUND_DEBIT_STATUS["NOT_REQUIRED"] = "NOT_REQUIRED";
+    REFUND_DEBIT_STATUS["PENDING"] = "PENDING";
+    REFUND_DEBIT_STATUS["SUCCESS"] = "SUCCESS";
+    REFUND_DEBIT_STATUS["FAILED"] = "FAILED";
+    REFUND_DEBIT_STATUS["RETRYING"] = "RETRYING";
+})(REFUND_DEBIT_STATUS || (exports.REFUND_DEBIT_STATUS = REFUND_DEBIT_STATUS = {}));
+/** Webhook event types emitted to merchants for refund lifecycle */
+var REFUND_WEBHOOK_TYPES;
+(function (REFUND_WEBHOOK_TYPES) {
+    REFUND_WEBHOOK_TYPES["created"] = "refund.created";
+    REFUND_WEBHOOK_TYPES["declined"] = "refund.declined";
+    REFUND_WEBHOOK_TYPES["cancelled"] = "refund.cancelled";
+    REFUND_WEBHOOK_TYPES["failed"] = "refund.failed";
+    REFUND_WEBHOOK_TYPES["completed"] = "refund.completed";
+    REFUND_WEBHOOK_TYPES["processing"] = "refund.processing";
+    REFUND_WEBHOOK_TYPES["customer_account_needed"] = "refund.customer_account_needed";
+    REFUND_WEBHOOK_TYPES["customer_account_updated"] = "refund.customer_account_updated";
+})(REFUND_WEBHOOK_TYPES || (exports.REFUND_WEBHOOK_TYPES = REFUND_WEBHOOK_TYPES = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konplit-services/common",
-  "version": "1.30.0",
+  "version": "1.30.1",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",