@koda-sl/baker-cli 0.254.1 → 0.255.0-dev.8030cfcf9

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-SJPRTSGY.js";
+} from "./chunk-HBDGUVUH.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -2113,7 +2113,14 @@ var GOOGLE_ADS_LIMITS = {
     // Google's published headers (`structured-snippet-headers.ts`), the longest
     // of which is 29 characters. Only the values are capped.
     structuredSnippetValuesMin: 3,
-    structuredSnippetValuesMax: 10
+    structuredSnippetValuesMax: 10,
+    /**
+     * Per VALUE, not per asset. Google rejects a 26-character value with a bare "Too long." at
+     * `structured_snippet_asset.values[i]` — one red row inside an otherwise clean publish, plus
+     * every link that depends on the asset. Confirmed live on v23: "Bases de datos vectoriales"
+     * (26) rejected, its four neighbours accepted.
+     */
+    structuredSnippetValueMax: 25
   },
   conversionAction: {
     nameMax: 255
@@ -2273,9 +2280,24 @@ var ASSET_FIELD_TYPES = [
   "HEADLINE",
   "DESCRIPTION",
   "LOGO",
+  /**
+   * Kept because a draft staged before {@link IMAGE_ASSET_LINK_MESSAGE} shipped may still carry one,
+   * and because it is the field type an asset-group image occupies. It is refused on an
+   * `assetLink.attach` — see that message for what Google actually does with it.
+   */
   "MARKETING_IMAGE",
   "BUSINESS_NAME"
 ];
+var IMAGE_ASSET_LINK_FIELD_TYPES = /* @__PURE__ */ new Set([
+  "MARKETING_IMAGE",
+  "SQUARE_MARKETING_IMAGE",
+  "PORTRAIT_MARKETING_IMAGE",
+  "AD_IMAGE"
+]);
+var IMAGE_ASSET_LINK_MESSAGE = "Google does not accept an image through an asset link. MARKETING_IMAGE is a Performance Max asset-group slot (use `asset-groups attach`), and AD_IMAGE \u2014 the field type Google names for a Search image extension \u2014 comes back UNSUPPORTED_FIELD_TYPE at campaign and ad group level alike. Image extensions are not reachable through the API: tell the user to add them in the Google Ads interface, and carry on with the rest of the job.";
+function isImageAssetLinkFieldType(fieldType) {
+  return IMAGE_ASSET_LINK_FIELD_TYPES.has(fieldType);
+}
 var ASSET_GROUP_ASSET_FIELD_TYPES = [
   "MARKETING_IMAGE",
   "SQUARE_MARKETING_IMAGE",
@@ -3123,7 +3145,7 @@ var structuredSnippetHeaderSchema = z4.string().min(1).transform((header, ctx) =
 var structuredSnippetAssetSchema = z4.object({
   type: z4.literal("structuredSnippet"),
   header: structuredSnippetHeaderSchema,
-  values: z4.array(z4.string().min(1)).min(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMin).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMax)
+  values: z4.array(z4.string().min(1).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValueMax)).min(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMin).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMax)
 });
 var callToActionAssetSchema = z4.object({ type: z4.literal("callToAction"), callToAction: z4.string().min(1) });
 var assetCreateSchema = z4.discriminatedUnion("type", [
@@ -3143,7 +3165,7 @@ var assetUpdateSchema = z4.object({
   finalUrls: z4.array(httpsUrlSchema2).min(1).optional(),
   calloutText: z4.string().min(1).max(GOOGLE_ADS_LIMITS.asset.calloutTextMax).optional(),
   header: structuredSnippetHeaderSchema.optional(),
-  values: z4.array(z4.string().min(1)).min(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMin).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMax).optional(),
+  values: z4.array(z4.string().min(1).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValueMax)).min(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMin).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMax).optional(),
   callToAction: z4.string().min(1).optional(),
   text: z4.string().min(1).optional()
 }).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
@@ -3151,7 +3173,11 @@ var assetLinkAttachSchema = z4.object({
   level: z4.enum(["campaign", "adGroup", "customer"]),
   parent: refSchema.optional(),
   asset: refSchema,
-  fieldType: z4.enum(ASSET_FIELD_TYPES)
+  // A plain string, not `z.enum(ASSET_FIELD_TYPES)`, so the image refusal below can answer with
+  // the reason instead of an enum listing. An agent reaching for AD_IMAGE is following Google's
+  // own documentation; "Invalid option: expected one of …" sends it to guess another field type,
+  // which is the failure this whole refusal exists to end.
+  fieldType: z4.string().min(1)
 }).superRefine((value, ctx) => {
   if (value.level !== "customer" && !value.parent) {
     ctx.addIssue({
@@ -3160,6 +3186,15 @@ var assetLinkAttachSchema = z4.object({
       message: `parent is required for a ${value.level}-level asset link (--parent-ref)`
     });
   }
+  if (isImageAssetLinkFieldType(value.fieldType)) {
+    ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["fieldType"], message: IMAGE_ASSET_LINK_MESSAGE });
+  } else if (!ASSET_FIELD_TYPES.includes(value.fieldType)) {
+    ctx.addIssue({
+      code: z4.ZodIssueCode.custom,
+      path: ["fieldType"],
+      message: `expected one of ${ASSET_FIELD_TYPES.join(" | ")}`
+    });
+  }
 });
 var assetGroupCreateSchema = z4.object({
   campaign: refSchema,
@@ -14784,7 +14819,7 @@ var assetsUpdateCommand = defineCommand30({
     "final-urls": { type: "string", description: "Comma-separated sitelink final URLs" },
     "callout-text": { type: "string", description: "Callout text" },
     header: { type: "string", description: "Structured snippet header" },
-    values: { type: "string", description: "Comma-separated structured snippet values" },
+    values: { type: "string", description: "Comma-separated structured snippet values (3-10, max 25 characters each)" },
     cta: { type: "string", description: "Call-to-action text" },
     text: { type: "string", description: "Text asset content" }
   },
@@ -14818,7 +14853,9 @@ var assetsCommand = defineCommand30({
       "Stage an asset (text/image/sitelink/callout/structuredSnippet/\u2026)"
     ),
     update: assetsUpdateCommand,
-    attach: fileCreateCommand("attach", "google.assetLink.attach", "Attach an asset to a campaign/adGroup/customer"),
+    attach: fileCreateCommand("attach", "google.assetLink.attach", "Attach an asset to a campaign/adGroup/customer", [
+      "Images are not attachable here at all \u2014 Google refuses every image field type through an asset link, at every level. Image extensions have to be added in the Google Ads interface; say so and carry on. Performance Max asset-group images are a different mechanism and do work (`asset-groups attach`)."
+    ]),
     detach: statusCommand2("google.assetLink.detach", "asset link")
   }
 });