@cesteral/meta-mcp 1.0.0

package/dist/services/meta/meta-insights-service.js

@@ -0,0 +1,209 @@
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+export class MetaInsightsService {
+    rateLimiter;
+    httpClient;
+    logger;
+    constructor(rateLimiter, httpClient, logger) {
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+        this.logger = logger;
+    }
+    validateDateRangeInputs(entityId, options, operation) {
+        if (options.datePreset && options.timeRange) {
+            this.logger.debug({ entityId, datePreset: options.datePreset, operation }, `Rejecting ${operation} request: datePreset and timeRange are mutually exclusive`);
+            throw new McpError(JsonRpcErrorCode.InvalidParams, "Cannot specify both datePreset and timeRange — they are mutually exclusive. Use one or the other.");
+        }
+    }
+    async getInsights(entityId, options, context) {
+        this.validateDateRangeInputs(entityId, options, "insights");
+        await this.rateLimiter.consume(`meta:default`);
+        const defaultFields = [
+            "impressions",
+            "clicks",
+            "spend",
+            "cpc",
+            "cpm",
+            "ctr",
+            "reach",
+            "frequency",
+            "actions",
+            "action_values",
+            "conversions",
+            "cost_per_action_type",
+        ];
+        const params = {
+            fields: options.fields?.join(",") || defaultFields.join(","),
+        };
+        if (options.datePreset) {
+            params.date_preset = options.datePreset;
+        }
+        if (options.timeRange) {
+            params.time_range = JSON.stringify(options.timeRange);
+        }
+        if (options.timeIncrement) {
+            params.time_increment = options.timeIncrement;
+        }
+        if (options.level) {
+            params.level = options.level;
+        }
+        if (options.limit) {
+            params.limit = String(options.limit);
+        }
+        if (options.after) {
+            params.after = options.after;
+        }
+        const result = (await this.httpClient.get(`/${entityId}/insights`, params, context));
+        const data = result.data || [];
+        const paging = result.paging;
+        const cursors = paging?.cursors;
+        return {
+            data,
+            nextCursor: cursors?.after,
+            summary: result.summary,
+        };
+    }
+    async submitInsightsReport(entityId, options, context) {
+        this.validateDateRangeInputs(entityId, options, "async insights report");
+        await this.rateLimiter.consume(`meta:default`);
+        const defaultFields = [
+            "impressions",
+            "clicks",
+            "spend",
+            "cpc",
+            "cpm",
+            "ctr",
+            "reach",
+            "frequency",
+            "actions",
+            "action_values",
+            "conversions",
+            "cost_per_action_type",
+        ];
+        const data = {
+            fields: options.fields?.join(",") || defaultFields.join(","),
+            async: 1,
+        };
+        if (options.datePreset) {
+            data.date_preset = options.datePreset;
+        }
+        if (options.timeRange) {
+            data.time_range = JSON.stringify(options.timeRange);
+        }
+        if (options.timeIncrement) {
+            data.time_increment = options.timeIncrement;
+        }
+        if (options.level) {
+            data.level = options.level;
+        }
+        if (options.breakdowns?.length) {
+            data.breakdowns = options.breakdowns.join(",");
+        }
+        const result = (await this.httpClient.post(`/${entityId}/insights`, data, context));
+        return { reportRunId: String(result.id) };
+    }
+    async checkReportStatus(reportRunId, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        const result = (await this.httpClient.get(`/${reportRunId}`, {
+            fields: "id,async_status,async_percent_completion,error_code,error_message,error_subcode,error_user_title,error_user_msg",
+        }, context));
+        return {
+            reportRunId: String(result.id ?? reportRunId),
+            status: String(result.async_status ?? "Unknown"),
+            asyncPercentCompletion: result.async_percent_completion != null
+                ? Number(result.async_percent_completion)
+                : undefined,
+            errorCode: result.error_code != null ? Number(result.error_code) : undefined,
+            errorMessage: result.error_message != null ? String(result.error_message) : undefined,
+            errorSubcode: result.error_subcode != null ? Number(result.error_subcode) : undefined,
+            errorUserTitle: result.error_user_title != null ? String(result.error_user_title) : undefined,
+            errorUserMsg: result.error_user_msg != null ? String(result.error_user_msg) : undefined,
+        };
+    }
+    async getReportResults(reportRunId, options, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        const data = [];
+        let after = options.after;
+        let fetchedAllRows = true;
+        do {
+            const remainingRows = options.limit ? options.limit - data.length : undefined;
+            if (remainingRows !== undefined && remainingRows <= 0) {
+                fetchedAllRows = false;
+                break;
+            }
+            const params = {};
+            if (remainingRows !== undefined) {
+                params.limit = String(remainingRows);
+            }
+            if (after) {
+                params.after = after;
+            }
+            const result = (await this.httpClient.get(`/${reportRunId}/insights`, params, context));
+            const pageData = Array.isArray(result.data) ? result.data : [];
+            data.push(...pageData);
+            const paging = result.paging;
+            const cursors = paging?.cursors;
+            after = cursors?.after;
+            if (!after) {
+                break;
+            }
+            if (remainingRows !== undefined && data.length >= options.limit) {
+                fetchedAllRows = false;
+                break;
+            }
+        } while (after);
+        return {
+            data,
+            fetchedAllRows,
+            nextCursor: after,
+        };
+    }
+    async getInsightsBreakdowns(entityId, options, context) {
+        this.validateDateRangeInputs(entityId, options, "insights breakdowns");
+        await this.rateLimiter.consume(`meta:default`);
+        const defaultFields = [
+            "impressions",
+            "clicks",
+            "spend",
+            "cpc",
+            "cpm",
+            "ctr",
+            "reach",
+            "frequency",
+            "actions",
+        ];
+        const params = {
+            fields: options.fields?.join(",") || defaultFields.join(","),
+            breakdowns: options.breakdowns.join(","),
+        };
+        if (options.datePreset) {
+            params.date_preset = options.datePreset;
+        }
+        if (options.timeRange) {
+            params.time_range = JSON.stringify(options.timeRange);
+        }
+        if (options.timeIncrement) {
+            params.time_increment = options.timeIncrement;
+        }
+        if (options.level) {
+            params.level = options.level;
+        }
+        if (options.limit) {
+            params.limit = String(options.limit);
+        }
+        if (options.after) {
+            params.after = options.after;
+        }
+        if (options.actionAttributionWindows?.length) {
+            params.action_attribution_windows = options.actionAttributionWindows.join(",");
+        }
+        const result = (await this.httpClient.get(`/${entityId}/insights`, params, context));
+        const data = result.data || [];
+        const paging = result.paging;
+        const cursors = paging?.cursors;
+        return {
+            data,
+            nextCursor: cursors?.after,
+        };
+    }
+}
+//# sourceMappingURL=meta-insights-service.js.map

package/dist/services/meta/meta-insights-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-insights-service.js","sourceRoot":"","sources":["../../../src/services/meta/meta-insights-service.ts"],"names":[],"mappings":"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"}

package/dist/services/meta/meta-service.d.ts

@@ -0,0 +1,64 @@
+import type { MetaGraphApiClient } from "./meta-graph-api-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import { type MetaEntityType } from "../../mcp-server/tools/utils/entity-mapping.js";
+import type { Logger } from "pino";
+import type { MetaCampaign, MetaAdSet, MetaAd, MetaAdCreative, MetaCustomAudience, MetaAdAccount } from "./types.js";
+export type { MetaCampaign, MetaAdSet, MetaAd, MetaAdCreative, MetaCustomAudience, MetaAdAccount };
+interface MetaEntityMap {
+    campaign: MetaCampaign;
+    adSet: MetaAdSet;
+    ad: MetaAd;
+    adCreative: MetaAdCreative;
+    customAudience: MetaCustomAudience;
+}
+export declare class MetaService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    constructor(rateLimiter: RateLimiter, httpClient: MetaGraphApiClient, logger: Logger);
+    get graphApiClient(): MetaGraphApiClient;
+    listEntities<T extends MetaEntityType>(entityType: T, adAccountId: string, fields?: string[], filtering?: Record<string, unknown>[], limit?: number, after?: string, context?: RequestContext): Promise<{
+        entities: MetaEntityMap[T][];
+        nextCursor?: string;
+    }>;
+    getEntity<T extends MetaEntityType>(entityType: T, entityId: string, fields?: string[], context?: RequestContext): Promise<MetaEntityMap[T]>;
+    createEntity<T extends MetaEntityType>(entityType: T, adAccountId: string, data: Record<string, unknown>, context?: RequestContext): Promise<MetaEntityMap[T]>;
+    updateEntity(entityId: string, data: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    deleteEntity(entityId: string, context?: RequestContext): Promise<unknown>;
+    bulkCreateEntities(entityType: MetaEntityType, adAccountId: string, items: Record<string, unknown>[], context?: RequestContext): Promise<{
+        results: Array<{
+            success: boolean;
+            entity?: unknown;
+            error?: string;
+        }>;
+    }>;
+    bulkUpdateStatus(entityIds: string[], status: "ACTIVE" | "PAUSED" | "ARCHIVED", context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    bulkUpdateEntities(items: Array<{
+        entityId: string;
+        data: Record<string, unknown>;
+    }>, context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    duplicateEntity(entityId: string, options?: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    listAdAccounts(fields?: string[], limit?: number, after?: string, context?: RequestContext): Promise<{
+        accounts: MetaAdAccount[];
+        nextCursor?: string;
+    }>;
+    getDeliveryEstimate(adAccountId: string, targetingSpec: Record<string, unknown>, optimizationGoal?: string, context?: RequestContext): Promise<unknown>;
+    createBudgetSchedule(campaignId: string, data: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    listBudgetSchedules(campaignId: string, context?: RequestContext): Promise<unknown>;
+    getAdPreviews(adId: string, adFormat: string, context?: RequestContext): Promise<unknown>;
+    private normalizeAccountId;
+}
+//# sourceMappingURL=meta-service.d.ts.map

package/dist/services/meta/meta-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-service.d.ts","sourceRoot":"","sources":["../../../src/services/meta/meta-service.ts"],"names":[],"mappings":"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"}

package/dist/services/meta/meta-service.js

@@ -0,0 +1,177 @@
+import { executeBulkConcurrent } from "@cesteral/shared";
+import { getEntityConfig, } from "../../mcp-server/tools/utils/entity-mapping.js";
+export class MetaService {
+    rateLimiter;
+    httpClient;
+    logger;
+    constructor(rateLimiter, httpClient, logger) {
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+        this.logger = logger;
+    }
+    get graphApiClient() {
+        return this.httpClient;
+    }
+    async listEntities(entityType, adAccountId, fields, filtering, limit, after, context) {
+        const config = getEntityConfig(entityType);
+        await this.rateLimiter.consume(`meta:${adAccountId}`);
+        const actId = this.normalizeAccountId(adAccountId);
+        const params = {};
+        if (fields?.length) {
+            params.fields = fields.join(",");
+        }
+        else if (config.defaultFields) {
+            params.fields = config.defaultFields.join(",");
+        }
+        if (filtering?.length) {
+            params.filtering = JSON.stringify(filtering);
+        }
+        if (limit) {
+            params.limit = String(limit);
+        }
+        if (after) {
+            params.after = after;
+        }
+        const result = (await this.httpClient.get(`/${actId}/${config.edge}`, params, context));
+        if (result.data !== undefined && !Array.isArray(result.data)) {
+            this.logger.warn({ dataType: typeof result.data, entityType }, "Meta API returned unexpected non-array data field");
+        }
+        const entities = (Array.isArray(result.data) ? result.data : []);
+        const paging = result.paging;
+        const cursors = paging?.cursors;
+        return {
+            entities,
+            nextCursor: cursors?.after,
+        };
+    }
+    async getEntity(entityType, entityId, fields, context) {
+        const config = getEntityConfig(entityType);
+        await this.rateLimiter.consume(`meta:default`);
+        const params = {};
+        if (fields?.length) {
+            params.fields = fields.join(",");
+        }
+        else if (config.defaultFields) {
+            params.fields = config.defaultFields.join(",");
+        }
+        return this.httpClient.get(`/${entityId}`, params, context);
+    }
+    async createEntity(entityType, adAccountId, data, context) {
+        const config = getEntityConfig(entityType);
+        await this.rateLimiter.consume(`meta:${adAccountId}`, 3);
+        const actId = this.normalizeAccountId(adAccountId);
+        return this.httpClient.post(`/${actId}/${config.edge}`, data, context);
+    }
+    async updateEntity(entityId, data, context) {
+        await this.rateLimiter.consume(`meta:default`, 3);
+        return this.httpClient.post(`/${entityId}`, data, context);
+    }
+    async deleteEntity(entityId, context) {
+        await this.rateLimiter.consume(`meta:default`, 3);
+        return this.httpClient.delete(`/${entityId}`, context);
+    }
+    async bulkCreateEntities(entityType, adAccountId, items, context) {
+        const results = await executeBulkConcurrent(items, async (data) => {
+            return this.createEntity(entityType, adAccountId, data, context);
+        }, { logger: this.logger });
+        return { results };
+    }
+    async bulkUpdateStatus(entityIds, status, context) {
+        this.logger.debug({ count: entityIds.length, status }, "Bulk status update");
+        const bulkResults = await executeBulkConcurrent(entityIds, async (entityId) => {
+            return this.updateEntity(entityId, { status }, context);
+        }, { logger: this.logger });
+        return {
+            results: bulkResults.map((r, i) => ({
+                entityId: entityIds[i],
+                success: r.success,
+                error: r.error,
+            })),
+        };
+    }
+    async bulkUpdateEntities(items, context) {
+        const bulkResults = await executeBulkConcurrent(items, async (item) => {
+            return this.updateEntity(item.entityId, item.data, context);
+        }, { logger: this.logger });
+        return {
+            results: bulkResults.map((r, i) => ({
+                entityId: items[i].entityId,
+                success: r.success,
+                error: r.error,
+            })),
+        };
+    }
+    async duplicateEntity(entityId, options, context) {
+        await this.rateLimiter.consume(`meta:default`, 3);
+        return this.httpClient.post(`/${entityId}/copies`, options, context);
+    }
+    async listAdAccounts(fields, limit, after, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        const defaultFields = [
+            "id",
+            "name",
+            "account_status",
+            "currency",
+            "timezone_name",
+            "amount_spent",
+            "balance",
+        ];
+        const params = {
+            fields: fields?.join(",") || defaultFields.join(","),
+        };
+        if (limit) {
+            params.limit = String(limit);
+        }
+        if (after) {
+            params.after = after;
+        }
+        const result = (await this.httpClient.get("/me/adaccounts", params, context));
+        if (result.data !== undefined && !Array.isArray(result.data)) {
+            this.logger.warn({ dataType: typeof result.data }, "Meta API returned unexpected non-array data field for ad accounts");
+        }
+        const accounts = (Array.isArray(result.data) ? result.data : []);
+        const paging = result.paging;
+        const cursors = paging?.cursors;
+        return {
+            accounts,
+            nextCursor: cursors?.after,
+        };
+    }
+    async getDeliveryEstimate(adAccountId, targetingSpec, optimizationGoal, context) {
+        await this.rateLimiter.consume(`meta:${adAccountId}`);
+        const actId = this.normalizeAccountId(adAccountId);
+        try {
+            const reachParams = {
+                targeting_spec: JSON.stringify(targetingSpec),
+            };
+            const result = await this.httpClient.get(`/${actId}/reachestimate`, reachParams, context);
+            return result;
+        }
+        catch (err) {
+            this.logger.debug({ err }, "reachestimate failed, falling back to delivery_estimate");
+        }
+        const params = {
+            targeting_spec: JSON.stringify(targetingSpec),
+        };
+        if (optimizationGoal) {
+            params.optimization_goal = optimizationGoal;
+        }
+        return this.httpClient.get(`/${actId}/delivery_estimate`, params, context);
+    }
+    async createBudgetSchedule(campaignId, data, context) {
+        await this.rateLimiter.consume(`meta:default`, 3);
+        return this.httpClient.post(`/${campaignId}/budget_schedules`, data, context);
+    }
+    async listBudgetSchedules(campaignId, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        return this.httpClient.get(`/${campaignId}/budget_schedules`, {}, context);
+    }
+    async getAdPreviews(adId, adFormat, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        return this.httpClient.get(`/${adId}/previews`, { ad_format: adFormat }, context);
+    }
+    normalizeAccountId(adAccountId) {
+        return adAccountId.startsWith("act_") ? adAccountId : `act_${adAccountId}`;
+    }
+}
+//# sourceMappingURL=meta-service.js.map

package/dist/services/meta/meta-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-service.js","sourceRoot":"","sources":["../../../src/services/meta/meta-service.ts"],"names":[],"mappings":"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"}

package/dist/services/meta/meta-targeting-service.d.ts

@@ -0,0 +1,13 @@
+import type { MetaGraphApiClient } from "./meta-graph-api-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import type { RequestContext } from "@cesteral/shared";
+import type { Logger } from "pino";
+export declare class MetaTargetingService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    constructor(rateLimiter: RateLimiter, httpClient: MetaGraphApiClient, logger: Logger);
+    searchTargeting(type: string, query: string, limit?: number, context?: RequestContext): Promise<unknown>;
+    getTargetingOptions(adAccountId: string, type?: string, context?: RequestContext): Promise<unknown>;
+}
+//# sourceMappingURL=meta-targeting-service.d.ts.map

package/dist/services/meta/meta-targeting-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-targeting-service.d.ts","sourceRoot":"","sources":["../../../src/services/meta/meta-targeting-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAQnC,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,MAAM;IAM3B,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAgCb,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;CAapB"}

package/dist/services/meta/meta-targeting-service.js

@@ -0,0 +1,38 @@
+export class MetaTargetingService {
+    rateLimiter;
+    httpClient;
+    logger;
+    constructor(rateLimiter, httpClient, logger) {
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+        this.logger = logger;
+    }
+    async searchTargeting(type, query, limit, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        const normalizedType = type.toLowerCase();
+        const params = {
+            type: normalizedType,
+        };
+        if (normalizedType === "adinterestsuggestion") {
+            this.logger.debug({ type: normalizedType }, "Using interest_list param for adinterestsuggestion type");
+            params.interest_list = query;
+        }
+        else {
+            params.q = query;
+        }
+        if (limit) {
+            params.limit = String(limit);
+        }
+        return this.httpClient.get("/search", params, context);
+    }
+    async getTargetingOptions(adAccountId, type, context) {
+        await this.rateLimiter.consume(`meta:default`);
+        const actId = adAccountId.startsWith("act_") ? adAccountId : `act_${adAccountId}`;
+        const params = {};
+        if (type) {
+            params.type = type.toLowerCase();
+        }
+        return this.httpClient.get(`/${actId}/targetingbrowse`, params, context);
+    }
+}
+//# sourceMappingURL=meta-targeting-service.js.map

package/dist/services/meta/meta-targeting-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-targeting-service.js","sourceRoot":"","sources":["../../../src/services/meta/meta-targeting-service.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,oBAAoB;IAEZ;IACA;IACA;IAHnB,YACmB,WAAwB,EACxB,UAA8B,EAC9B,MAAc;QAFd,gBAAW,GAAX,WAAW,CAAa;QACxB,eAAU,GAAV,UAAU,CAAoB;QAC9B,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAKJ,KAAK,CAAC,eAAe,CACnB,IAAY,EACZ,KAAa,EACb,KAAc,EACd,OAAwB;QAExB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAI/C,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAE1C,MAAM,MAAM,GAA2B;YACrC,IAAI,EAAE,cAAc;SACrB,CAAC;QAGF,IAAI,cAAc,KAAK,sBAAsB,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,IAAI,EAAE,cAAc,EAAE,EACxB,yDAAyD,CAC1D,CAAC;YACF,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAKD,KAAK,CAAC,mBAAmB,CACvB,WAAmB,EACnB,IAAa,EACb,OAAwB;QAExB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAE/C,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,WAAW,EAAE,CAAC;QAElF,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YAET,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF"}