@koda-sl/baker-cli 0.34.1 → 0.34.2

package/dist/commands/ads/x/stats/job-create.js

@@ -0,0 +1,95 @@
+import { defineCommand } from "citty";
+import { ApiError, apiPost } from "../../../../client.js";
+import { registerSchema } from "../../../../schemas.js";
+import { writeAdsJson } from "../../output.js";
+import { parseXApiError } from "../error-parser.js";
+import { resolveXAccountId } from "../output.js";
+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 undefined;
+    const parts = v
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return parts.length > 0 ? parts : undefined;
+}
+export const 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);
+        }
+    },
+});
+//# sourceMappingURL=job-create.js.map

package/dist/commands/ads/x/stats/job-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-create.js","sourceRoot":"","sources":["../../../../../src/commands/ads/x/stats/job-create.ts"],"names":[],"mappings":"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"}

package/dist/commands/ads/x/stats/job-status.d.ts

@@ -0,0 +1,18 @@
+export declare const statsJobStatusCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly "job-id": {
+        readonly type: "string";
+        readonly description: "Job ID";
+        readonly required: false;
+    };
+    readonly "job-ids": {
+        readonly type: "string";
+        readonly description: "CSV of job IDs";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=job-status.d.ts.map

package/dist/commands/ads/x/stats/job-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-status.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/x/stats/job-status.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;EAsChC,CAAC"}

package/dist/commands/ads/x/stats/job-status.js

@@ -0,0 +1,58 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../../../client.js";
+import { registerSchema } from "../../../../schemas.js";
+import { writeAdsJson } from "../../output.js";
+import { parseXApiError } from "../error-parser.js";
+import { resolveXAccountId } from "../output.js";
+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 },
+    },
+});
+export const 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);
+        }
+    },
+});
+//# sourceMappingURL=job-status.js.map

package/dist/commands/ads/x/stats/job-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-status.js","sourceRoot":"","sources":["../../../../../src/commands/ads/x/stats/job-status.ts"],"names":[],"mappings":"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"}

package/dist/commands/ads/x/stats/job.d.ts

@@ -0,0 +1,63 @@
+export declare const statsJobCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly entity: {
+        readonly type: "string";
+        readonly description: "Entity type";
+        readonly required: true;
+    };
+    readonly "entity-ids": {
+        readonly type: "string";
+        readonly description: "CSV of entity IDs";
+        readonly required: true;
+    };
+    readonly "start-time": {
+        readonly type: "string";
+        readonly description: "ISO start";
+        readonly required: true;
+    };
+    readonly "end-time": {
+        readonly type: "string";
+        readonly description: "ISO end";
+        readonly required: true;
+    };
+    readonly granularity: {
+        readonly type: "string";
+        readonly description: "Granularity";
+        readonly required: false;
+    };
+    readonly "metric-groups": {
+        readonly type: "string";
+        readonly description: "Metric groups CSV";
+        readonly required: true;
+    };
+    readonly placement: {
+        readonly type: "string";
+        readonly description: "Placement";
+        readonly required: false;
+    };
+    readonly "segmentation-type": {
+        readonly type: "string";
+        readonly description: "Segmentation type";
+        readonly required: false;
+    };
+    readonly country: {
+        readonly type: "string";
+        readonly description: "Country filter";
+        readonly required: false;
+    };
+    readonly platform: {
+        readonly type: "string";
+        readonly description: "Platform filter";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip result cache";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=job.d.ts.map

package/dist/commands/ads/x/stats/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/x/stats/job.ts"],"names":[],"mappings":"AA+FA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2G1B,CAAC"}

package/dist/commands/ads/x/stats/job.js

@@ -0,0 +1,183 @@
+import { gunzipSync } from "node:zlib";
+import { defineCommand } from "citty";
+import { ApiError, apiGet, apiPost } from "../../../../client.js";
+import { registerSchema } from "../../../../schemas.js";
+import { cacheGet, cacheSet } from "../../cache.js";
+import { writeAdsJson } from "../../output.js";
+import { parseXApiError } from "../error-parser.js";
+import { resolveXAccountId } from "../output.js";
+const POLL_INTERVAL_MS = 10_000;
+const DEADLINE_MS = 12 * 60 * 1000;
+const RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1000;
+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 — 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 undefined;
+    const parts = v
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return parts.length > 0 ? parts : undefined;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function downloadAndDecompress(url) {
+    const res = await fetch(url, { signal: AbortSignal.timeout(60_000) });
+    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 > 30_000) {
+            process.stderr.write(`  polling... (${job.status}, ${Math.round(elapsed / 1000)}s elapsed)\n`);
+            lastLog = elapsed;
+        }
+    }
+    throw new ApiError("TIMEOUT", `Stats job ${jobId} did not complete within ${DEADLINE_MS / 60_000} minutes`);
+}
+function buildCacheKey(body) {
+    return `stats-job:${JSON.stringify(body)}`;
+}
+export const statsJobCommand = defineCommand({
+    meta: {
+        name: "job",
+        description: `Async X Ads stats job, sync from the CLI's perspective. Creates → polls → downloads → returns.
+
+Must run in the background (the harness enforces this).
+
+Use this when:
+  • Date range > 7 days
+  • Need segmentation (AGE, GENDER, LOCATIONS, ...)
+  • 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   — create + return job ID immediately
+  baker ads x stats job-status   — 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...\n`);
+            const job = await apiPost("/api/ads/x/stats/jobs", body);
+            process.stderr.write(`Job ${job.id} queued. Polling every ${POLL_INTERVAL_MS / 1000}s...\n`);
+            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);
+        }
+    },
+});
+//# sourceMappingURL=job.js.map

package/dist/commands/ads/x/stats/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../../../../src/commands/ads/x/stats/job.ts"],"names":[],"mappings":"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"}

package/dist/commands/ads/x/stats/sync.d.ts

@@ -0,0 +1,73 @@
+export declare const statsSyncCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly preset: {
+        readonly type: "string";
+        readonly description: "Stats preset name";
+        readonly required: false;
+    };
+    readonly "list-presets": {
+        readonly type: "boolean";
+        readonly description: "List presets and exit";
+        readonly required: false;
+    };
+    readonly days: {
+        readonly type: "string";
+        readonly description: "Override days (1–7)";
+        readonly required: false;
+    };
+    readonly entity: {
+        readonly type: "string";
+        readonly description: "Entity type";
+        readonly required: false;
+    };
+    readonly "entity-ids": {
+        readonly type: "string";
+        readonly description: "CSV of entity IDs";
+        readonly required: false;
+    };
+    readonly "start-time": {
+        readonly type: "string";
+        readonly description: "ISO 8601 start";
+        readonly required: false;
+    };
+    readonly "end-time": {
+        readonly type: "string";
+        readonly description: "ISO 8601 end";
+        readonly required: false;
+    };
+    readonly granularity: {
+        readonly type: "string";
+        readonly description: "Granularity";
+        readonly required: false;
+    };
+    readonly "metric-groups": {
+        readonly type: "string";
+        readonly description: "Metric groups CSV";
+        readonly required: false;
+    };
+    readonly placement: {
+        readonly type: "string";
+        readonly description: "Placement";
+        readonly required: false;
+    };
+    readonly country: {
+        readonly type: "string";
+        readonly description: "Country filter";
+        readonly required: false;
+    };
+    readonly platform: {
+        readonly type: "string";
+        readonly description: "Platform filter";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/ads/x/stats/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ads/x/stats/sync.ts"],"names":[],"mappings":"AA8HA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC3B,CAAC"}