@fiado/type-kit 3.289.0 → 3.291.0

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

@@ -1,10 +1,13 @@
 import { KycStatus } from "../enums/issuance/KycStatus";
 import { UserStatus } from "../enums/issuance/UserStatus";
 import { KycReason } from "../enums/KycReason";
+import { KycVendorResultDetail } from "./KycVendorResultDetail";
 export declare class CardUpdateIssuanceRequest {
     kycStatus: KycStatus;
     userStatus: UserStatus;
     directoryId: string;
     externalUserId: string;
     kycReasons?: KycReason[];
+    /** Detalle crudo del vendor de KYC. Solo lo manda la ruta del webhook/connector de CP. */
+    kycVendorResults?: KycVendorResultDetail[];
 }

package/bin/card/dtos/CardUpdateIssuanceRequest.js

@@ -10,9 +10,11 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CardUpdateIssuanceRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const KycStatus_1 = require("../enums/issuance/KycStatus");
 const UserStatus_1 = require("../enums/issuance/UserStatus");
+const KycVendorResultDetail_1 = require("./KycVendorResultDetail");
 class CardUpdateIssuanceRequest {
 }
 exports.CardUpdateIssuanceRequest = CardUpdateIssuanceRequest;
@@ -37,3 +39,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", Array)
 ], CardUpdateIssuanceRequest.prototype, "kycReasons", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => KycVendorResultDetail_1.KycVendorResultDetail),
+    __metadata("design:type", Array)
+], CardUpdateIssuanceRequest.prototype, "kycVendorResults", void 0);

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

@@ -0,0 +1,10 @@
+/**
+ * Resultado crudo del vendor de KYC (IDology vía Central Payments). Valores libres a propósito:
+ * los códigos son un conjunto abierto del vendor — la traducción vive en el consumidor.
+ */
+export declare class KycVendorResultDetail {
+    vendor?: string;
+    type?: string;
+    code?: string;
+    description?: string;
+}

package/bin/card/dtos/KycVendorResultDetail.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.KycVendorResultDetail = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Resultado crudo del vendor de KYC (IDology vía Central Payments). Valores libres a propósito:
+ * los códigos son un conjunto abierto del vendor — la traducción vive en el consumidor.
+ */
+class KycVendorResultDetail {
+}
+exports.KycVendorResultDetail = KycVendorResultDetail;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycVendorResultDetail.prototype, "vendor", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycVendorResultDetail.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycVendorResultDetail.prototype, "code", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycVendorResultDetail.prototype, "description", void 0);

package/bin/card/index.d.ts

@@ -37,6 +37,7 @@ export * from './dtos/CardSummaryResponse';
 export * from './dtos/CardAdditionalResponse';
 export * from './dtos/AccountCancelGetResponse';
 export * from './dtos/CardUpdateIssuanceRequest';
+export * from './dtos/KycVendorResultDetail';
 export * from './dtos/AccountIssuanceStepConfig';
 export * from './enums/CardType';
 export * from './enums/CardUpdateKey';

package/bin/card/index.js

@@ -55,6 +55,7 @@ __exportStar(require("./dtos/CardSummaryResponse"), exports);
 __exportStar(require("./dtos/CardAdditionalResponse"), exports);
 __exportStar(require("./dtos/AccountCancelGetResponse"), exports);
 __exportStar(require("./dtos/CardUpdateIssuanceRequest"), exports);
+__exportStar(require("./dtos/KycVendorResultDetail"), exports);
 __exportStar(require("./dtos/AccountIssuanceStepConfig"), exports);
 //enums
 __exportStar(require("./enums/CardType"), exports);

package/bin/loanCredit/dtos/requests/UpdateActivationChecklistRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
+ * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
+ * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
+ */
+export declare class UpdateActivationChecklistRequest {
+    downPayment?: boolean;
+    contractSigned?: boolean;
+    imeiEnrolled?: boolean;
+    lockVerified?: boolean;
+}

package/bin/loanCredit/dtos/requests/UpdateActivationChecklistRequest.js

@@ -0,0 +1,46 @@
+"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.UpdateActivationChecklistRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
+ * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
+ * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
+ */
+class UpdateActivationChecklistRequest {
+}
+exports.UpdateActivationChecklistRequest = UpdateActivationChecklistRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "downPayment", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "contractSigned", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "imeiEnrolled", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateActivationChecklistRequest.prototype, "lockVerified", void 0);

package/bin/loanCredit/enums/ClientLevelEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
+ * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
+ * un CLIENTE nunca es `ALL`.
+ * @enum {string}
+ */
+export declare enum ClientLevelEnum {
+    BRONZE = "BRONZE",
+    SILVER = "SILVER",
+    GOLD = "GOLD"
+}

package/bin/loanCredit/enums/ClientLevelEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientLevelEnum = void 0;
+/**
+ * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
+ * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
+ * un CLIENTE nunca es `ALL`.
+ * @enum {string}
+ */
+var ClientLevelEnum;
+(function (ClientLevelEnum) {
+    ClientLevelEnum["BRONZE"] = "BRONZE";
+    ClientLevelEnum["SILVER"] = "SILVER";
+    ClientLevelEnum["GOLD"] = "GOLD";
+})(ClientLevelEnum || (exports.ClientLevelEnum = ClientLevelEnum = {}));

package/bin/retailWizard/dtos/SaleLogEntry.d.ts

@@ -26,4 +26,17 @@ export interface SaleLogEntry {
     /** Motivo, cuando la acción lo exige (cancelación, excepción aplicada). */
     reason: string | null;
     changes: SaleLogChange[];
+    /**
+     * Datos de la venta que la acción NO cambió y que se guardan para poder leer la entrada sin abrir
+     * otra pantalla (en un `SALE_CANCEL`: el tipo de venta, el monto, el enganche, el crédito).
+     *
+     * Va aparte de `changes` a propósito. Antes viajaba dentro de `new` y `changes` lo pintaba como un
+     * alta: la bitácora afirmaba que en la cancelación el tipo de venta había pasado «de nada a CASH».
+     * En una auditoría un cambio inventado es peor que un dato faltante.
+     *
+     * **El front lo pinta como contexto, NUNCA como «antes → después».** `null` cuando la acción no
+     * mandó contexto. Valores serializados a string igual que `changes`; y como `changes`, NUNCA
+     * lleva PII.
+     */
+    context: Record<string, string | null> | null;
 }

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

@@ -7,20 +7,36 @@
  * 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`).
+ * **Las identidades del contrato** (las tres se cumplen siempre y están cubiertas por tests):
+ *
+ * - `contado` + `credito` + `sinProveedor` == `total`
+ * - `surekeep` + `externas` == `credito`
+ *
+ * `contado`, `credito` y `sinProveedor` particionan `total`; `surekeep` y `externas` particionan
+ * `credito`. Ninguna de las dos particiones se solapa (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`. */
+    /** `type: CASH`. Efectivo de verdad — ver `sinProveedor`. */
     contado: number;
-    /** `type: CREDIT` o `EXTERNAL_REFERRAL` — todo lo que no es contado. */
+    /** Derivadas con financiera CONOCIDA: `type: CREDIT`, o `EXTERNAL_REFERRAL` con proveedor. */
     credito: number;
     /** Financiadas por la SOFOM (`type: CREDIT`). */
     surekeep: number;
     /** Financiadas por un tercero (`EXTERNAL_REFERRAL` con proveedor). */
     externas: number;
+    /**
+     * `type: EXTERNAL_REFERRAL` **sin** `externalProvider` — derivadas cuya financiera no quedó
+     * registrada. Es un DATO ROTO, no una forma de pago.
+     *
+     * Vive en su propia llave y NO en `contado` porque antes caía ahí y la pantalla las leía como
+     * EFECTIVO, que es la lectura más cara de equivocar. Tampoco entra en `credito`: `surekeep` +
+     * `externas` == `credito` y una venta sin financiera no pertenece a ninguna de las dos.
+     * Análisis ya las descartaba de su mix, y por eso Ventas y Análisis contaban distinto el mismo
+     * período. Un valor > 0 es una invitación a ir a corregir esas filas.
+     */
+    sinProveedor: number;
 }

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

@@ -22,6 +22,13 @@ export interface SellerKpiRow {
  *
  * Mismo criterio que A3: el eje es la venta, así que solo aparecen los vendedores que vendieron en
  * la ventana. El roster completo vive en `retail-org-business`.
+ *
+ * ⚠️ **Sin la ★ de encargado de tienda** que pinta el mockup (`es_admin_tienda`). Ese flag es del
+ * padrón (`RetailUser_GT`, de `retail-org-business`), no del snapshot de la venta: la pantalla lo
+ * trae de ahí y lo une por `sellerRetailUserId`.
+ *
+ * ⚠️ Tampoco lleva variación contra la semana pasada — el mockup de Vendedores no la pinta, solo el
+ * de Tiendas (ver `StoreKpiRow.weekOverWeekChangePct`).
  */
 export interface BackofficeSellerKpisResponse {
     items: SellerKpiRow[];

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

@@ -15,6 +15,21 @@ export interface StoreKpiRow {
     averageTicketCents: number | null;
     /** ISO-8601 de la venta más reciente de la tienda en la ventana. `null` si no vendió. */
     lastSaleAt: string | null;
+    /**
+     * Variación porcentual del volumen colocado contra la MISMA ventana corrida 7 días atrás, con un
+     * decimal. Es el chip `+12%` / `-8%` de la pantalla Tiendas.
+     *
+     * `null` en tres casos, todos «no sé» y ninguno «no cambió»:
+     * - la ventana pedida abarca **más de 7 días**, así que el baseline se solaparía con ella y el
+     *   delta compararía un período contra sí mismo (con el default de 90 días, siempre);
+     * - la tienda no vendió nada esa semana — no se divide por cero;
+     * - los números vienen del data lake y no hay fila para esta tienda en el baseline.
+     */
+    weekOverWeekChangePct: number | null;
+    /** Volumen colocado de la ventana de hace 7 días — el denominador del chip, explícito. */
+    baselineSameWeekdayCents: number | null;
+    /** Piezas de esa misma ventana. La pantalla las pinta debajo del chip («N piezas semana pasada»). */
+    baselineSameWeekdayUnits: number | null;
 }
 /**
  * GET /backoffice/stores/kpis — la pantalla Tiendas del Admin VL (A3).
@@ -22,6 +37,18 @@ export interface StoreKpiRow {
  *
  * El eje es la VENTA: solo aparecen las tiendas que vendieron en la ventana. El roster completo
  * (incluidas las que no vendieron) lo tiene `retail-org-business`; la pantalla los cruza.
+ *
+ * ⚠️ **Tres columnas del mockup NO salen de acá y no van a salir**, porque no están en el snapshot
+ * congelado de la venta sino en el padrón:
+ *
+ * | Columna | Dónde vive |
+ * |---|---|
+ * | código de tienda | `Store` — `retail-org-business` |
+ * | tipo propia / subdistribuidor | NO es un campo de `Store`: un subdistribuidor es un *retailer hijo*, así que sale de `GET /retailers/{retailerId}/hierarchy` |
+ * | vendedores activos | `RetailUser_GT` — `retail-org-business` |
+ *
+ * La pantalla las trae de ahí y las une por `storeId`. Devolverlas desde este endpoint obligaría al
+ * silo de ventas a consultar el padrón en cada lectura de tablero.
  */
 export interface BackofficeStoreKpisResponse {
     items: StoreKpiRow[];

package/package.json

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

package/src/card/dtos/CardUpdateIssuanceRequest.ts

@@ -1,7 +1,9 @@
-import { IsEnum, IsOptional, IsString, IsUUID } from "class-validator";
+import { Type } from "class-transformer";
+import { IsArray, IsEnum, IsOptional, IsString, IsUUID, ValidateNested } from "class-validator";
 import { KycStatus } from "../enums/issuance/KycStatus";
 import { UserStatus } from "../enums/issuance/UserStatus";
 import { KycReason } from "../enums/KycReason";
+import { KycVendorResultDetail } from "./KycVendorResultDetail";
 
 
 export class CardUpdateIssuanceRequest {
@@ -22,4 +24,11 @@ export class CardUpdateIssuanceRequest {
     @IsString()
     kycReasons?: KycReason[];
 
+    /** Detalle crudo del vendor de KYC. Solo lo manda la ruta del webhook/connector de CP. */
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => KycVendorResultDetail)
+    kycVendorResults?: KycVendorResultDetail[];
+
 }

package/src/card/dtos/KycVendorResultDetail.ts

@@ -0,0 +1,24 @@
+import { IsOptional, IsString } from "class-validator";
+
+/**
+ * Resultado crudo del vendor de KYC (IDology vía Central Payments). Valores libres a propósito:
+ * los códigos son un conjunto abierto del vendor — la traducción vive en el consumidor.
+ */
+export class KycVendorResultDetail {
+
+    @IsOptional()
+    @IsString()
+    vendor?: string;
+
+    @IsOptional()
+    @IsString()
+    type?: string;
+
+    @IsOptional()
+    @IsString()
+    code?: string;
+
+    @IsOptional()
+    @IsString()
+    description?: string;
+}

package/src/card/index.ts

@@ -41,6 +41,7 @@ export * from './dtos/CardSummaryResponse'
 export * from './dtos/CardAdditionalResponse'
 export * from './dtos/AccountCancelGetResponse'
 export * from './dtos/CardUpdateIssuanceRequest'
+export * from './dtos/KycVendorResultDetail'
 export * from './dtos/AccountIssuanceStepConfig'
 
 //enums

package/src/retailWizard/dtos/SaleLogEntry.ts

@@ -27,4 +27,17 @@ export interface SaleLogEntry {
     /** Motivo, cuando la acción lo exige (cancelación, excepción aplicada). */
     reason: string | null;
     changes: SaleLogChange[];
+    /**
+     * Datos de la venta que la acción NO cambió y que se guardan para poder leer la entrada sin abrir
+     * otra pantalla (en un `SALE_CANCEL`: el tipo de venta, el monto, el enganche, el crédito).
+     *
+     * Va aparte de `changes` a propósito. Antes viajaba dentro de `new` y `changes` lo pintaba como un
+     * alta: la bitácora afirmaba que en la cancelación el tipo de venta había pasado «de nada a CASH».
+     * En una auditoría un cambio inventado es peor que un dato faltante.
+     *
+     * **El front lo pinta como contexto, NUNCA como «antes → después».** `null` cuando la acción no
+     * mandó contexto. Valores serializados a string igual que `changes`; y como `changes`, NUNCA
+     * lleva PII.
+     */
+    context: Record<string, string | null> | null;
 }

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

@@ -7,20 +7,36 @@
  * 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`).
+ * **Las identidades del contrato** (las tres se cumplen siempre y están cubiertas por tests):
+ *
+ * - `contado` + `credito` + `sinProveedor` == `total`
+ * - `surekeep` + `externas` == `credito`
+ *
+ * `contado`, `credito` y `sinProveedor` particionan `total`; `surekeep` y `externas` particionan
+ * `credito`. Ninguna de las dos particiones se solapa (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`. */
+    /** `type: CASH`. Efectivo de verdad — ver `sinProveedor`. */
     contado: number;
-    /** `type: CREDIT` o `EXTERNAL_REFERRAL` — todo lo que no es contado. */
+    /** Derivadas con financiera CONOCIDA: `type: CREDIT`, o `EXTERNAL_REFERRAL` con proveedor. */
     credito: number;
     /** Financiadas por la SOFOM (`type: CREDIT`). */
     surekeep: number;
     /** Financiadas por un tercero (`EXTERNAL_REFERRAL` con proveedor). */
     externas: number;
+    /**
+     * `type: EXTERNAL_REFERRAL` **sin** `externalProvider` — derivadas cuya financiera no quedó
+     * registrada. Es un DATO ROTO, no una forma de pago.
+     *
+     * Vive en su propia llave y NO en `contado` porque antes caía ahí y la pantalla las leía como
+     * EFECTIVO, que es la lectura más cara de equivocar. Tampoco entra en `credito`: `surekeep` +
+     * `externas` == `credito` y una venta sin financiera no pertenece a ninguna de las dos.
+     * Análisis ya las descartaba de su mix, y por eso Ventas y Análisis contaban distinto el mismo
+     * período. Un valor > 0 es una invitación a ir a corregir esas filas.
+     */
+    sinProveedor: number;
 }

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

@@ -23,6 +23,13 @@ export interface SellerKpiRow {
  *
  * Mismo criterio que A3: el eje es la venta, así que solo aparecen los vendedores que vendieron en
  * la ventana. El roster completo vive en `retail-org-business`.
+ *
+ * ⚠️ **Sin la ★ de encargado de tienda** que pinta el mockup (`es_admin_tienda`). Ese flag es del
+ * padrón (`RetailUser_GT`, de `retail-org-business`), no del snapshot de la venta: la pantalla lo
+ * trae de ahí y lo une por `sellerRetailUserId`.
+ *
+ * ⚠️ Tampoco lleva variación contra la semana pasada — el mockup de Vendedores no la pinta, solo el
+ * de Tiendas (ver `StoreKpiRow.weekOverWeekChangePct`).
  */
 export interface BackofficeSellerKpisResponse {
     items: SellerKpiRow[];

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

@@ -15,6 +15,21 @@ export interface StoreKpiRow {
     averageTicketCents: number | null;
     /** ISO-8601 de la venta más reciente de la tienda en la ventana. `null` si no vendió. */
     lastSaleAt: string | null;
+    /**
+     * Variación porcentual del volumen colocado contra la MISMA ventana corrida 7 días atrás, con un
+     * decimal. Es el chip `+12%` / `-8%` de la pantalla Tiendas.
+     *
+     * `null` en tres casos, todos «no sé» y ninguno «no cambió»:
+     * - la ventana pedida abarca **más de 7 días**, así que el baseline se solaparía con ella y el
+     *   delta compararía un período contra sí mismo (con el default de 90 días, siempre);
+     * - la tienda no vendió nada esa semana — no se divide por cero;
+     * - los números vienen del data lake y no hay fila para esta tienda en el baseline.
+     */
+    weekOverWeekChangePct: number | null;
+    /** Volumen colocado de la ventana de hace 7 días — el denominador del chip, explícito. */
+    baselineSameWeekdayCents: number | null;
+    /** Piezas de esa misma ventana. La pantalla las pinta debajo del chip («N piezas semana pasada»). */
+    baselineSameWeekdayUnits: number | null;
 }
 
 /**
@@ -23,6 +38,18 @@ export interface StoreKpiRow {
  *
  * El eje es la VENTA: solo aparecen las tiendas que vendieron en la ventana. El roster completo
  * (incluidas las que no vendieron) lo tiene `retail-org-business`; la pantalla los cruza.
+ *
+ * ⚠️ **Tres columnas del mockup NO salen de acá y no van a salir**, porque no están en el snapshot
+ * congelado de la venta sino en el padrón:
+ *
+ * | Columna | Dónde vive |
+ * |---|---|
+ * | código de tienda | `Store` — `retail-org-business` |
+ * | tipo propia / subdistribuidor | NO es un campo de `Store`: un subdistribuidor es un *retailer hijo*, así que sale de `GET /retailers/{retailerId}/hierarchy` |
+ * | vendedores activos | `RetailUser_GT` — `retail-org-business` |
+ *
+ * La pantalla las trae de ahí y las une por `storeId`. Devolverlas desde este endpoint obligaría al
+ * silo de ventas a consultar el padrón en cada lectura de tablero.
  */
 export interface BackofficeStoreKpisResponse {
     items: StoreKpiRow[];

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