@koda-sl/baker-cli 0.572.0 → 0.574.0

package/dist/landings-GRJAJKHY.js

@@ -0,0 +1,151 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-VRQ5HEVU.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  LANDING_ANALYSE_BATCH,
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/landings.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.landings",
+  description: "Every landing page one brand's ads send people to, the ones in use now first (a short or tracking link counts as the page it opens; Instant Forms, chats, app stores and social profiles are not pages): how many ads point there, how many still run, platforms, when each was used (`used`: one stretch per run of ads, `\u2192 now` while running), `address_only` on an address only Google search ads print (Google publishes no search ad's real destination, and the path need not exist \u2014 not analysed), and \u2014 once analysed \u2014 the page's headline, value propositions, offer, pricing, CTAs, proof, audience and sections in order. Compact by default; --full returns every field, the ads behind each page and its screenshot. --analyse studies the top pages not yet analysed (a few minutes each).",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "Every field of every page", required: false, default: false },
+    analyse: {
+      type: "boolean",
+      description: `Analyse the top ${LANDING_ANALYSE_BATCH} pages not analysed yet (or those named in --pages)`,
+      required: false,
+      default: false
+    },
+    pages: {
+      type: "string",
+      description: `With --analyse: comma list of page urls to analyse instead (max ${LANDING_ANALYSE_BATCH})`,
+      required: false
+    }
+  }
+});
+var COMPACT_PAGES = 20;
+var COMPACT_VALUE_PROPS = 3;
+var day = (iso) => iso.slice(0, 10);
+function compactPage(p) {
+  const pitch = p.analysis.pitch;
+  return {
+    url: p.canonical_url,
+    in_use_now: p.active_ads > 0,
+    ads: p.ads,
+    running: p.active_ads,
+    platforms: p.platforms,
+    used: p.windows.map((w) => `${day(w.from)} \u2192 ${w.to ? day(w.to) : "now"}`),
+    last_seen_at: p.last_seen_at,
+    ...p.address_only ? { address_only: true } : {},
+    analysis: p.analysis.status,
+    ...pitch ? {
+      headline: pitch.headline,
+      value_propositions: pitch.value_propositions.slice(0, COMPACT_VALUE_PROPS),
+      offer: pitch.offer
+    } : {}
+  };
+}
+function compactLandings(report) {
+  return {
+    advertiser_id: report.advertiser_id,
+    total_pages: report.total_pages,
+    analysed: report.pages.filter((p) => p.analysis.status === "ready").length,
+    pages: report.pages.slice(0, COMPACT_PAGES).map(compactPage)
+  };
+}
+function pagesToAnalyse(report) {
+  return report.pages.filter((p) => !p.address_only && (p.analysis.status === "not_analysed" || p.analysis.status === "failed")).slice(0, LANDING_ANALYSE_BATCH).map((p) => p.canonical_url);
+}
+function landingsHints(report, advertiser) {
+  const hints = [];
+  const top = report.pages.slice(0, COMPACT_PAGES);
+  const pending = top.filter((p) => !p.address_only && p.analysis.status === "not_analysed").length;
+  const addressOnly = report.pages.filter((p) => p.address_only).length;
+  const analysing = report.pages.filter((p) => p.analysis.status === "analysing").length;
+  if (report.pages.length === 0) {
+    hints.push("No ad of this brand links to a landing page yet.");
+    return hints;
+  }
+  if (addressOnly > 0) {
+    hints.push(
+      `${addressOnly} ${addressOnly === 1 ? "address" : "addresses"} only Google search ads show (\`address_only\`): Google publishes no search ad's destination, only the address printed on it, whose path the brand types freely and need not exist. Quote it as the address the ad shows, never as a page the ads lead to; it is not analysed.`
+    );
+  }
+  if (pending > 0) {
+    hints.push(
+      `${pending} of the top pages are not analysed yet: \`baker winning-ads landings ${advertiser} --analyse\` studies the top ${LANDING_ANALYSE_BATCH} (value propositions, offer, pricing, proof, sections). It takes a few minutes; run this again to read them.`
+    );
+  }
+  if (analysing > 0) {
+    hints.push(`${analysing} pages are being analysed now: run this again in a few minutes.`);
+  }
+  if (report.pages.some((p) => p.analysis.status === "ready")) {
+    hints.push(
+      "--full returns each analysed page's whole read: pricing, CTAs, proof, audience and its sections in order."
+    );
+  }
+  return hints;
+}
+var landingsCommand = defineCommand({
+  meta: {
+    name: "landings",
+    description: "Every landing page a brand's ads point to, with how the page sells once analysed. Start here: baker winning-ads landings adv_123 (--analyse to study the top pages not analysed yet, --full for everything)"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "Every field of every page", required: false, default: false },
+    analyse: {
+      type: "boolean",
+      description: `Analyse the top ${LANDING_ANALYSE_BATCH} pages not analysed yet`,
+      required: false,
+      default: false
+    },
+    pages: { type: "string", description: "With --analyse: comma list of page urls to analyse", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const advertiser = String(args.advertiser);
+      const params = { advertiser };
+      if (args.platform) params.platform = String(args.platform);
+      let report = await apiGet("/api/ad-library/landing-pages", params);
+      let started;
+      if (args.analyse) {
+        const named = args.pages ? splitList(String(args.pages)) : [];
+        const urls = named.length > 0 ? named.slice(0, LANDING_ANALYSE_BATCH) : pagesToAnalyse(report);
+        if (urls.length > 0) {
+          started = (await apiPost("/api/ad-library/landing-pages/analyse", { urls })).pages;
+          report = await apiGet("/api/ad-library/landing-pages", params);
+        }
+      }
+      writeJson({
+        ok: true,
+        data: { ...args.full ? report : compactLandings(report), ...started ? { analyse: started } : {} },
+        hints: landingsHints(report, advertiser)
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  compactLandings,
+  landingsCommand,
+  landingsHints,
+  pagesToAnalyse
+};
+//# sourceMappingURL=landings-GRJAJKHY.js.map

package/dist/languages-22VMY7JN.js

@@ -0,0 +1,55 @@
+import {
+  writeResearchJson
+} from "./chunk-7PKEBTVP.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.languages",
+  description: "List all supported language codes for --language flag in research commands.",
+  args: {}
+});
+var LANGUAGES = [
+  { code: "en", name: "english" },
+  { code: "es", name: "spanish" },
+  { code: "fr", name: "french" },
+  { code: "de", name: "german" },
+  { code: "it", name: "italian" },
+  { code: "pt", name: "portuguese" },
+  { code: "nl", name: "dutch" },
+  { code: "ja", name: "japanese" },
+  { code: "ko", name: "korean" },
+  { code: "zh", name: "chinese" },
+  { code: "ar", name: "arabic" },
+  { code: "ru", name: "russian" },
+  { code: "pl", name: "polish" },
+  { code: "tr", name: "turkish" },
+  { code: "sv", name: "swedish" },
+  { code: "no", name: "norwegian" },
+  { code: "da", name: "danish" },
+  { code: "fi", name: "finnish" }
+];
+var FIELDS = {
+  code: "Language code to pass as --language",
+  name: "Language name (also accepted by --language)"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language codes for --language flag."
+  },
+  run: () => {
+    writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-22VMY7JN.js.map

package/dist/languages-FMHPUVOL.js

@@ -0,0 +1,40 @@
+import {
+  GOOGLE_ADS_LANGUAGES
+} from "./chunk-IGCS3X4F.js";
+import "./chunk-BMMXYR7A.js";
+import {
+  writeAdsJson
+} from "./chunk-VJUVTMHY.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.languages",
+  description: "List all supported language IDs for --language flag in Google Ads keyword commands.",
+  args: {}
+});
+var FIELDS = {
+  id: "Language ID to pass as --language",
+  name: "Language name"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language IDs for --language flag."
+  },
+  run: () => {
+    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-FMHPUVOL.js.map

package/dist/launches-NUMSS7HP.js

@@ -0,0 +1,19 @@
+import {
+  IDEA_HINT,
+  compactLaunches,
+  launchesCommand,
+  launchesHints
+} from "./chunk-UDNN4POE.js";
+import "./chunk-VRQ5HEVU.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  IDEA_HINT,
+  compactLaunches,
+  launchesCommand,
+  launchesHints
+};
+//# sourceMappingURL=launches-NUMSS7HP.js.map

package/dist/layerize-TFRXRHVL.js

@@ -0,0 +1,190 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/layerize.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.layerize",
+  description: "Split a library image into editable layers: transparent PNG cutouts for each element, plus any headline recovered as EDITABLE TEXT with its font, size, colour and position. Waits for completion by default. Costs credits.",
+  args: {
+    "image-id": { type: "string", description: "Library image ID to split", required: true },
+    instructions: {
+      type: "string",
+      description: "Optional steer for what to separate, e.g. 'keep the bottle and its shadow as one layer'",
+      required: false
+    },
+    full: { type: "boolean", description: "Include geometry and typography for every layer", required: false },
+    "max-wait": {
+      type: "number",
+      description: "Max wait ms (default 240000 = 4 min). Set 0 to fire-and-forget.",
+      required: false,
+      default: 24e4
+    }
+  }
+});
+var POLL_INTERVAL_MS = 4e3;
+function compact(doc) {
+  return {
+    layeredImageId: doc.layeredImageId,
+    imageId: doc.imageId,
+    status: doc.status,
+    canvas: { width: doc.width, height: doc.height },
+    layers: doc.layers.map((layer) => ({
+      id: layer.id,
+      kind: layer.kind,
+      name: layer.name,
+      ...layer.url ? { url: layer.url } : {},
+      ...layer.text ? { text: layer.text.content } : {}
+    }))
+  };
+}
+function hintsFor(doc) {
+  const hints = [];
+  const text = doc.layers.filter((layer) => layer.kind === "text");
+  const art = doc.layers.filter((layer) => layer.kind === "art" && layer.id !== "layer-base");
+  if (text.length > 0) {
+    hints.push(
+      `${text.length} text layer(s) recovered as editable copy \u2014 run with --full for the font, size and colour to reuse when rewriting it.`
+    );
+  }
+  if (art.length > 0) {
+    hints.push(
+      `Each art layer's url is a transparent PNG on the media host: wire one straight into a canvas composition to reuse that element on its own.`
+    );
+  }
+  hints.push(
+    '"Original image" is the flat picture kept underneath. The model separates what was VISIBLE and does not repaint what sat behind a subject, so moving one can leave a gap.'
+  );
+  return hints;
+}
+async function pollUntilSettled(imageId, maxWait) {
+  const start = Date.now();
+  while (Date.now() - start < maxWait) {
+    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    const doc = await apiGet("/api/images/layers", { imageId });
+    if (doc.status !== "splitting") return doc;
+  }
+  return null;
+}
+var layerizeCommand = defineCommand({
+  meta: {
+    name: "layerize",
+    description: "Split a library image into editable layers \u2014 transparent cutouts per element, plus any baked-in headline recovered as editable text with its typography.\n\nStart here: baker images layerize j571abc123def\nExample: baker images layerize j571abc123def --full\nExample: baker images layerize j571abc123def --instructions 'keep the product and its shadow together'"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    instructions: { type: "string", description: "Optional steer for what to separate", required: false },
+    full: { type: "boolean", description: "Include geometry and typography", required: false },
+    "max-wait": { type: "string", description: "Max wait ms (default 240000, 0 = no wait)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      const maxWait = args["max-wait"] ? Number(args["max-wait"]) : 24e4;
+      const full = Boolean(args.full);
+      const started = await apiPost("/api/images/layerize", {
+        imageId,
+        instructions: args.instructions
+      });
+      const settled = maxWait === 0 || started.status !== "splitting" ? started : await pollUntilSettled(imageId, maxWait);
+      if (!settled) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "TIMEOUT",
+            message: `Layers not ready within ${maxWait}ms`,
+            fix: `The split is still running. Read it later with: baker images layers ${imageId}`
+          }
+        });
+        process.exit(1);
+      }
+      if (settled.status === "failed") {
+        writeJson({
+          ok: false,
+          error: {
+            code: "IMAGE_PROCESSING_ERROR",
+            message: settled.error ?? "That image couldn't be split into layers",
+            fix: "Run the same command again \u2014 this provider rejects a valid request intermittently. If it fails twice more, carry on without layers."
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: true, data: full ? settled : compact(settled), hints: hintsFor(settled) });
+    } 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: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+registerSchema({
+  command: "images.layers",
+  description: "Read the layers of an image already split with `images layerize` \u2014 free, no provider call. Use it to see what an ad says and what its pieces are.",
+  args: {
+    "image-id": { type: "string", description: "Library image ID", required: true },
+    full: { type: "boolean", description: "Include geometry and typography for every layer", required: false }
+  }
+});
+var layersCommand = defineCommand({
+  meta: {
+    name: "layers",
+    description: "Read the layers of an image that has already been split. Free \u2014 no provider call.\n\nStart here: baker images layers j571abc123def\nExample: baker images layers j571abc123def --full"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    full: { type: "boolean", description: "Include geometry and typography", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      const doc = await apiGet("/api/images/layers", { imageId });
+      writeJson({ ok: true, data: args.full ? doc : compact(doc), hints: hintsFor(doc) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            ...err.code === "NOT_FOUND" ? { fix: `Split it first: baker images layerize ${args["image-id"]}` } : {}
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({
+        ok: false,
+        error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+export {
+  layerizeCommand,
+  layersCommand
+};
+//# sourceMappingURL=layerize-TFRXRHVL.js.map