@fiado/type-kit 3.507.0 → 3.509.0

package/_test_/unit/platformRbac/dtos/roleAssignmentsByScopeRefsDtos.test.ts

@@ -0,0 +1,49 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    PermissionScope,
+    RoleAssignmentsByScopeRefsRequest,
+    ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH,
+    ScopeRefLookupStatusEnum,
+} from '../../../../src/platformRbac';
+import type { RoleAssignmentsByScopeRefsResponse } from '../../../../src/platformRbac';
+
+describe('RoleAssignmentsByScopeRefsRequest', () => {
+    it('el tope del lote es 100', () => {
+        expect(ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH).toBe(100);
+    });
+
+    it('acepta una lista de scopeRefs y la vacía', async () => {
+        expect(await validate(plainToInstance(RoleAssignmentsByScopeRefsRequest, { scopeRefs: ['st-1'] }))).toEqual([]);
+        expect(await validate(plainToInstance(RoleAssignmentsByScopeRefsRequest, { scopeRefs: [] }))).toEqual([]);
+    });
+
+    it('rechaza 101 scopeRefs con arrayMaxSize', async () => {
+        const scopeRefs = Array.from({ length: 101 }, (_, i) => `st-${i}`);
+        const errors = await validate(plainToInstance(RoleAssignmentsByScopeRefsRequest, { scopeRefs }));
+        expect(errors[0].constraints?.arrayMaxSize).toBeDefined();
+    });
+
+    it('rechaza elementos que no son string', async () => {
+        const errors = await validate(plainToInstance(RoleAssignmentsByScopeRefsRequest, { scopeRefs: [7] }));
+        expect(errors[0].constraints?.isString).toBeDefined();
+    });
+});
+
+describe('RoleAssignmentsByScopeRefsResponse', () => {
+    it('lleva un item por scopeRef con su estado y asignaciones', () => {
+        const response: RoleAssignmentsByScopeRefsResponse = {
+            items: [
+                {
+                    scopeRef: 'st-1',
+                    status: ScopeRefLookupStatusEnum.OK,
+                    assignments: [{ cognitoSub: 'sub-1', roleId: 'store_manager', roleName: 'Encargado', scope: PermissionScope.LEVEL_3 }],
+                },
+                { scopeRef: 'st-2', status: ScopeRefLookupStatusEnum.UNAVAILABLE, assignments: [] },
+            ],
+        };
+        expect(Object.values(ScopeRefLookupStatusEnum)).toEqual(['OK', 'UNAVAILABLE']);
+        expect(response.items).toHaveLength(2);
+    });
+});

package/_test_/unit/retailOrg/dtos/sellerTableSources.test.ts

@@ -60,3 +60,20 @@ describe('shapes de los privados del padrón', () => {
     expect([store.managerRetailUserId, seller.phone, goals.goals.length]).toEqual(['u-1', null, 1]);
   });
 });
+
+describe('PrivateSellerDto.cognitoSub y createdAt', () => {
+  it('lleva la cuenta de RBAC y la fecha de alta, ambas nulables', () => {
+    const seller: PrivateSellerDto = {
+      sellerId: 'u-1',
+      displayName: 'Ana',
+      homeStoreId: null,
+      commissionTier: 'BASE',
+      status: 'ACTIVE' as never,
+      cognitoSub: 'sub-1',
+      createdAt: '2026-01-02T03:04:05.000Z',
+    };
+    const orphan: PrivateSellerDto = { ...seller, cognitoSub: null, createdAt: null };
+    expect(seller.cognitoSub).toBe('sub-1');
+    expect(orphan.createdAt).toBeNull();
+  });
+});

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

@@ -5,7 +5,7 @@ import {
 } from '../../../src/retailWizard';
 
 describe('BackofficeSellerTableResponse', () => {
-  it('declara las tres fuentes y una fila completa', () => {
+  it('declara las cinco fuentes y una fila completa', () => {
     const response: BackofficeSellerTableResponse = {
       from: '2026-09-07T06:00:00.000Z',
       to: '2026-10-07T05:59:59.999Z',
@@ -14,6 +14,8 @@ describe('BackofficeSellerTableResponse', () => {
         roster: SellerTableSourceStatusEnum.OK,
         goals: SellerTableSourceStatusEnum.UNAVAILABLE,
         commission: SellerTableSourceStatusEnum.OK,
+        rbac: SellerTableSourceStatusEnum.UNAVAILABLE,
+        lake: SellerTableSourceStatusEnum.DISABLED,
       },
       commissionPeriod: { periodId: '2026-09-28', from: '2026-09-28', to: '2026-10-04' },
       items: [
@@ -34,10 +36,15 @@ describe('BackofficeSellerTableResponse', () => {
           goalCents: null,
           commissionCents: null,
           npiM30Pct: null,
+          roles: [{ key: 'store_manager', name: 'Encargado de tienda' }],
+          email: null,
+          customersServed: 0,
+          memberSince: '2026-01-02T03:04:05.000Z',
+          weeklyPlacedCents: null,
         },
       ],
     };
-    expect(Object.values(SellerTableSourceStatusEnum)).toEqual(['OK', 'UNAVAILABLE']);
+    expect(Object.values(SellerTableSourceStatusEnum)).toEqual(['OK', 'UNAVAILABLE', 'DISABLED']);
     expect(response.items[0].npiM30Pct).toBeNull();
   });
 });

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/platformRbac/dtos/RoleAssignmentsByScopeRefsRequest.d.ts

@@ -0,0 +1,4 @@
+export declare const ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH = 100;
+export declare class RoleAssignmentsByScopeRefsRequest {
+    scopeRefs: string[];
+}

package/bin/platformRbac/dtos/RoleAssignmentsByScopeRefsRequest.js

@@ -0,0 +1,25 @@
+"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.RoleAssignmentsByScopeRefsRequest = exports.ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH = void 0;
+const class_validator_1 = require("class-validator");
+// Tope de scopeRefs por request del endpoint batch de asignaciones por destino.
+exports.ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH = 100;
+// Body de POST /internal/tenants/{tenantId}/role-assignments/by-scope-refs; la lista vacía responde sin items.
+class RoleAssignmentsByScopeRefsRequest {
+}
+exports.RoleAssignmentsByScopeRefsRequest = RoleAssignmentsByScopeRefsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(exports.ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], RoleAssignmentsByScopeRefsRequest.prototype, "scopeRefs", void 0);

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

@@ -0,0 +1,16 @@
+import type { PermissionScope } from '../enums/PermissionScope';
+import type { ScopeRefLookupStatusEnum } from '../enums/ScopeRefLookupStatusEnum';
+export interface ScopeRefRoleAssignment {
+    cognitoSub: string;
+    roleId: string;
+    roleName: string | null;
+    scope: PermissionScope;
+}
+export interface ScopeRefRoleAssignments {
+    scopeRef: string;
+    status: ScopeRefLookupStatusEnum;
+    assignments: ScopeRefRoleAssignment[];
+}
+export interface RoleAssignmentsByScopeRefsResponse {
+    items: ScopeRefRoleAssignments[];
+}

package/bin/platformRbac/dtos/RoleAssignmentsByScopeRefsResponse.js

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

package/bin/platformRbac/enums/ScopeRefLookupStatusEnum.d.ts

@@ -0,0 +1,5 @@
+/** Si la lectura de asignaciones de un destino contestó (`OK`) o falló (`UNAVAILABLE`). */
+export declare enum ScopeRefLookupStatusEnum {
+    OK = "OK",
+    UNAVAILABLE = "UNAVAILABLE"
+}

package/bin/platformRbac/enums/ScopeRefLookupStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeRefLookupStatusEnum = void 0;
+/** Si la lectura de asignaciones de un destino contestó (`OK`) o falló (`UNAVAILABLE`). */
+var ScopeRefLookupStatusEnum;
+(function (ScopeRefLookupStatusEnum) {
+    ScopeRefLookupStatusEnum["OK"] = "OK";
+    ScopeRefLookupStatusEnum["UNAVAILABLE"] = "UNAVAILABLE";
+})(ScopeRefLookupStatusEnum || (exports.ScopeRefLookupStatusEnum = ScopeRefLookupStatusEnum = {}));

package/bin/platformRbac/index.d.ts

@@ -87,6 +87,9 @@ export * from './dtos/RevokeTenantRoleRequest';
 export type { RevokeTenantRoleResponse } from './dtos/RevokeTenantRoleResponse';
 export * from './dtos/TenantUsersBySubsRequest';
 export type { TenantUserBySubItem, TenantUsersBySubsResponse } from './dtos/TenantUsersBySubsResponse';
+export * from './dtos/RoleAssignmentsByScopeRefsRequest';
+export * from './enums/ScopeRefLookupStatusEnum';
+export type { ScopeRefRoleAssignment, ScopeRefRoleAssignments, RoleAssignmentsByScopeRefsResponse, } from './dtos/RoleAssignmentsByScopeRefsResponse';
 export * from './apiUser/ApiLoginRequest';
 export * from './apiUser/ApiLoginResponse';
 export * from './apiUser/CreateApiUserRequest';

package/bin/platformRbac/index.js

@@ -129,6 +129,9 @@ __exportStar(require("./dtos/AssignTenantRoleRequest"), exports);
 __exportStar(require("./dtos/RevokeTenantRoleRequest"), exports);
 // Batch privado de usuarios del tenant por cognitoSub (hub de miembros de group-business).
 __exportStar(require("./dtos/TenantUsersBySubsRequest"), exports);
+// Batch privado de asignaciones de rol por destino (scopeRef), para la tabla de Vendedores.
+__exportStar(require("./dtos/RoleAssignmentsByScopeRefsRequest"), exports);
+__exportStar(require("./enums/ScopeRefLookupStatusEnum"), exports);
 // Usuarios de API: login por Bearer, alta, rotación de secreto y diagnóstico del W5.
 __exportStar(require("./apiUser/ApiLoginRequest"), exports);
 __exportStar(require("./apiUser/ApiLoginResponse"), exports);

package/bin/retailOrg/dtos/validation/PrivateSellerListResponse.d.ts

@@ -3,7 +3,7 @@ import type { RetailUserStatusEnum } from '../../enums/RetailUserStatusEnum';
  * Shape mínimo de un vendedor para el motor de comisiones (F3b): a quién pagarle, de qué tienda es y
  * en qué tier va.
  *
- * **Sin PII** — nada de teléfono ni `cognitoSub`. `displayName` es el rótulo de conveniencia con el
+ * **Sin PII** — el teléfono solo viaja a pedido. `displayName` es el rótulo de conveniencia con el
  * que el motor arma su reporte de devengo; no es identidad (la identidad vive en RBAC).
  *
  * `commissionTier` no es adorno: es lo que el motor usa para resolver CUÁNTO le toca a cada vendedor
@@ -17,6 +17,10 @@ export interface PrivateSellerDto {
     status: RetailUserStatusEnum;
     /** Teléfono del vendedor. Solo viaja si se pidió `includePhone=true`; `null` si no lo tiene. */
     phone?: string | null;
+    /** Cuenta del vendedor en RBAC; `null` si todavía no tiene usuario. */
+    cognitoSub?: string | null;
+    /** Alta del vendedor en el padrón (ISO); `null` si la fila no la trae. */
+    createdAt?: string | null;
 }
 /**
  * Respuesta de `GET /private/sellers?retailerId=…` — el padrón de una cadena, para máquinas.

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

@@ -1,5 +1,10 @@
 import type { RetailUserStatusEnum } from '../../../retailOrg/enums/RetailUserStatusEnum';
 import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
+/** Rol del vendedor en RBAC: `key` es el `roleId` y `name` su nombre legible. */
+export interface SellerTableRole {
+    key: string;
+    name: string;
+}
 /** Una fila de la tabla de Vendedores: padrón + ventas de la ventana + meta + comisión. */
 export interface SellerTableRow {
     retailUserId: string;
@@ -11,15 +16,25 @@ export interface SellerTableRow {
     storeId: string | null;
     storeName: string | null;
     zoneName: string | null;
-    /** Es el encargado (`managerRetailUserId`) de su tienda. */
+    /** Tiene el rol `store_manager`; si RBAC cae, es el encargado (`managerRetailUserId`) de su tienda. */
     isStoreAdmin: boolean;
+    /** Roles de RBAC en la cadena, sus zonas y tiendas; `null` si RBAC no contestó, `[]` sin cuenta o sin roles. */
+    roles: SellerTableRole[] | null;
+    /** Correo de su cuenta de RBAC; `null` sin cuenta, sin correo o con RBAC caído. */
+    email: string | null;
     /** Sin ventas en la ventana viaja `0`: el barrido es exhaustivo. */
     salesCount: number;
     placedCents: number;
     averageTicketCents: 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. */
+    /** Clientes distintos de la ventana, sin canceladas; `null` si los totales vinieron del lake. */
+    customersServed: number | null;
+    /** Alta del vendedor en el padrón (ISO); `null` si no está en el padrón. */
+    memberSince: string | null;
+    /** Δ % de los últimos 7 días (al cierre de la ventana) contra los 7 anteriores; `null` si la semana base vendió 0. */
     weekOverWeekChangePct: number | null;
+    /** Colocación de las últimas 8 semanas, de la más vieja a la actual; `null` sin lake. */
+    weeklyPlacedCents: number[] | null;
     /**
      * Meta mensual (`monthCents` del mes de `to`, hora de CDMX) escalada a los días de la ventana:
      * `round(monthCents * días / 30)`. `null` sin meta, con metas caídas o con ventana > 90 días.
@@ -35,6 +50,10 @@ export interface SellerTableSources {
     roster: SellerTableSourceStatusEnum;
     goals: SellerTableSourceStatusEnum;
     commission: SellerTableSourceStatusEnum;
+    /** Roles y correo. */
+    rbac: SellerTableSourceStatusEnum;
+    /** «Todo» y la tendencia de 8 semanas; `DISABLED` con el flag del lake apagado. */
+    lake: SellerTableSourceStatusEnum;
 }
 /** Corte semanal del que sale `commissionCents`; días locales `YYYY-MM-DD`, ambos incluidos. */
 export interface SellerTableCommissionPeriod {

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/SellerTableSourceStatusEnum.d.ts

@@ -1,5 +1,6 @@
-/** Si una fuente de la tabla de Vendedores contestó (`OK`) o falló (`UNAVAILABLE`). */
+/** Si una fuente de la tabla contestó (`OK`), falló (`UNAVAILABLE`) o está apagada por flag (`DISABLED`). */
 export declare enum SellerTableSourceStatusEnum {
     OK = "OK",
-    UNAVAILABLE = "UNAVAILABLE"
+    UNAVAILABLE = "UNAVAILABLE",
+    DISABLED = "DISABLED"
 }

package/bin/retailWizard/enums/SellerTableSourceStatusEnum.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SellerTableSourceStatusEnum = void 0;
-/** Si una fuente de la tabla de Vendedores contestó (`OK`) o falló (`UNAVAILABLE`). */
+/** Si una fuente de la tabla contestó (`OK`), falló (`UNAVAILABLE`) o está apagada por flag (`DISABLED`). */
 var SellerTableSourceStatusEnum;
 (function (SellerTableSourceStatusEnum) {
     SellerTableSourceStatusEnum["OK"] = "OK";
     SellerTableSourceStatusEnum["UNAVAILABLE"] = "UNAVAILABLE";
+    SellerTableSourceStatusEnum["DISABLED"] = "DISABLED";
 })(SellerTableSourceStatusEnum || (exports.SellerTableSourceStatusEnum = SellerTableSourceStatusEnum = {}));

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

@@ -138,6 +138,9 @@ 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

@@ -171,6 +171,9 @@ __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.507.0",
+  "version": "3.509.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/platformRbac/dtos/RoleAssignmentsByScopeRefsRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de scopeRefs por request del endpoint batch de asignaciones por destino.
+export const ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH = 100;
+
+// Body de POST /internal/tenants/{tenantId}/role-assignments/by-scope-refs; la lista vacía responde sin items.
+export class RoleAssignmentsByScopeRefsRequest {
+    @IsArray()
+    @ArrayMaxSize(ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH)
+    @IsString({ each: true })
+    scopeRefs!: string[];
+}

package/src/platformRbac/dtos/RoleAssignmentsByScopeRefsResponse.ts

@@ -0,0 +1,22 @@
+import type { PermissionScope } from '../enums/PermissionScope';
+import type { ScopeRefLookupStatusEnum } from '../enums/ScopeRefLookupStatusEnum';
+
+// Asignación vigente de un usuario en el destino; `roleId` es la clave del rol y `roleName` su displayName.
+export interface ScopeRefRoleAssignment {
+    cognitoSub: string;
+    roleId: string;
+    roleName: string | null;
+    scope: PermissionScope;
+}
+
+// Asignaciones de un destino; con `UNAVAILABLE` la lista viene vacía y no significa «sin roles».
+export interface ScopeRefRoleAssignments {
+    scopeRef: string;
+    status: ScopeRefLookupStatusEnum;
+    assignments: ScopeRefRoleAssignment[];
+}
+
+// Respuesta de POST /internal/tenants/{tenantId}/role-assignments/by-scope-refs; un item por scopeRef pedido.
+export interface RoleAssignmentsByScopeRefsResponse {
+    items: ScopeRefRoleAssignments[];
+}

package/src/platformRbac/enums/ScopeRefLookupStatusEnum.ts

@@ -0,0 +1,5 @@
+/** Si la lectura de asignaciones de un destino contestó (`OK`) o falló (`UNAVAILABLE`). */
+export enum ScopeRefLookupStatusEnum {
+    OK = 'OK',
+    UNAVAILABLE = 'UNAVAILABLE',
+}

package/src/platformRbac/index.ts

@@ -184,6 +184,15 @@ export type { RevokeTenantRoleResponse } from './dtos/RevokeTenantRoleResponse';
 export * from './dtos/TenantUsersBySubsRequest';
 export type { TenantUserBySubItem, TenantUsersBySubsResponse } from './dtos/TenantUsersBySubsResponse';
 
+// Batch privado de asignaciones de rol por destino (scopeRef), para la tabla de Vendedores.
+export * from './dtos/RoleAssignmentsByScopeRefsRequest';
+export * from './enums/ScopeRefLookupStatusEnum';
+export type {
+    ScopeRefRoleAssignment,
+    ScopeRefRoleAssignments,
+    RoleAssignmentsByScopeRefsResponse,
+} from './dtos/RoleAssignmentsByScopeRefsResponse';
+
 // Usuarios de API: login por Bearer, alta, rotación de secreto y diagnóstico del W5.
 export * from './apiUser/ApiLoginRequest';
 export * from './apiUser/ApiLoginResponse';

package/src/retailOrg/dtos/validation/PrivateSellerListResponse.ts

@@ -4,7 +4,7 @@ import type { RetailUserStatusEnum } from '../../enums/RetailUserStatusEnum';
  * Shape mínimo de un vendedor para el motor de comisiones (F3b): a quién pagarle, de qué tienda es y
  * en qué tier va.
  *
- * **Sin PII** — nada de teléfono ni `cognitoSub`. `displayName` es el rótulo de conveniencia con el
+ * **Sin PII** — el teléfono solo viaja a pedido. `displayName` es el rótulo de conveniencia con el
  * que el motor arma su reporte de devengo; no es identidad (la identidad vive en RBAC).
  *
  * `commissionTier` no es adorno: es lo que el motor usa para resolver CUÁNTO le toca a cada vendedor
@@ -18,6 +18,10 @@ export interface PrivateSellerDto {
     status: RetailUserStatusEnum;
     /** Teléfono del vendedor. Solo viaja si se pidió `includePhone=true`; `null` si no lo tiene. */
     phone?: string | null;
+    /** Cuenta del vendedor en RBAC; `null` si todavía no tiene usuario. */
+    cognitoSub?: string | null;
+    /** Alta del vendedor en el padrón (ISO); `null` si la fila no la trae. */
+    createdAt?: string | null;
 }
 
 /**

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

@@ -1,6 +1,12 @@
 import type { RetailUserStatusEnum } from '../../../retailOrg/enums/RetailUserStatusEnum';
 import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
 
+/** Rol del vendedor en RBAC: `key` es el `roleId` y `name` su nombre legible. */
+export interface SellerTableRole {
+    key: string;
+    name: string;
+}
+
 /** Una fila de la tabla de Vendedores: padrón + ventas de la ventana + meta + comisión. */
 export interface SellerTableRow {
     retailUserId: string;
@@ -12,15 +18,25 @@ export interface SellerTableRow {
     storeId: string | null;
     storeName: string | null;
     zoneName: string | null;
-    /** Es el encargado (`managerRetailUserId`) de su tienda. */
+    /** Tiene el rol `store_manager`; si RBAC cae, es el encargado (`managerRetailUserId`) de su tienda. */
     isStoreAdmin: boolean;
+    /** Roles de RBAC en la cadena, sus zonas y tiendas; `null` si RBAC no contestó, `[]` sin cuenta o sin roles. */
+    roles: SellerTableRole[] | null;
+    /** Correo de su cuenta de RBAC; `null` sin cuenta, sin correo o con RBAC caído. */
+    email: string | null;
     /** Sin ventas en la ventana viaja `0`: el barrido es exhaustivo. */
     salesCount: number;
     placedCents: number;
     averageTicketCents: 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. */
+    /** Clientes distintos de la ventana, sin canceladas; `null` si los totales vinieron del lake. */
+    customersServed: number | null;
+    /** Alta del vendedor en el padrón (ISO); `null` si no está en el padrón. */
+    memberSince: string | null;
+    /** Δ % de los últimos 7 días (al cierre de la ventana) contra los 7 anteriores; `null` si la semana base vendió 0. */
     weekOverWeekChangePct: number | null;
+    /** Colocación de las últimas 8 semanas, de la más vieja a la actual; `null` sin lake. */
+    weeklyPlacedCents: number[] | null;
     /**
      * Meta mensual (`monthCents` del mes de `to`, hora de CDMX) escalada a los días de la ventana:
      * `round(monthCents * días / 30)`. `null` sin meta, con metas caídas o con ventana > 90 días.
@@ -37,6 +53,10 @@ export interface SellerTableSources {
     roster: SellerTableSourceStatusEnum;
     goals: SellerTableSourceStatusEnum;
     commission: SellerTableSourceStatusEnum;
+    /** Roles y correo. */
+    rbac: SellerTableSourceStatusEnum;
+    /** «Todo» y la tendencia de 8 semanas; `DISABLED` con el flag del lake apagado. */
+    lake: SellerTableSourceStatusEnum;
 }
 
 /** Corte semanal del que sale `commissionCents`; días locales `YYYY-MM-DD`, ambos incluidos. */

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/SellerTableSourceStatusEnum.ts

@@ -1,5 +1,6 @@
-/** Si una fuente de la tabla de Vendedores contestó (`OK`) o falló (`UNAVAILABLE`). */
+/** Si una fuente de la tabla contestó (`OK`), falló (`UNAVAILABLE`) o está apagada por flag (`DISABLED`). */
 export enum SellerTableSourceStatusEnum {
     OK = 'OK',
     UNAVAILABLE = 'UNAVAILABLE',
+    DISABLED = 'DISABLED',
 }

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

@@ -163,6 +163,9 @@ 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';