@fiado/type-kit 3.577.0 → 3.578.0

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

@@ -12,9 +12,12 @@ describe('BackofficeCustomerTableResponse', () => {
       to: '2026-10-07T18:00:00.000Z',
       nextToken: 'abc',
       sources: { sales: SellerTableSourceStatusEnum.OK, credit: SellerTableSourceStatusEnum.UNAVAILABLE },
+      counts: { withSales: 1, accountOnly: 1 },
       items: [
         {
           retailCustomerId: 'RC-1',
+          accountOnly: false,
+          originStoreId: 'ST-1',
           name: 'Ana',
           phone: null,
           purchaseCount: 2,
@@ -28,9 +31,28 @@ describe('BackofficeCustomerTableResponse', () => {
           skLevel: ClientLevelEnum.GOLD,
           activeCreditsCount: null,
         },
+        {
+          retailCustomerId: 'RC-2',
+          accountOnly: true,
+          originStoreId: 'ST-1',
+          name: 'Luz',
+          phone: null,
+          purchaseCount: 0,
+          totalSpentCents: 0,
+          averageTicketCents: null,
+          firstPurchaseAt: null,
+          lastPurchaseAt: null,
+          lastStoreName: null,
+          favoriteStoreId: null,
+          favoriteStoreName: null,
+          skLevel: null,
+          activeCreditsCount: null,
+        },
       ],
     };
     expect(response.items[0].skLevel).toBe('GOLD');
     expect(response.sources.credit).toBe('UNAVAILABLE');
+    expect(response.items[1].accountOnly).toBe(true);
+    expect(response.counts.accountOnly).toBe(1);
   });
 });

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.d.ts

@@ -10,6 +10,8 @@ import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
 export declare class UpsertCustomerFromKycRequest {
     /** Tienda de alta/origen — del JWT del vendedor dueño de la sesión del wizard (F1 §3.5). */
     originStoreId: string;
+    /** Cadena de la tienda de alta; el wizard la manda desde la sesión. */
+    retailerId?: string;
     /** Nombre partido por convención Fiado (F1 §3.5) — lo entrega el OCR del INE, NO se deriva de un string. */
     names: string;
     paternalLastName: string;

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.js

@@ -30,6 +30,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], UpsertCustomerFromKycRequest.prototype, "originStoreId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "retailerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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

@@ -1,16 +1,23 @@
 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. */
+/**
+ * Una fila de la tabla de Clientes: un cliente del padrón de la cadena con sus compras en la ventana
+ * (sin canceladas) y su crédito SK. `accountOnly` = abrió cuenta y no tiene ninguna compra en la cadena.
+ */
 export interface CustomerTableRow {
     retailCustomerId: string;
+    accountOnly: boolean;
+    /** Tienda donde se dio de alta; `null` si el padrón no la tiene. */
+    originStoreId: string | null;
     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;
+    /** `null` en un cliente «solo cuenta». */
+    firstPurchaseAt: string | null;
+    lastPurchaseAt: string | null;
     lastStoreName: string | null;
     /** Tienda con más compras; en empate, la de la compra más reciente. */
     favoriteStoreId: string | null;
@@ -25,14 +32,20 @@ export interface CustomerTableSources {
     sales: SellerTableSourceStatusEnum.OK;
     credit: SellerTableSourceStatusEnum;
 }
+/** Clientes del padrón leídos en la página, antes del filtro `customerType`; el front los suma por página. */
+export interface CustomerTableCounts {
+    withSales: number;
+    accountOnly: number;
+}
 /**
- * `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».
+ * `GET /backoffice/customers/table?from&to&limit&nextToken&storeId&sellerId&customerType&value` — tabla
+ * de Clientes del Portal Admin VL, paginada sobre el padrón por alta descendente. `from` en `null` es «Todo».
  */
 export interface BackofficeCustomerTableResponse {
     from: string | null;
     to: string;
     nextToken: string | null;
     sources: CustomerTableSources;
+    counts: CustomerTableCounts;
     items: CustomerTableRow[];
 }

package/package.json

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

package/src/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.ts

@@ -27,6 +27,12 @@ export class UpsertCustomerFromKycRequest {
     @IsString()
     originStoreId!: string;
 
+    /** Cadena de la tienda de alta; el wizard la manda desde la sesión. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    retailerId?: string;
+
     /** Nombre partido por convención Fiado (F1 §3.5) — lo entrega el OCR del INE, NO se deriva de un string. */
     @Expose()
     @IsString()

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

@@ -1,17 +1,24 @@
 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. */
+/**
+ * Una fila de la tabla de Clientes: un cliente del padrón de la cadena con sus compras en la ventana
+ * (sin canceladas) y su crédito SK. `accountOnly` = abrió cuenta y no tiene ninguna compra en la cadena.
+ */
 export interface CustomerTableRow {
     retailCustomerId: string;
+    accountOnly: boolean;
+    /** Tienda donde se dio de alta; `null` si el padrón no la tiene. */
+    originStoreId: string | null;
     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;
+    /** `null` en un cliente «solo cuenta». */
+    firstPurchaseAt: string | null;
+    lastPurchaseAt: string | null;
     lastStoreName: string | null;
     /** Tienda con más compras; en empate, la de la compra más reciente. */
     favoriteStoreId: string | null;
@@ -28,14 +35,21 @@ export interface CustomerTableSources {
     credit: SellerTableSourceStatusEnum;
 }
 
+/** Clientes del padrón leídos en la página, antes del filtro `customerType`; el front los suma por página. */
+export interface CustomerTableCounts {
+    withSales: number;
+    accountOnly: number;
+}
+
 /**
- * `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».
+ * `GET /backoffice/customers/table?from&to&limit&nextToken&storeId&sellerId&customerType&value` — tabla
+ * de Clientes del Portal Admin VL, paginada sobre el padrón por alta descendente. `from` en `null` es «Todo».
  */
 export interface BackofficeCustomerTableResponse {
     from: string | null;
     to: string;
     nextToken: string | null;
     sources: CustomerTableSources;
+    counts: CustomerTableCounts;
     items: CustomerTableRow[];
 }