@fiado/type-kit 3.229.0 → 3.231.0

package/bin/retailOrg/dtos/validation/RetailUserValidationDto.d.ts

@@ -8,6 +8,12 @@ export interface RetailUserValidationDto {
     retailUserId: string;
     cognitoSub: string;
     retailerId: string;
+    /**
+     * Nombre de display del usuario retail (DEC-SKF1-021: etiqueta de conveniencia, la identidad real
+     * vive en RBAC). `null` si no se capturó. Lo consume el snapshot de venta del wizard para congelar
+     * quién vendió, sin tener que resolver el usuario en cada lectura del BO.
+     */
+    displayName: string | null;
     homeStoreId: string;
     employmentType: EmploymentTypeEnum;
     commissionTier: string;

package/bin/retailOrg/dtos/validation/StoreValidationDto.d.ts

@@ -7,6 +7,12 @@ export interface StoreValidationDto {
     storeId: string;
     retailerId: string;
     zoneId: string | null;
+    /**
+     * Nombre de la zona, resuelto por retail-org contra su propia tabla. `null` si la tienda no está
+     * acotada a una zona o si la zona ya no existe. Lo consume el snapshot de venta del wizard, que
+     * congela el contexto comercial y no puede resolver un `zoneId` de otro dominio.
+     */
+    zoneName: string | null;
     code: string;
     name: string;
     status: StoreStatusEnum;

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

@@ -35,6 +35,28 @@ export interface Sale {
     cancelledAt: string | null;
     /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
     cancelReason: string | null;
+    /**
+     * SNAPSHOT de identidad y contexto, congelado al cerrar la venta. NO se refresca: una venta es la
+     * fotografía de un hecho, no la caché de un perfil. Si el cliente corrige su nombre, la venta
+     * conserva el de ese día — eso es lo que la vuelve auditable.
+     * ⚠️ `customerName` y `customerCurp` son PII: esta tabla está en el catálogo PII. Nunca loguear.
+     * Ver la decisión 2026-07-28 (persistencia de nombre y CURP en el registro de venta).
+     * `null` cuando la resolución falló al cerrar (la venta NUNCA se cae por esto).
+     */
+    customerName: string | null;
+    customerCurp: string | null;
+    storeName: string | null;
+    zoneName: string | null;
+    sellerName: string | null;
+    productBrand: string | null;
+    productModel: string | null;
+    productCapacity: string | null;
+    /**
+     * Derivado: `[folio, customerName, customerCurp]` en MAYÚSCULAS, para búsqueda insensible a
+     * mayúsculas — `contains()` de DynamoDB es case-sensitive. No expone PII nueva: replica la que ya
+     * vive en la misma fila.
+     */
+    searchIndex: string | null;
     createdBy: string;
     updatedBy: string;
     createdAt: number;

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

@@ -5,4 +5,18 @@
  */
 export declare class CancelSaleRequest {
     reason: string;
+    /**
+     * Confirmación de que el equipo fue verificado físicamente en tienda antes de cancelar. El BO lo
+     * pide como checkbox obligatorio.
+     *
+     * **OPCIONAL en el DTO, obligatorio en el dominio — y es a propósito.** Marcarlo requerido volvería
+     * BREAKING este contrato: un caller que mande solo `reason` recibiría un `400` de validación. Como
+     * opcional, ese mismo caller recibe el **412 IMEI_NOT_RETURNABLE** que el manager lanza cuando el
+     * valor no es exactamente `true` — que es la respuesta semánticamente correcta ("no confirmaste el
+     * equipo") y no un error de forma. Ausente y `false` se tratan igual: fail-closed.
+     *
+     * `@IsBoolean()` estricto (el `validateRequest` del lambda NO usa `enableImplicitConversion`), así
+     * que el string `"false"` se rechaza en vez de colarse como truthy.
+     */
+    equipmentVerified?: boolean;
 }

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

@@ -26,3 +26,9 @@ __decorate([
     (0, class_validator_1.MaxLength)(200),
     __metadata("design:type", String)
 ], CancelSaleRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CancelSaleRequest.prototype, "equipmentVerified", void 0);

package/package.json

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

package/src/retailOrg/dtos/validation/RetailUserValidationDto.ts

@@ -9,6 +9,12 @@ export interface RetailUserValidationDto {
     retailUserId: string;
     cognitoSub: string;
     retailerId: string;
+    /**
+     * Nombre de display del usuario retail (DEC-SKF1-021: etiqueta de conveniencia, la identidad real
+     * vive en RBAC). `null` si no se capturó. Lo consume el snapshot de venta del wizard para congelar
+     * quién vendió, sin tener que resolver el usuario en cada lectura del BO.
+     */
+    displayName: string | null;
     homeStoreId: string;
     employmentType: EmploymentTypeEnum;
     commissionTier: string;

package/src/retailOrg/dtos/validation/StoreValidationDto.ts

@@ -8,6 +8,12 @@ export interface StoreValidationDto {
     storeId: string;
     retailerId: string;
     zoneId: string | null;
+    /**
+     * Nombre de la zona, resuelto por retail-org contra su propia tabla. `null` si la tienda no está
+     * acotada a una zona o si la zona ya no existe. Lo consume el snapshot de venta del wizard, que
+     * congela el contexto comercial y no puede resolver un `zoneId` de otro dominio.
+     */
+    zoneName: string | null;
     code: string;
     name: string;
     status: StoreStatusEnum;

package/src/retailWizard/dtos/Sale.ts

@@ -36,6 +36,28 @@ export interface Sale {
   cancelledAt: string | null;
   /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
   cancelReason: string | null;
+  /**
+   * SNAPSHOT de identidad y contexto, congelado al cerrar la venta. NO se refresca: una venta es la
+   * fotografía de un hecho, no la caché de un perfil. Si el cliente corrige su nombre, la venta
+   * conserva el de ese día — eso es lo que la vuelve auditable.
+   * ⚠️ `customerName` y `customerCurp` son PII: esta tabla está en el catálogo PII. Nunca loguear.
+   * Ver la decisión 2026-07-28 (persistencia de nombre y CURP en el registro de venta).
+   * `null` cuando la resolución falló al cerrar (la venta NUNCA se cae por esto).
+   */
+  customerName: string | null;
+  customerCurp: string | null;
+  storeName: string | null;
+  zoneName: string | null;
+  sellerName: string | null;
+  productBrand: string | null;
+  productModel: string | null;
+  productCapacity: string | null;
+  /**
+   * Derivado: `[folio, customerName, customerCurp]` en MAYÚSCULAS, para búsqueda insensible a
+   * mayúsculas — `contains()` de DynamoDB es case-sensitive. No expone PII nueva: replica la que ya
+   * vive en la misma fila.
+   */
+  searchIndex: string | null;
   createdBy: string;
   updatedBy: string;
   createdAt: number;

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

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsString, MaxLength } from 'class-validator';
+import { IsBoolean, IsOptional, IsString, MaxLength } from 'class-validator';
 
 /**
  * POST /sales/:saleId/cancel — cancela una venta (flujo C, solo BO dentro de ventana param). `reason`
@@ -11,4 +11,22 @@ export class CancelSaleRequest {
   @IsString()
   @MaxLength(200)
   reason!: string;
+
+  /**
+   * Confirmación de que el equipo fue verificado físicamente en tienda antes de cancelar. El BO lo
+   * pide como checkbox obligatorio.
+   *
+   * **OPCIONAL en el DTO, obligatorio en el dominio — y es a propósito.** Marcarlo requerido volvería
+   * BREAKING este contrato: un caller que mande solo `reason` recibiría un `400` de validación. Como
+   * opcional, ese mismo caller recibe el **412 IMEI_NOT_RETURNABLE** que el manager lanza cuando el
+   * valor no es exactamente `true` — que es la respuesta semánticamente correcta ("no confirmaste el
+   * equipo") y no un error de forma. Ausente y `false` se tratan igual: fail-closed.
+   *
+   * `@IsBoolean()` estricto (el `validateRequest` del lambda NO usa `enableImplicitConversion`), así
+   * que el string `"false"` se rechaza en vez de colarse como truthy.
+   */
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  equipmentVerified?: boolean;
 }

package/bin/benefitCenter/enums/BenefitFlowEnum.d.ts

@@ -1,11 +0,0 @@
-export declare enum BenefitFlowEnum {
-    TOPUPS = "TOPUPS",
-    BILL_PAYMENT = "BILL_PAYMENT",
-    CREDIT = "CREDIT",
-    INSURANCE = "INSURANCE",
-    DONATION = "DONATION",
-    PHARMACY = "PHARMACY",
-    REMITTANCE = "REMITTANCE",
-    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
-    WALLET_FUNDING = "WALLET_FUNDING"
-}

package/bin/benefitCenter/enums/BenefitFlowEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BenefitFlowEnum = void 0;
-var BenefitFlowEnum;
-(function (BenefitFlowEnum) {
-    BenefitFlowEnum["TOPUPS"] = "TOPUPS";
-    BenefitFlowEnum["BILL_PAYMENT"] = "BILL_PAYMENT";
-    BenefitFlowEnum["CREDIT"] = "CREDIT";
-    BenefitFlowEnum["INSURANCE"] = "INSURANCE";
-    BenefitFlowEnum["DONATION"] = "DONATION";
-    BenefitFlowEnum["PHARMACY"] = "PHARMACY";
-    BenefitFlowEnum["REMITTANCE"] = "REMITTANCE";
-    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
-    BenefitFlowEnum["WALLET_FUNDING"] = "WALLET_FUNDING";
-})(BenefitFlowEnum || (exports.BenefitFlowEnum = BenefitFlowEnum = {}));

package/bin/identity/enums/SelfieSourceEnum.d.ts

@@ -1,10 +0,0 @@
-/**
- * Con qué criterio se resolvió cuál archivo de S3 es la selfie del usuario.
- * Le dice al consumidor qué tan confiable es el match antes de mandarla a un facematch.
- */
-export declare enum SelfieSourceEnum {
-    /** Matcheó el verificationId de la verificación vigente en People. */
-    VERIFICATION = "VERIFICATION",
-    /** No hubo match por verificación: se tomó el archivo de selfie más reciente del bucket. */
-    LATEST = "LATEST"
-}

package/bin/identity/enums/SelfieSourceEnum.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SelfieSourceEnum = void 0;
-/**
- * Con qué criterio se resolvió cuál archivo de S3 es la selfie del usuario.
- * Le dice al consumidor qué tan confiable es el match antes de mandarla a un facematch.
- */
-var SelfieSourceEnum;
-(function (SelfieSourceEnum) {
-    /** Matcheó el verificationId de la verificación vigente en People. */
-    SelfieSourceEnum["VERIFICATION"] = "VERIFICATION";
-    /** No hubo match por verificación: se tomó el archivo de selfie más reciente del bucket. */
-    SelfieSourceEnum["LATEST"] = "LATEST";
-})(SelfieSourceEnum || (exports.SelfieSourceEnum = SelfieSourceEnum = {}));

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

@@ -1,6 +0,0 @@
-export declare class CancelFundingReferenceRequest {
-    /** Referencia Passport (PK de EqualityFundingReference_GT). */
-    reference: string;
-    directoryId: string;
-    idempotencyKey: string;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -1,31 +0,0 @@
-"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.CancelFundingReferenceRequest = void 0;
-const class_validator_1 = require("class-validator");
-class CancelFundingReferenceRequest {
-}
-exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "reference", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);

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

@@ -1,7 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-export declare class CancelFundingReferenceResponse {
-    reference: string;
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelFundingReferenceResponse = void 0;
-class CancelFundingReferenceResponse {
-}
-exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

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

@@ -1,11 +0,0 @@
-/**
- * Request del cancel via Centro de Beneficios (spec 13 v2.0).
- * `reference` viaja en el path, `directoryId` se resuelve del JWT.
- * `providerModuleName` permite al marketplace rutear al publisher correcto
- * sin tener que persistir el mapping (el wallet-app sabe el moduleName
- * porque vino en la respuesta del authorize).
- */
-export declare class CancelFundingRequest {
-    idempotencyKey: string;
-    providerModuleName: string;
-}

package/bin/walletFunding/dtos/CancelFundingRequest.js

@@ -1,33 +0,0 @@
-"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.CancelFundingRequest = void 0;
-const class_validator_1 = require("class-validator");
-/**
- * Request del cancel via Centro de Beneficios (spec 13 v2.0).
- * `reference` viaja en el path, `directoryId` se resuelve del JWT.
- * `providerModuleName` permite al marketplace rutear al publisher correcto
- * sin tener que persistir el mapping (el wallet-app sabe el moduleName
- * porque vino en la respuesta del authorize).
- */
-class CancelFundingRequest {
-}
-exports.CancelFundingRequest = CancelFundingRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingRequest.prototype, "idempotencyKey", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(128),
-    __metadata("design:type", String)
-], CancelFundingRequest.prototype, "providerModuleName", void 0);

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

@@ -1,14 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-/**
- * Response del cancel via Centro de Beneficios (spec 13 v2.0).
- * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
- * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
- * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
- */
-export declare class CancelFundingResponse {
-    reference: string;
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-    message?: string;
-}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelFundingResponse = void 0;
-/**
- * Response del cancel via Centro de Beneficios (spec 13 v2.0).
- * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
- * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
- * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
- */
-class CancelFundingResponse {
-}
-exports.CancelFundingResponse = CancelFundingResponse;

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

@@ -1,3 +0,0 @@
-export declare class CancelWalletFundingRequest {
-    idempotencyKey: string;
-}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -1,21 +0,0 @@
-"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.CancelWalletFundingRequest = void 0;
-const class_validator_1 = require("class-validator");
-class CancelWalletFundingRequest {
-}
-exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

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

@@ -1,7 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-export declare class CancelWalletFundingResponse {
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-    reference?: string;
-}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelWalletFundingResponse = void 0;
-class CancelWalletFundingResponse {
-}
-exports.CancelWalletFundingResponse = CancelWalletFundingResponse;