@koda-sl/baker-cli 0.386.0-dev.4e118c09a → 0.386.0-dev.d6e55699d

package/dist/job-E2U4FS5P.js

@@ -0,0 +1,202 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-G7AFVTUS.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/job.ts
+import { gunzipSync } from "zlib";
+import { defineCommand } from "citty";
+var POLL_INTERVAL_MS = 1e4;
+var DEADLINE_MS = 12 * 60 * 1e3;
+var RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
+registerSchema({
+  command: "ads.x.statsJob",
+  description: "Asynchronous X Ads stats job, fully synchronous from the CLI's perspective. Creates the job, polls every 10s, downloads + decompresses the gzip result, returns inline JSON. Hard deadline 12 min \u2014 must run in the background. Use this for ranges >7 days, segmented stats, or any query that hits sync limits. For fine-grained control, use `stats job-create` + `stats job-status` separately.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs (max 20)", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    granularity: { type: "string", description: "TOTAL | DAY | HOUR", required: false },
+    "metric-groups": { type: "string", description: "CSV of metric groups", required: true },
+    placement: { type: "string", description: "ALL_ON_TWITTER | PUBLISHER_NETWORK", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation (e.g. AGE, GENDER, LOCATIONS)", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip result cache (still does the live job)", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function downloadAndDecompress(url) {
+  const res = await fetch(url, { signal: AbortSignal.timeout(6e4) });
+  if (!res.ok) {
+    throw new ApiError("INTERNAL_ERROR", `Stats job download failed (${res.status})`);
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+  const decompressed = gunzipSync(buf);
+  return JSON.parse(decompressed.toString("utf-8"));
+}
+async function pollUntilDone(accountId, jobId) {
+  const deadline = Date.now() + DEADLINE_MS;
+  let lastLog = 0;
+  while (Date.now() < deadline) {
+    await sleep(POLL_INTERVAL_MS);
+    const jobs = await apiGet("/api/ads/x/stats/jobs", {
+      "account-id": accountId,
+      "job-id": jobId
+    });
+    const job = jobs[0];
+    if (!job) {
+      throw new ApiError("NOT_FOUND", `Stats job ${jobId} not found`);
+    }
+    if (job.status === "SUCCESS") {
+      return job;
+    }
+    if (job.status === "FAILED" || job.status === "CANCELLED") {
+      throw new ApiError("INTERNAL_ERROR", `Stats job ${jobId} ended in status ${job.status}`);
+    }
+    const elapsed = DEADLINE_MS - (deadline - Date.now());
+    if (elapsed - lastLog > 3e4) {
+      process.stderr.write(`  polling... (${job.status}, ${Math.round(elapsed / 1e3)}s elapsed)
+`);
+      lastLog = elapsed;
+    }
+  }
+  throw new ApiError("TIMEOUT", `Stats job ${jobId} did not complete within ${DEADLINE_MS / 6e4} minutes`);
+}
+function buildCacheKey(body) {
+  return `stats-job:${JSON.stringify(body)}`;
+}
+var statsJobCommand = defineCommand({
+  meta: {
+    name: "job",
+    description: `Async X Ads stats job, sync from the CLI's perspective. Creates \u2192 polls \u2192 downloads \u2192 returns.
+
+Must run in the background (the harness enforces this).
+
+Use this when:
+  \u2022 Date range > 7 days
+  \u2022 Need segmentation (AGE, GENDER, LOCATIONS, ...)
+  \u2022 Sync stats hit a limit
+
+Examples:
+  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\
+    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING
+
+  baker ads x stats job --account-id 18ce53xyz --entity LINE_ITEM \\
+    --entity-ids abc --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT \\
+    --segmentation-type LOCATIONS
+
+For fine-grained control (don't wait, poll yourself), use:
+  baker ads x stats job-create   \u2014 create + return job ID immediately
+  baker ads x stats job-status   \u2014 poll job status / get download URL`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "Entity type", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs", required: true },
+    "start-time": { type: "string", description: "ISO start", required: true },
+    "end-time": { type: "string", description: "ISO end", required: true },
+    granularity: { type: "string", description: "Granularity", required: false },
+    "metric-groups": { type: "string", description: "Metric groups CSV", required: true },
+    placement: { type: "string", description: "Placement", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation type", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false },
+    "no-cache": { type: "boolean", description: "Skip result cache", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const entityIds = parseCsv(args["entity-ids"]);
+    const metricGroups = parseCsv(args["metric-groups"]);
+    if (!entityIds || !metricGroups) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "MISSING_PARAMETER", message: "entity-ids and metric-groups are required" }
+      });
+      process.exit(1);
+    }
+    const body = {
+      accountId,
+      entity: args.entity,
+      entityIds,
+      startTime: args["start-time"],
+      endTime: args["end-time"],
+      granularity: args.granularity ?? "DAY",
+      metricGroups,
+      placement: args.placement ?? "ALL_ON_TWITTER",
+      segmentationType: args["segmentation-type"],
+      country: args.country,
+      platform: args.platform
+    };
+    const useCache = !args["no-cache"];
+    const cacheKey = buildCacheKey(body);
+    if (useCache) {
+      const cached = cacheGet("x-stats", cacheKey);
+      if (cached) {
+        process.stderr.write("Result served from cache.\n");
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      process.stderr.write(`Creating X Ads stats job for entity=${body.entity}, ${entityIds.length} IDs...
+`);
+      const job = await apiPost("/api/ads/x/stats/jobs", body);
+      process.stderr.write(`Job ${job.id} queued. Polling every ${POLL_INTERVAL_MS / 1e3}s...
+`);
+      const finished = await pollUntilDone(accountId, job.id);
+      if (!finished.url) {
+        throw new ApiError("INTERNAL_ERROR", `Stats job ${job.id} succeeded but returned no download URL`);
+      }
+      process.stderr.write("Job complete. Downloading + decompressing results...\n");
+      const data = await downloadAndDecompress(finished.url);
+      if (useCache) {
+        cacheSet("x-stats", cacheKey, data, RESULT_CACHE_TTL_MS);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({
+        ok: false,
+        error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+export {
+  statsJobCommand
+};
+//# sourceMappingURL=job-E2U4FS5P.js.map

package/dist/job-E2U4FS5P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/stats/job.ts"],"sourcesContent":["import { gunzipSync } from \"node:zlib\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { cacheGet, cacheSet } from \"../../cache.ts\";\nimport { writeAdsJson } from \"../../output.ts\";\nimport { parseXApiError } from \"../error-parser.ts\";\nimport { resolveXAccountId } from \"../output.ts\";\n\nconst POLL_INTERVAL_MS = 10_000;\nconst DEADLINE_MS = 12 * 60 * 1000;\nconst RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1000;\n\nregisterSchema({\n  command: \"ads.x.statsJob\",\n  description:\n    \"Asynchronous X Ads stats job, fully synchronous from the CLI's perspective. Creates the job, polls every 10s, downloads + decompresses the gzip result, returns inline JSON. Hard deadline 12 min — must run in the background. Use this for ranges >7 days, segmented stats, or any query that hits sync limits. For fine-grained control, use `stats job-create` + `stats job-status` separately.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...\", required: true },\n    \"entity-ids\": { type: \"string\", description: \"CSV of entity IDs (max 20)\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO 8601 hour-aligned start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO 8601 hour-aligned end\", required: true },\n    granularity: { type: \"string\", description: \"TOTAL | DAY | HOUR\", required: false },\n    \"metric-groups\": { type: \"string\", description: \"CSV of metric groups\", required: true },\n    placement: { type: \"string\", description: \"ALL_ON_TWITTER | PUBLISHER_NETWORK\", required: false },\n    \"segmentation-type\": { type: \"string\", description: \"Segmentation (e.g. AGE, GENDER, LOCATIONS)\", required: false },\n    country: { type: \"string\", description: \"Country filter\", required: false },\n    platform: { type: \"string\", description: \"Platform filter\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip result cache (still does the live job)\", required: false },\n  },\n});\n\ninterface XStatsJobShape {\n  id: string;\n  status: string;\n  url?: string;\n  expires_at?: string;\n}\n\nfunction parseCsv(v: unknown): string[] | undefined {\n  if (typeof v !== \"string\" || v.length === 0) return undefined;\n  const parts = v\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function downloadAndDecompress(url: string): Promise<unknown> {\n  const res = await fetch(url, { signal: AbortSignal.timeout(60_000) });\n  if (!res.ok) {\n    throw new ApiError(\"INTERNAL_ERROR\", `Stats job download failed (${res.status})`);\n  }\n  const buf = Buffer.from(await res.arrayBuffer());\n  const decompressed = gunzipSync(buf);\n  return JSON.parse(decompressed.toString(\"utf-8\"));\n}\n\nasync function pollUntilDone(accountId: string, jobId: string): Promise<XStatsJobShape> {\n  const deadline = Date.now() + DEADLINE_MS;\n  let lastLog = 0;\n  while (Date.now() < deadline) {\n    await sleep(POLL_INTERVAL_MS);\n    const jobs = await apiGet<XStatsJobShape[]>(\"/api/ads/x/stats/jobs\", {\n      \"account-id\": accountId,\n      \"job-id\": jobId,\n    });\n    const job = jobs[0];\n    if (!job) {\n      throw new ApiError(\"NOT_FOUND\", `Stats job ${jobId} not found`);\n    }\n    if (job.status === \"SUCCESS\") {\n      return job;\n    }\n    if (job.status === \"FAILED\" || job.status === \"CANCELLED\") {\n      throw new ApiError(\"INTERNAL_ERROR\", `Stats job ${jobId} ended in status ${job.status}`);\n    }\n    const elapsed = DEADLINE_MS - (deadline - Date.now());\n    if (elapsed - lastLog > 30_000) {\n      process.stderr.write(`  polling... (${job.status}, ${Math.round(elapsed / 1000)}s elapsed)\\n`);\n      lastLog = elapsed;\n    }\n  }\n  throw new ApiError(\"TIMEOUT\", `Stats job ${jobId} did not complete within ${DEADLINE_MS / 60_000} minutes`);\n}\n\nfunction buildCacheKey(body: Record<string, unknown>): string {\n  return `stats-job:${JSON.stringify(body)}`;\n}\n\nexport const statsJobCommand = defineCommand({\n  meta: {\n    name: \"job\",\n    description: `Async X Ads stats job, sync from the CLI's perspective. Creates → polls → downloads → returns.\n\nMust run in the background (the harness enforces this).\n\nUse this when:\n  • Date range > 7 days\n  • Need segmentation (AGE, GENDER, LOCATIONS, ...)\n  • Sync stats hit a limit\n\nExamples:\n  baker ads x stats job --account-id 18ce53xyz --entity CAMPAIGN \\\\\n    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\\\\n    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING\n\n  baker ads x stats job --account-id 18ce53xyz --entity LINE_ITEM \\\\\n    --entity-ids abc --start-time 2026-04-01T00:00:00Z \\\\\n    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT \\\\\n    --segmentation-type LOCATIONS\n\nFor fine-grained control (don't wait, poll yourself), use:\n  baker ads x stats job-create   — create + return job ID immediately\n  baker ads x stats job-status   — poll job status / get download URL`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"Entity type\", required: true },\n    \"entity-ids\": { type: \"string\", description: \"CSV of entity IDs\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO end\", required: true },\n    granularity: { type: \"string\", description: \"Granularity\", required: false },\n    \"metric-groups\": { type: \"string\", description: \"Metric groups CSV\", required: true },\n    placement: { type: \"string\", description: \"Placement\", required: false },\n    \"segmentation-type\": { type: \"string\", description: \"Segmentation type\", required: false },\n    country: { type: \"string\", description: \"Country filter\", required: false },\n    platform: { type: \"string\", description: \"Platform filter\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip result cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    const entityIds = parseCsv(args[\"entity-ids\"]);\n    const metricGroups = parseCsv(args[\"metric-groups\"]);\n    if (!entityIds || !metricGroups) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"MISSING_PARAMETER\", message: \"entity-ids and metric-groups are required\" },\n      });\n      process.exit(1);\n    }\n\n    const body = {\n      accountId,\n      entity: args.entity as string,\n      entityIds,\n      startTime: args[\"start-time\"] as string,\n      endTime: args[\"end-time\"] as string,\n      granularity: (args.granularity as string | undefined) ?? \"DAY\",\n      metricGroups,\n      placement: (args.placement as string | undefined) ?? \"ALL_ON_TWITTER\",\n      segmentationType: args[\"segmentation-type\"] as string | undefined,\n      country: args.country as string | undefined,\n      platform: args.platform as string | undefined,\n    };\n\n    const useCache = !args[\"no-cache\"];\n    const cacheKey = buildCacheKey(body);\n    if (useCache) {\n      const cached = cacheGet<unknown>(\"x-stats\", cacheKey);\n      if (cached) {\n        process.stderr.write(\"Result served from cache.\\n\");\n        writeAdsJson({ ok: true, data: cached.data, cached: true });\n        return;\n      }\n    }\n\n    try {\n      process.stderr.write(`Creating X Ads stats job for entity=${body.entity}, ${entityIds.length} IDs...\\n`);\n      const job = await apiPost<XStatsJobShape>(\"/api/ads/x/stats/jobs\", body);\n      process.stderr.write(`Job ${job.id} queued. Polling every ${POLL_INTERVAL_MS / 1000}s...\\n`);\n\n      const finished = await pollUntilDone(accountId, job.id);\n      if (!finished.url) {\n        throw new ApiError(\"INTERNAL_ERROR\", `Stats job ${job.id} succeeded but returned no download URL`);\n      }\n\n      process.stderr.write(\"Job complete. Downloading + decompressing results...\\n\");\n      const data = await downloadAndDecompress(finished.url);\n\n      if (useCache) {\n        cacheSet(\"x-stats\", cacheKey, data, RESULT_CACHE_TTL_MS);\n      }\n\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeAdsJson(parseXApiError(err.message, accountId));\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  },\n});\n"],"mappings":"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","names":[]}

package/dist/job-create-DFYCHVQ7.js

@@ -0,0 +1,109 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-G7AFVTUS.js";
+import {
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/job-create.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.statsJobCreate",
+  description: "Create an asynchronous X Ads stats job (range up to 90 days non-segmented, 45 days segmented). Returns a job id; poll with `stats job-status`. Times must be ISO 8601 hour-aligned.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs (max 20)", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    granularity: { type: "string", description: "TOTAL | DAY | HOUR", required: false },
+    "metric-groups": { type: "string", description: "CSV of metric groups", required: true },
+    placement: { type: "string", description: "ALL_ON_TWITTER | PUBLISHER_NETWORK", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation (e.g. AGE, GENDER, LOCATIONS)", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+var statsJobCreateCommand = defineCommand({
+  meta: {
+    name: "job-create",
+    description: `Create an async X Ads stats job (up to 90 days, supports segmentation).
+
+Examples:
+  baker ads x stats job-create --account-id 18ce53xyz --entity CAMPAIGN \\
+    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\
+    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING \\
+    --segmentation-type LOCATIONS`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "Entity type", required: true },
+    "entity-ids": { type: "string", description: "CSV of entity IDs", required: true },
+    "start-time": { type: "string", description: "ISO start", required: true },
+    "end-time": { type: "string", description: "ISO end", required: true },
+    granularity: { type: "string", description: "Granularity", required: false },
+    "metric-groups": { type: "string", description: "Metric groups CSV", required: true },
+    placement: { type: "string", description: "Placement", required: false },
+    "segmentation-type": { type: "string", description: "Segmentation type", required: false },
+    country: { type: "string", description: "Country filter", required: false },
+    platform: { type: "string", description: "Platform filter", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const entityIds = parseCsv(args["entity-ids"]);
+    const metricGroups = parseCsv(args["metric-groups"]);
+    if (!entityIds || !metricGroups) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "MISSING_PARAMETER", message: "entity-ids and metric-groups are required" }
+      });
+      process.exit(1);
+    }
+    const body = {
+      accountId,
+      entity: args.entity,
+      entityIds,
+      startTime: args["start-time"],
+      endTime: args["end-time"],
+      granularity: args.granularity ?? "DAY",
+      metricGroups,
+      placement: args.placement ?? "ALL_ON_TWITTER",
+      segmentationType: args["segmentation-type"],
+      country: args.country,
+      platform: args.platform
+    };
+    try {
+      const data = await apiPost("/api/ads/x/stats/jobs", body);
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  statsJobCreateCommand
+};
+//# sourceMappingURL=job-create-DFYCHVQ7.js.map

package/dist/job-create-DFYCHVQ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/stats/job-create.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { writeAdsJson } from \"../../output.ts\";\nimport { parseXApiError } from \"../error-parser.ts\";\nimport { resolveXAccountId } from \"../output.ts\";\n\nregisterSchema({\n  command: \"ads.x.statsJobCreate\",\n  description:\n    \"Create an asynchronous X Ads stats job (range up to 90 days non-segmented, 45 days segmented). Returns a job id; poll with `stats job-status`. Times must be ISO 8601 hour-aligned.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...\", required: true },\n    \"entity-ids\": { type: \"string\", description: \"CSV of entity IDs (max 20)\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO 8601 hour-aligned start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO 8601 hour-aligned end\", required: true },\n    granularity: { type: \"string\", description: \"TOTAL | DAY | HOUR\", required: false },\n    \"metric-groups\": { type: \"string\", description: \"CSV of metric groups\", required: true },\n    placement: { type: \"string\", description: \"ALL_ON_TWITTER | PUBLISHER_NETWORK\", required: false },\n    \"segmentation-type\": { type: \"string\", description: \"Segmentation (e.g. AGE, GENDER, LOCATIONS)\", required: false },\n    country: { type: \"string\", description: \"Country filter\", required: false },\n    platform: { type: \"string\", description: \"Platform filter\", required: false },\n  },\n});\n\nfunction parseCsv(v: unknown): string[] | undefined {\n  if (typeof v !== \"string\" || v.length === 0) return undefined;\n  const parts = v\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\nexport const statsJobCreateCommand = defineCommand({\n  meta: {\n    name: \"job-create\",\n    description: `Create an async X Ads stats job (up to 90 days, supports segmentation).\n\nExamples:\n  baker ads x stats job-create --account-id 18ce53xyz --entity CAMPAIGN \\\\\n    --entity-ids abc,def --start-time 2026-04-01T00:00:00Z \\\\\n    --end-time 2026-05-01T00:00:00Z --metric-groups ENGAGEMENT,BILLING \\\\\n    --segmentation-type LOCATIONS`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    entity: { type: \"string\", description: \"Entity type\", required: true },\n    \"entity-ids\": { type: \"string\", description: \"CSV of entity IDs\", required: true },\n    \"start-time\": { type: \"string\", description: \"ISO start\", required: true },\n    \"end-time\": { type: \"string\", description: \"ISO end\", required: true },\n    granularity: { type: \"string\", description: \"Granularity\", required: false },\n    \"metric-groups\": { type: \"string\", description: \"Metric groups CSV\", required: true },\n    placement: { type: \"string\", description: \"Placement\", required: false },\n    \"segmentation-type\": { type: \"string\", description: \"Segmentation type\", required: false },\n    country: { type: \"string\", description: \"Country filter\", required: false },\n    platform: { type: \"string\", description: \"Platform filter\", required: false },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    const entityIds = parseCsv(args[\"entity-ids\"]);\n    const metricGroups = parseCsv(args[\"metric-groups\"]);\n    if (!entityIds || !metricGroups) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"MISSING_PARAMETER\", message: \"entity-ids and metric-groups are required\" },\n      });\n      process.exit(1);\n    }\n    const body = {\n      accountId,\n      entity: args.entity as string,\n      entityIds,\n      startTime: args[\"start-time\"] as string,\n      endTime: args[\"end-time\"] as string,\n      granularity: (args.granularity as string | undefined) ?? \"DAY\",\n      metricGroups,\n      placement: (args.placement as string | undefined) ?? \"ALL_ON_TWITTER\",\n      segmentationType: args[\"segmentation-type\"] as string | undefined,\n      country: args.country as string | undefined,\n      platform: args.platform as string | undefined,\n    };\n    try {\n      const data = await apiPost<unknown>(\"/api/ads/x/stats/jobs\", body);\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeAdsJson(parseXApiError(err.message, accountId));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/job-status-FFPMTSHB.js

@@ -0,0 +1,74 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-G7AFVTUS.js";
+import {
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/job-status.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.statsJobStatus",
+  description: "Check the status of one or more X Ads stats jobs. Returns status (PROCESSING|SUCCESS|FAILED) and a downloadable url when SUCCESS. Pass --job-id or --job-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "job-id": { type: "string", description: "Single job ID", required: false },
+    "job-ids": { type: "string", description: "CSV of job IDs", required: false }
+  }
+});
+var statsJobStatusCommand = defineCommand({
+  meta: {
+    name: "job-status",
+    description: `Poll the status of an async X Ads stats job.
+
+Examples:
+  baker ads x stats job-status --account-id 18ce53xyz --job-id abc
+  baker ads x stats job-status --account-id 18ce53xyz --job-ids abc,def`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "job-id": { type: "string", description: "Job ID", required: false },
+    "job-ids": { type: "string", description: "CSV of job IDs", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    if (!args["job-id"] && !args["job-ids"]) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "MISSING_PARAMETER", message: "Pass --job-id or --job-ids" }
+      });
+      process.exit(1);
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["job-id"]) params["job-id"] = args["job-id"];
+      if (args["job-ids"]) params["job-ids"] = args["job-ids"];
+      const data = await apiGet("/api/ads/x/stats/jobs", params);
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  statsJobStatusCommand
+};
+//# sourceMappingURL=job-status-FFPMTSHB.js.map

package/dist/job-status-FFPMTSHB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/stats/job-status.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { ApiError, apiGet } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { writeAdsJson } from \"../../output.ts\";\nimport { parseXApiError } from \"../error-parser.ts\";\nimport { resolveXAccountId } from \"../output.ts\";\n\nregisterSchema({\n  command: \"ads.x.statsJobStatus\",\n  description:\n    \"Check the status of one or more X Ads stats jobs. Returns status (PROCESSING|SUCCESS|FAILED) and a downloadable url when SUCCESS. Pass --job-id or --job-ids (CSV).\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"job-id\": { type: \"string\", description: \"Single job ID\", required: false },\n    \"job-ids\": { type: \"string\", description: \"CSV of job IDs\", required: false },\n  },\n});\n\nexport const statsJobStatusCommand = defineCommand({\n  meta: {\n    name: \"job-status\",\n    description: `Poll the status of an async X Ads stats job.\n\nExamples:\n  baker ads x stats job-status --account-id 18ce53xyz --job-id abc\n  baker ads x stats job-status --account-id 18ce53xyz --job-ids abc,def`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"job-id\": { type: \"string\", description: \"Job ID\", required: false },\n    \"job-ids\": { type: \"string\", description: \"CSV of job IDs\", required: false },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    if (!args[\"job-id\"] && !args[\"job-ids\"]) {\n      writeAdsJson({\n        ok: false,\n        error: { code: \"MISSING_PARAMETER\", message: \"Pass --job-id or --job-ids\" },\n      });\n      process.exit(1);\n    }\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"job-id\"]) params[\"job-id\"] = args[\"job-id\"] as string;\n      if (args[\"job-ids\"]) params[\"job-ids\"] = args[\"job-ids\"] as string;\n      const data = await apiGet<unknown[]>(\"/api/ads/x/stats/jobs\", params);\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeAdsJson(parseXApiError(err.message, accountId));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAO9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,oBAAoB,UAAU,MAAM;AAAA,IACjF,UAAU,EAAE,MAAM,UAAU,aAAa,iBAAiB,UAAU,MAAM;AAAA,IAC1E,WAAW,EAAE,MAAM,UAAU,aAAa,kBAAkB,UAAU,MAAM;AAAA,EAC9E;AACF,CAAC;AAEM,IAAM,wBAAwB,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,oBAAoB,UAAU,MAAM;AAAA,IACjF,UAAU,EAAE,MAAM,UAAU,aAAa,UAAU,UAAU,MAAM;AAAA,IACnE,WAAW,EAAE,MAAM,UAAU,aAAa,kBAAkB,UAAU,MAAM;AAAA,EAC9E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,MAAM,kBAAkB,IAAI;AAC9C,QAAI,CAAC,KAAK,QAAQ,KAAK,CAAC,KAAK,SAAS,GAAG;AACvC,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,OAAO,EAAE,MAAM,qBAAqB,SAAS,6BAA6B;AAAA,MAC5E,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,QAAQ,EAAG,QAAO,QAAQ,IAAI,KAAK,QAAQ;AACpD,UAAI,KAAK,SAAS,EAAG,QAAO,SAAS,IAAI,KAAK,SAAS;AACvD,YAAM,OAAO,MAAM,OAAkB,yBAAyB,MAAM;AACpE,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,qBAAa,eAAe,IAAI,SAAS,SAAS,CAAC;AACnD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,mBAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,SAAS,mBAAmB,EAAE,CAAC;AACzF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/keep-GYZS2UTL.js

@@ -0,0 +1,78 @@
+import {
+  failStudioCommand
+} from "./chunk-3UDSYYND.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/keep.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "studio.keep",
+  description: "Mark one take as the keeper. For an image this stars it, so the client reviewing the batch sees which one you used. For a CLIP it is the step that puts it in the video library \u2014 until then the clip cannot be used in a canvas, a landing, or an ad.",
+  args: {
+    "generation-id": { type: "string", description: "Batch id from `generate` / `animate`", required: true },
+    slot: { type: "number", description: "Which take, as shown in the batch (0-based)", required: true },
+    undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
+  }
+});
+var keepCommand = defineCommand({
+  meta: {
+    name: "keep",
+    description: "Mark one take as the keeper. An image gets starred (it was already in the library); a clip gets INGESTED into the video library, which is what makes it usable anywhere else.\n\nExample: baker studio keep j57abc123def456ghi789 --slot 2\nExample: baker studio keep j57abc123def456ghi789 --slot 2 --undo"
+  },
+  args: {
+    "generation-id": { type: "positional", description: "Batch id", required: false },
+    slot: { type: "string", description: "Which take (0-based)", required: false },
+    undo: { type: "boolean", description: "Reverse the keep", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const generationId = args["generation-id"];
+      if (!generationId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A batch id is required" } });
+        process.exit(1);
+      }
+      if (args.slot === void 0 || args.slot === "") {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "--slot is required: say which take you are keeping" }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/studio/keep", {
+        generationId,
+        slot: Number(args.slot),
+        ...args.undo ? { keep: false } : {}
+      });
+      const hints = [];
+      if (data.kind === "video" && data.kept) {
+        hints.push(
+          `The clip is in the video library now as ${data.videoId ?? "a new video"} \u2014 use that id from a canvas, a landing, or an ad.`
+        );
+      }
+      if (data.kind === "video" && !data.kept) {
+        hints.push("The clip is out of the video library again, so nothing else can use it.");
+      }
+      if (data.kind === "image" && data.kept) {
+        hints.push(
+          "Starred. The image was already in the media library \u2014 this is what tells the client it is the pick."
+        );
+      }
+      writeJson({ ok: true, data, hints });
+    } catch (error) {
+      failStudioCommand(error);
+    }
+  }
+});
+export {
+  keepCommand
+};
+//# sourceMappingURL=keep-GYZS2UTL.js.map

package/dist/keep-GYZS2UTL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/keep.ts"],"sourcesContent":["import type { StudioKeepResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failStudioCommand } from \"./errors.ts\";\n\nregisterSchema({\n  command: \"studio.keep\",\n  description:\n    \"Mark one take as the keeper. For an image this stars it, so the client reviewing the batch sees which one you used. For a CLIP it is the step that puts it in the video library — until then the clip cannot be used in a canvas, a landing, or an ad.\",\n  args: {\n    \"generation-id\": { type: \"string\", description: \"Batch id from `generate` / `animate`\", required: true },\n    slot: { type: \"number\", description: \"Which take, as shown in the batch (0-based)\", required: true },\n    undo: { type: \"boolean\", description: \"Un-star an image, or take a kept clip back out\", required: false },\n  },\n});\n\nexport const keepCommand = defineCommand({\n  meta: {\n    name: \"keep\",\n    description:\n      \"Mark one take as the keeper. An image gets starred (it was already in the library); a clip gets INGESTED into the video library, which is what makes it usable anywhere else.\\n\\nExample: baker studio keep j57abc123def456ghi789 --slot 2\\nExample: baker studio keep j57abc123def456ghi789 --slot 2 --undo\",\n  },\n  args: {\n    \"generation-id\": { type: \"positional\", description: \"Batch id\", required: false },\n    slot: { type: \"string\", description: \"Which take (0-based)\", required: false },\n    undo: { type: \"boolean\", description: \"Reverse the keep\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const generationId = args[\"generation-id\"] as string | undefined;\n      if (!generationId) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"A batch id is required\" } });\n        process.exit(1);\n      }\n      if (args.slot === undefined || args.slot === \"\") {\n        writeJson({\n          ok: false,\n          error: { code: \"VALIDATION_ERROR\", message: \"--slot is required: say which take you are keeping\" },\n        });\n        process.exit(1);\n      }\n\n      const data = await apiPost<StudioKeepResponse>(\"/api/studio/keep\", {\n        generationId,\n        slot: Number(args.slot),\n        ...(args.undo ? { keep: false } : {}),\n      });\n\n      const hints: string[] = [];\n      if (data.kind === \"video\" && data.kept) {\n        hints.push(\n          `The clip is in the video library now as ${data.videoId ?? \"a new video\"} — use that id from a canvas, a landing, or an ad.`,\n        );\n      }\n      if (data.kind === \"video\" && !data.kept) {\n        hints.push(\"The clip is out of the video library again, so nothing else can use it.\");\n      }\n      if (data.kind === \"image\" && data.kept) {\n        hints.push(\n          \"Starred. The image was already in the media library — this is what tells the client it is the pick.\",\n        );\n      }\n      writeJson({ ok: true, data, hints });\n    } catch (error) {\n      failStudioCommand(error);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,iBAAiB,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,KAAK;AAAA,IACvG,MAAM,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,KAAK;AAAA,IACnG,MAAM,EAAE,MAAM,WAAW,aAAa,kDAAkD,UAAU,MAAM;AAAA,EAC1G;AACF,CAAC;AAEM,IAAM,cAAc,cAAc;AAAA,EACvC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,iBAAiB,EAAE,MAAM,cAAc,aAAa,YAAY,UAAU,MAAM;AAAA,IAChF,MAAM,EAAE,MAAM,UAAU,aAAa,wBAAwB,UAAU,MAAM;AAAA,IAC7E,MAAM,EAAE,MAAM,WAAW,aAAa,oBAAoB,UAAU,MAAM;AAAA,EAC5E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,eAAe,KAAK,eAAe;AACzC,UAAI,CAAC,cAAc;AACjB,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,yBAAyB,EAAE,CAAC;AAC/F,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,UAAI,KAAK,SAAS,UAAa,KAAK,SAAS,IAAI;AAC/C,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,qDAAqD;AAAA,QACnG,CAAC;AACD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,OAAO,MAAM,QAA4B,oBAAoB;AAAA,QACjE;AAAA,QACA,MAAM,OAAO,KAAK,IAAI;AAAA,QACtB,GAAI,KAAK,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC;AAAA,MACrC,CAAC;AAED,YAAM,QAAkB,CAAC;AACzB,UAAI,KAAK,SAAS,WAAW,KAAK,MAAM;AACtC,cAAM;AAAA,UACJ,2CAA2C,KAAK,WAAW,aAAa;AAAA,QAC1E;AAAA,MACF;AACA,UAAI,KAAK,SAAS,WAAW,CAAC,KAAK,MAAM;AACvC,cAAM,KAAK,yEAAyE;AAAA,MACtF;AACA,UAAI,KAAK,SAAS,WAAW,KAAK,MAAM;AACtC,cAAM;AAAA,UACJ;AAAA,QACF;AAAA,MACF;AACA,gBAAU,EAAE,IAAI,MAAM,MAAM,MAAM,CAAC;AAAA,IACrC,SAAS,OAAO;AACd,wBAAkB,KAAK;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}