@fiado/api-invoker 5.23.0 → 5.25.0

package/bin/contacts-business/api/ContactsBusinessApi.d.ts

@@ -1,10 +1,11 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import type { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
+import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse, EmailStartByDirectoryRequest, EmailStartByDirectoryResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
 import type { IContactsBusinessApi } from "./interfaces/IContactsBusinessApi.js";
 export default class ContactsBusinessApi implements IContactsBusinessApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     getPrimaryEmail(request: PrimaryEmailByDirectoryRequest): Promise<ApiGatewayResponse<PrimaryEmailResponse>>;
+    startVerification(request: EmailStartByDirectoryRequest): Promise<ApiGatewayResponse<EmailStartByDirectoryResponse>>;
 }

package/bin/contacts-business/api/ContactsBusinessApi.js

@@ -21,6 +21,10 @@ let ContactsBusinessApi = class ContactsBusinessApi {
         const url = `${this.baseUrl}/internal/email/primary`;
         return await this.httpRequest.get(url, { directoryId: request.directoryId });
     }
+    async startVerification(request) {
+        const url = `${this.baseUrl}/internal/email/start-verification`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 ContactsBusinessApi = __decorate([
     injectable(),

package/bin/contacts-business/api/interfaces/IContactsBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import type { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
+import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse, EmailStartByDirectoryRequest, EmailStartByDirectoryResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
 /**
  * Cliente del lambda contacts-business (fuente de verdad de correos verificados).
  * Lo consume benefits-marketplace-business en el gate de onboarding de remesas (F2).
@@ -11,4 +11,9 @@ export interface IContactsBusinessApi {
      * `email` es null si el directorio no tiene un correo verificado marcado oficial.
      */
     getPrimaryEmail(request: PrimaryEmailByDirectoryRequest): Promise<ApiGatewayResponse<PrimaryEmailResponse>>;
+    /**
+     * Registra un correo del directorio y dispara su verificación.
+     * Backend: POST /internal/email/start-verification (API privada/VPC).
+     */
+    startVerification(request: EmailStartByDirectoryRequest): Promise<ApiGatewayResponse<EmailStartByDirectoryResponse>>;
 }

package/bin/membership/MembershipApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IMembershipApi } from "./interfaces/IMembershipApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class MembershipApi implements IMembershipApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/membership/MembershipApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let MembershipApi = class MembershipApi {
+    httpRequest;
+    baseUrl = process.env.MEMBERSHIP_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+MembershipApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], MembershipApi);
+export { MembershipApi };

package/bin/membership/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IMembershipApi.js';
+export * from './MembershipApi.js';

package/bin/membership/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IMembershipApi.js';
+export * from './MembershipApi.js';

package/bin/membership/interfaces/IMembershipApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Membership (membership-business).
+ */
+export interface IMembershipApi {
+    /**
+     * Borra en cascada las membresías asociadas a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/membership/interfaces/IMembershipApi.js

@@ -0,0 +1 @@
+export {};

package/bin/notificationWebsockets/NotificationWebsocketApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { INotificationWebsocketApi } from "./interfaces/INotificationWebsocketApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class NotificationWebsocketApi implements INotificationWebsocketApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/notificationWebsockets/NotificationWebsocketApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let NotificationWebsocketApi = class NotificationWebsocketApi {
+    httpRequest;
+    baseUrl = process.env.NOTIFICATIONS_WEBSOCKET_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+NotificationWebsocketApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], NotificationWebsocketApi);
+export { NotificationWebsocketApi };

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Notifications Websocket (notifications-websocket).
+ */
+export interface INotificationWebsocketApi {
+    /**
+     * Borra en cascada las conexiones/notificaciones WS asociadas a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.js

@@ -0,0 +1 @@
+export {};

package/bin/performance-profile/PerformanceProfileApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IPerformanceProfileApi } from "./interfaces/IPerformanceProfileApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class PerformanceProfileApi implements IPerformanceProfileApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/performance-profile/PerformanceProfileApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let PerformanceProfileApi = class PerformanceProfileApi {
+    httpRequest;
+    baseUrl = process.env.PERFORMANCE_PROFILE_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+PerformanceProfileApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PerformanceProfileApi);
+export { PerformanceProfileApi };

package/bin/performance-profile/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IPerformanceProfileApi.js';
+export * from './PerformanceProfileApi.js';

package/bin/performance-profile/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IPerformanceProfileApi.js';
+export * from './PerformanceProfileApi.js';

package/bin/performance-profile/interfaces/IPerformanceProfileApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Performance Profile (performance-profile-business).
+ */
+export interface IPerformanceProfileApi {
+    /**
+     * Borra en cascada los perfiles de desempeño asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/performance-profile/interfaces/IPerformanceProfileApi.js

@@ -0,0 +1 @@
+export {};

package/bin/platformRbac/resolver/ApiInvokerPermissionResolver.js

@@ -38,7 +38,18 @@ let ApiInvokerPermissionResolver = class ApiInvokerPermissionResolver {
     }
     async resolve(input) {
         const cacheable = input.roleAssignmentsFromToken === undefined;
-        const key = `${input.issuer ?? ""}#${input.cognitoSub}`;
+        // DEC-RBAC-124: el tipo de principal entra en la cache key. NO es defensa contra colisión
+        // —los subs de integración llevan prefijo `INT#` y no chocan con un UUID de Cognito— sino
+        // para que el canal quede explícito y un cambio futuro de formato no cause aliasing
+        // silencioso entre un usuario y una integración.
+        //
+        // Se lee con cast en vez de tiparlo desde `ResolveInput` A PROPÓSITO: `principalType` recién
+        // existe en `@fiado/gateway-adapter` 4.x, y esta lib la consume toda la flota. Atarla al
+        // prerelease obligaría a todos a subir de major. Así compila igual contra 3.x y 4.x, y el
+        // reenvío al endpoint privado funciona en runtime porque `resolvePermissions(input)` manda
+        // el objeto entero sin filtrar campos.
+        const principalType = input.principalType ?? "USER";
+        const key = `${principalType}#${input.issuer ?? ""}#${input.cognitoSub}`;
         if (cacheable) {
             const hit = this._cache.get(key);
             if (hit)

package/bin/presence-websocket/PresenceWebsocketApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IPresenceWebsocketApi } from "./interfaces/IPresenceWebsocketApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class PresenceWebsocketApi implements IPresenceWebsocketApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/presence-websocket/PresenceWebsocketApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let PresenceWebsocketApi = class PresenceWebsocketApi {
+    httpRequest;
+    baseUrl = process.env.PRESENCE_WEBSOCKET_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+PresenceWebsocketApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PresenceWebsocketApi);
+export { PresenceWebsocketApi };

package/bin/presence-websocket/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IPresenceWebsocketApi.js';
+export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IPresenceWebsocketApi.js';
+export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Presence Websocket (presence-websocket).
+ */
+export interface IPresenceWebsocketApi {
+    /**
+     * Borra en cascada los registros de presencia asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.js

@@ -0,0 +1 @@
+export {};

package/bin/retailOrg/api/RetailOrgBusinessApi.d.ts

@@ -1,9 +1,9 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, RetailUserStatusEnum } from "@fiado/type-kit/bin/retailOrg/index.js";
-import { IRetailOrgBusinessApi } from "./interfaces/IRetailOrgBusinessApi.js";
+import { IRetailOrgBusinessApi, StoreRosterStatusFilter } from "./interfaces/IRetailOrgBusinessApi.js";
 /**
- * Publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1) para sus 6
+ * Publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1) para sus 8
  * endpoints privados de validación. Contrato y semántica completos → `IRetailOrgBusinessApi`.
  *
  * Los paths y el `?tenantId=` fueron verificados contra dev (200 + negativos 400/404) el
@@ -23,6 +23,13 @@ export default class RetailOrgBusinessApi implements IRetailOrgBusinessApi {
     getRetailer(retailerId: string, tenantId: string): Promise<StandardResponse<RetailerValidationDto>>;
     getRetailerByStore(storeId: string, tenantId: string): Promise<StandardResponse<RetailerValidationDto>>;
     getStore(retailerId: string, storeId: string, tenantId: string): Promise<StandardResponse<StoreValidationDto>>;
+    /**
+     * SureKeep F3 — el padrón de tiendas que le faltaba al tablero de cohorte de «Análisis de
+     * ventas»: sin él, la tienda que lleva 60 días sin vender no existe para el tablero. Contrato y
+     * semántica completos (incluido por qué acá `status` SÍ tiene default y en `listSellers` no)
+     * → `IRetailOrgBusinessApi.listStoresByRetailer`.
+     */
+    listStoresByRetailer(retailerId: string, tenantId: string, status?: StoreRosterStatusFilter): Promise<StandardResponse<StoreValidationDto[]>>;
     getStoreUsers(retailerId: string, storeId: string, tenantId: string): Promise<StandardResponse<RetailUserValidationDto[]>>;
     getUserByCognitoSub(cognitoSub: string, tenantId: string): Promise<StandardResponse<RetailUserValidationDto>>;
     listActiveCollectorsByRetailer(retailerId: string, tenantId: string): Promise<StandardResponse<CollectorValidationDto[]>>;

package/bin/retailOrg/api/RetailOrgBusinessApi.js

@@ -12,7 +12,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from "inversify";
 /**
- * Publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1) para sus 6
+ * Publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1) para sus 8
  * endpoints privados de validación. Contrato y semántica completos → `IRetailOrgBusinessApi`.
  *
  * Los paths y el `?tenantId=` fueron verificados contra dev (200 + negativos 400/404) el
@@ -43,6 +43,21 @@ let RetailOrgBusinessApi = class RetailOrgBusinessApi {
         const url = `${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/stores/${encodeURIComponent(storeId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+    /**
+     * SureKeep F3 — el padrón de tiendas que le faltaba al tablero de cohorte de «Análisis de
+     * ventas»: sin él, la tienda que lleva 60 días sin vender no existe para el tablero. Contrato y
+     * semántica completos (incluido por qué acá `status` SÍ tiene default y en `listSellers` no)
+     * → `IRetailOrgBusinessApi.listStoresByRetailer`.
+     */
+    async listStoresByRetailer(retailerId, tenantId, status) {
+        // `URLSearchParams` en vez de concatenar: `status` es opcional y armar el `&status=` a mano
+        // deja un `&status=undefined` en cuanto alguien se distrae.
+        const query = new URLSearchParams({ tenantId });
+        if (status)
+            query.set("status", status);
+        const path = `/private/retailers/${encodeURIComponent(retailerId)}/stores`;
+        return await this.httpRequest.get(`${this.baseUrl}${path}?${query.toString()}`);
+    }
     async getStoreUsers(retailerId, storeId, tenantId) {
         const url = `${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/users/by-store/${encodeURIComponent(storeId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);

package/bin/retailOrg/api/interfaces/IRetailOrgBusinessApi.d.ts

@@ -1,8 +1,14 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, RetailUserStatusEnum } from "@fiado/type-kit/bin/retailOrg/index.js";
+import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, RetailUserStatusEnum, StoreStatusEnum } from "@fiado/type-kit/bin/retailOrg/index.js";
+/**
+ * Filtro de `listStoresByRetailer`. `"ALL"` no es un estado de tienda: es la ausencia de filtro, y
+ * va en el MISMO parámetro que los estados porque los dos hablan del mismo eje — un segundo flag
+ * tipo `includeInactive` admitiría combinaciones sin sentido que alguien tendría que resolver.
+ */
+export type StoreRosterStatusFilter = StoreStatusEnum | "ALL";
 /**
  * Contrato del publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1)
- * para sus 6 endpoints privados de VALIDACIÓN (service-to-service, VPC-only).
+ * para sus 8 endpoints privados de VALIDACIÓN (service-to-service, VPC-only).
  *
  * Consumidores previstos (regla R5 — cruces entre lambdas son SOLO lecturas de validación;
  * ningún lambda escribe en tabla ajena):
@@ -12,7 +18,7 @@ import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, Col
  *   - `loan-collector-assignment-business` → lista cobradores ACTIVE del retailer para asignar cartera
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 4 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en TODOS los métodos — no es un detalle de firma.
  * ─────────────────────────────────────────────────────────────────────────────
  * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC),
  * así que el lambda destino no tiene `AuthContext.issuer` y NO puede inferir el silo. El caller
@@ -75,6 +81,42 @@ export interface IRetailOrgBusinessApi {
      * @throws si la tienda no existe o es de OTRO retailer (`404 STORE_NOT_FOUND` — verificado en dev).
      */
     getStore(retailerId: string, storeId: string, tenantId: string): Promise<StandardResponse<StoreValidationDto>>;
+    /**
+     * `GET /private/retailers/{retailerId}/stores` (SureKeep F3) — el **padrón de tiendas** de una
+     * cadena.
+     *
+     * ── 🔴 Por qué este método existe ────────────────────────────────────────────────────────────
+     * Lo consume el tablero de cohorte de «Análisis de ventas» (`retail-wizard-business`), que arma
+     * la lista de tiendas a partir de las VENTAS que leyó. Con eso, **la tienda que lleva 60 días sin
+     * vender no existe para el tablero** — y es exactamente la que hay que mirar. Este es el único
+     * endpoint que sirve el padrón completo: `getStore` resuelve UNA tienda y `publicListStores` va
+     * detrás del `W4Authorizer` (token de usuario, no invocable entre lambdas).
+     *
+     * NO se deriva de `listSellers`: ese endpoint escribe en `SharedPiiAccessLog_GT` y esa bitácora
+     * es la única traza de una exportación masiva de datos de empleados. Pedirle ids de tienda la
+     * llenaría de filas con una intención falsa.
+     *
+     * Devuelve el mismo `StoreValidationDto` que `getStore` — `storeId`, `retailerId`, `zoneId`,
+     * `zoneName`, `code`, `name`, `status` — con el `status` EFECTIVO (cascada del retailer padre ya
+     * aplicada). El `zoneName` sale de la tabla de zonas del propio retail-org: el consumidor no
+     * puede resolver un `zoneId` de otro dominio, y hoy lo saca de un snapshot congelado en la venta,
+     * así que una tienda re-zonificada muestra la zona vieja.
+     *
+     * ── ⚠️ `status` SÍ tiene default, al revés que `listSellers` ─────────────────────────────────
+     * Omitirlo devuelve **solo las `ACTIVE`**. La asimetría es deliberada: allá un vendedor dado de
+     * baja el día 20 sí tiene comisión por lo que vendió hasta el 19, así que filtrar lo perdería.
+     * Acá el consumidor cruza este padrón con ventas que YA leyó, o sea que la tienda cerrada que
+     * vendió dentro de la ventana entra igual por el lado de las ventas — filtrar no puede perder
+     * una tienda que vendió, solo evita agregar un cero permanente a un tablero cuyo trabajo es que
+     * las filas en cero llamen la atención. Pasa `"ALL"` para el padrón completo.
+     *
+     * @throws `404 RETAILER_NOT_FOUND` si el retailer no existe en ese silo. Un `[]` no distinguiría
+     *   "esta cadena no tiene tiendas" de "preguntaste por una cadena que no existe", y lo segundo
+     *   dejaría el tablero mudo sin que nadie sospeche del request.
+     * @throws `400 STORE_STATUS_FILTER_INVALID` si `status` no es del catálogo · `400 UNKNOWN_TENANT`
+     *   sin `tenantId`.
+     */
+    listStoresByRetailer(retailerId: string, tenantId: string, status?: StoreRosterStatusFilter): Promise<StandardResponse<StoreValidationDto[]>>;
     /**
      * GET /private/retailers/{retailerId}/users/by-store/{storeId} — usuarios retail cuya tienda base
      * (`homeStoreId`) es esa. Devuelve `[]` (no 404) si la tienda no tiene usuarios asignados.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.23.0",
+  "version": "5.25.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.278.0",
+    "@fiado/type-kit": "^3.295.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/contacts-business/api/ContactsBusinessApi.ts

@@ -1,7 +1,7 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import type { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
+import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse, EmailStartByDirectoryRequest, EmailStartByDirectoryResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
 import type { IContactsBusinessApi } from "./interfaces/IContactsBusinessApi.js";
 
 @injectable()
@@ -14,4 +14,9 @@ export default class ContactsBusinessApi implements IContactsBusinessApi {
         const url = `${this.baseUrl}/internal/email/primary`;
         return await this.httpRequest.get(url, { directoryId: request.directoryId });
     }
+
+    async startVerification(request: EmailStartByDirectoryRequest): Promise<ApiGatewayResponse<EmailStartByDirectoryResponse>> {
+        const url = `${this.baseUrl}/internal/email/start-verification`;
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/contacts-business/api/interfaces/IContactsBusinessApi.ts

@@ -1,5 +1,5 @@
 import type { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
+import type { PrimaryEmailByDirectoryRequest, PrimaryEmailResponse, EmailStartByDirectoryRequest, EmailStartByDirectoryResponse } from "@fiado/type-kit/bin/emailVerification/index.js";
 
 /**
  * Cliente del lambda contacts-business (fuente de verdad de correos verificados).
@@ -12,4 +12,10 @@ export interface IContactsBusinessApi {
      * `email` es null si el directorio no tiene un correo verificado marcado oficial.
      */
     getPrimaryEmail(request: PrimaryEmailByDirectoryRequest): Promise<ApiGatewayResponse<PrimaryEmailResponse>>;
+
+    /**
+     * Registra un correo del directorio y dispara su verificación.
+     * Backend: POST /internal/email/start-verification (API privada/VPC).
+     */
+    startVerification(request: EmailStartByDirectoryRequest): Promise<ApiGatewayResponse<EmailStartByDirectoryResponse>>;
 }

package/src/platformRbac/resolver/ApiInvokerPermissionResolver.ts

@@ -31,7 +31,18 @@ export class ApiInvokerPermissionResolver {
     }
     async resolve(input: ResolveInput): Promise<ResolvedPermissions> {
         const cacheable = input.roleAssignmentsFromToken === undefined;
-        const key = `${input.issuer ?? ""}#${input.cognitoSub}`;
+        // DEC-RBAC-124: el tipo de principal entra en la cache key. NO es defensa contra colisión
+        // —los subs de integración llevan prefijo `INT#` y no chocan con un UUID de Cognito— sino
+        // para que el canal quede explícito y un cambio futuro de formato no cause aliasing
+        // silencioso entre un usuario y una integración.
+        //
+        // Se lee con cast en vez de tiparlo desde `ResolveInput` A PROPÓSITO: `principalType` recién
+        // existe en `@fiado/gateway-adapter` 4.x, y esta lib la consume toda la flota. Atarla al
+        // prerelease obligaría a todos a subir de major. Así compila igual contra 3.x y 4.x, y el
+        // reenvío al endpoint privado funciona en runtime porque `resolvePermissions(input)` manda
+        // el objeto entero sin filtrar campos.
+        const principalType = (input as { principalType?: string }).principalType ?? "USER";
+        const key = `${principalType}#${input.issuer ?? ""}#${input.cognitoSub}`;
         if (cacheable) {
             const hit = this._cache.get(key);
             if (hit) return hit;

package/src/retailOrg/api/RetailOrgBusinessApi.ts

@@ -9,10 +9,13 @@ import {
     PrivateSellerListResponse,
     RetailUserStatusEnum,
 } from "@fiado/type-kit/bin/retailOrg/index.js";
-import { IRetailOrgBusinessApi } from "./interfaces/IRetailOrgBusinessApi.js";
+import {
+    IRetailOrgBusinessApi,
+    StoreRosterStatusFilter,
+} from "./interfaces/IRetailOrgBusinessApi.js";
 
 /**
- * Publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1) para sus 6
+ * Publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1) para sus 8
  * endpoints privados de validación. Contrato y semántica completos → `IRetailOrgBusinessApi`.
  *
  * Los paths y el `?tenantId=` fueron verificados contra dev (200 + negativos 400/404) el
@@ -56,6 +59,25 @@ export default class RetailOrgBusinessApi implements IRetailOrgBusinessApi {
         return await this.httpRequest.get(url);
     }
 
+    /**
+     * SureKeep F3 — el padrón de tiendas que le faltaba al tablero de cohorte de «Análisis de
+     * ventas»: sin él, la tienda que lleva 60 días sin vender no existe para el tablero. Contrato y
+     * semántica completos (incluido por qué acá `status` SÍ tiene default y en `listSellers` no)
+     * → `IRetailOrgBusinessApi.listStoresByRetailer`.
+     */
+    async listStoresByRetailer(
+        retailerId: string,
+        tenantId: string,
+        status?: StoreRosterStatusFilter,
+    ): Promise<StandardResponse<StoreValidationDto[]>> {
+        // `URLSearchParams` en vez de concatenar: `status` es opcional y armar el `&status=` a mano
+        // deja un `&status=undefined` en cuanto alguien se distrae.
+        const query = new URLSearchParams({ tenantId });
+        if (status) query.set("status", status);
+        const path = `/private/retailers/${encodeURIComponent(retailerId)}/stores`;
+        return await this.httpRequest.get(`${this.baseUrl}${path}?${query.toString()}`);
+    }
+
     async getStoreUsers(
         retailerId: string,
         storeId: string,

package/src/retailOrg/api/interfaces/IRetailOrgBusinessApi.ts

@@ -6,11 +6,19 @@ import {
     CollectorValidationDto,
     PrivateSellerListResponse,
     RetailUserStatusEnum,
+    StoreStatusEnum,
 } from "@fiado/type-kit/bin/retailOrg/index.js";
 
+/**
+ * Filtro de `listStoresByRetailer`. `"ALL"` no es un estado de tienda: es la ausencia de filtro, y
+ * va en el MISMO parámetro que los estados porque los dos hablan del mismo eje — un segundo flag
+ * tipo `includeInactive` admitiría combinaciones sin sentido que alguien tendría que resolver.
+ */
+export type StoreRosterStatusFilter = StoreStatusEnum | "ALL";
+
 /**
  * Contrato del publisher HTTP del lambda `retail-org-business` (componente 04 SureKeep Fase 1)
- * para sus 6 endpoints privados de VALIDACIÓN (service-to-service, VPC-only).
+ * para sus 8 endpoints privados de VALIDACIÓN (service-to-service, VPC-only).
  *
  * Consumidores previstos (regla R5 — cruces entre lambdas son SOLO lecturas de validación;
  * ningún lambda escribe en tabla ajena):
@@ -20,7 +28,7 @@ import {
  *   - `loan-collector-assignment-business` → lista cobradores ACTIVE del retailer para asignar cartera
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * `tenantId` es OBLIGATORIO en los 4 métodos — no es un detalle de firma.
+ * `tenantId` es OBLIGATORIO en TODOS los métodos — no es un detalle de firma.
  * ─────────────────────────────────────────────────────────────────────────────
  * Los privados NO llevan token de usuario (`Feature.ANONIMUS`; la protección es la red VPC),
  * así que el lambda destino no tiene `AuthContext.issuer` y NO puede inferir el silo. El caller
@@ -96,6 +104,47 @@ export interface IRetailOrgBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<StoreValidationDto>>;
 
+    /**
+     * `GET /private/retailers/{retailerId}/stores` (SureKeep F3) — el **padrón de tiendas** de una
+     * cadena.
+     *
+     * ── 🔴 Por qué este método existe ────────────────────────────────────────────────────────────
+     * Lo consume el tablero de cohorte de «Análisis de ventas» (`retail-wizard-business`), que arma
+     * la lista de tiendas a partir de las VENTAS que leyó. Con eso, **la tienda que lleva 60 días sin
+     * vender no existe para el tablero** — y es exactamente la que hay que mirar. Este es el único
+     * endpoint que sirve el padrón completo: `getStore` resuelve UNA tienda y `publicListStores` va
+     * detrás del `W4Authorizer` (token de usuario, no invocable entre lambdas).
+     *
+     * NO se deriva de `listSellers`: ese endpoint escribe en `SharedPiiAccessLog_GT` y esa bitácora
+     * es la única traza de una exportación masiva de datos de empleados. Pedirle ids de tienda la
+     * llenaría de filas con una intención falsa.
+     *
+     * Devuelve el mismo `StoreValidationDto` que `getStore` — `storeId`, `retailerId`, `zoneId`,
+     * `zoneName`, `code`, `name`, `status` — con el `status` EFECTIVO (cascada del retailer padre ya
+     * aplicada). El `zoneName` sale de la tabla de zonas del propio retail-org: el consumidor no
+     * puede resolver un `zoneId` de otro dominio, y hoy lo saca de un snapshot congelado en la venta,
+     * así que una tienda re-zonificada muestra la zona vieja.
+     *
+     * ── ⚠️ `status` SÍ tiene default, al revés que `listSellers` ─────────────────────────────────
+     * Omitirlo devuelve **solo las `ACTIVE`**. La asimetría es deliberada: allá un vendedor dado de
+     * baja el día 20 sí tiene comisión por lo que vendió hasta el 19, así que filtrar lo perdería.
+     * Acá el consumidor cruza este padrón con ventas que YA leyó, o sea que la tienda cerrada que
+     * vendió dentro de la ventana entra igual por el lado de las ventas — filtrar no puede perder
+     * una tienda que vendió, solo evita agregar un cero permanente a un tablero cuyo trabajo es que
+     * las filas en cero llamen la atención. Pasa `"ALL"` para el padrón completo.
+     *
+     * @throws `404 RETAILER_NOT_FOUND` si el retailer no existe en ese silo. Un `[]` no distinguiría
+     *   "esta cadena no tiene tiendas" de "preguntaste por una cadena que no existe", y lo segundo
+     *   dejaría el tablero mudo sin que nadie sospeche del request.
+     * @throws `400 STORE_STATUS_FILTER_INVALID` si `status` no es del catálogo · `400 UNKNOWN_TENANT`
+     *   sin `tenantId`.
+     */
+    listStoresByRetailer(
+        retailerId: string,
+        tenantId: string,
+        status?: StoreRosterStatusFilter,
+    ): Promise<StandardResponse<StoreValidationDto[]>>;
+
     /**
      * GET /private/retailers/{retailerId}/users/by-store/{storeId} — usuarios retail cuya tienda base
      * (`homeStoreId`) es esa. Devuelve `[]` (no 404) si la tienda no tiene usuarios asignados.