@fiado/type-kit 3.316.1 → 3.317.0

package/_test_/unit/retailCustomer/welcomeBonusRequests.test.ts

@@ -0,0 +1,153 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { WelcomeAccreditationRequest } from '../../../src/retailCustomer/dtos/requests/WelcomeAccreditationRequest';
+import { WelcomeAccreditationResultRequest } from '../../../src/retailCustomer/dtos/requests/WelcomeAccreditationResultRequest';
+import { WelcomeBonusStatusEnum } from '../../../src/retailCustomer/enums/WelcomeBonusStatusEnum';
+import { WelcomeBonusAmountSourceEnum } from '../../../src/retailCustomer/enums/WelcomeBonusAmountSourceEnum';
+import { WelcomeBonusSettlementStatusEnum } from '../../../src/retailCustomer/enums/WelcomeBonusSettlementStatusEnum';
+
+/** Valida como lo hace `retail-customer-business`: con `@Expose` y `excludeExtraneousValues`. */
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+    const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+    return validateSync(dto).map((e) => e.property);
+}
+
+describe('WelcomeAccreditationRequest — los datos de la venta son opcionales', () => {
+    // Durante la ventana de despliegue el wizard viejo llama sin body: el asiento nace incompleto,
+    // pero nace. Si el DTO exigiera los campos, la acreditación se caería con 400.
+    it('acepta un body vacío', () => {
+        expect(errorsOf(WelcomeAccreditationRequest, {})).toEqual([]);
+    });
+
+    it('acepta el juego completo de datos de la venta', () => {
+        expect(
+            errorsOf(WelcomeAccreditationRequest, {
+                storeId: 'store-1',
+                retailerId: 'surekeep',
+                sellerRetailUserId: 'user-1',
+                saleId: 'sale-1',
+                folio: 'F-001',
+                wizardSessionId: 'sess-1',
+                amountCents: 10_000,
+                currency: 'MXN',
+                amountSource: WelcomeBonusAmountSourceEnum.PARAM,
+                idempotencyKey: 'SUREKEEP-WELCOME-c1',
+                providerName: 'surekeep-welcome-bonus',
+            }),
+        ).toEqual([]);
+    });
+
+    // `storeId` es la partición del asiento: en blanco degradaría la pk a una constante.
+    it('rechaza un storeId en blanco', () => {
+        for (const storeId of ['', '   ']) {
+            expect(errorsOf(WelcomeAccreditationRequest, { storeId })).toContain('storeId');
+        }
+    });
+
+    it('recorta los espacios del storeId antes de que llegue al dominio', () => {
+        const dto = plainToInstance(
+            WelcomeAccreditationRequest,
+            { storeId: '  store-1 ' },
+            { excludeExtraneousValues: true },
+        );
+        expect(dto.storeId).toBe('store-1');
+    });
+
+    it('rechaza un monto de 0, negativo o fraccionario', () => {
+        for (const amountCents of [0, -1, 1.5]) {
+            expect(errorsOf(WelcomeAccreditationRequest, { amountCents })).toContain('amountCents');
+        }
+    });
+
+    it('rechaza un amountSource fuera del catálogo', () => {
+        expect(errorsOf(WelcomeAccreditationRequest, { amountSource: 'INVENTADO' })).toContain(
+            'amountSource',
+        );
+    });
+});
+
+describe('WelcomeAccreditationResultRequest — cerrar el asiento', () => {
+    it('acepta ACCREDITED con la transacción del processor', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                bonusKey: 'key-1',
+                status: WelcomeBonusStatusEnum.ACCREDITED,
+                processorTransactionId: 'tx-1',
+            }),
+        ).toEqual([]);
+    });
+
+    // Sin la transacción del processor el asiento ACCREDITED no es conciliable contra nada.
+    it('exige processorTransactionId cuando el resultado es ACCREDITED', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                bonusKey: 'key-1',
+                status: WelcomeBonusStatusEnum.ACCREDITED,
+            }),
+        ).toContain('processorTransactionId');
+    });
+
+    it.each([WelcomeBonusStatusEnum.FAILED, WelcomeBonusStatusEnum.UNVERIFIED])(
+        'exige failReason cuando el resultado es %s',
+        (status) => {
+            expect(errorsOf(WelcomeAccreditationResultRequest, { bonusKey: 'key-1', status })).toContain(
+                'failReason',
+            );
+        },
+    );
+
+    it.each([WelcomeBonusStatusEnum.FAILED, WelcomeBonusStatusEnum.UNVERIFIED])(
+        'acepta %s con su motivo',
+        (status) => {
+            expect(
+                errorsOf(WelcomeAccreditationResultRequest, {
+                    bonusKey: 'key-1',
+                    status,
+                    failReason: 'timeout del processor',
+                }),
+            ).toEqual([]);
+        },
+    );
+
+    // PENDING es el estado inicial que escribe el server, no un resultado que el caller pueda mandar.
+    it('rechaza PENDING como resultado', () => {
+        expect(
+            errorsOf(WelcomeAccreditationResultRequest, {
+                bonusKey: 'key-1',
+                status: WelcomeBonusStatusEnum.PENDING,
+            }),
+        ).toContain('status');
+    });
+
+    it('exige el bonusKey: sin él no se sabe qué asiento cerrar', () => {
+        for (const bonusKey of [undefined, '', '   ']) {
+            expect(
+                errorsOf(WelcomeAccreditationResultRequest, {
+                    bonusKey,
+                    status: WelcomeBonusStatusEnum.ACCREDITED,
+                    processorTransactionId: 'tx-1',
+                }),
+            ).toContain('bonusKey');
+        }
+    });
+});
+
+describe('enums del bono de bienvenida', () => {
+    it('el estado del asiento distingue el fallo inequívoco del ambiguo', () => {
+        expect(Object.values(WelcomeBonusStatusEnum)).toEqual([
+            'PENDING',
+            'ACCREDITED',
+            'FAILED',
+            'UNVERIFIED',
+        ]);
+    });
+
+    it('la conciliación arranca pendiente de remitir', () => {
+        expect(Object.values(WelcomeBonusSettlementStatusEnum)).toEqual(['PENDING', 'REMITTED']);
+    });
+
+    it('el origen del monto distingue el parámetro del fallback local', () => {
+        expect(Object.values(WelcomeBonusAmountSourceEnum)).toEqual(['PARAM', 'DEFAULT']);
+    });
+});

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationRequest.d.ts

@@ -0,0 +1,27 @@
+import { WelcomeBonusAmountSourceEnum } from '../../enums/WelcomeBonusAmountSourceEnum';
+/**
+ * Datos de la venta que acompañan la reserva del bono de bienvenida (D33):
+ * `POST /private/customers/:id/welcome-accreditation`. SureKeep Fase 2 — pista Retail.
+ *
+ * **TODOS los campos son opcionales a propósito.** El customer despliega antes que el wizard, así que
+ * durante la ventana el wizard viejo sigue llamando sin body: el asiento nace incompleto y se acredita
+ * igual. Exigirlos convertiría esa ventana en un 400 que deja al cliente sin bono.
+ */
+export declare class WelcomeAccreditationRequest {
+    /** Tienda donde se dio el bono — es la partición del asiento. */
+    storeId?: string;
+    retailerId?: string;
+    /** Vendedor que cerró la venta. */
+    sellerRetailUserId?: string;
+    saleId?: string;
+    /** Folio de la venta, tal como lo ve el vendedor en el ticket. */
+    folio?: string;
+    wizardSessionId?: string;
+    amountCents?: number;
+    /** ISO-4217. Ausente ⇒ el server asienta `MXN`. */
+    currency?: string;
+    amountSource?: WelcomeBonusAmountSourceEnum;
+    /** Clave con la que el caller acredita en el processor — ata el asiento al movimiento de plata. */
+    idempotencyKey?: string;
+    providerName?: string;
+}

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationRequest.js

@@ -0,0 +1,113 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WelcomeAccreditationRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const WelcomeBonusAmountSourceEnum_1 = require("../../enums/WelcomeBonusAmountSourceEnum");
+/** Recorta los strings del borde: un valor con espacios ensucia claves y cortes de conciliación. */
+const trim = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value));
+/**
+ * Datos de la venta que acompañan la reserva del bono de bienvenida (D33):
+ * `POST /private/customers/:id/welcome-accreditation`. SureKeep Fase 2 — pista Retail.
+ *
+ * **TODOS los campos son opcionales a propósito.** El customer despliega antes que el wizard, así que
+ * durante la ventana el wizard viejo sigue llamando sin body: el asiento nace incompleto y se acredita
+ * igual. Exigirlos convertiría esa ventana en un 400 que deja al cliente sin bono.
+ */
+class WelcomeAccreditationRequest {
+}
+exports.WelcomeAccreditationRequest = WelcomeAccreditationRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "sellerRetailUserId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "saleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "folio", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "wizardSessionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], WelcomeAccreditationRequest.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "currency", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(WelcomeBonusAmountSourceEnum_1.WelcomeBonusAmountSourceEnum),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "amountSource", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationRequest.prototype, "providerName", void 0);

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationResultRequest.d.ts

@@ -0,0 +1,17 @@
+import { WelcomeBonusStatusEnum } from '../../enums/WelcomeBonusStatusEnum';
+/**
+ * Cierre del asiento del bono de bienvenida (D33):
+ * `PUT /private/customers/:id/welcome-accreditation/result`. SureKeep Fase 2 — pista Retail.
+ *
+ * `FAILED` libera el candado `welcomeAccredited` para que la venta se reintente. `UNVERIFIED` lo deja
+ * tomado: el `walletFundingCredit` del processor no deduplica, así que liberar tras un timeout podría
+ * acreditar plata real dos veces.
+ */
+export declare class WelcomeAccreditationResultRequest {
+    /** Referencia opaca del asiento, tal como la devolvió la reserva. */
+    bonusKey: string;
+    status: WelcomeBonusStatusEnum;
+    processorTransactionId?: string;
+    failReason?: string;
+    providerName?: string;
+}

package/bin/retailCustomer/dtos/requests/WelcomeAccreditationResultRequest.js

@@ -0,0 +1,75 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WelcomeAccreditationResultRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const WelcomeBonusStatusEnum_1 = require("../../enums/WelcomeBonusStatusEnum");
+/** Recorta los strings del borde: un valor con espacios ensucia claves y cortes de conciliación. */
+const trim = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value));
+/** Resultados que el caller puede asentar. `PENDING` lo escribe el server al reservar, no el caller. */
+const RESULT_STATUSES = [
+    WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.ACCREDITED,
+    WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.FAILED,
+    WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.UNVERIFIED,
+];
+/** Resultados que exigen un motivo legible: sin él nadie puede revisar el asiento después. */
+const STATUSES_REQUIRING_REASON = [
+    WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.FAILED,
+    WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.UNVERIFIED,
+];
+/**
+ * Cierre del asiento del bono de bienvenida (D33):
+ * `PUT /private/customers/:id/welcome-accreditation/result`. SureKeep Fase 2 — pista Retail.
+ *
+ * `FAILED` libera el candado `welcomeAccredited` para que la venta se reintente. `UNVERIFIED` lo deja
+ * tomado: el `walletFundingCredit` del processor no deduplica, así que liberar tras un timeout podría
+ * acreditar plata real dos veces.
+ */
+class WelcomeAccreditationResultRequest {
+}
+exports.WelcomeAccreditationResultRequest = WelcomeAccreditationResultRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "bonusKey", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsIn)(RESULT_STATUSES),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.status === WelcomeBonusStatusEnum_1.WelcomeBonusStatusEnum.ACCREDITED),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)({ message: 'processorTransactionId es obligatorio cuando status es ACCREDITED' }),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "processorTransactionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => STATUSES_REQUIRING_REASON.includes(o.status)),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)({ message: 'failReason es obligatorio cuando status es FAILED o UNVERIFIED' }),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "failReason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    trim(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], WelcomeAccreditationResultRequest.prototype, "providerName", void 0);

package/bin/retailCustomer/dtos/responses/WelcomeAccreditationResponse.d.ts

@@ -0,0 +1,12 @@
+import { CustomerResponse } from './CustomerResponse';
+import { WelcomeBonusResponse } from './WelcomeBonusResponse';
+/**
+ * Respuesta de la reserva del bono de bienvenida (D33): el cliente con el candado ya tomado y el
+ * asiento recién abierto en `PENDING`. SureKeep Fase 2 — pista Retail.
+ *
+ * El `bonus.bonusKey` es lo que el caller guarda para cerrar el asiento con el resultado del processor.
+ */
+export interface WelcomeAccreditationResponse {
+    customer: CustomerResponse;
+    bonus: WelcomeBonusResponse;
+}

package/bin/retailCustomer/dtos/responses/WelcomeBonusResponse.d.ts

@@ -0,0 +1,43 @@
+import { WelcomeBonusAmountSourceEnum } from '../../enums/WelcomeBonusAmountSourceEnum';
+import { WelcomeBonusSettlementStatusEnum } from '../../enums/WelcomeBonusSettlementStatusEnum';
+import { WelcomeBonusStatusEnum } from '../../enums/WelcomeBonusStatusEnum';
+/**
+ * Asiento del bono de bienvenida (D33) hacia el consumidor. SureKeep Fase 2 — pista Retail.
+ *
+ * Es el libro contable del bono: monto, venta, tienda, vendedor y resultado del processor, para
+ * conciliar contra quien absorbe el costo (`fundedBy`). La unicidad del bono NO vive acá — sigue en
+ * `RetailCustomer.welcomeAccredited`.
+ *
+ * ⚠️ **Sin PII**: no lleva nombre, teléfono ni CLABE. El Cliente 360 los resuelve por
+ * `retailCustomerId`.
+ */
+export interface WelcomeBonusResponse {
+    bonusId: string;
+    /** Referencia opaca del asiento — es lo que el caller manda para cerrarlo. */
+    bonusKey: string;
+    retailCustomerId: string;
+    fiadoDirectoryId: string | null;
+    saleId: string | null;
+    folio: string | null;
+    wizardSessionId: string | null;
+    retailerId: string | null;
+    /** Tienda donde se dio el bono. `UNKNOWN` cuando el caller no la declaró. */
+    storeId: string;
+    sellerRetailUserId: string | null;
+    amountCents: number | null;
+    currency: string;
+    amountSource: WelcomeBonusAmountSourceEnum | null;
+    status: WelcomeBonusStatusEnum;
+    failReason: string | null;
+    requestedAt: string;
+    resolvedAt: string | null;
+    processorTransactionId: string | null;
+    idempotencyKey: string | null;
+    providerName: string | null;
+    /** Quién absorbe el costo del bono. */
+    fundedBy: string;
+    settlementStatus: WelcomeBonusSettlementStatusEnum;
+    settlementBatchId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/retailCustomer/enums/WelcomeBonusAmountSourceEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * De dónde salió el monto del bono. SureKeep Fase 2 — pista Retail.
+ *
+ * El resolver del wizard cae a un default local cuando `loan-config` no responde; para conciliar
+ * importa distinguir el monto parametrizado del que salió del fallback.
+ */
+export declare enum WelcomeBonusAmountSourceEnum {
+    /** Parámetro de negocio de `loan-config` (`WELCOME_BONUS/amount_cents`). */
+    PARAM = "PARAM",
+    /** Default local del wizard, usado porque `loan-config` no respondió. */
+    DEFAULT = "DEFAULT"
+}

package/bin/retailCustomer/enums/WelcomeBonusAmountSourceEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WelcomeBonusAmountSourceEnum = void 0;
+/**
+ * De dónde salió el monto del bono. SureKeep Fase 2 — pista Retail.
+ *
+ * El resolver del wizard cae a un default local cuando `loan-config` no responde; para conciliar
+ * importa distinguir el monto parametrizado del que salió del fallback.
+ */
+var WelcomeBonusAmountSourceEnum;
+(function (WelcomeBonusAmountSourceEnum) {
+    /** Parámetro de negocio de `loan-config` (`WELCOME_BONUS/amount_cents`). */
+    WelcomeBonusAmountSourceEnum["PARAM"] = "PARAM";
+    /** Default local del wizard, usado porque `loan-config` no respondió. */
+    WelcomeBonusAmountSourceEnum["DEFAULT"] = "DEFAULT";
+})(WelcomeBonusAmountSourceEnum || (exports.WelcomeBonusAmountSourceEnum = WelcomeBonusAmountSourceEnum = {}));

package/bin/retailCustomer/enums/WelcomeBonusSettlementStatusEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de conciliación del asiento contra quien absorbe el costo del bono (`fundedBy`).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum WelcomeBonusSettlementStatusEnum {
+    /** Asentado y todavía no remitido a quien lo financia. */
+    PENDING = "PENDING",
+    /** Ya incluido en un lote de remisión (`settlementBatchId`). */
+    REMITTED = "REMITTED"
+}

package/bin/retailCustomer/enums/WelcomeBonusSettlementStatusEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WelcomeBonusSettlementStatusEnum = void 0;
+/**
+ * Estado de conciliación del asiento contra quien absorbe el costo del bono (`fundedBy`).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var WelcomeBonusSettlementStatusEnum;
+(function (WelcomeBonusSettlementStatusEnum) {
+    /** Asentado y todavía no remitido a quien lo financia. */
+    WelcomeBonusSettlementStatusEnum["PENDING"] = "PENDING";
+    /** Ya incluido en un lote de remisión (`settlementBatchId`). */
+    WelcomeBonusSettlementStatusEnum["REMITTED"] = "REMITTED";
+})(WelcomeBonusSettlementStatusEnum || (exports.WelcomeBonusSettlementStatusEnum = WelcomeBonusSettlementStatusEnum = {}));

package/bin/retailCustomer/enums/WelcomeBonusStatusEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Estado del asiento del bono de bienvenida (D33). SureKeep Fase 2 — pista Retail.
+ *
+ * El fallo del processor NO es una sola cosa: `FAILED` es un rechazo inequívoco y libera el candado
+ * `welcomeAccredited` para reintentar; `UNVERIFIED` es un fallo ambiguo (timeout, 5xx) que pudo haber
+ * movido plata, así que el candado queda tomado y el caso va a revisión manual.
+ */
+export declare enum WelcomeBonusStatusEnum {
+    /** Asiento reservado, antes de llamar al processor. */
+    PENDING = "PENDING",
+    /** El processor confirmó la acreditación (llega con `processorTransactionId`). */
+    ACCREDITED = "ACCREDITED",
+    /** Rechazo inequívoco del processor. Libera el candado → reintentable. */
+    FAILED = "FAILED",
+    /** Fallo ambiguo: no se sabe si acreditó. Candado tomado → revisión manual. */
+    UNVERIFIED = "UNVERIFIED"
+}

package/bin/retailCustomer/enums/WelcomeBonusStatusEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WelcomeBonusStatusEnum = void 0;
+/**
+ * Estado del asiento del bono de bienvenida (D33). SureKeep Fase 2 — pista Retail.
+ *
+ * El fallo del processor NO es una sola cosa: `FAILED` es un rechazo inequívoco y libera el candado
+ * `welcomeAccredited` para reintentar; `UNVERIFIED` es un fallo ambiguo (timeout, 5xx) que pudo haber
+ * movido plata, así que el candado queda tomado y el caso va a revisión manual.
+ */
+var WelcomeBonusStatusEnum;
+(function (WelcomeBonusStatusEnum) {
+    /** Asiento reservado, antes de llamar al processor. */
+    WelcomeBonusStatusEnum["PENDING"] = "PENDING";
+    /** El processor confirmó la acreditación (llega con `processorTransactionId`). */
+    WelcomeBonusStatusEnum["ACCREDITED"] = "ACCREDITED";
+    /** Rechazo inequívoco del processor. Libera el candado → reintentable. */
+    WelcomeBonusStatusEnum["FAILED"] = "FAILED";
+    /** Fallo ambiguo: no se sabe si acreditó. Candado tomado → revisión manual. */
+    WelcomeBonusStatusEnum["UNVERIFIED"] = "UNVERIFIED";
+})(WelcomeBonusStatusEnum || (exports.WelcomeBonusStatusEnum = WelcomeBonusStatusEnum = {}));

package/bin/retailCustomer/index.d.ts

@@ -3,6 +3,9 @@ export * from './enums/RetailKycStatusEnum';
 export * from './enums/KycModalityEnum';
 export * from './enums/KycReviewResultEnum';
 export * from './enums/RetailCustomerStatusEnum';
+export * from './enums/WelcomeBonusStatusEnum';
+export * from './enums/WelcomeBonusAmountSourceEnum';
+export * from './enums/WelcomeBonusSettlementStatusEnum';
 export * from './dtos/KycReview';
 export * from './dtos/RetailAddress';
 export * from './dtos/RetailCustomer';
@@ -11,8 +14,12 @@ export * from './dtos/requests/UpsertCustomerFromKycRequest';
 export * from './dtos/requests/UpdateCustomerRequest';
 export * from './dtos/requests/AccountResultRequest';
 export * from './dtos/requests/KycReviewRequest';
+export * from './dtos/requests/WelcomeAccreditationRequest';
+export * from './dtos/requests/WelcomeAccreditationResultRequest';
 export * from './dtos/responses/CustomerResponse';
 export * from './dtos/responses/Customer360Response';
+export * from './dtos/responses/WelcomeBonusResponse';
+export * from './dtos/responses/WelcomeAccreditationResponse';
 export * from './events/CustomerCreatedV1';
 export * from './events/CustomerUpdatedV1';
 export * from './events/CustomerKycVerifiedV1';

package/bin/retailCustomer/index.js

@@ -20,6 +20,9 @@ __exportStar(require("./enums/RetailKycStatusEnum"), exports);
 __exportStar(require("./enums/KycModalityEnum"), exports);
 __exportStar(require("./enums/KycReviewResultEnum"), exports);
 __exportStar(require("./enums/RetailCustomerStatusEnum"), exports);
+__exportStar(require("./enums/WelcomeBonusStatusEnum"), exports);
+__exportStar(require("./enums/WelcomeBonusAmountSourceEnum"), exports);
+__exportStar(require("./enums/WelcomeBonusSettlementStatusEnum"), exports);
 // Entidades (planas, con class-validator + @Expose)
 __exportStar(require("./dtos/KycReview"), exports);
 __exportStar(require("./dtos/RetailAddress"), exports);
@@ -30,9 +33,13 @@ __exportStar(require("./dtos/requests/UpsertCustomerFromKycRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateCustomerRequest"), exports);
 __exportStar(require("./dtos/requests/AccountResultRequest"), exports);
 __exportStar(require("./dtos/requests/KycReviewRequest"), exports);
+__exportStar(require("./dtos/requests/WelcomeAccreditationRequest"), exports);
+__exportStar(require("./dtos/requests/WelcomeAccreditationResultRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CustomerResponse"), exports);
 __exportStar(require("./dtos/responses/Customer360Response"), exports);
+__exportStar(require("./dtos/responses/WelcomeBonusResponse"), exports);
+__exportStar(require("./dtos/responses/WelcomeAccreditationResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/CustomerCreatedV1"), exports);
 __exportStar(require("./events/CustomerUpdatedV1"), exports);

package/bin/walletFunding/dtos/CreditWalletFundingRequest.d.ts

@@ -19,18 +19,4 @@ export declare class CreditWalletFundingRequest {
     center?: string;
     /** Si viene, la FiadoTx se crea con este folio en vez de generar uno nuevo. */
     processorTransactionNumber?: string;
-    /**
-     * Producto de `ProductCatalog_GT` con el que tarifar este fondeo — de ahi
-     * salen la comision que Fiado le cobra al cliente y su IVA.
-     *
-     * Lo decide el CONNECTOR y no el processor porque la tarifa depende del
-     * canal, y solo el connector ve donde pago el cliente: el proveedor manda
-     * el comercio en el webhook del cash-in. Ej. `SP_CASH_IN` (cuota fija fuera
-     * de OXXO) vs `SP_CASH_IN_OXXO` (porcentual en OXXO).
-     *
-     * Opcional por compatibilidad: los callers que no lo mandan siguen cayendo
-     * al producto por defecto del processor (`MEX_WALLET_FUNDING_CREDIT`), que
-     * es el que usa Equality/Passport hoy.
-     */
-    productCatalogId?: string;
 }

package/bin/walletFunding/dtos/CreditWalletFundingRequest.js

@@ -65,9 +65,3 @@ __decorate([
     (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
 ], CreditWalletFundingRequest.prototype, "processorTransactionNumber", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CreditWalletFundingRequest.prototype, "productCatalogId", void 0);

package/package.json

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