@fiado/type-kit 3.506.0 → 3.508.0

package/_test_/unit/retailWizard/customerTableShapes.test.ts

@@ -0,0 +1,36 @@
+import 'reflect-metadata';
+import { ClientLevelEnum } from '../../../src/loanScoring/enums/ClientLevelEnum';
+import {
+  SellerTableSourceStatusEnum,
+  type BackofficeCustomerTableResponse,
+} from '../../../src/retailWizard';
+
+describe('BackofficeCustomerTableResponse', () => {
+  it('declara las fuentes, el cursor y una fila completa', () => {
+    const response: BackofficeCustomerTableResponse = {
+      from: null,
+      to: '2026-10-07T18:00:00.000Z',
+      nextToken: 'abc',
+      sources: { sales: SellerTableSourceStatusEnum.OK, credit: SellerTableSourceStatusEnum.UNAVAILABLE },
+      items: [
+        {
+          retailCustomerId: 'RC-1',
+          name: 'Ana',
+          phone: null,
+          purchaseCount: 2,
+          totalSpentCents: 300_000,
+          averageTicketCents: 150_000,
+          firstPurchaseAt: '2026-09-01T18:00:00.000Z',
+          lastPurchaseAt: '2026-10-01T18:00:00.000Z',
+          lastStoreName: 'Centro',
+          favoriteStoreId: 'ST-1',
+          favoriteStoreName: 'Centro',
+          skLevel: ClientLevelEnum.GOLD,
+          activeCreditsCount: null,
+        },
+      ],
+    };
+    expect(response.items[0].skLevel).toBe('GOLD');
+    expect(response.sources.credit).toBe('UNAVAILABLE');
+  });
+});

package/_test_/unit/retailWizard/storeTableShapes.test.ts

@@ -0,0 +1,47 @@
+import 'reflect-metadata';
+import { ProductCategoryEnum } from '../../../src/retailCatalog/enums/ProductCategoryEnum';
+import { StoreStatusEnum } from '../../../src/retailOrg/enums/StoreStatusEnum';
+import {
+  SellerTableSourceStatusEnum,
+  StoreKindEnum,
+  type BackofficeStoreDetailResponse,
+  type BackofficeStoreTableResponse,
+} from '../../../src/retailWizard';
+
+describe('BackofficeStoreTableResponse', () => {
+  it('declara las fuentes y una fila completa', () => {
+    const response: BackofficeStoreTableResponse = {
+      from: '2026-09-30T06:00:00.000Z',
+      to: '2026-10-07T05:59:59.999Z',
+      truncated: false,
+      sources: { roster: SellerTableSourceStatusEnum.OK, team: SellerTableSourceStatusEnum.OK, goals: SellerTableSourceStatusEnum.UNAVAILABLE },
+      items: [
+        {
+          storeId: 'ST-1', code: 'CEN', name: 'Centro', zoneId: 'Z-1', zoneName: 'Norte',
+          status: StoreStatusEnum.ACTIVE, kind: null,
+          managerRetailUserId: 'V-1', managerName: 'Karla',
+          teamActiveCount: 3, teamTotalCount: 4,
+          salesCount: 2, placedCents: 200_000, averageTicketCents: 100_000, customersServed: 2,
+          lastSaleAt: '2026-10-05T18:00:00.000Z', weekOverWeekChangePct: 12.5,
+          goalCents: null, networkSharePct: 40, npiM30Pct: null,
+        },
+      ],
+    };
+    expect(response.items[0].status).toBe('ACTIVE');
+    expect(StoreKindEnum.SUBDISTRIBUTOR).toBe('SUBDISTRIBUTOR');
+  });
+});
+
+describe('BackofficeStoreDetailResponse', () => {
+  it('declara la serie semanal y el mix por categoría', () => {
+    const response: BackofficeStoreDetailResponse = {
+      storeId: 'ST-1',
+      from: '2026-09-30T06:00:00.000Z',
+      to: '2026-10-07T05:59:59.999Z',
+      truncated: false,
+      weeklyPlacement: [{ from: '2026-09-30T06:00:00.000Z', to: '2026-10-07T05:59:59.999Z', salesCount: 1, placedCents: 100_000 }],
+      categoryMix: [{ category: ProductCategoryEnum.PHONE, units: 1, placedCents: 100_000 }, { category: null, units: 1, placedCents: 5_000 }],
+    };
+    expect(response.categoryMix[1].category).toBeNull();
+  });
+});

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

@@ -0,0 +1,38 @@
+import type { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
+/** Una fila de la tabla de Clientes: compras en la cadena dentro de la ventana, sin canceladas, más su crédito SK. */
+export interface CustomerTableRow {
+    retailCustomerId: string;
+    name: string | null;
+    phone: string | null;
+    purchaseCount: number;
+    /** Precio de lo comprado (en crédito, el precio del equipo, no el enganche). */
+    totalSpentCents: number;
+    averageTicketCents: number | null;
+    firstPurchaseAt: string;
+    lastPurchaseAt: string;
+    lastStoreName: string | null;
+    /** Tienda con más compras; en empate, la de la compra más reciente. */
+    favoriteStoreId: string | null;
+    favoriteStoreName: string | null;
+    /** `null` sin nivel o con el crédito sin leer. */
+    skLevel: ClientLevelEnum | null;
+    /** `null` con el crédito sin leer. */
+    activeCreditsCount: number | null;
+}
+/** Estado de cada fuente. Con el crédito `UNAVAILABLE` sus campos van en `null`, nunca en `0`. */
+export interface CustomerTableSources {
+    sales: SellerTableSourceStatusEnum.OK;
+    credit: SellerTableSourceStatusEnum;
+}
+/**
+ * `GET /backoffice/customers/table?from&to&limit&nextToken&storeId&sellerId&value` — tabla de Clientes
+ * del Portal Admin VL, paginada por última compra descendente. `from` en `null` es «Todo».
+ */
+export interface BackofficeCustomerTableResponse {
+    from: string | null;
+    to: string;
+    nextToken: string | null;
+    sources: CustomerTableSources;
+    items: CustomerTableRow[];
+}

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

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

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

@@ -0,0 +1,27 @@
+import type { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+/** Colocación de una semana de 7 días; ISO, ambos extremos incluidos. */
+export interface StoreWeeklyPlacement {
+    from: string;
+    to: string;
+    salesCount: number;
+    placedCents: number;
+}
+/** Lo vendido de una categoría en la ventana. `category: null` = venta sin líneas de producto. */
+export interface StoreCategoryMixEntry {
+    category: ProductCategoryEnum | null;
+    units: number;
+    placedCents: number;
+}
+/**
+ * `GET /backoffice/stores/{storeId}/detail?from&to` — el cajón de una tienda: colocación de las 8
+ * semanas que terminan en `to` (de la más vieja a la más nueva) y mix por categoría de `[from, to]`.
+ */
+export interface BackofficeStoreDetailResponse {
+    storeId: string;
+    from: string;
+    to: string;
+    truncated: boolean;
+    weeklyPlacement: StoreWeeklyPlacement[];
+    /** De mayor a menor colocación. */
+    categoryMix: StoreCategoryMixEntry[];
+}

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

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

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

@@ -0,0 +1,55 @@
+import type { StoreStatusEnum } from '../../../retailOrg/enums/StoreStatusEnum';
+import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
+import type { StoreKindEnum } from '../../enums/StoreKindEnum';
+/** Una fila de la tabla de Tiendas: padrón + equipo + ventas de la ventana + meta. */
+export interface StoreTableRow {
+    storeId: string;
+    /** `null` si la tienda vendió pero ya no está en el padrón. */
+    code: string | null;
+    name: string | null;
+    zoneId: string | null;
+    zoneName: string | null;
+    status: StoreStatusEnum | null;
+    /** Propia o subdistribuidor; `null` mientras ninguna fuente lo sepa. */
+    kind: StoreKindEnum | null;
+    managerRetailUserId: string | null;
+    /** `null` sin encargado o con el equipo sin leer. */
+    managerName: string | null;
+    /** Vendedores activos con esa tienda de casa; `null` con el equipo sin leer. */
+    teamActiveCount: number | null;
+    teamTotalCount: number | null;
+    /** Sin ventas en la ventana viaja `0`: el barrido es exhaustivo. */
+    salesCount: number;
+    placedCents: number;
+    averageTicketCents: number | null;
+    /** Clientes distintos que compraron en la ventana. */
+    customersServed: number | null;
+    lastSaleAt: string | null;
+    /** Δ % contra la misma ventana 7 días antes; `null` si la ventana pasa de 7 días o no hubo base. */
+    weekOverWeekChangePct: number | null;
+    /** Meta mensual de la tienda escalada a los días de la ventana; `null` sin meta, con metas caídas o ventana > 90 días. */
+    goalCents: number | null;
+    /** % de la colocación de la cadena en la ventana, a un decimal; `null` si la cadena no colocó. */
+    networkSharePct: number | null;
+    /** NPI M30: no lo calcula ningún lambda todavía. Siempre `null`. */
+    npiM30Pct: null;
+}
+/** Estado de cada fuente. Una fuente `UNAVAILABLE` deja sus campos en `null`, nunca en `0`. */
+export interface StoreTableSources {
+    roster: SellerTableSourceStatusEnum;
+    /** Vendedores de la cadena: equipo y nombre del encargado. */
+    team: SellerTableSourceStatusEnum;
+    goals: SellerTableSourceStatusEnum;
+}
+/**
+ * `GET /backoffice/stores/table?from&to&value` — la tabla completa de Tiendas del Portal Admin VL,
+ * sin paginación. Incluye las tiendas del padrón sin ventas y las inactivas.
+ */
+export interface BackofficeStoreTableResponse {
+    from: string;
+    to: string;
+    /** Las ventas de la ventana pasaron el tope de lectura: los números están recortados. */
+    truncated: boolean;
+    sources: StoreTableSources;
+    items: StoreTableRow[];
+}

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

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

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

@@ -0,0 +1,5 @@
+/** Si la tienda es propia de la cadena o de un subdistribuidor. */
+export declare enum StoreKindEnum {
+    OWN = "OWN",
+    SUBDISTRIBUTOR = "SUBDISTRIBUTOR"
+}

package/bin/retailWizard/enums/StoreKindEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreKindEnum = void 0;
+/** Si la tienda es propia de la cadena o de un subdistribuidor. */
+var StoreKindEnum;
+(function (StoreKindEnum) {
+    StoreKindEnum["OWN"] = "OWN";
+    StoreKindEnum["SUBDISTRIBUTOR"] = "SUBDISTRIBUTOR";
+})(StoreKindEnum || (exports.StoreKindEnum = StoreKindEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -137,6 +137,10 @@ export * from './dtos/responses/BackofficeStoreKpisResponse';
 export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
+export * from './dtos/responses/BackofficeCustomerTableResponse';
+export * from './enums/StoreKindEnum';
+export * from './dtos/responses/BackofficeStoreTableResponse';
+export * from './dtos/responses/BackofficeStoreDetailResponse';
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';

package/bin/retailWizard/index.js

@@ -170,6 +170,10 @@ __exportStar(require("./dtos/responses/BackofficeStoreKpisResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeSellerKpisResponse"), exports);
 __exportStar(require("./enums/SellerTableSourceStatusEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeSellerTableResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeCustomerTableResponse"), exports);
+__exportStar(require("./enums/StoreKindEnum"), exports);
+__exportStar(require("./dtos/responses/BackofficeStoreTableResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeStoreDetailResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/SaleCompletedV1"), exports);
 __exportStar(require("./events/SaleCancelledV1"), exports);

package/package.json

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

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

@@ -0,0 +1,41 @@
+import type { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
+
+/** Una fila de la tabla de Clientes: compras en la cadena dentro de la ventana, sin canceladas, más su crédito SK. */
+export interface CustomerTableRow {
+    retailCustomerId: string;
+    name: string | null;
+    phone: string | null;
+    purchaseCount: number;
+    /** Precio de lo comprado (en crédito, el precio del equipo, no el enganche). */
+    totalSpentCents: number;
+    averageTicketCents: number | null;
+    firstPurchaseAt: string;
+    lastPurchaseAt: string;
+    lastStoreName: string | null;
+    /** Tienda con más compras; en empate, la de la compra más reciente. */
+    favoriteStoreId: string | null;
+    favoriteStoreName: string | null;
+    /** `null` sin nivel o con el crédito sin leer. */
+    skLevel: ClientLevelEnum | null;
+    /** `null` con el crédito sin leer. */
+    activeCreditsCount: number | null;
+}
+
+/** Estado de cada fuente. Con el crédito `UNAVAILABLE` sus campos van en `null`, nunca en `0`. */
+export interface CustomerTableSources {
+    sales: SellerTableSourceStatusEnum.OK;
+    credit: SellerTableSourceStatusEnum;
+}
+
+/**
+ * `GET /backoffice/customers/table?from&to&limit&nextToken&storeId&sellerId&value` — tabla de Clientes
+ * del Portal Admin VL, paginada por última compra descendente. `from` en `null` es «Todo».
+ */
+export interface BackofficeCustomerTableResponse {
+    from: string | null;
+    to: string;
+    nextToken: string | null;
+    sources: CustomerTableSources;
+    items: CustomerTableRow[];
+}

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

@@ -0,0 +1,30 @@
+import type { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+
+/** Colocación de una semana de 7 días; ISO, ambos extremos incluidos. */
+export interface StoreWeeklyPlacement {
+    from: string;
+    to: string;
+    salesCount: number;
+    placedCents: number;
+}
+
+/** Lo vendido de una categoría en la ventana. `category: null` = venta sin líneas de producto. */
+export interface StoreCategoryMixEntry {
+    category: ProductCategoryEnum | null;
+    units: number;
+    placedCents: number;
+}
+
+/**
+ * `GET /backoffice/stores/{storeId}/detail?from&to` — el cajón de una tienda: colocación de las 8
+ * semanas que terminan en `to` (de la más vieja a la más nueva) y mix por categoría de `[from, to]`.
+ */
+export interface BackofficeStoreDetailResponse {
+    storeId: string;
+    from: string;
+    to: string;
+    truncated: boolean;
+    weeklyPlacement: StoreWeeklyPlacement[];
+    /** De mayor a menor colocación. */
+    categoryMix: StoreCategoryMixEntry[];
+}

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

@@ -0,0 +1,58 @@
+import type { StoreStatusEnum } from '../../../retailOrg/enums/StoreStatusEnum';
+import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
+import type { StoreKindEnum } from '../../enums/StoreKindEnum';
+
+/** Una fila de la tabla de Tiendas: padrón + equipo + ventas de la ventana + meta. */
+export interface StoreTableRow {
+    storeId: string;
+    /** `null` si la tienda vendió pero ya no está en el padrón. */
+    code: string | null;
+    name: string | null;
+    zoneId: string | null;
+    zoneName: string | null;
+    status: StoreStatusEnum | null;
+    /** Propia o subdistribuidor; `null` mientras ninguna fuente lo sepa. */
+    kind: StoreKindEnum | null;
+    managerRetailUserId: string | null;
+    /** `null` sin encargado o con el equipo sin leer. */
+    managerName: string | null;
+    /** Vendedores activos con esa tienda de casa; `null` con el equipo sin leer. */
+    teamActiveCount: number | null;
+    teamTotalCount: number | null;
+    /** Sin ventas en la ventana viaja `0`: el barrido es exhaustivo. */
+    salesCount: number;
+    placedCents: number;
+    averageTicketCents: number | null;
+    /** Clientes distintos que compraron en la ventana. */
+    customersServed: number | null;
+    lastSaleAt: string | null;
+    /** Δ % contra la misma ventana 7 días antes; `null` si la ventana pasa de 7 días o no hubo base. */
+    weekOverWeekChangePct: number | null;
+    /** Meta mensual de la tienda escalada a los días de la ventana; `null` sin meta, con metas caídas o ventana > 90 días. */
+    goalCents: number | null;
+    /** % de la colocación de la cadena en la ventana, a un decimal; `null` si la cadena no colocó. */
+    networkSharePct: number | null;
+    /** NPI M30: no lo calcula ningún lambda todavía. Siempre `null`. */
+    npiM30Pct: null;
+}
+
+/** Estado de cada fuente. Una fuente `UNAVAILABLE` deja sus campos en `null`, nunca en `0`. */
+export interface StoreTableSources {
+    roster: SellerTableSourceStatusEnum;
+    /** Vendedores de la cadena: equipo y nombre del encargado. */
+    team: SellerTableSourceStatusEnum;
+    goals: SellerTableSourceStatusEnum;
+}
+
+/**
+ * `GET /backoffice/stores/table?from&to&value` — la tabla completa de Tiendas del Portal Admin VL,
+ * sin paginación. Incluye las tiendas del padrón sin ventas y las inactivas.
+ */
+export interface BackofficeStoreTableResponse {
+    from: string;
+    to: string;
+    /** Las ventas de la ventana pasaron el tope de lectura: los números están recortados. */
+    truncated: boolean;
+    sources: StoreTableSources;
+    items: StoreTableRow[];
+}

package/src/retailWizard/enums/StoreKindEnum.ts

@@ -0,0 +1,5 @@
+/** Si la tienda es propia de la cadena o de un subdistribuidor. */
+export enum StoreKindEnum {
+    OWN = 'OWN',
+    SUBDISTRIBUTOR = 'SUBDISTRIBUTOR',
+}

package/src/retailWizard/index.ts

@@ -162,6 +162,10 @@ export * from './dtos/responses/BackofficeStoreKpisResponse';
 export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
+export * from './dtos/responses/BackofficeCustomerTableResponse';
+export * from './enums/StoreKindEnum';
+export * from './dtos/responses/BackofficeStoreTableResponse';
+export * from './dtos/responses/BackofficeStoreDetailResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/SaleCompletedV1';