@fiado/type-kit 3.260.0 → 3.262.0

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

@@ -0,0 +1,18 @@
+/**
+ * Financiera de la venta, DERIVADA — no es un campo de `RetailSale_GT`. Sale de `type` +
+ * `externalProvider` (ver `helpers/saleFinancier`). Existe porque las pantallas del Admin VL agrupan
+ * por financiera y el front, este lambda y el motor de comisiones tienen que derivarla IGUAL.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * NONE - Venta de contado: no hay financiera.
+ * SUREKEEP - Crédito propio de la SOFOM.
+ * PAYJOY / CREDIYA / LESPAGO / INNOVA - Derivada a un proveedor externo.
+ */
+export declare enum SaleFinancierEnum {
+    NONE = "NONE",
+    SUREKEEP = "SUREKEEP",
+    PAYJOY = "PAYJOY",
+    CREDIYA = "CREDIYA",
+    LESPAGO = "LESPAGO",
+    INNOVA = "INNOVA"
+}

package/bin/retailWizard/enums/SaleFinancierEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleFinancierEnum = void 0;
+/**
+ * Financiera de la venta, DERIVADA — no es un campo de `RetailSale_GT`. Sale de `type` +
+ * `externalProvider` (ver `helpers/saleFinancier`). Existe porque las pantallas del Admin VL agrupan
+ * por financiera y el front, este lambda y el motor de comisiones tienen que derivarla IGUAL.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * NONE - Venta de contado: no hay financiera.
+ * SUREKEEP - Crédito propio de la SOFOM.
+ * PAYJOY / CREDIYA / LESPAGO / INNOVA - Derivada a un proveedor externo.
+ */
+var SaleFinancierEnum;
+(function (SaleFinancierEnum) {
+    SaleFinancierEnum["NONE"] = "NONE";
+    SaleFinancierEnum["SUREKEEP"] = "SUREKEEP";
+    SaleFinancierEnum["PAYJOY"] = "PAYJOY";
+    SaleFinancierEnum["CREDIYA"] = "CREDIYA";
+    SaleFinancierEnum["LESPAGO"] = "LESPAGO";
+    SaleFinancierEnum["INNOVA"] = "INNOVA";
+})(SaleFinancierEnum || (exports.SaleFinancierEnum = SaleFinancierEnum = {}));

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

@@ -0,0 +1,19 @@
+/**
+ * Catálogo de reportes de ventas del Admin VL (M6 §5.1). Los ids son los del mockup — el front los usa
+ * como llave de ruta y de traducción. SureKeep Fase 3 — pista Retail.
+ *
+ * RVL_01 - Ventas por período (diaria).
+ * RVL_02 - Ventas por negocio · tienda (semanal).
+ * RVL_03 - Ventas por vendedor (semanal).
+ * RVL_04 - Ventas por producto (mensual).
+ * RVL_05 - Ventas por financiera (mensual).
+ *
+ * ⚠️ FUERA de F3: `RVL-06` (cross-border, es M5) y `RVL-07` (conciliación, backend de cobranza).
+ */
+export declare enum SalesReportIdEnum {
+    RVL_01 = "RVL-01",
+    RVL_02 = "RVL-02",
+    RVL_03 = "RVL-03",
+    RVL_04 = "RVL-04",
+    RVL_05 = "RVL-05"
+}

package/bin/retailWizard/enums/SalesReportIdEnum.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalesReportIdEnum = void 0;
+/**
+ * Catálogo de reportes de ventas del Admin VL (M6 §5.1). Los ids son los del mockup — el front los usa
+ * como llave de ruta y de traducción. SureKeep Fase 3 — pista Retail.
+ *
+ * RVL_01 - Ventas por período (diaria).
+ * RVL_02 - Ventas por negocio · tienda (semanal).
+ * RVL_03 - Ventas por vendedor (semanal).
+ * RVL_04 - Ventas por producto (mensual).
+ * RVL_05 - Ventas por financiera (mensual).
+ *
+ * ⚠️ FUERA de F3: `RVL-06` (cross-border, es M5) y `RVL-07` (conciliación, backend de cobranza).
+ */
+var SalesReportIdEnum;
+(function (SalesReportIdEnum) {
+    SalesReportIdEnum["RVL_01"] = "RVL-01";
+    SalesReportIdEnum["RVL_02"] = "RVL-02";
+    SalesReportIdEnum["RVL_03"] = "RVL-03";
+    SalesReportIdEnum["RVL_04"] = "RVL-04";
+    SalesReportIdEnum["RVL_05"] = "RVL-05";
+})(SalesReportIdEnum || (exports.SalesReportIdEnum = SalesReportIdEnum = {}));

package/bin/retailWizard/helpers/saleFinancier.d.ts

@@ -0,0 +1,21 @@
+import { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
+import { SaleFinancierEnum } from '../enums/SaleFinancierEnum';
+/** Lo mínimo de una venta para derivar su financiera. */
+export interface SaleFinancierSource {
+    type: SaleTypeEnum;
+    externalProvider: ExternalProviderEnum | null;
+}
+/**
+ * Deriva la financiera de una venta. Vive acá —y no en el lambda— porque el Admin VL agrupa por
+ * financiera en tres pantallas distintas (Ventas, Reportes, Análisis) y el front tiene que llegar al
+ * MISMO número que el backend; dos implementaciones paralelas divergen al primer tipo nuevo.
+ *
+ * `EXTERNAL_REFERRAL` sin `externalProvider` cae en `NONE` en vez de reventar: hay ventas viejas sin
+ * el campo y un contador no es lugar para tirar una excepción.
+ */
+export declare function financierOfSale(sale: SaleFinancierSource): SaleFinancierEnum;
+/** ¿La financió SureKeep? (pill «SureKeep» de los contadores del Admin VL). */
+export declare function isSureKeepFinanced(sale: SaleFinancierSource): boolean;
+/** ¿La financió un tercero? (pill «Externas»). Contado NO cuenta: no tiene financiera. */
+export declare function isExternallyFinanced(sale: SaleFinancierSource): boolean;

package/bin/retailWizard/helpers/saleFinancier.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.financierOfSale = financierOfSale;
+exports.isSureKeepFinanced = isSureKeepFinanced;
+exports.isExternallyFinanced = isExternallyFinanced;
+const SaleTypeEnum_1 = require("../enums/SaleTypeEnum");
+const ExternalProviderEnum_1 = require("../enums/ExternalProviderEnum");
+const SaleFinancierEnum_1 = require("../enums/SaleFinancierEnum");
+/**
+ * Mapa explícito proveedor → financiera. Es un `Record` COMPLETO a propósito: agregar un proveedor a
+ * `ExternalProviderEnum` sin agregarlo acá es error de compilación, que es exactamente el recordatorio
+ * que queremos. Un cast desde el enum de proveedor se vería más corto y perdería esa garantía.
+ */
+const FINANCIER_BY_PROVIDER = {
+    [ExternalProviderEnum_1.ExternalProviderEnum.PAYJOY]: SaleFinancierEnum_1.SaleFinancierEnum.PAYJOY,
+    [ExternalProviderEnum_1.ExternalProviderEnum.CREDIYA]: SaleFinancierEnum_1.SaleFinancierEnum.CREDIYA,
+    [ExternalProviderEnum_1.ExternalProviderEnum.LESPAGO]: SaleFinancierEnum_1.SaleFinancierEnum.LESPAGO,
+    [ExternalProviderEnum_1.ExternalProviderEnum.INNOVA]: SaleFinancierEnum_1.SaleFinancierEnum.INNOVA,
+};
+/**
+ * Deriva la financiera de una venta. Vive acá —y no en el lambda— porque el Admin VL agrupa por
+ * financiera en tres pantallas distintas (Ventas, Reportes, Análisis) y el front tiene que llegar al
+ * MISMO número que el backend; dos implementaciones paralelas divergen al primer tipo nuevo.
+ *
+ * `EXTERNAL_REFERRAL` sin `externalProvider` cae en `NONE` en vez de reventar: hay ventas viejas sin
+ * el campo y un contador no es lugar para tirar una excepción.
+ */
+function financierOfSale(sale) {
+    if (sale.type === SaleTypeEnum_1.SaleTypeEnum.CREDIT)
+        return SaleFinancierEnum_1.SaleFinancierEnum.SUREKEEP;
+    if (sale.type === SaleTypeEnum_1.SaleTypeEnum.EXTERNAL_REFERRAL && sale.externalProvider) {
+        return FINANCIER_BY_PROVIDER[sale.externalProvider] ?? SaleFinancierEnum_1.SaleFinancierEnum.NONE;
+    }
+    return SaleFinancierEnum_1.SaleFinancierEnum.NONE;
+}
+/** ¿La financió SureKeep? (pill «SureKeep» de los contadores del Admin VL). */
+function isSureKeepFinanced(sale) {
+    return financierOfSale(sale) === SaleFinancierEnum_1.SaleFinancierEnum.SUREKEEP;
+}
+/** ¿La financió un tercero? (pill «Externas»). Contado NO cuenta: no tiene financiera. */
+function isExternallyFinanced(sale) {
+    const financier = financierOfSale(sale);
+    return financier !== SaleFinancierEnum_1.SaleFinancierEnum.SUREKEEP && financier !== SaleFinancierEnum_1.SaleFinancierEnum.NONE;
+}

package/bin/retailWizard/index.d.ts

@@ -67,6 +67,29 @@ export * from './dtos/responses/ContractPreviewResponse';
 export * from './dtos/responses/SignatureSendOtpResponse';
 export * from './dtos/responses/SignatureSignResponse';
 export * from './dtos/responses/RegisterDeviceResponse';
+export * from './enums/SaleFinancierEnum';
+export * from './enums/SaleExceptionTypeEnum';
+export * from './enums/SaleExceptionStatusEnum';
+export * from './enums/SaleExceptionEventKindEnum';
+export * from './enums/SaleExceptionDecisionEnum';
+export * from './enums/SalesReportIdEnum';
+export * from './enums/ReportPeriodicityEnum';
+export * from './enums/ReportFormatEnum';
+export * from './enums/ReportRunStatusEnum';
+export * from './helpers/saleFinancier';
+export * from './dtos/SaleLogEntry';
+export * from './dtos/SaleExceptionPayload';
+export * from './dtos/SaleExceptionEvent';
+export * from './dtos/SaleException';
+export * from './dtos/SalesReportDefinition';
+export * from './dtos/SalesReportRun';
+export * from './dtos/requests/CreateSaleExceptionRequest';
+export * from './dtos/requests/ResolveSaleExceptionRequest';
+export * from './dtos/requests/RunSalesReportRequest';
+export * from './dtos/requests/BackofficeCancelSaleRequest';
+export * from './dtos/responses/BackofficeSalesStatsResponse';
+export * from './dtos/responses/BackofficeSalesKpisResponse';
+export * from './dtos/responses/BackofficeReportsResponse';
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SessionExpiredV1';

package/bin/retailWizard/index.js

@@ -89,6 +89,35 @@ __exportStar(require("./dtos/responses/ContractPreviewResponse"), exports);
 __exportStar(require("./dtos/responses/SignatureSendOtpResponse"), exports);
 __exportStar(require("./dtos/responses/SignatureSignResponse"), exports);
 __exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);
+// ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────
+// Enums
+__exportStar(require("./enums/SaleFinancierEnum"), exports);
+__exportStar(require("./enums/SaleExceptionTypeEnum"), exports);
+__exportStar(require("./enums/SaleExceptionStatusEnum"), exports);
+__exportStar(require("./enums/SaleExceptionEventKindEnum"), exports);
+__exportStar(require("./enums/SaleExceptionDecisionEnum"), exports);
+__exportStar(require("./enums/SalesReportIdEnum"), exports);
+__exportStar(require("./enums/ReportPeriodicityEnum"), exports);
+__exportStar(require("./enums/ReportFormatEnum"), exports);
+__exportStar(require("./enums/ReportRunStatusEnum"), exports);
+// Helpers puros (compartidos con el front y el motor de comisiones)
+__exportStar(require("./helpers/saleFinancier"), exports);
+// DTOs
+__exportStar(require("./dtos/SaleLogEntry"), exports);
+__exportStar(require("./dtos/SaleExceptionPayload"), exports);
+__exportStar(require("./dtos/SaleExceptionEvent"), exports);
+__exportStar(require("./dtos/SaleException"), exports);
+__exportStar(require("./dtos/SalesReportDefinition"), exports);
+__exportStar(require("./dtos/SalesReportRun"), exports);
+// Requests
+__exportStar(require("./dtos/requests/CreateSaleExceptionRequest"), exports);
+__exportStar(require("./dtos/requests/ResolveSaleExceptionRequest"), exports);
+__exportStar(require("./dtos/requests/RunSalesReportRequest"), exports);
+__exportStar(require("./dtos/requests/BackofficeCancelSaleRequest"), exports);
+// Responses
+__exportStar(require("./dtos/responses/BackofficeSalesStatsResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeSalesKpisResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeReportsResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/SaleCompletedV1"), exports);
 __exportStar(require("./events/SaleCancelledV1"), exports);

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

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

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -0,0 +1,31 @@
+"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

@@ -0,0 +1,7 @@
+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

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

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

@@ -0,0 +1,11 @@
+/**
+ * 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

@@ -0,0 +1,33 @@
+"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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,12 @@
+"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

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

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -0,0 +1,21 @@
+"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

@@ -0,0 +1,7 @@
+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

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

package/package.json

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

package/src/identity/dtos/PeopleResponse.ts

@@ -105,7 +105,16 @@ export class PeopleResponse {
         externalReferenceId:string | null;
         SSN_ITINRequired:boolean | null;
         hasSSN_ITIN:boolean | null;
+        /**
+         * @deprecated Typo histórico (tres `p`). NADIE escribe este campo:
+         * fiado-identity-lambda persiste `geoApproved` (una `p`), que es lo que
+         * está en DynamoDB. Quien lea este campo obtiene siempre `undefined`.
+         * Usar `geoApproved`. Se conserva solo para no romper a los consumidores
+         * que todavía lo referencian.
+         */
         geoAppproved?:boolean | null;
+        /** Geolocalización aprobada. `null` = no evaluada; solo `false` bloquea. */
+        geoApproved?:boolean | null;
         cnbvManualApproval?: ManualApproval | null;
         minorManualApproval?: ManualApproval | null;
 

package/src/platformRbac/application/Application.ts

@@ -55,6 +55,23 @@ export interface ApplicationDefaults {
      * UsernameAttributes del pool): true ⇒ pool con ['email','phone_number']. Heredado al tenant.
      */
     allowSecondary?: boolean;
+    /**
+     * DEC-RBAC-111: política de contraseña que heredan los tenants creados desde esta aplicación.
+     *
+     * TOP-LEVEL (hermano de `autoregister`), NO dentro de `securityPolicy`: en la ficha del tenant
+     * ese sub-objeto lo reescribe entero el PUT de security-policy, y acá se mantiene la simetría.
+     *
+     * La herencia ocurre UNA sola vez, en el onboarding: cambiar este default después NO re-escribe
+     * la policy de los tenants ya creados, solo aplica a los futuros. Los 5 campos son opcionales;
+     * `tempValidityDays` no es per-tenant y por eso no está.
+     */
+    passwordPolicy?: {
+        minLength?: number;
+        requireUppercase?: boolean;
+        requireLowercase?: boolean;
+        requireNumber?: boolean;
+        requireSymbol?: boolean;
+    };
 }
 
 export interface SeedRole {

package/src/platformRbac/dtos/CreateTenantRequest.ts

@@ -11,6 +11,7 @@ import {
     ValidateNested,
 } from 'class-validator';
 import { TokenValidationMode } from '../enums/TokenValidationMode';
+import { PasswordPolicyInput } from './PasswordPolicyInput';
 
 /**
  * Punto inicial de la política 2FA elegido en el alta del tenant (DEC-RBAC-064). Para el CREATE
@@ -69,4 +70,16 @@ export class CreateTenantRequest {
      */
     @Expose() @IsOptional() @ValidateNested() @Type(() => CreateTenantSecurityPolicy)
     securityPolicy?: CreateTenantSecurityPolicy;
+    /**
+     * DEC-RBAC-111: política de contraseña del tenant. Opcional: ausente ⇒ hereda
+     * `app.defaults.passwordPolicy` y, si tampoco está, la policy global del lambda.
+     *
+     * TOP-LEVEL a propósito, NO dentro de `securityPolicy`: ese sub-objeto lo reescribe entero el
+     * PUT de security-policy desde una lectura cacheada, y se llevaría puesta la passwordPolicy.
+     *
+     * INMUTABLE después del alta: alimenta la política nativa del user pool de Cognito, y no existe
+     * un update de pool (ver TD-RBAC-138 del platform-rbac-business).
+     */
+    @Expose() @IsOptional() @ValidateNested() @Type(() => PasswordPolicyInput)
+    passwordPolicy?: PasswordPolicyInput;
 }

package/src/platformRbac/dtos/PasswordPolicyInput.ts

@@ -0,0 +1,42 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsInt, IsOptional, Max, Min } from 'class-validator';
+
+/**
+ * DEC-RBAC-111: política de complejidad de contraseña de un tenant.
+ *
+ * Los 5 campos son OPCIONALES: un campo ausente cae a la plantilla de la aplicación
+ * (`ApplicationDefaults.passwordPolicy`) y, de ahí, a la policy global del lambda.
+ *
+ * Se usa en dos lugares, siempre TOP-LEVEL (nunca dentro de `securityPolicy`):
+ *  - `CreateTenantRequest.passwordPolicy` — override al crear el tenant.
+ *  - `ApplicationDefaults.passwordPolicy` — default de la plantilla que el tenant hereda.
+ *
+ * `tempValidityDays` NO está acá a propósito: la validez de la contraseña temporal no es per-tenant
+ * (es el único campo de la policy que no afecta la fuerza de la contraseña). Sale siempre de la
+ * env var global del lambda.
+ *
+ * El rango 6..99 de `minLength` es el que admite `PasswordPolicy.MinimumLength` de Cognito. Se valida
+ * ACÁ para que un valor fuera de rango se rechace en el borde: si llegara a `CreateUserPool`, la
+ * `InvalidParameterException` caería con la ficha del tenant ya escrita en estado 'provisioning',
+ * o sea dentro de la rama de compensación de la saga de onboarding.
+ *
+ * OJO: acá NO se valida el PISO (que la policy no sea más débil que la global). Ese piso depende de
+ * env vars del lambda; declararlo también en el type-kit sería una segunda fuente de verdad, en otro
+ * repo, que driftea en cuanto alguien cambia la env var. Lo decide el lambda.
+ */
+export class PasswordPolicyInput {
+    @Expose() @IsOptional() @IsInt() @Min(6) @Max(99)
+    minLength?: number;
+
+    @Expose() @IsOptional() @IsBoolean()
+    requireUppercase?: boolean;
+
+    @Expose() @IsOptional() @IsBoolean()
+    requireLowercase?: boolean;
+
+    @Expose() @IsOptional() @IsBoolean()
+    requireNumber?: boolean;
+
+    @Expose() @IsOptional() @IsBoolean()
+    requireSymbol?: boolean;
+}

package/src/platformRbac/index.ts

@@ -53,6 +53,9 @@ export * from './dtos/AuthorizeResponse';
 // decoradores class-validator → export de valor; CreateTenantResponse es interface → type-only.
 export * from './dtos/CreateTenantRequest';
 export type { CreateTenantResponse } from './dtos/CreateTenantResponse';
+// DEC-RBAC-111: policy de contraseña per-tenant. Lleva decoradores class-validator → export de valor.
+// La consumen CreateTenantRequest (override del alta) y ApplicationDefaults (default de la plantilla).
+export * from './dtos/PasswordPolicyInput';
 // DEC-RBAC-058/059 (aditivo) — tenant pending-infra + verify-infra
 export type { TenantStatus } from './dtos/TenantStatus';
 export type { VerifyTenantInfraResponse } from './dtos/VerifyTenantInfraResponse';

package/src/retailWizard/dtos/SaleException.ts

@@ -0,0 +1,55 @@
+import type { SaleExceptionTypeEnum } from '../enums/SaleExceptionTypeEnum';
+import type { SaleExceptionStatusEnum } from '../enums/SaleExceptionStatusEnum';
+import type { SaleExceptionEvent } from './SaleExceptionEvent';
+import type { SaleExceptionPayload } from './SaleExceptionPayload';
+
+/**
+ * Excepción de venta (`<T>RetailSaleException_GT`, pk `RETAILER#<retailerId>` ·
+ * sk `EXCEPTION#<createdAt>#<exceptionId>`, CERO GSIs). Bandeja del Admin VL, M6 §5.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * El `status` NO va en el sort key: el sk es inmutable en DynamoDB y el estado recorre
+ * `NEW → IN_REVIEW → APPROVED → APPLIED`. Meterlo ahí obligaría a borrar y reescribir el ítem en cada
+ * transición, perdiendo atomicidad y estabilidad del `exceptionId`. El filtro por estado se hace en
+ * memoria; son eventos raros.
+ *
+ * 🔴 **Hueco declarado (DEC-034):** `CAPTURE_FIX`, `BACKDATING` y `PRICE_OVERRIDE` mutan la venta
+ * después de cerrada, y el motor de comisiones solo escucha `SaleCompleted` / `SaleCancelled`. En el
+ * primer corte las excepciones **NO re-liquidan comisión**. Se ataca en F4 con un `SaleAmendedV1`.
+ */
+export interface SaleException {
+    exceptionId: string;
+    retailerId: string;
+    storeId: string;
+    /** `null` en las excepciones generales, que no cuelgan de una venta puntual. */
+    saleId: string | null;
+    type: SaleExceptionTypeEnum;
+    status: SaleExceptionStatusEnum;
+    /** userId de quien la levantó (normalmente el vendedor). */
+    requestedBy: string;
+    /** Nombre para mostrar, congelado al alta. `null` si no se pudo resolver. */
+    requestedByName: string | null;
+    /** ISO-8601. */
+    requestedAt: string;
+    /** OBLIGATORIA. Es lo que hace auditable la excepción. */
+    justification: string;
+    /**
+     * Impacto económico en centavos, con signo: positivo si la excepción suma (devolución al cliente,
+     * reemplazo), negativo si resta (descuento autorizado). `null` cuando no aplica.
+     */
+    impactCents: number | null;
+    payload: SaleExceptionPayload;
+    /** userId del Admin VL que aprobó o rechazó. `null` mientras esté sin resolver. */
+    resolvedBy: string | null;
+    resolvedByName: string | null;
+    /** ISO-8601. `null` mientras esté sin resolver. */
+    resolvedAt: string | null;
+    /** Resolución OBLIGATORIA al aprobar o rechazar. `null` mientras esté sin resolver. */
+    resolution: string | null;
+    /** Hilo de solicitud, notas y resolución, en orden cronológico ascendente. */
+    timeline: SaleExceptionEvent[];
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/src/retailWizard/dtos/SaleExceptionEvent.ts

@@ -0,0 +1,19 @@
+import type { SaleExceptionEventKindEnum } from '../enums/SaleExceptionEventKindEnum';
+
+/**
+ * Una entrada del timeline de una excepción: el hilo de solicitud, notas y resolución que la pantalla
+ * de Excepciones dibuja bajo la ficha. SureKeep Fase 3 — pista Retail.
+ *
+ * Va EMBEBIDO en el ítem de `RetailSaleException_GT`, no en una tabla aparte: son pocos eventos por
+ * excepción, se leen siempre junto con la ficha y nunca se consultan por su cuenta.
+ */
+export interface SaleExceptionEvent {
+    /** ISO-8601. */
+    at: string;
+    kind: SaleExceptionEventKindEnum;
+    /** userId del autor; `system` si lo escribió un proceso interno. */
+    authorId: string;
+    /** Nombre para mostrar, congelado al escribir el evento. `null` si no se pudo resolver. */
+    authorName: string | null;
+    body: string;
+}

package/src/retailWizard/dtos/SaleExceptionPayload.ts

@@ -0,0 +1,19 @@
+/**
+ * Lo que la excepción PIDE cambiar en la venta. Todos los campos son opcionales porque cada tipo usa
+ * los suyos: `CAPTURE_FIX` manda `sku`, `PRICE_OVERRIDE` manda `amountCents`, `BACKDATING` manda
+ * `soldAt`, `EXTENDED_WARRANTY` manda `imei`. `LATE_CANCEL` no manda ninguno.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Es un shape TIPADO y no un objeto libre a propósito: el payload cruza el borde HTTP y un
+ * `Record<string, unknown>` ahí deja al front sin contrato y al validador sin nada que validar.
+ */
+export interface SaleExceptionPayload {
+    /** SKU correcto (CAPTURE_FIX). */
+    sku?: string;
+    /** Monto correcto en centavos (PRICE_OVERRIDE, CAPTURE_FIX). */
+    amountCents?: number;
+    /** Fecha real de la venta, ISO-8601 (BACKDATING). */
+    soldAt?: string;
+    /** IMEI del equipo de reemplazo (EXTENDED_WARRANTY). */
+    imei?: string;
+}