@fiado/type-kit 3.555.0 → 3.556.0

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

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import { SystemCancelReasonEnum } from '../../../src/retailWizard';
+
+describe('SystemCancelReasonEnum — motivos de la apertura', () => {
+  it('declara ALREADY_HAS_ACCOUNT y CURP_OF_OTHER_CUSTOMER', () => {
+    expect(SystemCancelReasonEnum.ALREADY_HAS_ACCOUNT).toBe('ALREADY_HAS_ACCOUNT');
+    expect(SystemCancelReasonEnum.CURP_OF_OTHER_CUSTOMER).toBe('CURP_OF_OTHER_CUSTOMER');
+  });
+});

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

@@ -0,0 +1,37 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { StartSessionRequest, type WizardSession } from '../../../src/retailWizard';
+
+function startErrors(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(StartSessionRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('StartSessionRequest — marca accountOpening', () => {
+  it('sin la marca sigue igual que hoy', () => {
+    expect(startErrors({ phone: '5512345678' })).toEqual([]);
+  });
+
+  it.each([true, false])('acepta accountOpening=%s y lo conserva', (value) => {
+    const dto = plainToInstance(
+      StartSessionRequest,
+      { phone: '5512345678', accountOpening: value },
+      { excludeExtraneousValues: true },
+    );
+    expect(validateSync(dto)).toEqual([]);
+    expect(dto.accountOpening).toBe(value);
+  });
+
+  it.each(['true', 1, 'si'])('rechaza accountOpening no booleano (%p)', (value) => {
+    expect(startErrors({ phone: '5512345678', accountOpening: value })).toContain('accountOpening');
+  });
+});
+
+describe('WizardSession — marca accountOpening', () => {
+  it('es opcional en la sesión', () => {
+    const session: Pick<WizardSession, 'accountOpening'> = { accountOpening: true };
+    const legacy: Pick<WizardSession, 'accountOpening'> = {};
+    expect([session.accountOpening, legacy.accountOpening]).toEqual([true, undefined]);
+  });
+});

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

@@ -0,0 +1,44 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { OccupationEnum, OccupationRequest } from '../../../src/retailWizard';
+
+function occupationErrors(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(OccupationRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+const BASE_OCCUPATION = { occupation: OccupationEnum.EMPLOYED, monthlyIncome: '20000' };
+const FULL_PROFILE = {
+  monthlyExtraSupport: '0',
+  usageMonthly: '60',
+  maximumTx: '10000',
+  beneficialOwner: 'SELF',
+};
+
+describe('OccupationRequest — 4 MXN_* opcionales para la apertura', () => {
+  it('sin los MXN_* sigue igual que hoy', () => {
+    expect(occupationErrors(BASE_OCCUPATION)).toEqual([]);
+  });
+
+  it('acepta el perfil completo del catálogo y lo conserva', () => {
+    const dto = plainToInstance(
+      OccupationRequest,
+      { ...BASE_OCCUPATION, ...FULL_PROFILE },
+      { excludeExtraneousValues: true },
+    );
+    expect(validateSync(dto)).toEqual([]);
+    expect(dto).toMatchObject(FULL_PROFILE);
+  });
+
+  it('acepta OTHER en beneficialOwner: lo rechaza el negocio, no el DTO', () => {
+    expect(occupationErrors({ ...BASE_OCCUPATION, beneficialOwner: 'OTHER' })).toEqual([]);
+  });
+
+  it.each(['monthlyExtraSupport', 'usageMonthly', 'maximumTx', 'beneficialOwner'])(
+    'rechaza %s fuera del catálogo',
+    (field) => {
+      expect(occupationErrors({ ...BASE_OCCUPATION, ...FULL_PROFILE, [field]: 'X' })).toEqual([field]);
+    },
+  );
+});

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

@@ -0,0 +1,22 @@
+import 'reflect-metadata';
+import type { BackofficeAccountOpeningsResponse } from '../../../src/retailWizard';
+
+describe('BackofficeAccountOpeningsResponse', () => {
+  it('declara las filas de aperturas y el cursor', () => {
+    const response: BackofficeAccountOpeningsResponse = {
+      nextToken: null,
+      items: [
+        {
+          sessionId: 'S1',
+          retailCustomerId: 'RC-1',
+          name: null,
+          phone: '5512345678',
+          storeId: 'ST-1',
+          sellerRetailUserId: 'RU-1',
+          openedAt: '2026-10-20T18:00:00.000Z',
+        },
+      ],
+    };
+    expect(response.items[0].sessionId).toBe('S1');
+  });
+});

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

@@ -156,6 +156,8 @@ export interface WizardSession {
      * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
      */
     cashOnly?: boolean;
+    /** Sesión de apertura de cuenta sin venta; ausente = venta de siempre. */
+    accountOpening?: boolean;
     /** TTL DDB ~24h de inactividad (D14). */
     ttlEpoch: number;
     createdBy: string;

package/bin/retailWizard/dtos/requests/OccupationRequest.d.ts

@@ -8,4 +8,9 @@ export declare class OccupationRequest {
     occupationOther?: string;
     /** Mismo catálogo cerrado que el paso 10 (`ProfileQuestionsRequest`). */
     monthlyIncome: string;
+    /** MXN_* del perfil transaccional: opcionales aquí, la apertura de cuenta los exige en negocio. */
+    monthlyExtraSupport?: string;
+    usageMonthly?: string;
+    maximumTx?: string;
+    beneficialOwner?: string;
 }

package/bin/retailWizard/dtos/requests/OccupationRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const OccupationEnum_1 = require("../../enums/OccupationEnum");
 const monthlyIncome_1 = require("../../catalog/monthlyIncome");
+const ProfileQuestionsRequest_1 = require("./ProfileQuestionsRequest");
 /**
  * POST /wizard/sessions/:id/occupation — registra la ocupación y el ingreso mensual del expediente
  * PCF (viven en People de Fiado — D17). Los dos obligatorios; `OTHER` abre texto ≤60.
@@ -39,3 +40,31 @@ __decorate([
     (0, class_validator_1.IsIn)(monthlyIncome_1.MONTHLY_INCOME_VALUES),
     __metadata("design:type", String)
 ], OccupationRequest.prototype, "monthlyIncome", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.EXTRA_SUPPORT_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "monthlyExtraSupport", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.USAGE_MONTHLY_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "usageMonthly", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.MAXIMUM_TX_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "maximumTx", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.BENEFICIAL_OWNER_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "beneficialOwner", void 0);

package/bin/retailWizard/dtos/requests/StartSessionRequest.d.ts

@@ -7,4 +7,6 @@ export declare class StartSessionRequest {
     phone: string;
     /** Prospecto a reanudar (opcional): si viene, la sesión se vincula al prospecto. */
     prospectId?: string;
+    /** Marca de apertura de cuenta sin venta; ausente = venta de siempre. */
+    accountOpening?: boolean;
 }

package/bin/retailWizard/dtos/requests/StartSessionRequest.js

@@ -33,3 +33,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], StartSessionRequest.prototype, "prospectId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StartSessionRequest.prototype, "accountOpening", void 0);

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

@@ -0,0 +1,19 @@
+/** Una apertura de cuenta sin venta, cerrada en COMPLETED. */
+export interface AccountOpeningRow {
+    sessionId: string;
+    retailCustomerId: string;
+    /** `null` si el cliente no se pudo leer. */
+    name: string | null;
+    phone: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    openedAt: string;
+}
+/**
+ * `GET /backoffice/customers/account-openings?storeId&from&to&limit&nextToken` — sección «Cuentas abiertas
+ * sin compra» de Clientes VL, paginada por fecha de apertura descendente.
+ */
+export interface BackofficeAccountOpeningsResponse {
+    nextToken: string | null;
+    items: AccountOpeningRow[];
+}

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

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

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

@@ -2,8 +2,12 @@
  * `cancelReason` que escribe el sistema (no el vendedor).
  * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
  * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ * ALREADY_HAS_ACCOUNT: la apertura de cuenta se cierra porque el cliente ya tiene cuenta PagoConFiado.
+ * CURP_OF_OTHER_CUSTOMER: la apertura de cuenta se cierra porque la CURP ya es de otro cliente.
  */
 export declare enum SystemCancelReasonEnum {
     SWEEP_CREDIT_DISCARDED = "SWEEP_CREDIT_DISCARDED",
-    TAKEN_OVER_BY_OTHER_STORE = "TAKEN_OVER_BY_OTHER_STORE"
+    TAKEN_OVER_BY_OTHER_STORE = "TAKEN_OVER_BY_OTHER_STORE",
+    ALREADY_HAS_ACCOUNT = "ALREADY_HAS_ACCOUNT",
+    CURP_OF_OTHER_CUSTOMER = "CURP_OF_OTHER_CUSTOMER"
 }

package/bin/retailWizard/enums/SystemCancelReasonEnum.js

@@ -5,9 +5,13 @@ exports.SystemCancelReasonEnum = void 0;
  * `cancelReason` que escribe el sistema (no el vendedor).
  * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
  * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ * ALREADY_HAS_ACCOUNT: la apertura de cuenta se cierra porque el cliente ya tiene cuenta PagoConFiado.
+ * CURP_OF_OTHER_CUSTOMER: la apertura de cuenta se cierra porque la CURP ya es de otro cliente.
  */
 var SystemCancelReasonEnum;
 (function (SystemCancelReasonEnum) {
     SystemCancelReasonEnum["SWEEP_CREDIT_DISCARDED"] = "SWEEP_CREDIT_DISCARDED";
     SystemCancelReasonEnum["TAKEN_OVER_BY_OTHER_STORE"] = "TAKEN_OVER_BY_OTHER_STORE";
+    SystemCancelReasonEnum["ALREADY_HAS_ACCOUNT"] = "ALREADY_HAS_ACCOUNT";
+    SystemCancelReasonEnum["CURP_OF_OTHER_CUSTOMER"] = "CURP_OF_OTHER_CUSTOMER";
 })(SystemCancelReasonEnum || (exports.SystemCancelReasonEnum = SystemCancelReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -160,6 +160,7 @@ export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
 export * from './dtos/responses/BackofficeCustomerTableResponse';
+export * from './dtos/responses/BackofficeAccountOpeningsResponse';
 export * from './enums/StoreKindEnum';
 export * from './dtos/responses/BackofficeStoreTableResponse';
 export * from './enums/StoreMixCategoryEnum';

package/bin/retailWizard/index.js

@@ -193,6 +193,7 @@ __exportStar(require("./dtos/responses/BackofficeSellerKpisResponse"), exports);
 __exportStar(require("./enums/SellerTableSourceStatusEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeSellerTableResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeCustomerTableResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeAccountOpeningsResponse"), exports);
 __exportStar(require("./enums/StoreKindEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeStoreTableResponse"), exports);
 __exportStar(require("./enums/StoreMixCategoryEnum"), exports);

package/package.json

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

package/src/retailWizard/dtos/WizardSession.ts

@@ -160,6 +160,8 @@ export interface WizardSession {
    * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
    */
   cashOnly?: boolean;
+  /** Sesión de apertura de cuenta sin venta; ausente = venta de siempre. */
+  accountOpening?: boolean;
   /** TTL DDB ~24h de inactividad (D14). */
   ttlEpoch: number;
   createdBy: string;

package/src/retailWizard/dtos/requests/OccupationRequest.ts

@@ -2,6 +2,12 @@ import { Expose } from 'class-transformer';
 import { IsEnum, IsIn, IsOptional, IsString, MaxLength } from 'class-validator';
 import { OccupationEnum } from '../../enums/OccupationEnum';
 import { MONTHLY_INCOME_VALUES } from '../../catalog/monthlyIncome';
+import {
+  BENEFICIAL_OWNER_VALUES,
+  EXTRA_SUPPORT_VALUES,
+  MAXIMUM_TX_VALUES,
+  USAGE_MONTHLY_VALUES,
+} from './ProfileQuestionsRequest';
 
 /**
  * POST /wizard/sessions/:id/occupation — registra la ocupación y el ingreso mensual del expediente
@@ -23,4 +29,29 @@ export class OccupationRequest {
   @IsString()
   @IsIn(MONTHLY_INCOME_VALUES as unknown as string[])
   monthlyIncome!: string;
+
+  /** MXN_* del perfil transaccional: opcionales aquí, la apertura de cuenta los exige en negocio. */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(EXTRA_SUPPORT_VALUES as unknown as string[])
+  monthlyExtraSupport?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(USAGE_MONTHLY_VALUES as unknown as string[])
+  usageMonthly?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(MAXIMUM_TX_VALUES as unknown as string[])
+  maximumTx?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(BENEFICIAL_OWNER_VALUES as unknown as string[])
+  beneficialOwner?: string;
 }

package/src/retailWizard/dtos/requests/StartSessionRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsOptional, IsString, Matches } from 'class-validator';
+import { IsBoolean, IsOptional, IsString, Matches } from 'class-validator';
 import { regexPhoneMx } from '../../../helpers/constans/regex';
 
 /**
@@ -18,4 +18,10 @@ export class StartSessionRequest {
   @IsOptional()
   @IsString()
   prospectId?: string;
+
+  /** Marca de apertura de cuenta sin venta; ausente = venta de siempre. */
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  accountOpening?: boolean;
 }

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

@@ -0,0 +1,20 @@
+/** Una apertura de cuenta sin venta, cerrada en COMPLETED. */
+export interface AccountOpeningRow {
+    sessionId: string;
+    retailCustomerId: string;
+    /** `null` si el cliente no se pudo leer. */
+    name: string | null;
+    phone: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    openedAt: string;
+}
+
+/**
+ * `GET /backoffice/customers/account-openings?storeId&from&to&limit&nextToken` — sección «Cuentas abiertas
+ * sin compra» de Clientes VL, paginada por fecha de apertura descendente.
+ */
+export interface BackofficeAccountOpeningsResponse {
+    nextToken: string | null;
+    items: AccountOpeningRow[];
+}

package/src/retailWizard/enums/SystemCancelReasonEnum.ts

@@ -2,8 +2,12 @@
  * `cancelReason` que escribe el sistema (no el vendedor).
  * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
  * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ * ALREADY_HAS_ACCOUNT: la apertura de cuenta se cierra porque el cliente ya tiene cuenta PagoConFiado.
+ * CURP_OF_OTHER_CUSTOMER: la apertura de cuenta se cierra porque la CURP ya es de otro cliente.
  */
 export enum SystemCancelReasonEnum {
     SWEEP_CREDIT_DISCARDED = 'SWEEP_CREDIT_DISCARDED',
     TAKEN_OVER_BY_OTHER_STORE = 'TAKEN_OVER_BY_OTHER_STORE',
+    ALREADY_HAS_ACCOUNT = 'ALREADY_HAS_ACCOUNT',
+    CURP_OF_OTHER_CUSTOMER = 'CURP_OF_OTHER_CUSTOMER',
 }

package/src/retailWizard/index.ts

@@ -185,6 +185,7 @@ export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
 export * from './dtos/responses/BackofficeCustomerTableResponse';
+export * from './dtos/responses/BackofficeAccountOpeningsResponse';
 export * from './enums/StoreKindEnum';
 export * from './dtos/responses/BackofficeStoreTableResponse';
 export * from './enums/StoreMixCategoryEnum';