@koda-sl/baker-cli 0.553.0 → 0.555.0

package/dist/x-APVY4YHX.js

@@ -0,0 +1,47 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/index.ts
+import { defineCommand } from "citty";
+var xCommand = defineCommand({
+  meta: {
+    name: "x",
+    description: `X (Twitter) Ads commands. Read campaigns, line items, promoted tweets, creatives, audiences, and analytics.
+
+Start here:
+  baker ads x accounts                              \u2014 list accessible X Ads accounts
+  baker ads x stats sync --list-presets             \u2014 see available stats presets
+  baker ads x targeting-constants --constant locations --q "Madrid"
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x promoted-tweets --account-id 18ce53xyz
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads x stats job-create --entity CAMPAIGN --entity-ids abc \\
+    --start-time 2026-04-01T00:00:00Z --end-time 2026-05-01T00:00:00Z \\
+    --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
+
+The CLI auto-detects --account-id when exactly one X Ads account is connected, or via BAKER_X_ADS_ACCOUNT_ID.
+Full guide: __tooling__/docs/tools/baker/ads-x.md`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-KQ7NCM4L.js").then((m) => m.accountsCommand),
+    funding: () => import("./funding-7M4TJ3MW.js").then((m) => m.fundingCommand),
+    campaigns: () => import("./campaigns-B2AUW4TV.js").then((m) => m.campaignsCommand),
+    "line-items": () => import("./line-items-KPIKXLG4.js").then((m) => m.lineItemsCommand),
+    "promoted-tweets": () => import("./promoted-tweets-TGFPH7UI.js").then((m) => m.promotedTweetsCommand),
+    tweets: () => import("./tweets-33OCH74J.js").then((m) => m.tweetsCommand),
+    cards: () => import("./cards-HUXBNMEM.js").then((m) => m.cardsCommand),
+    draft: () => import("./draft-N56HPS36.js").then((m) => m.draftCommand),
+    media: () => import("./media-422INJCD.js").then((m) => m.mediaCommand),
+    audiences: () => import("./audiences-5TOTVZMK.js").then((m) => m.audiencesCommand),
+    "targeting-criteria": () => import("./targeting-criteria-H42LRULY.js").then((m) => m.targetingCriteriaCommand),
+    "targeting-constants": () => import("./targeting-constants-ZS422W5A.js").then((m) => m.targetingConstantsCommand),
+    "active-entities": () => import("./active-entities-3266UJYN.js").then((m) => m.activeEntitiesCommand),
+    stats: () => import("./stats-FSAXWTSE.js").then((m) => m.statsCommand)
+  }
+});
+export {
+  xCommand
+};
+//# sourceMappingURL=x-APVY4YHX.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.553.0",
+  "version": "0.555.0",
   "description": "AI-agent-first CLI for interacting with Baker, including the Baker creative canvas.",
   "type": "module",
   "bin": {

package/dist/account-XIC5TTV3.js

@@ -1,82 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError,
-  resolveAccountIdArg
-} from "./chunk-42JTSTQ3.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-QYH2UZAK.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-GO6ISZUZ.js";
-import "./chunk-RCNAKWK7.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-MSMTG6OC.js";
-import {
-  apiGet
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/account.ts
-import { defineCommand } from "citty";
-var accountDetailCommand = defineCommand({
-  meta: {
-    name: "detail",
-    description: `Single LinkedIn ad account detail (currency, status, type).
-
-Examples:
-  baker ads linkedin account --account-id 503001492
-  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-    "account-urn": { type: "string", description: "Alias for --account-id" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = { "account-id": accountId };
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/linkedin/account", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput([data], fmt);
-        return;
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-var accountCommand = defineCommand({
-  meta: {
-    name: "account",
-    description: `LinkedIn ad account: its detail, and the settings that apply across every ad set in it.
-
-Examples:
-  baker ads linkedin account --account-id 503001492                          \u2014 currency, status, type
-  baker ads linkedin account url-params --param utm_source=linkedin          \u2014 UTMs for every ad in the account`
-  },
-  subCommands: {
-    detail: accountDetailCommand,
-    "url-params": () => import("./write-commands-ZS4O4DSV.js").then((m) => m.accountUrlParamsCommand)
-  },
-  args: accountDetailCommand.args,
-  default: "detail"
-});
-export {
-  accountCommand
-};
-//# sourceMappingURL=account-XIC5TTV3.js.map

package/dist/account-assets-V7KSSTVP.js

@@ -1,290 +0,0 @@
-import {
-  csvOrJson,
-  handleMetaError,
-  resolveAccountIdArg
-} from "./chunk-QY7EK6Q4.js";
-import "./chunk-QALAJNBG.js";
-import {
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-QYH2UZAK.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-GO6ISZUZ.js";
-import {
-  apiGet
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/account-assets.ts
-import { defineCommand } from "citty";
-function emit(rows, args, hints) {
-  const fmt = csvOrJson(args);
-  if (fmt !== "json") {
-    writeAdsOutput(rows, fmt, void 0, hints);
-    return;
-  }
-  writeJsonEnvelope(hints.length > 0 ? { ok: true, data: rows, hints } : { ok: true, data: rows });
-}
-async function read(path, params, args) {
-  if (args["no-cache"]) params["skip-cache"] = "true";
-  return await apiGet(path, params);
-}
-var outputArg = { type: "string", description: "json|csv|jsonl|md", default: "json" };
-var accountArg = { type: "string", description: "Meta ad account ID (act_...)" };
-var schemaAccount = { type: "string", description: "Meta ad account ID (act_123)", required: false };
-var schemaNoCache = { type: "boolean", description: "Bypass the cache", required: false };
-var schemaOutput = { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" };
-function instagramIdentityHints(rows) {
-  if (rows.length === 0) {
-    return [
-      "No Instagram account is linked to this ad account or its Pages. A creative without --instagram-user cannot run in Instagram feeds, Stories or Reels \u2014 the account owner links one in Meta Business settings (Accounts \u2192 Instagram accounts) and assigns it to the ad account."
-    ];
-  }
-  const listed = rows.filter((row) => row.sources.includes("ad_account") || row.sources.includes("connected"));
-  const hints = ["Pass the id as `creatives create --instagram-user <id>`."];
-  if (listed.length > 0 && listed.length < rows.length) {
-    hints.push(
-      `Use one listed on the ad account (${listed.map((row) => row.username ?? row.id).join(", ")}): when the account lists any, staging refuses an identity it does not list.`
-    );
-  } else if (listed.length === 0) {
-    hints.push(
-      "Only Page identities are listed (page = the Page's linked Instagram account, page_backed = an Instagram presence Meta made for a Page with none). Meta accepts either as --instagram-user; a page_backed one shows the Page's name and picture on Instagram."
-    );
-  }
-  if (new Set(rows.map((row) => row.pageId).filter(Boolean)).size > 1) {
-    hints.push("Several Pages are involved \u2014 use the identity of the Page the creative runs from (--page).");
-  }
-  return hints;
-}
-registerSchema({
-  command: "ads.meta.instagram-accounts",
-  description: "The Instagram accounts an ad on this account can run as \u2014 the id `creatives create --instagram-user` takes. Lists accounts assigned or connected to the ad account and each promotable Page's linked or page-backed one.",
-  args: {
-    "account-id": schemaAccount,
-    "no-cache": schemaNoCache,
-    output: { type: "string", description: "json|csv", required: false, default: "json" }
-  }
-});
-var instagramAccountsCommand = defineCommand({
-  meta: {
-    name: "instagram-accounts",
-    description: "Instagram identities an ad can run as (the --instagram-user id). Start here before creatives create: baker ads meta instagram-accounts --account-id act_123"
-  },
-  args: { "account-id": accountArg, "no-cache": NO_CACHE_ARG, output: outputArg },
-  run: async ({ args }) => {
-    const accountId = await resolveAccountIdArg(args);
-    try {
-      const rows = await read(
-        "/api/ads/meta/instagram-accounts",
-        { "account-id": accountId },
-        args
-      );
-      emit(
-        rows.map((row) => ({ ...row, sources: row.sources.join(",") })),
-        args,
-        instagramIdentityHints(rows)
-      );
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-registerSchema({
-  command: "ads.meta.apps",
-  description: "The apps this ad account can promote (app installs / app engagement), with their store URLs \u2014 the application_id and object_store_url an app ad set's promoted_object takes.",
-  args: { "account-id": schemaAccount, "no-cache": schemaNoCache, output: schemaOutput }
-});
-var appsCommand = defineCommand({
-  meta: {
-    name: "apps",
-    description: "Apps the ad account can promote, for an app ad set's promoted_object. Example: baker ads meta apps --account-id act_123"
-  },
-  args: { "account-id": accountArg, "no-cache": NO_CACHE_ARG, output: outputArg },
-  run: async ({ args }) => {
-    const accountId = await resolveAccountIdArg(args);
-    try {
-      const rows = await read(
-        "/api/ads/meta/apps",
-        { "account-id": accountId },
-        args
-      );
-      emit(
-        rows.map((row) => ({ ...row })),
-        args,
-        rows.length > 0 ? [
-          'An app ad set promotes one: promoted_object {"application_id":"<id>","object_store_url":"<store url>"}. Use a real store URL (itunes / google_play); fb_canvas and instant_game are not app stores.'
-        ] : [
-          "No promotable apps. The app has to be registered in Meta for Developers and its owner has to add this ad account under the app's Advanced settings \u2192 Advertising accounts."
-        ]
-      );
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-registerSchema({
-  command: "ads.meta.dsa-recommendations",
-  description: "Names Meta suggests for the EU Digital Services Act disclosure (who benefits from and who pays for an ad) on this account.",
-  args: { "account-id": schemaAccount, "no-cache": schemaNoCache }
-});
-var dsaRecommendationsCommand = defineCommand({
-  meta: {
-    name: "dsa-recommendations",
-    description: "Meta's suggested DSA beneficiary/payor names for EU ad sets. Example: baker ads meta dsa-recommendations --account-id act_123"
-  },
-  args: { "account-id": accountArg, "no-cache": NO_CACHE_ARG },
-  run: async ({ args }) => {
-    const accountId = await resolveAccountIdArg(args);
-    try {
-      const names = await read("/api/ads/meta/dsa-recommendations", { "account-id": accountId }, args);
-      writeJsonEnvelope({
-        ok: true,
-        data: names,
-        hints: [
-          "An ad set reaching the EU needs dsa_beneficiary and dsa_payor. When they are missing Baker fills both from the ad account's saved EU advertiser and payer, else the first of these, else the business name; pass one of these instead when the user names someone else (an agency paying for a client)."
-        ]
-      });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-function compactImage(row) {
-  return {
-    hash: row.hash,
-    name: row.name,
-    width: row.width,
-    height: row.height,
-    status: row.status,
-    created_time: row.created_time
-  };
-}
-registerSchema({
-  command: "ads.meta.images",
-  description: "The ad account's image library \u2014 each image_hash a creative can reuse without uploading again. --hash looks one up.",
-  args: {
-    "account-id": schemaAccount,
-    hash: { type: "string", description: "One image hash", required: false },
-    limit: { type: "string", description: "Max rows (default 500)", required: false },
-    full: { type: "boolean", description: "URLs, permalink and which creatives use it", required: false },
-    "no-cache": schemaNoCache,
-    output: schemaOutput
-  }
-});
-var imagesCommand = defineCommand({
-  meta: {
-    name: "images",
-    description: "Image library of the ad account (image hashes). Example: baker ads meta images --account-id act_123 --limit 20; --hash <hash> for one"
-  },
-  args: {
-    "account-id": accountArg,
-    hash: { type: "string", description: "Look up one image hash" },
-    limit: { type: "string", description: "Max rows (default 500)" },
-    full: { type: "boolean", description: "Every field: url, permalink_url, creatives" },
-    "no-cache": NO_CACHE_ARG,
-    output: outputArg
-  },
-  run: async ({ args }) => {
-    const accountId = await resolveAccountIdArg(args);
-    const params = { "account-id": accountId };
-    if (args.hash) params.hash = args.hash;
-    if (args.limit) params.limit = args.limit;
-    try {
-      const rows = await read("/api/ads/meta/images", params, args);
-      emit(args.full ? rows : rows.map(compactImage), args, [
-        "A creative reuses one with its hash (the `image_hash` of a creative file). To push a Baker-library image, stage `media upload` instead."
-      ]);
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-registerSchema({
-  command: "ads.meta.labels",
-  description: "Ad labels defined on the account (Meta's tags for campaigns, ad sets, ads and creatives).",
-  args: { "account-id": schemaAccount, "no-cache": schemaNoCache, output: schemaOutput }
-});
-var labelsListArgs = { "account-id": accountArg, "no-cache": NO_CACHE_ARG, output: outputArg };
-var labelsCommand = defineCommand({
-  meta: {
-    name: "labels",
-    description: `Ad labels on the account (list), or stage label writes: create, rename, delete, attach (file campaigns/ad sets/ads/creatives under one), detach.
-  baker ads meta labels --account-id act_123
-  baker ads meta labels create --name "Q4 launch"
-  baker ads meta labels attach <labelId|meta_temp_\u2026> --campaigns 6123,6124 --ads 6125`
-  },
-  subCommands: {
-    list: () => labelsListCommand,
-    create: () => import("./asset-writes-RF6XTWLY.js").then((m) => m.labelsCreateCommand),
-    rename: () => import("./asset-writes-RF6XTWLY.js").then((m) => m.labelsRenameCommand),
-    delete: () => import("./asset-writes-RF6XTWLY.js").then((m) => m.labelsDeleteCommand),
-    attach: () => import("./asset-writes-RF6XTWLY.js").then((m) => m.labelsAttachCommand),
-    detach: () => import("./asset-writes-RF6XTWLY.js").then((m) => m.labelsDetachCommand)
-  },
-  args: labelsListArgs,
-  default: "list"
-});
-var labelsListCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "Ad labels on the account. Runs by default. Example: baker ads meta labels --account-id act_123"
-  },
-  args: labelsListArgs,
-  run: async ({ args }) => {
-    const accountId = await resolveAccountIdArg(args);
-    try {
-      const rows = await read("/api/ads/meta/labels", { "account-id": accountId }, args);
-      emit(rows, args, rows.length === 0 ? ["This account has no ad labels."] : []);
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-registerSchema({
-  command: "ads.meta.high-demand-periods",
-  description: "The budget boosts (high-demand periods) set on a campaign or ad set: when each runs and by how much.",
-  args: {
-    "campaign-id": { type: "string", description: "Campaign or ad set ID", required: true },
-    "no-cache": schemaNoCache,
-    output: schemaOutput
-  }
-});
-var highDemandPeriodsCommand = defineCommand({
-  meta: {
-    name: "high-demand-periods",
-    description: "Budget boosts on a campaign or ad set. Example: baker ads meta high-demand-periods --campaign-id 6123 (stage new ones with --budget-boost on campaigns or adsets create|update)"
-  },
-  args: {
-    "campaign-id": { type: "string", description: "Campaign (or ad set) ID", required: true },
-    "no-cache": NO_CACHE_ARG,
-    output: outputArg
-  },
-  run: async ({ args }) => {
-    try {
-      const rows = await read(
-        "/api/ads/meta/high-demand-periods",
-        { "campaign-id": args["campaign-id"] },
-        args
-      );
-      emit(rows, args, rows.length === 0 ? ["No budget boosts on this campaign."] : []);
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-export {
-  appsCommand,
-  dsaRecommendationsCommand,
-  highDemandPeriodsCommand,
-  imagesCommand,
-  instagramAccountsCommand,
-  instagramIdentityHints,
-  labelsCommand
-};
-//# sourceMappingURL=account-assets-V7KSSTVP.js.map