@adkit/cli 1.13.33 → 1.13.34

package/dist/cli.js

@@ -4818,6 +4818,56 @@ async function getLibraryAd(client, args, _flags) {
   if (!id) throw new CliError("MISSING_ARGUMENT", "Missing required argument: `<id>`", "Run: adkit library ads <ad-id>");
   return client.get(`/library/ads/${id}`);
 }
+var LIBRARY_BOARD_FIELDS = ["name", "description", "color"];
+async function createLibraryBoard(client, _args, flags) {
+  validateFlags(flags, LIBRARY_BOARD_FIELDS, "library boards create");
+  const name = requireFlag(flags, "name", "Run: adkit library boards create --name <name>");
+  const body = { name };
+  const description = readLibraryBoardTextFlag(flags, "description");
+  const color = readLibraryBoardTextFlag(flags, "color");
+  if (description !== void 0) body.description = description;
+  if (color !== void 0) body.color = color;
+  return client.post("/library/boards", body);
+}
+async function updateLibraryBoard(client, args, flags) {
+  validateFlags(flags, [...LIBRARY_BOARD_FIELDS, "share-enabled"], "library boards update");
+  const boardId = requireArg(args, 0, "board-id", "Run: adkit library boards update <board-id> --name <name>");
+  const body = {};
+  const name = readLibraryBoardTextFlag(flags, "name");
+  const description = readLibraryBoardTextFlag(flags, "description");
+  const color = readLibraryBoardTextFlag(flags, "color");
+  const shareEnabled = readLibraryBoardShareEnabled(flags);
+  if (name !== void 0) body.name = name;
+  if (description !== void 0) body.description = description;
+  if (color !== void 0) body.color = color;
+  if (shareEnabled !== void 0) body.shareEnabled = shareEnabled;
+  if (Object.keys(body).length === 0) throw new CliError("MISSING_FLAG", "Board update requires at least one field", "Use --name, --description, --color, or --share-enabled <true|false>");
+  const encodedBoardId = encodeURIComponent(boardId);
+  return client.patch(`/library/boards/${encodedBoardId}`, body);
+}
+async function addLibraryBoardAds(client, args, flags) {
+  validateFlags(flags, [], "library boards add-ads");
+  const boardId = requireArg(args, 0, "board-id", "Run: adkit library boards add-ads <board-id> <ad-id...>");
+  const adIds = args.slice(1);
+  if (adIds.length === 0) throw new CliError("MISSING_ARGUMENT", "Expected at least one ad ID after the board ID", "Run: adkit library boards add-ads <board-id> <ad-id...>");
+  if (adIds.length > 20) throw new CliError("INVALID_VALUE", "A board add-ads command accepts at most 20 ad IDs", "Split the ads across multiple add-ads commands");
+  const encodedBoardId = encodeURIComponent(boardId);
+  return client.post(`/library/boards/${encodedBoardId}/ads`, { adIds });
+}
+function readLibraryBoardTextFlag(flags, key) {
+  const value = flags[key];
+  if (typeof value === "string") return value;
+  if (!Array.isArray(value)) return void 0;
+  if (value.length === 1) return value[0];
+  throw new CliError("INVALID_VALUE", `--${key} can only be provided once for board commands`, `Use one --${key} value`);
+}
+function readLibraryBoardShareEnabled(flags) {
+  const value = flags["share-enabled"];
+  if (value === void 0) return void 0;
+  if (value === true || value === "true") return true;
+  if (value === "false") return false;
+  throw new CliError("INVALID_VALUE", "--share-enabled must be true or false", "Use --share-enabled true or --share-enabled false");
+}
 
 // src/commands/studio.ts
 import { readFile as readFile2 } from "node:fs/promises";
@@ -8122,8 +8172,27 @@ Examples:
 
   advertisers         Browse and inspect advertisers
   ads                 Browse and inspect ads
+  boards              Create, update, share, and fill inspiration boards
 
 Run \`adkit library <command> --help\` for details.`.trim(),
+  "library boards": `adkit library boards \u2014 Manage inspiration boards
+
+  create                         Create a private board
+  update <board-id>              Update board details or sharing
+  add-ads <board-id> <ad-id...>  Add 1-20 library ads without duplicates
+
+Flags (create/update):
+  --name <text>                  Board name
+  --description <text>           Board description
+  --color <value>                Board color
+  --share-enabled <true|false>   Enable or disable the public link (update only)
+  --project <id>                 Choose the project; otherwise use the active project
+
+Examples:
+  adkit library boards create --name "Offer-first banners"
+  adkit library boards update 507f1f77bcf86cd799439011 --name "Client references"
+  adkit library boards update 507f1f77bcf86cd799439011 --share-enabled true
+  adkit library boards add-ads 507f1f77bcf86cd799439011 507f1f77bcf86cd799439012 507f1f77bcf86cd799439013`.trim(),
   studio: `adkit studio \u2014 Create and manage Studio ads
 
   ads                 Manage Studio ads
@@ -10406,7 +10475,23 @@ ${pageInfo}`);
         }
         return;
       }
-      throw new CliError("UNKNOWN_COMMAND", `Unknown library command: ${libraryTarget}`, "Available: advertisers, ads");
+      if (libraryTarget === "boards") {
+        const action = args[2];
+        if (flags.help || !action) {
+          showHelp("library boards", flags.help === "full");
+          return;
+        }
+        const client = requireClient(flags);
+        const commandArgs = args.slice(3);
+        let data;
+        if (action === "create") data = await createLibraryBoard(client, commandArgs, flags);
+        else if (action === "update") data = await updateLibraryBoard(client, commandArgs, flags);
+        else if (action === "add-ads") data = await addLibraryBoardAds(client, commandArgs, flags);
+        else throw new CliError("UNKNOWN_COMMAND", `Unknown library boards action: ${action}`, "Available: create, update, add-ads");
+        printResult(data, flags);
+        return;
+      }
+      throw new CliError("UNKNOWN_COMMAND", `Unknown library command: ${libraryTarget}`, "Available: advertisers, ads, boards");
     }
     if (args[0] === "studio") {
       const studioTarget = args[1];

package/package.json

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