@cesteral/gads-mcp 1.0.0

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

@@ -0,0 +1,84 @@
+import { createMcpServer } from "../server.js";
+import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
+import { GAdsHeadersAuthStrategy } from "../../auth/gads-auth-strategy.js";
+import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
+import { rateLimiter } from "../../utils/platform.js";
+function buildPlatformConfig(config, logger) {
+    return {
+        authStrategy: config.mcpAuthMode === "gads-headers"
+            ? new GAdsHeadersAuthStrategy(logger)
+            : createAuthStrategy(config.mcpAuthMode, {
+                jwtSecret: config.mcpAuthSecretKey,
+                logger,
+            }),
+        corsAllowHeaders: [
+            "Content-Type",
+            "Authorization",
+            "Mcp-Session-Id",
+            "MCP-Protocol-Version",
+            "X-GAds-Developer-Token",
+            "X-GAds-Client-Id",
+            "X-GAds-Client-Secret",
+            "X-GAds-Refresh-Token",
+            "X-GAds-Login-Customer-Id",
+        ],
+        authErrorHint: config.mcpAuthMode === "gads-headers"
+            ? "Provide Google Ads credentials via X-GAds-Developer-Token, X-GAds-Client-Id, X-GAds-Client-Secret, and X-GAds-Refresh-Token headers."
+            : "Provide a valid Bearer token in the Authorization header.",
+        sessionServiceStore,
+        rateLimiter,
+        async createSessionForAuth(authResult, sessionId, appConfig, log) {
+            const adapter = authResult.platformAuthAdapter;
+            if (adapter) {
+                await adapter.validate();
+                const services = createSessionServices(adapter, { baseUrl: appConfig.gadsApiBaseUrl }, log, rateLimiter);
+                sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                return { services };
+            }
+            if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
+                const typedConfig = appConfig;
+                if (typedConfig.gadsDeveloperToken &&
+                    typedConfig.gadsClientId &&
+                    typedConfig.gadsClientSecret &&
+                    typedConfig.gadsRefreshToken) {
+                    const { GAdsRefreshTokenAuthAdapter } = await import("../../auth/gads-auth-adapter.js");
+                    const envAdapter = new GAdsRefreshTokenAuthAdapter({
+                        developerToken: typedConfig.gadsDeveloperToken,
+                        clientId: typedConfig.gadsClientId,
+                        clientSecret: typedConfig.gadsClientSecret,
+                        refreshToken: typedConfig.gadsRefreshToken,
+                        loginCustomerId: typedConfig.gadsLoginCustomerId,
+                    });
+                    await envAdapter.validate();
+                    const services = createSessionServices(envAdapter, { baseUrl: typedConfig.gadsApiBaseUrl }, log, rateLimiter);
+                    sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
+                    return { services };
+                }
+                if (appConfig.mcpAuthMode !== "none") {
+                    return {
+                        services: null,
+                        error: {
+                            message: "Google Ads credentials required. Set GADS_DEVELOPER_TOKEN, GADS_CLIENT_ID, GADS_CLIENT_SECRET, and GADS_REFRESH_TOKEN env vars, or use MCP_AUTH_MODE=gads-headers.",
+                            status: 400,
+                        },
+                    };
+                }
+                return { services: null };
+            }
+            return {
+                services: null,
+                error: {
+                    message: "Google Ads API credentials required for this server.",
+                    status: 400,
+                },
+            };
+        },
+        async createMcpServer(log, sessionId, gcsBucket) {
+            return createMcpServer(log, sessionId, gcsBucket);
+        },
+        packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
+        serverCard: buildServerCardExtras("gads-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":"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"}

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

@@ -0,0 +1,13 @@
+import type { Logger } from "pino";
+import type { GAdsAuthAdapter } from "../../auth/gads-auth-adapter.js";
+import type { RequestContext } from "@cesteral/shared";
+export declare class GAdsHttpClient {
+    private authAdapter;
+    private baseUrl;
+    private logger;
+    constructor(authAdapter: GAdsAuthAdapter, baseUrl: string, logger: Logger);
+    get developerToken(): string;
+    get loginCustomerId(): string | undefined;
+    fetch(path: string, context?: RequestContext, options?: RequestInit): Promise<unknown>;
+}
+//# sourceMappingURL=gads-http-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gads-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/gads/gads-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAyGpE,qBAAa,cAAc;IAEvB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBAFN,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAGxB,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAUK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAqC7F"}

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

@@ -0,0 +1,113 @@
+import { JsonRpcErrorCode, executeWithRetry, fetchWithTimeout } from "@cesteral/shared";
+import { withGAdsApiSpan } from "../../utils/platform.js";
+const GADS_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialBackoffMs: 1_000,
+    maxBackoffMs: 10_000,
+    timeoutMs: 30_000,
+    platformName: "Google Ads",
+};
+function parseGAdsErrors(body) {
+    try {
+        const parsed = JSON.parse(body);
+        if (parsed.error?.details) {
+            const failures = parsed.error.details;
+            const messages = [];
+            for (const failure of failures) {
+                if (failure.errors) {
+                    for (const err of failure.errors) {
+                        const code = err.errorCode
+                            ? Object.entries(err.errorCode)
+                                .map(([k, v]) => `${k}=${v}`)
+                                .join(", ")
+                            : "unknown";
+                        messages.push(`[${code}] ${err.message || "No message"}`);
+                    }
+                }
+            }
+            if (messages.length > 0) {
+                return messages.join("; ");
+            }
+        }
+        if (parsed.error && typeof parsed.error === "object" && "message" in parsed.error) {
+            return parsed.error.message;
+        }
+        return body.substring(0, 500);
+    }
+    catch {
+        return body.substring(0, 500);
+    }
+}
+function mapGAdsStatusCode(status) {
+    if (status >= 500)
+        return JsonRpcErrorCode.ServiceUnavailable;
+    if (status === 429)
+        return JsonRpcErrorCode.RateLimited;
+    if (status === 403)
+        return JsonRpcErrorCode.Forbidden;
+    return JsonRpcErrorCode.InvalidRequest;
+}
+function buildGAdsNextAction(status, errorBody, defaultHint) {
+    if (status === 401) {
+        return "Renew the OAuth access token. Refresh tokens for Google Ads typically expire after extended inactivity — re-run the OAuth consent flow to obtain a new refresh token.";
+    }
+    if (status === 403) {
+        if (/developer.?token/i.test(errorBody)) {
+            return "The developer token is missing or not approved for production. Verify the token in the Google Ads UI (Tools & Settings → API Center) and ensure it has standard or basic access for the customer being targeted.";
+        }
+        return "Verify the authenticated user has permission for this customer ID. Use gads_list_accounts to confirm accessible customer IDs and that the login-customer-id header reflects the manager account hierarchy.";
+    }
+    if (status === 404) {
+        return "Verify the customer/entity ID with gads_list_accounts or gads_list_entities before retrying.";
+    }
+    return defaultHint;
+}
+export class GAdsHttpClient {
+    authAdapter;
+    baseUrl;
+    logger;
+    constructor(authAdapter, baseUrl, logger) {
+        this.authAdapter = authAdapter;
+        this.baseUrl = baseUrl;
+        this.logger = logger;
+    }
+    get developerToken() {
+        return this.authAdapter.developerToken;
+    }
+    get loginCustomerId() {
+        return this.authAdapter.loginCustomerId;
+    }
+    async fetch(path, context, options) {
+        const url = `${this.baseUrl}${path}`;
+        const method = options?.method || "GET";
+        this.logger.debug({ url, method, requestId: context?.requestId }, "Making Google Ads API request");
+        return withGAdsApiSpan(`api.${method}`, path, async (span) => {
+            span.setAttribute("http.request.method", method);
+            span.setAttribute("http.url", url);
+            const result = await executeWithRetry(GADS_RETRY_CONFIG, {
+                url,
+                fetchOptions: options,
+                context,
+                logger: this.logger,
+                fetchFn: fetchWithTimeout,
+                getHeaders: async () => {
+                    const accessToken = await this.authAdapter.getAccessToken();
+                    const headers = {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${accessToken}`,
+                        "developer-token": this.authAdapter.developerToken,
+                    };
+                    if (this.authAdapter.loginCustomerId) {
+                        headers["login-customer-id"] = this.authAdapter.loginCustomerId;
+                    }
+                    return headers;
+                },
+                mapStatusCode: (status) => mapGAdsStatusCode(status),
+                parseErrorBody: parseGAdsErrors,
+                buildNextAction: buildGAdsNextAction,
+            });
+            return result;
+        });
+    }
+}
+//# sourceMappingURL=gads-http-client.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { Logger } from "pino";
+import type { GAdsHttpClient } from "./gads-http-client.js";
+import type { RateLimiter } from "@cesteral/shared";
+import { type RequestContext } from "@cesteral/shared";
+import { type GAdsEntityType } from "../../mcp-server/tools/utils/entity-mapping.js";
+import type { GoogleAdsQueryRow } from "./types.js";
+export type { GoogleAdsQueryRow };
+export declare class GAdsService {
+    private readonly logger;
+    private readonly rateLimiter;
+    private readonly httpClient;
+    constructor(logger: Logger, rateLimiter: RateLimiter, httpClient: GAdsHttpClient);
+    gaqlSearch(customerId: string, query: string, pageSize?: number, pageToken?: string, context?: RequestContext): Promise<{
+        results: GoogleAdsQueryRow[];
+        nextPageToken?: string;
+        totalResultsCount?: number;
+    }>;
+    listAccessibleCustomers(context?: RequestContext): Promise<{
+        resourceNames: string[];
+    }>;
+    getEntity(entityType: GAdsEntityType, customerId: string, entityId: string, context?: RequestContext): Promise<GoogleAdsQueryRow>;
+    listEntities(entityType: GAdsEntityType, customerId: string, filters?: Record<string, string>, pageSize?: number, pageToken?: string, orderBy?: string, context?: RequestContext): Promise<{
+        entities: GoogleAdsQueryRow[];
+        nextPageToken?: string;
+        totalResultsCount?: number;
+    }>;
+    createEntity(entityType: GAdsEntityType, customerId: string, data: Record<string, unknown>, context?: RequestContext): Promise<unknown>;
+    updateEntity(entityType: GAdsEntityType, customerId: string, entityId: string, data: Record<string, unknown>, updateMask: string, context?: RequestContext): Promise<unknown>;
+    removeEntity(entityType: GAdsEntityType, customerId: string, entityId: string, context?: RequestContext): Promise<unknown>;
+    validateEntity(entityType: GAdsEntityType, customerId: string, data: Record<string, unknown>, mode: "create" | "update", entityId?: string, updateMask?: string, context?: RequestContext): Promise<{
+        valid: boolean;
+        errors?: string[];
+    }>;
+    bulkMutate(entityType: GAdsEntityType, customerId: string, operations: Array<Record<string, unknown>>, partialFailure?: boolean, context?: RequestContext): Promise<unknown>;
+    adjustBids(customerId: string, adjustments: Array<{
+        adGroupId: string;
+        cpcBidMicros?: string;
+        cpmBidMicros?: string;
+    }>, context?: RequestContext): Promise<{
+        results: Array<{
+            adGroupId: string;
+            adGroupName?: string;
+            success: boolean;
+            previousCpcBidMicros?: string;
+            previousCpmBidMicros?: string;
+            newCpcBidMicros?: string;
+            newCpmBidMicros?: string;
+            error?: string;
+        }>;
+    }>;
+    private parsePartialFailureErrors;
+    bulkUpdateStatus(entityType: GAdsEntityType, customerId: string, entityIds: string[], status: "ENABLED" | "PAUSED" | "REMOVED", context?: RequestContext): Promise<{
+        results: Array<{
+            entityId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=gads-service.d.ts.map

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

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

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

@@ -0,0 +1,363 @@
+import { McpError, JsonRpcErrorCode } from "@cesteral/shared";
+import { getEntityConfig, buildMutateUrl, buildResourceName, assertMutateOpSupported, } from "../../mcp-server/tools/utils/entity-mapping.js";
+import { buildListQuery, buildGetByIdQuery } from "../../mcp-server/tools/utils/gaql-helpers.js";
+export class GAdsService {
+    logger;
+    rateLimiter;
+    httpClient;
+    constructor(logger, rateLimiter, httpClient) {
+        this.logger = logger;
+        this.rateLimiter = rateLimiter;
+        this.httpClient = httpClient;
+    }
+    async gaqlSearch(customerId, query, pageSize, pageToken, context) {
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ customerId, query: query.substring(0, 200) }, "Executing GAQL search");
+        const body = {
+            query,
+        };
+        if (pageSize) {
+            body.pageSize = pageSize;
+        }
+        if (pageToken) {
+            body.pageToken = pageToken;
+        }
+        const result = (await this.httpClient.fetch(`/customers/${customerId}/googleAds:search`, context, {
+            method: "POST",
+            body: JSON.stringify(body),
+        }));
+        return {
+            results: (result.results || []),
+            nextPageToken: result.nextPageToken,
+            totalResultsCount: result.totalResultsCount,
+        };
+    }
+    async listAccessibleCustomers(context) {
+        await this.rateLimiter.consume("gads:global");
+        const result = (await this.httpClient.fetch("/customers:listAccessibleCustomers", context, {
+            method: "GET",
+        }));
+        return {
+            resourceNames: result.resourceNames || [],
+        };
+    }
+    async getEntity(entityType, customerId, entityId, context) {
+        const query = buildGetByIdQuery(entityType, entityId);
+        const { results } = await this.gaqlSearch(customerId, query, 1, undefined, context);
+        if (results.length === 0) {
+            throw new McpError(JsonRpcErrorCode.NotFound, `${entityType} with ID ${entityId} not found in customer ${customerId}`);
+        }
+        return results[0];
+    }
+    async listEntities(entityType, customerId, filters, pageSize, pageToken, orderBy, context) {
+        const query = buildListQuery(entityType, filters, orderBy);
+        const result = await this.gaqlSearch(customerId, query, pageSize, pageToken, context);
+        return {
+            entities: result.results,
+            nextPageToken: result.nextPageToken,
+            totalResultsCount: result.totalResultsCount,
+        };
+    }
+    async createEntity(entityType, customerId, data, context) {
+        assertMutateOpSupported(entityType, "create");
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ entityType, customerId }, "Creating Google Ads entity");
+        const mutateUrl = buildMutateUrl(entityType, customerId);
+        const result = await this.httpClient.fetch(mutateUrl, context, {
+            method: "POST",
+            body: JSON.stringify({
+                operations: [{ create: data }],
+            }),
+        });
+        return result;
+    }
+    async updateEntity(entityType, customerId, entityId, data, updateMask, context) {
+        assertMutateOpSupported(entityType, "update");
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ entityType, customerId, entityId, updateMask }, "Updating Google Ads entity");
+        const resourceName = buildResourceName(entityType, customerId, entityId);
+        const mutateUrl = buildMutateUrl(entityType, customerId);
+        const result = await this.httpClient.fetch(mutateUrl, context, {
+            method: "POST",
+            body: JSON.stringify({
+                operations: [
+                    {
+                        update: { ...data, resourceName },
+                        updateMask: updateMask,
+                    },
+                ],
+            }),
+        });
+        return result;
+    }
+    async removeEntity(entityType, customerId, entityId, context) {
+        assertMutateOpSupported(entityType, "remove");
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ entityType, customerId, entityId }, "Removing Google Ads entity");
+        const resourceName = buildResourceName(entityType, customerId, entityId);
+        const mutateUrl = buildMutateUrl(entityType, customerId);
+        const result = await this.httpClient.fetch(mutateUrl, context, {
+            method: "POST",
+            body: JSON.stringify({
+                operations: [{ remove: resourceName }],
+            }),
+        });
+        return result;
+    }
+    async validateEntity(entityType, customerId, data, mode, entityId, updateMask, context) {
+        try {
+            assertMutateOpSupported(entityType, mode);
+        }
+        catch (err) {
+            return { valid: false, errors: [err.message] };
+        }
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ entityType, customerId, mode }, "Validating Google Ads entity (dry-run)");
+        const mutateUrl = buildMutateUrl(entityType, customerId);
+        let operations;
+        if (mode === "update") {
+            if (!entityId || !updateMask) {
+                return {
+                    valid: false,
+                    errors: ["entityId and updateMask are required for update mode validation"],
+                };
+            }
+            const resourceName = buildResourceName(entityType, customerId, entityId);
+            operations = [
+                {
+                    update: { ...data, resourceName },
+                    updateMask,
+                },
+            ];
+        }
+        else {
+            operations = [{ create: data }];
+        }
+        try {
+            await this.httpClient.fetch(mutateUrl, context, {
+                method: "POST",
+                body: JSON.stringify({
+                    operations,
+                    validateOnly: true,
+                }),
+            });
+            return { valid: true };
+        }
+        catch (error) {
+            const err = error;
+            const errorMessage = err?.message ?? String(error);
+            const errorBody = err?.data?.errorBody ?? errorMessage;
+            return { valid: false, errors: [errorBody] };
+        }
+    }
+    async bulkMutate(entityType, customerId, operations, partialFailure, context) {
+        for (const op of operations) {
+            const kind = "create" in op
+                ? "create"
+                : "update" in op
+                    ? "update"
+                    : "remove" in op
+                        ? "remove"
+                        : undefined;
+            if (!kind) {
+                throw new McpError(JsonRpcErrorCode.InvalidParams, "Each bulk mutate operation must have one of: create, update, remove");
+            }
+            assertMutateOpSupported(entityType, kind);
+        }
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ entityType, customerId, operationCount: operations.length }, "Executing bulk mutate");
+        const mutateUrl = buildMutateUrl(entityType, customerId);
+        const body = { operations };
+        if (partialFailure) {
+            body.partialFailure = true;
+        }
+        const result = await this.httpClient.fetch(mutateUrl, context, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return result;
+    }
+    async adjustBids(customerId, adjustments, context) {
+        const results = [];
+        for (const adjustment of adjustments) {
+            try {
+                const readQuery = `SELECT ad_group.id, ad_group.name, ad_group.cpc_bid_micros, ad_group.cpm_bid_micros FROM ad_group WHERE ad_group.id = ${adjustment.adGroupId}`;
+                const { results: rows } = await this.gaqlSearch(customerId, readQuery, 1, undefined, context);
+                if (rows.length === 0) {
+                    results.push({
+                        adGroupId: adjustment.adGroupId,
+                        success: false,
+                        error: `Ad group ${adjustment.adGroupId} not found in customer ${customerId}`,
+                    });
+                    continue;
+                }
+                const adGroupRow = rows[0];
+                const adGroup = adGroupRow.adGroup || {};
+                const adGroupName = adGroup.name;
+                const previousCpcBidMicros = adGroup.cpcBidMicros?.toString();
+                const previousCpmBidMicros = adGroup.cpmBidMicros?.toString();
+                const updateData = {};
+                const maskFields = [];
+                if (adjustment.cpcBidMicros !== undefined) {
+                    updateData.cpcBidMicros = adjustment.cpcBidMicros;
+                    maskFields.push("cpcBidMicros");
+                }
+                if (adjustment.cpmBidMicros !== undefined) {
+                    updateData.cpmBidMicros = adjustment.cpmBidMicros;
+                    maskFields.push("cpmBidMicros");
+                }
+                const resourceName = buildResourceName("adGroup", customerId, adjustment.adGroupId);
+                const mutateUrl = buildMutateUrl("adGroup", customerId);
+                await this.rateLimiter.consume(`gads:${customerId}`);
+                await this.httpClient.fetch(mutateUrl, context, {
+                    method: "POST",
+                    body: JSON.stringify({
+                        operations: [
+                            {
+                                update: { ...updateData, resourceName },
+                                updateMask: maskFields.join(","),
+                            },
+                        ],
+                    }),
+                });
+                results.push({
+                    adGroupId: adjustment.adGroupId,
+                    adGroupName,
+                    success: true,
+                    previousCpcBidMicros,
+                    previousCpmBidMicros,
+                    newCpcBidMicros: adjustment.cpcBidMicros,
+                    newCpmBidMicros: adjustment.cpmBidMicros,
+                });
+            }
+            catch (error) {
+                const errorMessage = error?.message ?? String(error);
+                this.logger.error({ adGroupId: adjustment.adGroupId, error: errorMessage }, "Bid adjustment failed for ad group");
+                results.push({
+                    adGroupId: adjustment.adGroupId,
+                    success: false,
+                    error: errorMessage,
+                });
+            }
+        }
+        return { results };
+    }
+    parsePartialFailureErrors(result) {
+        const errorsByIndex = new Map();
+        const partialErrors = result.partialFailureError ?? null;
+        if (!partialErrors)
+            return errorsByIndex;
+        const errorDetails = (partialErrors.details ?? []);
+        for (const detail of errorDetails) {
+            const errors = (detail?.errors ?? []);
+            for (const err of errors) {
+                const location = err?.location;
+                const fieldPathElements = (location?.fieldPathElements ?? []);
+                const opElement = fieldPathElements.find((el) => el.fieldName === "operations" && el.index != null);
+                const opIndex = opElement ? Number(opElement.index) : -1;
+                const message = err?.message ??
+                    (err?.errorCode ? JSON.stringify(err.errorCode) : "Unknown error");
+                if (opIndex >= 0) {
+                    errorsByIndex.set(opIndex, message);
+                }
+            }
+        }
+        return errorsByIndex;
+    }
+    async bulkUpdateStatus(entityType, customerId, entityIds, status, context) {
+        await this.rateLimiter.consume(`gads:${customerId}`);
+        this.logger.debug({ entityType, customerId, count: entityIds.length, status }, "Executing bulk status update");
+        const config = getEntityConfig(entityType);
+        const mutateUrl = buildMutateUrl(entityType, customerId);
+        if (!config.statusField && status !== "REMOVED") {
+            return {
+                results: entityIds.map((entityId) => ({
+                    entityId,
+                    success: false,
+                    error: `Entity type "${entityType}" does not have a status field and cannot be set to ${status}`,
+                })),
+            };
+        }
+        const statusFieldParts = (config.statusField || "").split(".");
+        const statusProperty = statusFieldParts[statusFieldParts.length - 1] || "status";
+        if (status === "REMOVED") {
+            const operations = entityIds.map((entityId) => ({
+                remove: buildResourceName(entityType, customerId, entityId),
+            }));
+            try {
+                const result = (await this.httpClient.fetch(mutateUrl, context, {
+                    method: "POST",
+                    body: JSON.stringify({ operations, partialFailure: true }),
+                }));
+                const errorsByIndex = this.parsePartialFailureErrors(result);
+                const mutateResults = result.results || [];
+                return {
+                    results: entityIds.map((entityId, idx) => {
+                        const error = errorsByIndex.get(idx);
+                        if (error) {
+                            return { entityId, success: false, error };
+                        }
+                        const resultEntry = mutateResults[idx];
+                        const hasResult = resultEntry && Object.keys(resultEntry).length > 0;
+                        return {
+                            entityId,
+                            success: hasResult,
+                            error: !hasResult ? "Operation produced no result" : undefined,
+                        };
+                    }),
+                };
+            }
+            catch (error) {
+                const errorMessage = error?.message ?? String(error);
+                return {
+                    results: entityIds.map((entityId) => ({
+                        entityId,
+                        success: false,
+                        error: errorMessage,
+                    })),
+                };
+            }
+        }
+        const operations = entityIds.map((entityId) => ({
+            update: {
+                resourceName: buildResourceName(entityType, customerId, entityId),
+                [statusProperty]: status,
+            },
+            updateMask: statusProperty,
+        }));
+        try {
+            const result = (await this.httpClient.fetch(mutateUrl, context, {
+                method: "POST",
+                body: JSON.stringify({ operations, partialFailure: true }),
+            }));
+            const errorsByIndex = this.parsePartialFailureErrors(result);
+            const mutateResults = result.results || [];
+            return {
+                results: entityIds.map((entityId, idx) => {
+                    const error = errorsByIndex.get(idx);
+                    if (error) {
+                        return { entityId, success: false, error };
+                    }
+                    const resultEntry = mutateResults[idx];
+                    const hasResult = resultEntry && Object.keys(resultEntry).length > 0;
+                    return {
+                        entityId,
+                        success: hasResult,
+                        error: !hasResult ? "Operation produced no result" : undefined,
+                    };
+                }),
+            };
+        }
+        catch (error) {
+            const errorMessage = error?.message ?? String(error);
+            return {
+                results: entityIds.map((entityId) => ({
+                    entityId,
+                    success: false,
+                    error: errorMessage,
+                })),
+            };
+        }
+    }
+}
+//# sourceMappingURL=gads-service.js.map