@fiado/type-kit 3.466.0 → 3.468.0

package/_test_/unit/directory/directoryAgentsBySponsorDtos.test.ts

@@ -0,0 +1,69 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    DirectoryAgentsBySponsorRequest,
+    DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH,
+} from '../../../src/directory';
+import type {
+    DirectoryAgentBySponsorItem,
+    DirectoryAgentsBySponsorResponse,
+} from '../../../src/directory';
+
+describe('DirectoryAgentsBySponsorRequest', () => {
+    it('el tope del lote es 100', () => {
+        expect(DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH).toBe(100);
+    });
+
+    it('acepta una lista de ids', async () => {
+        const dto = plainToInstance(DirectoryAgentsBySponsorRequest, { sponsorDirectoryIds: ['d1', 'd2'] });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('acepta la lista vacía', async () => {
+        const dto = plainToInstance(DirectoryAgentsBySponsorRequest, { sponsorDirectoryIds: [] });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('acepta exactamente 100 ids', async () => {
+        const ids = Array.from({ length: 100 }, (_, i) => `d${i}`);
+        const dto = plainToInstance(DirectoryAgentsBySponsorRequest, { sponsorDirectoryIds: ids });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('rechaza 101 ids con la constraint arrayMaxSize', async () => {
+        const ids = Array.from({ length: 101 }, (_, i) => `d${i}`);
+        const dto = plainToInstance(DirectoryAgentsBySponsorRequest, { sponsorDirectoryIds: ids });
+        const errors = await validate(dto);
+        expect(errors).toHaveLength(1);
+        expect(errors[0].property).toBe('sponsorDirectoryIds');
+        expect(errors[0].constraints?.arrayMaxSize).toBeDefined();
+    });
+
+    it('rechaza si falta el campo', async () => {
+        const dto = plainToInstance(DirectoryAgentsBySponsorRequest, {});
+        const errors = await validate(dto);
+        expect(errors[0].constraints?.isArray).toBeDefined();
+    });
+
+    it('rechaza un id que no es string', async () => {
+        const dto = plainToInstance(DirectoryAgentsBySponsorRequest, { sponsorDirectoryIds: ['d1', 7] });
+        const errors = await validate(dto);
+        expect(errors[0].constraints?.isString).toBeDefined();
+    });
+});
+
+describe('DirectoryAgentsBySponsorResponse', () => {
+    it('es un mapa sponsorDirectoryId -> directorio AGENT', () => {
+        const item: DirectoryAgentBySponsorItem = {
+            id: 'agent-dir-1',
+            sponsorDirectoryId: 'd1',
+            identityId: null,
+            email: null,
+            status: 'ACTIVE',
+            updatedAt: null,
+        };
+        const response: DirectoryAgentsBySponsorResponse = { d1: item };
+        expect(response.d1.sponsorDirectoryId).toBe('d1');
+    });
+});

package/_test_/unit/group/groupMemberHubItem.test.ts

@@ -0,0 +1,87 @@
+import 'reflect-metadata';
+import type { GroupMemberHubItem } from '../../../src/group';
+import { RelationStatus, RelationType } from '../../../src/group';
+import { CPStatusEnum } from '../../../src/identity/enums/CPStatusEnum';
+
+const [anyRelationType] = Object.values(RelationType) as RelationType[];
+const [anyRelationStatus] = Object.values(RelationStatus) as RelationStatus[];
+const [anyCpStatus] = Object.values(CPStatusEnum) as CPStatusEnum[];
+
+describe('GroupMemberHubItem', () => {
+    it('un miembro que no es agente lleva las columnas de agente en null', () => {
+        const row: GroupMemberHubItem = {
+            PK: 'GROUP#g1',
+            SK: 'DIRECTORY#d1',
+            directoryId: 'd1',
+            groupId: 'g1',
+            relationType: anyRelationType,
+            status: anyRelationStatus,
+            agent: null,
+            createdAt: '2026-09-24T00:00:00.000Z',
+            updatedAt: '2026-09-24T00:00:00.000Z',
+            phoneNumber: null,
+            indexName: null,
+            peopleId: null,
+            referralCode: null,
+            myReferralCode: null,
+            CP_Status: null,
+            parentGroupId: null,
+            operationId: null,
+            referralDirectoryId: null,
+            promotedToDirectory: null,
+            isAgent: false,
+            agentId: null,
+            agentRole: null,
+            agentStatus: null,
+            position: null,
+            reportsToDirectoryId: null,
+            reportsToName: null,
+            agentDirectoryStatus: null,
+            loginEmail: null,
+            hasRbac: false,
+            rbacStatus: null,
+        };
+        expect(row.isAgent).toBe(false);
+    });
+
+    it('hasRbac admite null cuando la fuente RBAC no respondió', () => {
+        const unknownRbac: GroupMemberHubItem['hasRbac'] = null;
+        expect(unknownRbac).toBeNull();
+    });
+
+    it('un agente con RBAC llena las columnas nuevas', () => {
+        const row: GroupMemberHubItem = {
+            PK: 'GROUP#g1',
+            SK: 'DIRECTORY#d2',
+            directoryId: 'd2',
+            groupId: 'g1',
+            relationType: anyRelationType,
+            status: anyRelationStatus,
+            agent: 'agent-1',
+            createdAt: '2026-09-24T00:00:00.000Z',
+            updatedAt: '2026-09-24T00:00:00.000Z',
+            phoneNumber: '+525500000000',
+            indexName: 'ANA PEREZ',
+            peopleId: 'p2',
+            referralCode: 'SPONSOR1',
+            myReferralCode: 'MINE1',
+            CP_Status: anyCpStatus,
+            parentGroupId: null,
+            operationId: 'op-1',
+            referralDirectoryId: 'd9',
+            promotedToDirectory: false,
+            isAgent: true,
+            agentId: 'agent-1',
+            agentRole: 'AGENT',
+            agentStatus: 'ACTIVE',
+            position: 'Supervisora',
+            reportsToDirectoryId: 'd1',
+            reportsToName: 'JUAN LOPEZ',
+            agentDirectoryStatus: 'ACTIVE',
+            loginEmail: 'ana@somosfiado.com',
+            hasRbac: true,
+            rbacStatus: 'ACTIVE',
+        };
+        expect(row.rbacStatus).toBe('ACTIVE');
+    });
+});

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

@@ -0,0 +1,61 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    TenantUsersBySubsRequest,
+    TENANT_USERS_BY_SUBS_MAX_BATCH,
+} from '../../../../src/platformRbac';
+import type {
+    TenantUserBySubItem,
+    TenantUsersBySubsResponse,
+} from '../../../../src/platformRbac';
+
+describe('TenantUsersBySubsRequest', () => {
+    it('el tope del lote es 100', () => {
+        expect(TENANT_USERS_BY_SUBS_MAX_BATCH).toBe(100);
+    });
+
+    it('acepta una lista de cognitoSubs', async () => {
+        const dto = plainToInstance(TenantUsersBySubsRequest, { cognitoSubs: ['sub-1', 'sub-2'] });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('acepta la lista vacía', async () => {
+        const dto = plainToInstance(TenantUsersBySubsRequest, { cognitoSubs: [] });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('rechaza 101 subs con la constraint arrayMaxSize', async () => {
+        const subs = Array.from({ length: 101 }, (_, i) => `sub-${i}`);
+        const dto = plainToInstance(TenantUsersBySubsRequest, { cognitoSubs: subs });
+        const errors = await validate(dto);
+        expect(errors).toHaveLength(1);
+        expect(errors[0].property).toBe('cognitoSubs');
+        expect(errors[0].constraints?.arrayMaxSize).toBeDefined();
+    });
+
+    it('rechaza si falta el campo', async () => {
+        const dto = plainToInstance(TenantUsersBySubsRequest, {});
+        const errors = await validate(dto);
+        expect(errors[0].constraints?.isArray).toBeDefined();
+    });
+
+    it('rechaza un sub que no es string', async () => {
+        const dto = plainToInstance(TenantUsersBySubsRequest, { cognitoSubs: [null] });
+        const errors = await validate(dto);
+        expect(errors[0].constraints?.isString).toBeDefined();
+    });
+});
+
+describe('TenantUsersBySubsResponse', () => {
+    it('es un mapa cognitoSub -> usuario, con email nullable', () => {
+        const item: TenantUserBySubItem = {
+            cognitoSub: 'sub-1',
+            email: null,
+            status: 'ACTIVE',
+            displayName: null,
+        };
+        const response: TenantUsersBySubsResponse = { 'sub-1': item };
+        expect(response['sub-1'].status).toBe('ACTIVE');
+    });
+});

package/_test_/unit/referral-business/agentsByDirectoryIdsDtos.test.ts

@@ -0,0 +1,65 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    AgentsByDirectoryIdsRequest,
+    AGENTS_BY_DIRECTORY_IDS_MAX_BATCH,
+} from '../../../src/referral-business';
+import type {
+    AgentByDirectoryIdItem,
+    AgentsByDirectoryIdsResponse,
+} from '../../../src/referral-business';
+
+describe('AgentsByDirectoryIdsRequest', () => {
+    it('el tope del lote es 100', () => {
+        expect(AGENTS_BY_DIRECTORY_IDS_MAX_BATCH).toBe(100);
+    });
+
+    it('acepta una lista de ids', async () => {
+        const dto = plainToInstance(AgentsByDirectoryIdsRequest, { directoryIds: ['d1', 'd2'] });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('acepta la lista vacía', async () => {
+        const dto = plainToInstance(AgentsByDirectoryIdsRequest, { directoryIds: [] });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('rechaza 101 ids con la constraint arrayMaxSize', async () => {
+        const ids = Array.from({ length: 101 }, (_, i) => `d${i}`);
+        const dto = plainToInstance(AgentsByDirectoryIdsRequest, { directoryIds: ids });
+        const errors = await validate(dto);
+        expect(errors).toHaveLength(1);
+        expect(errors[0].property).toBe('directoryIds');
+        expect(errors[0].constraints?.arrayMaxSize).toBeDefined();
+    });
+
+    it('rechaza si directoryIds no es arreglo', async () => {
+        const dto = plainToInstance(AgentsByDirectoryIdsRequest, { directoryIds: 'd1' });
+        const errors = await validate(dto);
+        expect(errors[0].constraints?.isArray).toBeDefined();
+    });
+
+    it('rechaza un id que no es string', async () => {
+        const dto = plainToInstance(AgentsByDirectoryIdsRequest, { directoryIds: [1] });
+        const errors = await validate(dto);
+        expect(errors[0].constraints?.isString).toBeDefined();
+    });
+});
+
+describe('AgentsByDirectoryIdsResponse', () => {
+    it('es un mapa directoryId -> agente', () => {
+        const item: AgentByDirectoryIdItem = {
+            id: 'agent-1',
+            directoryId: 'd1',
+            groupId: null,
+            agentRole: 'AGENT',
+            notes: null,
+            parentDirectoryId: null,
+            status: 'ACTIVE',
+            updatedAt: 1727222400000,
+        };
+        const response: AgentsByDirectoryIdsResponse = { d1: item };
+        expect(response.d1.id).toBe('agent-1');
+    });
+});

package/bin/credit/dtos/BannerStateResponse.d.ts

@@ -24,13 +24,19 @@ export declare class BannerStateResponse {
     credit_id?: string | null;
     /** Pago del proximo cupon pendiente. */
     next_payment_amount_mxn?: number | null;
+    /** USD real que cobrará el collector por next_payment_amount_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    next_payment_amount_usd_charge?: number;
     next_payment_date?: string | null;
     next_coupon_number?: number | null;
     /** Montos de cupones vencidos (solo DELINQUENT). */
     overdue_amount_mxn?: number | null;
+    /** USD real que cobrará el collector por overdue_amount_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    overdue_amount_usd_charge?: number;
     overdue_count?: number | null;
     /** Saldo insoluto del credito activo. */
     outstanding_balance_mxn?: number | null;
+    /** USD real que cobrará el collector por outstanding_balance_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    outstanding_balance_usd_charge?: number;
     /**
      * Cantidad total de creditos que el directoryId ha tenido en Credits_GT
      * (incluye ACTIVE, PAID_OFF, DEFAULTED — todos los estados historicos).

package/bin/credit/dtos/CreditOfferOptionItem.d.ts

@@ -5,7 +5,11 @@ export declare class CreditOfferOptionItem {
     term_weeks: number;
     annual_rate: number;
     weekly_payment_mxn: number;
+    /** USD real que cobrará el collector por weekly_payment_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    weekly_payment_usd_charge?: number;
     total_to_pay_mxn: number;
+    /** USD real que cobrará el collector por total_to_pay_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    total_to_pay_usd_charge?: number;
     total_interest_mxn: number;
     savings_vs_longest: number;
     is_recommended: boolean;
@@ -17,6 +21,8 @@ export declare class CreditOfferOptionItem {
     first_payment_date?: string;
     /** Monto solicitado por el cliente (lo que recibe). */
     requested_amount_mxn?: number;
+    /** USD real que cobrará el collector por requested_amount_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    requested_amount_usd_charge?: number;
     /** Principal financiado (amount + fee + fee_iva si financed). */
     financed_amount_mxn?: number;
     /** Comision por apertura como fraccion (ej. 0.05 = 5%). */

package/bin/creditEngine/dtos/AnticipatedPaymentQuote.d.ts

@@ -1,4 +1,5 @@
 import { PaymentScheduleItemResponse } from "./PaymentScheduleItemResponse";
+import { FxQuote } from "./FxQuote";
 /**
  * Preview / cotizacion de un abono a capital (ANTICIPATED) antes de ejecutarlo.
  *
@@ -13,6 +14,8 @@ export declare class AnticipatedPaymentQuote {
     creditId: string;
     /** Monto que el usuario propuso, capeado al outstanding real del credito. */
     amountMxn: number;
+    /** USD real que cobrará el collector por amountMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    amountUsdCharge?: number;
     /** Estado actual (as-is) del credito, antes de aplicar el abono. */
     current: AnticipatedPaymentSummary;
     /** Estado proyectado (as-if) despues de aplicar el abono. */
@@ -28,10 +31,14 @@ export declare class AnticipatedPaymentQuote {
     newSchedule: PaymentScheduleItemResponse[];
     /** ISO timestamp de la cotizacion. */
     quoteDate: string;
+    /** Cotizacion FX usada para los campos `*UsdCharge` (incluye los de `newSchedule`). Ausente si el collector no estuvo disponible. */
+    fxQuote?: FxQuote;
 }
 export declare class AnticipatedPaymentSummary {
     /** Cuota semanal vigente. */
     weeklyPaymentMxn: number;
+    /** USD real que cobrará el collector por weeklyPaymentMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    weeklyPaymentUsdCharge?: number;
     /** Saldo insoluto (capital pendiente). */
     outstandingMxn: number;
     /** Cupones que aun no estan PAID (incluye PARTIAL). */

package/bin/creditEngine/dtos/CreditDetailResponse.d.ts

@@ -1,3 +1,4 @@
+import { FxQuote } from "./FxQuote";
 /**
  * Response con el detalle completo de un credito LOAN.
  */
@@ -9,11 +10,15 @@ export declare class CreditDetailResponse {
     termWeeks?: number;
     annualRate?: number;
     weeklyPaymentMxn?: number;
+    /** USD real que cobrará el collector por weeklyPaymentMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    weeklyPaymentUsdCharge?: number;
     status?: string;
     nextPaymentDate?: string;
     paidCoupons?: number;
     totalCoupons?: number;
     remainingBalanceMxn?: number;
+    /** USD real que cobrará el collector por remainingBalanceMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    remainingBalanceUsdCharge?: number;
     cat?: number | null;
     totalInterestMxn?: number;
     totalIvaMxn?: number;
@@ -24,8 +29,16 @@ export declare class CreditDetailResponse {
     firstPaymentDate?: string | null;
     lastPaymentDate?: string | null;
     nextPaymentAmountMxn?: number | null;
+    /** USD real que cobrará el collector por nextPaymentAmountMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    nextPaymentAmountUsdCharge?: number;
     nextCouponNumber?: number | null;
     totalPaidMxn?: number;
+    /** USD real que cobrará el collector por totalPaidMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    totalPaidUsdCharge?: number;
     overdueCount?: number;
     overdueAmountMxn?: number;
+    /** USD real que cobrará el collector por overdueAmountMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    overdueAmountUsdCharge?: number;
+    /** Cotizacion FX usada para los campos `*UsdCharge`. Ausente si el collector no estuvo disponible. */
+    fxQuote?: FxQuote;
 }

package/bin/creditEngine/dtos/FxQuote.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tipo de cambio y factor que el collector aplicara al cobro en USD.
+ *
+ * Es la cotizacion vigente al momento de armar la respuesta: con ella el
+ * collector convierte cada monto MXN al USD real que descuenta del pocket
+ * (comision + IVA + TC ajustado). Viaja junto a los campos `<x>UsdCharge`
+ * para que el frontend pueda explicar el numero, no para recalcularlo.
+ * Ausente si el collector no estuvo disponible.
+ */
+export declare class FxQuote {
+    /** TC MXN por USD publicado, sin ajuste. */
+    exchangeRate: number;
+    /** TC MXN por USD ajustado con el colchon del collector; es el divisor real del cobro. */
+    adjustmentRate: number;
+    /** Factor multiplicativo sobre el MXN nocional (comision + IVA). */
+    totalFactor: number;
+    /** Momento de la cotizacion, ISO 8601. */
+    quotedAt: string;
+}
+/**
+ * Gemelo snake_case de `FxQuote` para los DTOs contenedores que ya son
+ * snake_case (`SettlementQuote`, `OfferResult`). Misma semantica campo a campo.
+ */
+export declare class FxQuoteSnake {
+    /** TC MXN por USD publicado, sin ajuste. */
+    exchange_rate: number;
+    /** TC MXN por USD ajustado con el colchon del collector; es el divisor real del cobro. */
+    adjustment_rate: number;
+    /** Factor multiplicativo sobre el MXN nocional (comision + IVA). */
+    total_factor: number;
+    /** Momento de la cotizacion, ISO 8601. */
+    quoted_at: string;
+}

package/bin/creditEngine/dtos/FxQuote.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FxQuoteSnake = exports.FxQuote = void 0;
+/**
+ * Tipo de cambio y factor que el collector aplicara al cobro en USD.
+ *
+ * Es la cotizacion vigente al momento de armar la respuesta: con ella el
+ * collector convierte cada monto MXN al USD real que descuenta del pocket
+ * (comision + IVA + TC ajustado). Viaja junto a los campos `<x>UsdCharge`
+ * para que el frontend pueda explicar el numero, no para recalcularlo.
+ * Ausente si el collector no estuvo disponible.
+ */
+class FxQuote {
+}
+exports.FxQuote = FxQuote;
+/**
+ * Gemelo snake_case de `FxQuote` para los DTOs contenedores que ya son
+ * snake_case (`SettlementQuote`, `OfferResult`). Misma semantica campo a campo.
+ */
+class FxQuoteSnake {
+}
+exports.FxQuoteSnake = FxQuoteSnake;

package/bin/creditEngine/dtos/OfferResult.d.ts

@@ -1,3 +1,4 @@
+import { FxQuoteSnake } from "./FxQuote";
 /**
  * Respuesta del endpoint de generación de oferta: lista de tasas disponibles
  * para el usuario, plus los parámetros de la comisión por apertura.
@@ -18,4 +19,6 @@ export declare class OfferResult {
     opening_fee_pct?: number;
     /** True si la comisión se financia (se suma al principal y se amortiza); false si se cobra al desembolso. */
     opening_fee_financed?: boolean;
+    /** Cotizacion FX vigente al generar la oferta, para los `*_usd_charge` que el frontend proyecte sobre ella. Ausente si el collector no estuvo disponible. */
+    fx_quote?: FxQuoteSnake;
 }

package/bin/creditEngine/dtos/PaymentScheduleItemResponse.d.ts

@@ -8,6 +8,10 @@ export declare class PaymentScheduleItemResponse {
     interestMxn?: number;
     ivaMxn?: number;
     totalMxn?: number;
+    /** USD real que cobrará el collector por totalMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    totalUsdCharge?: number;
+    /** True si totalUsdCharge queda por debajo del minimo cobrable del collector. Solo viene cuando aplica. */
+    totalBelowMinimum?: boolean;
     status?: string;
     paidAmountMxn: number;
     remainingBalanceMxn?: number;

package/bin/creditEngine/dtos/SettlementQuote.d.ts

@@ -1,3 +1,4 @@
+import { FxQuoteSnake } from "./FxQuote";
 /**
  * Cotizacion para liquidacion anticipada de un credito.
  *
@@ -22,4 +23,6 @@ export declare class SettlementQuote {
      * omite el campo y la UI debe caer a "solo MXN".
      */
     total_settlement_usd_charge?: number;
+    /** Cotizacion FX usada para `total_settlement_usd_charge`. Ausente si el collector no estuvo disponible. */
+    fx_quote?: FxQuoteSnake;
 }

package/bin/creditEngine/index.d.ts

@@ -17,3 +17,4 @@ export * from './dtos/EarlyPaymentResult';
 export * from './dtos/OfferResult';
 export * from './dtos/SettlementQuote';
 export * from './dtos/AnticipatedPaymentQuote';
+export * from './dtos/FxQuote';

package/bin/creditEngine/index.js

@@ -33,3 +33,4 @@ __exportStar(require("./dtos/EarlyPaymentResult"), exports);
 __exportStar(require("./dtos/OfferResult"), exports);
 __exportStar(require("./dtos/SettlementQuote"), exports);
 __exportStar(require("./dtos/AnticipatedPaymentQuote"), exports);
+__exportStar(require("./dtos/FxQuote"), exports);

package/bin/directory/dtos/DirectoryAgentsBySponsorRequest.d.ts

@@ -0,0 +1,4 @@
+export declare const DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH = 100;
+export declare class DirectoryAgentsBySponsorRequest {
+    sponsorDirectoryIds: string[];
+}

package/bin/directory/dtos/DirectoryAgentsBySponsorRequest.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.DirectoryAgentsBySponsorRequest = exports.DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH = void 0;
+const class_validator_1 = require("class-validator");
+// Tope de sponsorDirectoryIds por request del endpoint batch de directorios AGENT por sponsor.
+exports.DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH = 100;
+// Body de POST /directories/search/by-sponsor-directory-ids; la lista vacía es válida y responde {}.
+class DirectoryAgentsBySponsorRequest {
+}
+exports.DirectoryAgentsBySponsorRequest = DirectoryAgentsBySponsorRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(exports.DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], DirectoryAgentsBySponsorRequest.prototype, "sponsorDirectoryIds", void 0);

package/bin/directory/dtos/DirectoryAgentsBySponsorResponse.d.ts

@@ -0,0 +1,9 @@
+export interface DirectoryAgentBySponsorItem {
+    id: string;
+    sponsorDirectoryId: string;
+    identityId: string | null;
+    email: string | null;
+    status: string;
+    updatedAt: number | null;
+}
+export type DirectoryAgentsBySponsorResponse = Record<string, DirectoryAgentBySponsorItem>;

package/bin/directory/dtos/DirectoryAgentsBySponsorResponse.js

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

package/bin/directory/index.d.ts

@@ -6,6 +6,8 @@ export * from './dtos/DirectoryBackofficeUpdateRequest';
 export * from './dtos/CreateDirectoryUserEventRequest';
 export * from './dtos/CreateDirectoryUserEventResponse';
 export * from './dtos/DeleteByDirectoryResponse';
+export * from './dtos/DirectoryAgentsBySponsorRequest';
+export * from './dtos/DirectoryAgentsBySponsorResponse';
 export * from './dtos/External';
 export * from './enums/TypeOfDirectoryId';
 export * from './enums/DirectoryBackofficeStatusEnum';

package/bin/directory/index.js

@@ -23,6 +23,8 @@ __exportStar(require("./dtos/DirectoryBackofficeUpdateRequest"), exports);
 __exportStar(require("./dtos/CreateDirectoryUserEventRequest"), exports);
 __exportStar(require("./dtos/CreateDirectoryUserEventResponse"), exports);
 __exportStar(require("./dtos/DeleteByDirectoryResponse"), exports);
+__exportStar(require("./dtos/DirectoryAgentsBySponsorRequest"), exports);
+__exportStar(require("./dtos/DirectoryAgentsBySponsorResponse"), exports);
 __exportStar(require("./dtos/External"), exports);
 //enums
 __exportStar(require("./enums/TypeOfDirectoryId"), exports);

package/bin/group/dtos/GroupMemberHubItem.d.ts

@@ -0,0 +1,36 @@
+import { RelationStatus } from "../enums/RelationStatus";
+import { RelationType } from "../enums/RelationType";
+import { CPStatusEnum } from "../../identity/enums/CPStatusEnum";
+import type { TenantUserStatusValue } from "../../platformRbac/dtos/TenantUserResponse";
+export interface GroupMemberHubItem {
+    PK: string;
+    SK: string;
+    directoryId: string;
+    groupId: string;
+    relationType: RelationType;
+    status: RelationStatus;
+    agent: string | null;
+    createdAt: string;
+    updatedAt: string;
+    phoneNumber: string | null;
+    indexName: string | null;
+    peopleId: string | null;
+    referralCode: string | null;
+    myReferralCode: string | null;
+    CP_Status: CPStatusEnum | null;
+    parentGroupId: string | null;
+    operationId: string | null;
+    referralDirectoryId: string | null;
+    promotedToDirectory: boolean | null;
+    isAgent: boolean;
+    agentId: string | null;
+    agentRole: string | null;
+    agentStatus: string | null;
+    position: string | null;
+    reportsToDirectoryId: string | null;
+    reportsToName: string | null;
+    agentDirectoryStatus: string | null;
+    loginEmail: string | null;
+    hasRbac: boolean | null;
+    rbacStatus: TenantUserStatusValue | null;
+}

package/bin/group/dtos/GroupMemberHubItem.js

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

package/bin/group/index.d.ts

@@ -9,3 +9,4 @@ export * from './enums/RelationType';
 export * from './enums/RelationStatus';
 export * from './enums/GroupAction';
 export * from './dtos/GroupCountsResponse';
+export * from './dtos/GroupMemberHubItem';

package/bin/group/index.js

@@ -28,3 +28,4 @@ __exportStar(require("./enums/RelationStatus"), exports);
 __exportStar(require("./enums/GroupAction"), exports);
 //dtos
 __exportStar(require("./dtos/GroupCountsResponse"), exports);
+__exportStar(require("./dtos/GroupMemberHubItem"), exports);

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

@@ -0,0 +1,4 @@
+export declare const TENANT_USERS_BY_SUBS_MAX_BATCH = 100;
+export declare class TenantUsersBySubsRequest {
+    cognitoSubs: string[];
+}

package/bin/platformRbac/dtos/TenantUsersBySubsRequest.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.TenantUsersBySubsRequest = exports.TENANT_USERS_BY_SUBS_MAX_BATCH = void 0;
+const class_validator_1 = require("class-validator");
+// Tope de cognitoSubs por request del endpoint batch de usuarios del tenant.
+exports.TENANT_USERS_BY_SUBS_MAX_BATCH = 100;
+// Body de POST /internal/tenants/{tenantId}/users/by-subs; la lista vacía es válida y responde {}.
+class TenantUsersBySubsRequest {
+}
+exports.TenantUsersBySubsRequest = TenantUsersBySubsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(exports.TENANT_USERS_BY_SUBS_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], TenantUsersBySubsRequest.prototype, "cognitoSubs", void 0);

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

@@ -0,0 +1,8 @@
+import type { TenantUserStatusValue } from './TenantUserResponse';
+export interface TenantUserBySubItem {
+    cognitoSub: string;
+    email: string | null;
+    status: TenantUserStatusValue;
+    displayName: string | null;
+}
+export type TenantUsersBySubsResponse = Record<string, TenantUserBySubItem>;

package/bin/platformRbac/dtos/TenantUsersBySubsResponse.js

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

package/bin/platformRbac/index.d.ts

@@ -84,3 +84,5 @@ export * from './dtos/AssignTenantRoleRequest';
 export type { AssignTenantRoleResponse } from './dtos/AssignTenantRoleResponse';
 export * from './dtos/RevokeTenantRoleRequest';
 export type { RevokeTenantRoleResponse } from './dtos/RevokeTenantRoleResponse';
+export * from './dtos/TenantUsersBySubsRequest';
+export type { TenantUserBySubItem, TenantUsersBySubsResponse } from './dtos/TenantUsersBySubsResponse';

package/bin/platformRbac/index.js

@@ -125,3 +125,5 @@ __exportStar(require("./dtos/ResetTenantUserPasswordRequest"), exports);
 __exportStar(require("./dtos/ResetTenantUserMfaRequest"), exports);
 __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);

package/bin/referral-business/dtos/AgentsByDirectoryIdsRequest.d.ts

@@ -0,0 +1,4 @@
+export declare const AGENTS_BY_DIRECTORY_IDS_MAX_BATCH = 100;
+export declare class AgentsByDirectoryIdsRequest {
+    directoryIds: string[];
+}

package/bin/referral-business/dtos/AgentsByDirectoryIdsRequest.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.AgentsByDirectoryIdsRequest = exports.AGENTS_BY_DIRECTORY_IDS_MAX_BATCH = void 0;
+const class_validator_1 = require("class-validator");
+// Tope de directoryIds por request del endpoint batch de agentes por directorio.
+exports.AGENTS_BY_DIRECTORY_IDS_MAX_BATCH = 100;
+// Body de POST /private/agents/by-directory-ids; la lista vacía es válida y responde {}.
+class AgentsByDirectoryIdsRequest {
+}
+exports.AgentsByDirectoryIdsRequest = AgentsByDirectoryIdsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(exports.AGENTS_BY_DIRECTORY_IDS_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], AgentsByDirectoryIdsRequest.prototype, "directoryIds", void 0);

package/bin/referral-business/dtos/AgentsByDirectoryIdsResponse.d.ts

@@ -0,0 +1,11 @@
+export interface AgentByDirectoryIdItem {
+    id: string;
+    directoryId: string;
+    groupId: string | null;
+    agentRole: string | null;
+    notes: string | null;
+    parentDirectoryId: string | null;
+    status: string;
+    updatedAt: number | null;
+}
+export type AgentsByDirectoryIdsResponse = Record<string, AgentByDirectoryIdItem>;

package/bin/referral-business/dtos/AgentsByDirectoryIdsResponse.js

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

package/bin/referral-business/index.d.ts

@@ -1 +1,3 @@
 export * from './enums/AgentRoleEnum';
+export * from './dtos/AgentsByDirectoryIdsRequest';
+export * from './dtos/AgentsByDirectoryIdsResponse';

package/bin/referral-business/index.js

@@ -16,3 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 //Enums
 __exportStar(require("./enums/AgentRoleEnum"), exports);
+//dtos
+__exportStar(require("./dtos/AgentsByDirectoryIdsRequest"), exports);
+__exportStar(require("./dtos/AgentsByDirectoryIdsResponse"), exports);

package/package.json

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

package/src/credit/dtos/BannerStateResponse.ts

@@ -25,13 +25,19 @@ export class BannerStateResponse {
     credit_id?: string | null;
     /** Pago del proximo cupon pendiente. */
     next_payment_amount_mxn?: number | null;
+    /** USD real que cobrará el collector por next_payment_amount_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    next_payment_amount_usd_charge?: number;
     next_payment_date?: string | null;
     next_coupon_number?: number | null;
     /** Montos de cupones vencidos (solo DELINQUENT). */
     overdue_amount_mxn?: number | null;
+    /** USD real que cobrará el collector por overdue_amount_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    overdue_amount_usd_charge?: number;
     overdue_count?: number | null;
     /** Saldo insoluto del credito activo. */
     outstanding_balance_mxn?: number | null;
+    /** USD real que cobrará el collector por outstanding_balance_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    outstanding_balance_usd_charge?: number;
     /**
      * Cantidad total de creditos que el directoryId ha tenido en Credits_GT
      * (incluye ACTIVE, PAID_OFF, DEFAULTED — todos los estados historicos).

package/src/credit/dtos/CreditOfferOptionItem.ts

@@ -5,7 +5,11 @@ export class CreditOfferOptionItem {
     term_weeks: number;
     annual_rate: number;
     weekly_payment_mxn: number;
+    /** USD real que cobrará el collector por weekly_payment_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    weekly_payment_usd_charge?: number;
     total_to_pay_mxn: number;
+    /** USD real que cobrará el collector por total_to_pay_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    total_to_pay_usd_charge?: number;
     total_interest_mxn: number;
     savings_vs_longest: number;
     is_recommended: boolean;
@@ -17,6 +21,8 @@ export class CreditOfferOptionItem {
     first_payment_date?: string;
     /** Monto solicitado por el cliente (lo que recibe). */
     requested_amount_mxn?: number;
+    /** USD real que cobrará el collector por requested_amount_mxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    requested_amount_usd_charge?: number;
     /** Principal financiado (amount + fee + fee_iva si financed). */
     financed_amount_mxn?: number;
     /** Comision por apertura como fraccion (ej. 0.05 = 5%). */

package/src/creditEngine/dtos/AnticipatedPaymentQuote.ts

@@ -1,4 +1,5 @@
 import { PaymentScheduleItemResponse } from "./PaymentScheduleItemResponse";
+import { FxQuote } from "./FxQuote";
 
 /**
  * Preview / cotizacion de un abono a capital (ANTICIPATED) antes de ejecutarlo.
@@ -16,6 +17,9 @@ export class AnticipatedPaymentQuote {
     /** Monto que el usuario propuso, capeado al outstanding real del credito. */
     amountMxn!: number;
 
+    /** USD real que cobrará el collector por amountMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    amountUsdCharge?: number;
+
     /** Estado actual (as-is) del credito, antes de aplicar el abono. */
     current!: AnticipatedPaymentSummary;
 
@@ -35,11 +39,16 @@ export class AnticipatedPaymentQuote {
 
     /** ISO timestamp de la cotizacion. */
     quoteDate!: string;
+
+    /** Cotizacion FX usada para los campos `*UsdCharge` (incluye los de `newSchedule`). Ausente si el collector no estuvo disponible. */
+    fxQuote?: FxQuote;
 }
 
 export class AnticipatedPaymentSummary {
     /** Cuota semanal vigente. */
     weeklyPaymentMxn!: number;
+    /** USD real que cobrará el collector por weeklyPaymentMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    weeklyPaymentUsdCharge?: number;
     /** Saldo insoluto (capital pendiente). */
     outstandingMxn!: number;
     /** Cupones que aun no estan PAID (incluye PARTIAL). */

package/src/creditEngine/dtos/CreditDetailResponse.ts

@@ -1,3 +1,4 @@
+import { FxQuote } from "./FxQuote";
 
 /**
  * Response con el detalle completo de un credito LOAN.
@@ -10,11 +11,15 @@ export class CreditDetailResponse {
     termWeeks?: number;
     annualRate?: number;
     weeklyPaymentMxn?: number;
+    /** USD real que cobrará el collector por weeklyPaymentMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    weeklyPaymentUsdCharge?: number;
     status?: string;
     nextPaymentDate?: string;
     paidCoupons?: number;
     totalCoupons?: number;
     remainingBalanceMxn?: number;
+    /** USD real que cobrará el collector por remainingBalanceMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    remainingBalanceUsdCharge?: number;
     cat?: number | null;
     totalInterestMxn?: number;
     totalIvaMxn?: number;
@@ -25,8 +30,16 @@ export class CreditDetailResponse {
     firstPaymentDate?: string | null;
     lastPaymentDate?: string | null;
     nextPaymentAmountMxn?: number | null;
+    /** USD real que cobrará el collector por nextPaymentAmountMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    nextPaymentAmountUsdCharge?: number;
     nextCouponNumber?: number | null;
     totalPaidMxn?: number;
+    /** USD real que cobrará el collector por totalPaidMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    totalPaidUsdCharge?: number;
     overdueCount?: number;
     overdueAmountMxn?: number;
+    /** USD real que cobrará el collector por overdueAmountMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    overdueAmountUsdCharge?: number;
+    /** Cotizacion FX usada para los campos `*UsdCharge`. Ausente si el collector no estuvo disponible. */
+    fxQuote?: FxQuote;
 }

package/src/creditEngine/dtos/FxQuote.ts

@@ -0,0 +1,34 @@
+/**
+ * Tipo de cambio y factor que el collector aplicara al cobro en USD.
+ *
+ * Es la cotizacion vigente al momento de armar la respuesta: con ella el
+ * collector convierte cada monto MXN al USD real que descuenta del pocket
+ * (comision + IVA + TC ajustado). Viaja junto a los campos `<x>UsdCharge`
+ * para que el frontend pueda explicar el numero, no para recalcularlo.
+ * Ausente si el collector no estuvo disponible.
+ */
+export class FxQuote {
+    /** TC MXN por USD publicado, sin ajuste. */
+    exchangeRate!: number;
+    /** TC MXN por USD ajustado con el colchon del collector; es el divisor real del cobro. */
+    adjustmentRate!: number;
+    /** Factor multiplicativo sobre el MXN nocional (comision + IVA). */
+    totalFactor!: number;
+    /** Momento de la cotizacion, ISO 8601. */
+    quotedAt!: string;
+}
+
+/**
+ * Gemelo snake_case de `FxQuote` para los DTOs contenedores que ya son
+ * snake_case (`SettlementQuote`, `OfferResult`). Misma semantica campo a campo.
+ */
+export class FxQuoteSnake {
+    /** TC MXN por USD publicado, sin ajuste. */
+    exchange_rate!: number;
+    /** TC MXN por USD ajustado con el colchon del collector; es el divisor real del cobro. */
+    adjustment_rate!: number;
+    /** Factor multiplicativo sobre el MXN nocional (comision + IVA). */
+    total_factor!: number;
+    /** Momento de la cotizacion, ISO 8601. */
+    quoted_at!: string;
+}

package/src/creditEngine/dtos/OfferResult.ts

@@ -1,3 +1,5 @@
+import { FxQuoteSnake } from "./FxQuote";
+
 /**
  * Respuesta del endpoint de generación de oferta: lista de tasas disponibles
  * para el usuario, plus los parámetros de la comisión por apertura.
@@ -19,4 +21,6 @@ export class OfferResult {
     opening_fee_pct?: number;
     /** True si la comisión se financia (se suma al principal y se amortiza); false si se cobra al desembolso. */
     opening_fee_financed?: boolean;
+    /** Cotizacion FX vigente al generar la oferta, para los `*_usd_charge` que el frontend proyecte sobre ella. Ausente si el collector no estuvo disponible. */
+    fx_quote?: FxQuoteSnake;
 }

package/src/creditEngine/dtos/PaymentScheduleItemResponse.ts

@@ -9,6 +9,10 @@ export class PaymentScheduleItemResponse {
     interestMxn?: number;
     ivaMxn?: number;
     totalMxn?: number;
+    /** USD real que cobrará el collector por totalMxn (comisión + IVA + TC ajustado). Ausente si el collector no estuvo disponible. */
+    totalUsdCharge?: number;
+    /** True si totalUsdCharge queda por debajo del minimo cobrable del collector. Solo viene cuando aplica. */
+    totalBelowMinimum?: boolean;
     status?: string;
     paidAmountMxn!: number;
     remainingBalanceMxn?: number;

package/src/creditEngine/dtos/SettlementQuote.ts

@@ -1,3 +1,5 @@
+import { FxQuoteSnake } from "./FxQuote";
+
 /**
  * Cotizacion para liquidacion anticipada de un credito.
  *
@@ -22,4 +24,6 @@ export class SettlementQuote {
      * omite el campo y la UI debe caer a "solo MXN".
      */
     total_settlement_usd_charge?: number;
+    /** Cotizacion FX usada para `total_settlement_usd_charge`. Ausente si el collector no estuvo disponible. */
+    fx_quote?: FxQuoteSnake;
 }

package/src/creditEngine/index.ts

@@ -19,3 +19,4 @@ export * from './dtos/EarlyPaymentResult';
 export * from './dtos/OfferResult';
 export * from './dtos/SettlementQuote';
 export * from './dtos/AnticipatedPaymentQuote';
+export * from './dtos/FxQuote';

package/src/directory/dtos/DirectoryAgentsBySponsorRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de sponsorDirectoryIds por request del endpoint batch de directorios AGENT por sponsor.
+export const DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH = 100;
+
+// Body de POST /directories/search/by-sponsor-directory-ids; la lista vacía es válida y responde {}.
+export class DirectoryAgentsBySponsorRequest {
+    @IsArray()
+    @ArrayMaxSize(DIRECTORY_AGENTS_BY_SPONSOR_MAX_BATCH)
+    @IsString({ each: true })
+    sponsorDirectoryIds!: string[];
+}

package/src/directory/dtos/DirectoryAgentsBySponsorResponse.ts

@@ -0,0 +1,12 @@
+// Directorio AGENT ganador de un sponsor: excluye DELETE, ACTIVE gana y luego el updatedAt más reciente.
+export interface DirectoryAgentBySponsorItem {
+    id: string;
+    sponsorDirectoryId: string;
+    identityId: string | null;
+    email: string | null;
+    status: string;
+    updatedAt: number | null;
+}
+
+// Respuesta de POST /directories/search/by-sponsor-directory-ids; un sponsor sin agente no aparece.
+export type DirectoryAgentsBySponsorResponse = Record<string, DirectoryAgentBySponsorItem>;

package/src/directory/index.ts

@@ -8,6 +8,8 @@ export * from './dtos/DirectoryBackofficeUpdateRequest';
 export * from './dtos/CreateDirectoryUserEventRequest';
 export * from './dtos/CreateDirectoryUserEventResponse';
 export * from './dtos/DeleteByDirectoryResponse';
+export * from './dtos/DirectoryAgentsBySponsorRequest';
+export * from './dtos/DirectoryAgentsBySponsorResponse';
 
 export * from './dtos/External';
 

package/src/group/dtos/GroupMemberHubItem.ts

@@ -0,0 +1,40 @@
+import { RelationStatus } from "../enums/RelationStatus";
+import { RelationType } from "../enums/RelationType";
+import { CPStatusEnum } from "../../identity/enums/CPStatusEnum";
+import type { TenantUserStatusValue } from "../../platformRbac/dtos/TenantUserResponse";
+
+// Fila de GET /backoffice/members por groupIds: membresía + directorio, people, onboarding, agente y RBAC.
+// Las columnas de una fuente que falló o no aplica salen en null (enriquecimiento best-effort).
+export interface GroupMemberHubItem {
+    PK: string;
+    SK: string;
+    directoryId: string;
+    groupId: string;
+    relationType: RelationType;
+    status: RelationStatus;
+    agent: string | null;
+    createdAt: string;
+    updatedAt: string;
+    phoneNumber: string | null;
+    indexName: string | null;
+    peopleId: string | null;
+    referralCode: string | null;
+    myReferralCode: string | null;
+    CP_Status: CPStatusEnum | null;
+    parentGroupId: string | null;
+    operationId: string | null;
+    referralDirectoryId: string | null;
+    promotedToDirectory: boolean | null;
+    isAgent: boolean;
+    agentId: string | null;
+    agentRole: string | null;
+    agentStatus: string | null;
+    position: string | null;
+    reportsToDirectoryId: string | null;
+    reportsToName: string | null;
+    agentDirectoryStatus: string | null;
+    loginEmail: string | null;
+    // null = la fuente RBAC o la de directorios AGENT falló; false = respondió y no hay usuario.
+    hasRbac: boolean | null;
+    rbacStatus: TenantUserStatusValue | null;
+}

package/src/group/index.ts

@@ -19,3 +19,4 @@ export * from './enums/GroupAction';
 
 //dtos
 export * from './dtos/GroupCountsResponse';
+export * from './dtos/GroupMemberHubItem';

package/src/platformRbac/dtos/TenantUsersBySubsRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de cognitoSubs por request del endpoint batch de usuarios del tenant.
+export const TENANT_USERS_BY_SUBS_MAX_BATCH = 100;
+
+// Body de POST /internal/tenants/{tenantId}/users/by-subs; la lista vacía es válida y responde {}.
+export class TenantUsersBySubsRequest {
+    @IsArray()
+    @ArrayMaxSize(TENANT_USERS_BY_SUBS_MAX_BATCH)
+    @IsString({ each: true })
+    cognitoSubs!: string[];
+}

package/src/platformRbac/dtos/TenantUsersBySubsResponse.ts

@@ -0,0 +1,12 @@
+import type { TenantUserStatusValue } from './TenantUserResponse';
+
+// Usuario del tenant (SharedUser) sin roles; email nulo en tenants phone-primary sin correo.
+export interface TenantUserBySubItem {
+    cognitoSub: string;
+    email: string | null;
+    status: TenantUserStatusValue;
+    displayName: string | null;
+}
+
+// Respuesta de POST /internal/tenants/{tenantId}/users/by-subs; un sub inexistente o de otro tenant no aparece.
+export type TenantUsersBySubsResponse = Record<string, TenantUserBySubItem>;

package/src/platformRbac/index.ts

@@ -178,3 +178,7 @@ export * from './dtos/AssignTenantRoleRequest';
 export type { AssignTenantRoleResponse } from './dtos/AssignTenantRoleResponse';
 export * from './dtos/RevokeTenantRoleRequest';
 export type { RevokeTenantRoleResponse } from './dtos/RevokeTenantRoleResponse';
+
+// Batch privado de usuarios del tenant por cognitoSub (hub de miembros de group-business).
+export * from './dtos/TenantUsersBySubsRequest';
+export type { TenantUserBySubItem, TenantUsersBySubsResponse } from './dtos/TenantUsersBySubsResponse';

package/src/referral-business/dtos/AgentsByDirectoryIdsRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de directoryIds por request del endpoint batch de agentes por directorio.
+export const AGENTS_BY_DIRECTORY_IDS_MAX_BATCH = 100;
+
+// Body de POST /private/agents/by-directory-ids; la lista vacía es válida y responde {}.
+export class AgentsByDirectoryIdsRequest {
+    @IsArray()
+    @ArrayMaxSize(AGENTS_BY_DIRECTORY_IDS_MAX_BATCH)
+    @IsString({ each: true })
+    directoryIds!: string[];
+}

package/src/referral-business/dtos/AgentsByDirectoryIdsResponse.ts

@@ -0,0 +1,14 @@
+// Fila ganadora de Agents_GT de un directorio: excluye DELETE, ACTIVE gana y luego el updatedAt más reciente.
+export interface AgentByDirectoryIdItem {
+    id: string;
+    directoryId: string;
+    groupId: string | null;
+    agentRole: string | null;
+    notes: string | null;
+    parentDirectoryId: string | null;
+    status: string;
+    updatedAt: number | null;
+}
+
+// Respuesta de POST /private/agents/by-directory-ids; un directorio sin agente no aparece.
+export type AgentsByDirectoryIdsResponse = Record<string, AgentByDirectoryIdItem>;

package/src/referral-business/index.ts

@@ -1,2 +1,6 @@
 //Enums
-export * from './enums/AgentRoleEnum';
+export * from './enums/AgentRoleEnum';
+
+//dtos
+export * from './dtos/AgentsByDirectoryIdsRequest';
+export * from './dtos/AgentsByDirectoryIdsResponse';