@koda-sl/baker-cli 0.563.0-dev.25ca3cbc8 → 0.564.0

package/dist/performance-GEALWLJF.js

@@ -0,0 +1,27 @@
+import {
+  definitionInsights,
+  parseDays,
+  performanceCommand,
+  withDefinitions
+} from "./chunk-6RDVZRK2.js";
+import "./chunk-TSFHW2W4.js";
+import "./chunk-7BV5QN2P.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 "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  definitionInsights,
+  parseDays,
+  performanceCommand,
+  withDefinitions
+};
+//# sourceMappingURL=performance-GEALWLJF.js.map

package/dist/pixels-WTTLC4O5.js

@@ -0,0 +1,62 @@
+import {
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-ULIQNJ5J.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-OASXBRXQ.js";
+import "./chunk-RBCO3C3Q.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/pixels.ts
+import { defineCommand } from "citty";
+var CREATE_ARGS = {
+  name: { type: "string", description: "What the pixel is called in Ads Manager, e.g. withbaker.com", required: true }
+};
+function pixelCreateOp(args) {
+  return { kind: "pixel.create", payload: { name: typeof args.name === "string" ? args.name.trim() : args.name } };
+}
+registerSchema({
+  command: "ads.chatgpt.pixels.create",
+  description: "Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var pixelsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new website pixel (applies when the chat is published).
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [
+      `Define what it counts with \`baker ads chatgpt conversions create --pixel ${staged.ref} --name \u2026 --event \u2026\`.`,
+      "After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag."
+    ]);
+  }
+});
+var pixelsCommand = defineCommand({
+  meta: {
+    name: "pixels",
+    description: `Website pixels \u2014 what a site installs so ChatGPT Ads can count its conversions. Read them with \`baker ads chatgpt conversions\`.
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  subCommands: { create: pixelsCreateCommand }
+});
+export {
+  pixelCreateOp,
+  pixelsCommand
+};
+//# sourceMappingURL=pixels-WTTLC4O5.js.map

package/dist/posts-TRQCRLYZ.js

@@ -0,0 +1,36 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/posts/index.ts
+import { defineCommand } from "citty";
+var postsCommand = defineCommand({
+  meta: {
+    name: "posts",
+    description: `The posts the company's followed accounts published \u2014 its own pages and its key people (CEO, CTO, head of sales\u2026) on LinkedIn, Instagram, TikTok, YouTube and Facebook \u2014 text-only ones included, with their likes, comments and views, and whether each can run as a paid ad (usable \xB7 needs the author's OK \xB7 can't). Accounts are followed with \`baker media-sources add\`. Subcommands: list, get, search, add, suggest, approved, tag, refresh.
+
+Examples:
+  baker posts list --role ceo --usable needs_approval      # the CEO's posts a Thought Leader ad can boost
+  baker posts list --account linkedin:acme --sort engagement --since 2026-09-01
+  baker posts list --about-company                         # people's posts that name the company (ABM)
+  baker posts search "series A"
+  baker posts get <post-id>
+  baker posts add https://www.linkedin.com/posts/jane-doe_activity-7477679889043750912-K2pu
+  baker posts suggest <post-id> --verdict usable --note "Best-performing CEO post this month"
+  baker posts approved <post-id> --account-id 513852526       # the user says the author already approved it
+  baker ads linkedin creatives create --format tla --post <post-id> --campaign <ad set>
+Full guide: __tooling__/docs/tools/baker/posts.md`
+  },
+  subCommands: {
+    list: () => import("./list-2EJ3XZ6I.js").then((m) => m.listCommand),
+    get: () => import("./get-5SCYUC4G.js").then((m) => m.getCommand),
+    search: () => import("./search-HNRANK6H.js").then((m) => m.searchCommand),
+    add: () => import("./add-IMKVYDQV.js").then((m) => m.addCommand),
+    suggest: () => import("./suggest-KCN2NDYE.js").then((m) => m.suggestCommand),
+    approved: () => import("./approved-3XFZNRJR.js").then((m) => m.approvedCommand),
+    tag: () => import("./tag-NKAHDL35.js").then((m) => m.tagCommand),
+    refresh: () => import("./refresh-JSCYTM4B.js").then((m) => m.refreshCommand)
+  }
+});
+export {
+  postsCommand
+};
+//# sourceMappingURL=posts-TRQCRLYZ.js.map

package/dist/preview-Q3N6NMQ5.js

@@ -0,0 +1,101 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-QML3FCJC.js";
+import {
+  AD_PREVIEW_DIR,
+  renderAdPreviews
+} from "./chunk-EGVWSAWY.js";
+import "./chunk-VN3WDB4O.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import "./chunk-7BV5QN2P.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 {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/preview.ts
+import { writeFileSync } from "fs";
+import { defineCommand } from "citty";
+var previewCommand = defineCommand({
+  meta: {
+    name: "preview",
+    description: `See an existing LinkedIn ad exactly as people see it in the feed \u2014 LinkedIn's own renderer,
+for desktop and mobile. Returns shownText (the text displayed, in order) and a picture of each;
+Read the picture only for what text cannot tell (words in the artwork, cropping, how it looks).
+
+Start here before saying anything about how an ad LOOKS (which text shows, whether the headline
+appears under the image, what the button says): the API fields say what is stored, the preview
+shows what is displayed. Works for single image, carousel, video, event and job ads that already
+exist on LinkedIn; staged (unpublished) ads have no preview yet.
+
+Examples:
+  baker ads linkedin preview 1611562694 --account-id 503001492
+  baker ads linkedin preview 1611562694 --placement mobile
+  baker ads linkedin preview 1611562694 --out-dir /tmp/review`
+  },
+  args: {
+    id: { type: "positional", description: "Creative id or urn:li:sponsoredCreative:N", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    placement: { type: "string", description: "desktop|mobile|both (default: both)", default: "both" },
+    "out-dir": { type: "string", description: `Folder for the pictures (default: ${AD_PREVIEW_DIR})` },
+    "html-file": { type: "string", description: "Also save LinkedIn's raw preview iframes to this file" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const placement = String(args.placement);
+    if (!["desktop", "mobile", "both"].includes(placement)) {
+      writeJsonEnvelope({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "--placement must be desktop, mobile or both" }
+      });
+      process.exit(1);
+    }
+    try {
+      const body = { accountId, creativeId: String(args.id) };
+      const data = await apiPost("/api/ads/linkedin/preview", body);
+      const wanted = data.previews.filter((p) => placement === "both" || p.placement === placement);
+      if (wanted.length === 0) {
+        writeJsonEnvelope({
+          ok: true,
+          data: { creativeId: data.creativeId, previews: [] },
+          hints: [
+            "LinkedIn returned no preview for this ad (its format may not support one). Say its look could not be checked; do not describe it from the API fields."
+          ]
+        });
+        return;
+      }
+      if (args["html-file"]) {
+        writeFileSync(String(args["html-file"]), wanted.map((p) => p.html).join("\n"), "utf-8");
+      }
+      const rendered = await renderAdPreviews(wanted, {
+        dir: args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR,
+        name: `linkedin-${data.creativeId}`
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data: { creativeId: data.creativeId, previews: rendered.previews },
+        hints: rendered.hints
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  previewCommand
+};
+//# sourceMappingURL=preview-Q3N6NMQ5.js.map

package/dist/promoted-tweet-writes-DB6U5OIJ.js

@@ -0,0 +1,183 @@
+import {
+  csvArg,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-YXEUUGUJ.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-YD6OZSSY.js";
+import "./chunk-RBCO3C3Q.js";
+import {
+  TARGETING_OPERATORS,
+  TARGETING_TYPES
+} from "./chunk-7BV5QN2P.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 "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/promoted-tweet-writes.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.promotedTweets.create",
+  description: "Stage promoting one or more existing posts in an X ad group. Takes post (tweet) ids \u2014 the numeric id from the post's URL, not a base36 ads id.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-id": {
+      type: "string",
+      description: "Ad group id, or an x_temp_* ref staged in this draft",
+      required: true
+    },
+    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
+  }
+});
+var promotedTweetsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage promoting posts in an ad group (applies when the chat is published).
+
+Example:
+  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
+    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "promotedTweet.create",
+      accountId,
+      payload: { lineItemId: args["line-item-id"], tweetIds: csvArg(args["tweet-ids"]) ?? [] }
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.promotedTweets.remove",
+  description: "Stage removing one or more promoted posts. X has no pause for these \u2014 removal is the only way to stop one serving, and it cannot be undone (re-promoting creates a new association).",
+  args: {
+    ids: { type: "string", description: "Promoted-post ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false }
+  }
+});
+var promotedTweetsRemoveCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Stage removing promoted posts. Cannot be undone.
+
+Example:
+  baker ads x promoted-tweets remove ayyorn,ayyoro`
+  },
+  args: {
+    ids: { type: "positional", description: "Promoted-post ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOps(
+      requireTargets(args, "ids").map((id) => ({
+        kind: "promotedTweet.remove",
+        accountId,
+        target: id,
+        payload: {}
+      }))
+    );
+  }
+});
+registerSchema({
+  command: "ads.x.targetingCriteria.create",
+  description: `Stage one targeting criterion on an X ad group. One op per value, because X stores each criterion as its own entity. Look values up first with \`baker ads x targeting-constants\`.
+Types: ${TARGETING_TYPES.join(", ")}. Operators: ${TARGETING_OPERATORS.join(" (include) | ")} (exclude).`,
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-id": { type: "string", description: "Ad group id, or an x_temp_* ref", required: true },
+    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
+    value: {
+      type: "string",
+      description: "Targeting value \u2014 from `targeting-constants` for the lookup types",
+      required: true
+    },
+    operator: { type: "string", description: "EQ to include (default), NE to exclude", required: false }
+  }
+});
+var targetingCriteriaCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage one targeting criterion on an ad group.
+
+Examples:
+  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1
+  baker ads x targeting-criteria create --line-item-id wiee9 --type INTEREST --value 25 --operator NE`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
+    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
+    value: { type: "string", description: "Targeting value", required: true },
+    operator: { type: "string", description: "EQ (include) | NE (exclude)" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "targetingCriteria.create",
+      accountId,
+      payload: {
+        lineItemId: args["line-item-id"],
+        targetingType: args.type,
+        targetingValue: args.value,
+        ...args.operator ? { operatorType: args.operator } : {}
+      }
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.targetingCriteria.remove",
+  description: "Stage removing one or more targeting criteria from an X ad group.",
+  args: {
+    ids: { type: "string", description: "Targeting criterion ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false }
+  }
+});
+var targetingCriteriaRemoveCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Stage removing targeting criteria.
+
+Example:
+  baker ads x targeting-criteria remove 1dmtken`
+  },
+  args: {
+    ids: { type: "positional", description: "Targeting criterion ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOps(
+      requireTargets(args, "ids").map((id) => ({
+        kind: "targetingCriteria.remove",
+        accountId,
+        target: id,
+        payload: {}
+      }))
+    );
+  }
+});
+export {
+  promotedTweetsCreateCommand,
+  promotedTweetsRemoveCommand,
+  targetingCriteriaCreateCommand,
+  targetingCriteriaRemoveCommand
+};
+//# sourceMappingURL=promoted-tweet-writes-DB6U5OIJ.js.map

package/dist/promoted-tweets-ATKIVR2F.js

@@ -0,0 +1,119 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-YD6OZSSY.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-RBCO3C3Q.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/promoted-tweets.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.promotedTweets",
+  description: "List promoted tweets for an X Ads account. Returns id, line_item_id, tweet_id, approval_status. Filter by line-item-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var promotedTweetsListCommand = defineCommand({
+  meta: {
+    name: "promoted-tweets",
+    description: `List X Ads promoted tweets.
+
+Examples:
+  baker ads x promoted-tweets --account-id 18ce53xyz --line-item-ids abc,def`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const cacheKey = `promoted-tweets:${accountId}:${today}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["line-item-ids"]) params["line-item-ids"] = args["line-item-ids"];
+      if (args["with-deleted"]) params["with-deleted"] = "true";
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/promoted-tweets", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var promotedTweetsCommand = defineCommand({
+  meta: {
+    name: "promoted-tweets",
+    description: `Promoted posts \u2014 the association between a post and an ad group, which X Ads Manager calls an ad.
+
+There is no pause: removing the association is the only way to stop one serving,
+and it cannot be undone (re-promoting creates a new one). The post itself is
+never touched.
+
+Examples:
+  baker ads x promoted-tweets
+  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285
+  baker ads x promoted-tweets remove ayyorn`
+  },
+  subCommands: {
+    list: promotedTweetsListCommand,
+    create: () => import("./promoted-tweet-writes-DB6U5OIJ.js").then((m) => m.promotedTweetsCreateCommand),
+    remove: () => import("./promoted-tweet-writes-DB6U5OIJ.js").then((m) => m.promotedTweetsRemoveCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs" },
+    "with-deleted": { type: "boolean", description: "Include deleted" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  default: "list"
+});
+export {
+  promotedTweetsCommand
+};
+//# sourceMappingURL=promoted-tweets-ATKIVR2F.js.map