@adkit/cli 1.13.0 → 1.13.1

package/dist/cli.js

@@ -3493,6 +3493,12 @@ function buildLinkedInMediaUploadSource(flags) {
   return source;
 }
 
+// src/commands/microsoft.ts
+async function listMicrosoftAvailableAccounts(client, _args, flags) {
+  validateFlags(flags, [], "manage microsoft accounts available");
+  return client.get("/manage/microsoft/accounts/available");
+}
+
 // src/commands/status.ts
 function isStatusResponse(value) {
   if (!value || typeof value !== "object") return false;
@@ -4456,7 +4462,7 @@ var FLAG = {
   budgetDaily: "  --budget-daily <n>  Daily budget in account currency",
   cta: "  --cta <type>        sign_up, learn_more, shop_now, download, get_offer, contact_us, subscribe, get_quote, book_now, apply_now"
 };
-var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X", linkedin: "LinkedIn" };
+var RAW_PLATFORM_LABELS = { google: "Google", meta: "Meta", reddit: "Reddit", tiktok: "TikTok", x: "X", linkedin: "LinkedIn", microsoft: "Microsoft" };
 function rawPlatformCommandLine(platform2) {
   return `Raw ${RAW_PLATFORM_LABELS[platform2] ?? platform2} API calls use the shared command: adkit manage platform-api-requests --platform ${platform2} ...`;
 }
@@ -6150,9 +6156,9 @@ Examples:
 
 Flags:
   --data <json>             Full request object (preferred for agents)
-  --platform <meta|google|tiktok|reddit|x|linkedin> Target platform (required)
-  --endpoint <path>          Relative API path (required)
-  --payload <json>           JSON body for POST/PUT/PATCH, query params for GET, omit for DELETE
+  --platform <meta|google|tiktok|reddit|x|linkedin|microsoft> Target platform (required)
+  --endpoint <path>          Relative API path (required). Microsoft is the exception: pass the full https URL to a Bing Ads v13 host
+  --payload <json>           JSON body for POST/PUT/PATCH, query params for GET, omit for DELETE (exception: Microsoft DELETE takes a JSON body of ids)
   --method <GET|POST|PUT|PATCH|DELETE>  HTTP method (default: POST)
   --request-description <text>  What this request does (required)
   --account <id>             Ad account ID (required)
@@ -6168,7 +6174,8 @@ Examples:
   adkit manage platform-api-requests --platform tiktok --endpoint "campaign/get/" --method GET --payload '{"advertiser_id":"123"}' --request-description "List TikTok campaigns" --account 123
   adkit manage platform-api-requests --platform reddit --endpoint "ad_accounts/a2_example/campaigns" --payload '{"name":"Test","objective":"TRAFFIC","configured_status":"PAUSED"}' --request-description "Create paused Reddit campaign" --account a2_example
   adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t
-  adkit manage platform-api-requests --platform linkedin --endpoint "adCampaignGroups/(account:urn:li:sponsoredAccount:512345678)" --method GET --request-description "List LinkedIn campaign groups" --account 512345678`.trim(),
+  adkit manage platform-api-requests --platform linkedin --endpoint "adCampaignGroups/(account:urn:li:sponsoredAccount:512345678)" --method GET --request-description "List LinkedIn campaign groups" --account 512345678
+  adkit manage platform-api-requests --platform microsoft --endpoint "https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/Campaigns/QueryByAccountId" --payload '{"AccountId":187276743,"CampaignType":"Search"}' --request-description "List Microsoft campaigns" --account 187276743 --publish`.trim(),
   manage: `adkit manage \u2014 Ad platform management
 
 Platforms:
@@ -6178,6 +6185,7 @@ Platforms:
   reddit              Reddit Ads
   x                   X Ads raw API access
   linkedin            LinkedIn Ads (campaigns, ad groups, ads, targeting, results)
+  microsoft           Microsoft Ads raw API access + account discovery
   drafts              Manage drafts across platforms
   platform-api-requests  Send raw API requests (escape hatch)
 
@@ -6270,6 +6278,21 @@ ${rawPlatformCommandLine("x")}
 
 Examples:
   adkit manage platform-api-requests --platform x --endpoint "accounts/18ce54d4x5t/campaigns" --method GET --request-description "List X campaigns" --account 18ce54d4x5t`.trim(),
+  microsoft: `adkit manage microsoft \u2014 Microsoft Ads raw API access + account discovery
+
+Microsoft (Bing) is currently exposed through Advanced Platform Access, plus account discovery.
+Endpoints are FULL https URLs to Bing Ads v13 hosts (campaign/reporting/bulk .api.bingads.microsoft.com) \u2014 not relative paths.
+Bing REST puts the operation in the HTTP verb; query reads are POST to .../Query* paths.
+Because query reads are POST, add --publish on read-only Query* calls \u2014 otherwise you get a draft instead of data.
+
+${rawPlatformCommandLine("microsoft")}
+
+Commands:
+  accounts available   List Microsoft ad accounts discoverable from the connected workspace login
+
+Examples:
+  adkit manage microsoft accounts available
+  adkit manage platform-api-requests --platform microsoft --endpoint "https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/Campaigns/QueryByAccountId" --payload '{"AccountId":187276743,"CampaignType":"Search"}' --request-description "List Microsoft campaigns" --account 187276743 --publish`.trim(),
   linkedin: `adkit manage linkedin \u2014 LinkedIn Ads management
 
 Entity groups:
@@ -7202,13 +7225,14 @@ function readRawRequestData(flags) {
   const data = parseDataFlag(flags, `Run: adkit manage platform-api-requests --data '{"platform":"meta","endpoint":"act_123/campaigns","payload":{},"description":"Create campaign","accountId":"act_123"}'`);
   if (!data || typeof data !== "object" || Array.isArray(data)) throw new CliError("INVALID_VALUE", "--data must be a JSON object", "Include platform, endpoint, payload, description, and accountId");
   const input = data;
+  const platform2 = readRawRequestPlatform(input.platform);
   const method = readRawRequestMethod(input.method);
   const publish = readRawRequestPublish({ data: input, flags });
   const description = readRawRequestDataDescription(input);
-  const payload = readRawRequestPayload({ method, payload: input.payload, source: "data" });
+  const payload = readRawRequestPayload({ method, payload: input.payload, platform: platform2, source: "data" });
   return {
     body: {
-      platform: readRawRequestPlatform(input.platform),
+      platform: platform2,
       endpoint: readRawRequestString({ value: input.endpoint, field: "endpoint", hint: "Include endpoint in --data" }),
       payload,
       method,
@@ -7219,13 +7243,14 @@ function readRawRequestData(flags) {
   };
 }
 function readRawRequestFlags(flags) {
-  const platform2 = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, x, or linkedin");
+  const platformFlag = requireFlag(flags, "platform", "Required: --platform meta, google, tiktok, reddit, x, linkedin, or microsoft");
+  const platform2 = readRawRequestPlatform(platformFlag);
   const method = readRawRequestMethod(flags.method);
   const rawPayload = readRawRequestFlagPayload(flags);
-  const payload = readRawRequestPayload({ method, payload: rawPayload, source: "flag" });
+  const payload = readRawRequestPayload({ method, payload: rawPayload, platform: platform2, source: "flag" });
   return {
     body: {
-      platform: readRawRequestPlatform(platform2),
+      platform: platform2,
       endpoint: requireFlag(flags, "endpoint", "Required: --endpoint <api-path>"),
       payload,
       method,
@@ -7254,8 +7279,8 @@ function readRawRequestString(input) {
   throw new CliError("MISSING_FLAG", `Missing required field: \`${input.field}\``, input.hint);
 }
 function readRawRequestPlatform(value) {
-  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x" || value === "linkedin") return value;
-  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, x, or linkedin");
+  if (value === "meta" || value === "google" || value === "tiktok" || value === "reddit" || value === "x" || value === "linkedin" || value === "microsoft") return value;
+  throw new CliError("INVALID_VALUE", `Invalid platform: ${String(value)}`, "Use meta, google, tiktok, reddit, x, linkedin, or microsoft");
 }
 function readRawRequestMethod(value) {
   const method = typeof value === "string" ? value.toUpperCase() : "POST";
@@ -7280,7 +7305,7 @@ function readRawRequestPayload(input) {
     if (input.source === "data") throw new CliError("MISSING_FLAG", "POST/PUT/PATCH requests require payload in --data", 'Include "payload": {"key":"value"}');
     throw new CliError("MISSING_FLAG", "POST/PUT/PATCH requests require --payload", `Add --payload '{"key":"value"}'`);
   }
-  if (input.method === "DELETE" && input.payload !== void 0 && input.payload !== null) throw new CliError("INVALID_VALUE", "DELETE requests do not support payload", "Put identifiers in the endpoint path");
+  if (input.method === "DELETE" && input.platform !== "microsoft" && input.payload !== void 0 && input.payload !== null) throw new CliError("INVALID_VALUE", "DELETE requests do not support payload", "Put identifiers in the endpoint path");
   return input.payload ?? null;
 }
 function showHelp(key, full = false) {
@@ -7426,7 +7451,7 @@ async function main() {
         return;
       }
       const platform2 = manageTarget;
-      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x" && platform2 !== "linkedin") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
+      if (platform2 !== "meta" && platform2 !== "google" && platform2 !== "tiktok" && platform2 !== "reddit" && platform2 !== "x" && platform2 !== "linkedin" && platform2 !== "microsoft") throw new CliError("UNKNOWN_COMMAND", `Unknown platform: ${platform2}`, "Available: meta, google, tiktok, reddit, x, linkedin, microsoft, drafts, platform-api-requests");
       const entity = args[2];
       const action = args[3];
       const restArgs = args.slice(4);
@@ -8164,8 +8189,23 @@ async function main() {
           default:
             throw new CliError("UNKNOWN_COMMAND", `Unknown entity: linkedin ${entity}`, "Available: accounts, media, campaigns, ad-groups, ads, targeting-search, results, platform-api-requests");
         }
+      } else if (platform2 === "microsoft") {
+        switch (entity) {
+          case "accounts":
+            switch (action) {
+              case "available":
+                data = await listMicrosoftAvailableAccounts(client, restArgs, flags);
+                emptyHint = "No Microsoft ad accounts available from the connected workspace login.";
+                break;
+              default:
+                throw new CliError("UNKNOWN_COMMAND", `Unknown action: microsoft accounts ${action}`, "Available: available.");
+            }
+            break;
+          default:
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: microsoft ${entity}`, "Available: accounts, platform-api-requests");
+        }
       } else if (platform2 === "x") throw new CliError("UNKNOWN_COMMAND", `Unknown entity: x ${entity}`, "Available: platform-api-requests");
-      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, linkedin, drafts, platform-api-requests");
+      else throw new CliError("UNKNOWN_COMMAND", "Unknown platform", "Available: meta, google, tiktok, reddit, x, linkedin, microsoft, drafts, platform-api-requests");
       printResult(data, flags, emptyHint, detailEntity);
       return;
     }

package/package.json

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