@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/chunk-V6XXXEXZ.js

@@ -0,0 +1,76 @@
+import {
+  handleConnectionError,
+  isNotConnectedError,
+  writeAdsJson
+} from "./chunk-EIGXX6KI.js";
+import {
+  ApiError
+} from "./chunk-CUL3VB4L.js";
+
+// src/commands/ads/google/service-read-errors.ts
+var KNOWN_REFUSALS = [
+  {
+    match: /BILLING_SETUP_NOT_ON_MONTHLY_INVOICING/,
+    code: "NOT_INVOICED",
+    message: "This account is not billed by monthly invoicing, so Google issues no invoices through the API.",
+    explanation: "Degrade, don't abort: the account pays automatically (card or bank), and its receipts are in Google Ads \u2192 Billing \u2192 Documents for the user to download. Spend itself is readable with `query --preset account-summary`. Carry on with the rest of the job."
+  },
+  {
+    match: /no approved billing setup/i,
+    code: "NO_BILLING_SETUP",
+    message: "This account has no approved billing setup, so it has no invoices.",
+    explanation: "Degrade, don't abort: nothing is billed to this account yet (or a manager account pays). Carry on with the rest of the job."
+  },
+  {
+    match: /BILLING_NOT_ON_MONTHLY_INVOICING|verification is only open to customers with billing setup for monthly invoicing/,
+    code: "VERIFICATION_NOT_READABLE",
+    message: "Google only reports advertiser verification through the API for accounts on monthly invoicing.",
+    explanation: "Degrade, don't abort: the status is in Google Ads \u2192 Billing \u2192 Advertiser verification, where the user can read it. Say that, and carry on with the rest of the job."
+  },
+  {
+    match: /UNSUPPORTED_AD_TYPE/,
+    code: "NO_PREVIEW_FOR_AD_TYPE",
+    message: "Google has no shareable preview for this ad type: --ads previews only video ads of Video campaigns, live on YouTube (search, display and Demand Gen ads answer unsupported).",
+    explanation: "Degrade, don't abort: preview a Performance Max campaign with --asset-groups, and describe any other ad from its copy (`ads list`, `query --preset ad-copy-performance`). Carry on with the rest of the job."
+  }
+];
+function serviceReadRefusal(message) {
+  const known = KNOWN_REFUSALS.find((refusal) => refusal.match.test(message));
+  if (!known) return null;
+  return {
+    ok: false,
+    error: {
+      code: known.code,
+      message: known.message,
+      fix: { action: "reject", explanation: known.explanation },
+      retryable: false
+    }
+  };
+}
+function exitWithServiceReadError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) handleConnectionError("google_ads", err.message);
+    writeAdsJson(
+      serviceReadRefusal(err.message) ?? {
+        ok: false,
+        error: {
+          code: err.code,
+          message: err.message,
+          fix: { action: "reject", explanation: err.message },
+          retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE"
+        }
+      }
+    );
+    process.exit(1);
+  }
+  writeAdsJson({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+
+export {
+  exitWithServiceReadError
+};
+//# sourceMappingURL=chunk-V6XXXEXZ.js.map

package/dist/chunk-V6XXXEXZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/service-read-errors.ts"],"sourcesContent":["/**\n * What a refused non-GAQL read (invoices, identity verification, previews, forecast, themes) tells\n * the agent. A refusal that is the account's situation — not on monthly invoicing, no billing\n * setup — is not a failure of the job: the fix says where the answer lives instead and to carry on.\n */\nimport { ApiError } from \"../../../client.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../../error-handler.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport type { AdsErrorEnvelope } from \"../types.ts\";\n\ninterface KnownRefusal {\n  match: RegExp;\n  code: string;\n  message: string;\n  explanation: string;\n}\n\nconst KNOWN_REFUSALS: KnownRefusal[] = [\n  {\n    match: /BILLING_SETUP_NOT_ON_MONTHLY_INVOICING/,\n    code: \"NOT_INVOICED\",\n    message: \"This account is not billed by monthly invoicing, so Google issues no invoices through the API.\",\n    explanation:\n      \"Degrade, don't abort: the account pays automatically (card or bank), and its receipts are in Google Ads → Billing → Documents for the user to download. Spend itself is readable with `query --preset account-summary`. Carry on with the rest of the job.\",\n  },\n  {\n    match: /no approved billing setup/i,\n    code: \"NO_BILLING_SETUP\",\n    message: \"This account has no approved billing setup, so it has no invoices.\",\n    explanation:\n      \"Degrade, don't abort: nothing is billed to this account yet (or a manager account pays). Carry on with the rest of the job.\",\n  },\n  {\n    match:\n      /BILLING_NOT_ON_MONTHLY_INVOICING|verification is only open to customers with billing setup for monthly invoicing/,\n    code: \"VERIFICATION_NOT_READABLE\",\n    message: \"Google only reports advertiser verification through the API for accounts on monthly invoicing.\",\n    explanation:\n      \"Degrade, don't abort: the status is in Google Ads → Billing → Advertiser verification, where the user can read it. Say that, and carry on with the rest of the job.\",\n  },\n  {\n    match: /UNSUPPORTED_AD_TYPE/,\n    code: \"NO_PREVIEW_FOR_AD_TYPE\",\n    message:\n      \"Google has no shareable preview for this ad type: --ads previews only video ads of Video campaigns, live on YouTube (search, display and Demand Gen ads answer unsupported).\",\n    explanation:\n      \"Degrade, don't abort: preview a Performance Max campaign with --asset-groups, and describe any other ad from its copy (`ads list`, `query --preset ad-copy-performance`). Carry on with the rest of the job.\",\n  },\n];\n\nexport function serviceReadRefusal(message: string): AdsErrorEnvelope | null {\n  const known = KNOWN_REFUSALS.find((refusal) => refusal.match.test(message));\n  if (!known) return null;\n  return {\n    ok: false,\n    error: {\n      code: known.code,\n      message: known.message,\n      fix: { action: \"reject\", explanation: known.explanation },\n      retryable: false,\n    },\n  };\n}\n\n/** Write the error envelope for a failed service read and exit. */\nexport function exitWithServiceReadError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (isNotConnectedError(err.code, err.message)) handleConnectionError(\"google_ads\", err.message);\n    writeAdsJson(\n      serviceReadRefusal(err.message) ?? {\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          fix: { action: \"reject\", explanation: err.message },\n          retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\",\n        },\n      },\n    );\n    process.exit(1);\n  }\n  writeAdsJson({\n    ok: false,\n    error: { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n  });\n  process.exit(1);\n}\n"],"mappings":";;;;;;;;;;AAiBA,IAAM,iBAAiC;AAAA,EACrC;AAAA,IACE,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,aACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,aACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,OACE;AAAA,IACF,MAAM;AAAA,IACN,SAAS;AAAA,IACT,aACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SACE;AAAA,IACF,aACE;AAAA,EACJ;AACF;AAEO,SAAS,mBAAmB,SAA0C;AAC3E,QAAM,QAAQ,eAAe,KAAK,CAAC,YAAY,QAAQ,MAAM,KAAK,OAAO,CAAC;AAC1E,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,SAAS,MAAM;AAAA,MACf,KAAK,EAAE,QAAQ,UAAU,aAAa,MAAM,YAAY;AAAA,MACxD,WAAW;AAAA,IACb;AAAA,EACF;AACF;AAGO,SAAS,yBAAyB,KAAqB;AAC5D,MAAI,eAAe,UAAU;AAC3B,QAAI,oBAAoB,IAAI,MAAM,IAAI,OAAO,EAAG,uBAAsB,cAAc,IAAI,OAAO;AAC/F;AAAA,MACE,mBAAmB,IAAI,OAAO,KAAK;AAAA,QACjC,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM,IAAI;AAAA,UACV,SAAS,IAAI;AAAA,UACb,KAAK,EAAE,QAAQ,UAAU,aAAa,IAAI,QAAQ;AAAA,UAClD,WAAW,IAAI,SAAS,kBAAkB,IAAI,SAAS;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,eAAa;AAAA,IACX,IAAI;AAAA,IACJ,OAAO,EAAE,MAAM,iBAAiB,SAAS,eAAe,QAAQ,IAAI,UAAU,mBAAmB;AAAA,EACnG,CAAC;AACD,UAAQ,KAAK,CAAC;AAChB;","names":[]}

package/dist/chunk-V7BW2CIQ.js

@@ -0,0 +1,92 @@
+import {
+  leadVersion,
+  writeSeriesMemberCanvas
+} from "./chunk-EVDRF4CI.js";
+import {
+  claimNewCreativeInWorkspace,
+  creativeLimitRefusal
+} from "./chunk-CVEY353K.js";
+import {
+  definitionFieldsOf,
+  setDefinitionFields,
+  setSpecMessage
+} from "./chunk-TTVKI54A.js";
+import {
+  IDEAS_DIR
+} from "./chunk-BIPIL4QA.js";
+
+// src/commands/creatives/make-series.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { parseDocument } from "yaml";
+var LEAD_ONLY = ["idea", "message", "evidence", "angle", "persona", "awareness", "hypothesis", "series", "title"];
+function withoutFields(raw, keys) {
+  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  for (const key of keys) doc.delete(key);
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+async function makeSeriesAd(root, idea, slug, lead, evidence, deps) {
+  if (slug === lead) {
+    return {
+      code: "series_of_itself",
+      message: `"${slug}" is the lead itself.`,
+      fix: "Give the new ad its own --slug."
+    };
+  }
+  const version = await leadVersion(root, lead);
+  if ("refused" in version) return version.refused;
+  const dir = path.join(root, "src", "creatives", slug);
+  const definitionPath = path.join(dir, "_definition.md");
+  const claim = await claimNewCreativeInWorkspace(path.join(root, "canvas"), slug, deps.chatId, definitionPath);
+  if (!claim.allowed) return creativeLimitRefusal(slug).error;
+  await mkdir(dir, { recursive: true });
+  await writeFile(path.join(dir, "prompt.json"), setSpecMessage(JSON.stringify(version.spec), idea.message), "utf8");
+  const leadDefinition = await readFile(path.join(root, "src", "creatives", lead, "_definition.md"), "utf8").catch(
+    () => "---\nkind: static\n---\n"
+  );
+  const definition = setDefinitionFields(withoutFields(leadDefinition, LEAD_ONLY), {
+    title: idea.message.slice(0, 120),
+    series: lead,
+    status: "draft",
+    ...definitionFieldsOf(idea, evidence)
+  });
+  await writeFile(definitionPath, definition, "utf8");
+  const made = await writeSeriesMemberCanvas(root, slug, { leadWords: true });
+  if (made === null || "refused" in made) {
+    return made?.refused ?? { code: "series_not_made", message: `"${slug}" could not be made in the series of "${lead}".` };
+  }
+  if (idea.status === "idea") {
+    const ideaPath = path.join(root, IDEAS_DIR, `${idea.id}.md`);
+    const raw = await readFile(ideaPath, "utf8").catch(() => null);
+    if (raw !== null) await writeFile(ideaPath, setDefinitionFields(raw, { status: "built" }), "utf8");
+  }
+  await deps.sync(dir);
+  return { slug, lead, leadRunId: version.lead.runId, canvasPath: made.canvasPath };
+}
+function seriesMadeEnvelope(made, idea) {
+  return {
+    ok: true,
+    data: {
+      creative: made.slug,
+      idea: idea.id,
+      message: idea.message,
+      series: made.lead,
+      canvas_path: made.canvasPath
+    },
+    hints: [
+      `Write this ad's words in src/creatives/${made.slug}/prompt.json \`copy\`: one line for each of the lead's, in the same roles and about as long, saying this idea's message. Change nothing else: the picture, layout and colours are the lead's (${made.lead}), and every word you write replaces the lead's line in its place.`,
+      `When every ad of the series has its words: baker canvas run --series ${made.lead} (renders them all at once, each reviewed and corrected on its own).`
+    ]
+  };
+}
+
+export {
+  withoutFields,
+  makeSeriesAd,
+  seriesMadeEnvelope
+};
+//# sourceMappingURL=chunk-V7BW2CIQ.js.map

package/dist/chunk-V7BW2CIQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/make-series.ts"],"sourcesContent":["/**\n * `baker creatives make <idea> --series <lead>`: another message in the lead ad's style. Nothing is\n * searched, described or rendered: the ad starts as the lead's ready version with the idea's\n * message, and its words are the agent's to write. Its picture is the lead's with those words\n * (`series-member.ts`), so a series of ten messages is one design ten times.\n */\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { parseDocument } from \"yaml\";\nimport { claimNewCreativeInWorkspace, creativeLimitRefusal } from \"../canvas/creative-limit.ts\";\nimport { leadVersion, writeSeriesMemberCanvas } from \"../canvas/series-member.ts\";\nimport type { EvidenceLevel, Idea } from \"./ideas-model.ts\";\nimport { IDEAS_DIR } from \"./ideas-workspace.ts\";\nimport { definitionFieldsOf, setDefinitionFields, setSpecMessage } from \"./make-model.ts\";\n\ntype Failure = { code: string; message: string; fix?: string };\n\n/** The lead's own reasons, which are not this ad's: its idea, evidence and the like are replaced or dropped. */\nconst LEAD_ONLY = [\"idea\", \"message\", \"evidence\", \"angle\", \"persona\", \"awareness\", \"hypothesis\", \"series\", \"title\"];\n\n/** `raw` with `keys` dropped from its frontmatter, every other field and the body kept. */\nexport function withoutFields(raw: string, keys: readonly string[]): string {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/);\n  if (!match) return raw;\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return raw;\n  for (const key of keys) doc.delete(key);\n  return `---\\n${doc.toString()}---${raw.slice(match[0].length)}`;\n}\n\n/** Make `slug`, an ad of the series led by `lead`, from `idea`. The made ad, or why not. */\nexport async function makeSeriesAd(\n  root: string,\n  idea: Idea,\n  slug: string,\n  lead: string,\n  evidence: EvidenceLevel | \"explore\",\n  deps: { sync: (dir: string) => Promise<unknown>; chatId: string | null },\n): Promise<{ slug: string; lead: string; leadRunId: string; canvasPath: string } | Failure> {\n  if (slug === lead) {\n    return {\n      code: \"series_of_itself\",\n      message: `\"${slug}\" is the lead itself.`,\n      fix: \"Give the new ad its own --slug.\",\n    };\n  }\n  const version = await leadVersion(root, lead);\n  if (\"refused\" in version) return version.refused;\n  const dir = path.join(root, \"src\", \"creatives\", slug);\n  const definitionPath = path.join(dir, \"_definition.md\");\n  const claim = await claimNewCreativeInWorkspace(path.join(root, \"canvas\"), slug, deps.chatId, definitionPath);\n  if (!claim.allowed) return creativeLimitRefusal(slug).error;\n  await mkdir(dir, { recursive: true });\n  await writeFile(path.join(dir, \"prompt.json\"), setSpecMessage(JSON.stringify(version.spec), idea.message), \"utf8\");\n  const leadDefinition = await readFile(path.join(root, \"src\", \"creatives\", lead, \"_definition.md\"), \"utf8\").catch(\n    () => \"---\\nkind: static\\n---\\n\",\n  );\n  const definition = setDefinitionFields(withoutFields(leadDefinition, LEAD_ONLY), {\n    title: idea.message.slice(0, 120),\n    series: lead,\n    status: \"draft\",\n    ...definitionFieldsOf(idea, evidence),\n  });\n  await writeFile(definitionPath, definition, \"utf8\");\n  const made = await writeSeriesMemberCanvas(root, slug, { leadWords: true });\n  if (made === null || \"refused\" in made) {\n    return (\n      made?.refused ?? { code: \"series_not_made\", message: `\"${slug}\" could not be made in the series of \"${lead}\".` }\n    );\n  }\n  if (idea.status === \"idea\") {\n    const ideaPath = path.join(root, IDEAS_DIR, `${idea.id}.md`);\n    const raw = await readFile(ideaPath, \"utf8\").catch(() => null);\n    if (raw !== null) await writeFile(ideaPath, setDefinitionFields(raw, { status: \"built\" }), \"utf8\");\n  }\n  // The dashboard learns the ad and its series now, not at Publish.\n  await deps.sync(dir);\n  return { slug, lead, leadRunId: version.lead.runId, canvasPath: made.canvasPath };\n}\n\n/** What `make --series` prints: the ad, its lead, and the one step left (its words), then the series run. Pure. */\nexport function seriesMadeEnvelope(\n  made: { slug: string; lead: string; leadRunId: string; canvasPath: string },\n  idea: Pick<Idea, \"id\" | \"message\">,\n) {\n  return {\n    ok: true as const,\n    data: {\n      creative: made.slug,\n      idea: idea.id,\n      message: idea.message,\n      series: made.lead,\n      canvas_path: made.canvasPath,\n    },\n    hints: [\n      `Write this ad's words in src/creatives/${made.slug}/prompt.json \\`copy\\`: one line for each of the lead's, in the same roles and about as long, saying this idea's message. Change nothing else: the picture, layout and colours are the lead's (${made.lead}), and every word you write replaces the lead's line in its place.`,\n      `When every ad of the series has its words: baker canvas run --series ${made.lead} (renders them all at once, each reviewed and corrected on its own).`,\n    ],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-VSU5R34H.js

@@ -0,0 +1,76 @@
+import {
+  MAX_REMOTE_IMAGE_BYTES,
+  fetchExternalBytes
+} from "./chunk-JXMZEOHV.js";
+
+// src/lib/image/io.ts
+import { randomBytes } from "crypto";
+import { glob as fsGlob, readFile, rename, stat, writeFile } from "fs/promises";
+import { dirname, extname, join, resolve } from "path";
+var REMOTE_RE = /^https?:\/\//i;
+var GLOB_RE = /[*?[\]{}]/;
+function isRemoteUrl(value) {
+  return REMOTE_RE.test(value);
+}
+function looksLikeGlob(value) {
+  return GLOB_RE.test(value);
+}
+async function expandInputs(spec) {
+  const parts = spec.split(",").map((p) => p.trim()).filter(Boolean);
+  const out = [];
+  for (const part of parts) {
+    if (isRemoteUrl(part)) {
+      out.push(part);
+      continue;
+    }
+    if (looksLikeGlob(part)) {
+      for await (const match of fsGlob(part)) {
+        if (typeof match === "string") out.push(match);
+      }
+    } else {
+      out.push(part);
+    }
+  }
+  return out;
+}
+async function readImageBuffer(pathOrUrl) {
+  if (isRemoteUrl(pathOrUrl)) {
+    const { buffer } = await fetchExternalBytes(pathOrUrl, { maxBytes: MAX_REMOTE_IMAGE_BYTES });
+    return buffer;
+  }
+  return readFile(pathOrUrl);
+}
+async function isDirectory(path) {
+  try {
+    const s = await stat(path);
+    return s.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function resolveOutputPath(inputPath, outputArg, options) {
+  const base = options.newExtension ? inputPath.slice(0, -extname(inputPath).length) + options.newExtension : inputPath;
+  if (!outputArg) return base;
+  if (options.multipleInputs || await isDirectory(outputArg)) {
+    const filename = base.split("/").pop() ?? "out.png";
+    return join(outputArg, filename);
+  }
+  return outputArg;
+}
+async function atomicWrite(targetPath, data) {
+  const absolute = resolve(targetPath);
+  const dir = dirname(absolute);
+  const tmp = join(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
+  await writeFile(tmp, data);
+  await rename(tmp, absolute);
+}
+
+export {
+  isRemoteUrl,
+  expandInputs,
+  readImageBuffer,
+  isDirectory,
+  resolveOutputPath,
+  atomicWrite
+};
+//# sourceMappingURL=chunk-VSU5R34H.js.map

package/dist/chunk-VSU5R34H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/image/io.ts"],"sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport { glob as fsGlob, readFile, rename, stat, writeFile } from \"node:fs/promises\";\nimport { dirname, extname, join, resolve } from \"node:path\";\nimport { fetchExternalBytes, MAX_REMOTE_IMAGE_BYTES } from \"../externalFetch.ts\";\n\nconst REMOTE_RE = /^https?:\\/\\//i;\nconst GLOB_RE = /[*?[\\]{}]/;\n\nexport function isRemoteUrl(value: string): boolean {\n  return REMOTE_RE.test(value);\n}\n\nfunction looksLikeGlob(value: string): boolean {\n  return GLOB_RE.test(value);\n}\n\n/**\n * Expand a user-supplied input spec into a list of local file paths.\n * Accepts: single path, glob pattern, or comma-separated list. Inputs that look\n * like remote URLs are returned unchanged so callers can decide whether to\n * fetch them.\n */\nexport async function expandInputs(spec: string): Promise<string[]> {\n  const parts = spec\n    .split(\",\")\n    .map((p) => p.trim())\n    .filter(Boolean);\n  const out: string[] = [];\n  for (const part of parts) {\n    if (isRemoteUrl(part)) {\n      out.push(part);\n      continue;\n    }\n    if (looksLikeGlob(part)) {\n      for await (const match of fsGlob(part)) {\n        if (typeof match === \"string\") out.push(match);\n      }\n    } else {\n      out.push(part);\n    }\n  }\n  return out;\n}\n\nexport async function readImageBuffer(pathOrUrl: string): Promise<Buffer> {\n  if (isRemoteUrl(pathOrUrl)) {\n    // Everything reaching here is decoded by sharp — `crop`, `normalize`,\n    // `dimensions`. An image ceiling, not the canvas asset one.\n    const { buffer } = await fetchExternalBytes(pathOrUrl, { maxBytes: MAX_REMOTE_IMAGE_BYTES });\n    return buffer;\n  }\n  return readFile(pathOrUrl);\n}\n\nexport async function isDirectory(path: string): Promise<boolean> {\n  try {\n    const s = await stat(path);\n    return s.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolve the output path for a processed file.\n * - One input + --output=<file>  → that file path\n * - One input + --output=<dir>   → dir/basename\n * - One input, no --output       → input path (in-place)\n * - N inputs + --output=<dir>    → dir/basename\n * - N inputs, no --output        → each input path (in-place)\n * - N inputs + --output=<file>   → validation error before reaching here\n */\nexport async function resolveOutputPath(\n  inputPath: string,\n  outputArg: string | undefined,\n  options: { multipleInputs: boolean; newExtension?: string },\n): Promise<string> {\n  const base = options.newExtension ? inputPath.slice(0, -extname(inputPath).length) + options.newExtension : inputPath;\n\n  if (!outputArg) return base;\n\n  if (options.multipleInputs || (await isDirectory(outputArg))) {\n    const filename = base.split(\"/\").pop() ?? \"out.png\";\n    return join(outputArg, filename);\n  }\n  return outputArg;\n}\n\n/**\n * Write a file atomically: write to a tempfile in the same directory, then\n * rename. Prevents partial writes if the process is killed mid-write.\n */\nexport async function atomicWrite(targetPath: string, data: Buffer): Promise<void> {\n  const absolute = resolve(targetPath);\n  const dir = dirname(absolute);\n  const tmp = join(dir, `.baker-image-${randomBytes(8).toString(\"hex\")}.tmp`);\n  await writeFile(tmp, data);\n  await rename(tmp, absolute);\n}\n"],"mappings":";;;;;;AAAA,SAAS,mBAAmB;AAC5B,SAAS,QAAQ,QAAQ,UAAU,QAAQ,MAAM,iBAAiB;AAClE,SAAS,SAAS,SAAS,MAAM,eAAe;AAGhD,IAAM,YAAY;AAClB,IAAM,UAAU;AAET,SAAS,YAAY,OAAwB;AAClD,SAAO,UAAU,KAAK,KAAK;AAC7B;AAEA,SAAS,cAAc,OAAwB;AAC7C,SAAO,QAAQ,KAAK,KAAK;AAC3B;AAQA,eAAsB,aAAa,MAAiC;AAClE,QAAM,QAAQ,KACX,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACjB,QAAM,MAAgB,CAAC;AACvB,aAAW,QAAQ,OAAO;AACxB,QAAI,YAAY,IAAI,GAAG;AACrB,UAAI,KAAK,IAAI;AACb;AAAA,IACF;AACA,QAAI,cAAc,IAAI,GAAG;AACvB,uBAAiB,SAAS,OAAO,IAAI,GAAG;AACtC,YAAI,OAAO,UAAU,SAAU,KAAI,KAAK,KAAK;AAAA,MAC/C;AAAA,IACF,OAAO;AACL,UAAI,KAAK,IAAI;AAAA,IACf;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,gBAAgB,WAAoC;AACxE,MAAI,YAAY,SAAS,GAAG;AAG1B,UAAM,EAAE,OAAO,IAAI,MAAM,mBAAmB,WAAW,EAAE,UAAU,uBAAuB,CAAC;AAC3F,WAAO;AAAA,EACT;AACA,SAAO,SAAS,SAAS;AAC3B;AAEA,eAAsB,YAAY,MAAgC;AAChE,MAAI;AACF,UAAM,IAAI,MAAM,KAAK,IAAI;AACzB,WAAO,EAAE,YAAY;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWA,eAAsB,kBACpB,WACA,WACA,SACiB;AACjB,QAAM,OAAO,QAAQ,eAAe,UAAU,MAAM,GAAG,CAAC,QAAQ,SAAS,EAAE,MAAM,IAAI,QAAQ,eAAe;AAE5G,MAAI,CAAC,UAAW,QAAO;AAEvB,MAAI,QAAQ,kBAAmB,MAAM,YAAY,SAAS,GAAI;AAC5D,UAAM,WAAW,KAAK,MAAM,GAAG,EAAE,IAAI,KAAK;AAC1C,WAAO,KAAK,WAAW,QAAQ;AAAA,EACjC;AACA,SAAO;AACT;AAMA,eAAsB,YAAY,YAAoB,MAA6B;AACjF,QAAM,WAAW,QAAQ,UAAU;AACnC,QAAM,MAAM,QAAQ,QAAQ;AAC5B,QAAM,MAAM,KAAK,KAAK,gBAAgB,YAAY,CAAC,EAAE,SAAS,KAAK,CAAC,MAAM;AAC1E,QAAM,UAAU,KAAK,IAAI;AACzB,QAAM,OAAO,KAAK,QAAQ;AAC5B;","names":[]}

package/dist/chunk-W4SA4CMR.js

@@ -0,0 +1,296 @@
+import {
+  DIRECT_ROUTE,
+  captureProxyCredentials,
+  childEnvWith,
+  plannedRoutes,
+  shouldEscalate
+} from "./chunk-I4FTS5EE.js";
+
+// src/lib/vimeoCookie.ts
+import { writeFile } from "fs/promises";
+import path from "path";
+var COOKIE_NAME = "vimeo";
+async function writeVimeoCookieFile(cookie, workDir) {
+  const value = cookie?.trim();
+  if (!value) return void 0;
+  const expires = Math.floor(Date.now() / 1e3) + 365 * 24 * 60 * 60;
+  const jar = [
+    "# Netscape HTTP Cookie File",
+    [".vimeo.com", "TRUE", "/", "TRUE", String(expires), COOKIE_NAME, value].join("	"),
+    ""
+  ].join("\n");
+  const filePath = path.join(workDir, "vimeo-cookies.txt");
+  await writeFile(filePath, jar, { mode: 384 });
+  return filePath;
+}
+var VIMEO_AUTH_SIGNATURES = ["oauth token", "only works when logged-in", "unable to fetch new oauth tokens"];
+function isVimeoAuthFailure(detail) {
+  const haystack = detail.toLowerCase();
+  if (!haystack.includes("[vimeo]")) return false;
+  return VIMEO_AUTH_SIGNATURES.some((signature) => haystack.includes(signature));
+}
+
+// src/lib/ytDlpSignal.ts
+var HTTP_ERROR = /HTTP Error (\d{3})/i;
+var CHALLENGE_PHRASES = [
+  "sign in to confirm you're not a bot",
+  "sign in to confirm you\u2019re not a bot",
+  "confirm you are not a bot",
+  "unusual traffic",
+  "captcha"
+];
+var NOT_A_BLOCK_PHRASES = ["private video", "video unavailable", "members-only", "this video is available to"];
+var PROXY_TUNNEL_FAILURE = /tunnel connection failed: 407|proxy authentication required|http error 407/i;
+function ytDlpBlockSignal(stderr) {
+  const text = stderr.toLowerCase();
+  if (PROXY_TUNNEL_FAILURE.test(stderr)) return { status: 407 };
+  if (NOT_A_BLOCK_PHRASES.some((phrase) => text.includes(phrase))) return {};
+  const status = HTTP_ERROR.exec(stderr);
+  if (status) return { status: Number(status[1]) };
+  if (CHALLENGE_PHRASES.some((phrase) => text.includes(phrase))) return { challenge: true };
+  return {};
+}
+
+// src/lib/ytDlp.ts
+import { spawn } from "child_process";
+import { readdir, readFile } from "fs/promises";
+import path2 from "path";
+
+// src/lib/ytDlpFormat.ts
+function videoFormatArgs(maxResolution) {
+  const sort = maxResolution ? ["-S", `res:${maxResolution}`] : [];
+  return ["--format", "bv*+ba/b", ...sort, "--merge-output-format", "mp4"];
+}
+
+// src/lib/ytDlpPlayerClient.ts
+var YOUTUBE_FALLBACK_CLIENT_ARGS = ["--extractor-args", "youtube:player_client=android"];
+var MEDIA_FETCH_REFUSED = "unable to download video data";
+var YOUTUBE_HOSTS = ["youtube.com", "youtu.be"];
+function isYouTube(url) {
+  let host;
+  try {
+    host = new URL(url).hostname.toLowerCase();
+  } catch {
+    return false;
+  }
+  return YOUTUBE_HOSTS.some((known) => host === known || host.endsWith(`.${known}`));
+}
+function needsPlayerClientRetry(url, stderr) {
+  return isYouTube(url) && stderr.toLowerCase().includes(MEDIA_FETCH_REFUSED);
+}
+
+// src/lib/ytDlp.ts
+var YT_DLP_BIN = "yt-dlp";
+var YT_DLP_TIMEOUT_MS = 10 * 60 * 1e3;
+var YT_DLP_PROBE_TIMEOUT_MS = 60 * 1e3;
+var TRUST_SYSTEM_CERTS = ["--compat-options", "no-certifi"];
+var YtDlpError = class extends Error {
+  constructor(message, stderrTail) {
+    super(message);
+    this.stderrTail = stderrTail;
+    this.name = "YtDlpError";
+  }
+};
+function tail(text, maxLines) {
+  return text.split("\n").slice(-maxLines).join("\n");
+}
+async function runYtDlp(args) {
+  const outTemplate = path2.join(args.workDir, "out.%(ext)s");
+  const infoPath = path2.join(args.workDir, "out.info.json");
+  const argv = [
+    args.url,
+    "--no-playlist",
+    "--no-progress",
+    "--no-warnings",
+    "--quiet",
+    "--write-info-json",
+    ...TRUST_SYSTEM_CERTS,
+    "-o",
+    outTemplate
+  ];
+  if (args.audioOnly) {
+    argv.push("-x", "--audio-format", "m4a");
+  } else {
+    argv.push(...videoFormatArgs(args.maxHeight));
+  }
+  const cookieFile = await writeVimeoCookieFile(args.vimeoCookie, args.workDir);
+  if (cookieFile) argv.push("--cookies", cookieFile);
+  args.onLog?.(`yt-dlp: downloading ${args.audioOnly ? "audio" : "video"}`);
+  const timeoutMs = args.timeoutMs ?? YT_DLP_TIMEOUT_MS;
+  const { code, stderr, tier, reducedQuality } = await downloadWithClientFallback({
+    url: args.url,
+    argv,
+    onLog: args.onLog,
+    ladder: (attemptArgv) => runViaLadder({ url: args.url, argv: attemptArgv, timeoutMs, onLog: args.onLog, country: args.country }),
+    repeat: (attemptArgv, route) => spawnAndWait(YT_DLP_BIN, attemptArgv, timeoutMs, { extraEnv: proxyEnvFor(route) })
+  });
+  if (code !== 0) {
+    throw new YtDlpError(`yt-dlp exited ${code}`, tail(stderr, 40));
+  }
+  const files = await readdir(args.workDir);
+  const wanted = args.audioOnly ? ".m4a" : ".mp4";
+  const downloaded = files.find((f) => f.startsWith("out.") && f.endsWith(wanted));
+  if (!downloaded) {
+    throw new YtDlpError(`yt-dlp finished but produced no ${wanted} file (saw: ${files.join(", ")})`, "");
+  }
+  let info = {};
+  try {
+    info = JSON.parse(await readFile(infoPath, "utf-8"));
+  } catch {
+  }
+  return { filePath: path2.join(args.workDir, downloaded), info, tier, reducedQuality };
+}
+async function probeYtDlp(args) {
+  const argv = [
+    args.url,
+    "--no-playlist",
+    "--no-warnings",
+    "--dump-single-json",
+    "--skip-download",
+    // Without this the probe fails wherever the *download* would fail, which
+    // defeats the point of probing: yt-dlp still runs format selection for
+    // `--dump-single-json`, so a binary too old to read a site's format list
+    // exits "Requested format is not available" and we learn nothing — measured
+    // against a stale build, which returned full metadata the moment this flag
+    // was added. Duration and id come from the page, not from a format.
+    "--ignore-no-formats-error",
+    ...TRUST_SYSTEM_CERTS
+  ];
+  if (args.cookieDir) {
+    const cookieFile = await writeVimeoCookieFile(args.vimeoCookie, args.cookieDir);
+    if (cookieFile) argv.push("--cookies", cookieFile);
+  }
+  let stdout = "";
+  const { code, stderr, tier } = await walkYtDlpLadder({
+    url: args.url,
+    credentials: captureProxyCredentials(),
+    attempt: async (route) => {
+      const result = await spawnAndWait(YT_DLP_BIN, argv, args.timeoutMs ?? YT_DLP_PROBE_TIMEOUT_MS, {
+        extraEnv: proxyEnvFor(route),
+        captureStdout: true
+      });
+      stdout = result.stdout ?? "";
+      return result;
+    },
+    onLog: args.onLog,
+    country: args.country
+  });
+  if (code !== 0) {
+    throw new YtDlpError(`yt-dlp exited ${code}`, tail(stderr, 40));
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(stdout);
+  } catch {
+    throw new YtDlpError("yt-dlp returned metadata that could not be read", tail(stdout, 5));
+  }
+  if (parsed === null || typeof parsed !== "object") {
+    throw new YtDlpError("yt-dlp returned no metadata for that link", tail(stderr, 40));
+  }
+  return { info: parsed, tier };
+}
+function isAudioOnly(info) {
+  return info.vcodec === "none";
+}
+function durationSeconds(info) {
+  const raw = info.duration;
+  return typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : void 0;
+}
+function canonicalUrl(info) {
+  const raw = info.webpage_url;
+  return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+}
+async function walkYtDlpLadder(args) {
+  const routes = plannedRoutes(args.url, args.credentials, args.country ? { country: args.country } : void 0);
+  let last = { code: -1, stderr: "", tier: "direct", route: DIRECT_ROUTE };
+  for (const route of routes) {
+    const tier = route.kind === "proxy" ? route.tier : "direct";
+    if (route.kind === "proxy") args.onLog?.(`yt-dlp: retrying via ${tier}`);
+    last = { ...await args.attempt(route), tier, route };
+    if (last.code === 0) return last;
+    if (!shouldEscalate(ytDlpBlockSignal(last.stderr))) return last;
+  }
+  return last;
+}
+async function downloadWithClientFallback(args) {
+  const first = await args.ladder(args.argv);
+  if (first.code === 0 || !needsPlayerClientRetry(args.url, first.stderr)) {
+    return { ...first, reducedQuality: false };
+  }
+  args.onLog?.("yt-dlp: retrying with the fallback player client");
+  const again = await args.repeat([...args.argv, ...YOUTUBE_FALLBACK_CLIENT_ARGS], first.route);
+  return { ...again, tier: first.tier, route: first.route, reducedQuality: again.code === 0 };
+}
+function runViaLadder(args) {
+  return walkYtDlpLadder({
+    url: args.url,
+    credentials: captureProxyCredentials(),
+    attempt: (route) => spawnAndWait(YT_DLP_BIN, args.argv, args.timeoutMs, { extraEnv: proxyEnvFor(route) }),
+    onLog: args.onLog,
+    country: args.country
+  });
+}
+function proxyEnvFor(route) {
+  if (route.kind !== "proxy") return void 0;
+  const uri = new URL(route.server);
+  uri.username = encodeURIComponent(route.username);
+  uri.password = encodeURIComponent(route.password);
+  return {
+    HTTP_PROXY: uri.toString(),
+    HTTPS_PROXY: uri.toString(),
+    http_proxy: uri.toString(),
+    https_proxy: uri.toString()
+  };
+}
+function spawnAndWait(bin, argv, timeoutMs, options = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(bin, argv, {
+      stdio: ["ignore", "pipe", "pipe"],
+      // `childEnvWith` because `spawn`'s `env` REPLACES the environment rather
+      // than extending it — passing only the additions would strip PATH.
+      ...options.extraEnv ? { env: childEnvWith(options.extraEnv) } : {}
+    });
+    const stderrChunks = [];
+    const stdoutChunks = [];
+    let stderrLen = 0;
+    const MAX_STDERR = 256 * 1024;
+    child.stdout.on("data", (chunk) => {
+      if (options.captureStdout) stdoutChunks.push(chunk);
+    });
+    child.stderr.on("data", (chunk) => {
+      if (stderrLen < MAX_STDERR) {
+        stderrChunks.push(chunk);
+        stderrLen += chunk.length;
+      }
+    });
+    const timer = setTimeout(() => {
+      child.kill("SIGKILL");
+      reject(new Error(`${bin} timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+    child.on("error", (err) => {
+      clearTimeout(timer);
+      reject(new Error(`failed to spawn "${bin}" \u2014 ${err.message}`));
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve({
+        code: code ?? -1,
+        stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+        ...options.captureStdout ? { stdout: Buffer.concat(stdoutChunks).toString("utf-8") } : {}
+      });
+    });
+  });
+}
+
+export {
+  isVimeoAuthFailure,
+  ytDlpBlockSignal,
+  YT_DLP_BIN,
+  YtDlpError,
+  runYtDlp,
+  probeYtDlp,
+  isAudioOnly,
+  durationSeconds,
+  canonicalUrl
+};
+//# sourceMappingURL=chunk-W4SA4CMR.js.map