@adkit/cli 1.13.21 → 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;
@@ -528,10 +582,15 @@ var isWsl = () => {
     return true;
   }
   try {
-    return fs3.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft") ? !isInsideContainer() : false;
+    if (fs3.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft")) {
+      return !isInsideContainer();
+    }
   } catch {
-    return false;
   }
+  if (fs3.existsSync("/proc/sys/fs/binfmt_misc/WSLInterop") || fs3.existsSync("/run/WSL")) {
+    return !isInsideContainer();
+  }
+  return false;
 };
 var is_wsl_default = process2.env.__IS_WSL_TEST__ ? isWsl : isWsl();
 
@@ -1748,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]));
@@ -1919,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";
@@ -1940,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"];
@@ -2206,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;
 }
@@ -2214,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;
@@ -2225,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 = {
@@ -4755,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:_]/;
@@ -5435,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
@@ -5443,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):
@@ -5458,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.`;
@@ -5484,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}
@@ -5493,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}
@@ -5512,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
@@ -6417,11 +6486,12 @@ ${FLAG.data}
   --offset <n>        Row offset for list
   --campaign-ids <ids> Comma-separated campaign IDs for filtered reads
   --name <name>       Campaign name
-  --status <s>        create: active or draft (defaults to draft). update: active, paused, or archived
+  --status <s>        create: active or draft (defaults to active). update: active, paused, or archived
   --budget-lifetime <n> Lifetime budget in account currency
   --end-date <date>   YYYY-MM-DD; required with --budget-lifetime
 
 Notes:
+  Creates are saved as AdKit drafts unless --publish is set. The create status controls the LinkedIn state after publishing.
   This tier takes lifetime budgets only; a daily budget here returns a 500. Set daily budgets on ad-groups.
   A live campaign can never go back to draft.
 
@@ -6452,7 +6522,7 @@ ${FLAG.data}
   --campaign <id>     Parent campaign ID (create only)
   --name <name>       Ad group name
   --objective <type>  brand_awareness, engagement, website_visits, video_views, website_conversions, lead_generation
-  --status <s>        create: active or draft (defaults to draft). update: active, paused, or archived
+  --status <s>        create: active or draft (defaults to active). update: active, paused, or archived
   --budget-daily <n>  Daily budget in account currency
   --budget-lifetime <n> Lifetime budget in account currency
   --bid-strategy <s>  maximum_delivery, manual, target_cost, cost_cap
@@ -6463,19 +6533,21 @@ ${FLAG.data}
 
 Targeting (--data only):
   targeting is nested: { geoLocations: { include: [{ type: "country", code }] }, audience: { <facet>: { include?: [ids], exclude?: [ids] } } }.
+  Active (including omitted status) requires at least one geoLocations.include target. Use --data for active creation; named flags without targeting need --status draft.
   Values are bare IDs \u2014 use "adkit manage linkedin targeting-search" to find them.
   Facets: jobTitles, seniorities, jobFunctions, industries, companySizes, companies, skills, interests, customAudiences, ageRanges, genders.
   ageRanges/genders are include-only (LinkedIn rejects them in exclude): ageRanges take tuples like (25,34), genders take FEMALE/MALE.
   customAudiences goes inside targeting.audience (never top-level): pass the segment ID/URN. Matched Audiences are created in Campaign Manager, but you list them with "adkit manage linkedin targeting-search --facet customAudiences". Choose a language via platformOverrides.locale.
 
 Notes:
+  Creates are saved as AdKit drafts unless --publish is set. The create status controls the LinkedIn state after publishing.
   A live ad group can never go back to draft. targeting on update is a full replace (send the whole targeting object via --data).
   Explicit bidding on create requires a compatible --objective. Bidding changes are atomic: send --bid-strategy and --optimization together. manual, target_cost, and cost_cap also require --bid-amount; maximum_delivery rejects it.
   LinkedIn further constrains bidding by objective and creative format.
 
 Examples:
-  adkit manage linkedin ad-groups create --campaign 628940516 --name "US Broad" --budget-daily 50 --objective website_visits
-  adkit manage linkedin ad-groups create --campaign 628940516 --name "US Manual CPC" --objective website_visits --bid-strategy manual --optimization clicks --bid-amount 8
+  adkit manage linkedin ad-groups create --campaign 628940516 --name "Incomplete setup" --budget-daily 50 --objective website_visits --status draft
+  adkit manage linkedin ad-groups create --data '{"adGroups":[{"campaignId":"628940516","name":"US Manual CPC","objective":"website_visits","bidStrategy":"manual","optimization":"clicks","bidAmount":8,"targeting":{"geoLocations":{"include":[{"type":"country","code":"103644278"}]}}}]}'
   adkit manage linkedin ad-groups update 361387516 --account 512345678 --status paused
   adkit manage linkedin ad-groups create --data '{"adGroups":[{"campaignId":"628940516","name":"US Senior Eng","budget":{"daily":50},"targeting":{"geoLocations":{"include":[{"type":"country","code":"103644278"}]},"audience":{"seniorities":{"include":["6"]},"customAudiences":{"include":["123456"]}}}}]}'`.trim(),
   "linkedin ads": `adkit manage linkedin ads \u2014 LinkedIn ads
@@ -6495,9 +6567,10 @@ ${FLAG.data}
   --ad-group <id>     Parent ad group ID (create only)
   --existing-post <urn> Reference an existing share/ugcPost URN (create only)
   --name <name>       Ad name
-  --status <s>        create: active or draft (defaults to draft). update: active, paused, or archived
+  --status <s>        create: active or draft (defaults to active). update: active, paused, or archived
 
 Create:
+  Creates are saved as AdKit drafts unless --publish is set. The create status controls the LinkedIn state after publishing.
   Inline ad: pass --data with a creative \u2014 keys are primaryTexts, headlines, media, url, cta. creative.media needs at least one { role: "image"|"video", id: "urn:li:image:..." } entry.
   Reference ad: pass --existing-post <share/ugcPost URN>; omit creative entirely (its text/url/media are ignored).
   creative.cta is the button label \u2014 one of: apply, download, view_quote, learn_more, sign_up, subscribe, register, join, attend, request_demo, see_more, buy_now, shop_now. It needs creative.url and cannot be combined with existing-post.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.21",
+  "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",