@koda-sl/baker-cli 0.502.0 → 0.504.0

package/dist/targeting-constants-236ES5HE.js

@@ -0,0 +1,118 @@
+import {
+  runListCommand
+} from "./chunk-TLQOMWLQ.js";
+import "./chunk-FIN4ZXGJ.js";
+import {
+  writeAdsJson
+} from "./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/targeting-constants.ts
+import { defineCommand } from "citty";
+var ALLOWED_CONSTANTS = [
+  "locations",
+  "interests",
+  "events",
+  "platforms",
+  "platform_versions",
+  "devices",
+  "app_store_categories",
+  "network_operators",
+  "tv_markets",
+  "tv_shows"
+];
+registerSchema({
+  command: "ads.x.targetingConstants",
+  description: "Lookup X Ads targeting constants (locations, interests, events, platforms, devices, etc.). Cached 7 days. For locations: --q to filter by name, --country-code to scope. For tv_shows: --locale is required \u2014 take one from --constant tv_markets.",
+  args: {
+    constant: {
+      type: "string",
+      description: `One of: ${ALLOWED_CONSTANTS.join(", ")}`,
+      required: true
+    },
+    q: { type: "string", description: "Search query (locations only)", required: false },
+    "country-code": { type: "string", description: "ISO country code filter", required: false },
+    "location-type": {
+      type: "string",
+      description: "COUNTRIES|REGIONS|CITIES|METROS|POSTAL_CODES \u2014 plural, X rejects the singular (locations only)",
+      required: false
+    },
+    locale: { type: "string", description: "Market locale, e.g. en-US (required for tv_shows)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var targetingConstantsCommand = defineCommand({
+  meta: {
+    name: "targeting-constants",
+    description: `Lookup X Ads targeting constants.
+
+Examples:
+  baker ads x targeting-constants --constant locations --q Madrid --country-code ES --location-type CITIES
+  baker ads x targeting-constants --constant interests
+  baker ads x targeting-constants --constant devices
+  baker ads x targeting-constants --constant tv_shows --locale en-US`
+  },
+  args: {
+    constant: { type: "string", description: "Targeting constant name", required: true },
+    q: { type: "string", description: "Search query", required: false },
+    "country-code": { type: "string", description: "Country filter", required: false },
+    "location-type": {
+      type: "string",
+      description: "COUNTRIES|REGIONS|CITIES|METROS|POSTAL_CODES (plural)",
+      required: false
+    },
+    locale: { type: "string", description: "Market locale, e.g. en-US (required for tv_shows)", 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 constant = args.constant;
+    if (!ALLOWED_CONSTANTS.includes(constant)) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_PARAMETER",
+          message: `Unsupported constant '${constant}'. Allowed: ${ALLOWED_CONSTANTS.join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    if (constant === "tv_shows" && !args.locale) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_PARAMETER",
+          message: "tv_shows requires --locale (for example en-US). Run `baker ads x targeting-constants --constant tv_markets` to see the available markets and their locales."
+        }
+      });
+      process.exit(1);
+    }
+    const useCache = !args["no-cache"];
+    const cacheKey = `targeting-constants:${constant}:${args.q ?? ""}:${args["country-code"] ?? ""}:${args["location-type"] ?? ""}:${args.locale ?? ""}`;
+    await runListCommand({
+      path: "/api/ads/x/targeting-constants",
+      cacheCategory: "x-targeting-constants",
+      cacheKey,
+      cacheTtlMs: 7 * 24 * 60 * 60 * 1e3,
+      params: {
+        constant,
+        q: args.q,
+        "country-code": args["country-code"],
+        "location-type": args["location-type"],
+        locale: args.locale
+      },
+      format: args.output || "json",
+      useCache
+    });
+  }
+});
+export {
+  targetingConstantsCommand
+};
+//# sourceMappingURL=targeting-constants-236ES5HE.js.map

package/dist/targeting-criteria-APNZ7DN3.js

@@ -0,0 +1,113 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-7NF73SCB.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  ApiError,
+  apiGet
+} from "./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/targeting-criteria.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.targetingCriteria",
+  description: "List targeting criteria attached to line items in an X Ads account. Returns targeting_type, targeting_value, name, operator_type per criterion. Filter by line-item-ids.",
+  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 },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var targetingCriteriaListCommand = defineCommand({
+  meta: {
+    name: "targeting-criteria",
+    description: `List targeting criteria attached to line items.
+
+Examples:
+  baker ads x targeting-criteria --account-id 18ce53xyz --line-item-ids abc`
+  },
+  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 },
+    "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 cacheKey = `targeting-criteria:${accountId}:${args["line-item-ids"] ?? ""}`;
+    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 (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/targeting-criteria", 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 targetingCriteriaCommand = defineCommand({
+  meta: {
+    name: "targeting-criteria",
+    description: `Targeting attached to ad groups \u2014 read it, or stage a change.
+
+X stores each criterion as its own entity, so one op targets one value. Look
+values up with \`baker ads x targeting-constants\` first.
+
+Examples:
+  baker ads x targeting-criteria --line-item-ids wiee9
+  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1
+  baker ads x targeting-criteria remove 1dmtken`
+  },
+  subCommands: {
+    list: targetingCriteriaListCommand,
+    create: () => import("./promoted-tweet-writes-7XGCGHPN.js").then((m) => m.targetingCriteriaCreateCommand),
+    remove: () => import("./promoted-tweet-writes-7XGCGHPN.js").then((m) => m.targetingCriteriaRemoveCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  default: "list"
+});
+export {
+  targetingCriteriaCommand
+};
+//# sourceMappingURL=targeting-criteria-APNZ7DN3.js.map

package/dist/targets-LNZBOK2B.js

@@ -0,0 +1,104 @@
+import {
+  chatBody,
+  failApi,
+  failValidation
+} from "./chunk-277FW25B.js";
+import "./chunk-ASRS37QE.js";
+import {
+  TRIGGER_KIND_IDS,
+  TRIGGER_TARGET_FIELD_IDS
+} from "./chunk-EXELLNQS.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/targets.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  trigger: {
+    type: "string",
+    description: "The trigger kind to point, e.g. task.claimed. `baker scheduled-agents triggers --trigger <kind>` lists its `pointAt` fields.",
+    required: true
+  },
+  field: {
+    type: "string",
+    description: `Which of its narrowings to list: ${TRIGGER_TARGET_FIELD_IDS.join(", ")}. Defaults to the kind's first.`,
+    required: false
+  },
+  search: { type: "string", description: "Only options whose name contains this.", required: false },
+  form: {
+    type: "string",
+    description: "With --field stepId: the Form (slug) whose steps to list.",
+    required: false
+  },
+  app: {
+    type: "string",
+    description: "With --trigger app.event and --field appEvent or account: the connected tool (slug) to list for.",
+    required: false
+  },
+  event: {
+    type: "string",
+    description: "With --field appEvent --app <tool>: describe ONE event whole \u2014 every setting (description, default, examples) and every field it sends. Read it before narrowing.",
+    required: false
+  }
+};
+registerSchema({
+  command: "scheduled-agents.targets",
+  description: "What a trigger can be pointed at: the open Tasks, the company's scheduled agents, its review sources, followed competitors, pages, Forms and their steps, Knowledge collections, tools. Returns each option's value (pass it to the matching flag on create/update) with its name.",
+  args: ARGS
+});
+var targetsCommand = defineCommand({
+  meta: {
+    name: "targets",
+    description: `What a trigger can be pointed at \u2014 so "when a Task is picked up" becomes "when THIS Task is picked up".
+
+Each trigger's narrowings (\`pointAt\` in \`triggers\`) are chosen from a list, the same list the user's picker shows. Pass an option's \`value\` to the flag the response names; leave the flag off to run on any.
+
+Examples:
+  baker scheduled-agents targets --trigger task.claimed --field taskId --search hero
+  baker scheduled-agents targets --trigger session.published --field agentId
+  baker scheduled-agents targets --trigger flow.step.submitted --field stepId --form quote
+  baker scheduled-agents targets --trigger advertiser.new_ads
+  baker scheduled-agents targets --trigger app.event --field toolkit
+  baker scheduled-agents targets --trigger app.event --field appEvent --app gmail
+  baker scheduled-agents targets --trigger app.event --field appEvent --app gmail --event GMAIL_NEW_GMAIL_MESSAGE
+Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const trigger = args.trigger;
+    if (!TRIGGER_KIND_IDS.some((kind) => kind === trigger)) {
+      failValidation(`--trigger must be one of: ${TRIGGER_KIND_IDS.join(", ")}.`);
+    }
+    try {
+      const response = await apiPost("/api/scheduled-agents/targets", {
+        trigger,
+        ...args.field ? { field: args.field } : {},
+        ...args.search ? { search: args.search } : {},
+        ...args.form ? { flowId: args.form } : {},
+        ...args.app ? { toolkit: args.app } : {},
+        ...args.event ? { event: args.event } : {},
+        ...chatBody()
+      });
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  targetsCommand
+};
+//# sourceMappingURL=targets-LNZBOK2B.js.map

package/dist/testimonials-Y6RADYJ5.js

@@ -0,0 +1,32 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/index.ts
+import { defineCommand } from "citty";
+var testimonialsCommand = defineCommand({
+  meta: {
+    name: "testimonials",
+    description: `Find and browse testimonials in Baker, and manage the review pages they come from. Subcommands: search, get, list, delete, tags, sources.
+
+Examples:
+  baker testimonials search "great customer service" --limit 5
+  baker testimonials search "value for money" --rating-min 4
+  baker testimonials get <testimonial-id>
+  baker testimonials list --source google --sentiment positive
+  baker testimonials delete <testimonial-id> --dry-run
+  baker testimonials tags
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+Full guide: __tooling__/docs/tools/baker/testimonials.md`
+  },
+  subCommands: {
+    get: () => import("./get-OB3UGRPN.js").then((m) => m.getCommand),
+    search: () => import("./search-VCRWREOU.js").then((m) => m.searchCommand),
+    list: () => import("./list-4SAXAQCN.js").then((m) => m.listCommand),
+    delete: () => import("./delete-4XHBC4UR.js").then((m) => m.deleteCommand),
+    tags: () => import("./tags-WRUUTQCJ.js").then((m) => m.tagsCommand),
+    sources: () => import("./sources-ZJ7EZ6TJ.js").then((m) => m.sourcesCommand)
+  }
+});
+export {
+  testimonialsCommand
+};
+//# sourceMappingURL=testimonials-Y6RADYJ5.js.map

package/dist/themes-7I6URZUW.js

@@ -0,0 +1,95 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-HGUYC5K6.js";
+import {
+  failWriteValidation,
+  listFlag,
+  requireCustomerId
+} from "./chunk-JOXNUKI7.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-KJZPCLQE.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-4GAEB6NK.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/themes.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" },
+  keywords: { type: "string", description: "Comma-separated keywords to place" },
+  "ad-groups": {
+    type: "string",
+    description: "Comma-separated existing ad group ids (or resource names) to sort them into \u2014 read them with `ad-groups list`"
+  }
+};
+registerSchema({
+  command: "ads.google.keywords.themes",
+  description: "Which existing ad group each keyword belongs in, by Google's reading of the ad groups' themes (Keyword Planner GenerateAdGroupThemes). Start here: `baker ads google keywords themes --customer-id 1234567890 --keywords \"solar panels,heat pumps\" --ad-groups 111,222`. Returns suggestions (keyword \u2192 suggested keyword, match type, ad group) and unusable_ad_groups (ones Google could not read a theme from).",
+  args: Object.fromEntries(
+    Object.entries(ARGS).map(([name, arg]) => [
+      name,
+      { type: arg.type, description: arg.description, required: false }
+    ])
+  )
+});
+var themesCommand = defineCommand({
+  meta: {
+    name: "themes",
+    description: `Sort keywords into the existing ad groups whose theme fits them (Keyword Planner).
+
+Example:
+  baker ads google keywords themes --customer-id 1234567890 --keywords "solar panels,heat pumps" --ad-groups 111,222`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    const keywords = listFlag(args.keywords);
+    const adGroups = listFlag(args["ad-groups"]);
+    if (!keywords?.length || !adGroups?.length) failWriteValidation("pass --keywords and --ad-groups");
+    const managerId = getManagerIdForCustomer(customerId);
+    try {
+      const { data } = await apiPost(
+        "/api/ads/google/keywords/themes",
+        {
+          customerId,
+          ...managerId ? { managerId } : {},
+          keywords,
+          adGroups
+        }
+      );
+      const hints = data.unusable_ad_groups.length > 0 ? [
+        `${data.unusable_ad_groups.length} ad group(s) gave Google no theme to match against (removed, empty or under a removed campaign) \u2014 they received no keywords.`
+      ] : [];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+export {
+  themesCommand
+};
+//# sourceMappingURL=themes-7I6URZUW.js.map

package/dist/top-companies-HZQTHV2H.js

@@ -0,0 +1,109 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-CLUJWAQE.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-EXELLNQS.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/top-companies.ts
+import { defineCommand } from "citty";
+var COMPANIES_HINT = "For whole-account reach over months (one row per company, --by month|campaign, --with-domains), use `baker ads linkedin companies`.";
+var topCompaniesCommand = defineCommand({
+  meta: {
+    name: "top-companies",
+    description: `Top companies whose employees saw / clicked / converted on a campaign.
+
+Wrapper for: analytics --pivot company. Returns rows sorted by impressions desc.
+Each row's pivot[] contains { urn, id, name } \u2014 org names are resolved automatically.
+Cross-reference names against your target account list to spot audience leakage.
+
+Demographic data is delayed 12-24h with a \u22653-event privacy floor.
+
+Examples:
+  baker ads linkedin top-companies --campaign-id 1234 --last-days 30
+  baker ads linkedin top-companies --campaign-id 1,2,3 --intent revenue --last-days 90 --top-n 50
+  baker ads linkedin top-companies --campaign-id 1234 --output csv`
+  },
+  args: {
+    "campaign-id": { type: "string", description: "Comma-separated campaign IDs (required)" },
+    intent: { type: "string", description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)" },
+    "top-n": { type: "string", description: "Top rows by impressions (default: 25)" },
+    start: { type: "string", description: "Start date YYYY-MM-DD" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const campaignIdsRaw = args["campaign-id"];
+    const invalid = !campaignIdsRaw ? "--campaign-id is required: one campaign id, or several comma-separated. For every company the whole ad account reached, use `baker ads linkedin companies`." : outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
+    if (invalid !== null || !campaignIdsRaw) {
+      writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: invalid ?? "" } });
+      process.exit(1);
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const intent = args.intent ?? "baseline";
+    const topN = args["top-n"] ? Number(args["top-n"]) : 25;
+    const start = args.start ?? daysAgoIso(args["last-days"] ? Number(args["last-days"]) : 30);
+    const end = args.end ?? todayIso();
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request: {
+          level: "campaign",
+          ids,
+          intent,
+          pivot: "company",
+          start,
+          end,
+          granularity: "ALL",
+          limit: 500
+        },
+        skipCache: Boolean(args["no-cache"])
+      });
+      const top = [...data.rows].sort((a, b) => Number(b.impressions ?? 0) - Number(a.impressions ?? 0)).slice(0, topN);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(top, fmt, data.fields, [COMPANIES_HINT]);
+        return;
+      }
+      writeJsonEnvelope({
+        ok: true,
+        data: {
+          query: { campaigns: ids, start, end, intent, topN },
+          rows: top,
+          warnings: data.warnings
+        },
+        hints: [COMPANIES_HINT]
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  topCompaniesCommand
+};
+//# sourceMappingURL=top-companies-HZQTHV2H.js.map