@fiado/type-kit 3.259.0 → 3.261.0

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

@@ -0,0 +1,9 @@
+/**
+ * Periodicidad de un reporte del Admin VL. Los diarios y semanales corren por cron; los mensuales
+ * requieren corrida manual (M6 §5.1). SureKeep Fase 3 — pista Retail.
+ */
+export declare enum ReportPeriodicityEnum {
+    DAILY = "DAILY",
+    WEEKLY = "WEEKLY",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailWizard/enums/ReportPeriodicityEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportPeriodicityEnum = void 0;
+/**
+ * Periodicidad de un reporte del Admin VL. Los diarios y semanales corren por cron; los mensuales
+ * requieren corrida manual (M6 §5.1). SureKeep Fase 3 — pista Retail.
+ */
+var ReportPeriodicityEnum;
+(function (ReportPeriodicityEnum) {
+    ReportPeriodicityEnum["DAILY"] = "DAILY";
+    ReportPeriodicityEnum["WEEKLY"] = "WEEKLY";
+    ReportPeriodicityEnum["MONTHLY"] = "MONTHLY";
+})(ReportPeriodicityEnum || (exports.ReportPeriodicityEnum = ReportPeriodicityEnum = {}));

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

@@ -0,0 +1,18 @@
+/**
+ * Estado de una corrida de reporte. La generación es ASÍNCRONA: el `POST .../run` devuelve `QUEUED` y
+ * el front poletea el listado. SureKeep Fase 3 — pista Retail.
+ *
+ * Es async desde el día uno por el límite de 29 s de API Gateway: un reporte de red completa no entra
+ * en una respuesta síncrona. Mismo error que ya se corrigió en el cierre de corte de comisiones.
+ *
+ * QUEUED - Encolada, sin arrancar.
+ * RUNNING - Generándose.
+ * READY - Lista para descargar (`downloadUrl` presente).
+ * FAILED - Falló; `failureReason` explica por qué.
+ */
+export declare enum ReportRunStatusEnum {
+    QUEUED = "QUEUED",
+    RUNNING = "RUNNING",
+    READY = "READY",
+    FAILED = "FAILED"
+}

package/bin/retailWizard/enums/ReportRunStatusEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportRunStatusEnum = void 0;
+/**
+ * Estado de una corrida de reporte. La generación es ASÍNCRONA: el `POST .../run` devuelve `QUEUED` y
+ * el front poletea el listado. SureKeep Fase 3 — pista Retail.
+ *
+ * Es async desde el día uno por el límite de 29 s de API Gateway: un reporte de red completa no entra
+ * en una respuesta síncrona. Mismo error que ya se corrigió en el cierre de corte de comisiones.
+ *
+ * QUEUED - Encolada, sin arrancar.
+ * RUNNING - Generándose.
+ * READY - Lista para descargar (`downloadUrl` presente).
+ * FAILED - Falló; `failureReason` explica por qué.
+ */
+var ReportRunStatusEnum;
+(function (ReportRunStatusEnum) {
+    ReportRunStatusEnum["QUEUED"] = "QUEUED";
+    ReportRunStatusEnum["RUNNING"] = "RUNNING";
+    ReportRunStatusEnum["READY"] = "READY";
+    ReportRunStatusEnum["FAILED"] = "FAILED";
+})(ReportRunStatusEnum || (exports.ReportRunStatusEnum = ReportRunStatusEnum = {}));

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

@@ -0,0 +1,10 @@
+/**
+ * Veredicto del Admin VL al resolver una excepción. Es un enum PROPIO y no un subconjunto de
+ * `SaleExceptionStatusEnum`: el request expresa una DECISIÓN («apruébala»), no un estado destino, y
+ * mezclarlos dejaría al caller mandar `APPLIED` o `NEW` en un endpoint que no los admite.
+ * SureKeep Fase 3 — pista Retail.
+ */
+export declare enum SaleExceptionDecisionEnum {
+    APPROVE = "APPROVE",
+    REJECT = "REJECT"
+}

package/bin/retailWizard/enums/SaleExceptionDecisionEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleExceptionDecisionEnum = void 0;
+/**
+ * Veredicto del Admin VL al resolver una excepción. Es un enum PROPIO y no un subconjunto de
+ * `SaleExceptionStatusEnum`: el request expresa una DECISIÓN («apruébala»), no un estado destino, y
+ * mezclarlos dejaría al caller mandar `APPLIED` o `NEW` en un endpoint que no los admite.
+ * SureKeep Fase 3 — pista Retail.
+ */
+var SaleExceptionDecisionEnum;
+(function (SaleExceptionDecisionEnum) {
+    SaleExceptionDecisionEnum["APPROVE"] = "APPROVE";
+    SaleExceptionDecisionEnum["REJECT"] = "REJECT";
+})(SaleExceptionDecisionEnum || (exports.SaleExceptionDecisionEnum = SaleExceptionDecisionEnum = {}));

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

@@ -0,0 +1,17 @@
+/**
+ * Tipo de entrada del timeline de una excepción (la conversación que la pantalla de Excepciones
+ * dibuja bajo la ficha). SureKeep Fase 3 — pista Retail.
+ *
+ * REQUEST - El alta: quién la levantó y por qué.
+ * NOTE - Nota de seguimiento (pide evidencia, deja contexto).
+ * APPROVAL - Queda aprobada.
+ * REJECTION - Queda rechazada.
+ * APPLIED - El cambio ya se aplicó al sistema.
+ */
+export declare enum SaleExceptionEventKindEnum {
+    REQUEST = "REQUEST",
+    NOTE = "NOTE",
+    APPROVAL = "APPROVAL",
+    REJECTION = "REJECTION",
+    APPLIED = "APPLIED"
+}

package/bin/retailWizard/enums/SaleExceptionEventKindEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleExceptionEventKindEnum = void 0;
+/**
+ * Tipo de entrada del timeline de una excepción (la conversación que la pantalla de Excepciones
+ * dibuja bajo la ficha). SureKeep Fase 3 — pista Retail.
+ *
+ * REQUEST - El alta: quién la levantó y por qué.
+ * NOTE - Nota de seguimiento (pide evidencia, deja contexto).
+ * APPROVAL - Queda aprobada.
+ * REJECTION - Queda rechazada.
+ * APPLIED - El cambio ya se aplicó al sistema.
+ */
+var SaleExceptionEventKindEnum;
+(function (SaleExceptionEventKindEnum) {
+    SaleExceptionEventKindEnum["REQUEST"] = "REQUEST";
+    SaleExceptionEventKindEnum["NOTE"] = "NOTE";
+    SaleExceptionEventKindEnum["APPROVAL"] = "APPROVAL";
+    SaleExceptionEventKindEnum["REJECTION"] = "REJECTION";
+    SaleExceptionEventKindEnum["APPLIED"] = "APPLIED";
+})(SaleExceptionEventKindEnum || (exports.SaleExceptionEventKindEnum = SaleExceptionEventKindEnum = {}));

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

@@ -0,0 +1,19 @@
+/**
+ * Estado de una excepción de venta. SureKeep Fase 3 — pista Retail.
+ *
+ * NEW - Levantada por el vendedor, sin tomar.
+ * IN_REVIEW - El Admin VL la está revisando.
+ * APPROVED - Aprobada; falta aplicar el cambio a la venta.
+ * APPLIED - Aprobada Y aplicada.
+ * REJECTED - Rechazada, con resolución obligatoria.
+ *
+ * ⚠️ El estado NO va en el sort key de `RetailSaleException_GT`: el sk es inmutable en DynamoDB y esto
+ * cambia en todo el ciclo. El filtro por estado se hace en memoria (son eventos raros).
+ */
+export declare enum SaleExceptionStatusEnum {
+    NEW = "NEW",
+    IN_REVIEW = "IN_REVIEW",
+    APPROVED = "APPROVED",
+    APPLIED = "APPLIED",
+    REJECTED = "REJECTED"
+}

package/bin/retailWizard/enums/SaleExceptionStatusEnum.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleExceptionStatusEnum = void 0;
+/**
+ * Estado de una excepción de venta. SureKeep Fase 3 — pista Retail.
+ *
+ * NEW - Levantada por el vendedor, sin tomar.
+ * IN_REVIEW - El Admin VL la está revisando.
+ * APPROVED - Aprobada; falta aplicar el cambio a la venta.
+ * APPLIED - Aprobada Y aplicada.
+ * REJECTED - Rechazada, con resolución obligatoria.
+ *
+ * ⚠️ El estado NO va en el sort key de `RetailSaleException_GT`: el sk es inmutable en DynamoDB y esto
+ * cambia en todo el ciclo. El filtro por estado se hace en memoria (son eventos raros).
+ */
+var SaleExceptionStatusEnum;
+(function (SaleExceptionStatusEnum) {
+    SaleExceptionStatusEnum["NEW"] = "NEW";
+    SaleExceptionStatusEnum["IN_REVIEW"] = "IN_REVIEW";
+    SaleExceptionStatusEnum["APPROVED"] = "APPROVED";
+    SaleExceptionStatusEnum["APPLIED"] = "APPLIED";
+    SaleExceptionStatusEnum["REJECTED"] = "REJECTED";
+})(SaleExceptionStatusEnum || (exports.SaleExceptionStatusEnum = SaleExceptionStatusEnum = {}));

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

@@ -0,0 +1,19 @@
+/**
+ * Tipo de excepción de venta (bandeja del Admin VL, M6 §5). SureKeep Fase 3 — pista Retail.
+ *
+ * CAPTURE_FIX - Corrección de captura: el POS registró un modelo/SKU distinto al vendido.
+ * LATE_CANCEL - Cancelación fuera de la ventana de 7 días.
+ * BACKDATING - Venta física ejecutada antes de su captura; se pide la fecha real.
+ * PRICE_OVERRIDE - Descuento o precio fuera de lista, autorizado por el Admin VL.
+ * EXTENDED_WARRANTY - Reemplazo de equipo bajo garantía extendida contratada en la venta.
+ *
+ * ⚠️ NO existe `AUTHORIZATION_CAP` (el `autorizacion_tope` del mockup): su dato es de conciliación,
+ * que es cobranza (D1), no retail. La fila del mockup no tiene backend en F3.
+ */
+export declare enum SaleExceptionTypeEnum {
+    CAPTURE_FIX = "CAPTURE_FIX",
+    LATE_CANCEL = "LATE_CANCEL",
+    BACKDATING = "BACKDATING",
+    PRICE_OVERRIDE = "PRICE_OVERRIDE",
+    EXTENDED_WARRANTY = "EXTENDED_WARRANTY"
+}

package/bin/retailWizard/enums/SaleExceptionTypeEnum.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaleExceptionTypeEnum = void 0;
+/**
+ * Tipo de excepción de venta (bandeja del Admin VL, M6 §5). SureKeep Fase 3 — pista Retail.
+ *
+ * CAPTURE_FIX - Corrección de captura: el POS registró un modelo/SKU distinto al vendido.
+ * LATE_CANCEL - Cancelación fuera de la ventana de 7 días.
+ * BACKDATING - Venta física ejecutada antes de su captura; se pide la fecha real.
+ * PRICE_OVERRIDE - Descuento o precio fuera de lista, autorizado por el Admin VL.
+ * EXTENDED_WARRANTY - Reemplazo de equipo bajo garantía extendida contratada en la venta.
+ *
+ * ⚠️ NO existe `AUTHORIZATION_CAP` (el `autorizacion_tope` del mockup): su dato es de conciliación,
+ * que es cobranza (D1), no retail. La fila del mockup no tiene backend en F3.
+ */
+var SaleExceptionTypeEnum;
+(function (SaleExceptionTypeEnum) {
+    SaleExceptionTypeEnum["CAPTURE_FIX"] = "CAPTURE_FIX";
+    SaleExceptionTypeEnum["LATE_CANCEL"] = "LATE_CANCEL";
+    SaleExceptionTypeEnum["BACKDATING"] = "BACKDATING";
+    SaleExceptionTypeEnum["PRICE_OVERRIDE"] = "PRICE_OVERRIDE";
+    SaleExceptionTypeEnum["EXTENDED_WARRANTY"] = "EXTENDED_WARRANTY";
+})(SaleExceptionTypeEnum || (exports.SaleExceptionTypeEnum = SaleExceptionTypeEnum = {}));

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/package.json

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

package/src/helpdesk/dtos/ZendeskInternalAlertRequest.ts

@@ -0,0 +1,31 @@
+import { IsEnum, IsNotEmpty, IsOptional, IsString } from "class-validator";
+import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
+
+/**
+ * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
+ * la convierte en una nota interna de Zendesk: solo la ven los agentes, el usuario nunca.
+ *
+ * El asunto del ticket lo genera zendesk-business — es el único campo que el usuario podría
+ * llegar a ver, así que no lo escribe el caller.
+ */
+export class ZendeskInternalAlertRequest {
+
+    /** Usuario sobre el que se alerta. */
+    @IsNotEmpty()
+    @IsString()
+    directoryId: string;
+
+    /** Detalle del problema. Acá va lo sensible: es lo que se escribe como nota interna. */
+    @IsNotEmpty()
+    @IsString()
+    note: string;
+
+    /** Decide el ruteo en Zendesk (tag, vista y equipo). */
+    @IsEnum(InternalAlertChannel)
+    channel: InternalAlertChannel;
+
+    /** Id del evento origen, para rastrear la alerta de vuelta. */
+    @IsString()
+    @IsOptional()
+    reference?: string;
+}

package/src/helpdesk/enums/InternalAlertChannelEnum.ts

@@ -0,0 +1,7 @@
+/** Canal de una alerta interna: decide el ruteo dentro de Zendesk (tag, vista y equipo). */
+export enum InternalAlertChannel {
+    /** Alertas operativas que resuelve el equipo interno sin involucrar al usuario. */
+    INTERNAL = 'INTERNAL',
+    /** Alertas de cumplimiento regulatorio. El usuario no puede enterarse. */
+    COMPLIANCE = 'COMPLIANCE'
+}

package/src/helpdesk/enums/ZendeskAlertKindEnum.ts

@@ -0,0 +1,7 @@
+/** Discrimina qué transporta un mensaje de la cola de alertamiento de Zendesk. */
+export enum ZendeskAlertKind {
+    /** Nota interna en un ticket: solo la ven los agentes. */
+    INTERNAL_NOTE = 'INTERNAL_NOTE',
+    /** Mensaje proactivo al chat del usuario. */
+    PROACTIVE_MESSAGE = 'PROACTIVE_MESSAGE'
+}

package/src/helpdesk/index.ts

@@ -1,2 +1,8 @@
 export * from './dtos/HelpdeskCreateUserRequest';
-export * from './dtos/HelpdeskCreateTicketRequest';
+export * from './dtos/HelpdeskCreateTicketRequest';
+
+// Alertamiento interno (cola de Zendesk)
+export * from './dtos/ZendeskInternalAlertRequest';
+export * from './enums/InternalAlertChannelEnum';
+export * from './enums/ZendeskAlertKindEnum';
+export * from './interfaces/IZendeskAlertMessage';

package/src/helpdesk/interfaces/IZendeskAlertMessage.ts

@@ -0,0 +1,7 @@
+import { ZendeskAlertKind } from "../enums/ZendeskAlertKindEnum";
+
+/** Sobre de un mensaje de la cola de alertamiento: `kind` decide cómo interpretar `payload`. */
+export interface IZendeskAlertMessage<TPayload = unknown> {
+    kind: ZendeskAlertKind;
+    payload: TPayload;
+}

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';