@fiado/type-kit 3.506.0 → 3.507.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/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/index.d.ts

@@ -137,6 +137,7 @@ 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 './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';

package/bin/retailWizard/index.js

@@ -170,6 +170,7 @@ __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);
 // 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.507.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/index.ts

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