@koda-sl/baker-cli 0.249.0 → 0.250.0-dev.5db6c10ee

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-SJPRTSGY.js";
+} from "./chunk-77OP3PDC.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -5181,6 +5181,9 @@ var imageSourceSchema = z15.enum([
   "google_testimonial",
   "trustpilot_testimonial",
   "instagram",
+  "pexels",
+  "pixabay",
+  // Retired stock provider — kept so existing library rows stay filterable.
   "magnific",
   "brandfetch",
   "google_images",
@@ -5247,7 +5250,8 @@ var imageDocSchema = z15.object({
 }).extend(assetGroupFieldsSchema.shape);
 var imageHitSourceSchema = z15.enum([
   "library",
-  "magnific",
+  "pexels",
+  "pixabay",
   "google_images",
   "brandfetch",
   "firecrawl",
@@ -5367,7 +5371,7 @@ var imagesUpscaleResponseSchema = z15.object({
   imageId: z15.string(),
   status: z15.literal("processing")
 });
-var IMAGES_FIND_SOURCES = ["library", "magnific", "google", "iconify", "giphy", "pinterest"];
+var IMAGES_FIND_SOURCES = ["library", "pexels", "pixabay", "google", "iconify", "giphy", "pinterest"];
 var imagesFindRequestSchema = z15.object({
   query: z15.string().min(1),
   sources: z15.array(z15.enum(IMAGES_FIND_SOURCES)).optional(),
@@ -5390,19 +5394,27 @@ var imagesFindResponseSchema = z15.object({
 });
 var imagesStockRequestSchema = z15.object({
   query: z15.string().min(1),
-  orientation: z15.enum(["landscape", "portrait", "square", "panoramic"]).optional(),
-  contentType: z15.enum(["photo", "vector", "psd"]).optional(),
-  license: z15.enum(["freemium", "premium"]).optional(),
+  /** `illustration` and `vector` are Pixabay-only; `photo` searches both. */
+  contentType: z15.enum(["photo", "illustration", "vector"]).optional(),
+  /** `square` is Pexels-only — Pixabay has no square orientation. */
+  orientation: z15.enum(["landscape", "portrait", "square"]).optional(),
+  /** Minimum resolution: large 24MP, medium 12MP, small 4MP. */
+  size: z15.enum(["large", "medium", "small"]).optional(),
+  /** Named colour (`red`, `turquoise`, …) or a hex code. */
   color: z15.string().optional(),
-  aiGenerated: z15.enum(["exclude", "only"]).optional(),
-  people: z15.enum(["include", "exclude", "only"]).optional(),
-  order: z15.enum(["relevance", "recent"]).optional(),
-  limit: z15.coerce.number().int().positive().max(50).optional(),
+  /** Locale of the search terms, e.g. `es-ES`. */
+  locale: z15.string().optional(),
+  limit: z15.coerce.number().int().positive().max(80).optional(),
   page: z15.coerce.number().int().positive().optional(),
   autoIngest: z15.coerce.number().int().min(0).max(20).optional(),
   descriptionContext: z15.string().optional()
 });
-var imagesStockResponseSchema = providerHitsResponseSchema();
+var imagesStockResponseSchema = providerHitsResponseSchema().extend({
+  /** Libraries that failed while the other answered, so a partial result says
+   * so instead of reading as the whole of what stock holds. Optional, so a CLI
+   * built before the second library still parses the response. */
+  errors: z15.array(z15.object({ source: imageHitSourceSchema, message: z15.string() })).optional()
+});
 var imagesGoogleRequestSchema = z15.object({
   query: z15.string().min(1),
   type: z15.string().optional(),
@@ -19266,6 +19278,14 @@ var CTA_TYPES2 = [
   "BUY_TICKETS",
   "NO_BUTTON"
 ];
+var LEAD_FORM_CTA_TYPES = [
+  "APPLY_NOW",
+  "DOWNLOAD",
+  "GET_QUOTE",
+  "LEARN_MORE",
+  "SIGN_UP",
+  "SUBSCRIBE"
+];
 var AD_FORMATS2 = ["SINGLE_IMAGE", "CAROUSEL", "SINGLE_VIDEO"];
 var ENROLL_STATUSES = ["OPT_IN", "OPT_OUT"];
 var STAGEABLE_CREATE_STATUSES3 = ["ACTIVE", "PAUSED"];
@@ -19697,6 +19717,14 @@ var callToActionSchema = z25.object({
    * "Choose or create an instant form for your leads campaign".
    */
   lead_gen_form_id: z25.string().regex(NUMERIC_ID_REGEX3).optional()
+}).superRefine((p, ctx) => {
+  if (p.lead_gen_form_id && !LEAD_FORM_CTA_TYPES.some((allowed) => allowed === p.type)) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["type"],
+      message: `${p.type} cannot open an instant form \u2014 Meta refuses it (subcode 1856030). Use one of ${LEAD_FORM_CTA_TYPES.join(", ")}, or drop lead_gen_form_id if this ad should go to the website.`
+    });
+  }
 });
 var creativeEnhancementsSchema = z25.object({
   standardEnhancements: z25.enum(ENROLL_STATUSES).optional(),
@@ -20441,7 +20469,7 @@ Example: baker ads meta creatives create --page 555 --message "Save now" --link
     cta: { type: "string", description: "Call-to-action type (SHOP_NOW|LEARN_MORE|SIGN_UP|\u2026)" },
     "lead-form": {
       type: "string",
-      description: "Instant form id the button opens \u2014 REQUIRED for an ad set that collects leads on the ad. List them with `baker ads meta lead-forms`"
+      description: "Instant form id the button opens \u2014 REQUIRED for an ad set that collects leads on the ad. List them with `baker ads meta lead-forms`. With a form, --cta must be APPLY_NOW|DOWNLOAD|GET_QUOTE|LEARN_MORE|SIGN_UP|SUBSCRIBE"
     },
     "image-hash": { type: "string", description: "Meta ad-image hash (already uploaded)" },
     "image-ref": { type: "string", description: "meta_temp_* ref of a staged media upload" },
@@ -23686,7 +23714,7 @@ var ANALYTICS_PRESET_INFO = [
   },
   {
     name: "flow",
-    description: "One Form in depth: conversions counted at the node that produced them, step-to-step paths for a branching Form, the per-step table, every trigger raised, and each marked conversion by name. Read convertedSessions rather than submits \u2014 a Form whose scheduling widget sits mid-flow never emits a submit and reports zero on every other report. An empty `conversions` array means nobody has marked what this Form is for, so the numbers rest on a built-in guess; mark it in the Forms builder or with `conversions: [{ triggerId }]` on the node.",
+    description: "One Form in depth: conversions counted at the node that produced them, step-to-step paths for a branching Form, the per-step table, every trigger raised, and each marked conversion by name. Read convertedSessions rather than submits \u2014 a Form whose scheduling widget sits mid-flow never emits a submit and reports zero on every other report. An empty `conversions` array means nobody has marked what this Form is for, so the numbers rest on a built-in guess; mark it in the Forms builder or with `conversions: [{ triggerId }]` on the node. `flowDestinations` is the other half and is evidence rather than a count: which Forms demonstrably handed something over in this window. Read it against the scaffold's `flow-no-destination` warning before acting on one \u2014 the stored picture of a Form is only rewritten when it is published, so a destination added since then shows there and not in the tree.",
     playbook: "flow-builder \u2014 fix the branch or the step that loses people"
   },
   {
@@ -24165,7 +24193,7 @@ var funnelCommand = presetCommand({
 var flowCommand = presetCommand({
   name: "flow",
   preset: "flow",
-  description: "One Form in depth: how many people it converted, where they went between steps, the per-step table, and every trigger it raised. Every count is DISTINCT VISITS, so quote shares against `funnels[].visits` \u2014 the visits that opened the Form \u2014 and never against `starts`, which is only the visits that touched it. The gap between the two is people who read the Form and left, and on most Forms it is the largest loss there is. Read `flowSummary.convertedSessions`, not `submits` \u2014 a Form that books a call on a scheduling node in the MIDDLE of the flow never emits a submit, so it reports zero submits and every one of its real bookings as conversions. `flowPaths` is the flow as edges between steps, bracketed by __flow_start__, __flow_converted__ and __flow_exit__, which is how a branching Form is read at all: a per-step table cannot say that of the people who left step two, forty went to the booking branch and ninety went nowhere.",
+  description: "One Form in depth: how many people it converted, where they went between steps, the per-step table, and every trigger it raised. Every count is DISTINCT VISITS, so quote shares against `funnels[].visits` \u2014 the visits that opened the Form \u2014 and never against `starts`, which is only the visits that touched it. The gap between the two is people who read the Form and left, and on most Forms it is the largest loss there is. Read `flowSummary.convertedSessions`, not `submits` \u2014 a Form that books a call on a scheduling node in the MIDDLE of the flow never emits a submit, so it reports zero submits and every one of its real bookings as conversions. `flowPaths` is the flow as edges between steps, bracketed by __flow_start__, __flow_converted__ and __flow_exit__, which is how a branching Form is read at all: a per-step table cannot say that of the people who left step two, forty went to the booking branch and ninety went nowhere. `flowDestinations` is the other half and is evidence rather than a count: which Forms demonstrably handed something over in this window. Read it against the scaffold's `flow-no-destination` warning before acting on one \u2014 the stored picture of a Form is only rewritten when it is published, so a destination added since then shows there and not in the tree.",
   extraArgs: { flow: { type: "string", description: "Form slug (default: every Form)", required: false } },
   resolve: (args) => ({ preset: "flow", flowSlug: args.flow ? String(args.flow) : void 0 })
 });
@@ -38659,10 +38687,10 @@ var FALLBACK = {
   google: () => "Still empty \u2192 `baker studio generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry.",
   // The library is step 1 of the sourcing recipe, so its empty result is the
   // most common one an agent hits — and the one that previously steered nowhere.
-  library: () => "The library does not hold this yet \u2014 that is a normal starting state, not a failure. Source it externally, which also files it into the library for next time: `baker images find <query> --sources library,magnific,pinterest,google` for a broad sweep, `baker images stock <query> --type photo` for photography, `baker images logo <domain>` for a brand mark, or `baker studio generate` to make it. Do not re-run this search with reshuffled filters.",
-  find: () => "`find` searches only the sources you name \u2014 with no `--sources` it searches the library alone, which is the usual cause of an empty fanout. Re-run as `baker images find <query> --sources library,magnific,pinterest,google`. If that is still empty, `baker studio generate` makes the asset.",
+  library: () => "The library does not hold this yet \u2014 that is a normal starting state, not a failure. Source it externally, which also files it into the library for next time: `baker images find <query> --sources library,pexels,pixabay,pinterest,google` for a broad sweep, `baker images stock <query>` for photography or `--type vector` for artwork, `baker images logo <domain>` for a brand mark, or `baker studio generate` to make it. Do not re-run this search with reshuffled filters.",
+  find: () => "`find` searches only the sources you name \u2014 with no `--sources` it searches the library alone, which is the usual cause of an empty fanout. Re-run as `baker images find <query> --sources library,pexels,pixabay,pinterest,google`. If that is still empty, `baker studio generate` makes the asset.",
   logo: (subject) => `Brandfetch does not know this domain \u2014 that is normal for small or recently renamed brands, and is not a failure. Pull the mark off the brand's own site instead: \`baker images extract https://${subject}\`. For a tech or product mark also try \`baker images icon <name> --set logos\`.`,
-  icon: (subject) => `No icon matched. Iconify is set-scoped, so the set is usually the problem, not the name: retry with \`baker images icon ${subject} --set lucide\` (UI glyphs), \`--set simple-icons\` or \`--set logos\` (brand marks), \`--set devicon\` (tech stack). Still nothing \u2192 \`baker images stock ${subject} --type vector\`.`
+  icon: (subject) => `No icon matched. Iconify is set-scoped, so the set is usually the problem, not the name: retry with \`baker images icon ${subject} --set lucide\` (UI glyphs), \`--set simple-icons\` or \`--set logos\` (brand marks), \`--set devicon\` (tech stack). Still nothing \u2192 \`baker images stock ${subject} --type vector\`, then \`baker studio generate\` with the vector model.`
 };
 function emptyResultHints({ provider, hitCount, activeFilters, subject }) {
   if (hitCount > 0) {
@@ -38689,7 +38717,7 @@ registerSchema({
     query: { type: "string", description: "Search query", required: true },
     sources: {
       type: "string",
-      description: "Comma-separated providers: library,magnific,google,iconify,giphy,pinterest (brandfetch lives at `baker images logo`)",
+      description: "Comma-separated providers: library,pexels,pixabay,google,iconify,giphy,pinterest (brandfetch lives at `baker images logo`)",
       required: false
     },
     limit: { type: "number", description: "Max results per group", required: false, default: 20 },
@@ -38719,7 +38747,7 @@ registerSchema({
 var findCommand = defineCommand135({
   meta: {
     name: "find",
-    description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs.\n\nExample: baker images find 'office' --sources library,magnific --limit 20"
+    description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs.\n\nExample: baker images find 'office' --sources library,pexels --limit 20"
   },
   args: {
     query: { type: "positional", description: "Search query", required: false },
@@ -39283,7 +39311,7 @@ registerSchema({
 var ingestCommand = defineCommand141({
   meta: {
     name: "ingest",
-    description: "Download a remote URL and store it in the library. Hash-deduped on bytes + externalId.\n\nExample: baker images ingest https://img.freepik.com/free-photo/xyz.jpg --source magnific --external-id 12345"
+    description: "Download a remote URL and store it in the library. Hash-deduped on bytes + externalId.\n\nExample: baker images ingest https://images.pexels.com/photos/13219418/pexels-photo-13219418.jpeg --source pexels --external-id 13219418"
   },
   args: {
     url: { type: "positional", description: "Image URL", required: false },
@@ -39538,7 +39566,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
     source: {
       type: "string",
-      description: "Filter by source (uploaded, magnific, brandfetch, google_images, firecrawl, screenshotone, iconify, giphy, \u2026)",
+      description: "Filter by source (uploaded, pexels, pixabay, brandfetch, google_images, firecrawl, screenshotone, iconify, giphy, \u2026)",
       required: false
     },
     "external-url-host": {
@@ -40821,47 +40849,38 @@ var STOCK_ERROR_FIX = {
 };
 registerSchema({
   command: "images.stock",
-  description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
+  description: "Stock search across the free libraries \u2014 Pexels photos plus Pixabay photos, illustrations and vectors. The previous provider's --license, --ai, --people and --order do not exist here: everything both libraries hold is free for commercial use with no attribution, neither indexes AI-generated content separately, neither has a people filter (name the person in the query instead), and both sort by relevance only.",
   args: {
     query: { type: "string", description: "Search query", required: true },
     type: {
       type: "string",
-      description: "Content type: photo | vector | psd",
+      description: "Content type: photo (default, both libraries) | illustration | vector (Pixabay only)",
       required: false,
-      enum: ["photo", "vector", "psd"]
+      enum: ["photo", "illustration", "vector"]
     },
     orientation: {
       type: "string",
-      description: "landscape | portrait | square | panoramic",
+      description: "landscape | portrait | square (square searches Pexels only \u2014 Pixabay has no square)",
       required: false,
-      enum: ["landscape", "portrait", "square", "panoramic"]
+      enum: ["landscape", "portrait", "square"]
     },
-    license: {
-      type: "string",
-      description: "freemium (free with attribution) | premium (paid)",
-      required: false,
-      enum: ["freemium", "premium"]
-    },
-    color: { type: "string", description: "Hex color filter (e.g. '#0a0a0a' or '0a0a0a')", required: false },
-    ai: {
+    size: {
       type: "string",
-      description: "AI-generated filter: exclude | only (default: no filter)",
+      description: "Minimum resolution: large (24MP) | medium (12MP) | small (4MP)",
       required: false,
-      enum: ["exclude", "only"]
+      enum: ["large", "medium", "small"]
     },
-    people: {
+    color: {
       type: "string",
-      description: "People-in-image filter: include | exclude | only",
-      required: false,
-      enum: ["include", "exclude", "only"]
+      description: "Colour filter \u2014 a name (red, turquoise, black, \u2026) searches both libraries; a hex code such as '#0a0a0a' searches Pexels only",
+      required: false
     },
-    order: {
+    locale: {
       type: "string",
-      description: "relevance (default) | recent",
-      required: false,
-      enum: ["relevance", "recent"]
+      description: "Locale of the search terms, e.g. 'es-ES' or 'de-DE' \u2014 Pexels matches translated tags",
+      required: false
     },
-    limit: { type: "number", description: "Max results (1-50, default 10)", required: false, default: 10 },
+    limit: { type: "number", description: "Max results (1-80, default 10)", required: false, default: 10 },
     page: { type: "number", description: "Page number for pagination", required: false },
     "auto-ingest": {
       type: "number",
@@ -40871,7 +40890,7 @@ registerSchema({
     },
     context: {
       type: "string",
-      description: "Free-text hint applied to every auto-ingested hit (overrides Magnific title)",
+      description: "Free-text hint applied to every auto-ingested hit (overrides the library's own alt text or tags)",
       required: false
     }
   }
@@ -40880,32 +40899,42 @@ function buildStockRequest(query, args) {
   const body = { query };
   if (args.type) body.contentType = args.type;
   if (args.orientation) body.orientation = args.orientation;
-  if (args.license) body.license = args.license;
+  if (args.size) body.size = args.size;
   if (args.color) body.color = args.color;
-  if (args.ai) body.aiGenerated = args.ai;
-  if (args.people) body.people = args.people;
-  if (args.order) body.order = args.order;
+  if (args.locale) body.locale = args.locale;
   if (args.limit) body.limit = Number(args.limit);
   if (args.page) body.page = Number(args.page);
   if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
   if (args.context) body.descriptionContext = args.context;
   return body;
 }
+function partialLibraryHints(errors, hitCount) {
+  if (!errors || errors.length === 0) return [];
+  const sources = errors.map((e) => e.source);
+  const names = sources.join(", ");
+  if (hitCount === 0) {
+    const failed = sources.length === 1 ? `${sources[0]} did not answer` : `none of ${names} answered`;
+    return [
+      `Stock search did not run \u2014 ${failed}. This is an outage, not an empty result: do not re-run it with a different query or flags, and report that stock search is unavailable. Source the asset another way (\`baker images find <query> --sources library,pinterest,google\`) or \`baker studio generate\`.`
+    ];
+  }
+  return [
+    `These results are partial: ${names} did not answer, so they come from the remaining library alone. Treat a thin result as unproven rather than as "stock does not have this", and report the outage rather than re-running the search.`
+  ];
+}
 var stockCommand = defineCommand150({
   meta: {
     name: "stock",
-    description: "Stock search via Magnific \u2014 Freepik's developer API (~250M assets: photos, vectors, illustrations, icons, PSDs). $0.002/req. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'flat office workers' --type vector\n  baker images stock 'hero photo of a kitchen' --type photo --orientation landscape --ai exclude\n  baker images stock 'brand pattern' --color '#0a0a0a' --license freemium --auto-ingest 2"
+    description: "Stock search across the free libraries \u2014 Pexels photographs plus Pixabay photographs, illustrations and vectors. No per-request cost. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'hero photo of a kitchen' --orientation landscape --size large\n  baker images stock 'flat office workers' --type illustration\n  baker images stock 'leaf outline mark' --type vector\n  baker images stock 'smiling carpenter portrait' --orientation portrait"
   },
   args: {
     query: { type: "positional", description: "Search query", required: false },
-    type: { type: "string", description: "photo|vector|psd", required: false },
-    orientation: { type: "string", description: "Orientation filter", required: false },
-    license: { type: "string", description: "freemium|premium", required: false },
-    color: { type: "string", description: "Hex color filter", required: false },
-    ai: { type: "string", description: "exclude|only", required: false },
-    people: { type: "string", description: "include|exclude|only", required: false },
-    order: { type: "string", description: "relevance|recent", required: false },
-    limit: { type: "string", description: "Max results (1-50)", required: false },
+    type: { type: "string", description: "photo|illustration|vector", required: false },
+    orientation: { type: "string", description: "landscape|portrait|square", required: false },
+    size: { type: "string", description: "Minimum resolution: large|medium|small", required: false },
+    color: { type: "string", description: "Colour name or hex code", required: false },
+    locale: { type: "string", description: "Locale of the search terms, e.g. es-ES", required: false },
+    limit: { type: "string", description: "Max results (1-80)", required: false },
     page: { type: "string", description: "Page number", required: false },
     "auto-ingest": {
       type: "string",
@@ -40939,11 +40968,15 @@ var stockCommand = defineCommand150({
         }
       }
       const data = await apiPost("/api/images/stock", buildStockRequest(query, args));
-      const hints = emptyResultHints({
-        provider: "stock",
-        hitCount: data.hits.length,
-        activeFilters: activeFilterFlags(args, ["type", "orientation", "license", "color", "ai", "people"])
-      });
+      const outage = (data.errors?.length ?? 0) > 0 && data.hits.length === 0;
+      const hints = [
+        ...partialLibraryHints(data.errors, data.hits.length),
+        ...outage ? [] : emptyResultHints({
+          provider: "stock",
+          hitCount: data.hits.length,
+          activeFilters: activeFilterFlags(args, ["type", "orientation", "size", "color", "locale"])
+        })
+      ];
       writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
@@ -41298,7 +41331,7 @@ Library + search:
   baker images find <q> --sources \u2026     Fanout: library first, then opt-in providers
 
 External providers:
-  baker images stock <q> [--type photo|vector|psd]     Magnific (Freepik's dev API) \u2014 photos, vectors, illustrations, PSDs
+  baker images stock <q> [--type \u2026]                    Free stock \u2014 Pexels photos + Pixabay illustrations/vectors
   baker images google <q>                              Google Images via the official Custom Search API
   baker images pinterest <q>                           Pinterest reference imagery via ScrapeCreators (photo-real mood boards)
   baker images logo <domain>                           Brand logo via Brandfetch CDN