@adkit/cli 1.13.29 → 1.13.31

package/dist/cli.js

@@ -1567,25 +1567,35 @@ async function listMetaLeadForms(client, _args, flags) {
   const qs = queryString({ accountId, pageId, fields, raw });
   return client.get(`/manage/meta/lead-forms${qs}`);
 }
-function buildCampaignPayload(flags) {
+async function listMetaConversions(client, _args, flags) {
+  validateFlags(flags, ["account", "limit", "offset", "raw"], "manage meta conversions list");
+  const accountId = typeof flags.account === "string" ? flags.account : void 0;
+  const limit = typeof flags.limit === "string" ? flags.limit : void 0;
+  const offset = typeof flags.offset === "string" ? flags.offset : void 0;
+  const raw = flags.raw === true ? "true" : void 0;
+  const qs = queryString({ accountId, limit, offset, raw });
+  return client.get(`/manage/meta/conversions${qs}`);
+}
+function buildCampaignPayload(flags, { defaultCbo }) {
   const payload = {};
   if (typeof flags.name === "string") payload.name = flags.name;
   if (typeof flags.objective === "string") payload.objective = flags.objective;
   if (typeof flags.status === "string") payload.status = flags.status;
   if (typeof flags["bid-strategy"] === "string") payload.bidStrategy = flags["bid-strategy"];
   if (flags.abo === true) payload.advantageCampaignBudget = false;
-  else payload.advantageCampaignBudget = true;
+  else if (defaultCbo) payload.advantageCampaignBudget = true;
   if (typeof flags["budget-daily"] === "string") payload.budget = { daily: parseFloat(flags["budget-daily"]) };
   if (typeof flags["budget-total"] === "string") payload.budget = { ...payload.budget, lifetime: parseFloat(flags["budget-total"]) };
   if (typeof flags["platform-overrides"] === "string") payload.platformOverrides = parseJsonObject(flags["platform-overrides"], "platform-overrides");
   return payload;
 }
 async function listMetaCampaigns(client, _args, flags) {
-  validateFlags(flags, ["account", "status", "raw"], "manage meta campaigns list");
+  validateFlags(flags, ["account", "status", "limit", "raw"], "manage meta campaigns list");
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
   const status2 = typeof flags.status === "string" ? flags.status : void 0;
+  const limit = typeof flags.limit === "string" ? flags.limit : void 0;
   const raw = flags.raw === true ? "true" : void 0;
-  const qs = queryString({ accountId, status: status2, raw });
+  const qs = queryString({ accountId, status: status2, limit, raw });
   return client.get(`/manage/meta/campaigns${qs}`);
 }
 var CAMPAIGN_FLAGS = ["name", "objective", "status", "budget-daily", "budget-total", "abo", "bid-strategy"];
@@ -1603,7 +1613,7 @@ async function createCampaign(client, _args, flags) {
     return client.post(`/manage/meta/campaigns${publish2}`, body2);
   }
   validateFlags(flags, CAMPAIGN_FLAGS, "manage meta campaigns create");
-  const payload = buildCampaignPayload(flags);
+  const payload = buildCampaignPayload(flags, { defaultCbo: true });
   if (!payload.name) payload.name = generateCampaignName();
   const body = { campaigns: [payload] };
   mergeAccountId(body, flags);
@@ -1612,15 +1622,16 @@ async function createCampaign(client, _args, flags) {
 }
 async function updateCampaign(client, args, flags) {
   const id = requireArg(args, 0, "campaign-id", `Run: adkit manage meta campaigns update <campaign-id> --status paused`);
+  const publish = flags.publish === true ? "?publish=true" : "";
   if (typeof flags.data === "string") {
     const body = parseDataFlag(flags, "Check JSON syntax in --data");
     mergeAccountId(body, flags);
-    return client.patch(`/manage/meta/campaigns/${id}`, body);
+    return client.patch(`/manage/meta/campaigns/${id}${publish}`, body);
   }
   validateFlags(flags, CAMPAIGN_FLAGS, "manage meta campaigns update");
-  const payload = buildCampaignPayload(flags);
+  const payload = buildCampaignPayload(flags, { defaultCbo: false });
   mergeAccountId(payload, flags);
-  return client.patch(`/manage/meta/campaigns/${id}`, payload);
+  return client.patch(`/manage/meta/campaigns/${id}${publish}`, payload);
 }
 async function deleteCampaign(client, args, flags) {
   const id = requireArg(args, 0, "campaign-id", "Run: adkit manage meta campaigns delete <campaign-id>");
@@ -1693,15 +1704,16 @@ async function createAdSet(client, _args, flags) {
 }
 async function updateAdSet(client, args, flags) {
   const id = requireArg(args, 0, "adset-id", `Run: adkit manage meta adsets update <adset-id> --budget-daily 50`);
+  const publish = flags.publish === true ? "?publish=true" : "";
   if (typeof flags.data === "string") {
     const body = parseDataFlag(flags, "Check JSON syntax in --data");
     mergeAccountId(body, flags);
-    return client.patch(`/manage/meta/adsets/${id}`, body);
+    return client.patch(`/manage/meta/adsets/${id}${publish}`, body);
   }
   validateFlags(flags, ADSET_FLAGS, "manage meta adsets update");
   const payload = buildAdSetPayload(flags);
   mergeAccountId(payload, flags);
-  return client.patch(`/manage/meta/adsets/${id}`, payload);
+  return client.patch(`/manage/meta/adsets/${id}${publish}`, payload);
 }
 async function deleteAdSet(client, args, flags) {
   const id = requireArg(args, 0, "adset-id", "Run: adkit manage meta adsets delete <adset-id>");
@@ -1864,7 +1876,8 @@ async function updateAd(client, args, flags) {
   const id = requireArg(args, 0, "ad-id", `Run: adkit manage meta ads update <ad-id> --data '{"status":"paused"}'`);
   const body = parseDataFlag(flags, "Check JSON syntax in --data");
   mergeAccountId(body, flags);
-  return client.patch(`/manage/meta/ads/${id}`, body);
+  const publish = flags.publish === true ? "?publish=true" : "";
+  return client.patch(`/manage/meta/ads/${id}${publish}`, body);
 }
 async function deleteAd(client, args, flags) {
   const id = requireArg(args, 0, "ad-id", "Run: adkit manage meta ads delete <ad-id>");
@@ -1918,15 +1931,16 @@ async function createCreative(client, _args, flags) {
 }
 async function updateCreative(client, args, flags) {
   const id = requireArg(args, 0, "creative-id", `Run: adkit manage meta creatives update <creative-id> --primary-text "Start free trial"`);
+  const publish = flags.publish === true ? "?publish=true" : "";
   if (typeof flags.data === "string") {
     const body = parseDataFlag(flags, "Check JSON syntax in --data");
     mergeAccountId(body, flags);
-    return client.patch(`/manage/meta/creatives/${id}`, body);
+    return client.patch(`/manage/meta/creatives/${id}${publish}`, body);
   }
   validateFlags(flags, CREATIVE_FLAGS, "manage meta creatives update");
   const payload = buildCreativePayload(flags);
   mergeAccountId(payload, flags);
-  return client.patch(`/manage/meta/creatives/${id}`, payload);
+  return client.patch(`/manage/meta/creatives/${id}${publish}`, payload);
 }
 async function deleteCreative(client, args, flags) {
   const id = requireArg(args, 0, "creative-id", "Run: adkit manage meta creatives delete <creative-id>");
@@ -2024,6 +2038,9 @@ var SEARCH_TERMS_FLAGS = ["campaign", "ad-group", "keyword", "keyword-match-type
 var PLACEMENT_REPORT_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "raw"];
 var GOOGLE_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "breakdown", "fields", "conversion-actions", "raw"];
 var GOOGLE_KEYWORD_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "fields", "raw"];
+var CONVERSION_LIST_FLAGS = ["limit", "offset"];
+var CONVERSION_CREATE_FLAGS = ["name", "type", "category", "status", "counting-type", "default-value", "currency", "click-days", "view-days"];
+var CONVERSION_UPDATE_FLAGS = ["name", "category", "counting-type", "default-value", "currency"];
 var CONVERSION_UPLOAD_FLAGS = ["conversion", "gclid", "gbraid", "wbraid", "occurred-at", "value", "currency", "order-id", "conversion-environment", "validate-only", "job-id"];
 var CHANGE_HISTORY_FLAGS = ["account", "period", "from", "to", "limit", "resource", "campaign", "ad-group"];
 var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volume"];
@@ -2250,6 +2267,40 @@ function applyGoogleClickConversionUploadOptions(body, flags) {
   if (!Number.isInteger(jobId) || jobId >= 2147483648) throw new CliError("INVALID_VALUE", `Invalid integer for --job-id: ${rawJobId}`, "Use a non-negative integer below 2147483648");
   body.jobId = jobId;
 }
+function buildGoogleConversionCreateInput(flags) {
+  const conversion = {
+    name: requireFlag(flags, "name", "Google conversion create requires --name"),
+    type: requireFlag(flags, "type", "Google conversion create requires --type"),
+    category: requireFlag(flags, "category", "Google conversion create requires --category")
+  };
+  if (flags.status !== void 0) {
+    if (flags.status !== "enabled") throw new CliError("INVALID_VALUE", `Unsupported conversion create status: ${String(flags.status)}`, "Use --status enabled or omit the flag.");
+    conversion.status = flags.status;
+  }
+  if (typeof flags["counting-type"] === "string") conversion.countingType = flags["counting-type"];
+  if (typeof flags["default-value"] === "string") conversion.defaultValue = readNumberFlag(flags, "default-value", "Use a non-negative number for --default-value");
+  if (typeof flags.currency === "string") conversion.currency = flags.currency;
+  const clickDays = readPositiveIntegerFlag(flags, "click-days");
+  const viewDays = readPositiveIntegerFlag(flags, "view-days");
+  if (clickDays !== void 0 || viewDays !== void 0) conversion.attributionWindow = { clickDays, viewDays };
+  return conversion;
+}
+function buildGoogleConversionUpdateInput(flags) {
+  const changes = {};
+  if (typeof flags.name === "string") changes.name = flags.name;
+  if (typeof flags.category === "string") changes.category = flags.category;
+  if (typeof flags["counting-type"] === "string") changes.countingType = flags["counting-type"];
+  if (typeof flags["default-value"] === "string") changes.defaultValue = readNumberFlag(flags, "default-value", "Use a non-negative number for --default-value");
+  if (typeof flags.currency === "string") changes.currency = flags.currency;
+  if (Object.keys(changes).length === 0) throw new CliError("MISSING_FLAG", "Conversion update requires at least one change", "Pass --name, --category, --counting-type, --default-value, --currency, or --data");
+  return changes;
+}
+function readPositiveIntegerFlag(flags, key) {
+  const value = flags[key];
+  if (value === void 0) return void 0;
+  if (typeof value !== "string" || !/^\d+$/u.test(value) || Number(value) < 1) throw new CliError("INVALID_VALUE", `Invalid positive integer for --${key}: ${String(value)}`, `Use a positive integer for --${key}`);
+  return Number(value);
+}
 function resolveAssetScope(flags) {
   const scopeType = typeof flags.scope === "string" ? flags.scope : void 0;
   if (scopeType !== "account" && scopeType !== "campaign" && scopeType !== "ad-group") throw new CliError("MISSING_FLAG", "Missing required flag: `--scope`", "Use --scope account|campaign|ad-group");
@@ -2616,6 +2667,57 @@ async function uploadGoogleConversions(client, _args, flags) {
   const path3 = `/manage/google/conversions/upload${query}`;
   return client.post(path3, body);
 }
+async function listGoogleConversions(client, _args, flags) {
+  validateFlags(flags, CONVERSION_LIST_FLAGS, "manage google conversions list");
+  const accountId = typeof flags.account === "string" ? flags.account : void 0;
+  const fields = typeof flags.fields === "string" ? flags.fields : void 0;
+  const limit = typeof flags.limit === "string" ? flags.limit : void 0;
+  const offset = typeof flags.offset === "string" ? flags.offset : void 0;
+  const query = queryString({ accountId, fields, limit, offset });
+  return client.get(`/manage/google/conversions${query}`);
+}
+async function getGoogleConversion(client, args, flags) {
+  validateFlags(flags, [], "manage google conversions get");
+  const id = requireGoogleNumericId(args, "conversion-id", "Run: adkit manage google conversions get <conversion-id>");
+  const accountId = typeof flags.account === "string" ? flags.account : void 0;
+  const fields = typeof flags.fields === "string" ? flags.fields : void 0;
+  const query = queryString({ accountId, fields });
+  return client.get(`/manage/google/conversions/${id}${query}`);
+}
+async function createGoogleConversion(client, _args, flags) {
+  validateFlags(flags, CONVERSION_CREATE_FLAGS, "manage google conversions create");
+  if (typeof flags.data === "string") {
+    const rawBody2 = parseDataFlag(flags, 'Use { "conversions": [...] } for Google conversion create');
+    const query2 = buildGoogleMutationQuery(flags, rawBody2);
+    const body2 = removeQueryOnlyBodyKeys(rawBody2, ["accountId"]);
+    return client.post(`/manage/google/conversions${query2}`, body2);
+  }
+  const conversion = buildGoogleConversionCreateInput(flags);
+  const rawBody = { conversions: [conversion] };
+  const query = buildGoogleMutationQuery(flags, rawBody);
+  const body = removeQueryOnlyBodyKeys(rawBody, ["accountId"]);
+  return client.post(`/manage/google/conversions${query}`, body);
+}
+async function updateGoogleConversion(client, args, flags) {
+  validateFlags(flags, CONVERSION_UPDATE_FLAGS, "manage google conversions update");
+  const id = requireGoogleNumericId(args, "conversion-id", "Run: adkit manage google conversions update <conversion-id> --data <json>");
+  if (typeof flags.data === "string") {
+    const rawBody2 = parseDataFlag(flags, "Use a Google conversion update object");
+    const query2 = buildGoogleMutationQuery(flags, rawBody2);
+    const body2 = removeQueryOnlyBodyKeys(rawBody2, ["accountId"]);
+    return client.patch(`/manage/google/conversions/${id}${query2}`, body2);
+  }
+  const rawBody = buildGoogleConversionUpdateInput(flags);
+  const query = buildGoogleMutationQuery(flags, rawBody);
+  const body = removeQueryOnlyBodyKeys(rawBody, ["accountId"]);
+  return client.patch(`/manage/google/conversions/${id}${query}`, body);
+}
+async function deleteGoogleConversion(client, args, flags) {
+  validateFlags(flags, [], "manage google conversions delete");
+  const id = requireGoogleNumericId(args, "conversion-id", "Run: adkit manage google conversions delete <conversion-id>");
+  const query = buildGoogleMutationQuery(flags, {});
+  return client.delete(`/manage/google/conversions/${id}${query}`);
+}
 async function listGoogleCampaigns(client, _args, flags) {
   validateFlags(flags, CAMPAIGN_LIST_FLAGS, "manage google campaigns list");
   const qs = buildGoogleListQuery(flags);
@@ -5083,6 +5185,7 @@ ${FLAG.budgetDaily}
 Flags (list):
 ${FLAG.account}
   --status <s>        Filter by effective status (default: active,paused,in_process,with_issues; use "all" for every status)
+  --limit <n>         Maximum campaigns to return
 
 Flags (list/get):
   --raw               Return raw Meta API response (no conversion)
@@ -5118,6 +5221,7 @@ ${FLAG.budgetDaily}
 Flags (list):
 ${FLAG.account}
   --status <s>        Filter by effective status (default: active,paused,in_process,with_issues; use "all" for every status)
+  --limit <n>         Maximum campaigns to return
 
 Flags (list/get):
   --raw               Return raw Meta API response (no conversion)
@@ -5472,7 +5576,9 @@ Flags:
   --adset-ids <ids>   Comma-separated ad set IDs
   --ad-ids <ids>      Comma-separated ad IDs
   --statuses <s>      active, paused (filter by entity status)
-  --period <range>    Relative range like 7d or preset: today, yesterday, this_month, last_month, this_quarter, last_quarter, this_year, last_year, maximum (default: 30d)
+  --period <range>    3d, 7d, 14d, 28d, 30d, 90d, or a named preset (default: 30d)
+                        Named presets: today, yesterday, this_month, last_month, this_quarter, last_quarter, this_year, last_year, maximum
+                        Use --from/--to for any other date range.
   --from <date>       Start date, YYYY-MM-DD
   --to <date>         End date, YYYY-MM-DD
   --fields <list>     Normalized fields, e.g. spend, impressions, clicks, conversionEvents, etc
@@ -6441,8 +6547,43 @@ Notes:
   YouTube registration does not upload, copy, or re-host the video.`;
 var GOOGLE_CONVERSIONS_HELP = `adkit manage google conversions \u2014 Google Ads conversion tracking
 
+  list                List configured conversion actions
+  get <id>            View a conversion action
+  create              Create a conversion action
+  update <id>         Update a conversion action
+  delete <id>         Delete a conversion action
   upload              Upload offline click conversion events
 
+Flags (list/get):
+  --account <id>      Optional if one Google Ads account is connected
+  --fields <fields>   Comma-separated response fields
+  --limit <n>         Maximum rows to return (list only)
+  --offset <n>        Rows to skip (list only)
+
+Flags (create):
+  --name <name>       Conversion action name (required for create)
+  --type <type>       Conversion action type (required for create)
+  --category <value>  Conversion category (required for create)
+  --status <status>   enabled (create only)
+  --counting-type <t> one or many
+  --default-value <n> Non-negative default conversion value
+  --currency <code>   ISO currency code, e.g. USD
+  --click-days <n>    Positive click attribution window
+  --view-days <n>     Positive view attribution window
+  --account <id>      Optional if one Google Ads account is connected
+  --publish           Apply directly to Google instead of saving a draft
+  --data <json>       Exact body: {"conversions":[...]}
+
+Flags (update):
+  --name <name>       New conversion action name
+  --category <value>  New conversion category
+  --counting-type <t> one or many
+  --default-value <n> Non-negative default conversion value
+  --currency <code>   ISO currency code, e.g. USD
+  --account <id>      Optional if one Google Ads account is connected
+  --publish           Apply directly to Google instead of saving a draft
+  --data <json>       Exact partial update object
+
 Flags (upload):
   --conversion <id>   Google conversion ID (platformId), must be type upload_clicks
   --gclid <id>        Google click ID
@@ -6459,13 +6600,38 @@ Flags (upload):
   --data <json>       Batch body: {"conversions":[...],"validateOnly":true}
 
 Examples:
+  adkit manage google conversions list --account 1234567890
+  adkit manage google conversions get 123456 --account 1234567890
+  adkit manage google conversions create --name "Qualified lead" --type upload_clicks --category submit_lead_form
+  adkit manage google conversions update 123456 --name "Qualified lead v2" --publish
+  adkit manage google conversions delete 123456
   adkit manage google conversions upload --conversion 123 --gclid EAIaIQob... --occurred-at "2026-06-24 13:45:00+00:00" --value 120 --currency USD --validate-only
   adkit manage google conversions upload --data '{"conversions":[{"conversionId":"123","gclid":"EAIaIQob...","occurredAt":"2026-06-24 13:45:00+00:00","value":120,"currency":"USD"}],"validateOnly":true}' --account 1234567890
 
 Notes:
+  Create, update, and delete save a draft by default. Pass --publish to apply immediately.
+  Google conversion actions do not support paused. Use delete for removal.
+  Use --data for advanced fields such as isPrimary and alwaysUseDefaultValue.
   Upload sends events directly to Google; it is not a draft flow.
   Use --validate-only before a real upload when testing a new CRM/backend export.
   Real uploads require publish access.`;
+var META_CONVERSIONS_HELP = `adkit manage meta conversions \u2014 Meta Custom Conversions
+
+  list                List configured custom conversions
+
+Flags (list):
+  --account <id>      Optional if one Meta ad account is connected
+  --limit <n>         Maximum rows to return
+  --offset <n>        Rows to skip
+  --raw               Return raw Meta custom conversion rows
+
+Notes:
+  This command is read-only. Create or edit custom conversions in Meta Events Manager.
+  Use platformId from a result with: adkit manage meta results --conversion-event-keys <id>
+  For conversion counts, CPA, and ROAS, use meta results instead.
+
+Example:
+  adkit manage meta conversions list --account act_123`;
 var META_RESEARCH_HELP = `adkit manage meta research \u2014 Meta Ads research tools
 
   interests <query>   Search targeting interests (returns IDs for ad set targeting)
@@ -6504,6 +6670,7 @@ Examples:
   "meta results": RESULTS_HELP,
   "meta creatives": CREATIVE_HELP,
   "meta lead-forms": LEAD_FORM_HELP,
+  "meta conversions": META_CONVERSIONS_HELP,
   "google accounts": `adkit manage google accounts \u2014 Google Ads accounts
 
   list                List connected Google Ads accounts
@@ -6955,6 +7122,7 @@ Entity groups:
   adsets              Manage ad sets
   ads                 Manage ads
   lead-forms          List existing Meta Instant Forms (supporting asset)
+  conversions         List configured Meta Custom Conversions
   results             Performance metrics (spend, clicks, conversions) \u2014 not in list commands
   creatives           Manage ad creatives (prefer using ads with --media instead)
   research            Research targeting interests
@@ -8534,6 +8702,16 @@ async function main() {
             }
             break;
           }
+          case "conversions": {
+            if (!action || flags.help) {
+              showHelp("meta conversions");
+              return;
+            }
+            if (action !== "list") throw new CliError("UNKNOWN_COMMAND", `Unknown action: meta conversions ${action}`, "Available: list");
+            data = await listMetaConversions(client, restArgs, flags);
+            emptyHint = "No Meta Custom Conversions found. Standard events such as purchase and lead do not appear in this list.";
+            break;
+          }
           case "creatives": {
             switch (action) {
               case "create":
@@ -8579,7 +8757,7 @@ async function main() {
             break;
           }
           default:
-            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: meta ${entity}`, "Available: accounts, campaigns, adsets, ads, lead-forms, results, creatives, media, research");
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: meta ${entity}`, "Available: accounts, campaigns, adsets, ads, lead-forms, conversions, results, creatives, media, research");
         }
       } else if (platform2 === "google") {
         switch (entity) {
@@ -8851,11 +9029,27 @@ async function main() {
               return;
             }
             switch (action) {
+              case "list":
+                data = await listGoogleConversions(client, restArgs, flags);
+                emptyHint = "No Google conversion actions found for this account.";
+                break;
+              case "get":
+                data = await getGoogleConversion(client, restArgs, flags);
+                break;
+              case "create":
+                data = await createGoogleConversion(client, restArgs, flags);
+                break;
+              case "update":
+                data = await updateGoogleConversion(client, restArgs, flags);
+                break;
+              case "delete":
+                data = await deleteGoogleConversion(client, restArgs, flags);
+                break;
               case "upload":
                 data = await uploadGoogleConversions(client, restArgs, flags);
                 break;
               default:
-                throw new CliError("UNKNOWN_COMMAND", `Unknown action: google conversions ${action}`, "Available: upload");
+                throw new CliError("UNKNOWN_COMMAND", `Unknown action: google conversions ${action}`, "Available: list, get, create, update, delete, upload");
             }
             break;
           }

package/package.json

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