@koda-sl/baker-cli 0.510.0 → 0.512.0-dev.8a743a629

package/dist/line-item-writes-V7UWLP7J.js

@@ -0,0 +1,209 @@
+import {
+  compact,
+  csvArg,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-VHJBM2CE.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-7NF73SCB.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  OBJECTIVES,
+  PLACEMENTS,
+  PRODUCT_TYPES
+} from "./chunk-7D7YRHN3.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/line-item-writes.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.lineItems.create",
+  description: `Stage a new X ad group under a campaign. Objective, product type and campaign are fixed at create \u2014 X refuses to change any of them afterwards, so get them right here.
+Objectives: ${OBJECTIVES.join(", ")}.`,
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "campaign-id": {
+      type: "string",
+      description: "Parent campaign id, or an x_temp_* ref staged in this draft",
+      required: true
+    },
+    name: { type: "string", description: "Ad group name", required: true },
+    objective: { type: "string", description: OBJECTIVES.join(" | "), required: true },
+    "product-type": { type: "string", description: PRODUCT_TYPES.join(" | "), required: false },
+    placements: { type: "string", description: `CSV of ${PLACEMENTS.join(", ")}`, required: false },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)", required: false },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET", required: false },
+    bid: {
+      type: "string",
+      description: "Bid in account currency \u2014 required for MAX/TARGET, refused for AUTO",
+      required: false
+    },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "start-time": { type: "string", description: "ISO 8601 start", required: false },
+    "end-time": { type: "string", description: "ISO 8601 end", required: false }
+  }
+});
+var lineItemsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new ad group (applies when the chat is published).
+
+Examples:
+  baker ads x line-items create --campaign-id oilf0 --name "Spain" --objective WEBSITE_CLICKS
+  baker ads x line-items create --campaign-id x_temp_abc --name "Spain" --objective REACH --bid-strategy MAX --bid 1.20`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "campaign-id": { type: "string", description: "Parent campaign id or x_temp_* ref", required: true },
+    name: { type: "string", description: "Ad group name", required: true },
+    objective: { type: "string", description: OBJECTIVES.join(" | "), required: true },
+    "product-type": { type: "string", description: PRODUCT_TYPES.join(" | ") },
+    placements: { type: "string", description: `CSV of ${PLACEMENTS.join(", ")}` },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)" },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET" },
+    bid: { type: "string", description: "Bid in account currency" },
+    "daily-budget": { type: "string", description: "Daily budget in account currency" },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency" },
+    "start-time": { type: "string", description: "ISO 8601 start" },
+    "end-time": { type: "string", description: "ISO 8601 end" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "lineItem.create",
+      accountId,
+      payload: compact({
+        campaignId: args["campaign-id"],
+        name: args.name,
+        objective: args.objective,
+        productType: args["product-type"],
+        placements: csvArg(args.placements),
+        entityStatus: args.status,
+        bidStrategy: args["bid-strategy"],
+        bidAmountLocalMicro: microsFromArg(args.bid, "--bid"),
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget"),
+        startTime: args["start-time"],
+        endTime: args["end-time"]
+      })
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.lineItems.update",
+  description: "Stage a change to an existing X ad group. Objective, product type and campaign are absent on purpose \u2014 X treats all three as immutable after create.",
+  args: {
+    id: { type: "string", description: "Ad group id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    name: { type: "string", description: "New name", required: false },
+    status: { type: "string", description: "ACTIVE | PAUSED", required: false },
+    placements: { type: "string", description: "CSV of placements", required: false },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET", required: false },
+    bid: { type: "string", description: "Bid in account currency", required: false },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "start-time": { type: "string", description: "ISO 8601 start", required: false },
+    "end-time": { type: "string", description: "ISO 8601 end", required: false }
+  }
+});
+var lineItemsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to an ad group.
+
+Examples:
+  baker ads x line-items update wiee9 --bid 1.50
+  baker ads x line-items update wiee9 --end-time 2026-12-31T00:00:00Z`
+  },
+  args: {
+    id: { type: "positional", description: "Ad group id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" },
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE | PAUSED" },
+    placements: { type: "string", description: "CSV of placements" },
+    "bid-strategy": { type: "string", description: "AUTO | MAX | TARGET" },
+    bid: { type: "string", description: "Bid in account currency" },
+    "daily-budget": { type: "string", description: "Daily budget in account currency" },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency" },
+    "start-time": { type: "string", description: "ISO 8601 start" },
+    "end-time": { type: "string", description: "ISO 8601 end" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "lineItem.update",
+      accountId,
+      target: requireTarget(args, "id"),
+      payload: compact({
+        name: args.name,
+        entityStatus: args.status,
+        placements: csvArg(args.placements),
+        bidStrategy: args["bid-strategy"],
+        bidAmountLocalMicro: microsFromArg(args.bid, "--bid"),
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget"),
+        startTime: args["start-time"],
+        endTime: args["end-time"]
+      })
+    });
+  }
+});
+function statusCommand(name, status) {
+  registerSchema({
+    command: `ads.x.lineItems.${name}`,
+    description: `Stage ${name === "pause" ? "a pause" : "a resume"} for one or more X ad groups. Pass every id in one call.`,
+    args: {
+      ids: { type: "string", description: "Ad group ids, comma-separated", required: true },
+      "account-id": { type: "string", description: "X Ads account ID", required: false }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${name === "pause" ? "pausing" : "resuming"} ad groups.
+
+Example:
+  baker ads x line-items ${name} wiee9,wo2sr`
+    },
+    args: {
+      ids: { type: "positional", description: "Ad group 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: "lineItem.update",
+          accountId,
+          target: id,
+          payload: { entityStatus: status }
+        }))
+      );
+    }
+  });
+}
+var lineItemsPauseCommand = statusCommand("pause", "PAUSED");
+var lineItemsResumeCommand = statusCommand("resume", "ACTIVE");
+export {
+  lineItemsCreateCommand,
+  lineItemsPauseCommand,
+  lineItemsResumeCommand,
+  lineItemsUpdateCommand
+};
+//# sourceMappingURL=line-item-writes-V7UWLP7J.js.map

package/dist/line-items-PPHV3QBI.js

@@ -0,0 +1,107 @@
+import {
+  xMicrosHints
+} from "./chunk-MKAYMOZY.js";
+import {
+  runListCommand
+} from "./chunk-TLQOMWLQ.js";
+import "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-7NF73SCB.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/line-items.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.lineItems",
+  description: "List line items (ad groups) for an X Ads account. Returns bid, product_type, objective, placements, schedule. Filter by campaign-ids or line-item-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", 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 lineItemsListCommand = defineCommand({
+  meta: {
+    name: "line-items",
+    description: `List X Ads line items (ad groups).
+
+Examples:
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x line-items --account-id 18ce53xyz --with-deleted`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", 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 = `line-items:${accountId}:${today}:${args["campaign-ids"] ?? ""}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    await runListCommand({
+      path: "/api/ads/x/line-items",
+      cacheCategory: "x-account-data",
+      cacheKey,
+      cacheTtlMs: 60 * 60 * 1e3,
+      params: {
+        "account-id": accountId,
+        "campaign-ids": args["campaign-ids"],
+        "line-item-ids": args["line-item-ids"],
+        "with-deleted": args["with-deleted"] ? "true" : void 0
+      },
+      format: args.output || "json",
+      accountId,
+      useCache,
+      hintsFor: xMicrosHints
+    });
+  }
+});
+var lineItemsCommand = defineCommand({
+  meta: {
+    name: "line-items",
+    description: `X Ads ad groups (X calls them line items) \u2014 read them, or stage a change that applies when the chat is published.
+
+Objective, product type and parent campaign are fixed at create: X refuses to
+change any of them afterwards.
+
+Examples:
+  baker ads x line-items
+  baker ads x line-items create --campaign-id oilf0 --name "Spain" --objective WEBSITE_CLICKS
+  baker ads x line-items update wiee9 --bid 1.50
+  baker ads x line-items pause wiee9`
+  },
+  subCommands: {
+    list: lineItemsListCommand,
+    create: () => import("./line-item-writes-V7UWLP7J.js").then((m) => m.lineItemsCreateCommand),
+    update: () => import("./line-item-writes-V7UWLP7J.js").then((m) => m.lineItemsUpdateCommand),
+    pause: () => import("./line-item-writes-V7UWLP7J.js").then((m) => m.lineItemsPauseCommand),
+    resume: () => import("./line-item-writes-V7UWLP7J.js").then((m) => m.lineItemsResumeCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs" },
+    "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 {
+  lineItemsCommand
+};
+//# sourceMappingURL=line-items-PPHV3QBI.js.map

package/dist/link-RUUSSNGZ.js

@@ -0,0 +1,65 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-GJ52W2U2.js";
+import "./chunk-7D7YRHN3.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-HNNCAJNF.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/link.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.link",
+  description: "Stage a 'blocker -> blocked' dependency. Refs can be either action IDs or tempIds from create ops in the same draft.",
+  args: {
+    blocker: { type: "string", description: "Blocker action ID or tempId", required: true },
+    blocked: { type: "string", description: "Blocked action ID or tempId", required: true }
+  }
+});
+var linkCommand = defineCommand({
+  meta: {
+    name: "link",
+    description: "Stage a dependency link. Example: baker actions link --blocker <id> --blocked <id>"
+  },
+  args: {
+    blocker: { type: "string", description: "Blocker ref", required: false },
+    blocked: { type: "string", description: "Blocked ref", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const blocker = args.blocker;
+      const blocked = args.blocked;
+      if (!blocker || !blocked) {
+        failValidation("--blocker and --blocked are required.");
+      }
+      const chatId = requireChatId();
+      await apiPost("/api/actions/link", {
+        chatId,
+        blockerRef: blocker,
+        blockedRef: blocked
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  linkCommand
+};
+//# sourceMappingURL=link-RUUSSNGZ.js.map