@fiado/type-kit 3.283.0 → 3.285.0

package/bin/account/dtos/AccountCreateRequest.d.ts

@@ -37,4 +37,10 @@ export declare class AccountCreateRequest {
     SSN_ITIN?: string;
     externalReferenceId?: string;
     source?: "BACKOFFICE" | "USER_APP" | "API";
+    /**
+     * Nombre a imprimir en la tarjeta, leido de People tal cual: lo calcula el
+     * lambda de identidad y aqui solo se transporta. MAYUSCULAS sin acentos y
+     * maximo 21 caracteres, que es el limite de name_on_card en Central Payments.
+     */
+    usName21?: string;
 }

package/bin/account/dtos/AccountCreateRequest.js

@@ -141,3 +141,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AccountCreateRequest.prototype, "source", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(21),
+    __metadata("design:type", String)
+], AccountCreateRequest.prototype, "usName21", void 0);

package/bin/account/dtos/CreateBankAccountUserRequest.d.ts

@@ -16,4 +16,13 @@ export declare class CreateBankAccountUserRequest {
     gender?: "M" | "F";
     externalReferenceId?: string;
     source?: "BACKOFFICE" | "USER_APP" | "API";
+    /**
+     * Nombre a imprimir en la tarjeta que se emite con el alta. Viene ya
+     * calculado desde People, en MAYUSCULAS sin acentos y con maximo 21
+     * caracteres, que es el limite de name_on_card en Central Payments.
+     *
+     * Opcional a proposito: si no llega, el proveedor genera el nombre como lo
+     * hacia antes, asi que el despliegue no depende del orden entre lambdas.
+     */
+    usName21?: string;
 }

package/bin/card/dtos/CardApplicationRequest.d.ts

@@ -12,4 +12,10 @@ export declare class CardApplicationRequest {
     firstNameSecondary: string;
     lastNameSecondary: string;
     phoneNumberSecondary: string;
+    /**
+     * Nombre a imprimir en la tarjeta. Si no viene, el proveedor conserva el que
+     * ya traia la tarjeta. El limite de 21 es el de name_on_card en Central
+     * Payments.
+     */
+    nameOnCard?: string;
 }

package/bin/card/dtos/CardApplicationRequest.js

@@ -70,3 +70,9 @@ __decorate([
     (0, IsPhoneNumberConstraint_1.IsPhoneNumberFiado)(),
     __metadata("design:type", String)
 ], CardApplicationRequest.prototype, "phoneNumberSecondary", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(21),
+    __metadata("design:type", String)
+], CardApplicationRequest.prototype, "nameOnCard", void 0);

package/bin/card/dtos/Internal/ReplaceBankAccountCardRequest.d.ts

@@ -5,4 +5,10 @@ export declare class ReplaceBankAccountCardRequest {
     lastName?: string;
     address?: AddressBase;
     reason?: ReplaceBankAccountCardReasonEnum;
+    /**
+     * Nombre a imprimir en la tarjeta nueva, acotado a 21 caracteres, que es el
+     * limite de name_on_card en Central Payments. Si no viene, el conector
+     * conserva el nombre que ya traia la tarjeta que se reemplaza.
+     */
+    nameOnCard?: string;
 }

package/bin/identity/dtos/PeopleResponse.d.ts

@@ -14,6 +14,13 @@ export declare class PeopleResponse {
     creationMethod: AppEnum | null;
     names: PeopleName[] | null;
     indexName: string | null;
+    /**
+     * Nombre a imprimir en la tarjeta, derivado de usNames y usLastNames por el
+     * lambda de identidad: MAYUSCULAS sin acentos y maximo 21 caracteres, que es
+     * el limite de name_on_card en Central Payments. Solo de lectura para los
+     * consumidores; se recalcula solo en cada guardado de la persona.
+     */
+    usName21: string | null;
     preferredName: string | null;
     usSuffix: string | null;
     usLastNames: string | null;

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.283.0",
+  "version": "3.285.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/account/dtos/AccountCreateRequest.ts

@@ -1,4 +1,4 @@
-import { IsBoolean, IsDateString, IsEmail, IsEnum, IsOptional, IsString, Length, Matches, ValidateNested } from 'class-validator';
+import { IsBoolean, IsDateString, IsEmail, IsEnum, IsOptional, IsString, Length, Matches, MaxLength, ValidateNested } from 'class-validator';
 import { AddressResponse } from "../../address";
 import { CountryId } from "../../country";
 import { regexUuidV4 } from '../../helpers/constans/regex';
@@ -113,4 +113,14 @@ export class AccountCreateRequest {
     @IsString()
     source?: "BACKOFFICE" | "USER_APP" | "API";
 
+    /**
+     * Nombre a imprimir en la tarjeta, leido de People tal cual: lo calcula el
+     * lambda de identidad y aqui solo se transporta. MAYUSCULAS sin acentos y
+     * maximo 21 caracteres, que es el limite de name_on_card en Central Payments.
+     */
+    @IsOptional()
+    @IsString()
+    @MaxLength(21)
+    usName21?: string;
+
 }

package/src/account/dtos/CreateBankAccountUserRequest.ts

@@ -17,6 +17,15 @@ export class CreateBankAccountUserRequest {
     gender?: "M" | "F";
     externalReferenceId?: string;
     source?: "BACKOFFICE" | "USER_APP" | "API";
-}  
+    /**
+     * Nombre a imprimir en la tarjeta que se emite con el alta. Viene ya
+     * calculado desde People, en MAYUSCULAS sin acentos y con maximo 21
+     * caracteres, que es el limite de name_on_card en Central Payments.
+     *
+     * Opcional a proposito: si no llega, el proveedor genera el nombre como lo
+     * hacia antes, asi que el despliegue no depende del orden entre lambdas.
+     */
+    usName21?: string;
+}
 
 

package/src/card/dtos/CardApplicationRequest.ts

@@ -1,6 +1,6 @@
 
 
-import { IsEnum, IsNumber, isNumber, IsOptional, IsString } from 'class-validator';
+import { IsEnum, IsNumber, isNumber, IsOptional, IsString, MaxLength } from 'class-validator';
 import { CreditOrDebit } from '../enums/CreditOrDebit';
 import { VirtualOrPhysical } from '../enums/VirtualOrPhysical';
 import { DeliveryChannel } from '../enums/DeliveryChannel';
@@ -48,5 +48,15 @@ export class CardApplicationRequest {
   @IsOptional()
   @IsPhoneNumberFiado()
   phoneNumberSecondary: string;
+
+  /**
+   * Nombre a imprimir en la tarjeta. Si no viene, el proveedor conserva el que
+   * ya traia la tarjeta. El limite de 21 es el de name_on_card en Central
+   * Payments.
+   */
+  @IsOptional()
+  @IsString()
+  @MaxLength(21)
+  nameOnCard?: string;
 }
 

package/src/card/dtos/Internal/ReplaceBankAccountCardRequest.ts

@@ -6,4 +6,10 @@ export class ReplaceBankAccountCardRequest {
     lastName?: string;
     address?: AddressBase;
     reason?: ReplaceBankAccountCardReasonEnum;
+    /**
+     * Nombre a imprimir en la tarjeta nueva, acotado a 21 caracteres, que es el
+     * limite de name_on_card en Central Payments. Si no viene, el conector
+     * conserva el nombre que ya traia la tarjeta que se reemplaza.
+     */
+    nameOnCard?: string;
 }

package/src/identity/dtos/PeopleResponse.ts

@@ -17,6 +17,13 @@ export class PeopleResponse {
     creationMethod: AppEnum | null;
     names: PeopleName[] | null;
     indexName: string | null;
+    /**
+     * Nombre a imprimir en la tarjeta, derivado de usNames y usLastNames por el
+     * lambda de identidad: MAYUSCULAS sin acentos y maximo 21 caracteres, que es
+     * el limite de name_on_card en Central Payments. Solo de lectura para los
+     * consumidores; se recalcula solo en cada guardado de la persona.
+     */
+    usName21: string | null;
     preferredName: string | null;
     usSuffix: string | null;
     usLastNames: string | null;

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