@koda-sl/baker-cli 0.173.0-dev.6ecd65d29 → 0.173.0

package/dist/cli.js

@@ -36,7 +36,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-K424D3CY.js";
+} from "./chunk-CG6OTNUU.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -3063,6 +3063,13 @@ var hubspotContactLookupResponseSchema = z10.object({
       createdAt: z10.string().nullable()
     }).nullable(),
     deals: z10.array(z10.object({ id: z10.string(), stage: z10.string().nullable(), pipeline: z10.string().nullable() })),
+    /**
+     * False when the connection never granted deal access, which makes an empty
+     * `deals` unknown rather than absent. Deal access is granted separately from
+     * contact access, so one can be present without the other — and "no deals"
+     * is the headline finding of this command, so it must not be guessed.
+     */
+    dealsReadable: z10.boolean(),
     /**
      * The account the contact was filed under. In B2B a workflow usually
      * creates it on contact creation, so its absence is a finding — but only
@@ -4977,6 +4984,19 @@ var ASSET_FIELD_TYPES = [
   "MARKETING_IMAGE",
   "BUSINESS_NAME"
 ];
+var ASSET_GROUP_ASSET_FIELD_TYPES = [
+  "MARKETING_IMAGE",
+  "SQUARE_MARKETING_IMAGE",
+  "PORTRAIT_MARKETING_IMAGE",
+  "LOGO",
+  "LANDSCAPE_LOGO",
+  "YOUTUBE_VIDEO",
+  "HEADLINE",
+  "LONG_HEADLINE",
+  "DESCRIPTION",
+  "BUSINESS_NAME",
+  "CALL_TO_ACTION_SELECTION"
+];
 var DEVICE_TYPES = ["MOBILE", "TABLET", "DESKTOP", "CONNECTED_TV", "OTHER"];
 var DAYS_OF_WEEK = ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"];
 var CAMPAIGN_OBJECTIVES = [
@@ -5353,9 +5373,15 @@ var assetGroupCreateSchema = z15.object({
   businessName: z15.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.businessNameMax),
   imageAssets: z15.array(refSchema).optional(),
   squareImageAssets: z15.array(refSchema).optional(),
+  portraitImageAssets: z15.array(refSchema).optional(),
   logoAssets: z15.array(refSchema).optional(),
   status: z15.enum(["ENABLED", "PAUSED"]).default("PAUSED")
 });
+var assetGroupAssetAttachSchema = z15.object({
+  assetGroup: refSchema,
+  asset: refSchema,
+  fieldType: z15.enum(ASSET_GROUP_ASSET_FIELD_TYPES)
+});
 var assetGroupUpdateSchema = z15.object({
   name: z15.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.nameMax).optional(),
   finalUrls: z15.array(httpsUrlSchema2).min(1).optional(),
@@ -5526,6 +5552,8 @@ var GOOGLE_DRAFT_OP_KINDS = [
   "google.assetLink.detach",
   "google.assetGroup.create",
   "google.assetGroup.update",
+  "google.assetGroupAsset.attach",
+  "google.assetGroupAsset.detach",
   "google.audience.create",
   "google.audienceCriterion.attach",
   "google.audienceCriterion.detach",
@@ -5583,6 +5611,8 @@ var googleDraftOpInputSchema = z15.discriminatedUnion("kind", [
   targetOp("google.assetLink.detach"),
   createOp2("google.assetGroup.create", assetGroupCreateSchema),
   updateOp2("google.assetGroup.update", assetGroupUpdateSchema),
+  createOp2("google.assetGroupAsset.attach", assetGroupAssetAttachSchema),
+  targetOp("google.assetGroupAsset.detach"),
   createOp2("google.audience.create", audienceCreateSchema2),
   createOp2("google.audienceCriterion.attach", audienceCriterionAttachSchema),
   targetOp("google.audienceCriterion.detach"),
@@ -9553,8 +9583,15 @@ var assetGroupsCommand = defineCommand30({
         "long-headlines": { type: "string", description: "Comma-separated long headlines (1\u20135, \u226490 chars)" },
         descriptions: { type: "string", description: "Comma-separated descriptions (2\u20135, \u226490 chars)" },
         "business-name": { type: "string" },
-        "image-assets": { type: "string", description: "Comma-separated marketing image asset refs" },
-        "square-image-assets": { type: "string", description: "Comma-separated square marketing image asset refs" },
+        "image-assets": { type: "string", description: "Comma-separated marketing image asset refs (1.91:1)" },
+        "square-image-assets": {
+          type: "string",
+          description: "Comma-separated square marketing image asset refs (1:1)"
+        },
+        "portrait-image-assets": {
+          type: "string",
+          description: "Comma-separated portrait marketing image asset refs (4:5)"
+        },
         "logo-assets": { type: "string", description: "Comma-separated logo image asset refs" },
         status: { type: "string", description: "ENABLED | PAUSED (default PAUSED)" }
       },
@@ -9573,6 +9610,7 @@ var assetGroupsCommand = defineCommand30({
           businessName: args["business-name"],
           imageAssets: listFlag(args["image-assets"]),
           squareImageAssets: listFlag(args["square-image-assets"]),
+          portraitImageAssets: listFlag(args["portrait-image-assets"]),
           logoAssets: listFlag(args["logo-assets"]),
           status: args.status
         });
@@ -9598,7 +9636,40 @@ var assetGroupsCommand = defineCommand30({
         });
         await stageUpdate("google.assetGroup.update", customerId, target, payload);
       }
-    })
+    }),
+    attach: defineCommand30({
+      meta: {
+        name: "attach",
+        description: "Add one existing asset to an existing asset group. Start here to refresh a live PMax group's creatives: attach the new image, then `detach` the old one \u2014 never detach first."
+      },
+      args: {
+        ...customerIdArg,
+        ...fileArg,
+        "asset-group-ref": { type: "string", description: "Asset group ref (g_temp_*, id, or resource name)" },
+        "asset-ref": { type: "string", description: "Asset ref (g_temp_*, id, or resource name)" },
+        "field-type": {
+          type: "string",
+          description: `Slot the asset fills: ${ASSET_GROUP_ASSET_FIELD_TYPES.join(" | ")}`
+        }
+      },
+      run: async ({ args }) => {
+        const customerId = requireCustomerId(args);
+        const payload = mergePayload(loadJsonFileArg(args.file), {
+          assetGroup: args["asset-group-ref"],
+          asset: args["asset-ref"],
+          fieldType: args["field-type"]
+        });
+        await stageCreate("google.assetGroupAsset.attach", customerId, payload, [
+          "Swapping a creative? Stage the matching `asset-groups detach` for the image this one replaces \u2014 an attach alone grows the group instead of refreshing it.",
+          "The field type must match the image's real ratio (1.91:1 \u2192 MARKETING_IMAGE, 1:1 \u2192 SQUARE_MARKETING_IMAGE, 4:5 \u2192 PORTRAIT_MARKETING_IMAGE); Google rejects a mismatch at publish.",
+          "Slots have ceilings as well as minimums: BUSINESS_NAME and CALL_TO_ACTION_SELECTION hold 1, LOGO 5, LONG_HEADLINE and DESCRIPTION 5, HEADLINE 15, YOUTUBE_VIDEO 15, images 20. Adding to a full slot is rejected exactly like removing below an empty one, so count what the group already holds (`SELECT asset_group_asset.field_type FROM asset_group_asset WHERE asset_group.id = \u2026`) and stage the detach alongside when it is full."
+        ]);
+      }
+    }),
+    detach: statusCommand2("google.assetGroupAsset.detach", "asset group asset", [
+      "Stage order is execution order \u2014 if you are replacing this image, its `asset-groups attach` must already be staged BEFORE this detach, or Google sees the group below its per-ratio minimum and rejects the removal.",
+      "Pass the full composite resource name (customers/{cid}/assetGroupAssets/{assetGroupId}~{assetId}~{FIELD_TYPE}) \u2014 read it from `asset_group_asset.resource_name` via `ads google query`."
+    ])
   }
 });
 function fileCreateCommand(name, kind, description, hints) {
@@ -26708,7 +26779,7 @@ registerSchema({
 });
 registerSchema({
   command: "hubspot.contacts.lookup",
-  description: "One contact by email: its lifecycle stage, whether anyone is assigned, the account (company) it was filed under, and any deals it is attached to with their stage. Use it to settle whether a specific lead was picked up. `found: false` means the lead never reached the CRM at all \u2014 that is a finding, not an error. `companyReadable: false` means account details were not readable on this connection, so a null company is unknown rather than absent.",
+  description: "One contact by email: its lifecycle stage, whether anyone is assigned, the account (company) it was filed under, and any deals it is attached to with their stage. Use it to settle whether a specific lead was picked up. `found: false` means the lead never reached the CRM at all \u2014 that is a finding, not an error. `dealsReadable: false` / `companyReadable: false` mean deals or account details were not readable on this connection, so an empty deals list or a null company is unknown rather than absent.",
   args: {
     email: { type: "positional", description: "The contact's email address", required: true }
   }
@@ -27078,6 +27149,35 @@ var contactsSummaryCommand = defineCommand114({
     }
   }
 });
+function contactLookupHints(data) {
+  const { found, contact, deals, dealsReadable, company, companyReadable } = data;
+  if (!found) {
+    return [
+      "No contact with that email. The lead never reached the CRM \u2014 check the form's submissions before assuming the CRM lost it."
+    ];
+  }
+  const hints = [];
+  if (contact?.ownerId === null) {
+    hints.push("Nobody is assigned to this contact.");
+  }
+  if (!dealsReadable) {
+    hints.push(
+      "Deals were not read: this HubSpot connection does not cover them. Do not report the lead as having no deal \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
+    );
+  } else if (deals.length === 0) {
+    hints.push("No deal is associated, so this contact was never taken into the pipeline.");
+  }
+  if (!companyReadable) {
+    hints.push(
+      "Account details were not read: this HubSpot connection does not cover them. Do not report the lead as having no account \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
+    );
+  } else if (company === null) {
+    hints.push(
+      "No account is associated either. Most B2B setups create one automatically when a contact arrives, so this usually means the lead was never processed at all \u2014 not that the account is missing."
+    );
+  }
+  return hints;
+}
 var contactsLookupCommand = defineCommand114({
   meta: {
     name: "lookup",
@@ -27091,31 +27191,12 @@ var contactsLookupCommand = defineCommand114({
       const response = await apiPost("/api/hubspot/contacts/lookup", {
         email: args.email
       });
-      const { found, contact, deals, company, companyReadable } = response.data;
-      const hints = [];
-      if (!found) {
-        hints.push(
-          "No contact with that email. The lead never reached the CRM \u2014 check the form's submissions before assuming the CRM lost it."
-        );
-      } else {
-        if (contact?.ownerId === null) {
-          hints.push("Nobody is assigned to this contact.");
-        }
-        if (deals.length === 0) {
-          hints.push("No deal is associated, so this contact was never taken into the pipeline.");
-        }
-        if (companyReadable && company === null) {
-          hints.push(
-            "No account is associated either. Most B2B setups create one automatically when a contact arrives, so this usually means the lead was never processed at all \u2014 not that the account is missing."
-          );
-        }
-        if (!companyReadable) {
-          hints.push(
-            "Account details were not read: this HubSpot connection does not cover them. Do not report the lead as having no account \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
-          );
-        }
-      }
-      writeJson({ ...response, meta: { count: found ? 1 : 0 }, ...hints.length > 0 ? { hints } : {} });
+      const hints = contactLookupHints(response.data);
+      writeJson({
+        ...response,
+        meta: { count: response.data.found ? 1 : 0 },
+        ...hints.length > 0 ? { hints } : {}
+      });
     } catch (err) {
       failNotConnected(err);
     }