@fiado/type-kit 3.265.0 → 3.266.0

package/bin/loanConfig/enums/ModifiableByRoleEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+export declare enum ModifiableByRoleEnum {
+    SUPER_ADMIN = "super_admin",
+    SOFOM_ADMIN = "sofom_admin",
+    RETAILER_ADMIN = "retailer_admin"
+}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifiableByRoleEnum = void 0;
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+var ModifiableByRoleEnum;
+(function (ModifiableByRoleEnum) {
+    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
+    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
+    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
+})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

package/bin/places/dtos/CashInFeeDto.d.ts

@@ -0,0 +1,17 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+export declare class CashInFeeDto {
+    /** Comisión fija, en la moneda del país. */
+    fixed?: number;
+    /** Porcentaje del monto depositado (0–100). */
+    percentage?: number;
+    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
+    cap?: number;
+    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
+    currency: CurrencyId;
+}

package/bin/places/dtos/CashInFeeDto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CashInFeeDto = void 0;
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+class CashInFeeDto {
+}
+exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -0,0 +1,22 @@
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+export declare class ResendOtpRequest {
+    email: string;
+    tenantId: string;
+}
+/**
+ * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
+ * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
+ * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
+ * el server responde 200 genérico sin session ni método.
+ */
+export interface ResendOtpResponse {
+    session?: string;
+    mfaMethod?: MfaMethodEnum;
+}

package/bin/{walletFunding/dtos/CancelFundingRequest.js → platformRbac/dtos/ResendOtpRequest.js}

@@ -9,25 +9,28 @@ 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.CancelFundingRequest = void 0;
+exports.ResendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * Request del cancel via Centro de Beneficios (spec 13 v2.0).
- * `reference` viaja en el path, `directoryId` se resuelve del JWT.
- * `providerModuleName` permite al marketplace rutear al publisher correcto
- * sin tener que persistir el mapping (el wallet-app sabe el moduleName
- * porque vino en la respuesta del authorize).
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
  */
-class CancelFundingRequest {
+class ResendOtpRequest {
 }
-exports.CancelFundingRequest = CancelFundingRequest;
+exports.ResendOtpRequest = ResendOtpRequest;
 __decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CancelFundingRequest.prototype, "idempotencyKey", void 0);
+], ResendOtpRequest.prototype, "email", void 0);
 __decorate([
+    (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(128),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CancelFundingRequest.prototype, "providerModuleName", void 0);
+], ResendOtpRequest.prototype, "tenantId", void 0);

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+export declare class ResendSelfRegisterOtpRequest {
+    tenantId: string;
+    email: string;
+}

package/bin/{walletFunding/dtos/CancelFundingReferenceRequest.js → platformRbac/dtos/ResendSelfRegisterOtpRequest.js}

@@ -9,23 +9,28 @@ 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.CancelFundingReferenceRequest = void 0;
+exports.ResendSelfRegisterOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-class CancelFundingReferenceRequest {
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+class ResendSelfRegisterOtpRequest {
 }
-exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
 __decorate([
+    (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "reference", void 0);
+], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
 __decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

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

@@ -0,0 +1,36 @@
+/**
+ * Una fila de la lista **Clientes VL** del Portal Admin VentasLuga (A1).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Sale del ítem de estadísticas de por vida (`RETAILER#<retailerId>` / `CUSTSTATS#<customerId>`
+ * dentro de `RetailSale_GT`), no de barrer ventas: por eso los totales son **de por vida** y no del
+ * periodo filtrado. Ver D19 / DEC-040.
+ *
+ * ⚠️ `customerName` y `customerPhone` son PII. Nunca loguear. La lectura queda registrada en
+ * `PiiAccessLog` igual que el listado de ventas.
+ */
+export interface RetailCustomerListItem {
+    retailCustomerId: string;
+    /** Congelado en la venta. `null` si nunca se pudo resolver. */
+    customerName: string | null;
+    customerPhone: string | null;
+    /** Compras DE POR VIDA. Puede venir negativo si hubo cancelaciones antes del backfill. */
+    salesCount: number;
+    /** Gastado DE POR VIDA, en centavos. Mide volumen COLOCADO (precio del equipo), no lo cobrado. */
+    totalSpentCents: number;
+    /** ISO-8601 de la primera compra. `null` mientras el backfill no lo haya sembrado. */
+    firstSaleAt: string | null;
+    /** ISO-8601 de la última compra. Es el campo por el que filtra la pantalla. */
+    lastSaleAt: string | null;
+    /**
+     * Tienda y vendedor de la ÚLTIMA compra.
+     *
+     * ⚠️ El mockup los llama «tienda favorita» y «vendedor recurrente», que serían la MODA. Acá es el
+     * ÚLTIMO: la moda exigiría un contador por (cliente × tienda), que multiplica el ítem por cada
+     * tienda donde el cliente compró. Se sirve el último y se declara. Ver `TD-F3-WIZ-MODA`.
+     */
+    lastStoreId: string | null;
+    lastStoreName: string | null;
+    lastSellerId: string | null;
+    lastSellerName: string | null;
+}

package/bin/retailWizard/dtos/RetailCustomerListItem.js

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

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

@@ -0,0 +1,20 @@
+import type { Sale } from '../Sale';
+/**
+ * GET /backoffice/customers/{id}/purchases — el historial de compras de un cliente (A2).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Lee `RetailSale_GT` por `customerId-soldAt-index`, así que viene ordenado por fecha y pagina por
+ * cursor: un cliente puede tener muchas compras y la ficha las muestra de a poco.
+ *
+ * `compras30` / `compras90` se cuentan sobre la MISMA lectura cuando la ventana entra en la página;
+ * son los contadores que la pantalla muestra como sublínea del total de por vida.
+ */
+export interface BackofficeCustomerPurchasesResponse {
+    items: Sale[];
+    count: number;
+    nextToken?: string;
+    /** Compras en los últimos 30 días. */
+    last30Count: number;
+    /** Compras en los últimos 90 días — el que define el segmento `inactivo` (=== 0). */
+    last90Count: number;
+}

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

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

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

@@ -0,0 +1,14 @@
+import type { RetailCustomerListItem } from '../RetailCustomerListItem';
+/**
+ * GET /backoffice/customers — la lista de Clientes VL (A1). SureKeep Fase 3 — pista Retail.
+ *
+ * NO pagina por cursor: una Query trae todos los clientes de la cadena (una fila por CLIENTE, ~200 B,
+ * no una por venta) y la pantalla ordena y filtra sobre el conjunto. `truncated` avisa cuando la
+ * cadena excede el tope de lectura — un listado recortado servido en silencio se lee como completo.
+ */
+export interface BackofficeCustomersResponse {
+    items: RetailCustomerListItem[];
+    count: number;
+    /** `true` si se alcanzó el tope de lectura y la lista NO está completa. */
+    truncated: boolean;
+}

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

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

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

@@ -0,0 +1,27 @@
+/** KPIs de un vendedor en la ventana consultada. */
+export interface SellerKpiRow {
+    sellerRetailUserId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    sellerName: string | null;
+    storeId: string | null;
+    storeName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    lastSaleAt: string | null;
+}
+/**
+ * GET /backoffice/sellers/kpis — la pantalla Vendedores del Admin VL (A4).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * 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`.
+ */
+export interface BackofficeSellerKpisResponse {
+    items: SellerKpiRow[];
+    count: number;
+    from: string;
+    to: string | null;
+    truncated: boolean;
+}

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

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

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

@@ -0,0 +1,29 @@
+/** KPIs de una tienda en la ventana consultada. */
+export interface StoreKpiRow {
+    storeId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    storeName: string | null;
+    zoneName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    /** ISO-8601 de la venta más reciente de la tienda en la ventana. `null` si no vendió. */
+    lastSaleAt: string | null;
+}
+/**
+ * GET /backoffice/stores/kpis — la pantalla Tiendas del Admin VL (A3).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * 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.
+ */
+export interface BackofficeStoreKpisResponse {
+    items: StoreKpiRow[];
+    count: number;
+    /** ISO-8601 de la ventana efectivamente agregada. */
+    from: string;
+    to: string | null;
+    /** `true` si se alcanzó el tope de agregación y los números están TRUNCADOS. */
+    truncated: boolean;
+}

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

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

package/bin/retailWizard/index.d.ts

@@ -90,6 +90,11 @@ export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';
+export * from './dtos/RetailCustomerListItem';
+export * from './dtos/responses/BackofficeCustomersResponse';
+export * from './dtos/responses/BackofficeCustomerPurchasesResponse';
+export * from './dtos/responses/BackofficeStoreKpisResponse';
+export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';

package/bin/retailWizard/index.js

@@ -118,6 +118,12 @@ __exportStar(require("./dtos/requests/BackofficeCancelSaleRequest"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesStatsResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesKpisResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeReportsResponse"), exports);
+// A1-A4 · agregados del portal (D17)
+__exportStar(require("./dtos/RetailCustomerListItem"), exports);
+__exportStar(require("./dtos/responses/BackofficeCustomersResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeCustomerPurchasesResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeStoreKpisResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeSellerKpisResponse"), 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.265.0",
+  "version": "3.266.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/retailWizard/dtos/RetailCustomerListItem.ts

@@ -0,0 +1,36 @@
+/**
+ * Una fila de la lista **Clientes VL** del Portal Admin VentasLuga (A1).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Sale del ítem de estadísticas de por vida (`RETAILER#<retailerId>` / `CUSTSTATS#<customerId>`
+ * dentro de `RetailSale_GT`), no de barrer ventas: por eso los totales son **de por vida** y no del
+ * periodo filtrado. Ver D19 / DEC-040.
+ *
+ * ⚠️ `customerName` y `customerPhone` son PII. Nunca loguear. La lectura queda registrada en
+ * `PiiAccessLog` igual que el listado de ventas.
+ */
+export interface RetailCustomerListItem {
+    retailCustomerId: string;
+    /** Congelado en la venta. `null` si nunca se pudo resolver. */
+    customerName: string | null;
+    customerPhone: string | null;
+    /** Compras DE POR VIDA. Puede venir negativo si hubo cancelaciones antes del backfill. */
+    salesCount: number;
+    /** Gastado DE POR VIDA, en centavos. Mide volumen COLOCADO (precio del equipo), no lo cobrado. */
+    totalSpentCents: number;
+    /** ISO-8601 de la primera compra. `null` mientras el backfill no lo haya sembrado. */
+    firstSaleAt: string | null;
+    /** ISO-8601 de la última compra. Es el campo por el que filtra la pantalla. */
+    lastSaleAt: string | null;
+    /**
+     * Tienda y vendedor de la ÚLTIMA compra.
+     *
+     * ⚠️ El mockup los llama «tienda favorita» y «vendedor recurrente», que serían la MODA. Acá es el
+     * ÚLTIMO: la moda exigiría un contador por (cliente × tienda), que multiplica el ítem por cada
+     * tienda donde el cliente compró. Se sirve el último y se declara. Ver `TD-F3-WIZ-MODA`.
+     */
+    lastStoreId: string | null;
+    lastStoreName: string | null;
+    lastSellerId: string | null;
+    lastSellerName: string | null;
+}

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

@@ -0,0 +1,21 @@
+import type { Sale } from '../Sale';
+
+/**
+ * GET /backoffice/customers/{id}/purchases — el historial de compras de un cliente (A2).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Lee `RetailSale_GT` por `customerId-soldAt-index`, así que viene ordenado por fecha y pagina por
+ * cursor: un cliente puede tener muchas compras y la ficha las muestra de a poco.
+ *
+ * `compras30` / `compras90` se cuentan sobre la MISMA lectura cuando la ventana entra en la página;
+ * son los contadores que la pantalla muestra como sublínea del total de por vida.
+ */
+export interface BackofficeCustomerPurchasesResponse {
+    items: Sale[];
+    count: number;
+    nextToken?: string;
+    /** Compras en los últimos 30 días. */
+    last30Count: number;
+    /** Compras en los últimos 90 días — el que define el segmento `inactivo` (=== 0). */
+    last90Count: number;
+}

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

@@ -0,0 +1,15 @@
+import type { RetailCustomerListItem } from '../RetailCustomerListItem';
+
+/**
+ * GET /backoffice/customers — la lista de Clientes VL (A1). SureKeep Fase 3 — pista Retail.
+ *
+ * NO pagina por cursor: una Query trae todos los clientes de la cadena (una fila por CLIENTE, ~200 B,
+ * no una por venta) y la pantalla ordena y filtra sobre el conjunto. `truncated` avisa cuando la
+ * cadena excede el tope de lectura — un listado recortado servido en silencio se lee como completo.
+ */
+export interface BackofficeCustomersResponse {
+    items: RetailCustomerListItem[];
+    count: number;
+    /** `true` si se alcanzó el tope de lectura y la lista NO está completa. */
+    truncated: boolean;
+}

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

@@ -0,0 +1,28 @@
+/** KPIs de un vendedor en la ventana consultada. */
+export interface SellerKpiRow {
+    sellerRetailUserId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    sellerName: string | null;
+    storeId: string | null;
+    storeName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    lastSaleAt: string | null;
+}
+
+/**
+ * GET /backoffice/sellers/kpis — la pantalla Vendedores del Admin VL (A4).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * 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`.
+ */
+export interface BackofficeSellerKpisResponse {
+    items: SellerKpiRow[];
+    count: number;
+    from: string;
+    to: string | null;
+    truncated: boolean;
+}

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

@@ -0,0 +1,30 @@
+/** KPIs de una tienda en la ventana consultada. */
+export interface StoreKpiRow {
+    storeId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    storeName: string | null;
+    zoneName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    /** ISO-8601 de la venta más reciente de la tienda en la ventana. `null` si no vendió. */
+    lastSaleAt: string | null;
+}
+
+/**
+ * GET /backoffice/stores/kpis — la pantalla Tiendas del Admin VL (A3).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * 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.
+ */
+export interface BackofficeStoreKpisResponse {
+    items: StoreKpiRow[];
+    count: number;
+    /** ISO-8601 de la ventana efectivamente agregada. */
+    from: string;
+    to: string | null;
+    /** `true` si se alcanzó el tope de agregación y los números están TRUNCADOS. */
+    truncated: boolean;
+}

package/src/retailWizard/index.ts

@@ -112,6 +112,12 @@ export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';
+// A1-A4 · agregados del portal (D17)
+export * from './dtos/RetailCustomerListItem';
+export * from './dtos/responses/BackofficeCustomersResponse';
+export * from './dtos/responses/BackofficeCustomerPurchasesResponse';
+export * from './dtos/responses/BackofficeStoreKpisResponse';
+export * from './dtos/responses/BackofficeSellerKpisResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/SaleCompletedV1';

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

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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1,46 +0,0 @@
-"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

@@ -1,11 +0,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}
- */
-export declare enum ClientLevelEnum {
-    BRONZE = "BRONZE",
-    SILVER = "SILVER",
-    GOLD = "GOLD"
-}

package/bin/loanCredit/enums/ClientLevelEnum.js

@@ -1,15 +0,0 @@
-"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/walletFunding/dtos/CancelFundingReferenceRequest.d.ts

@@ -1,6 +0,0 @@
-export declare class CancelFundingReferenceRequest {
-    /** Referencia Passport (PK de EqualityFundingReference_GT). */
-    reference: string;
-    directoryId: string;
-    idempotencyKey: string;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts

@@ -1,7 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-export declare class CancelFundingReferenceResponse {
-    reference: string;
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelFundingReferenceResponse = void 0;
-class CancelFundingReferenceResponse {
-}
-exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

package/bin/walletFunding/dtos/CancelFundingRequest.d.ts

@@ -1,11 +0,0 @@
-/**
- * Request del cancel via Centro de Beneficios (spec 13 v2.0).
- * `reference` viaja en el path, `directoryId` se resuelve del JWT.
- * `providerModuleName` permite al marketplace rutear al publisher correcto
- * sin tener que persistir el mapping (el wallet-app sabe el moduleName
- * porque vino en la respuesta del authorize).
- */
-export declare class CancelFundingRequest {
-    idempotencyKey: string;
-    providerModuleName: string;
-}

package/bin/walletFunding/dtos/CancelFundingResponse.d.ts

@@ -1,14 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-/**
- * Response del cancel via Centro de Beneficios (spec 13 v2.0).
- * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
- * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
- * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
- */
-export declare class CancelFundingResponse {
-    reference: string;
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-    message?: string;
-}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelFundingResponse = void 0;
-/**
- * Response del cancel via Centro de Beneficios (spec 13 v2.0).
- * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
- * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
- * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
- */
-class CancelFundingResponse {
-}
-exports.CancelFundingResponse = CancelFundingResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -1,3 +0,0 @@
-export declare class CancelWalletFundingRequest {
-    idempotencyKey: string;
-}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -1,21 +0,0 @@
-"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.CancelWalletFundingRequest = void 0;
-const class_validator_1 = require("class-validator");
-class CancelWalletFundingRequest {
-}
-exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -1,7 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-export declare class CancelWalletFundingResponse {
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-    reference?: string;
-}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelWalletFundingResponse = void 0;
-class CancelWalletFundingResponse {
-}
-exports.CancelWalletFundingResponse = CancelWalletFundingResponse;