@fiado/type-kit 3.260.0 → 3.262.0

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

@@ -0,0 +1,48 @@
+"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.BackofficeCancelSaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /backoffice/sales/:saleId/cancel — cancelación del Admin VL. SureKeep Fase 3 — pista Retail.
+ *
+ * Es un endpoint SEPARADO de `POST /sales/:saleId/cancel` (el del vendedor), no una rama del mismo, y
+ * por eso lleva su propio DTO. Son dos reglas de negocio distintas: la del vendedor está acotada a su
+ * propia venta y a la ventana de 7 días; la del admin puede cancelar FUERA de ventana — que es justo
+ * lo que habilita la excepción `LATE_CANCEL`. Mezclarlas en un handler enredaría las dos.
+ *
+ * `outOfWindowExceptionId` es el puente entre las dos piezas: cancelar fuera de ventana exige una
+ * excepción `LATE_CANCEL` ya aprobada. Sin ella el manager rechaza, aunque el actor tenga el permiso.
+ */
+class BackofficeCancelSaleRequest {
+}
+exports.BackofficeCancelSaleRequest = BackofficeCancelSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(10),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], BackofficeCancelSaleRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], BackofficeCancelSaleRequest.prototype, "equipmentVerified", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BackofficeCancelSaleRequest.prototype, "outOfWindowExceptionId", void 0);

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

@@ -0,0 +1,28 @@
+import { SaleExceptionTypeEnum } from '../../enums/SaleExceptionTypeEnum';
+/** Lo que la excepción pide cambiar. Cada tipo usa los campos que le tocan; todos son opcionales. */
+export declare class SaleExceptionPayloadInput {
+    sku?: string;
+    amountCents?: number;
+    soldAt?: string;
+    imei?: string;
+}
+/**
+ * POST /backoffice/exceptions — levanta una excepción sobre una venta. SureKeep Fase 3 — pista Retail.
+ *
+ * La `justification` es OBLIGATORIA y con mínimo real: es lo único que vuelve auditable la excepción,
+ * y un campo libre que acepta `"x"` no audita nada. Escribe `RetailSaleException_GT` +
+ * `SharedAuditTrail_GT` en la MISMA `TransactWriteItems`.
+ *
+ * El `retailerId` NO viaja en el request: sale del token (`scopeFromRetailer`).
+ */
+export declare class CreateSaleExceptionRequest {
+    type: SaleExceptionTypeEnum;
+    /** `null`/ausente en las excepciones generales, que no cuelgan de una venta puntual. */
+    saleId?: string;
+    /** Obligatorio cuando NO hay `saleId`; si hay venta, se toma el de la venta. */
+    storeId?: string;
+    justification: string;
+    /** Impacto económico con signo, en centavos. Negativo si la excepción resta (descuento). */
+    impactCents?: number;
+    payload?: SaleExceptionPayloadInput;
+}

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

@@ -0,0 +1,96 @@
+"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.CreateSaleExceptionRequest = exports.SaleExceptionPayloadInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SaleExceptionTypeEnum_1 = require("../../enums/SaleExceptionTypeEnum");
+/** Lo que la excepción pide cambiar. Cada tipo usa los campos que le tocan; todos son opcionales. */
+class SaleExceptionPayloadInput {
+}
+exports.SaleExceptionPayloadInput = SaleExceptionPayloadInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], SaleExceptionPayloadInput.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], SaleExceptionPayloadInput.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], SaleExceptionPayloadInput.prototype, "soldAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(20),
+    __metadata("design:type", String)
+], SaleExceptionPayloadInput.prototype, "imei", void 0);
+/**
+ * POST /backoffice/exceptions — levanta una excepción sobre una venta. SureKeep Fase 3 — pista Retail.
+ *
+ * La `justification` es OBLIGATORIA y con mínimo real: es lo único que vuelve auditable la excepción,
+ * y un campo libre que acepta `"x"` no audita nada. Escribe `RetailSaleException_GT` +
+ * `SharedAuditTrail_GT` en la MISMA `TransactWriteItems`.
+ *
+ * El `retailerId` NO viaja en el request: sale del token (`scopeFromRetailer`).
+ */
+class CreateSaleExceptionRequest {
+}
+exports.CreateSaleExceptionRequest = CreateSaleExceptionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SaleExceptionTypeEnum_1.SaleExceptionTypeEnum),
+    __metadata("design:type", String)
+], CreateSaleExceptionRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CreateSaleExceptionRequest.prototype, "saleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CreateSaleExceptionRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(20),
+    (0, class_validator_1.MaxLength)(1000),
+    __metadata("design:type", String)
+], CreateSaleExceptionRequest.prototype, "justification", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CreateSaleExceptionRequest.prototype, "impactCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SaleExceptionPayloadInput),
+    __metadata("design:type", SaleExceptionPayloadInput)
+], CreateSaleExceptionRequest.prototype, "payload", void 0);

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

@@ -0,0 +1,15 @@
+import { SaleExceptionDecisionEnum } from '../../enums/SaleExceptionDecisionEnum';
+/**
+ * POST /backoffice/exceptions/:exceptionId/resolve — aprueba o rechaza una excepción.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * La `resolution` es OBLIGATORIA en los dos veredictos, no solo al rechazar: un «aprobada» sin motivo
+ * escrito es exactamente el registro que después nadie puede defender ante una auditoría.
+ *
+ * **Idempotente** con el guard local (`IIdempotencyGuard` + `SureKeepSharedIdempotency_GT`): un doble
+ * click no puede resolver dos veces. ⚠️ El decorador `@Idempotent` NO existe en el gateway-adapter.
+ */
+export declare class ResolveSaleExceptionRequest {
+    decision: SaleExceptionDecisionEnum;
+    resolution: string;
+}

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

@@ -0,0 +1,40 @@
+"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.ResolveSaleExceptionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SaleExceptionDecisionEnum_1 = require("../../enums/SaleExceptionDecisionEnum");
+/**
+ * POST /backoffice/exceptions/:exceptionId/resolve — aprueba o rechaza una excepción.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * La `resolution` es OBLIGATORIA en los dos veredictos, no solo al rechazar: un «aprobada» sin motivo
+ * escrito es exactamente el registro que después nadie puede defender ante una auditoría.
+ *
+ * **Idempotente** con el guard local (`IIdempotencyGuard` + `SureKeepSharedIdempotency_GT`): un doble
+ * click no puede resolver dos veces. ⚠️ El decorador `@Idempotent` NO existe en el gateway-adapter.
+ */
+class ResolveSaleExceptionRequest {
+}
+exports.ResolveSaleExceptionRequest = ResolveSaleExceptionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SaleExceptionDecisionEnum_1.SaleExceptionDecisionEnum),
+    __metadata("design:type", String)
+], ResolveSaleExceptionRequest.prototype, "decision", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(10),
+    (0, class_validator_1.MaxLength)(1000),
+    __metadata("design:type", String)
+], ResolveSaleExceptionRequest.prototype, "resolution", void 0);

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

@@ -0,0 +1,18 @@
+import { ReportFormatEnum } from '../../enums/ReportFormatEnum';
+/**
+ * POST /backoffice/reports/:reportId/run — encola la generación de un reporte.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Devuelve el `SalesReportRun` en `QUEUED`, NO el archivo: la generación es asíncrona por el límite de
+ * 29 s de API Gateway. El front poletea `GET /backoffice/reports` hasta ver `READY` y ahí usa el
+ * `downloadUrl`.
+ *
+ * El `reportId` viaja en el path, no acá. El `retailerId` sale del token.
+ */
+export declare class RunSalesReportRequest {
+    format: ReportFormatEnum;
+    /** Inicio de la ventana de datos, ISO-8601. Si falta, la resuelve la periodicidad del reporte. */
+    periodFrom?: string;
+    /** Fin de la ventana de datos, ISO-8601. Si falta, la resuelve la periodicidad del reporte. */
+    periodTo?: string;
+}

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

@@ -0,0 +1,45 @@
+"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.RunSalesReportRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReportFormatEnum_1 = require("../../enums/ReportFormatEnum");
+/**
+ * POST /backoffice/reports/:reportId/run — encola la generación de un reporte.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Devuelve el `SalesReportRun` en `QUEUED`, NO el archivo: la generación es asíncrona por el límite de
+ * 29 s de API Gateway. El front poletea `GET /backoffice/reports` hasta ver `READY` y ahí usa el
+ * `downloadUrl`.
+ *
+ * El `reportId` viaja en el path, no acá. El `retailerId` sale del token.
+ */
+class RunSalesReportRequest {
+}
+exports.RunSalesReportRequest = RunSalesReportRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ReportFormatEnum_1.ReportFormatEnum),
+    __metadata("design:type", String)
+], RunSalesReportRequest.prototype, "format", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RunSalesReportRequest.prototype, "periodFrom", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RunSalesReportRequest.prototype, "periodTo", void 0);

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

@@ -0,0 +1,14 @@
+import type { SalesReportDefinition } from '../SalesReportDefinition';
+import type { SalesReportRun } from '../SalesReportRun';
+/**
+ * GET /backoffice/reports — el catálogo de los 5 reportes de ventas MÁS el log de corridas recientes,
+ * que es exactamente lo que la pantalla dibuja en sus dos secciones. SureKeep Fase 3 — pista Retail.
+ *
+ * Van juntos en una sola respuesta y no en dos endpoints porque la pantalla siempre necesita los dos,
+ * y el catálogo son 5 ítems de configuración en código: partirlo costaría un round-trip para nada.
+ */
+export interface BackofficeReportsResponse {
+    definitions: SalesReportDefinition[];
+    /** Últimas corridas del retailer, más recientes primero. */
+    runs: SalesReportRun[];
+}

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

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

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

@@ -0,0 +1,32 @@
+import type { SaleFinancierEnum } from '../../enums/SaleFinancierEnum';
+/** Un tramo del mix por financiera del Home del Admin VL. */
+export interface SalesFinancierMixEntry {
+    financier: SaleFinancierEnum;
+    count: number;
+    amountCents: number;
+}
+/**
+ * GET /backoffice/sales/kpis — los KPIs del Home del Admin VL. SureKeep Fase 3 — pista Retail.
+ *
+ * 🟡 **Incompleto por diseño:** el panel «Meta del día» necesita las metas por tienda, que viven en
+ * `retail-org-business` y **todavía no existen**. `goal` viaja `null` hasta entonces; todo lo demás
+ * son datos reales. El front debe tratar `null` como «sin meta configurada», no como cero.
+ *
+ * Las llaves van en inglés (el diseño no fija un payload literal acá, a diferencia de
+ * `BackofficeSalesStatsResponse`).
+ */
+export interface BackofficeSalesKpisResponse {
+    /** Monto colocado hoy, en centavos. Mide precio del equipo, no lo cobrado en caja (DEC-032). */
+    soldTodayCents: number;
+    /** Piezas vendidas hoy. */
+    unitsToday: number;
+    /** Ticket promedio de hoy, en centavos. 0 si no hubo ventas. */
+    averageTicketCents: number;
+    /** Delta porcentual del monto de hoy contra ayer. `null` si ayer no hubo ventas (no se divide por cero). */
+    deltaVsYesterdayPct: number | null;
+    /** Monto del MISMO día de la semana pasada, en centavos — el baseline honesto contra la estacionalidad. */
+    baselineSameWeekdayCents: number;
+    mix: SalesFinancierMixEntry[];
+    /** Meta del día del retailer, en centavos. `null` mientras no exista la tabla de metas. */
+    goalCents: number | null;
+}

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * GET /backoffice/sales/stats — los pills de conteo arriba de la tabla de Ventas del Admin VL.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * ⚠️ **Las llaves van en ESPAÑOL, a propósito y como única excepción del dominio.** Es el contrato
+ * literal que fija el diseño de F3 (`03_backoffice_ventasluga/lambdas/retail-wizard-business.md`) y
+ * contra el que el front ya mockeó la pantalla. Cambiarlas a inglés por consistencia rompería una
+ * pantalla ya construida sin ganar nada. Decisión de Andrés, 2026-08-03.
+ *
+ * `contado` + `credito` == `total`. `surekeep` + `externas` == `credito`: las dos particiones son
+ * completas y NO se solapan (ver `helpers/saleFinancier`).
+ */
+export interface BackofficeSalesStatsResponse {
+    /** Ventas del retailer en la ventana consultada. */
+    total: number;
+    /** Subconjunto de `total` con `soldAt` en el día de hoy. */
+    hoy: number;
+    /** `type: CASH`. */
+    contado: number;
+    /** `type: CREDIT` o `EXTERNAL_REFERRAL` — todo lo que no es contado. */
+    credito: number;
+    /** Financiadas por la SOFOM (`type: CREDIT`). */
+    surekeep: number;
+    /** Financiadas por un tercero (`EXTERNAL_REFERRAL` con proveedor). */
+    externas: number;
+}

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

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

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

@@ -0,0 +1,5 @@
+/** Formato de salida de un reporte del Admin VL. SureKeep Fase 3 — pista Retail. */
+export declare enum ReportFormatEnum {
+    CSV = "CSV",
+    PDF = "PDF"
+}

package/bin/retailWizard/enums/ReportFormatEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportFormatEnum = void 0;
+/** Formato de salida de un reporte del Admin VL. SureKeep Fase 3 — pista Retail. */
+var ReportFormatEnum;
+(function (ReportFormatEnum) {
+    ReportFormatEnum["CSV"] = "CSV";
+    ReportFormatEnum["PDF"] = "PDF";
+})(ReportFormatEnum || (exports.ReportFormatEnum = ReportFormatEnum = {}));

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 = {}));