@fiado/type-kit 3.568.0 → 3.570.0

package/_test_/unit/collection/disbursementType.test.ts

@@ -3,8 +3,8 @@ import { Collection } from '../../../src/index';
 import { DisbursementType } from '../../../src/collection/index';
 
 describe('DisbursementType', () => {
-    it('v1 solo trae el riel MEX_BONUS', () => {
-        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS']);
+    it('trae los productos de bono y comisión de vendedor', () => {
+        expect(Object.values(DisbursementType)).toEqual(['MEX_BONUS', 'MEX_SELLER_COMMISSION']);
     });
 
     it('cada clave es igual a su valor', () => {
@@ -15,5 +15,6 @@ describe('DisbursementType', () => {
 
     it('sale por el index raíz', () => {
         expect(Collection.DisbursementType.MEX_BONUS).toBe('MEX_BONUS');
+        expect(Collection.DisbursementType.MEX_SELLER_COMMISSION).toBe('MEX_SELLER_COMMISSION');
     });
 });

package/_test_/unit/productCatalog/enums/ProductSubtypeEnum.test.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import { ProductSubtypeEnum } from '../../../../src/productCatalog/enums/ProductSubtypeEnum';
+
+describe('ProductSubtypeEnum SureKeep', () => {
+  it('trae los subtipos de bono y comisión de vendedor', () => {
+    expect(ProductSubtypeEnum.SUREKEEP_BONUS_MX).toBe('BONUS_MX');
+    expect(ProductSubtypeEnum.SUREKEEP_SELLER_COMMISSION_MX).toBe('SELLER_COMMISSION_MX');
+  });
+});

package/_test_/unit/retailWizard/storePendingRefundsResponse.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { RefundStatusEnum, SalePaymentMethodEnum } from '../../../src/retailWizard';
+import type { StorePendingRefundsResponse } from '../../../src/retailWizard';
+
+describe('StorePendingRefundsResponse', () => {
+  it('expone el estado del reembolso y el trail de la entrega', () => {
+    const response: StorePendingRefundsResponse = {
+      refunds: [
+        {
+          sessionId: 'S1',
+          storeId: 'ST-1',
+          sellerId: 'RU-1',
+          sellerName: 'Ana',
+          creditId: 'C-1',
+          folio: 'ENG-1',
+          refundPendingCents: 150000,
+          paymentMethod: SalePaymentMethodEnum.CASH,
+          status: RefundStatusEnum.DELIVERED,
+          deliverable: false,
+          cancelledAt: '2026-10-20T10:00:00.000Z',
+          cancelledBy: 'sub-cancel',
+          deliveredAt: '2026-10-21T10:00:00.000Z',
+          deliveredBy: 'sub-v',
+          deliveredByName: 'Ana',
+        },
+      ],
+      pendingCount: 0,
+      pendingTotalCents: 0,
+    };
+    expect(response.refunds[0].status).toBe('DELIVERED');
+    expect(Object.values(RefundStatusEnum)).toEqual(['PENDING', 'DELIVERED']);
+  });
+});

package/bin/collection/enums/DisbursementType.d.ts

@@ -1,7 +1,10 @@
 /**
- * Riel por el que el motor de cobro deposita una dispersión. Nombra el movimiento, no el propósito:
- * el propósito lo manda el llamador en `concept`.
+ * Producto con el que el motor de cobro deposita una dispersión.
+ * El detalle para la persona va en `concept`.
  */
 export declare enum DisbursementType {
-    MEX_BONUS = "MEX_BONUS"
+    /** Bono. */
+    MEX_BONUS = "MEX_BONUS",
+    /** Comisión de vendedor. */
+    MEX_SELLER_COMMISSION = "MEX_SELLER_COMMISSION"
 }

package/bin/collection/enums/DisbursementType.js

@@ -2,10 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DisbursementType = void 0;
 /**
- * Riel por el que el motor de cobro deposita una dispersión. Nombra el movimiento, no el propósito:
- * el propósito lo manda el llamador en `concept`.
+ * Producto con el que el motor de cobro deposita una dispersión.
+ * El detalle para la persona va en `concept`.
  */
 var DisbursementType;
 (function (DisbursementType) {
+    /** Bono. */
     DisbursementType["MEX_BONUS"] = "MEX_BONUS";
+    /** Comisión de vendedor. */
+    DisbursementType["MEX_SELLER_COMMISSION"] = "MEX_SELLER_COMMISSION";
 })(DisbursementType || (exports.DisbursementType = DisbursementType = {}));

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -59,6 +59,7 @@ export declare enum ProductSubtypeEnum {
      */
     SP_CASH_IN_CASH_IN_OXXO = "CASH_IN_OXXO",
     SUREKEEP_BONUS_MX = "BONUS_MX",
+    SUREKEEP_SELLER_COMMISSION_MX = "SELLER_COMMISSION_MX",
     STORE_PHONE = "PHONE",
     REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
     REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -75,6 +75,8 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["SP_CASH_IN_CASH_IN_OXXO"] = "CASH_IN_OXXO";
     //SUREKEEP
     ProductSubtypeEnum["SUREKEEP_BONUS_MX"] = "BONUS_MX";
+    // Comisión de vendedor de SureKeep abonada a la wallet.
+    ProductSubtypeEnum["SUREKEEP_SELLER_COMMISSION_MX"] = "SELLER_COMMISSION_MX";
     //STORE
     ProductSubtypeEnum["STORE_PHONE"] = "PHONE";
     // REFUND_PCF

package/bin/retailWizard/dtos/SellerPendingRefundItem.d.ts

@@ -0,0 +1,23 @@
+import { RefundStatusEnum } from '../enums/RefundStatusEnum';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+/** Un reembolso de enganche de la tienda en el Portal Vendedor (GET /portal/pending-refunds). */
+export interface SellerPendingRefundItem {
+    sessionId: string;
+    storeId: string;
+    sellerId: string | null;
+    sellerName: string | null;
+    creditId: string | null;
+    folio: string | null;
+    refundPendingCents: number;
+    /** `null` = el registro no guardó con qué se cobró el enganche; no se puede marcar entregado. */
+    paymentMethod: SalePaymentMethodEnum | null;
+    status: RefundStatusEnum;
+    /** `true` si el vendedor puede marcarlo entregado: efectivo y pendiente. */
+    deliverable: boolean;
+    cancelledAt: string;
+    /** Actor que canceló la venta (cognitoSub o nombre del lambda). */
+    cancelledBy: string;
+    deliveredAt: string | null;
+    deliveredBy: string | null;
+    deliveredByName: string | null;
+}

package/bin/retailWizard/dtos/SellerPendingRefundItem.js

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

package/bin/retailWizard/dtos/responses/StorePendingRefundsResponse.d.ts

@@ -0,0 +1,7 @@
+import { SellerPendingRefundItem } from '../SellerPendingRefundItem';
+/** Respuesta de GET /portal/pending-refunds: pendientes de la tienda y entregados de los últimos 30 días. */
+export interface StorePendingRefundsResponse {
+    refunds: SellerPendingRefundItem[];
+    pendingCount: number;
+    pendingTotalCents: number;
+}

package/bin/retailWizard/dtos/responses/StorePendingRefundsResponse.js

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

package/bin/retailWizard/enums/RefundStatusEnum.d.ts

@@ -0,0 +1,5 @@
+/** Estado del reembolso de enganche de una venta a crédito cancelada. SureKeep — Portal Vendedor. */
+export declare enum RefundStatusEnum {
+    PENDING = "PENDING",
+    DELIVERED = "DELIVERED"
+}

package/bin/retailWizard/enums/RefundStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundStatusEnum = void 0;
+/** Estado del reembolso de enganche de una venta a crédito cancelada. SureKeep — Portal Vendedor. */
+var RefundStatusEnum;
+(function (RefundStatusEnum) {
+    RefundStatusEnum["PENDING"] = "PENDING";
+    RefundStatusEnum["DELIVERED"] = "DELIVERED";
+})(RefundStatusEnum || (exports.RefundStatusEnum = RefundStatusEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -7,6 +7,7 @@ export * from './enums/PaymentMethodEnum';
 export * from './enums/ExternalProviderEnum';
 export * from './enums/SaleTypeEnum';
 export * from './enums/SalePaymentMethodEnum';
+export * from './enums/RefundStatusEnum';
 export * from './enums/SaleStatusEnum';
 export * from './enums/CentralSyncStatusEnum';
 export * from './enums/ProspectStatusEnum';
@@ -102,6 +103,8 @@ export * from './dtos/requests/SuggestIdentifiersQuery';
 export * from './dtos/requests/SendEmailOtpRequest';
 export * from './dtos/requests/VerifyEmailOtpRequest';
 export * from './dtos/requests/CreateAccessorySaleRequest';
+export * from './dtos/SellerPendingRefundItem';
+export * from './dtos/responses/StorePendingRefundsResponse';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';

package/bin/retailWizard/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./enums/PaymentMethodEnum"), exports);
 __exportStar(require("./enums/ExternalProviderEnum"), exports);
 __exportStar(require("./enums/SaleTypeEnum"), exports);
 __exportStar(require("./enums/SalePaymentMethodEnum"), exports);
+__exportStar(require("./enums/RefundStatusEnum"), exports);
 __exportStar(require("./enums/SaleStatusEnum"), exports);
 __exportStar(require("./enums/CentralSyncStatusEnum"), exports);
 __exportStar(require("./enums/ProspectStatusEnum"), exports);
@@ -128,6 +129,8 @@ __exportStar(require("./dtos/requests/SendEmailOtpRequest"), exports);
 __exportStar(require("./dtos/requests/VerifyEmailOtpRequest"), exports);
 __exportStar(require("./dtos/requests/CreateAccessorySaleRequest"), exports);
 // Response DTOs (output tipado por endpoint)
+__exportStar(require("./dtos/SellerPendingRefundItem"), exports);
+__exportStar(require("./dtos/responses/StorePendingRefundsResponse"), exports);
 __exportStar(require("./dtos/responses/KycPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/ProofOfAddressPrepareResponse"), exports);
 __exportStar(require("./dtos/responses/SessionFinanciersResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.568.0",
+  "version": "3.570.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/collection/enums/DisbursementType.ts

@@ -1,7 +1,10 @@
 /**
- * Riel por el que el motor de cobro deposita una dispersión. Nombra el movimiento, no el propósito:
- * el propósito lo manda el llamador en `concept`.
+ * Producto con el que el motor de cobro deposita una dispersión.
+ * El detalle para la persona va en `concept`.
  */
 export enum DisbursementType {
+    /** Bono. */
     MEX_BONUS = 'MEX_BONUS',
+    /** Comisión de vendedor. */
+    MEX_SELLER_COMMISSION = 'MEX_SELLER_COMMISSION',
 }

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -83,6 +83,8 @@ export enum ProductSubtypeEnum {
 
     //SUREKEEP
     SUREKEEP_BONUS_MX = "BONUS_MX",
+    // Comisión de vendedor de SureKeep abonada a la wallet.
+    SUREKEEP_SELLER_COMMISSION_MX = "SELLER_COMMISSION_MX",
 
     //STORE
     STORE_PHONE = "PHONE",

package/src/retailWizard/dtos/SellerPendingRefundItem.ts

@@ -0,0 +1,24 @@
+import { RefundStatusEnum } from '../enums/RefundStatusEnum';
+import { SalePaymentMethodEnum } from '../enums/SalePaymentMethodEnum';
+
+/** Un reembolso de enganche de la tienda en el Portal Vendedor (GET /portal/pending-refunds). */
+export interface SellerPendingRefundItem {
+    sessionId: string;
+    storeId: string;
+    sellerId: string | null;
+    sellerName: string | null;
+    creditId: string | null;
+    folio: string | null;
+    refundPendingCents: number;
+    /** `null` = el registro no guardó con qué se cobró el enganche; no se puede marcar entregado. */
+    paymentMethod: SalePaymentMethodEnum | null;
+    status: RefundStatusEnum;
+    /** `true` si el vendedor puede marcarlo entregado: efectivo y pendiente. */
+    deliverable: boolean;
+    cancelledAt: string;
+    /** Actor que canceló la venta (cognitoSub o nombre del lambda). */
+    cancelledBy: string;
+    deliveredAt: string | null;
+    deliveredBy: string | null;
+    deliveredByName: string | null;
+}

package/src/retailWizard/dtos/responses/StorePendingRefundsResponse.ts

@@ -0,0 +1,8 @@
+import { SellerPendingRefundItem } from '../SellerPendingRefundItem';
+
+/** Respuesta de GET /portal/pending-refunds: pendientes de la tienda y entregados de los últimos 30 días. */
+export interface StorePendingRefundsResponse {
+    refunds: SellerPendingRefundItem[];
+    pendingCount: number;
+    pendingTotalCents: number;
+}

package/src/retailWizard/enums/RefundStatusEnum.ts

@@ -0,0 +1,5 @@
+/** Estado del reembolso de enganche de una venta a crédito cancelada. SureKeep — Portal Vendedor. */
+export enum RefundStatusEnum {
+    PENDING = 'PENDING',
+    DELIVERED = 'DELIVERED',
+}

package/src/retailWizard/index.ts

@@ -10,6 +10,7 @@ export * from './enums/PaymentMethodEnum';
 export * from './enums/ExternalProviderEnum';
 export * from './enums/SaleTypeEnum';
 export * from './enums/SalePaymentMethodEnum';
+export * from './enums/RefundStatusEnum';
 export * from './enums/SaleStatusEnum';
 export * from './enums/CentralSyncStatusEnum';
 export * from './enums/ProspectStatusEnum';
@@ -115,6 +116,8 @@ export * from './dtos/requests/VerifyEmailOtpRequest';
 export * from './dtos/requests/CreateAccessorySaleRequest';
 
 // Response DTOs (output tipado por endpoint)
+export * from './dtos/SellerPendingRefundItem';
+export * from './dtos/responses/StorePendingRefundsResponse';
 export * from './dtos/responses/KycPrepareResponse';
 export * from './dtos/responses/ProofOfAddressPrepareResponse';
 export * from './dtos/responses/SessionFinanciersResponse';