@adkit/cli 1.13.22 → 1.13.24

package/dist/cli.js

@@ -1,5 +1,68 @@
 #!/usr/bin/env node
 
+// ../shared/dist/errors.js
+function describeRetryDelay(retryAfterSeconds) {
+  if (!retryAfterSeconds || retryAfterSeconds <= 300)
+    return "in a few minutes";
+  if (retryAfterSeconds <= 3600)
+    return "within the hour";
+  return "in a few hours";
+}
+
+// ../shared/dist/utils/type-guards.js
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readProperty(value, key) {
+  return value[key];
+}
+function readStringProperty(value, key) {
+  const raw = value[key];
+  return typeof raw === "string" ? raw : void 0;
+}
+
+// ../shared/dist/manage/google/constants.js
+var GOOGLE_LIMITED_AD_APPROVAL_STATUSES = ["APPROVED_LIMITED", "AREA_OF_INTEREST_ONLY"];
+var GOOGLE_PROBLEM_AD_APPROVAL_STATUSES = ["DISAPPROVED", ...GOOGLE_LIMITED_AD_APPROVAL_STATUSES];
+
+// ../shared/dist/manage/google/campaign-validation.js
+var VALID_GOOGLE_BID_STRATEGIES = ["manual_cpc", "manual_cpm", "maximize_clicks", "maximize_conversions", "maximize_conversion_value", "target_spend", "target_impression_share"];
+var SUPPORTED_GOOGLE_CAMPAIGN_TYPES = ["search", "display"];
+var validGoogleBidStrategySet = new Set(VALID_GOOGLE_BID_STRATEGIES);
+var validGoogleBidStrategyList = VALID_GOOGLE_BID_STRATEGIES.join(", ");
+var supportedGoogleCampaignTypeSet = new Set(SUPPORTED_GOOGLE_CAMPAIGN_TYPES);
+var supportedGoogleCampaignTypeList = SUPPORTED_GOOGLE_CAMPAIGN_TYPES.join(", ");
+
+// ../shared/dist/manage/google/validators/conversion-goals.js
+var GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORIES = [
+  "add_to_cart",
+  "begin_checkout",
+  "book_appointment",
+  "contact",
+  "converted_lead",
+  "default",
+  "download",
+  "engagement",
+  "get_directions",
+  "imported_lead",
+  "outbound_click",
+  "page_view",
+  "phone_call_lead",
+  "purchase",
+  "qualified_lead",
+  "request_quote",
+  "signup",
+  "store_sale",
+  "store_visit",
+  "submit_lead_form",
+  "subscribe_paid",
+  "youtube_follow_on_views"
+];
+var googleCampaignConversionGoalCategorySet = new Set(GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORIES);
+
+// ../shared/dist/manage/google/types/google-adkit.js
+var GOOGLE_GEO_LOCATION_SEARCH_TYPES = ["country", "region", "city", "postal_code", "metro"];
+
 // src/config.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
 import { join } from "node:path";
@@ -65,15 +128,6 @@ function readLegacyProjectApiKey(config, selectedProject) {
   return config.projects?.[selectedProject]?.apiKey ?? null;
 }
 
-// ../shared/dist/errors.js
-function describeRetryDelay(retryAfterSeconds) {
-  if (!retryAfterSeconds || retryAfterSeconds <= 300)
-    return "in a few minutes";
-  if (retryAfterSeconds <= 3600)
-    return "within the hour";
-  return "in a few hours";
-}
-
 // src/errors.ts
 var CliError = class extends Error {
   code;
@@ -1753,9 +1807,6 @@ function getAd(client, args, flags) {
   return getMetaEntity(client, args, flags, { path: "ads", usageHint: "Run: adkit manage meta ads <ad-id>" });
 }
 
-// ../shared/dist/manage/google/types/google-adkit.js
-var GOOGLE_GEO_LOCATION_SEARCH_TYPES = ["country", "region", "city", "postal_code", "metro"];
-
 // ../shared/dist/manage/google/asset-utils.js
 var SUPPORTED_GOOGLE_STRUCTURED_SNIPPET_HEADERS = ["Amenities", "Brands", "Courses", "Degree programs", "Destinations", "Featured hotels", "Insurance coverage", "Models", "Neighborhoods", "Service catalog", "Shows", "Styles", "Types"];
 var STRUCTURED_SNIPPET_HEADER_LOOKUP = new Map(SUPPORTED_GOOGLE_STRUCTURED_SNIPPET_HEADERS.map((header) => [header.toLowerCase(), header]));
@@ -1924,18 +1975,6 @@ function parseGoogleSitelinkShorthand(value) {
   return normalizeSitelinkAsset({ type: "sitelink", linkText, finalUrls: [finalUrl] });
 }
 
-// ../shared/dist/utils/type-guards.js
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readProperty(value, key) {
-  return value[key];
-}
-function readStringProperty(value, key) {
-  const raw = value[key];
-  return typeof raw === "string" ? raw : void 0;
-}
-
 // src/commands/google.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 import { basename, extname, resolve } from "node:path";
@@ -1945,8 +1984,8 @@ var ASSET_CREATE_FLAGS = ["type", "text", "sitelink", "header", "value", "descri
 var ASSET_LINK_FLAGS = ["type", "scope", "scope-id", "status"];
 var MEDIA_UPLOAD_FLAGS = ["file", "url", "base64", "adkit-media", "video-id", "filename", "content-type", "name"];
 var CAMPAIGN_LIST_FLAGS = ["status", "limit", "offset"];
-var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
-var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
+var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "conversion-goals", "countries"];
+var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "conversion-goals", "countries"];
 var ASSET_GROUP_LIST_FLAGS = ["campaign", "limit", "offset"];
 var ASSET_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "final-url"];
 var ASSET_GROUP_UPDATE_FLAGS = ["name", "status", "final-url"];
@@ -2211,6 +2250,7 @@ function buildCampaignPayload2(flags) {
   if (flags["search-partners"] === true) payload.searchPartners = true;
   if (flags["display-network"] === true) payload.displayNetwork = true;
   if (typeof flags["tracking-url-suffix"] === "string") payload.trackingUrlSuffix = flags["tracking-url-suffix"];
+  if (typeof flags["conversion-goals"] === "string") payload.conversionGoals = parseCampaignConversionGoals(flags["conversion-goals"]);
   if (typeof flags.countries === "string") payload.countries = parseCampaignCountries(flags.countries);
   return payload;
 }
@@ -2219,6 +2259,12 @@ function parseCampaignCountries(value) {
   const normalizedCountries = countryParts.map((country) => country.trim().toUpperCase());
   return normalizedCountries.filter(Boolean);
 }
+function parseCampaignConversionGoals(value) {
+  if (value.trim().toLowerCase() === "null") return null;
+  const goalParts = value.split(",");
+  const normalizedGoals = goalParts.map((goal) => goal.trim());
+  return normalizedGoals.filter(Boolean);
+}
 function buildCampaignUpdatePayloadFromFlags(flags) {
   const payload = {};
   if (typeof flags.name === "string") payload.name = flags.name;
@@ -2230,6 +2276,7 @@ function buildCampaignUpdatePayloadFromFlags(flags) {
   if (flags["search-partners"] === true) payload.searchPartners = true;
   if (flags["display-network"] === true) payload.displayNetwork = true;
   if (typeof flags["tracking-url-suffix"] === "string") payload.trackingUrlSuffix = flags["tracking-url-suffix"];
+  if (typeof flags["conversion-goals"] === "string") payload.conversionGoals = parseCampaignConversionGoals(flags["conversion-goals"]);
   if (typeof flags.countries === "string") {
     const countries = parseCampaignCountries(flags.countries);
     payload.targeting = {
@@ -4760,6 +4807,7 @@ var require2 = createRequire(import.meta.url);
 var CLI_VERSION = require2("../package.json").version;
 var DEFAULT_BASE_URL = "https://app.adkit.so/api/v1";
 var GOOGLE_NUMERIC_ID_PATTERN2 = /^\d+$/;
+var GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORY_LIST = GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORIES.join(", ");
 var GOOGLE_RESULTS_LEVEL_ACTIONS = /* @__PURE__ */ new Set(["campaigns", "ad-groups", "ads"]);
 var TIKTOK_NUMERIC_ID_PATTERN = /^\d+$/;
 var LINKEDIN_ID_PATTERN = /[\d:_]/;
@@ -5077,6 +5125,7 @@ Note:
   list returns ad configuration only (creative, status, adset).
   AdKit hides deleted and archived ads by default. Use --status to include them.
   Single-image/video ads use --media. Carousel ads use --data with carouselCards.
+  Copy flags are repeatable \u2014 pass every headline/primary-text/link-description the user supplies; Meta rotates them on one ad. If it is unclear whether they want one ad with variants or separate ads, ask before creating. Only when writing copy yourself, default to one per field unless the user asks for variants.
 
 Examples:
   # Create an ad with a local video file
@@ -5139,6 +5188,7 @@ Note:
   list returns ad configuration only (creative, status, adset).
   AdKit hides deleted and archived ads by default. Use --status to include them.
   Single-image/video ads use --media. Carousel ads use --data with carouselCards.
+  Copy flags are repeatable \u2014 pass every headline/primary-text/link-description the user supplies; Meta rotates them on one ad. If it is unclear whether they want one ad with variants or separate ads, ask before creating. Only when writing copy yourself, default to one per field unless the user asks for variants.
 
 --data JSON fields:
   adsetId             (required) Parent ad set ID
@@ -5440,6 +5490,7 @@ Flags (create):
   --bid-strategy <s>  manual_cpc, manual_cpm, maximize_clicks, maximize_conversions, maximize_conversion_value, target_spend, target_impression_share
   --target-cpa <n>    Target CPA in account currency (with --bid-strategy maximize_conversions)
   --target-roas <n>   Target ROAS ratio, e.g. 3.5 = 350% (with --bid-strategy maximize_conversion_value)
+  --conversion-goals <list>  Comma-separated goal categories or conversion-action IDs; never mix them
 
 Flags (update):
   --name <name>       Campaign name
@@ -5448,6 +5499,7 @@ Flags (update):
   --bid-strategy <s>  Change bidding strategy
   --target-cpa <n>    Target CPA in account currency. Send alone to retune the existing maximize_conversions target
   --target-roas <n>   Target ROAS ratio (3.5 = 350%). Send alone to retune the existing target, incl. Performance Max
+  --conversion-goals <list>  Replace goals; pass null to restore account defaults
   --countries <codes> Replace included countries, e.g. US,CA
 
 Flags (list):
@@ -5463,15 +5515,20 @@ Note:
   Advanced geo examples: adkit manage google campaigns --help full
   Display creation starts here: campaigns create --campaign-type display, then create Display ad groups and responsive_display ads.
   Performance Max: campaignType "performance_max" with asset groups \u2014 build it with --data. See --help full.
+  conversion-goals chooses what to optimize toward; bid-strategy controls bidding. It works on Search, Display, and Performance Max.
+  On create, omit conversion-goals to inherit account defaults. On update, omit it to leave goals unchanged or pass null to restore defaults.
+  Run --help full for valid goal categories and conversion-action ID discovery.
   View a Performance Max campaign by ID to read back its assetGroups; manage existing groups with google asset-groups.
   For spend/clicks/conversions: adkit manage google results
 
 Examples:
   adkit manage google campaigns list --account 1234567890
   adkit manage google campaigns create --name "Display Prospecting" --campaign-type display --budget-daily 50 --account 1234567890
+  adkit manage google campaigns create --name "Purchase Search" --campaign-type search --budget-daily 40 --bid-strategy maximize_conversion_value --conversion-goals purchase --account 1234567890
   adkit manage google campaigns create --data '{"campaigns":[{"name":"Display US","campaignType":"display","budget":{"daily":50},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}' --account 1234567890
   adkit manage google campaigns update 987654321 --data '{"targeting":{"geoLocations":{"match":"presence_or_interest"}}}' --account 1234567890
   adkit manage google campaigns update 987654321 --status paused --account 1234567890
+  adkit manage google campaigns update 987654321 --conversion-goals null --account 1234567890
   adkit manage google campaigns delete 987654321 --account 1234567890
 
 Run --help full for all fields and advanced options.`;
@@ -5489,6 +5546,7 @@ Flags (create):
   --budget-daily <n>  Daily budget in account currency
   --campaign-type <type>    search, display, performance_max (performance_max needs --data for asset groups)
   --bid-strategy <s>  manual_cpc, manual_cpm, maximize_clicks, maximize_conversions, maximize_conversion_value, target_spend, target_impression_share
+  --conversion-goals <list>  Comma-separated goal categories or conversion-action IDs; never mix them
 ${FLAG.account}
 ${FLAG.publish}
 ${FLAG.data}
@@ -5498,6 +5556,7 @@ Flags (update):
   --status <s>        enabled, paused
   --budget-daily <n>  Daily budget in account currency
   --bid-strategy <s>  Change bidding strategy
+  --conversion-goals <list>  Replace goals; pass null to restore account defaults
   --countries <codes> Replace included countries, e.g. US,CA
 ${FLAG.account}
 ${FLAG.publish}
@@ -5517,17 +5576,24 @@ Notes:
   Google exclusions support named locations. Proximity circles belong in include.
   Display campaign creation uses campaignType:"display" or --campaign-type display. Videos are not supported for Display media in v1.
   Performance Max: campaignType "performance_max" requires at least one assetGroups[] entry and supports multiple groups. Text assets are inline ({role,text}); upload images with google media first, then reference their id/resourceName. Needs an enabled conversion (publish is blocked without one). Non-retail only. Build it with --data.
+  conversion-goals works on Search, Display, and Performance Max. It chooses what to optimize toward; bid-strategy controls bidding.
+  Valid goal categories: ${GOOGLE_CAMPAIGN_CONVERSION_GOAL_CATEGORY_LIST}
+  For exact IDs, run google conversions list and pass conversion.platformId. Do not pass conversion.category; it uses a different vocabulary.
+  On create, omit conversion-goals to inherit account defaults. On update, omit it to leave goals unchanged or pass null to restore defaults.
   View a Performance Max campaign by ID to read back its assetGroups. After creation, manage groups with google asset-groups.
   For spend/clicks/conversions: adkit manage google results
 
 Examples:
   adkit manage google campaigns list --account 1234567890
   adkit manage google campaigns create --name "Display Prospecting" --campaign-type display --budget-daily 50 --account 1234567890
+  adkit manage google campaigns create --name "Purchase Search" --campaign-type search --budget-daily 40 --bid-strategy maximize_conversion_value --conversion-goals purchase --account 1234567890
   adkit manage google campaigns create --data '{"campaigns":[{"name":"Display US","campaignType":"display","budget":{"daily":50},"targeting":{"geoLocations":{"include":[{"type":"country","country":"US"}]}}}]}' --account 1234567890
   adkit manage google campaigns create --data '{"campaigns":[{"name":"Austin Search","campaignType":"search","budget":{"daily":5},"targeting":{"geoLocations":{"include":[{"type":"city","code":"1026201"}]}}}]}' --account 1234567890
   adkit manage google campaigns create --data '{"campaigns":[{"name":"SF Radius","campaignType":"search","budget":{"daily":5},"targeting":{"geoLocations":{"include":[{"type":"platformLocation","platform":"google","value":{"proximity":{"geo_point":{"latitude_in_micro_degrees":37774900,"longitude_in_micro_degrees":-122419400},"radius":5,"radius_units":"MILES"}}}]}}}]}' --account 1234567890
   adkit manage google campaigns create --data '{"campaigns":[{"name":"PMAX Launch","campaignType":"performance_max","budget":{"daily":50},"bidStrategy":"maximize_conversions","assetGroups":[{"name":"Asset Group 1","finalUrls":["https://example.com"],"assets":[{"role":"headline","text":"Ship faster"},{"role":"headline","text":"Save hours every week"},{"role":"headline","text":"Start free today"},{"role":"long_headline","text":"Automate your ad workflow and launch in minutes"},{"role":"description","text":"Automate your workflow in minutes"},{"role":"description","text":"No credit card required"},{"role":"business_name","text":"Acme"},{"role":"logo","id":"<uploaded-asset-id>"},{"role":"marketing_image","id":"<uploaded-asset-id>"},{"role":"square_marketing_image","id":"<uploaded-asset-id>"}],"signals":[{"type":"search_theme","text":"project management software"}]}]}]}' --account 1234567890
   adkit manage google campaigns update 987654321 --status paused --account 1234567890
+  adkit manage google campaigns update 987654321 --conversion-goals 23854890221234567 --account 1234567890
+  adkit manage google campaigns update 987654321 --conversion-goals null --account 1234567890
   adkit manage google campaigns update 987654321 --data '{"targeting":{"geoLocations":{"match":"presence_or_interest"}}}' --account 1234567890
   adkit manage google campaigns delete 987654321 --account 1234567890 --publish`;
 var GOOGLE_ASSET_GROUP_HELP = `adkit manage google asset-groups \u2014 Performance Max asset groups

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.22",
+  "version": "1.13.24",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",