@fiado/type-kit 3.282.0 → 3.284.0

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

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

@@ -0,0 +1,15 @@
+"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/loanConfig/enums/ModifiableByRoleEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+export declare enum ModifiableByRoleEnum {
+    SUPER_ADMIN = "super_admin",
+    SOFOM_ADMIN = "sofom_admin",
+    RETAILER_ADMIN = "retailer_admin"
+}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifiableByRoleEnum = void 0;
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+var ModifiableByRoleEnum;
+(function (ModifiableByRoleEnum) {
+    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
+    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
+    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
+})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

package/bin/phoneSales/DeviceVariantResponseDto.d.ts

@@ -1,10 +1,19 @@
 import { DeviceVariantStatusEnum } from './enums/DeviceVariantStatusEnum';
+import { CurrencyId } from '../currency';
 export declare class DeviceVariantResponseDto {
     id: string;
     model: string;
     color: string;
     storage: string;
     price: number;
+    /**
+     * Multi-moneda (DEC-011): moneda en la que viene expresado `price` — resuelta server-side del
+     * scope del comprador, NUNCA la elige el front. Optional: el catálogo de backoffice (que
+     * muestra TODAS las variantes sin resolver una sola moneda) no lo setea; el catálogo público sí,
+     * siempre. El front de la app DEBE mostrarlo junto al precio y usarlo para validar saldo antes
+     * de dejar avanzar al checkout (evita que el usuario llegue al pago y falle recién ahí).
+     */
+    currencyId?: CurrencyId;
     stock: number;
     /**
      * Presigned GET URL (S3, expira en 1h) — nunca la URL directa del bucket.

package/bin/places/dtos/CashInFeeDto.d.ts

@@ -0,0 +1,17 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+export declare class CashInFeeDto {
+    /** Comisión fija, en la moneda del país. */
+    fixed?: number;
+    /** Porcentaje del monto depositado (0–100). */
+    percentage?: number;
+    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
+    cap?: number;
+    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
+    currency: CurrencyId;
+}

package/bin/places/dtos/CashInFeeDto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CashInFeeDto = void 0;
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+class CashInFeeDto {
+}
+exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -0,0 +1,22 @@
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+export declare class ResendOtpRequest {
+    email: string;
+    tenantId: string;
+}
+/**
+ * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
+ * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
+ * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
+ * el server responde 200 genérico sin session ni método.
+ */
+export interface ResendOtpResponse {
+    session?: string;
+    mfaMethod?: MfaMethodEnum;
+}

package/bin/platformRbac/dtos/ResendOtpRequest.js

@@ -0,0 +1,36 @@
+"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.ResendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+class ResendOtpRequest {
+}
+exports.ResendOtpRequest = ResendOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "tenantId", void 0);

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+export declare class ResendSelfRegisterOtpRequest {
+    tenantId: string;
+    email: string;
+}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.js

@@ -0,0 +1,36 @@
+"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.ResendSelfRegisterOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+class ResendSelfRegisterOtpRequest {
+}
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

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

@@ -0,0 +1,16 @@
+/**
+ * POST /backoffice/exceptions/:exceptionId/notes — agrega una nota a la bitácora de la excepción.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Es la conversación de seguimiento que la pantalla dibuja bajo la ficha: pedir evidencia, dejar
+ * contexto, registrar lo que se habló por fuera. **No cambia el estado** — para eso están `/review`,
+ * `/resolve` y `/apply`.
+ *
+ * El `body` es OBLIGATORIO: una nota vacía no es una nota, es ruido en un registro auditable.
+ *
+ * A diferencia de las demás mutaciones de la excepción, esta se puede agregar en CUALQUIER estado,
+ * incluso después de resuelta: cerrar el caso no cierra la conversación sobre él.
+ */
+export declare class AddSaleExceptionNoteRequest {
+    body: string;
+}

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

@@ -0,0 +1,37 @@
+"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.AddSaleExceptionNoteRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /backoffice/exceptions/:exceptionId/notes — agrega una nota a la bitácora de la excepción.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Es la conversación de seguimiento que la pantalla dibuja bajo la ficha: pedir evidencia, dejar
+ * contexto, registrar lo que se habló por fuera. **No cambia el estado** — para eso están `/review`,
+ * `/resolve` y `/apply`.
+ *
+ * El `body` es OBLIGATORIO: una nota vacía no es una nota, es ruido en un registro auditable.
+ *
+ * A diferencia de las demás mutaciones de la excepción, esta se puede agregar en CUALQUIER estado,
+ * incluso después de resuelta: cerrar el caso no cierra la conversación sobre él.
+ */
+class AddSaleExceptionNoteRequest {
+}
+exports.AddSaleExceptionNoteRequest = AddSaleExceptionNoteRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(3),
+    (0, class_validator_1.MaxLength)(1000),
+    __metadata("design:type", String)
+], AddSaleExceptionNoteRequest.prototype, "body", void 0);

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

@@ -0,0 +1,16 @@
+/**
+ * POST /backoffice/exceptions/:exceptionId/apply — marca la excepción como APLICADA
+ * (`APPROVED → APPLIED`). SureKeep Fase 3 — pista Retail.
+ *
+ * 🔴 **DEC-034 — esto NO muta la venta ni re-liquida comisión.** Es marca de estado + entrada de
+ * bitácora, nada más. `APPROVED` significa «el Admin VL lo autorizó» y `APPLIED` «alguien ya lo
+ * ejecutó por fuera»: el cierre del circuito es manual hasta que exista `SaleAmendedV1` (F4). Sin este
+ * endpoint, toda excepción aprobada queda para siempre en `APPROVED` y la bandeja no distingue lo
+ * pendiente de lo hecho.
+ *
+ * La `note` es OPCIONAL: describe CÓMO se aplicó (folio de la nota de crédito, ticket del ajuste).
+ * Cuando viene, entra al timeline como evento `APPLIED`.
+ */
+export declare class ApplySaleExceptionRequest {
+    note?: string;
+}

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

@@ -0,0 +1,38 @@
+"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.ApplySaleExceptionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /backoffice/exceptions/:exceptionId/apply — marca la excepción como APLICADA
+ * (`APPROVED → APPLIED`). SureKeep Fase 3 — pista Retail.
+ *
+ * 🔴 **DEC-034 — esto NO muta la venta ni re-liquida comisión.** Es marca de estado + entrada de
+ * bitácora, nada más. `APPROVED` significa «el Admin VL lo autorizó» y `APPLIED` «alguien ya lo
+ * ejecutó por fuera»: el cierre del circuito es manual hasta que exista `SaleAmendedV1` (F4). Sin este
+ * endpoint, toda excepción aprobada queda para siempre en `APPROVED` y la bandeja no distingue lo
+ * pendiente de lo hecho.
+ *
+ * La `note` es OPCIONAL: describe CÓMO se aplicó (folio de la nota de crédito, ticket del ajuste).
+ * Cuando viene, entra al timeline como evento `APPLIED`.
+ */
+class ApplySaleExceptionRequest {
+}
+exports.ApplySaleExceptionRequest = ApplySaleExceptionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(3),
+    (0, class_validator_1.MaxLength)(1000),
+    __metadata("design:type", String)
+], ApplySaleExceptionRequest.prototype, "note", void 0);

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

@@ -0,0 +1,14 @@
+/**
+ * POST /backoffice/exceptions/:exceptionId/review — el Admin VL TOMA la excepción (`NEW → IN_REVIEW`).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * No es un veredicto: solo marca que alguien se hizo cargo, para que dos Admin VL no trabajen el
+ * mismo caso. La `note` es OPCIONAL — tomar un caso no exige explicar nada; obligarlo solo agregaría
+ * fricción a un click de bandeja. Cuando viene, entra al timeline como evento `REVIEW`.
+ *
+ * **Idempotente** con el guard local (`IIdempotencyGuard` + `SureKeepSharedIdempotency_GT`) y, además,
+ * la transición solo sale de `NEW`: un doble click devuelve `409`.
+ */
+export declare class ReviewSaleExceptionRequest {
+    note?: string;
+}

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

@@ -0,0 +1,36 @@
+"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.ReviewSaleExceptionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /backoffice/exceptions/:exceptionId/review — el Admin VL TOMA la excepción (`NEW → IN_REVIEW`).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * No es un veredicto: solo marca que alguien se hizo cargo, para que dos Admin VL no trabajen el
+ * mismo caso. La `note` es OPCIONAL — tomar un caso no exige explicar nada; obligarlo solo agregaría
+ * fricción a un click de bandeja. Cuando viene, entra al timeline como evento `REVIEW`.
+ *
+ * **Idempotente** con el guard local (`IIdempotencyGuard` + `SureKeepSharedIdempotency_GT`) y, además,
+ * la transición solo sale de `NEW`: un doble click devuelve `409`.
+ */
+class ReviewSaleExceptionRequest {
+}
+exports.ReviewSaleExceptionRequest = ReviewSaleExceptionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(3),
+    (0, class_validator_1.MaxLength)(1000),
+    __metadata("design:type", String)
+], ReviewSaleExceptionRequest.prototype, "note", void 0);

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

@@ -26,6 +26,14 @@ export interface BackofficeSalesKpisResponse {
     deltaVsYesterdayPct: number | null;
     /** Monto del MISMO día de la semana pasada, en centavos — el baseline honesto contra la estacionalidad. */
     baselineSameWeekdayCents: number;
+    /**
+     * Piezas del MISMO día de la semana pasada — la otra mitad del baseline.
+     *
+     * 🔴 Sin esto el ticket promedio de hace 7 días es **inderivable**: el monto solo no alcanza, y el
+     * Home lo necesita para su delta de ticket. Es el mismo par que `soldTodayCents` / `unitsToday`
+     * forman para hoy.
+     */
+    baselineSameWeekdayUnits: 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/enums/SaleExceptionEventKindEnum.d.ts

@@ -3,6 +3,7 @@
  * dibuja bajo la ficha). SureKeep Fase 3 — pista Retail.
  *
  * REQUEST - El alta: quién la levantó y por qué.
+ * REVIEW - Un Admin VL la TOMÓ para revisarla (`NEW → IN_REVIEW`). No es un veredicto.
  * NOTE - Nota de seguimiento (pide evidencia, deja contexto).
  * APPROVAL - Queda aprobada.
  * REJECTION - Queda rechazada.
@@ -10,6 +11,7 @@
  */
 export declare enum SaleExceptionEventKindEnum {
     REQUEST = "REQUEST",
+    REVIEW = "REVIEW",
     NOTE = "NOTE",
     APPROVAL = "APPROVAL",
     REJECTION = "REJECTION",

package/bin/retailWizard/enums/SaleExceptionEventKindEnum.js

@@ -6,6 +6,7 @@ exports.SaleExceptionEventKindEnum = void 0;
  * dibuja bajo la ficha). SureKeep Fase 3 — pista Retail.
  *
  * REQUEST - El alta: quién la levantó y por qué.
+ * REVIEW - Un Admin VL la TOMÓ para revisarla (`NEW → IN_REVIEW`). No es un veredicto.
  * NOTE - Nota de seguimiento (pide evidencia, deja contexto).
  * APPROVAL - Queda aprobada.
  * REJECTION - Queda rechazada.
@@ -14,6 +15,7 @@ exports.SaleExceptionEventKindEnum = void 0;
 var SaleExceptionEventKindEnum;
 (function (SaleExceptionEventKindEnum) {
     SaleExceptionEventKindEnum["REQUEST"] = "REQUEST";
+    SaleExceptionEventKindEnum["REVIEW"] = "REVIEW";
     SaleExceptionEventKindEnum["NOTE"] = "NOTE";
     SaleExceptionEventKindEnum["APPROVAL"] = "APPROVAL";
     SaleExceptionEventKindEnum["REJECTION"] = "REJECTION";

package/bin/retailWizard/index.d.ts

@@ -84,7 +84,10 @@ export * from './dtos/SaleException';
 export * from './dtos/SalesReportDefinition';
 export * from './dtos/SalesReportRun';
 export * from './dtos/requests/CreateSaleExceptionRequest';
+export * from './dtos/requests/ReviewSaleExceptionRequest';
 export * from './dtos/requests/ResolveSaleExceptionRequest';
+export * from './dtos/requests/ApplySaleExceptionRequest';
+export * from './dtos/requests/AddSaleExceptionNoteRequest';
 export * from './dtos/requests/RunSalesReportRequest';
 export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';

package/bin/retailWizard/index.js

@@ -111,7 +111,10 @@ __exportStar(require("./dtos/SalesReportDefinition"), exports);
 __exportStar(require("./dtos/SalesReportRun"), exports);
 // Requests
 __exportStar(require("./dtos/requests/CreateSaleExceptionRequest"), exports);
+__exportStar(require("./dtos/requests/ReviewSaleExceptionRequest"), exports);
 __exportStar(require("./dtos/requests/ResolveSaleExceptionRequest"), exports);
+__exportStar(require("./dtos/requests/ApplySaleExceptionRequest"), exports);
+__exportStar(require("./dtos/requests/AddSaleExceptionNoteRequest"), exports);
 __exportStar(require("./dtos/requests/RunSalesReportRequest"), exports);
 __exportStar(require("./dtos/requests/BackofficeCancelSaleRequest"), exports);
 // Responses

package/package.json

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

package/src/phoneSales/DeviceVariantResponseDto.ts

@@ -1,4 +1,5 @@
 import { DeviceVariantStatusEnum } from './enums/DeviceVariantStatusEnum';
+import { CurrencyId } from '../currency';
 
 export class DeviceVariantResponseDto {
   id!: string;
@@ -6,6 +7,14 @@ export class DeviceVariantResponseDto {
   color!: string;
   storage!: string;
   price!: number;
+  /**
+   * Multi-moneda (DEC-011): moneda en la que viene expresado `price` — resuelta server-side del
+   * scope del comprador, NUNCA la elige el front. Optional: el catálogo de backoffice (que
+   * muestra TODAS las variantes sin resolver una sola moneda) no lo setea; el catálogo público sí,
+   * siempre. El front de la app DEBE mostrarlo junto al precio y usarlo para validar saldo antes
+   * de dejar avanzar al checkout (evita que el usuario llegue al pago y falle recién ahí).
+   */
+  currencyId?: CurrencyId;
   stock!: number;
   /**
    * Presigned GET URL (S3, expira en 1h) — nunca la URL directa del bucket.

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

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength, MinLength } from 'class-validator';
+
+/**
+ * POST /backoffice/exceptions/:exceptionId/notes — agrega una nota a la bitácora de la excepción.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Es la conversación de seguimiento que la pantalla dibuja bajo la ficha: pedir evidencia, dejar
+ * contexto, registrar lo que se habló por fuera. **No cambia el estado** — para eso están `/review`,
+ * `/resolve` y `/apply`.
+ *
+ * El `body` es OBLIGATORIO: una nota vacía no es una nota, es ruido en un registro auditable.
+ *
+ * A diferencia de las demás mutaciones de la excepción, esta se puede agregar en CUALQUIER estado,
+ * incluso después de resuelta: cerrar el caso no cierra la conversación sobre él.
+ */
+export class AddSaleExceptionNoteRequest {
+    @Expose()
+    @IsString()
+    @MinLength(3)
+    @MaxLength(1000)
+    body!: string;
+}

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

@@ -0,0 +1,24 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString, MaxLength, MinLength } from 'class-validator';
+
+/**
+ * POST /backoffice/exceptions/:exceptionId/apply — marca la excepción como APLICADA
+ * (`APPROVED → APPLIED`). SureKeep Fase 3 — pista Retail.
+ *
+ * 🔴 **DEC-034 — esto NO muta la venta ni re-liquida comisión.** Es marca de estado + entrada de
+ * bitácora, nada más. `APPROVED` significa «el Admin VL lo autorizó» y `APPLIED` «alguien ya lo
+ * ejecutó por fuera»: el cierre del circuito es manual hasta que exista `SaleAmendedV1` (F4). Sin este
+ * endpoint, toda excepción aprobada queda para siempre en `APPROVED` y la bandeja no distingue lo
+ * pendiente de lo hecho.
+ *
+ * La `note` es OPCIONAL: describe CÓMO se aplicó (folio de la nota de crédito, ticket del ajuste).
+ * Cuando viene, entra al timeline como evento `APPLIED`.
+ */
+export class ApplySaleExceptionRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MinLength(3)
+    @MaxLength(1000)
+    note?: string;
+}

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

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString, MaxLength, MinLength } from 'class-validator';
+
+/**
+ * POST /backoffice/exceptions/:exceptionId/review — el Admin VL TOMA la excepción (`NEW → IN_REVIEW`).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * No es un veredicto: solo marca que alguien se hizo cargo, para que dos Admin VL no trabajen el
+ * mismo caso. La `note` es OPCIONAL — tomar un caso no exige explicar nada; obligarlo solo agregaría
+ * fricción a un click de bandeja. Cuando viene, entra al timeline como evento `REVIEW`.
+ *
+ * **Idempotente** con el guard local (`IIdempotencyGuard` + `SureKeepSharedIdempotency_GT`) y, además,
+ * la transición solo sale de `NEW`: un doble click devuelve `409`.
+ */
+export class ReviewSaleExceptionRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MinLength(3)
+    @MaxLength(1000)
+    note?: string;
+}

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

@@ -28,6 +28,14 @@ export interface BackofficeSalesKpisResponse {
     deltaVsYesterdayPct: number | null;
     /** Monto del MISMO día de la semana pasada, en centavos — el baseline honesto contra la estacionalidad. */
     baselineSameWeekdayCents: number;
+    /**
+     * Piezas del MISMO día de la semana pasada — la otra mitad del baseline.
+     *
+     * 🔴 Sin esto el ticket promedio de hace 7 días es **inderivable**: el monto solo no alcanza, y el
+     * Home lo necesita para su delta de ticket. Es el mismo par que `soldTodayCents` / `unitsToday`
+     * forman para hoy.
+     */
+    baselineSameWeekdayUnits: number;
     mix: SalesFinancierMixEntry[];
     /** Meta del día del retailer, en centavos. `null` mientras no exista la tabla de metas. */
     goalCents: number | null;

package/src/retailWizard/enums/SaleExceptionEventKindEnum.ts

@@ -3,6 +3,7 @@
  * dibuja bajo la ficha). SureKeep Fase 3 — pista Retail.
  *
  * REQUEST - El alta: quién la levantó y por qué.
+ * REVIEW - Un Admin VL la TOMÓ para revisarla (`NEW → IN_REVIEW`). No es un veredicto.
  * NOTE - Nota de seguimiento (pide evidencia, deja contexto).
  * APPROVAL - Queda aprobada.
  * REJECTION - Queda rechazada.
@@ -10,6 +11,7 @@
  */
 export enum SaleExceptionEventKindEnum {
     REQUEST = 'REQUEST',
+    REVIEW = 'REVIEW',
     NOTE = 'NOTE',
     APPROVAL = 'APPROVAL',
     REJECTION = 'REJECTION',

package/src/retailWizard/index.ts

@@ -104,7 +104,10 @@ export * from './dtos/SalesReportRun';
 
 // Requests
 export * from './dtos/requests/CreateSaleExceptionRequest';
+export * from './dtos/requests/ReviewSaleExceptionRequest';
 export * from './dtos/requests/ResolveSaleExceptionRequest';
+export * from './dtos/requests/ApplySaleExceptionRequest';
+export * from './dtos/requests/AddSaleExceptionNoteRequest';
 export * from './dtos/requests/RunSalesReportRequest';
 export * from './dtos/requests/BackofficeCancelSaleRequest';
 

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