@koda-sl/baker-cli 0.568.0 → 0.569.0-dev.1b455b3fe

package/dist/creatives-4G2V4J6N.js

@@ -1,229 +0,0 @@
-import {
-  csvOrJson,
-  handleLinkedinError,
-  resolveAccountIdArg,
-  resolveStatusFilter,
-  statusesArgDescription
-} from "./chunk-CI3QSB6G.js";
-import {
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-RBCO3C3Q.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-GO6ISZUZ.js";
-import {
-  shapeListRows
-} from "./chunk-65Y3RCWP.js";
-import "./chunk-2Q7K4F4H.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-XHWHBGKX.js";
-import {
-  apiGet
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/linkedin/creatives.ts
-import { defineCommand } from "citty";
-function asRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
-}
-function asString(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function creativeDestination(content) {
-  if (!content) return { format: "unknown" };
-  const reference = asString(content.reference);
-  if (reference) return { format: "post", postUrn: reference };
-  const textAd = asRecord(content.textAd);
-  if (textAd) return { format: "text", landingUrl: asString(textAd.landingPage) };
-  const spotlight = asRecord(content.spotlight);
-  if (spotlight) return { format: "spotlight", landingUrl: asString(spotlight.landingPage) };
-  if (asRecord(content.follower)) return { format: "follower" };
-  if (asRecord(content.jobs)) return { format: "jobs" };
-  return { format: "unknown" };
-}
-var COMPACT_COLUMNS = [
-  "id",
-  "urn",
-  "campaign",
-  "intendedStatus",
-  "isServing",
-  "reviewStatus",
-  "format",
-  "landingUrl",
-  "postUrn",
-  "leadForm",
-  "leadFormButton"
-];
-function leadFormUrn(destination) {
-  const id = destination?.match(/(\d+)$/)?.[1];
-  return id ? `urn:li:leadGenForm:${id}` : void 0;
-}
-function compactRow(row) {
-  const destination = creativeDestination(row.content);
-  const leadForm = leadFormUrn(row.leadgenCallToAction?.destination);
-  return {
-    id: row.id,
-    urn: row.urn,
-    campaign: row.campaign,
-    intendedStatus: row.intendedStatus,
-    isServing: row.isServing,
-    reviewStatus: row.reviewStatus,
-    format: destination.format,
-    ...destination.landingUrl ? { landingUrl: destination.landingUrl } : {},
-    ...destination.postUrn ? { postUrn: destination.postUrn } : {},
-    ...leadForm ? { leadForm, leadFormButton: row.leadgenCallToAction?.label } : {}
-  };
-}
-function unmappedShapeWarnings(rows, rawContentReturned) {
-  const unmapped = rows.filter((row) => row.content && creativeDestination(row.content).format === "unknown");
-  if (unmapped.length === 0) return [];
-  const remedy = rawContentReturned ? "Their raw content is in this response \u2014 read it directly; this command cannot resolve a destination for them." : "Re-read those with --full before drawing any conclusion about where they point.";
-  return [
-    {
-      code: "UNMAPPED_CREATIVE_CONTENT",
-      message: `${unmapped.length} of ${rows.length} creatives have a content shape this command can't read, so their destination is missing (ids: ${unmapped.slice(0, 5).map((row) => row.id).join(", ")}). ${remedy}`
-    }
-  ];
-}
-var listArgs = {
-  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
-  "account-urn": { type: "string", description: "Alias for --account-id" },
-  "campaign-id": { type: "string", description: "Filter by campaign ID" },
-  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: statusesArgDescription("creatives") },
-  fields: {
-    type: "string",
-    description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage"
-  },
-  full: { type: "boolean", description: "Return the complete raw records, including the opaque 'content' block" },
-  limit: { type: "string", description: "Max rows (default: 500)" },
-  "no-cache": NO_CACHE_ARG,
-  output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
-};
-var creativesListCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "List LinkedIn creatives (ads). Runs by default when no subcommand is given."
-  },
-  args: listArgs,
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args, "creatives");
-      if (statuses) params.statuses = statuses.join(",");
-      if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
-      if (args.limit) params.limit = String(args.limit);
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/linkedin/creatives", params);
-      const shaped = shapeListRows(data, args, {
-        row: compactRow,
-        columns: COMPACT_COLUMNS
-      });
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(shaped.rows, fmt, shaped.fields, shaped.hints);
-        return;
-      }
-      const warnings = unmappedShapeWarnings(data, args.full === true);
-      writeJsonEnvelope({
-        ok: true,
-        data: shaped.rows,
-        ...warnings.length > 0 ? { warnings } : {},
-        ...shaped.hints ? { hints: shaped.hints } : {}
-      });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-var creativesGetCommand = defineCommand({
-  meta: {
-    name: "get",
-    description: `Read one ad as LinkedIn holds it: headline, intro text, landing URL, the lead gen form it opens, its review verdict (with rejection reasons) and why it is not serving (notServingBecause \u2014 e.g. FORM_HOLD, UNDER_REVIEW, CAMPAIGN_STOPPED).
-The listing can only name a post-based ad's post; this is where its headline and link come back.
-Example: baker ads linkedin creatives get 1584704523`
-  },
-  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" }
-  },
-  run: async ({ args }) => {
-    const accountId = resolveAccountIdArg(args);
-    try {
-      const data = await apiGet("/api/ads/linkedin/creative", {
-        "account-id": accountId,
-        "creative-id": String(args.id)
-      });
-      writeJsonEnvelope({
-        ok: true,
-        data,
-        hints: [
-          `These are the stored fields, not what people see. To look at the ad as the feed shows it: baker ads linkedin preview ${String(args.id)} --account-id ${accountId}`
-        ]
-      });
-    } catch (err) {
-      handleLinkedinError(err);
-    }
-  }
-});
-var creativesCommand = defineCommand({
-  meta: {
-    name: "creatives",
-    description: `List LinkedIn creatives (ads), or stage writes (create/update/pause/resume/duplicate).
-
-Defaults to ACTIVE intended-status. Pass --all-statuses or --statuses ACTIVE,PAUSED to widen.
-
-Rows are compact by default: id, urn, campaign, status, review status, format, and
-the resolved destination (landingUrl, or postUrn for post-based ads), and for a
-lead gen ad the form it opens (leadForm, leadFormButton). Use --fields
-for specific dotted paths, or --full for the complete raw records.
-
-Post-based ads (image, video, carousel, document, article, event, TLA) report a
-postUrn, not a landingUrl \u2014 their destination lives in the post itself.
-Use 'reviewStatus' to spot rejected/pending creatives during an audit.
-
-Write subcommands stage ops on this chat's draft \u2014 media comes from the Baker
-library and is uploaded to LinkedIn only at publish.
-
-Examples:
-  baker ads linkedin creatives --account-id 503001492
-  baker ads linkedin creatives --account-id 503001492 --fields id,intendedStatus,content.textAd.landingPage
-  baker ads linkedin creatives create --campaign 1234 --format image --image-id <bakerImageId> --intro "\u2026" --headline "Book a demo" --landing-url https://example.com --cta REQUEST_DEMO
-  baker ads linkedin creatives get 1584704523      # one ad: headline, landing URL, form, review, why not serving
-  baker ads linkedin creatives pause urn:li:sponsoredCreative:789`
-  },
-  subCommands: {
-    list: creativesListCommand,
-    get: creativesGetCommand,
-    create: () => import("./write-commands-VQPEHKH7.js").then((m) => m.creativesCreateCommand),
-    update: () => import("./write-commands-VQPEHKH7.js").then((m) => m.creativesUpdateCommand),
-    pause: () => import("./write-commands-VQPEHKH7.js").then((m) => m.creativesPauseCommand),
-    resume: () => import("./write-commands-VQPEHKH7.js").then((m) => m.creativesResumeCommand),
-    duplicate: () => import("./write-commands-VQPEHKH7.js").then((m) => m.creativesDuplicateCommand),
-    delete: () => import("./write-commands-VQPEHKH7.js").then((m) => m.creativesDeleteCommand)
-  },
-  // A parent must never declare `run`: citty falls through to it *after* running
-  // the matched subcommand, so every write would also trigger a full live list.
-  // `args` stays here so citty's subcommand scan knows which flags take a value.
-  args: listArgs,
-  default: "list"
-});
-export {
-  compactRow,
-  creativeDestination,
-  creativesCommand,
-  unmappedShapeWarnings
-};
-//# sourceMappingURL=creatives-4G2V4J6N.js.map

package/dist/creatives-QWNQDPNE.js

@@ -1,58 +0,0 @@
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/creatives/index.ts
-import { defineCommand } from "citty";
-var creativesCommand = defineCommand({
-  meta: {
-    name: "creatives",
-    description: `Make ads from what customers said, read and record what the user thinks of each version, and save the approved ones.
-
-Making ads, in order:
-  baker creatives brief                 # one read: who sees the ads, what works, taste, customer quotes, ideas on file
-  baker creatives ideas                 # check and rank the ideas in src/creatives/_ideas/
-  baker creatives make <idea>           # one idea \u2192 one creative (reference picked and checked for you)
-  baker creatives translate --slug <ad> --to es-MX,pt-BR   # the same ad in other languages, one design
-  baker creatives learn                 # what each idea's ads did, written back onto the idea
-
-Before making or changing a creative, read the company's taste:
-  baker creatives feedback [--slug <slug>]
-
-The company's standing rules for every ad (BRAND.md's and the ones a person taught):
-  baker creatives rules list
-  baker creatives rules add --candidate <rc-\u2026>   # only after the person agreed it is a rule for every ad
-  baker creatives check                 # after a rule changes: which ads already made break it
-
-When the user reacts to a version in the chat (likes it, rejects it, asks for changes), record it:
-  baker creatives feedback record --slug <slug> --run <r_\u2026> --verdict approved|rejected [--reasons a,b] [--note "<their words>"]
-
-When they pick a version (or options inside it) to keep:
-  baker creatives select --slug <slug> --run <r_\u2026> [--options <label,\u2026>]
-
-Creative handoff:
-  baker creatives publish --title "Spring Offer Static Ad" --slug <slug> --run-id <r_\u2026> [--output 4:5]
-  baker creatives publish ./canvas/run/final.mp4 --title "Spring Offer Reel" --slug spring-offer --run-id <r_\u2026>
-
-Publishing an image uploads it to the Company image library, applies the official creative tag, and returns an image reference for chat previews. Publishing a video uploads it to the video library, waits until it plays, saves it on the creative (--slug required) and returns a video reference.
-
-How published creatives are doing in live Meta ads (results, fatigue, angle; hook and hold rate for videos):
-  baker creatives performance [--slug <slug>] [--days 30] [--full]
-Full guide: __tooling__/docs/tools/baker/creatives.md`
-  },
-  subCommands: {
-    brief: () => import("./brief-A5XFT6VH.js").then((m) => m.briefCommand),
-    ideas: () => import("./ideas-TT24LJR5.js").then((m) => m.ideasCommand),
-    make: () => import("./make-4XUB6RSF.js").then((m) => m.makeCommand),
-    translate: () => import("./translate-IPTYPZF6.js").then((m) => m.translateCommand),
-    learn: () => import("./learn-XNN3DGDF.js").then((m) => m.learnCommand),
-    feedback: () => import("./feedback-2YJ24NV7.js").then((m) => m.feedbackCommand),
-    rules: () => import("./rules-4A25K2P7.js").then((m) => m.rulesCommand),
-    check: () => import("./check-FQYDJ5RS.js").then((m) => m.checkCommand),
-    select: () => import("./select-MZ2U7U5U.js").then((m) => m.selectCommand),
-    publish: () => import("./publish-MDVPC77V.js").then((m) => m.publishCommand),
-    performance: () => import("./performance-PU4NHFUE.js").then((m) => m.performanceCommand)
-  }
-});
-export {
-  creativesCommand
-};
-//# sourceMappingURL=creatives-QWNQDPNE.js.map

package/dist/creatives-SFPNXJ6Z.js

@@ -1,118 +0,0 @@
-import {
-  META_LIST_SHAPE_ARGS,
-  registerMetaListSchema,
-  shapeMetaListRows,
-  writeMetaListRows
-} from "./chunk-3E74OM2E.js";
-import {
-  csvOrJson,
-  handleMetaError,
-  resolveAccountIdArg
-} from "./chunk-5H6N36LS.js";
-import "./chunk-QALAJNBG.js";
-import "./chunk-RBCO3C3Q.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-GO6ISZUZ.js";
-import "./chunk-65Y3RCWP.js";
-import {
-  apiGet
-} from "./chunk-QEREDRZO.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/creatives.ts
-import { defineCommand } from "citty";
-var listArgs = {
-  "account-id": { type: "string", description: "Meta ad account ID (required if no --creative-id)" },
-  "creative-id": {
-    type: "string",
-    description: "One creative ID, or several comma-separated, read in one call: --creative-id 2394\u2026,2395\u2026"
-  },
-  "name-contains": {
-    type: "string",
-    description: "Only creatives whose name contains this text (any case), matched by Baker while it reads the account; --limit counts the matches. Start here to find a creative by name: --name-contains octubre"
-  },
-  limit: { type: "string", description: "Max rows (default 500)" },
-  "no-cache": NO_CACHE_ARG,
-  ...META_LIST_SHAPE_ARGS
-};
-registerMetaListSchema(
-  "creatives",
-  "List ad creatives, or read some by id, as a table by default: id, name, status, object_type, dynamic (the asset feed's optimization_type), body, title, description, link, cta, url_tags, image_hash, video_id, page_id, instagram_user_id, effective_object_story_id. Copy and assets are read from wherever the creative keeps them (top level, object_story_spec, its carousel cards or asset_feed_spec); a dynamic creative's variants and a carousel's cards come back as lists. Per-placement rules and enhancement toggles are --fields (asset_feed_spec.asset_customization_rules, degrees_of_freedom_spec) or --full. Start here: baker ads meta creatives --creative-id 2394\u2026,2395\u2026 --output json.",
-  listArgs
-);
-async function readCreatives(ids, skipCache) {
-  const rows = [];
-  for (const id of ids) {
-    rows.push(
-      await apiGet("/api/ads/meta/creatives", {
-        "creative-id": id,
-        ...skipCache ? { "skip-cache": "true" } : {}
-      })
-    );
-  }
-  return rows;
-}
-var listCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "List ad creatives, or read some by ID. Runs by default when no subcommand is given. Example: baker ads meta creatives --creative-id 2394\u2026,2395\u2026"
-  },
-  args: listArgs,
-  run: async ({ args }) => {
-    try {
-      const ids = (args["creative-id"] ?? "").split(",").map((id) => id.trim()).filter(Boolean);
-      let data;
-      if (ids.length > 0) {
-        data = await readCreatives(ids, Boolean(args["no-cache"]));
-      } else {
-        const params = { "account-id": await resolveAccountIdArg(args) };
-        if (args["name-contains"]) params["name-contains"] = args["name-contains"];
-        if (args.limit) params.limit = args.limit;
-        if (args["no-cache"]) params["skip-cache"] = "true";
-        data = await apiGet("/api/ads/meta/creatives", params);
-      }
-      writeMetaListRows("creatives", shapeMetaListRows("creatives", data, args), csvOrJson(args));
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-var creativesCommand = defineCommand({
-  meta: {
-    name: "creatives",
-    description: `List ad creatives, fetch one by ID, or stage writes (create/update). Write subcommands stage ops on this chat's draft.
-
-Important: Meta creatives are effectively immutable once attached to an ad. Editing copy/image/CTA = create
-a new creative + repoint the ad (baker ads meta ads update <adId> --creative <ref>).
-
-Reads print a table by default: id, name, status, object_type, dynamic, body, title, description, link, cta,
-url_tags, image_hash, video_id, page_id, instagram_user_id, effective_object_story_id \u2014 read from wherever the
-creative keeps them; a dynamic creative's variants and a carousel's cards come back as lists. --fields (dotted paths) or --full for the rest.
-
-Examples:
-  baker ads meta creatives --account-id act_123 --name-contains octubre   \u2014 find creatives by name
-  baker ads meta creatives --creative-id 23842...,23843... --output json   # read several at once
-  baker ads meta creatives --creative-id 23842... --fields id,asset_feed_spec.asset_customization_rules --output json
-  baker ads meta creatives create --page 555 --message "Save now" --link https://x.com --image-hash abc\u2026 --cta SHOP_NOW`
-  },
-  subCommands: {
-    list: listCommand,
-    create: () => import("./write-commands-SIOVTRHH.js").then((m) => m.adCreativesCreateCommand),
-    update: () => import("./write-commands-SIOVTRHH.js").then((m) => m.adCreativesUpdateCommand),
-    delete: () => import("./asset-writes-7RFZZYU7.js").then((m) => m.creativesDeleteCommand)
-  },
-  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
-  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
-  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
-  // invocation — citty falls through to `run` after a subcommand, double-executing it.
-  args: listArgs,
-  default: "list"
-});
-export {
-  creativesCommand
-};
-//# sourceMappingURL=creatives-SFPNXJ6Z.js.map