@koda-sl/baker-cli 0.500.0 → 0.501.0-dev.6e96f50b9

package/dist/demographics-YI2WM4HS.js

@@ -0,0 +1,139 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-SGU5L5JS.js";
+import {
+  writeAdsJson
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/demographics.ts
+import { defineCommand } from "citty";
+var DEFAULT_PIVOTS = ["job-title", "company", "industry", "seniority", "job-function", "company-size"];
+function numberOf(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : 0;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+  }
+  return 0;
+}
+function topByImpressions(rows, limit) {
+  return [...rows].sort((a, b) => numberOf(b.impressions) - numberOf(a.impressions)).slice(0, limit);
+}
+var demographicsCommand = defineCommand({
+  meta: {
+    name: "demographics",
+    description: `Sweep all firmographic pivots in one command \u2014 LinkedIn's superpower.
+
+Default pivots:
+  job-title, company, industry, seniority, job-function, company-size
+
+Use --pivots to narrow the sweep. Output is one section per pivot, each with
+top-N rows by impressions (configurable via --top-n).
+
+Demographic data is delayed 12-24h with a \u22653-event privacy floor \u2014 small
+buckets are silently dropped. The CLI surfaces this in 'warnings' when the
+result set comes back unexpectedly empty.
+
+Examples:
+  baker ads linkedin demographics --campaign-id 1234
+  baker ads linkedin demographics --campaign-id 1234 --pivots job-title,company
+  baker ads linkedin demographics --campaign-id 1234 --last-days 30 --top-n 25`
+  },
+  args: {
+    "campaign-id": { type: "string", description: "Comma-separated campaign IDs (required)" },
+    pivots: { type: "string", description: `CSV of pivots (default: ${DEFAULT_PIVOTS.join(",")})` },
+    "top-n": { type: "string", description: "Top rows per pivot (default: 10)" },
+    intent: { type: "string", description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)" },
+    start: { type: "string", description: "Start date YYYY-MM-DD" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const fmt = csvOrJson(args);
+    if (fmt !== "json") {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "UNSUPPORTED_FORMAT",
+          message: "demographics returns a structured per-pivot report \u2014 only --output json supported."
+        }
+      });
+      process.exit(1);
+    }
+    const campaignIdsRaw = args["campaign-id"];
+    if (!campaignIdsRaw) {
+      handleLinkedinError(new Error("--campaign-id is required (CSV for multi)."));
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const pivotsRaw = args.pivots?.split(",").map((s) => s.trim().toLowerCase());
+    const pivots = pivotsRaw && pivotsRaw.length > 0 ? pivotsRaw : DEFAULT_PIVOTS;
+    const topN = args["top-n"] ? Number(args["top-n"]) : 10;
+    const intent = args.intent ?? "baseline";
+    const { start, end } = resolveRange(args);
+    try {
+      const results = [];
+      for (const pivot of pivots) {
+        const data = await apiPost("/api/ads/linkedin/analytics", {
+          request: {
+            level: "campaign",
+            ids,
+            intent,
+            pivot,
+            start,
+            end,
+            granularity: "ALL",
+            limit: 500
+          },
+          skipCache: Boolean(args["no-cache"])
+        });
+        results.push({ pivot, rows: topByImpressions(data.rows, topN), warnings: data.warnings });
+      }
+      writeAdsJson({
+        ok: true,
+        data: {
+          query: { campaigns: ids, start, end, intent, topN },
+          pivots: results
+        }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+function resolveRange(args) {
+  const start = args.start;
+  const end = args.end;
+  if (start) {
+    return { start, end };
+  }
+  const days = args["last-days"] ? Number(args["last-days"]) : 30;
+  if (!Number.isFinite(days) || days < 1) {
+    handleLinkedinError(new Error("Invalid --last-days; must be a positive integer."));
+  }
+  return { start: daysAgoIso(days), end: todayIso() };
+}
+export {
+  demographicsCommand
+};
+//# sourceMappingURL=demographics-YI2WM4HS.js.map

package/dist/discard-PJNIC22V.js

@@ -0,0 +1,67 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-4IYLTR6P.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/discard.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.discard",
+  description: "Stage discard of an action \u2014 no claim needed; retire any action you're not working on. Applies on chat publish. Blocked only if another chat currently has it claimed.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true },
+    reason: { type: "string", description: "Optional reason", required: false }
+  }
+});
+var discardCommand = defineCommand({
+  meta: {
+    name: "discard",
+    description: 'Stage discard of an action (no claim needed). Example: baker actions discard <id> --reason "obsolete"'
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false },
+    reason: { type: "string", description: "Reason for discarding", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      await apiPost("/api/actions/discard", {
+        chatId,
+        actionId: id,
+        reason: args.reason
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  discardCommand
+};
+//# sourceMappingURL=discard-PJNIC22V.js.map

package/dist/discover-KXTBNKH3.js

@@ -0,0 +1,172 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-4D5HZ7V3.js";
+import "./chunk-43PAN3L2.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/discover.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.discover",
+  description: 'Discover keyword ideas from seed keywords or URLs. Returns { source: "keyword_planner_estimate", keywords, total_results, next_page_token? }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    seeds: { type: "string", description: "Comma-separated seed keywords (max 10)", required: false },
+    url: { type: "string", description: "URL to extract keyword ideas from", required: false },
+    location: {
+      type: "string",
+      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    limit: { type: "string", description: "Max keyword ideas (default: 20, max: 100)", required: false, default: 20 },
+    cursor: {
+      type: "string",
+      description: "Pagination cursor from previous response (next_page_token)",
+      required: false
+    },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function stampDiscoverResponse(data) {
+  return { ...data, source: PLANNER_SOURCE, keywords: stampPlannerRows(data.keywords ?? []) };
+}
+function buildDiscoverBody(customerId, args) {
+  const body = {
+    customerId,
+    pageSize: args.limit ? Number(args.limit) : 20
+  };
+  const managerId = getManagerIdForCustomer(customerId);
+  if (managerId) body.managerId = managerId;
+  const seeds = args.seeds ? args.seeds.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+  if (seeds) body.seeds = seeds;
+  if (args.url) body.url = args.url;
+  if (args.location) body.locationIds = [args.location];
+  if (args.language) body.languageId = args.language;
+  if (args.cursor) body.pageToken = args.cursor;
+  return body;
+}
+function handleKeywordError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: err.code === "RATE_LIMITED"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var discoverCommand = defineCommand({
+  meta: {
+    name: "discover",
+    description: `Discover new keyword ideas from seed keywords or competitor URLs.
+
+Returns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.
+
+Examples:
+  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes,athletic footwear"
+  baker ads google keywords discover --customer-id 1234567890 --url "https://competitor.com"
+  baker ads google keywords discover --customer-id 1234567890 --seeds "seo tools" --location 2826 --limit 50`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    seeds: { type: "string", description: "Comma-separated seed keywords", required: false },
+    url: { type: "string", description: "URL to extract ideas from", required: false },
+    location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+    language: { type: "string", description: "Language ID (default 1000)", required: false },
+    limit: { type: "string", description: "Max results (default 20)", required: false },
+    cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const queryContext = buildAdsQueryContext(args.location, args.language);
+    if (!args.seeds && !args.url) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Provide --seeds or --url (at least one required)" }
+      });
+      process.exit(1);
+    }
+    const body = buildDiscoverBody(customerId, args);
+    const useCache = !args["no-cache"] && !args.cursor;
+    if (!useCache) body.skipCache = true;
+    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("keywords", cacheKey);
+      if (cached) {
+        warnDefaults(queryContext);
+        writeAdsJson({ ok: true, data: stampDiscoverResponse(cached.data), cached: true, query_context: queryContext });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/google/keywords/discover", body);
+      if (useCache) {
+        cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      warnDefaults(queryContext);
+      const stamped = stampDiscoverResponse(data);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(stamped.keywords, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });
+    } catch (err) {
+      handleKeywordError(err);
+    }
+  }
+});
+export {
+  discoverCommand,
+  stampDiscoverResponse
+};
+//# sourceMappingURL=discover-KXTBNKH3.js.map

package/dist/domain-GJUNOEFM.js

@@ -0,0 +1,99 @@
+import {
+  failSite
+} from "./chunk-4SATGZL3.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/site/domain.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "site.domain.add",
+  description: "Stage connecting a custom domain (a subdomain such as shop.acme.com \u2014 not the bare acme.com) to the company's landings. Applies when the chat is published; then Baker starts verifying it. The client must add a CNAME record pointing the hostname at customers.withbaker.com \u2014 the response's hints give the exact record to ask for. Refused at once when another company already registered it or the company is at its domain limit.",
+  args: { hostname: { type: "string", description: "The subdomain to connect, e.g. shop.acme.com", required: true } }
+});
+registerSchema({
+  command: "site.domain.list",
+  description: "Every custom domain of the company and its status: pending_verification (waiting for the DNS record \u2014 `message` says what is missing), active (live), error, or staged (this chat adds it at publish). Read-only.",
+  args: {}
+});
+registerSchema({
+  command: "site.domain.verify",
+  description: "Re-check a domain that is waiting for verification now instead of waiting for the background check (every few minutes). Use after the client says they added the DNS record. Returns its state and, if it is not live yet, what is still missing. A staged domain cannot be checked until the chat is published.",
+  args: { hostname: { type: "string", description: "A domain from `baker site domain list`", required: true } }
+});
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Stage connecting a custom domain; applies at publish. The client adds a CNAME to customers.withbaker.com.\n\nExample: baker site domain add shop.acme.com"
+  },
+  args: { hostname: { type: "positional", description: "Subdomain, e.g. shop.acme.com", required: true } },
+  run: async ({ args }) => {
+    try {
+      const body = {
+        chatId: requireChatId(),
+        inputs: [{ setting: "customDomain", hostname: String(args.hostname) }]
+      };
+      writeJson(await apiPost("/api/site/stage", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the company's custom domains and what each is waiting for.\n\nExample: baker site domain list"
+  },
+  run: async () => {
+    try {
+      const chatId = optionalChatId();
+      writeJson(await apiGet("/api/site/domains", chatId ? { chatId } : void 0));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var verifyCommand = defineCommand({
+  meta: {
+    name: "verify",
+    description: "Re-check a pending domain now, e.g. right after the client added the DNS record.\n\nExample: baker site domain verify shop.acme.com"
+  },
+  args: { hostname: { type: "positional", description: "A domain from `baker site domain list`", required: true } },
+  run: async ({ args }) => {
+    try {
+      const body = { hostname: String(args.hostname) };
+      writeJson(await apiPost("/api/site/domains/verify", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var domainCommand = defineCommand({
+  meta: {
+    name: "domain",
+    description: "Custom domains for the company's landings. Subcommands: add (staged until publish), list, verify.\n\nExamples:\n  baker site domain add shop.acme.com\n  baker site domain list\n  baker site domain verify shop.acme.com"
+  },
+  subCommands: { add: addCommand, list: listCommand, verify: verifyCommand }
+});
+export {
+  domainCommand
+};
+//# sourceMappingURL=domain-GJUNOEFM.js.map

package/dist/download-XQBBVHO2.js

@@ -0,0 +1,170 @@
+import {
+  videosDownloadResponseSchema
+} from "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  ApiError,
+  apiPost,
+  validateConvexId
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/download.ts
+import { mkdir, open, rm, stat } from "fs/promises";
+import path from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+import { defineCommand } from "citty";
+var DEFAULT_TIMEOUT_SECONDS = 20 * 60;
+var POLL_INTERVAL_MS = 1e4;
+registerSchema({
+  command: "videos.download",
+  description: "Save a library video (one from `videos search`, or one the user attached in chat) as a local .mp4 to edit with ffmpeg or a canvas ingest node. Waits while the file is prepared.",
+  args: {
+    id: { type: "string", description: "Library video ID", required: true },
+    out: { type: "string", description: "Directory to write the file into (created if missing)", required: true },
+    "timeout-seconds": {
+      type: "string",
+      description: `How long to wait for the file to be prepared (default ${DEFAULT_TIMEOUT_SECONDS})`,
+      required: false
+    }
+  }
+});
+async function awaitDownloadUrl(ask, options) {
+  const deadline = options.now() + options.timeoutMs;
+  for (; ; ) {
+    const answer = await ask();
+    if (answer.status === "ready") return { ready: true, url: answer.url, filename: answer.filename };
+    if (options.now() + options.intervalMs > deadline) return { ready: false, lastStatus: answer.status };
+    await options.sleep(options.intervalMs);
+  }
+}
+async function saveVideoFile(url, outDir, filename) {
+  await mkdir(outDir, { recursive: true });
+  const { name: stem, ext } = path.parse(path.basename(filename));
+  for (let n = 1; ; n++) {
+    const file = path.join(outDir, `${stem}${n === 1 ? "" : `-${n}`}${ext || ".mp4"}`);
+    let handle;
+    try {
+      handle = await open(file, "wx");
+    } catch (err) {
+      if (err instanceof Error && "code" in err && err.code === "EEXIST") continue;
+      throw err;
+    }
+    try {
+      const response = await fetch(url);
+      if (!response.ok || !response.body)
+        throw new Error(`The video file could not be fetched (HTTP ${response.status})`);
+      await pipeline(Readable.fromWeb(response.body), handle.createWriteStream());
+    } catch (err) {
+      await handle.close().catch(() => void 0);
+      await rm(file, { force: true });
+      throw err;
+    }
+    return { file, bytes: (await stat(file)).size };
+  }
+}
+async function downloadLibraryVideo(args, deps) {
+  let wait;
+  try {
+    wait = await awaitDownloadUrl(deps.ask, { timeoutMs: args.timeoutMs, intervalMs: args.intervalMs, ...deps });
+  } catch (err) {
+    if (!(err instanceof ApiError)) throw err;
+    const fix = err.fix ?? (err.code === "CONFLICT" ? {
+      action: "continue_without",
+      explanation: "Tell the user why this video cannot be used and carry on without it."
+    } : void 0);
+    return { ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } };
+  }
+  if (!wait.ready) {
+    return {
+      ok: false,
+      error: {
+        code: "TIMEOUT",
+        message: wait.lastStatus === "processing" ? "The video is still being uploaded to the library." : "The library is still preparing a downloadable file of this video.",
+        fix: {
+          action: "wait_and_retry",
+          explanation: "Tell the user the video is still being prepared, carry on with the rest of the job, and run this command again in a few minutes. Do not abort the whole job."
+        }
+      }
+    };
+  }
+  try {
+    const saved = await saveVideoFile(wait.url, path.resolve(args.out), wait.filename);
+    return {
+      ok: true,
+      data: saved,
+      hints: [
+        `Edit ${saved.file} with ffprobe/ffmpeg, or feed it to a canvas ingest node as { source: "path", path, expect: "video" }. The library video is unchanged.`
+      ]
+    };
+  } catch (err) {
+    return {
+      ok: false,
+      error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : String(err) }
+    };
+  }
+}
+function positiveInt(value) {
+  const parsed = typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
+}
+var downloadCommand = defineCommand({
+  meta: {
+    name: "download",
+    description: "Save a library video as a local .mp4 so you can edit it (ffmpeg, canvas ingest node). Use it for a video the user attached in chat, or one found with `videos search`. Waits up to 20 minutes while the file is prepared.\n\nExample: baker videos download j571abc123def --out /tmp/clips"
+  },
+  args: {
+    id: { type: "positional", description: "Library video ID", required: true },
+    out: { type: "string", description: "Directory to write the file into", required: true },
+    "timeout-seconds": {
+      type: "string",
+      description: `How long to wait for the file (default ${DEFAULT_TIMEOUT_SECONDS})`,
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    const id = String(args.id ?? "");
+    try {
+      validateConvexId(id);
+    } catch (err) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: err instanceof Error ? err.message : "Invalid video ID" }
+      });
+      process.exit(1);
+    }
+    const result = await downloadLibraryVideo(
+      {
+        id,
+        out: String(args.out ?? ""),
+        timeoutMs: (positiveInt(args["timeout-seconds"]) ?? DEFAULT_TIMEOUT_SECONDS) * 1e3,
+        intervalMs: POLL_INTERVAL_MS
+      },
+      {
+        ask: async () => videosDownloadResponseSchema.parse(await apiPost("/api/videos/download", { id })),
+        now: Date.now,
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+      }
+    );
+    writeJson(result);
+    if (!result.ok) process.exit(1);
+  }
+});
+export {
+  awaitDownloadUrl,
+  downloadCommand,
+  downloadLibraryVideo,
+  saveVideoFile
+};
+//# sourceMappingURL=download-XQBBVHO2.js.map

package/dist/download-XQBBVHO2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/videos/download.ts"],"sourcesContent":["import { mkdir, open, rm, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport { type VideosDownloadResponse, videosDownloadResponseSchema } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, type ApiErrorFix, apiPost, type ErrorCode, validateConvexId } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nconst DEFAULT_TIMEOUT_SECONDS = 20 * 60;\nconst POLL_INTERVAL_MS = 10_000;\n\nregisterSchema({\n  command: \"videos.download\",\n  description:\n    \"Save a library video (one from `videos search`, or one the user attached in chat) as a local .mp4 to edit with ffmpeg or a canvas ingest node. Waits while the file is prepared.\",\n  args: {\n    id: { type: \"string\", description: \"Library video ID\", required: true },\n    out: { type: \"string\", description: \"Directory to write the file into (created if missing)\", required: true },\n    \"timeout-seconds\": {\n      type: \"string\",\n      description: `How long to wait for the file to be prepared (default ${DEFAULT_TIMEOUT_SECONDS})`,\n      required: false,\n    },\n  },\n});\n\ntype Clock = { now: () => number; sleep: (ms: number) => Promise<void> };\n\nexport type DownloadUrlWait =\n  | { ready: true; url: string; filename: string }\n  | { ready: false; lastStatus: \"preparing\" | \"processing\" };\n\n/**\n * Ask the library for the video's file until it has one or the budget runs out.\n * The first ask may start Mux encoding it, which takes minutes for a long clip.\n */\nexport async function awaitDownloadUrl(\n  ask: () => Promise<VideosDownloadResponse>,\n  options: { timeoutMs: number; intervalMs: number } & Clock,\n): Promise<DownloadUrlWait> {\n  const deadline = options.now() + options.timeoutMs;\n  for (;;) {\n    const answer = await ask();\n    if (answer.status === \"ready\") return { ready: true, url: answer.url, filename: answer.filename };\n    if (options.now() + options.intervalMs > deadline) return { ready: false, lastStatus: answer.status };\n    await options.sleep(options.intervalMs);\n  }\n}\n\n/**\n * Stream the file at `url` into `outDir` as `filename`, or `<stem>-2.mp4` and\n * so on when that name is taken — never over a file already there. Streamed\n * to disk, never held in memory: a library video can be gigabytes.\n */\nexport async function saveVideoFile(\n  url: string,\n  outDir: string,\n  filename: string,\n): Promise<{ file: string; bytes: number }> {\n  await mkdir(outDir, { recursive: true });\n  const { name: stem, ext } = path.parse(path.basename(filename));\n  for (let n = 1; ; n++) {\n    const file = path.join(outDir, `${stem}${n === 1 ? \"\" : `-${n}`}${ext || \".mp4\"}`);\n    let handle: Awaited<ReturnType<typeof open>>;\n    try {\n      handle = await open(file, \"wx\");\n    } catch (err) {\n      if (err instanceof Error && \"code\" in err && err.code === \"EEXIST\") continue;\n      throw err;\n    }\n    try {\n      const response = await fetch(url);\n      if (!response.ok || !response.body)\n        throw new Error(`The video file could not be fetched (HTTP ${response.status})`);\n      await pipeline(Readable.fromWeb(response.body as WebReadableStream<Uint8Array>), handle.createWriteStream());\n    } catch (err) {\n      await handle.close().catch(() => undefined);\n      await rm(file, { force: true });\n      throw err;\n    }\n    return { file, bytes: (await stat(file)).size };\n  }\n}\n\ntype DownloadResult =\n  | { ok: true; data: { file: string; bytes: number }; hints: string[] }\n  | { ok: false; error: { code: ErrorCode | \"DOWNLOAD_FAILED\"; message: string; fix?: ApiErrorFix } };\n\n/** Wait for the library's file, then save it: the whole command, minus argv and stdout. */\nexport async function downloadLibraryVideo(\n  args: { id: string; out: string; timeoutMs: number; intervalMs: number },\n  deps: { ask: () => Promise<VideosDownloadResponse> } & Clock,\n): Promise<DownloadResult> {\n  let wait: DownloadUrlWait;\n  try {\n    wait = await awaitDownloadUrl(deps.ask, { timeoutMs: args.timeoutMs, intervalMs: args.intervalMs, ...deps });\n  } catch (err) {\n    if (!(err instanceof ApiError)) throw err;\n    const fix =\n      err.fix ??\n      (err.code === \"CONFLICT\"\n        ? {\n            action: \"continue_without\",\n            explanation: \"Tell the user why this video cannot be used and carry on without it.\",\n          }\n        : undefined);\n    return { ok: false, error: { code: err.code, message: err.message, ...(fix ? { fix } : {}) } };\n  }\n  if (!wait.ready) {\n    return {\n      ok: false,\n      error: {\n        code: \"TIMEOUT\",\n        message:\n          wait.lastStatus === \"processing\"\n            ? \"The video is still being uploaded to the library.\"\n            : \"The library is still preparing a downloadable file of this video.\",\n        fix: {\n          action: \"wait_and_retry\",\n          explanation:\n            \"Tell the user the video is still being prepared, carry on with the rest of the job, and run this command again in a few minutes. Do not abort the whole job.\",\n        },\n      },\n    };\n  }\n  try {\n    const saved = await saveVideoFile(wait.url, path.resolve(args.out), wait.filename);\n    return {\n      ok: true,\n      data: saved,\n      hints: [\n        `Edit ${saved.file} with ffprobe/ffmpeg, or feed it to a canvas ingest node as { source: \"path\", path, expect: \"video\" }. The library video is unchanged.`,\n      ],\n    };\n  } catch (err) {\n    return {\n      ok: false,\n      error: { code: \"DOWNLOAD_FAILED\", message: err instanceof Error ? err.message : String(err) },\n    };\n  }\n}\n\nfunction positiveInt(value: unknown): number | undefined {\n  const parsed = typeof value === \"string\" ? Number.parseInt(value, 10) : Number.NaN;\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;\n}\n\nexport const downloadCommand = defineCommand({\n  meta: {\n    name: \"download\",\n    description:\n      \"Save a library video as a local .mp4 so you can edit it (ffmpeg, canvas ingest node). Use it for a video the user attached in chat, or one found with `videos search`. Waits up to 20 minutes while the file is prepared.\\n\\nExample: baker videos download j571abc123def --out /tmp/clips\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"Library video ID\", required: true },\n    out: { type: \"string\", description: \"Directory to write the file into\", required: true },\n    \"timeout-seconds\": {\n      type: \"string\",\n      description: `How long to wait for the file (default ${DEFAULT_TIMEOUT_SECONDS})`,\n      required: false,\n    },\n  },\n  run: async ({ args }) => {\n    const id = String(args.id ?? \"\");\n    try {\n      validateConvexId(id);\n    } catch (err) {\n      writeJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: err instanceof Error ? err.message : \"Invalid video ID\" },\n      });\n      process.exit(1);\n    }\n    const result = await downloadLibraryVideo(\n      {\n        id,\n        out: String(args.out ?? \"\"),\n        timeoutMs: (positiveInt(args[\"timeout-seconds\"]) ?? DEFAULT_TIMEOUT_SECONDS) * 1000,\n        intervalMs: POLL_INTERVAL_MS,\n      },\n      {\n        ask: async () => videosDownloadResponseSchema.parse(await apiPost<unknown>(\"/api/videos/download\", { id })),\n        now: Date.now,\n        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),\n      },\n    );\n    writeJson(result);\n    if (!result.ok) process.exit(1);\n  },\n});\n"],"mappings":"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","names":[]}