@koda-sl/baker-cli 0.491.0 → 0.493.0

package/dist/output-GWIP6ROX.js

@@ -1,24 +0,0 @@
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  resolveCustomerId,
-  toCsvRow,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-SWL4AAPP.js";
-import "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-export {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  resolveCustomerId,
-  toCsvRow,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-};
-//# sourceMappingURL=output-GWIP6ROX.js.map

package/dist/page-YWGBCN65.js

@@ -1,105 +0,0 @@
-import {
-  INSPIRATION_HINTS,
-  reportError,
-  staleCopyHint
-} from "./chunk-IN4G7X6W.js";
-import {
-  apiGet
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/landing/inspiration/page.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "landing.inspiration.page",
-  description: "Show a whole reference page as a sequence: every section top to bottom with its type and the idea behind it. This is the view to use when the question is how a good page is ORDERED rather than what one section looks like.",
-  args: {
-    id: {
-      type: "string",
-      description: "Page id \u2014 the `page_id` on any search result or favorites row",
-      required: true
-    },
-    full: {
-      type: "boolean",
-      description: "Add the transferable idea behind every section. A long page roughly triples the response",
-      required: false
-    }
-  }
-});
-var pageCommand = defineCommand({
-  meta: {
-    name: "page",
-    description: "Show how a reference page sequences its sections. Example: baker landing inspiration page j91xyz\u2026 \u2014 the blueprint, not the pixels."
-  },
-  args: {
-    id: { type: "positional", description: "Page id (the `page_id` on a search result)", required: true },
-    full: { type: "boolean", description: "Include why_it_works per section", required: false, default: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const data = await apiGet("/api/landing-inspiration/page", { id: args.id });
-      if (data.status !== "indexed") {
-        writeJson({
-          ok: true,
-          data: { id: data.id, url: data.url, status: data.status, sections: [] },
-          hints: [
-            data.status === "error" ? "We couldn't read this page. Try a different address, or a different page on the same site." : "Still being studied \u2014 check back later in the turn or in a later one."
-          ]
-        });
-        return;
-      }
-      const full = args.full;
-      writeJson({
-        ok: true,
-        data: {
-          id: data.id,
-          url: data.url,
-          domain: data.domain,
-          title: data.title,
-          archetype: data.archetype,
-          stack: data.detectedStack,
-          page_fidelity: data.pageFidelity,
-          read_at: data.studiedAt ? new Date(data.studiedAt).toISOString().slice(0, 10) : null,
-          ...data.refreshFailedAt ? { refresh_failed_at: new Date(data.refreshFailedAt).toISOString().slice(0, 10) } : {},
-          blueprint: data.sectionOrder,
-          sections: data.sections.map((section) => ({
-            id: section.id,
-            position: section.index,
-            section: section.sectionType,
-            composition: section.composition,
-            look: section.visualRegister,
-            motion: section.motionSummary,
-            craft: section.craftScore,
-            // Behind --full. This command exists to answer an ordering
-            // question, and `blueprint` answers it in a line; a 600-character
-            // paragraph per section turned a 40-section page into ~5,900 tokens
-            // of material about individual sections nobody had chosen yet.
-            ...full ? { why_it_works: section.whyItWorks } : {}
-          }))
-        },
-        hints: [
-          "The blueprint is the section order top to bottom \u2014 the answer to 'how do good pages in this category sequence themselves'.",
-          "Use `baker landing inspiration view <section id>` for any section worth a closer look.",
-          ...full ? [] : ["Add --full for the idea behind every section, once you know which page you care about."],
-          INSPIRATION_HINTS.adapt,
-          ...[staleCopyHint(data.studiedAt, data.filedUrl)].filter((hint) => hint !== null),
-          ...data.refreshFailedAt ? [
-            "The last attempt to read this page again failed, so this is the earlier copy. Tell the user if the live page may differ."
-          ] : []
-        ]
-      });
-    } catch (error) {
-      reportError(error);
-    }
-  }
-});
-export {
-  pageCommand
-};
-//# sourceMappingURL=page-YWGBCN65.js.map

package/dist/page-photos-CXRG4AXV.js

@@ -1,115 +0,0 @@
-import {
-  bareAccountId,
-  failWriteValidation,
-  requireTarget,
-  stageOp
-} from "./chunk-5C35OW7L.js";
-import "./chunk-A4MVVPJ2.js";
-import "./chunk-HLVRHBKL.js";
-import "./chunk-QTOZ32SU.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-SFJW2KED.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-FNA277HP.js";
-import "./chunk-SWL4AAPP.js";
-import "./chunk-5WMTPYKT.js";
-import "./chunk-23H4ZJRP.js";
-import "./chunk-DWX44QL6.js";
-import "./chunk-2FSEESJU.js";
-import "./chunk-CVBKW75S.js";
-import "./chunk-BLAHHMPF.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/page-photos.ts
-import { defineCommand } from "citty";
-var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
-registerSchema({
-  command: "ads.meta.page-photos.upload",
-  description: "Stage a photo upload to a Facebook Page, NOT posted to its timeline, made at publish \u2014 for Instant Experience photo elements (`instant-experiences create --photo-id <ref>`). Needs the Page posts permission for Meta.",
-  args: {
-    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
-    "page-id": { type: "string", description: "The Facebook Page", required: true },
-    "image-id": { type: "string", description: "Baker library image id", required: false },
-    url: { type: "string", description: "Or a public https picture address", required: false },
-    caption: { type: "string", description: "Caption kept with the photo (never posted)", required: false }
-  }
-});
-var uploadCommand = defineCommand({
-  meta: {
-    name: "upload",
-    description: `Put a photo on a Facebook Page without posting it. ${STAGED_NOTE}
-Example: baker ads meta page-photos upload --account-id act_123 --page-id 904238019441800 --image-id <library image id>
-Then: baker ads meta instant-experiences create --page-id 904238019441800 --photo-id meta_temp_\u2026 \u2026`
-  },
-  args: {
-    "account-id": { type: "string", description: "Numeric account ID or act_N" },
-    "page-id": { type: "string", description: "The Facebook Page \u2014 from `baker ads meta pages`" },
-    "image-id": { type: "string", description: "Baker library image id (`baker images library \u2026`)" },
-    url: { type: "string", description: "Or a public https picture address Meta can fetch" },
-    caption: { type: "string", description: "Caption kept with the photo; it is never posted" }
-  },
-  run: async ({ args }) => {
-    if (!args["image-id"] && !args.url) failWriteValidation("pass --image-id (a library image) or --url");
-    await stageOp(
-      {
-        kind: "pagePhoto.create",
-        accountId: bareAccountId(args),
-        payload: {
-          page_id: args["page-id"],
-          bakerImageId: args["image-id"],
-          url: args.url,
-          caption: args.caption
-        }
-      },
-      ["Use it in an Instant Experience with `instant-experiences create --photo-id <ref>`."]
-    );
-  }
-});
-registerSchema({
-  command: "ads.meta.page-photos.delete",
-  description: "Stage deleting a photo from a Facebook Page. An Instant Experience already made with it keeps it.",
-  args: {
-    id: { type: "positional", description: "Page photo id", required: true },
-    "account-id": { type: "string", description: "Ad account the change is staged under", required: false }
-  }
-});
-var deleteCommand = defineCommand({
-  meta: {
-    name: "delete",
-    description: `Delete a photo from its Facebook Page. ${STAGED_NOTE}
-Example: baker ads meta page-photos delete 122142489045161003 --account-id act_123`
-  },
-  args: {
-    id: { type: "positional", description: "Page photo id", required: true },
-    "account-id": { type: "string", description: "Numeric account ID or act_N" }
-  },
-  run: async ({ args }) => {
-    await stageOp({
-      kind: "pagePhoto.update",
-      accountId: bareAccountId(args),
-      target: requireTarget(args, "Page photo"),
-      payload: { status: "DELETED" }
-    });
-  }
-});
-var pagePhotosCommand = defineCommand({
-  meta: {
-    name: "page-photos",
-    description: `Photos on a Facebook Page that are never posted \u2014 for Instant Experiences and collection ads. Needs the Page posts permission for Meta.
-  baker ads meta page-photos upload --page-id <id> --image-id <library id>
-  baker ads meta page-photos delete <photo id>`
-  },
-  subCommands: { upload: uploadCommand, delete: deleteCommand }
-});
-export {
-  pagePhotosCommand
-};
-//# sourceMappingURL=page-photos-CXRG4AXV.js.map

package/dist/pages-PTWRXAZT.js

@@ -1,66 +0,0 @@
-import {
-  csvOrJson,
-  handleMetaError
-} from "./chunk-QTOZ32SU.js";
-import {
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-SWL4AAPP.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-K3TNTBZJ.js";
-import {
-  apiGet
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/pages.ts
-import { defineCommand } from "citty";
-function pageSelectionHints(data) {
-  if (data.length === 0) return [];
-  const accountHint = "Use a Page only with an ad account listed in its promotingAccountIds. hasPageAccessToken must be true to read instant forms; null means Meta could not check it. Form reads also require the company's lead-ads permissions.";
-  if (data.length > 1) {
-    return [
-      accountHint,
-      "MULTIPLE Pages can run ads from the selected Meta ad accounts \u2014 do NOT guess. Confirm with the user which Page an ad should run from before passing --page to `creatives create`; a wrong Page publishes the ad under the wrong brand identity and staging will not catch it."
-    ];
-  }
-  return [accountHint];
-}
-var pagesCommand = defineCommand({
-  meta: {
-    name: "pages",
-    description: `List the Facebook Pages that the selected Meta ad accounts can promote, showing which accounts can promote each Page. Every Meta ad publishes from a Page, so match its promotingAccountIds to the target account. hasPageAccessToken shows whether the connected person can also read that Page's instant forms. If more than one Page is listed, confirm the brand with the user.
-
-Examples:
-  baker ads meta pages`
-  },
-  args: {
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "Output format", default: "json" }
-  },
-  run: async ({ args }) => {
-    try {
-      const params = {};
-      if (args["no-cache"]) params["skip-cache"] = "true";
-      const data = await apiGet("/api/ads/meta/pages", params);
-      const fmt = csvOrJson(args);
-      if (fmt !== "json") {
-        writeAdsOutput(data, fmt);
-        return;
-      }
-      const hints = pageSelectionHints(data);
-      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-export {
-  pageSelectionHints,
-  pagesCommand
-};
-//# sourceMappingURL=pages-PTWRXAZT.js.map

package/dist/performance-7NEZTOJ5.js

@@ -1,24 +0,0 @@
-import {
-  definitionInsights,
-  parseDays,
-  performanceCommand,
-  withDefinitions
-} from "./chunk-MRQHJW5U.js";
-import "./chunk-GBFL4TD2.js";
-import "./chunk-DAO63OOP.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-WTJSMYY2.js";
-import "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-export {
-  definitionInsights,
-  parseDays,
-  performanceCommand,
-  withDefinitions
-};
-//# sourceMappingURL=performance-7NEZTOJ5.js.map

package/dist/pinterest-J442QLQS.js

@@ -1,96 +0,0 @@
-import {
-  AUTO_INGEST_MAX,
-  parseAutoIngest
-} from "./chunk-KKJ4KJCW.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/images/pinterest.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "images.pinterest",
-  description: "Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing \u2014 Pinterest is unverified, trademark-bearing web content.",
-  args: {
-    query: { type: "string", description: "Search query", required: true },
-    limit: { type: "number", description: "Max results (1-20, default 5)", required: false, default: 5 },
-    "auto-ingest": {
-      type: "number",
-      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}, default 0) and return Baker-owned URLs on ingested hits`,
-      required: false,
-      default: 0
-    },
-    context: {
-      type: "string",
-      description: "Free-text hint applied to every auto-ingested hit (overrides the pin title)",
-      required: false
-    }
-  }
-});
-var pinterestCommand = defineCommand({
-  meta: {
-    name: "pinterest",
-    description: "Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery \u2014 lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. \u26A0 Unverified, trademark-bearing web content \u2014 inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\n\nExamples:\n  baker images pinterest 'scandinavian living room'\n  baker images pinterest 'minimalist skincare product photography' --limit 20\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'"
-  },
-  args: {
-    query: { type: "positional", description: "Search query", required: false },
-    limit: { type: "string", description: "Max results (1-20)", required: false },
-    "auto-ingest": {
-      type: "string",
-      description: `Auto-ingest top N (0-${AUTO_INGEST_MAX.pinterest}) and return Baker-owned URLs on ingested hits`,
-      required: false
-    },
-    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const query = args.query;
-      if (!query) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
-        process.exit(1);
-      }
-      const body = { query };
-      if (args.limit) body.limit = Number(args.limit);
-      if (args["auto-ingest"] !== void 0) {
-        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.pinterest);
-        if (!parsed.ok) {
-          writeJson({
-            ok: false,
-            error: {
-              code: "VALIDATION_ERROR",
-              message: parsed.message,
-              fix: {
-                action: "retry_with_changes",
-                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.pinterest}.`
-              }
-            }
-          });
-          process.exit(1);
-        }
-        body.autoIngest = parsed.value;
-      }
-      if (args.context) body.descriptionContext = args.context;
-      const data = await apiPost("/api/images/pinterest", body);
-      writeJson({ ok: true, data });
-    } catch (err) {
-      if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
-        process.exit(1);
-      }
-      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
-  }
-});
-export {
-  pinterestCommand
-};
-//# sourceMappingURL=pinterest-J442QLQS.js.map

package/dist/pixels-MYT3TCHZ.js

@@ -1,60 +0,0 @@
-import {
-  schemaArgs,
-  stageChatgptOp
-} from "./chunk-AQM4JH62.js";
-import {
-  CHATGPT_ADS_REFERENCE
-} from "./chunk-IG627WWY.js";
-import "./chunk-SWL4AAPP.js";
-import "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.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-MYT3TCHZ.js.map

package/dist/pixels-ZZCQUS3J.js

@@ -1,108 +0,0 @@
-import {
-  csvOrJson,
-  daysAgoIso,
-  handleMetaError,
-  resolveAccountIdArg,
-  todayIso
-} from "./chunk-QTOZ32SU.js";
-import {
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-SWL4AAPP.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-K3TNTBZJ.js";
-import {
-  apiGet
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/meta/pixels.ts
-import { defineCommand } from "citty";
-var pixelsCommand = defineCommand({
-  meta: {
-    name: "pixels",
-    description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
-
-Examples:
-  baker ads meta pixels --account-id act_123
-  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`
-  },
-  args: {
-    "account-id": { type: "string", description: "Meta ad account ID" },
-    "pixel-id": { type: "string", description: "Pixel ID for --stats" },
-    stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
-    aggregation: {
-      type: "string",
-      description: "stats aggregation: event|browser_type|host|pixel_fire",
-      default: "event"
-    },
-    days: { type: "string", description: "Lookback days for --stats (default 7)" },
-    "no-cache": NO_CACHE_ARG,
-    output: { type: "string", description: "Output format", default: "json" }
-  },
-  run: async ({ args }) => {
-    try {
-      if (args.stats) {
-        await runStats(args);
-        return;
-      }
-      await runList(args);
-    } catch (err) {
-      handleMetaError(err);
-    }
-  }
-});
-async function runStats(args) {
-  const pixelId = args["pixel-id"];
-  if (!pixelId) {
-    handleMetaError(new Error("--pixel-id is required when --stats is set"));
-  }
-  const days = args.days ? Number(args.days) : 7;
-  if (!Number.isInteger(days) || days <= 0 || days > 90) {
-    handleMetaError(new Error("--days must be a positive integer \u2264 90"));
-  }
-  const params = {
-    "pixel-id": pixelId,
-    aggregation: args.aggregation ?? "event",
-    "start-time": daysAgoIso(days),
-    "end-time": todayIso()
-  };
-  if (args["no-cache"]) params["skip-cache"] = "true";
-  const data = await apiGet("/api/ads/meta/pixel-stats", params);
-  emit(data, args);
-}
-async function runList(args) {
-  const accountId = resolveAccountIdArg(args);
-  const params = { "account-id": accountId };
-  if (args["no-cache"]) params["skip-cache"] = "true";
-  const { pixels, restrictedFields } = await apiGet("/api/ads/meta/pixels", params);
-  emit(pixels, args, pixelWarnings(restrictedFields));
-}
-function pixelWarnings(restrictedFields) {
-  if (restrictedFields.length === 0) {
-    return [];
-  }
-  return [
-    {
-      code: "PIXEL_FIELDS_RESTRICTED",
-      message: `Meta withheld ${restrictedFields.join(", ")} for these pixels \u2014 the connected user holds no role in the Business that owns them. IDs, names, creation and last-fired times are complete; install code and setup details are not. To get them, the client assigns the pixel to the connected user in Meta Business settings \u2192 Data sources \u2192 Datasets.`
-    }
-  ];
-}
-function emit(data, args, warnings = []) {
-  const fmt = csvOrJson(args);
-  if (fmt !== "json") {
-    writeAdsOutput(data, fmt);
-    return;
-  }
-  writeAdsJson({ ok: true, data, ...warnings.length > 0 ? { warnings } : {} });
-}
-export {
-  pixelWarnings,
-  pixelsCommand
-};
-//# sourceMappingURL=pixels-ZZCQUS3J.js.map