@adkit/cli 1.13.22 → 1.13.23

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:_]/;
@@ -5440,6 +5488,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 +5497,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 +5513,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 +5544,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 +5554,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 +5574,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.23",
   "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",