mcp-google-ads 1.1.0 → 1.2.2

package/dist/removeHelpers.d.ts

@@ -0,0 +1,41 @@
+export interface RemoveArgs {
+    customer_id?: string;
+    campaign_ids?: string[];
+    ad_group_ids?: string[];
+    ad_ids?: string[];
+    confirm?: boolean;
+    labels?: string[];
+}
+export declare function coerceStringArray(v: unknown): string[] | undefined;
+export declare function normalizeRemoveArgs(raw: Record<string, unknown> | undefined): RemoveArgs;
+export type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateRemoveInput(args: RemoveArgs): ValidationResult;
+export interface RemovePreview {
+    dry_run: true;
+    message: string;
+    customer_id: string;
+    would_remove: {
+        campaigns: string[];
+        ad_groups: string[];
+        ads: string[];
+    };
+    labels_to_apply: string[];
+    removal_order: string;
+}
+export declare function buildRemovePreview(args: RemoveArgs): RemovePreview;
+export type RemovalStep = {
+    type: "ads";
+    ids: string[];
+} | {
+    type: "ad_groups";
+    ids: string[];
+} | {
+    type: "campaigns";
+    ids: string[];
+};
+export declare function orderRemovalsChildUp(args: RemoveArgs): RemovalStep[];

package/dist/removeHelpers.js

@@ -0,0 +1,68 @@
+function coerceStringArray(v) {
+  if (v == null) return void 0;
+  if (Array.isArray(v)) return v.map(String);
+  if (typeof v === "string") {
+    const trimmed = v.trim();
+    if (trimmed.startsWith("[")) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed)) return parsed.map(String);
+      } catch {
+      }
+    }
+    return [trimmed];
+  }
+  return void 0;
+}
+function normalizeRemoveArgs(raw) {
+  const r = raw ?? {};
+  return {
+    customer_id: typeof r.customer_id === "string" ? r.customer_id : void 0,
+    campaign_ids: coerceStringArray(r.campaign_ids),
+    ad_group_ids: coerceStringArray(r.ad_group_ids),
+    ad_ids: coerceStringArray(r.ad_ids),
+    confirm: r.confirm === true || r.confirm === "true",
+    labels: coerceStringArray(r.labels)
+  };
+}
+function validateRemoveInput(args) {
+  const hasCampaigns = (args.campaign_ids?.length ?? 0) > 0;
+  const hasAdGroups = (args.ad_group_ids?.length ?? 0) > 0;
+  const hasAds = (args.ad_ids?.length ?? 0) > 0;
+  if (!hasCampaigns && !hasAdGroups && !hasAds) {
+    return {
+      ok: false,
+      error: "No item IDs provided. Specify campaign_ids, ad_group_ids, or ad_ids."
+    };
+  }
+  return { ok: true };
+}
+function buildRemovePreview(args) {
+  return {
+    dry_run: true,
+    message: "DRY RUN. Nothing removed. Pass confirm: true to actually remove.",
+    customer_id: args.customer_id ?? "",
+    would_remove: {
+      campaigns: args.campaign_ids ?? [],
+      ad_groups: args.ad_group_ids ?? [],
+      ads: args.ad_ids ?? []
+    },
+    labels_to_apply: args.labels ?? [],
+    removal_order: "ads \u2192 ad_groups \u2192 campaigns (child-up, so parent removes don't fail on enabled children)"
+  };
+}
+function orderRemovalsChildUp(args) {
+  const steps = [];
+  if (args.ad_ids?.length) steps.push({ type: "ads", ids: args.ad_ids });
+  if (args.ad_group_ids?.length) steps.push({ type: "ad_groups", ids: args.ad_group_ids });
+  if (args.campaign_ids?.length) steps.push({ type: "campaigns", ids: args.campaign_ids });
+  return steps;
+}
+export {
+  buildRemovePreview,
+  coerceStringArray,
+  normalizeRemoveArgs,
+  orderRemovalsChildUp,
+  validateRemoveInput
+};
+//# sourceMappingURL=removeHelpers.js.map

package/dist/tools.js

@@ -104,21 +104,56 @@ const tools = [
   },
   {
     name: "google_ads_create_campaign",
-    description: "Create a new campaign (will be PAUSED until approved). Returns campaign ID.",
+    description: "Create a new campaign (will be PAUSED until approved). Defaults: channel_type=SEARCH, bidding_strategy=MANUAL_CPC (SEARCH) or MAXIMIZE_CONVERSIONS (DEMAND_GEN), language_id=1000 (English). For DEMAND_GEN provide geo_target_ids (Google Ads geo target constant IDs, e.g. '21134' for Alaska). TARGET_CPA requires target_cpa (dollars). MAXIMIZE_CLICKS may take target_cpc_cap (dollars). start_date/end_date are YYYY-MM-DD.",
     inputSchema: {
       additionalProperties: false,
       type: "object",
       properties: {
         customer_id: { type: "string" },
         name: { type: "string" },
-        daily_budget: { type: "number", description: "Daily budget in dollars" }
+        daily_budget: { type: "number", description: "Daily budget in dollars" },
+        channel_type: {
+          type: "string",
+          enum: ["SEARCH", "DEMAND_GEN"],
+          description: "Advertising channel type. Defaults to SEARCH."
+        },
+        bidding_strategy: {
+          type: "string",
+          enum: ["MANUAL_CPC", "MAXIMIZE_CLICKS", "MAXIMIZE_CONVERSIONS", "TARGET_CPA"],
+          description: "Bidding strategy. Defaults to MANUAL_CPC for SEARCH, MAXIMIZE_CONVERSIONS for DEMAND_GEN."
+        },
+        target_cpa: {
+          type: "number",
+          description: "Target CPA in dollars (required if bidding_strategy=TARGET_CPA)."
+        },
+        target_cpc_cap: {
+          type: "number",
+          description: "Optional CPC ceiling in dollars for MAXIMIZE_CLICKS strategy."
+        },
+        geo_target_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "Google Ads geo target constant IDs (e.g. '21134' = Alaska, '21141' = Maine)."
+        },
+        language_id: {
+          type: "string",
+          description: "Language constant ID. Defaults to '1000' (English)."
+        },
+        start_date: {
+          type: "string",
+          description: "YYYY-MM-DD start date (optional)."
+        },
+        end_date: {
+          type: "string",
+          description: "YYYY-MM-DD end date (optional)."
+        }
       },
       required: ["name", "daily_budget"]
     }
   },
   {
     name: "google_ads_create_ad_group",
-    description: "Create a new ad group (will be PAUSED until approved). Returns ad group ID.",
+    description: "Create a new ad group (will be PAUSED until approved). Returns ad group ID. type defaults to SEARCH_STANDARD for back-compat; use DEMAND_GEN_MULTI_ASSET_AD_GROUP for Demand Gen campaigns.",
     inputSchema: {
       additionalProperties: false,
       type: "object",
@@ -126,7 +161,12 @@ const tools = [
         customer_id: { type: "string" },
         campaign_id: { type: "string" },
         name: { type: "string" },
-        cpc_bid: { type: "number", description: "CPC bid in dollars" }
+        cpc_bid: { type: "number", description: "CPC bid in dollars" },
+        type: {
+          type: "string",
+          enum: ["SEARCH_STANDARD", "DEMAND_GEN_MULTI_ASSET_AD_GROUP"],
+          description: "Ad group type. Defaults to SEARCH_STANDARD. Use DEMAND_GEN_MULTI_ASSET_AD_GROUP for Demand Gen campaigns."
+        }
       },
       required: ["campaign_id", "name"]
     }
@@ -220,7 +260,7 @@ const tools = [
   },
   {
     name: "google_ads_enable_items",
-    description: "Enable paused campaigns, ad groups, or ads. REQUIRES USER APPROVAL. Use after reviewing in Google Ads UI.",
+    description: "Enable paused campaigns, ad groups, or ads. REQUIRES USER APPROVAL. Use after reviewing in Google Ads UI. Auto-applies today's `Claude-MM-DD-YY` label; pass `labels` to attach additional custom labels so different enable operations stay distinguishable.",
     inputSchema: {
       additionalProperties: false,
       type: "object",
@@ -228,13 +268,18 @@ const tools = [
         customer_id: { type: "string" },
         campaign_ids: { type: "array", items: { type: "string" } },
         ad_group_ids: { type: "array", items: { type: "string" } },
-        ad_ids: { type: "array", items: { type: "string" } }
+        ad_ids: { type: "array", items: { type: "string" } },
+        labels: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional custom labels to apply to every enabled item (in addition to the auto-applied `Claude-MM-DD-YY` label). Labels are created if they don't exist."
+        }
       }
     }
   },
   {
     name: "google_ads_pause_items",
-    description: "Pause enabled campaigns, ad groups, or ads. REQUIRES USER APPROVAL. This will stop items from serving.",
+    description: "Pause enabled campaigns, ad groups, or ads. REQUIRES USER APPROVAL. This will stop items from serving. Auto-applies today's `Claude-MM-DD-YY` label; pass `labels` to attach additional custom labels so different pause operations stay distinguishable (e.g. `fix-landing-page-redirect`).",
     inputSchema: {
       additionalProperties: false,
       type: "object",
@@ -242,10 +287,57 @@ const tools = [
         customer_id: { type: "string" },
         campaign_ids: { type: "array", items: { type: "string" } },
         ad_group_ids: { type: "array", items: { type: "string" } },
-        ad_ids: { type: "array", items: { type: "string" } }
+        ad_ids: { type: "array", items: { type: "string" } },
+        labels: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional custom labels to apply to every paused item (in addition to the auto-applied `Claude-MM-DD-YY` label). Labels are created if they don't exist."
+        }
       }
     }
   },
+  {
+    name: "google_ads_remove_items",
+    description: "Remove campaigns, ad groups, or ads permanently. IRREVERSIBLE at the API level (reports on removed resources still work). DRY-RUN BY DEFAULT: omit `confirm` or pass `confirm: false` to get a preview; pass `confirm: true` to actually remove. Labels are applied BEFORE removal so the audit trail survives. Removals run in child-up order (ads \u2192 ad_groups \u2192 campaigns) so parent removes don't fail on enabled children. Auto-applies today's `Claude-MM-DD-YY` label.",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        campaign_ids: { type: "array", items: { type: "string" } },
+        ad_group_ids: { type: "array", items: { type: "string" } },
+        ad_ids: { type: "array", items: { type: "string" } },
+        confirm: {
+          type: "boolean",
+          description: "Must be true to actually remove. Omit or false for dry-run preview."
+        },
+        labels: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional custom labels to apply BEFORE removal (label-first ordering keeps the audit trail intact). Labels are created if they don't exist."
+        }
+      }
+    }
+  },
+  {
+    name: "google_ads_apply_label",
+    description: "Attach a label to existing campaigns, ad groups, or ads without changing their status. Label is created if it doesn't exist. Useful for tagging items for audit trails or bulk ops.",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        label: {
+          type: "string",
+          description: "Label name. Created if it doesn't exist."
+        },
+        campaign_ids: { type: "array", items: { type: "string" } },
+        ad_group_ids: { type: "array", items: { type: "string" } },
+        ad_ids: { type: "array", items: { type: "string" } }
+      },
+      required: ["label"]
+    }
+  },
   {
     name: "google_ads_create_shared_set",
     description: "Create a new shared negative keyword list at account level. Returns the new shared set ID.",
@@ -590,6 +682,26 @@ const tools = [
       required: ["campaign_id", "daily_budget"]
     }
   },
+  {
+    name: "google_ads_update_campaign_bidding",
+    description: "Update a campaign's bidding strategy and/or target CPA / target ROAS. If `strategy` is omitted the current strategy is preserved and only the target values are updated (useful for adding a tCPA to an existing Max Conversions campaign). Dollar amounts are in dollars (converted to micros internally). target_roas is a decimal (e.g., 3.0 = 300%).",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        campaign_id: { type: "string", description: "The numeric string campaign ID to update" },
+        strategy: {
+          type: "string",
+          enum: ["MAXIMIZE_CONVERSIONS", "MAXIMIZE_CONVERSION_VALUE", "TARGET_CPA", "TARGET_ROAS", "MANUAL_CPC", "MAXIMIZE_CLICKS"],
+          description: "Optional. New bidding strategy. If omitted, keeps current strategy and only updates target values."
+        },
+        target_cpa_dollars: { type: "number", description: "Target CPA in dollars. Applies to MAXIMIZE_CONVERSIONS (optional ceiling) or TARGET_CPA (required)." },
+        target_roas: { type: "number", description: "Target ROAS as decimal (3.0 = 300%). Applies to MAXIMIZE_CONVERSION_VALUE or TARGET_ROAS." }
+      },
+      required: ["campaign_id"]
+    }
+  },
   {
     name: "google_ads_gaql_query",
     description: "Execute a raw GAQL (Google Ads Query Language) query. Use this for custom reports or accessing any Google Ads API resource not covered by other tools. See https://developers.google.com/google-ads/api/docs/query/overview for GAQL syntax.",
@@ -603,6 +715,60 @@ const tools = [
       required: ["query"]
     }
   },
+  {
+    name: "google_ads_update_asset_urls",
+    description: "Update the final_urls on one or more assets (e.g. sitelinks, callouts). DRY-RUN BY DEFAULT: omit `confirm` or pass `confirm: false` to get a preview. Updating an asset's URL affects EVERY campaign/ad group/customer link that uses that asset ID -- use GAQL against customer_asset/campaign_asset/ad_group_asset to check attachments first.",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        updates: {
+          type: "array",
+          description: "List of assets to update.",
+          items: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+              asset_id: { type: "string", description: "Numeric asset ID" },
+              final_urls: {
+                type: "array",
+                items: { type: "string" },
+                description: "New final URLs. Must start with http:// or https://."
+              }
+            },
+            required: ["asset_id", "final_urls"]
+          }
+        },
+        confirm: {
+          type: "boolean",
+          description: "Must be true to actually update. Omit or false for dry-run preview."
+        }
+      },
+      required: ["updates"]
+    }
+  },
+  {
+    name: "google_ads_pause_asset_links",
+    description: "Pause asset links (customer_asset, campaign_asset, or ad_group_asset). Use this to stop a sitelink from serving without deleting the underlying asset. DRY-RUN BY DEFAULT: omit `confirm` or pass `confirm: false` to get a preview. Resource name form: customers/{cid}/customerAssets/{assetId}~SITELINK, customers/{cid}/campaignAssets/{campId}~{assetId}~SITELINK, or customers/{cid}/adGroupAssets/{agId}~{assetId}~SITELINK.",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        resource_names: {
+          type: "array",
+          items: { type: "string" },
+          description: "Full resource names of the asset links to pause."
+        },
+        confirm: {
+          type: "boolean",
+          description: "Must be true to actually pause. Omit or false for dry-run preview."
+        }
+      },
+      required: ["resource_names"]
+    }
+  },
   {
     name: "google_ads_keyword_volume",
     description: "Get historical search volume estimates for a list of keywords using the Google Ads Keyword Planner. Returns avg monthly searches, competition level, and CPC bid range for each keyword.",
@@ -628,6 +794,100 @@ const tools = [
       },
       required: ["keywords"]
     }
+  },
+  {
+    name: "google_ads_create_demand_gen_multi_asset_ad",
+    description: "Create a Demand Gen Multi-Asset ad under a DEMAND_GEN_MULTI_ASSET_AD_GROUP (will be PAUSED until approved). Validates character limits and count caps before the API call: headlines (max 5, \u226440 chars each), long_headlines (max 5, \u226490 chars), descriptions (max 5, \u226490 chars). marketing_image_asset_ids is required (1:1 square images, \u22651); square/portrait/logo assets are optional. call_to_action is a string enum value such as 'LEARN_MORE' or 'SHOP_NOW'. Auto-labels the created ad.",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        ad_group_id: { type: "string" },
+        final_urls: { type: "array", items: { type: "string" } },
+        business_name: { type: "string" },
+        call_to_action: {
+          type: "string",
+          description: "CallToAction enum value, e.g. LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, BOOK_NOW, CONTACT_US, GET_QUOTE, APPLY_NOW, SUBSCRIBE, BUY_NOW, DONATE_NOW, ORDER_NOW, PLAY_NOW, SEE_MORE, START_NOW, VISIT_SITE, WATCH_NOW."
+        },
+        marketing_image_asset_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "1.91:1 landscape marketing image asset IDs (min 1). Get IDs from google_ads_create_image_asset."
+        },
+        square_marketing_image_asset_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional 1:1 square marketing image asset IDs."
+        },
+        portrait_marketing_image_asset_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional 4:5 portrait marketing image asset IDs."
+        },
+        logo_image_asset_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional 1:1 logo image asset IDs."
+        },
+        headlines: {
+          type: "array",
+          description: "Max 5 headlines, each \u226440 characters. Each item is a string or { text, pinned_position? }.",
+          items: {
+            oneOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  text: { type: "string" },
+                  pinned_position: { type: "number" }
+                },
+                required: ["text"]
+              }
+            ]
+          }
+        },
+        long_headlines: {
+          type: "array",
+          description: "Max 5 long headlines, each \u226490 characters.",
+          items: { type: "string" }
+        },
+        descriptions: {
+          type: "array",
+          description: "Max 5 descriptions, each \u226490 characters.",
+          items: { type: "string" }
+        },
+        labels: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional additional labels (auto-applied Claude-MM-DD-YY label is added regardless)."
+        }
+      },
+      required: [
+        "ad_group_id",
+        "final_urls",
+        "business_name",
+        "call_to_action",
+        "marketing_image_asset_ids",
+        "headlines",
+        "descriptions"
+      ]
+    }
+  },
+  {
+    name: "google_ads_create_image_asset",
+    description: "Upload an image asset for use in Demand Gen (or other image-capable) ads. Provide exactly one of file_path (absolute path to PNG/JPG/GIF on disk) or base64_data (raw base64, no data URL prefix). Validates mime type, max 5MB, min dimensions 600x314 (Demand Gen minimum). Auto-labels the created asset. Returns {asset_id, resource_name, name, bytes, mime_type}.",
+    inputSchema: {
+      additionalProperties: false,
+      type: "object",
+      properties: {
+        customer_id: { type: "string" },
+        name: { type: "string", description: "Human-readable asset name (shown in the Google Ads UI)." },
+        file_path: { type: "string", description: "Absolute path to the image on disk. Mutually exclusive with base64_data." },
+        base64_data: { type: "string", description: "Raw base64-encoded image data (no 'data:image/...;base64,' prefix). Mutually exclusive with file_path." }
+      },
+      required: ["name"]
+    }
   }
 ];
 export {

package/dist/validateDemandGenAd.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Pure validation for Demand Gen multi-asset ads. Kept as a standalone module
+ * so we don't need to stand up a live Google Ads client to unit test the
+ * rules. Rules come from Google Ads API docs for DemandGenMultiAssetAdInfo:
+ *   - headlines:       max 5, each ≤ 40 chars
+ *   - long_headlines:  max 5, each ≤ 90 chars
+ *   - descriptions:    max 5, each ≤ 90 chars
+ *   - marketing_image_asset_ids: required, ≥ 1 (1.91:1 landscape images)
+ *   - business_name:   required, non-empty
+ *   - call_to_action:  required, non-empty (string CTA enum value)
+ *   - final_urls:      required, ≥ 1
+ */
+export interface DemandGenAdInput {
+    final_urls: string[];
+    business_name: string;
+    call_to_action: string;
+    marketing_image_asset_ids: string[];
+    square_marketing_image_asset_ids?: string[];
+    portrait_marketing_image_asset_ids?: string[];
+    logo_image_asset_ids?: string[];
+    headlines: Array<string | {
+        text: string;
+        pinned_position?: number;
+    }>;
+    long_headlines?: string[];
+    descriptions: string[];
+    labels?: string[];
+}
+export interface DemandGenAdValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare const MAX_HEADLINES = 5;
+export declare const MAX_HEADLINE_LEN = 40;
+export declare const MAX_LONG_HEADLINES = 5;
+export declare const MAX_LONG_HEADLINE_LEN = 90;
+export declare const MAX_DESCRIPTIONS = 5;
+export declare const MAX_DESCRIPTION_LEN = 90;
+/**
+ * Build the raw Google Ads DemandGenMultiAssetAdInfo payload. Asset IDs in the
+ * input are expanded to full resource names. Optional image fields are only
+ * set when the caller provided a non-empty list.
+ *
+ * NOTE: the v23 typed helper for AdService is missing the long_headlines field
+ * on DemandGenMultiAssetAdInfo. We emit long_headlines regardless; the payload
+ * is submitted via customer.mutateResources which accepts unknown fields and
+ * forwards them to the server.
+ */
+export interface DemandGenAdPayload {
+    ad_group: string;
+    status: number;
+    ad: {
+        final_urls: string[];
+        demand_gen_multi_asset_ad: Record<string, any>;
+    };
+}
+export declare function buildDemandGenAdPayload(args: {
+    customer_id_clean: string;
+    ad_group_id: string;
+    input: DemandGenAdInput;
+}): DemandGenAdPayload;
+export declare function validateDemandGenAd(ad: DemandGenAdInput): DemandGenAdValidationResult;

package/dist/validateDemandGenAd.js

@@ -0,0 +1,96 @@
+const MAX_HEADLINES = 5;
+const MAX_HEADLINE_LEN = 40;
+const MAX_LONG_HEADLINES = 5;
+const MAX_LONG_HEADLINE_LEN = 90;
+const MAX_DESCRIPTIONS = 5;
+const MAX_DESCRIPTION_LEN = 90;
+function headlineText(h) {
+  return typeof h === "string" ? h : h.text;
+}
+function buildDemandGenAdPayload(args) {
+  const { customer_id_clean, ad_group_id, input } = args;
+  const assetRef = (id) => ({ asset: `customers/${customer_id_clean}/assets/${id}` });
+  const dgAd = {
+    business_name: input.business_name,
+    call_to_action_text: input.call_to_action,
+    marketing_images: input.marketing_image_asset_ids.map(assetRef),
+    headlines: input.headlines.map((h) => ({ text: headlineText(h) })),
+    descriptions: input.descriptions.map((t) => ({ text: t }))
+  };
+  if (input.square_marketing_image_asset_ids?.length) {
+    dgAd.square_marketing_images = input.square_marketing_image_asset_ids.map(assetRef);
+  }
+  if (input.portrait_marketing_image_asset_ids?.length) {
+    dgAd.portrait_marketing_images = input.portrait_marketing_image_asset_ids.map(assetRef);
+  }
+  if (input.logo_image_asset_ids?.length) {
+    dgAd.logo_images = input.logo_image_asset_ids.map(assetRef);
+  }
+  if (input.long_headlines?.length) {
+    dgAd.long_headlines = input.long_headlines.map((t) => ({ text: t }));
+  }
+  return {
+    ad_group: `customers/${customer_id_clean}/adGroups/${ad_group_id}`,
+    status: 3,
+    ad: {
+      final_urls: input.final_urls,
+      demand_gen_multi_asset_ad: dgAd
+    }
+  };
+}
+function validateDemandGenAd(ad) {
+  const errors = [];
+  if (!ad.final_urls || ad.final_urls.length === 0) {
+    errors.push("At least one final URL is required");
+  }
+  if (!ad.business_name || !ad.business_name.trim()) {
+    errors.push("business_name is required");
+  }
+  if (!ad.call_to_action || !ad.call_to_action.trim()) {
+    errors.push("call_to_action is required (e.g. 'LEARN_MORE')");
+  }
+  if (!ad.marketing_image_asset_ids || ad.marketing_image_asset_ids.length === 0) {
+    errors.push("At least one marketing_image_asset_id is required");
+  }
+  if (!ad.headlines || ad.headlines.length === 0) {
+    errors.push("At least one headline is required");
+  } else if (ad.headlines.length > MAX_HEADLINES) {
+    errors.push(`Maximum ${MAX_HEADLINES} headlines, got ${ad.headlines.length}`);
+  }
+  (ad.headlines ?? []).forEach((h, i) => {
+    const text = headlineText(h);
+    if (text.length > MAX_HEADLINE_LEN) {
+      errors.push(`Headline ${i + 1} too long (${text.length}/${MAX_HEADLINE_LEN}): "${text}"`);
+    }
+  });
+  if (ad.long_headlines && ad.long_headlines.length > MAX_LONG_HEADLINES) {
+    errors.push(`Maximum ${MAX_LONG_HEADLINES} long_headlines, got ${ad.long_headlines.length}`);
+  }
+  (ad.long_headlines ?? []).forEach((t, i) => {
+    if (t.length > MAX_LONG_HEADLINE_LEN) {
+      errors.push(`Long headline ${i + 1} too long (${t.length}/${MAX_LONG_HEADLINE_LEN}): "${t}"`);
+    }
+  });
+  if (!ad.descriptions || ad.descriptions.length === 0) {
+    errors.push("At least one description is required");
+  } else if (ad.descriptions.length > MAX_DESCRIPTIONS) {
+    errors.push(`Maximum ${MAX_DESCRIPTIONS} descriptions, got ${ad.descriptions.length}`);
+  }
+  (ad.descriptions ?? []).forEach((t, i) => {
+    if (t.length > MAX_DESCRIPTION_LEN) {
+      errors.push(`Description ${i + 1} too long (${t.length}/${MAX_DESCRIPTION_LEN}): "${t}"`);
+    }
+  });
+  return { valid: errors.length === 0, errors };
+}
+export {
+  MAX_DESCRIPTIONS,
+  MAX_DESCRIPTION_LEN,
+  MAX_HEADLINES,
+  MAX_HEADLINE_LEN,
+  MAX_LONG_HEADLINES,
+  MAX_LONG_HEADLINE_LEN,
+  buildDemandGenAdPayload,
+  validateDemandGenAd
+};
+//# sourceMappingURL=validateDemandGenAd.js.map

package/dist/validateRsa.d.ts

@@ -22,3 +22,14 @@ export interface RsaValidationResult {
     errors: string[];
 }
 export declare function validateRsa(ad: RsaInput): RsaValidationResult;
+/**
+ * Compute the length Google Ads will actually validate against, after
+ * substituting dynamic insertions:
+ *   - {KeyWord:default} / {Keyword:default} / {keyword:default} / {KEYWORD:default}
+ *     → rendered as the default text
+ *   - {CUSTOMIZER.Name:default} → rendered as the default text
+ *   - {CUSTOMIZER.Name}        → rendered as a conservative estimate
+ *
+ * Applies to headlines, descriptions, and display paths alike.
+ */
+export declare function effectiveTextLength(text: string): number;