@koda-sl/baker-cli 0.23.0 → 0.25.0-dev.f89d9a60

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"}

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

@@ -0,0 +1,151 @@
+import { defineCommand } from "citty";
+import { ApiError, 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";
+import { getPreset, isoHourFloor, X_STATS_PRESETS } from "../presets.js";
+registerSchema({
+    command: "ads.x.statsSync",
+    description: "Synchronous analytics for an X Ads account (max 7 days). Use --preset for common queries or pass --entity, --entity-ids (CSV, max 20), --metric-groups (CSV), --start-time, --end-time, --granularity (DAY|HOUR|TOTAL), --placement (ALL_ON_TWITTER|PUBLISHER_NETWORK).",
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        preset: { type: "string", description: "Use a stats preset (see --list-presets)", required: false },
+        "list-presets": { type: "boolean", description: "List available presets and exit", required: false },
+        days: { type: "string", description: "Override preset days (max 7)", required: false },
+        entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET | ...", required: false },
+        "entity-ids": { type: "string", description: "CSV of entity IDs (max 20)", required: false },
+        "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: false },
+        "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: false },
+        granularity: { type: "string", description: "TOTAL | DAY | HOUR", required: false },
+        "metric-groups": {
+            type: "string",
+            description: "CSV: ENGAGEMENT,BILLING,VIDEO,MEDIA,WEB_CONVERSION,MOBILE_CONVERSION,LIFE_TIME_VALUE_MOBILE_CONVERSION",
+            required: false,
+        },
+        placement: { type: "string", description: "ALL_ON_TWITTER | PUBLISHER_NETWORK", required: false },
+        country: { type: "string", description: "Country filter (mobile_conversion only)", required: false },
+        platform: { type: "string", description: "Platform filter (mobile_conversion only)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", 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 resolveQueryFromArgs(args) {
+    let entity = args.entity;
+    let metricGroups = parseCsv(args["metric-groups"]);
+    let granularity = args.granularity ?? "DAY";
+    let placement = args.placement ?? "ALL_ON_TWITTER";
+    let startTime = args["start-time"];
+    let endTime = args["end-time"];
+    if (args.preset) {
+        const preset = getPreset(args.preset);
+        if (!preset) {
+            return { error: `Unknown preset '${args.preset}'. Run with --list-presets to see options.` };
+        }
+        entity ??= preset.entity;
+        metricGroups ??= preset.metricGroups;
+        granularity = args.granularity ?? preset.granularity;
+        placement = args.placement ?? preset.placement;
+        const days = args.days ? Math.min(7, Math.max(1, Number(args.days))) : preset.defaultDays;
+        startTime ??= isoHourFloor(days);
+        endTime ??= isoHourFloor(0);
+    }
+    const entityIds = parseCsv(args["entity-ids"]);
+    if (!entity || !metricGroups || metricGroups.length === 0 || !startTime || !endTime || !entityIds) {
+        return {
+            error: "stats sync requires entity, entity-ids, metric-groups, start-time, end-time. Use --preset for defaults.",
+        };
+    }
+    return { entity, metricGroups, granularity, placement, startTime, endTime, entityIds };
+}
+async function runSync(args, q) {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const body = {
+        accountId,
+        entity: q.entity,
+        entityIds: q.entityIds,
+        startTime: q.startTime,
+        endTime: q.endTime,
+        granularity: q.granularity,
+        metricGroups: q.metricGroups,
+        placement: q.placement,
+        country: args.country ?? undefined,
+        platform: args.platform ?? undefined,
+        skipCache: !useCache || undefined,
+    };
+    const cacheKey = `stats-sync:${JSON.stringify(body)}`;
+    if (useCache) {
+        const cached = cacheGet("x-stats", cacheKey);
+        if (cached) {
+            writeAdsJson({ ok: true, data: cached.data, cached: true });
+            return;
+        }
+    }
+    try {
+        const data = await apiPost("/api/ads/x/stats", body);
+        if (useCache) {
+            cacheSet("x-stats", cacheKey, data, 60 * 60 * 1000);
+        }
+        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 const statsSyncCommand = defineCommand({
+    meta: {
+        name: "sync",
+        description: `Synchronous X Ads analytics (max 7-day window).
+
+Examples:
+  baker ads x stats sync --preset campaign-engagement-7d --account-id 18ce53xyz --entity-ids abc,def
+  baker ads x stats sync --account-id 18ce53xyz --entity LINE_ITEM --entity-ids abc \\
+    --start-time 2026-05-01T00:00:00Z --end-time 2026-05-07T00:00:00Z \\
+    --metric-groups ENGAGEMENT,BILLING --granularity DAY
+  baker ads x stats sync --list-presets`,
+    },
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        preset: { type: "string", description: "Stats preset name", required: false },
+        "list-presets": { type: "boolean", description: "List presets and exit", required: false },
+        days: { type: "string", description: "Override days (1–7)", required: false },
+        entity: { type: "string", description: "Entity type", required: false },
+        "entity-ids": { type: "string", description: "CSV of entity IDs", required: false },
+        "start-time": { type: "string", description: "ISO 8601 start", required: false },
+        "end-time": { type: "string", description: "ISO 8601 end", required: false },
+        granularity: { type: "string", description: "Granularity", required: false },
+        "metric-groups": { type: "string", description: "Metric groups CSV", required: false },
+        placement: { type: "string", description: "Placement", required: false },
+        country: { type: "string", description: "Country filter", required: false },
+        platform: { type: "string", description: "Platform filter", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+    run: async ({ args }) => {
+        if (args["list-presets"]) {
+            writeAdsJson({ ok: true, data: X_STATS_PRESETS });
+            return;
+        }
+        const resolved = resolveQueryFromArgs(args);
+        if ("error" in resolved) {
+            writeAdsJson({ ok: false, error: { code: "INVALID_PARAMETER", message: resolved.error } });
+            process.exit(1);
+        }
+        await runSync(args, resolved);
+    },
+});
+//# sourceMappingURL=sync.js.map

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

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

package/dist/commands/ads/x/targeting-constants.d.ts

@@ -0,0 +1,34 @@
+export declare const targetingConstantsCommand: import("citty").CommandDef<{
+    readonly constant: {
+        readonly type: "string";
+        readonly description: "Targeting constant name";
+        readonly required: true;
+    };
+    readonly q: {
+        readonly type: "string";
+        readonly description: "Search query";
+        readonly required: false;
+    };
+    readonly "country-code": {
+        readonly type: "string";
+        readonly description: "Country filter";
+        readonly required: false;
+    };
+    readonly "location-type": {
+        readonly type: "string";
+        readonly description: "Location type filter";
+        readonly required: false;
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip cache";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=targeting-constants.d.ts.map

package/dist/commands/ads/x/targeting-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeting-constants.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/targeting-constants.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CpC,CAAC"}

package/dist/commands/ads/x/targeting-constants.js

@@ -0,0 +1,80 @@
+import { defineCommand } from "citty";
+import { registerSchema } from "../../../schemas.js";
+import { writeAdsJson } from "../output.js";
+import { runListCommand } from "./run-list.js";
+const ALLOWED_CONSTANTS = [
+    "locations",
+    "interests",
+    "events",
+    "platforms",
+    "platform_versions",
+    "devices",
+    "app_store_categories",
+    "network_operators",
+    "tv_markets",
+    "tv_shows",
+];
+registerSchema({
+    command: "ads.x.targetingConstants",
+    description: "Lookup X Ads targeting constants (locations, interests, events, platforms, devices, etc.). Cached 7 days. For locations: --q to filter by name, --country-code to scope.",
+    args: {
+        constant: {
+            type: "string",
+            description: `One of: ${ALLOWED_CONSTANTS.join(", ")}`,
+            required: true,
+        },
+        q: { type: "string", description: "Search query (locations only)", required: false },
+        "country-code": { type: "string", description: "ISO country code filter", required: false },
+        "location-type": { type: "string", description: "COUNTRY|REGION|CITY|... (locations only)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const targetingConstantsCommand = defineCommand({
+    meta: {
+        name: "targeting-constants",
+        description: `Lookup X Ads targeting constants.
+
+Examples:
+  baker ads x targeting-constants --constant locations --q Madrid --country-code ES
+  baker ads x targeting-constants --constant interests
+  baker ads x targeting-constants --constant devices`,
+    },
+    args: {
+        constant: { type: "string", description: "Targeting constant name", required: true },
+        q: { type: "string", description: "Search query", required: false },
+        "country-code": { type: "string", description: "Country filter", required: false },
+        "location-type": { type: "string", description: "Location type filter", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+        output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const constant = args.constant;
+        if (!ALLOWED_CONSTANTS.includes(constant)) {
+            writeAdsJson({
+                ok: false,
+                error: {
+                    code: "INVALID_PARAMETER",
+                    message: `Unsupported constant '${constant}'. Allowed: ${ALLOWED_CONSTANTS.join(", ")}`,
+                },
+            });
+            process.exit(1);
+        }
+        const useCache = !args["no-cache"];
+        const cacheKey = `targeting-constants:${constant}:${args.q ?? ""}:${args["country-code"] ?? ""}:${args["location-type"] ?? ""}`;
+        await runListCommand({
+            path: "/api/ads/x/targeting-constants",
+            cacheCategory: "x-targeting-constants",
+            cacheKey,
+            cacheTtlMs: 7 * 24 * 60 * 60 * 1000,
+            params: {
+                constant,
+                q: args.q,
+                "country-code": args["country-code"],
+                "location-type": args["location-type"],
+            },
+            format: args.output || "json",
+            useCache,
+        });
+    },
+});
+//# sourceMappingURL=targeting-constants.js.map

package/dist/commands/ads/x/targeting-constants.js.map

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