@cesteral/cm360-mcp 1.0.0

package/dist/mcp-server/tools/utils/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAGlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.d.ts

@@ -0,0 +1,43 @@
+import type { Logger } from "pino";
+export declare const createMcpHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "google-headers" | "jwt" | "none";
+    cm360ApiBaseUrl: string;
+    cm360RateLimitPerMinute: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    cm360ServiceAccountJson?: string | undefined;
+    cm360ServiceAccountFile?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "google-headers" | "jwt" | "none";
+    cm360ApiBaseUrl: string;
+    cm360RateLimitPerMinute: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    cm360ServiceAccountJson?: string | undefined;
+    cm360ServiceAccountFile?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
+//# sourceMappingURL=streamable-http-transport.d.ts.map

package/dist/mcp-server/transports/streamable-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AA2EnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}

package/dist/mcp-server/transports/streamable-http-transport.js

@@ -0,0 +1,58 @@
+import { createMcpServer } from "../server.js";
+import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
+import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
+import { rateLimiter } from "../../utils/platform.js";
+function buildPlatformConfig(config, logger) {
+    return {
+        authStrategy: createAuthStrategy(config.mcpAuthMode, {
+            scopes: [
+                "https://www.googleapis.com/auth/dfareporting",
+                "https://www.googleapis.com/auth/dfatrafficking",
+            ],
+            jwtSecret: config.mcpAuthSecretKey,
+            logger,
+        }),
+        corsAllowHeaders: [
+            "Content-Type",
+            "Authorization",
+            "Mcp-Session-Id",
+            "MCP-Protocol-Version",
+            "X-Google-Auth-Type",
+            "X-Google-Credentials",
+            "X-Google-Client-Id",
+            "X-Google-Client-Secret",
+            "X-Google-Refresh-Token",
+        ],
+        authErrorHint: config.mcpAuthMode === "google-headers"
+            ? "Provide Google credentials via X-Google-Auth-Type and associated headers."
+            : "Provide a valid Bearer token in the Authorization header.",
+        sessionServiceStore,
+        rateLimiter,
+        async createSessionForAuth(authResult, sessionId, appConfig, log) {
+            const adapter = authResult.googleAuthAdapter;
+            if (adapter) {
+                await adapter.validate();
+                const services = createSessionServices(adapter, { baseUrl: appConfig.cm360ApiBaseUrl }, log, rateLimiter);
+                sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                return { services };
+            }
+            if (appConfig.mcpAuthMode !== "none") {
+                return {
+                    services: null,
+                    error: {
+                        message: "Google API credentials required for this server. Use MCP_AUTH_MODE=google-headers.",
+                        status: 400,
+                    },
+                };
+            }
+            return { services: null };
+        },
+        async createMcpServer(log, sessionId, gcsBucket) {
+            return createMcpServer(log, sessionId, gcsBucket);
+        },
+        packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
+        serverCard: buildServerCardExtras("cm360-mcp"),
+    };
+}
+export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
+//# sourceMappingURL=streamable-http-transport.js.map

package/dist/mcp-server/transports/streamable-http-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http-transport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAIlB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,SAAS,mBAAmB,CAAC,MAAiB,EAAE,MAAc;IAC5D,OAAO;QACL,YAAY,EAAE,kBAAkB,CAAC,MAAM,CAAC,WAAuB,EAAE;YAC/D,MAAM,EAAE;gBACN,8CAA8C;gBAC9C,gDAAgD;aACjD;YACD,SAAS,EAAE,MAAM,CAAC,gBAAgB;YAClC,MAAM;SACP,CAAC;QACF,gBAAgB,EAAE;YAChB,cAAc;YACd,eAAe;YACf,gBAAgB;YAChB,sBAAsB;YACtB,oBAAoB;YACpB,sBAAsB;YACtB,oBAAoB;YACpB,wBAAwB;YACxB,wBAAwB;SACzB;QACD,aAAa,EACX,MAAM,CAAC,WAAW,KAAK,gBAAgB;YACrC,CAAC,CAAC,2EAA2E;YAC7E,CAAC,CAAC,2DAA2D;QACjE,mBAAmB;QACnB,WAAW;QACX,KAAK,CAAC,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG;YAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAkD,CAAC;YAC9E,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,qBAAqB,CACpC,OAAO,EACP,EAAE,OAAO,EAAG,SAAuB,CAAC,eAAe,EAAE,EACrD,GAAG,EACH,WAAW,CACZ,CAAC;gBACF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,qBAAqB,CAAC,CAAC;gBAC/E,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,CAAC;YACD,IAAI,SAAS,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;gBACrC,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE;wBACL,OAAO,EACL,oFAAoF;wBACtF,MAAM,EAAE,GAAG;qBACZ;iBACF,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS;YAC7C,OAAO,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,eAAe,EAAE,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ;QAC3E,UAAU,EAAE,qBAAqB,CAAC,WAAW,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,GACnD,0BAA0B,CAAY,mBAAmB,CAAC,CAAC"}

package/dist/services/cm360/cm360-http-client.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from "pino";
+import type { GoogleAuthAdapter } from "@cesteral/shared";
+import type { RequestContext } from "@cesteral/shared";
+export declare class CM360HttpClient {
+    private authAdapter;
+    private baseUrl;
+    private logger;
+    constructor(authAdapter: GoogleAuthAdapter, baseUrl: string, logger: Logger);
+    fetch(path: string, context?: RequestContext, options?: RequestInit): Promise<unknown>;
+    fetchRaw(url: string, timeoutMs: number, context?: RequestContext, options?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=cm360-http-client.d.ts.map

package/dist/services/cm360/cm360-http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cm360-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/cm360/cm360-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAWvD,qBAAa,eAAe;IAExB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBAFN,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAGlB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBtF,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,QAAQ,CAAC;CA8CrB"}

package/dist/services/cm360/cm360-http-client.js

@@ -0,0 +1,77 @@
+import { fetchWithTimeout, executeWithRetry } from "@cesteral/shared";
+import { withCM360ApiSpan } from "../../utils/platform.js";
+const RETRY_CONFIG = {
+    maxRetries: 3,
+    initialBackoffMs: 1_000,
+    maxBackoffMs: 10_000,
+    timeoutMs: 10_000,
+    platformName: "CM360",
+};
+export class CM360HttpClient {
+    authAdapter;
+    baseUrl;
+    logger;
+    constructor(authAdapter, baseUrl, logger) {
+        this.authAdapter = authAdapter;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+    }
+    async fetch(path, context, options) {
+        const url = `${this.baseUrl}${path}`;
+        const method = options?.method || "GET";
+        this.logger.debug({ url, method, requestId: context?.requestId }, "Making CM360 API request");
+        return withCM360ApiSpan(`api.${method}`, path, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            return executeWithRetry(RETRY_CONFIG, {
+                url,
+                fetchOptions: options,
+                context,
+                logger: this.logger,
+                getHeaders: async () => {
+                    const accessToken = await this.authAdapter.getAccessToken();
+                    return { Authorization: `Bearer ${accessToken}` };
+                },
+            });
+        });
+    }
+    async fetchRaw(url, timeoutMs, context, options) {
+        const method = options?.method || "GET";
+        const maxRetries = 3;
+        return withCM360ApiSpan(`api.raw.${method}`, url, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            let lastResponse;
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                const accessToken = await this.authAdapter.getAccessToken();
+                const response = await fetchWithTimeout(url, timeoutMs, context, {
+                    ...options,
+                    headers: {
+                        ...options?.headers,
+                        Authorization: `Bearer ${accessToken}`,
+                    },
+                });
+                if (response.ok || (response.status < 500 && response.status !== 429)) {
+                    span.setAttribute("http.response.status_code", response.status);
+                    return response;
+                }
+                lastResponse = response;
+                if (attempt < maxRetries) {
+                    const delayMs = Math.min(1_000 * Math.pow(2, attempt), 10_000);
+                    this.logger.warn({
+                        url,
+                        method,
+                        status: response.status,
+                        attempt: attempt + 1,
+                        maxRetries,
+                        requestId: context?.requestId,
+                    }, "Retrying CM360 raw fetch after transient error");
+                    await new Promise((resolve) => setTimeout(resolve, delayMs));
+                }
+            }
+            span.setAttribute("http.response.status_code", lastResponse.status);
+            return lastResponse;
+        });
+    }
+}
+//# sourceMappingURL=cm360-http-client.js.map

package/dist/services/cm360/cm360-http-client.js.map

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

package/dist/services/cm360/cm360-reporting-service.d.ts

@@ -0,0 +1,50 @@
+import type { Logger } from "pino";
+import type { CM360HttpClient } from "./cm360-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+export interface CM360ReportConfig {
+    name: string;
+    type: string;
+    criteria?: Record<string, unknown>;
+    schedule?: Record<string, unknown>;
+    delivery?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare class CM360ReportingService {
+    private readonly rateLimiter;
+    private readonly httpClient;
+    private readonly logger;
+    private readonly pollIntervalMs;
+    private readonly maxPollAttempts;
+    constructor(rateLimiter: RateLimiter, httpClient: CM360HttpClient, logger: Logger, pollIntervalMs?: number, maxPollAttempts?: number);
+    runReport(profileId: string, config: CM360ReportConfig, context?: RequestContext): Promise<unknown>;
+    createReport(profileId: string, config: CM360ReportConfig, context?: RequestContext): Promise<{
+        reportId: string;
+        fileId: string;
+    }>;
+    checkReportFile(profileId: string, reportId: string, fileId: string, context?: RequestContext): Promise<{
+        reportId: string;
+        fileId: string;
+        status: string;
+        file: Record<string, unknown>;
+        downloadUrl?: string;
+    }>;
+    private pollReportFile;
+    downloadReportFile(downloadUrl: string, timeoutMs?: number, context?: RequestContext): Promise<Response>;
+    createReportSchedule(profileId: string, config: CM360ReportConfig & {
+        schedule: Record<string, unknown>;
+    }, context?: RequestContext): Promise<{
+        reportId: string;
+        reportName: string;
+        schedule: Record<string, unknown>;
+    }>;
+    listReportSchedules(profileId: string, options?: {
+        maxResults?: number;
+        pageToken?: string;
+    }, context?: RequestContext): Promise<{
+        reports: Record<string, unknown>[];
+        nextPageToken?: string;
+    }>;
+    deleteReportSchedule(profileId: string, reportId: string, context?: RequestContext): Promise<void>;
+}
+//# sourceMappingURL=cm360-reporting-service.d.ts.map

package/dist/services/cm360/cm360-reporting-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cm360-reporting-service.d.ts","sourceRoot":"","sources":["../../../src/services/cm360/cm360-reporting-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAJf,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAwC,EACxD,eAAe,GAAE,MAAW;IAGzC,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAwCb,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA6B1C,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;YAeY,cAAc;IAqCtB,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAe,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAad,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACjE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAwBjF,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EACzD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BpE,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

package/dist/services/cm360/cm360-reporting-service.js

@@ -0,0 +1,123 @@
+import { DEFAULT_REPORT_MAX_BACKOFF_MS, DEFAULT_REPORT_POLL_INTERVAL_MS, pollUntilComplete, ReportFailedError, } from "@cesteral/shared";
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+export class CM360ReportingService {
+    rateLimiter;
+    httpClient;
+    logger;
+    pollIntervalMs;
+    maxPollAttempts;
+    constructor(rateLimiter, httpClient, logger, pollIntervalMs = DEFAULT_REPORT_POLL_INTERVAL_MS, maxPollAttempts = 60) {
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+        this.logger = logger;
+        this.pollIntervalMs = pollIntervalMs;
+        this.maxPollAttempts = maxPollAttempts;
+    }
+    async runReport(profileId, config, context) {
+        await this.rateLimiter.consume("cm360");
+        const report = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports`, context, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(config),
+        }));
+        const reportId = report.id;
+        this.logger.info({ reportId, requestId: context?.requestId }, "CM360 report created");
+        await this.rateLimiter.consume("cm360");
+        const file = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports/${reportId}/run`, context, { method: "POST" }));
+        const fileId = file.id;
+        this.logger.info({ reportId, fileId, requestId: context?.requestId }, "CM360 report execution started — polling for results");
+        const completedFile = await this.pollReportFile(profileId, reportId, fileId, context);
+        const urls = completedFile.urls;
+        const downloadUrl = urls?.apiUrl;
+        return { reportId, fileId, file: completedFile, downloadUrl };
+    }
+    async createReport(profileId, config, context) {
+        await this.rateLimiter.consume("cm360");
+        const report = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports`, context, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(config),
+        }));
+        const reportId = report.id;
+        await this.rateLimiter.consume("cm360");
+        const file = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports/${reportId}/run`, context, { method: "POST" }));
+        const fileId = file.id;
+        this.logger.info({ reportId, fileId, requestId: context?.requestId }, "CM360 report submitted (non-blocking)");
+        return { reportId, fileId };
+    }
+    async checkReportFile(profileId, reportId, fileId, context) {
+        await this.rateLimiter.consume("cm360");
+        const file = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports/${reportId}/files/${fileId}`, context));
+        const status = file.status || "PROCESSING";
+        const urls = file.urls;
+        const downloadUrl = urls?.apiUrl;
+        return { reportId, fileId, status, file, downloadUrl };
+    }
+    async pollReportFile(profileId, reportId, fileId, context) {
+        try {
+            return await pollUntilComplete({
+                fetchStatus: async () => {
+                    await this.rateLimiter.consume("cm360");
+                    return (await this.httpClient.fetch(`/userprofiles/${profileId}/reports/${reportId}/files/${fileId}`, context));
+                },
+                isComplete: (file) => file.status === "REPORT_AVAILABLE",
+                isFailed: (file) => {
+                    const s = file.status;
+                    return s === "FAILED" || s === "CANCELLED";
+                },
+                initialDelayMs: this.pollIntervalMs,
+                maxDelayMs: DEFAULT_REPORT_MAX_BACKOFF_MS,
+                maxAttempts: this.maxPollAttempts,
+            });
+        }
+        catch (err) {
+            if (err instanceof ReportFailedError) {
+                const file = err.status;
+                throw new McpError(JsonRpcErrorCode.InternalError, `CM360 report ${String(file.status).toLowerCase()}`, { reportId, fileId, status: file.status, file });
+            }
+            throw err;
+        }
+    }
+    async downloadReportFile(downloadUrl, timeoutMs = 30_000, context) {
+        return this.httpClient.fetchRaw(downloadUrl, timeoutMs, context, {
+            method: "GET",
+        });
+    }
+    async createReportSchedule(profileId, config, context) {
+        await this.rateLimiter.consume("cm360");
+        const report = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports`, context, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(config),
+        }));
+        this.logger.info({ reportId: report.id, requestId: context?.requestId }, "CM360 scheduled report created");
+        return {
+            reportId: report.id,
+            reportName: report.name,
+            schedule: report.schedule ?? config.schedule,
+        };
+    }
+    async listReportSchedules(profileId, options = {}, context) {
+        await this.rateLimiter.consume("cm360");
+        const params = new URLSearchParams({ scope: "ALL" });
+        if (options.maxResults)
+            params.set("maxResults", String(options.maxResults));
+        if (options.pageToken)
+            params.set("pageToken", options.pageToken);
+        const result = (await this.httpClient.fetch(`/userprofiles/${profileId}/reports?${params}`, context));
+        const items = result.items ?? [];
+        const scheduled = items.filter((r) => r.schedule && r.schedule.active !== false);
+        return {
+            reports: scheduled,
+            nextPageToken: result.nextPageToken,
+        };
+    }
+    async deleteReportSchedule(profileId, reportId, context) {
+        await this.rateLimiter.consume("cm360");
+        await this.httpClient.fetch(`/userprofiles/${profileId}/reports/${reportId}`, context, {
+            method: "DELETE",
+        });
+        this.logger.info({ reportId, requestId: context?.requestId }, "CM360 scheduled report deleted");
+    }
+}
+//# sourceMappingURL=cm360-reporting-service.js.map

package/dist/services/cm360/cm360-reporting-service.js.map

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

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

@@ -0,0 +1,60 @@
+import type { Logger } from "pino";
+import type { CM360HttpClient } from "./cm360-http-client.js";
+import type { BulkResult, RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import type { CM360EntityType } from "../../mcp-server/tools/utils/entity-mapping.js";
+import type { components } from "../../generated/types.js";
+type CM360Campaign = components["schemas"]["Campaign"];
+type CM360Placement = components["schemas"]["Placement"];
+type CM360Ad = components["schemas"]["Ad"];
+type CM360Creative = components["schemas"]["Creative"];
+type CM360Site = components["schemas"]["Site"];
+type CM360Advertiser = components["schemas"]["Advertiser"];
+type CM360FloodlightActivity = components["schemas"]["FloodlightActivity"];
+type CM360FloodlightConfiguration = components["schemas"]["FloodlightConfiguration"];
+interface CM360EntityMap {
+    campaign: CM360Campaign;
+    placement: CM360Placement;
+    ad: CM360Ad;
+    creative: CM360Creative;
+    site: CM360Site;
+    advertiser: CM360Advertiser;
+    floodlightActivity: CM360FloodlightActivity;
+    floodlightConfiguration: CM360FloodlightConfiguration;
+}
+export type { CM360Campaign, CM360Placement, CM360Ad, CM360Creative, CM360Site, CM360Advertiser, CM360FloodlightActivity, CM360FloodlightConfiguration, };
+export declare class CM360Service {
+    private readonly logger;
+    private readonly rateLimiter;
+    private readonly httpClient;
+    constructor(logger: Logger, rateLimiter: RateLimiter, httpClient: CM360HttpClient);
+    listUserProfiles(context?: RequestContext): Promise<unknown>;
+    listEntities<T extends CM360EntityType>(entityType: T, profileId: string, filters?: Record<string, unknown>, pageToken?: string, maxResults?: number, context?: RequestContext): Promise<{
+        entities: CM360EntityMap[T][];
+        nextPageToken?: string;
+    }>;
+    getEntity<T extends CM360EntityType>(entityType: T, profileId: string, entityId: string, context?: RequestContext): Promise<CM360EntityMap[T]>;
+    createEntity<T extends CM360EntityType>(entityType: T, profileId: string, data: Record<string, unknown>, context?: RequestContext): Promise<CM360EntityMap[T]>;
+    updateEntity<T extends CM360EntityType>(entityType: T, profileId: string, data: Record<string, unknown>, context?: RequestContext): Promise<CM360EntityMap[T]>;
+    listTargetingOptions(profileId: string, targetingType: string, filters?: Record<string, unknown>, pageToken?: string, maxResults?: number, context?: RequestContext): Promise<{
+        options: unknown[];
+        nextPageToken?: string;
+    }>;
+    deleteEntity(entityType: CM360EntityType, profileId: string, entityId: string, context?: RequestContext): Promise<unknown>;
+    bulkCreateEntities<T extends CM360EntityType>(entityType: T, profileId: string, items: Record<string, unknown>[], context?: RequestContext): Promise<BulkResult<CM360EntityMap[T]>[]>;
+    bulkUpdateEntities<T extends CM360EntityType>(entityType: T, profileId: string, items: Array<{
+        entityId: string;
+        data: Record<string, unknown>;
+    }>, context?: RequestContext): Promise<Array<{
+        entityId: string;
+        success: boolean;
+        entity?: CM360EntityMap[T];
+        error?: string;
+    }>>;
+    bulkUpdateStatus<T extends CM360EntityType>(entityType: T, profileId: string, entityIds: string[], status: string, applyStatus: (current: Record<string, unknown>, status: string) => Record<string, unknown>, context?: RequestContext): Promise<Array<{
+        entityId: string;
+        success: boolean;
+        error?: string;
+    }>>;
+}
+//# sourceMappingURL=cm360-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cm360-service.d.ts","sourceRoot":"","sources":["../../../src/services/cm360/cm360-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAsB3D,KAAK,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;AACvD,KAAK,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;AACzD,KAAK,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,KAAK,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;AACvD,KAAK,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,KAAK,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;AAC3D,KAAK,uBAAuB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AAC3E,KAAK,4BAA4B,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,yBAAyB,CAAC,CAAC;AAErF,UAAU,cAAc;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,kBAAkB,EAAE,uBAAuB,CAAC;IAC5C,uBAAuB,EAAE,4BAA4B,CAAC;CACvD;AAED,YAAY,EACV,aAAa,EACb,cAAc,EACd,OAAO,EACP,aAAa,EACb,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,4BAA4B,GAC7B,CAAC;AAEF,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,eAAe;IAGxC,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5D,YAAY,CAAC,CAAC,SAAS,eAAe,EAC1C,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqC/D,SAAS,CAAC,CAAC,SAAS,eAAe,EACvC,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAOvB,YAAY,CAAC,CAAC,SAAS,eAAe,EAC1C,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAWvB,YAAY,CAAC,CAAC,SAAS,eAAe,EAC1C,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAWvB,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA+BpD,YAAY,CAChB,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAmBb,kBAAkB,CAAC,CAAC,SAAS,eAAe,EAChD,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAQrC,kBAAkB,CAAC,CAAC,SAAS,eAAe,EAChD,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,EACjE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CACR,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAC1F;IAqBK,gBAAgB,CAAC,CAAC,SAAS,eAAe,EAC9C,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1F,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmB1E"}

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

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import { McpError, JsonRpcErrorCode, executeBulkConcurrent, } from "@cesteral/shared";
+import { getEntityConfig } from "../../mcp-server/tools/utils/entity-mapping.js";
+const PaginatedListEnvelopeSchema = z
+    .object({
+    nextPageToken: z.string().optional(),
+})
+    .catchall(z.unknown());
+function parseListEnvelope(value, endpoint) {
+    const result = PaginatedListEnvelopeSchema.safeParse(value);
+    if (!result.success) {
+        throw new McpError(JsonRpcErrorCode.InternalError, `CM360 response from ${endpoint} did not match expected shape: ${result.error.message}`);
+    }
+    return result.data;
+}
+export class CM360Service {
+    logger;
+    rateLimiter;
+    httpClient;
+    constructor(logger, rateLimiter, httpClient) {
+        this.logger = logger;
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+    }
+    async listUserProfiles(context) {
+        await this.rateLimiter.consume("cm360");
+        this.logger.debug({ requestId: context?.requestId }, "Listing CM360 user profiles");
+        return this.httpClient.fetch("/userprofiles", context);
+    }
+    async listEntities(entityType, profileId, filters, pageToken, maxResults, context) {
+        await this.rateLimiter.consume("cm360");
+        const config = getEntityConfig(entityType);
+        const params = new URLSearchParams();
+        if (pageToken)
+            params.set("pageToken", pageToken);
+        if (maxResults)
+            params.set("maxResults", String(maxResults));
+        if (filters) {
+            for (const [key, value] of Object.entries(filters)) {
+                if (value !== undefined && value !== null) {
+                    params.set(key, String(value));
+                }
+            }
+        }
+        const queryString = params.toString();
+        const path = `/userprofiles/${profileId}/${config.apiCollection}${queryString ? `?${queryString}` : ""}`;
+        const raw = await this.httpClient.fetch(path, context);
+        const result = parseListEnvelope(raw, `GET ${path}`);
+        const rawEntities = result[config.apiCollection];
+        if (rawEntities === undefined) {
+            this.logger.warn({
+                entityType,
+                collection: config.apiCollection,
+                responseKeys: Object.keys(result),
+                requestId: context?.requestId,
+            }, `CM360 API response missing expected collection key "${config.apiCollection}" — returning empty results`);
+        }
+        const entities = (Array.isArray(rawEntities) ? rawEntities : []);
+        return { entities, nextPageToken: result.nextPageToken };
+    }
+    async getEntity(entityType, profileId, entityId, context) {
+        await this.rateLimiter.consume("cm360");
+        const config = getEntityConfig(entityType);
+        const path = `/userprofiles/${profileId}/${config.apiCollection}/${entityId}`;
+        return this.httpClient.fetch(path, context);
+    }
+    async createEntity(entityType, profileId, data, context) {
+        await this.rateLimiter.consume("cm360");
+        const config = getEntityConfig(entityType);
+        const path = `/userprofiles/${profileId}/${config.apiCollection}`;
+        return this.httpClient.fetch(path, context, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(data),
+        });
+    }
+    async updateEntity(entityType, profileId, data, context) {
+        await this.rateLimiter.consume("cm360");
+        const config = getEntityConfig(entityType);
+        const path = `/userprofiles/${profileId}/${config.apiCollection}`;
+        return this.httpClient.fetch(path, context, {
+            method: "PUT",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(data),
+        });
+    }
+    async listTargetingOptions(profileId, targetingType, filters, pageToken, maxResults, context) {
+        await this.rateLimiter.consume("cm360");
+        const params = new URLSearchParams();
+        if (pageToken)
+            params.set("pageToken", pageToken);
+        if (maxResults)
+            params.set("maxResults", String(maxResults));
+        if (filters) {
+            for (const [key, value] of Object.entries(filters)) {
+                if (value !== undefined && value !== null) {
+                    params.set(key, String(value));
+                }
+            }
+        }
+        const queryString = params.toString();
+        const path = `/userprofiles/${profileId}/${targetingType}${queryString ? `?${queryString}` : ""}`;
+        const raw = await this.httpClient.fetch(path, context);
+        const result = parseListEnvelope(raw, `GET ${path}`);
+        const rawOptions = result[targetingType];
+        if (rawOptions === undefined) {
+            this.logger.warn({ targetingType, responseKeys: Object.keys(result), requestId: context?.requestId }, `CM360 API response missing expected key "${targetingType}" — returning empty results`);
+        }
+        const options = Array.isArray(rawOptions) ? rawOptions : [];
+        return { options, nextPageToken: result.nextPageToken };
+    }
+    async deleteEntity(entityType, profileId, entityId, context) {
+        await this.rateLimiter.consume("cm360");
+        const config = getEntityConfig(entityType);
+        if (!config.supportsDelete) {
+            throw new McpError(JsonRpcErrorCode.InvalidParams, `Delete is not supported for entity type: ${entityType}`);
+        }
+        const path = `/userprofiles/${profileId}/${config.apiCollection}/${entityId}`;
+        return this.httpClient.fetch(path, context, { method: "DELETE" });
+    }
+    async bulkCreateEntities(entityType, profileId, items, context) {
+        return executeBulkConcurrent(items, (item) => this.createEntity(entityType, profileId, item, context), { logger: this.logger });
+    }
+    async bulkUpdateEntities(entityType, profileId, items, context) {
+        const bulkResults = await executeBulkConcurrent(items, (item) => this.updateEntity(entityType, profileId, { ...item.data, id: item.entityId }, context), { logger: this.logger });
+        return bulkResults.map((r, i) => ({
+            entityId: items[i].entityId,
+            success: r.success,
+            entity: r.entity,
+            error: r.error,
+        }));
+    }
+    async bulkUpdateStatus(entityType, profileId, entityIds, status, applyStatus, context) {
+        const bulkResults = await executeBulkConcurrent(entityIds, async (entityId) => {
+            const current = (await this.getEntity(entityType, profileId, entityId, context));
+            await this.updateEntity(entityType, profileId, applyStatus(current, status), context);
+            return entityId;
+        }, { logger: this.logger });
+        return bulkResults.map((r, i) => ({
+            entityId: entityIds[i],
+            success: r.success,
+            error: r.error,
+        }));
+    }
+}
+//# sourceMappingURL=cm360-service.js.map