@fiado/api-invoker 5.149.0 → 5.150.0

package/bin/container.config.js

@@ -79,6 +79,7 @@ import ReportProcessorBusinessApi from "./report-processor-business/api/ReportPr
 import NotificationWSMessagePublisher from "./notificationWebsockets/queue/NotificationWSMessagePublisher.js";
 import PeopleBusinessApi from "./people-business/api/PeopleBusinessApi.js";
 import DatalakeReportsApi from "./datalake-reports-business/api/DatalakeReportsApi.js";
+import MeetingConnectorApi from "./meeting-connector/api/MeetingConnectorApi.js";
 import PlacesBusinessApi from "./places-business/api/PlacesBusinessApi.js";
 import STPBusinessApi from "./stp-business/api/STPBusinessApi.js";
 import MulticommServicePaymentApi from "./multicommServicePayment/api/MulticommServicePaymentApi.js";
@@ -237,6 +238,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IReportProcessorBusinessApi").to(ReportProcessorBusinessApi);
     bind("IPeopleBusinessApi").to(PeopleBusinessApi);
     bind("IDatalakeReportsApi").to(DatalakeReportsApi);
+    bind("IMeetingConnectorApi").to(MeetingConnectorApi);
     bind("IPlacesBusinessApi").to(PlacesBusinessApi);
     bind("ISTPBusinessApi").to(STPBusinessApi);
     bind("IProductPaymentApi").to(ProductPaymentApi);

package/bin/index.d.ts

@@ -69,6 +69,7 @@ export * from "./report-processor-business/index.js";
 export * from "./notificationWebsockets/index.js";
 export * from "./people-business/index.js";
 export * from "./datalake-reports-business/index.js";
+export * from "./meeting-connector/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";

package/bin/index.js

@@ -69,6 +69,7 @@ export * from "./report-processor-business/index.js";
 export * from "./notificationWebsockets/index.js";
 export * from "./people-business/index.js";
 export * from "./datalake-reports-business/index.js";
+export * from "./meeting-connector/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";

package/bin/meeting-connector/api/MeetingConnectorApi.d.ts

@@ -0,0 +1,14 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import type { IMeetingConnectorApi, MeetingConnectorCreated, MeetingConnectorCreateRequest, MeetingConnectorHost, MeetingConnectorParticipant, MeetingConnectorPollAnswer, MeetingConnectorRegistrant } from "./interfaces/IMeetingConnectorApi.js";
+export default class MeetingConnectorApi implements IMeetingConnectorApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    getHosts(): Promise<MeetingConnectorHost[]>;
+    createMeeting(request: MeetingConnectorCreateRequest): Promise<MeetingConnectorCreated>;
+    getStartUrl(externalMeetingId: string): Promise<string>;
+    getRegistrant(externalMeetingId: string, registrantId: string): Promise<MeetingConnectorRegistrant | undefined>;
+    /** El uuid de una sesión puede traer '/' o '=': va codificado (el connector lo decodifica una vez). */
+    getSessionParticipants(sessionId: string): Promise<MeetingConnectorParticipant[]>;
+    getSessionPolls(sessionId: string): Promise<MeetingConnectorPollAnswer[] | undefined>;
+}

package/bin/meeting-connector/api/MeetingConnectorApi.js

@@ -0,0 +1,55 @@
+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";
+const datoDe = (sobre) => (sobre && typeof sobre === "object" && "data" in sobre ? sobre.data : sobre);
+let MeetingConnectorApi = class MeetingConnectorApi {
+    httpRequest;
+    baseUrl = process.env.MEETING_CONNECTOR_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async getHosts() {
+        const r = await this.httpRequest.get(`${this.baseUrl}hosts`);
+        return datoDe(r)?.items ?? [];
+    }
+    async createMeeting(request) {
+        const r = await this.httpRequest.post(`${this.baseUrl}meetings`, request);
+        return datoDe(r);
+    }
+    async getStartUrl(externalMeetingId) {
+        const r = await this.httpRequest.get(`${this.baseUrl}meetings/${encodeURIComponent(externalMeetingId)}/start-url`);
+        return datoDe(r)?.startUrl ?? "";
+    }
+    async getRegistrant(externalMeetingId, registrantId) {
+        const r = await this.httpRequest.get(`${this.baseUrl}meetings/${encodeURIComponent(externalMeetingId)}/registrants/${encodeURIComponent(registrantId)}`);
+        return datoDe(r) ?? undefined;
+    }
+    /** El uuid de una sesión puede traer '/' o '=': va codificado (el connector lo decodifica una vez). */
+    async getSessionParticipants(sessionId) {
+        const r = await this.httpRequest.get(`${this.baseUrl}sessions/${encodeURIComponent(encodeURIComponent(sessionId))}/participants`);
+        return datoDe(r)?.items ?? [];
+    }
+    async getSessionPolls(sessionId) {
+        const r = await this.httpRequest.get(`${this.baseUrl}sessions/${encodeURIComponent(encodeURIComponent(sessionId))}/polls`);
+        const datos = datoDe(r);
+        if (!datos || datos.ready === false)
+            return undefined;
+        return datos.items ?? [];
+    }
+};
+MeetingConnectorApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], MeetingConnectorApi);
+export default MeetingConnectorApi;

package/bin/meeting-connector/api/interfaces/IMeetingConnectorApi.d.ts

@@ -0,0 +1,83 @@
+/**
+ * El contrato agnóstico de meeting-connector (la envoltura del proveedor de reuniones; hoy Zoom,
+ * Teams después): nada acá nombra al proveedor. Lo consume meetings-business.
+ */
+export type MeetingConnectorHost = {
+    email: string;
+    name?: string;
+    licensed: boolean;
+};
+export type MeetingConnectorCreateRequest = {
+    hostEmail: string;
+    title: string;
+    agenda?: string;
+    startsAt: string;
+    durationMinutes: number;
+    timezone: string;
+    registrationRequired: boolean;
+    phoneRequired: boolean;
+    registrationQuestions?: Array<{
+        ref: string;
+        text: string;
+        required?: boolean;
+        dataType?: string;
+    }>;
+    polls?: Array<{
+        title: string;
+        questions: Array<{
+            ref: string;
+            text: string;
+            type: string;
+            options?: string[];
+        }>;
+    }>;
+};
+export type MeetingConnectorCreated = {
+    externalMeetingId: string;
+    registrationUrl?: string;
+    joinUrl?: string;
+    polls?: Array<{
+        title: string;
+        externalPollId: string;
+    }>;
+};
+export type MeetingConnectorParticipant = {
+    participantId: string;
+    registrantId?: string;
+    name?: string;
+    email?: string;
+    joinedAt: string;
+    leftAt?: string;
+    durationSeconds?: number;
+};
+export type MeetingConnectorPollAnswer = {
+    name?: string;
+    email?: string;
+    answers: Array<{
+        question: string;
+        answer: string;
+        externalPollId?: string;
+        respondedAt?: string;
+    }>;
+};
+export type MeetingConnectorRegistrant = {
+    registrantId: string;
+    name?: string;
+    email?: string;
+    phoneNumber?: string;
+    answers?: Array<{
+        question: string;
+        answer: string;
+    }>;
+};
+export interface IMeetingConnectorApi {
+    getHosts(): Promise<MeetingConnectorHost[]>;
+    /** Si algo falla en la plataforma, el connector borra y no queda nada a medias. */
+    createMeeting(request: MeetingConnectorCreateRequest): Promise<MeetingConnectorCreated>;
+    /** El link del anfitrión vence a las 2 horas: se pide uno nuevo cada vez. */
+    getStartUrl(externalMeetingId: string): Promise<string>;
+    getRegistrant(externalMeetingId: string, registrantId: string): Promise<MeetingConnectorRegistrant | undefined>;
+    getSessionParticipants(sessionId: string): Promise<MeetingConnectorParticipant[]>;
+    /** undefined = la plataforma todavía no los tiene listos: reintentar después. */
+    getSessionPolls(sessionId: string): Promise<MeetingConnectorPollAnswer[] | undefined>;
+}

package/bin/meeting-connector/api/interfaces/IMeetingConnectorApi.js

@@ -0,0 +1,5 @@
+/**
+ * El contrato agnóstico de meeting-connector (la envoltura del proveedor de reuniones; hoy Zoom,
+ * Teams después): nada acá nombra al proveedor. Lo consume meetings-business.
+ */
+export {};

package/bin/meeting-connector/index.d.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IMeetingConnectorApi.js';
+export { default as MeetingConnectorApi } from './api/MeetingConnectorApi.js';

package/bin/meeting-connector/index.js

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IMeetingConnectorApi.js';
+export { default as MeetingConnectorApi } from './api/MeetingConnectorApi.js';

package/bin/onboarding-business/api/OnboardingBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import type { IHttpRequest } from "@fiado/http-client";
-import type { IOnboardingBusinessApi } from "./interfaces/IOnboardingBusinessApi.js";
+import type { IOnboardingBusinessApi, OnboardingAssignTagParams, OnboardingTagSubject } from "./interfaces/IOnboardingBusinessApi.js";
 export default class OnboardingBusinessApi implements IOnboardingBusinessApi {
     private httpRequest;
     private readonly baseUrl;
@@ -25,13 +25,11 @@ export default class OnboardingBusinessApi implements IOnboardingBusinessApi {
         pageSize?: string;
     }): Promise<any>;
     getBatchByIds(ids: string[]): Promise<any>;
-    tagsSummary(): Promise<any>;
-    tagsByDirectories(directoryIds: string[]): Promise<any>;
-    getUsersByTag(tag: string, pageSize?: number, index?: string): Promise<any>;
-    assignTag(params: {
-        directoryId: string;
-        tag: string;
-    }): Promise<any>;
+    tagsSummary(subject?: OnboardingTagSubject): Promise<any>;
+    tagsByDirectories(directoryIds: string[], subject?: OnboardingTagSubject): Promise<any>;
+    getUsersByTag(tag: string, pageSize?: number, index?: string, subject?: OnboardingTagSubject): Promise<any>;
+    removeTag(id: string, subject?: OnboardingTagSubject): Promise<any>;
+    assignTag(params: OnboardingAssignTagParams): Promise<any>;
     issuanceReadiness(params: {
         directoryId: string;
         side: string;

package/bin/onboarding-business/api/OnboardingBusinessApi.js

@@ -93,25 +93,35 @@ let OnboardingBusinessApi = class OnboardingBusinessApi {
         const url = `${this.baseUrl}private/getBatchByIds`;
         return await this.httpRequest.get(`${url}`, { ids });
     }
-    async tagsSummary() {
-        const url = `${this.baseUrl}private/tags/summary`;
+    async tagsSummary(subject) {
+        const url = `${this.baseUrl}private/tags/summary${subject ? `?subject=${subject}` : ''}`;
         return await this.httpRequest.get(`${url}`);
     }
-    async tagsByDirectories(directoryIds) {
+    async tagsByDirectories(directoryIds, subject) {
         const url = `${this.baseUrl}private/tags/by-directories`;
-        return await this.httpRequest.post(`${url}`, { directoryIds });
+        const body = subject === 'lead' ? { subject, leadIds: directoryIds } : { directoryIds };
+        return await this.httpRequest.post(`${url}`, body);
     }
-    async getUsersByTag(tag, pageSize = 200, index) {
+    async getUsersByTag(tag, pageSize = 200, index, subject) {
         const queryParams = [`pageSize=${pageSize}`];
         if (index) {
             queryParams.push(`index=${encodeURIComponent(index)}`);
         }
+        if (subject) {
+            queryParams.push(`subject=${subject}`);
+        }
         const url = `${this.baseUrl}private/tags/${encodeURIComponent(tag)}/users?${queryParams.join('&')}`;
         return await this.httpRequest.get(`${url}`);
     }
+    async removeTag(id, subject) {
+        const url = `${this.baseUrl}private/tags/${encodeURIComponent(id)}${subject ? `?subject=${subject}` : ''}`;
+        return await this.httpRequest.delete(`${url}`);
+    }
     async assignTag(params) {
         const url = `${this.baseUrl}private/tags`;
-        return await this.httpRequest.post(`${url}`, { directoryId: params.directoryId, tag: params.tag });
+        // Sólo viajan los campos presentes: sin subject el cuerpo es el de siempre, { directoryId, tag }.
+        const body = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== undefined));
+        return await this.httpRequest.post(`${url}`, body);
     }
     //**
     // Function: issuanceReadiness

package/bin/onboarding-business/api/interfaces/IOnboardingBusinessApi.d.ts

@@ -1,3 +1,19 @@
+/**
+ * A quién se le pone la etiqueta: `user` (UserTags_GT, por directoryId) es el default de siempre;
+ * `lead` (LeadTags_GT, por leadId) es de los leads de meetings-business.
+ */
+export type OnboardingTagSubject = "user" | "lead";
+/** Con `subject` lead van `leadId`, `phoneNumber` y quién la puso; sin subject, `directoryId` como siempre. */
+export interface OnboardingAssignTagParams {
+    subject?: OnboardingTagSubject;
+    directoryId?: string;
+    leadId?: string;
+    tag: string;
+    phoneNumber?: string;
+    source?: "RULE" | "MANUAL";
+    meetingId?: string;
+    addedBy?: string;
+}
 export interface IOnboardingBusinessApi {
     getById(id: string): Promise<any>;
     getByPhoneNumber(phoneNumber: string): Promise<any>;
@@ -20,8 +36,8 @@ export interface IOnboardingBusinessApi {
         pageSize?: string;
     }): Promise<any>;
     getBatchByIds(ids: string[]): Promise<any>;
-    /** Dashboard Ops Segmentos — tags distintos + count c/u (TagsSummaryResponse en data). */
-    tagsSummary(): Promise<any>;
+    /** Dashboard Ops Segmentos — tags distintos + count c/u (TagsSummaryResponse en data). Con `lead`, los de los leads. */
+    tagsSummary(subject?: OnboardingTagSubject): Promise<any>;
     /** Dashboard Ops Segmentos — tags por usuario para un batch de directoryIds (TagsByDirectoriesResponse en data). */
     /**
      * Directorios que tienen un tag, paginado.
@@ -32,13 +48,13 @@ export interface IOnboardingBusinessApi {
      * Es el inverso de `tagsByDirectories` (ese da los tags DE unos directorios; éste da
      * los directorios CON un tag). Consumido por `direct-deposit-export-business`.
      */
-    getUsersByTag(tag: string, pageSize?: number, index?: string): Promise<any>;
-    tagsByDirectories(directoryIds: string[]): Promise<any>;
-    /** Asigna un tag a un directoryId. Idempotente: si ya estaba responde 200 con alreadyAssigned true. */
-    assignTag(params: {
-        directoryId: string;
-        tag: string;
-    }): Promise<any>;
+    getUsersByTag(tag: string, pageSize?: number, index?: string, subject?: OnboardingTagSubject): Promise<any>;
+    /** Con `lead`, `directoryIds` son leadIds y viajan como `leadIds`. */
+    tagsByDirectories(directoryIds: string[], subject?: OnboardingTagSubject): Promise<any>;
+    /** Asigna un tag a un directoryId (o a un lead con `subject` lead). Idempotente: si ya estaba responde 200 con alreadyAssigned true. */
+    assignTag(params: OnboardingAssignTagParams): Promise<any>;
+    /** Quita un tag por su id compuesto (`${directoryId}-${tag}`, o `${leadId}-${tag}` con `subject` lead). Idempotente. */
+    removeTag(id: string, subject?: OnboardingTagSubject): Promise<any>;
     /**
      * ¿Este expediente cumple los requisitos para emitir el lado indicado?
      *

package/bin/usmarketgrowth-business/UsMarketGrowthBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import type { IHttpRequest } from "@fiado/http-client";
-import type { PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
+import type { CreatePromoterFromLeadRequest, PostPromoterFromLeadResponse, PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
 import { IUsMarketGrowthBusinessApi } from "./interfaces/IUsMarketGrowthBusinessApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 export declare class UsMarketGrowthBusinessApi implements IUsMarketGrowthBusinessApi {
@@ -7,5 +7,6 @@ export declare class UsMarketGrowthBusinessApi implements IUsMarketGrowthBusines
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     getPromoterByDirectoryId(directoryId: string): Promise<FiadoApiResponse<PromoterByDirectoryIdResponse>>;
+    createPromoterFromLead(request: CreatePromoterFromLeadRequest): Promise<FiadoApiResponse<PostPromoterFromLeadResponse>>;
 }
 export {};

package/bin/usmarketgrowth-business/UsMarketGrowthBusinessApi.js

@@ -24,6 +24,10 @@ let UsMarketGrowthBusinessApi = class UsMarketGrowthBusinessApi {
         const url = joinUrl(this.baseUrl, `private/promoters/directoryId/${encodeURIComponent(directoryId)}`);
         return await this.httpRequest.get(url);
     }
+    async createPromoterFromLead(request) {
+        const url = joinUrl(this.baseUrl, "private/promoters/from-lead");
+        return await this.httpRequest.post(url, request);
+    }
 };
 UsMarketGrowthBusinessApi = __decorate([
     injectable(),

package/bin/usmarketgrowth-business/interfaces/IUsMarketGrowthBusinessApi.d.ts

@@ -1,5 +1,5 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-import type { PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
+import type { CreatePromoterFromLeadRequest, PostPromoterFromLeadResponse, PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
 /**
  * Cliente de `usmarketgrowth-business` (promotores de US Market Growth).
  *
@@ -13,5 +13,10 @@ export interface IUsMarketGrowthBusinessApi {
      * @param directoryId ID del directorio.
      */
     getPromoterByDirectoryId(directoryId: string): Promise<FiadoApiResponse<PromoterByDirectoryIdResponse>>;
+    /**
+     * 4.5 del plan de reuniones: promotor a partir de un lead, idempotente por teléfono o correo
+     * (dos llamadas con el mismo contacto devuelven el mismo promoterId; EXISTING no toca nada).
+     */
+    createPromoterFromLead(request: CreatePromoterFromLeadRequest): Promise<FiadoApiResponse<PostPromoterFromLeadResponse>>;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.149.0",
+  "version": "5.150.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",

package/src/container.config.ts

@@ -113,6 +113,8 @@ import { INotificationWSMessagesPublisher } from "./notificationWebsockets/index
 import NotificationWSMessagePublisher from "./notificationWebsockets/queue/NotificationWSMessagePublisher.js";
 import PeopleBusinessApi from "./people-business/api/PeopleBusinessApi.js";
 import DatalakeReportsApi from "./datalake-reports-business/api/DatalakeReportsApi.js";
+import MeetingConnectorApi from "./meeting-connector/api/MeetingConnectorApi.js";
+import { IMeetingConnectorApi } from "./meeting-connector/index.js";
 import { IDatalakeReportsApi } from "./datalake-reports-business/index.js";
 import { IPeopleBusinessApi } from "./people-business/index.js";
 import PlacesBusinessApi from "./places-business/api/PlacesBusinessApi.js";
@@ -311,6 +313,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<IReportProcessorBusinessApi>("IReportProcessorBusinessApi").to(ReportProcessorBusinessApi);
     bind<IPeopleBusinessApi>("IPeopleBusinessApi").to(PeopleBusinessApi);
     bind<IDatalakeReportsApi>("IDatalakeReportsApi").to(DatalakeReportsApi);
+    bind<IMeetingConnectorApi>("IMeetingConnectorApi").to(MeetingConnectorApi);
     bind<IPlacesBusinessApi>("IPlacesBusinessApi").to(PlacesBusinessApi);
     bind<ISTPBusinessApi>("ISTPBusinessApi").to(STPBusinessApi);
     bind<IProductPaymentApi>("IProductPaymentApi").to(ProductPaymentApi);

package/src/index.ts

@@ -69,6 +69,7 @@ export * from "./report-processor-business/index.js";
 export * from "./notificationWebsockets/index.js";
 export * from "./people-business/index.js";
 export * from "./datalake-reports-business/index.js";
+export * from "./meeting-connector/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";

package/src/meeting-connector/api/MeetingConnectorApi.ts

@@ -0,0 +1,51 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import type {
+    IMeetingConnectorApi, MeetingConnectorCreated, MeetingConnectorCreateRequest, MeetingConnectorHost,
+    MeetingConnectorParticipant, MeetingConnectorPollAnswer, MeetingConnectorRegistrant,
+} from "./interfaces/IMeetingConnectorApi.js";
+
+type Sobre<T> = { data: T } | T;
+const datoDe = <T>(sobre: Sobre<T>): T => (sobre && typeof sobre === "object" && "data" in (sobre as object) ? (sobre as { data: T }).data : (sobre as T));
+
+@injectable()
+export default class MeetingConnectorApi implements IMeetingConnectorApi {
+
+    private readonly baseUrl = process.env.MEETING_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async getHosts(): Promise<MeetingConnectorHost[]> {
+        const r = await this.httpRequest.get(`${this.baseUrl}hosts`);
+        return datoDe<{ items: MeetingConnectorHost[] }>(r as never)?.items ?? [];
+    }
+
+    async createMeeting(request: MeetingConnectorCreateRequest): Promise<MeetingConnectorCreated> {
+        const r = await this.httpRequest.post(`${this.baseUrl}meetings`, request);
+        return datoDe<MeetingConnectorCreated>(r as never);
+    }
+
+    async getStartUrl(externalMeetingId: string): Promise<string> {
+        const r = await this.httpRequest.get(`${this.baseUrl}meetings/${encodeURIComponent(externalMeetingId)}/start-url`);
+        return datoDe<{ startUrl: string }>(r as never)?.startUrl ?? "";
+    }
+
+    async getRegistrant(externalMeetingId: string, registrantId: string): Promise<MeetingConnectorRegistrant | undefined> {
+        const r = await this.httpRequest.get(`${this.baseUrl}meetings/${encodeURIComponent(externalMeetingId)}/registrants/${encodeURIComponent(registrantId)}`);
+        return datoDe<MeetingConnectorRegistrant | undefined>(r as never) ?? undefined;
+    }
+
+    /** El uuid de una sesión puede traer '/' o '=': va codificado (el connector lo decodifica una vez). */
+    async getSessionParticipants(sessionId: string): Promise<MeetingConnectorParticipant[]> {
+        const r = await this.httpRequest.get(`${this.baseUrl}sessions/${encodeURIComponent(encodeURIComponent(sessionId))}/participants`);
+        return datoDe<{ items: MeetingConnectorParticipant[] }>(r as never)?.items ?? [];
+    }
+
+    async getSessionPolls(sessionId: string): Promise<MeetingConnectorPollAnswer[] | undefined> {
+        const r = await this.httpRequest.get(`${this.baseUrl}sessions/${encodeURIComponent(encodeURIComponent(sessionId))}/polls`);
+        const datos = datoDe<{ ready?: boolean; items?: MeetingConnectorPollAnswer[] }>(r as never);
+        if (!datos || datos.ready === false) return undefined;
+        return datos.items ?? [];
+    }
+}

package/src/meeting-connector/api/interfaces/IMeetingConnectorApi.ts

@@ -0,0 +1,52 @@
+/**
+ * El contrato agnóstico de meeting-connector (la envoltura del proveedor de reuniones; hoy Zoom,
+ * Teams después): nada acá nombra al proveedor. Lo consume meetings-business.
+ */
+
+export type MeetingConnectorHost = { email: string; name?: string; licensed: boolean };
+
+export type MeetingConnectorCreateRequest = {
+    hostEmail: string;
+    title: string;
+    agenda?: string;
+    startsAt: string;
+    durationMinutes: number;
+    timezone: string;
+    registrationRequired: boolean;
+    phoneRequired: boolean;
+    registrationQuestions?: Array<{ ref: string; text: string; required?: boolean; dataType?: string }>;
+    polls?: Array<{ title: string; questions: Array<{ ref: string; text: string; type: string; options?: string[] }> }>;
+};
+
+export type MeetingConnectorCreated = {
+    externalMeetingId: string;
+    registrationUrl?: string;
+    joinUrl?: string;
+    polls?: Array<{ title: string; externalPollId: string }>;
+};
+
+export type MeetingConnectorParticipant = {
+    participantId: string;
+    registrantId?: string;
+    name?: string;
+    email?: string;
+    joinedAt: string;
+    leftAt?: string;
+    durationSeconds?: number;
+};
+
+export type MeetingConnectorPollAnswer = { name?: string; email?: string; answers: Array<{ question: string; answer: string; externalPollId?: string; respondedAt?: string }> };
+
+export type MeetingConnectorRegistrant = { registrantId: string; name?: string; email?: string; phoneNumber?: string; answers?: Array<{ question: string; answer: string }> };
+
+export interface IMeetingConnectorApi {
+    getHosts(): Promise<MeetingConnectorHost[]>;
+    /** Si algo falla en la plataforma, el connector borra y no queda nada a medias. */
+    createMeeting(request: MeetingConnectorCreateRequest): Promise<MeetingConnectorCreated>;
+    /** El link del anfitrión vence a las 2 horas: se pide uno nuevo cada vez. */
+    getStartUrl(externalMeetingId: string): Promise<string>;
+    getRegistrant(externalMeetingId: string, registrantId: string): Promise<MeetingConnectorRegistrant | undefined>;
+    getSessionParticipants(sessionId: string): Promise<MeetingConnectorParticipant[]>;
+    /** undefined = la plataforma todavía no los tiene listos: reintentar después. */
+    getSessionPolls(sessionId: string): Promise<MeetingConnectorPollAnswer[] | undefined>;
+}

package/src/meeting-connector/index.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IMeetingConnectorApi.js';
+export { default as MeetingConnectorApi } from './api/MeetingConnectorApi.js';

package/src/onboarding-business/api/OnboardingBusinessApi.ts

@@ -1,6 +1,6 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
-import type { IOnboardingBusinessApi } from "./interfaces/IOnboardingBusinessApi.js";
+import type { IOnboardingBusinessApi, OnboardingAssignTagParams, OnboardingTagSubject } from "./interfaces/IOnboardingBusinessApi.js";
 
 
 @injectable()
@@ -91,30 +91,41 @@ export default class OnboardingBusinessApi implements IOnboardingBusinessApi {
         return await this.httpRequest.get(`${url}`, { ids });
     }
 
-    async tagsSummary(): Promise<any> {
-        const url = `${this.baseUrl}private/tags/summary`;
+    async tagsSummary(subject?: OnboardingTagSubject): Promise<any> {
+        const url = `${this.baseUrl}private/tags/summary${subject ? `?subject=${subject}` : ''}`;
         return await this.httpRequest.get(`${url}`);
     }
 
-    async tagsByDirectories(directoryIds: string[]): Promise<any> {
+    async tagsByDirectories(directoryIds: string[], subject?: OnboardingTagSubject): Promise<any> {
         const url = `${this.baseUrl}private/tags/by-directories`;
-        return await this.httpRequest.post(`${url}`, { directoryIds });
+        const body = subject === 'lead' ? { subject, leadIds: directoryIds } : { directoryIds };
+        return await this.httpRequest.post(`${url}`, body);
     }
 
-    async getUsersByTag(tag: string, pageSize = 200, index?: string): Promise<any> {
+    async getUsersByTag(tag: string, pageSize = 200, index?: string, subject?: OnboardingTagSubject): Promise<any> {
         const queryParams = [`pageSize=${pageSize}`];
 
         if (index) {
             queryParams.push(`index=${encodeURIComponent(index)}`);
         }
+        if (subject) {
+            queryParams.push(`subject=${subject}`);
+        }
 
         const url = `${this.baseUrl}private/tags/${encodeURIComponent(tag)}/users?${queryParams.join('&')}`;
         return await this.httpRequest.get(`${url}`);
     }
 
-    async assignTag(params: { directoryId: string; tag: string }): Promise<any> {
+    async removeTag(id: string, subject?: OnboardingTagSubject): Promise<any> {
+        const url = `${this.baseUrl}private/tags/${encodeURIComponent(id)}${subject ? `?subject=${subject}` : ''}`;
+        return await this.httpRequest.delete(`${url}`);
+    }
+
+    async assignTag(params: OnboardingAssignTagParams): Promise<any> {
         const url = `${this.baseUrl}private/tags`;
-        return await this.httpRequest.post(`${url}`, { directoryId: params.directoryId, tag: params.tag });
+        // Sólo viajan los campos presentes: sin subject el cuerpo es el de siempre, { directoryId, tag }.
+        const body = Object.fromEntries(Object.entries(params).filter(([, value]) => value !== undefined));
+        return await this.httpRequest.post(`${url}`, body);
     }
 
     //**

package/src/onboarding-business/api/interfaces/IOnboardingBusinessApi.ts

@@ -1,3 +1,21 @@
+/**
+ * A quién se le pone la etiqueta: `user` (UserTags_GT, por directoryId) es el default de siempre;
+ * `lead` (LeadTags_GT, por leadId) es de los leads de meetings-business.
+ */
+export type OnboardingTagSubject = "user" | "lead";
+
+/** Con `subject` lead van `leadId`, `phoneNumber` y quién la puso; sin subject, `directoryId` como siempre. */
+export interface OnboardingAssignTagParams {
+    subject?: OnboardingTagSubject;
+    directoryId?: string;
+    leadId?: string;
+    tag: string;
+    phoneNumber?: string;
+    source?: "RULE" | "MANUAL";
+    meetingId?: string;
+    addedBy?: string;
+}
+
 export interface IOnboardingBusinessApi {
     getById(id: string): Promise<any>
     getByPhoneNumber(phoneNumber: string): Promise<any>
@@ -8,8 +26,8 @@ export interface IOnboardingBusinessApi {
 
     getBatchByIds(ids: string[]): Promise<any>
 
-    /** Dashboard Ops Segmentos — tags distintos + count c/u (TagsSummaryResponse en data). */
-    tagsSummary(): Promise<any>
+    /** Dashboard Ops Segmentos — tags distintos + count c/u (TagsSummaryResponse en data). Con `lead`, los de los leads. */
+    tagsSummary(subject?: OnboardingTagSubject): Promise<any>
     /** Dashboard Ops Segmentos — tags por usuario para un batch de directoryIds (TagsByDirectoriesResponse en data). */
     /**
      * Directorios que tienen un tag, paginado.
@@ -20,11 +38,14 @@ export interface IOnboardingBusinessApi {
      * Es el inverso de `tagsByDirectories` (ese da los tags DE unos directorios; éste da
      * los directorios CON un tag). Consumido por `direct-deposit-export-business`.
      */
-    getUsersByTag(tag: string, pageSize?: number, index?: string): Promise<any>;
+    getUsersByTag(tag: string, pageSize?: number, index?: string, subject?: OnboardingTagSubject): Promise<any>;
 
-    tagsByDirectories(directoryIds: string[]): Promise<any>
-    /** Asigna un tag a un directoryId. Idempotente: si ya estaba responde 200 con alreadyAssigned true. */
-    assignTag(params: { directoryId: string; tag: string }): Promise<any>
+    /** Con `lead`, `directoryIds` son leadIds y viajan como `leadIds`. */
+    tagsByDirectories(directoryIds: string[], subject?: OnboardingTagSubject): Promise<any>
+    /** Asigna un tag a un directoryId (o a un lead con `subject` lead). Idempotente: si ya estaba responde 200 con alreadyAssigned true. */
+    assignTag(params: OnboardingAssignTagParams): Promise<any>
+    /** Quita un tag por su id compuesto (`${directoryId}-${tag}`, o `${leadId}-${tag}` con `subject` lead). Idempotente. */
+    removeTag(id: string, subject?: OnboardingTagSubject): Promise<any>
 
     /**
      * ¿Este expediente cumple los requisitos para emitir el lado indicado?

package/src/usmarketgrowth-business/UsMarketGrowthBusinessApi.ts

@@ -1,7 +1,7 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import dotenv from 'dotenv';
-import type { PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
+import type { CreatePromoterFromLeadRequest, PostPromoterFromLeadResponse, PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
 import { IUsMarketGrowthBusinessApi } from "./interfaces/IUsMarketGrowthBusinessApi.js";
 import { joinUrl } from "../utils/joinUrl.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
@@ -19,4 +19,9 @@ export class UsMarketGrowthBusinessApi implements IUsMarketGrowthBusinessApi {
         const url = joinUrl(this.baseUrl, `private/promoters/directoryId/${encodeURIComponent(directoryId)}`);
         return await this.httpRequest.get(url);
     }
+
+    async createPromoterFromLead(request: CreatePromoterFromLeadRequest): Promise<FiadoApiResponse<PostPromoterFromLeadResponse>> {
+        const url = joinUrl(this.baseUrl, "private/promoters/from-lead");
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/usmarketgrowth-business/interfaces/IUsMarketGrowthBusinessApi.ts

@@ -1,5 +1,5 @@
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
-import type { PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
+import type { CreatePromoterFromLeadRequest, PostPromoterFromLeadResponse, PromoterByDirectoryIdResponse } from "@fiado/type-kit/bin/usmarketgrowth-business/index.js";
 
 /**
  * Cliente de `usmarketgrowth-business` (promotores de US Market Growth).
@@ -14,4 +14,10 @@ export interface IUsMarketGrowthBusinessApi {
      * @param directoryId ID del directorio.
      */
     getPromoterByDirectoryId(directoryId: string): Promise<FiadoApiResponse<PromoterByDirectoryIdResponse>>;
+
+    /**
+     * 4.5 del plan de reuniones: promotor a partir de un lead, idempotente por teléfono o correo
+     * (dos llamadas con el mismo contacto devuelven el mismo promoterId; EXISTING no toca nada).
+     */
+    createPromoterFromLead(request: CreatePromoterFromLeadRequest): Promise<FiadoApiResponse<PostPromoterFromLeadResponse>>;
 }