@koda-sl/baker-cli 0.25.1 → 0.27.0

package/dist/commands/ads/x/funding.js

@@ -0,0 +1,65 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../../client.js";
+import { registerSchema } from "../../../schemas.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { parseXApiError } from "./error-parser.js";
+import { resolveXAccountId } from "./output.js";
+registerSchema({
+    command: "ads.x.funding",
+    description: "List funding instruments for an X Ads account. Returns id, type, currency, credit_limit_local_micro, funded_amount_local_micro, status. Falls back to BAKER_X_ADS_ACCOUNT_ID env var.",
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID (base36)", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const fundingCommand = defineCommand({
+    meta: {
+        name: "funding",
+        description: `List funding instruments for an X Ads account.
+
+Examples:
+  baker ads x funding --account-id 18ce53xyz`,
+    },
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", 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 accountId = await resolveXAccountId(args);
+        const useCache = !args["no-cache"];
+        const cacheKey = `funding:${accountId}`;
+        if (useCache) {
+            const cached = cacheGet("x-account-data", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = { "account-id": accountId };
+            if (!useCache)
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/x/funding-instruments", params);
+            if (useCache) {
+                cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            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=funding.js.map

package/dist/commands/ads/x/funding.js.map

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

package/dist/commands/ads/x/index.d.ts

@@ -0,0 +1,2 @@
+export declare const xCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/ads/x/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/index.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,QAAQ,qDAmCnB,CAAC"}

package/dist/commands/ads/x/index.js

@@ -0,0 +1,50 @@
+import { defineCommand } from "citty";
+import { accountsCommand } from "./accounts.js";
+import { activeEntitiesCommand } from "./active-entities.js";
+import { audiencesCommand } from "./audiences.js";
+import { campaignsCommand } from "./campaigns.js";
+import { cardsCommand } from "./cards.js";
+import { fundingCommand } from "./funding.js";
+import { lineItemsCommand } from "./line-items.js";
+import { mediaCommand } from "./media.js";
+import { promotedTweetsCommand } from "./promoted-tweets.js";
+import { statsCommand } from "./stats/index.js";
+import { targetingConstantsCommand } from "./targeting-constants.js";
+import { targetingCriteriaCommand } from "./targeting-criteria.js";
+export const xCommand = defineCommand({
+    meta: {
+        name: "x",
+        description: `X (Twitter) Ads commands. Read campaigns, line items, promoted tweets, creatives, audiences, and analytics.
+
+Start here:
+  baker ads x accounts                              — list accessible X Ads accounts
+  baker ads x stats sync --list-presets             — see available stats presets
+  baker ads x targeting-constants --constant locations --q "Madrid"
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x promoted-tweets --account-id 18ce53xyz
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads x stats job-create --entity CAMPAIGN --entity-ids abc \\
+    --start-time 2026-04-01T00:00:00Z --end-time 2026-05-01T00:00:00Z \\
+    --metric-groups ENGAGEMENT,BILLING --segmentation-type LOCATIONS
+
+The CLI auto-detects --account-id when exactly one X Ads account is connected, or via BAKER_X_ADS_ACCOUNT_ID.`,
+    },
+    subCommands: {
+        accounts: accountsCommand,
+        funding: fundingCommand,
+        campaigns: campaignsCommand,
+        "line-items": lineItemsCommand,
+        "promoted-tweets": promotedTweetsCommand,
+        cards: cardsCommand,
+        media: mediaCommand,
+        audiences: audiencesCommand,
+        "targeting-criteria": targetingCriteriaCommand,
+        "targeting-constants": targetingConstantsCommand,
+        "active-entities": activeEntitiesCommand,
+        stats: statsCommand,
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/commands/ads/x/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/x/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC;IACpC,IAAI,EAAE;QACJ,IAAI,EAAE,GAAG;QACT,WAAW,EAAE;;;;;;;;;;;;;;;;8GAgB6F;KAC3G;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;QAC3B,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,qBAAqB;QACxC,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,gBAAgB;QAC3B,oBAAoB,EAAE,wBAAwB;QAC9C,qBAAqB,EAAE,yBAAyB;QAChD,iBAAiB,EAAE,qBAAqB;QACxC,KAAK,EAAE,YAAY;KACpB;CACF,CAAC,CAAC"}

package/dist/commands/ads/x/line-items.d.ts

@@ -0,0 +1,34 @@
+export declare const lineItemsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly "campaign-ids": {
+        readonly type: "string";
+        readonly description: "CSV of campaign IDs";
+        readonly required: false;
+    };
+    readonly "line-item-ids": {
+        readonly type: "string";
+        readonly description: "CSV of line item IDs";
+        readonly required: false;
+    };
+    readonly "with-deleted": {
+        readonly type: "boolean";
+        readonly description: "Include deleted";
+        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=line-items.d.ts.map

package/dist/commands/ads/x/line-items.d.ts.map

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

package/dist/commands/ads/x/line-items.js

@@ -0,0 +1,55 @@
+import { defineCommand } from "citty";
+import { registerSchema } from "../../../schemas.js";
+import { resolveXAccountId } from "./output.js";
+import { runListCommand } from "./run-list.js";
+registerSchema({
+    command: "ads.x.lineItems",
+    description: "List line items (ad groups) for an X Ads account. Returns bid, product_type, objective, placements, schedule. Filter by campaign-ids or line-item-ids (CSV).",
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+        "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+        "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const lineItemsCommand = defineCommand({
+    meta: {
+        name: "line-items",
+        description: `List X Ads line items (ad groups).
+
+Examples:
+  baker ads x line-items --account-id 18ce53xyz --campaign-ids abc
+  baker ads x line-items --account-id 18ce53xyz --with-deleted`,
+    },
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+        "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+        "with-deleted": { type: "boolean", description: "Include deleted", 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 accountId = await resolveXAccountId(args);
+        const useCache = !args["no-cache"];
+        const today = new Date().toISOString().slice(0, 10);
+        const cacheKey = `line-items:${accountId}:${today}:${args["campaign-ids"] ?? ""}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+        await runListCommand({
+            path: "/api/ads/x/line-items",
+            cacheCategory: "x-account-data",
+            cacheKey,
+            cacheTtlMs: 60 * 60 * 1000,
+            params: {
+                "account-id": accountId,
+                "campaign-ids": args["campaign-ids"],
+                "line-item-ids": args["line-item-ids"],
+                "with-deleted": args["with-deleted"] ? "true" : undefined,
+            },
+            format: args.output || "json",
+            accountId,
+            useCache,
+        });
+    },
+});
+//# sourceMappingURL=line-items.js.map

package/dist/commands/ads/x/line-items.js.map

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

package/dist/commands/ads/x/media.d.ts

@@ -0,0 +1,24 @@
+export declare const mediaCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly "media-type": {
+        readonly type: "string";
+        readonly description: "IMAGE | GIF | VIDEO";
+        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=media.d.ts.map

package/dist/commands/ads/x/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/media.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;EAkDvB,CAAC"}

package/dist/commands/ads/x/media.js

@@ -0,0 +1,70 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../../client.js";
+import { registerSchema } from "../../../schemas.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { parseXApiError } from "./error-parser.js";
+import { resolveXAccountId } from "./output.js";
+registerSchema({
+    command: "ads.x.media",
+    description: "List media assets in the X Ads media library (images, GIFs, videos). Filter by media-type (IMAGE, GIF, VIDEO).",
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const mediaCommand = defineCommand({
+    meta: {
+        name: "media",
+        description: `List media assets in the X Ads media library.
+
+Examples:
+  baker ads x media --account-id 18ce53xyz
+  baker ads x media --account-id 18ce53xyz --media-type VIDEO`,
+    },
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", 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 accountId = await resolveXAccountId(args);
+        const useCache = !args["no-cache"];
+        const cacheKey = `media:${accountId}:${args["media-type"] ?? "ALL"}`;
+        if (useCache) {
+            const cached = cacheGet("x-account-data", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = { "account-id": accountId };
+            if (args["media-type"])
+                params["media-type"] = args["media-type"];
+            if (!useCache)
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/x/media-library", params);
+            if (useCache) {
+                cacheSet("x-account-data", cacheKey, data, 6 * 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            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=media.js.map

package/dist/commands/ads/x/media.js.map

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

package/dist/commands/ads/x/output.d.ts

@@ -0,0 +1,13 @@
+export interface XAccountInfo {
+    id: string;
+    name: string;
+    approval_status?: string;
+    timezone?: string;
+    currency?: string;
+}
+/**
+ * Resolve an X Ads account_id from either --account-id, BAKER_X_ADS_ACCOUNT_ID, or
+ * (if exactly one account is connected) auto-detect.
+ */
+export declare function resolveXAccountId(args: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=output.d.ts.map

package/dist/commands/ads/x/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/output.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDtF"}

package/dist/commands/ads/x/output.js

@@ -0,0 +1,75 @@
+import { ApiError, apiGet } from "../../../client.js";
+import { getEnv } from "../../../env.js";
+import { handleConnectionError } from "../../../error-handler.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson } from "../output.js";
+const ACCOUNTS_CACHE_TTL_MS = 60 * 60 * 1000;
+async function fetchXAccounts(useCache) {
+    if (useCache) {
+        const cached = cacheGet("x-accounts", "list");
+        if (cached)
+            return cached.data;
+    }
+    const params = !useCache ? { "skip-cache": "true" } : undefined;
+    const data = await apiGet("/api/ads/x/accounts", params);
+    if (useCache) {
+        cacheSet("x-accounts", "list", data, ACCOUNTS_CACHE_TTL_MS);
+    }
+    return data;
+}
+/**
+ * Resolve an X Ads account_id from either --account-id, BAKER_X_ADS_ACCOUNT_ID, or
+ * (if exactly one account is connected) auto-detect.
+ */
+export async function resolveXAccountId(args) {
+    const fromArgs = args["account-id"];
+    const accountId = fromArgs || getEnv().BAKER_X_ADS_ACCOUNT_ID;
+    if (accountId) {
+        if (!/^[a-z0-9]+$/.test(accountId)) {
+            writeAdsJson({
+                ok: false,
+                error: {
+                    code: "INVALID_ACCOUNT_ID",
+                    message: "X Ads account ID must be a base36 string (lowercase letters and digits). Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID.",
+                },
+            });
+            process.exit(1);
+        }
+        return accountId;
+    }
+    const useCache = !args["no-cache"];
+    try {
+        const accounts = await fetchXAccounts(useCache);
+        const [single] = accounts;
+        if (accounts.length === 1 && single) {
+            process.stderr.write(`Using account "${single.name}" (${single.id})\n`);
+            return single.id;
+        }
+        if (accounts.length === 0) {
+            handleConnectionError("x_ads");
+        }
+        const list = accounts.map((a) => `  ${a.id}  ${a.name}`).join("\n");
+        writeAdsJson({
+            ok: false,
+            error: {
+                code: "MULTIPLE_ACCOUNTS",
+                message: `Multiple X Ads accounts found. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID:\n${list}`,
+            },
+        });
+        process.exit(1);
+    }
+    catch (err) {
+        if (err instanceof ApiError && (err.code === "UNAUTHORIZED" || err.code === "NOT_FOUND")) {
+            handleConnectionError("x_ads", err.message);
+        }
+        writeAdsJson({
+            ok: false,
+            error: {
+                code: "INVALID_ACCOUNT_ID",
+                message: "Could not auto-detect account. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID.",
+            },
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/commands/ads/x/output.js.map

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

package/dist/commands/ads/x/presets.d.ts

@@ -0,0 +1,15 @@
+interface XStatsPreset {
+    name: string;
+    description: string;
+    entity: string;
+    metricGroups: string[];
+    granularity: "TOTAL" | "DAY" | "HOUR";
+    defaultDays: number;
+    placement: "ALL_ON_TWITTER" | "PUBLISHER_NETWORK";
+}
+export declare const X_STATS_PRESETS: XStatsPreset[];
+export declare function getPreset(name: string): XStatsPreset | undefined;
+/** Hour-aligned ISO 8601 string `daysAgo` days before now (UTC). */
+export declare function isoHourFloor(daysAgo: number): string;
+export {};
+//# sourceMappingURL=presets.d.ts.map

package/dist/commands/ads/x/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/presets.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;CACnD;AAED,eAAO,MAAM,eAAe,EAAE,YAAY,EA8CzC,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOpD"}

package/dist/commands/ads/x/presets.js

@@ -0,0 +1,60 @@
+export const X_STATS_PRESETS = [
+    {
+        name: "campaign-engagement-7d",
+        description: "Campaign-level engagements + impressions over the last 7 days, daily granularity",
+        entity: "CAMPAIGN",
+        metricGroups: ["ENGAGEMENT"],
+        granularity: "DAY",
+        defaultDays: 7,
+        placement: "ALL_ON_TWITTER",
+    },
+    {
+        name: "campaign-spend-30d",
+        description: "Campaign-level billed engagements + spend over the last 30 days, daily",
+        entity: "CAMPAIGN",
+        metricGroups: ["BILLING"],
+        granularity: "DAY",
+        defaultDays: 30,
+        placement: "ALL_ON_TWITTER",
+    },
+    {
+        name: "tweet-performance-7d",
+        description: "Promoted tweet engagement + media metrics over the last 7 days, daily",
+        entity: "PROMOTED_TWEET",
+        metricGroups: ["ENGAGEMENT", "MEDIA"],
+        granularity: "DAY",
+        defaultDays: 7,
+        placement: "ALL_ON_TWITTER",
+    },
+    {
+        name: "video-performance-30d",
+        description: "Promoted tweet video views/CTAs + engagement over the last 30 days, daily",
+        entity: "PROMOTED_TWEET",
+        metricGroups: ["VIDEO", "ENGAGEMENT"],
+        granularity: "DAY",
+        defaultDays: 30,
+        placement: "ALL_ON_TWITTER",
+    },
+    {
+        name: "line-item-conversions-30d",
+        description: "Line item web conversions + billing over the last 30 days, daily",
+        entity: "LINE_ITEM",
+        metricGroups: ["WEB_CONVERSION", "BILLING"],
+        granularity: "DAY",
+        defaultDays: 30,
+        placement: "ALL_ON_TWITTER",
+    },
+];
+export function getPreset(name) {
+    return X_STATS_PRESETS.find((p) => p.name === name);
+}
+/** Hour-aligned ISO 8601 string `daysAgo` days before now (UTC). */
+export function isoHourFloor(daysAgo) {
+    const d = new Date();
+    d.setUTCMilliseconds(0);
+    d.setUTCSeconds(0);
+    d.setUTCMinutes(0);
+    d.setUTCDate(d.getUTCDate() - daysAgo);
+    return d.toISOString();
+}
+//# sourceMappingURL=presets.js.map

package/dist/commands/ads/x/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../../src/commands/ads/x/presets.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,kFAAkF;QAC/F,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE,CAAC,YAAY,CAAC;QAC5B,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,gBAAgB;KAC5B;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,wEAAwE;QACrF,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE,CAAC,SAAS,CAAC;QACzB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,gBAAgB;KAC5B;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,uEAAuE;QACpF,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;QACrC,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,gBAAgB;KAC5B;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,2EAA2E;QACxF,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC;QACrC,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,gBAAgB;KAC5B;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,CAAC,gBAAgB,EAAE,SAAS,CAAC;QAC3C,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,gBAAgB;KAC5B;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/commands/ads/x/promoted-tweets.d.ts

@@ -0,0 +1,29 @@
+export declare const promotedTweetsCommand: import("citty").CommandDef<{
+    readonly "account-id": {
+        readonly type: "string";
+        readonly description: "X Ads account ID";
+        readonly required: false;
+    };
+    readonly "line-item-ids": {
+        readonly type: "string";
+        readonly description: "CSV of line item IDs";
+        readonly required: false;
+    };
+    readonly "with-deleted": {
+        readonly type: "boolean";
+        readonly description: "Include deleted";
+        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=promoted-tweets.d.ts.map

package/dist/commands/ads/x/promoted-tweets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promoted-tweets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/x/promoted-tweets.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDhC,CAAC"}

package/dist/commands/ads/x/promoted-tweets.js

@@ -0,0 +1,74 @@
+import { defineCommand } from "citty";
+import { ApiError, apiGet } from "../../../client.js";
+import { registerSchema } from "../../../schemas.js";
+import { cacheGet, cacheSet } from "../cache.js";
+import { writeAdsJson, writeAdsOutput } from "../output.js";
+import { parseXApiError } from "./error-parser.js";
+import { resolveXAccountId } from "./output.js";
+registerSchema({
+    command: "ads.x.promotedTweets",
+    description: "List promoted tweets for an X Ads account. Returns id, line_item_id, tweet_id, approval_status. Filter by line-item-ids (CSV).",
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+        "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+        "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    },
+});
+export const promotedTweetsCommand = defineCommand({
+    meta: {
+        name: "promoted-tweets",
+        description: `List X Ads promoted tweets.
+
+Examples:
+  baker ads x promoted-tweets --account-id 18ce53xyz --line-item-ids abc,def`,
+    },
+    args: {
+        "account-id": { type: "string", description: "X Ads account ID", required: false },
+        "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+        "with-deleted": { type: "boolean", description: "Include deleted", 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 accountId = await resolveXAccountId(args);
+        const useCache = !args["no-cache"];
+        const today = new Date().toISOString().slice(0, 10);
+        const cacheKey = `promoted-tweets:${accountId}:${today}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+        if (useCache) {
+            const cached = cacheGet("x-account-data", cacheKey);
+            if (cached) {
+                writeAdsJson({ ok: true, data: cached.data, cached: true });
+                return;
+            }
+        }
+        try {
+            const params = { "account-id": accountId };
+            if (args["line-item-ids"])
+                params["line-item-ids"] = args["line-item-ids"];
+            if (args["with-deleted"])
+                params["with-deleted"] = "true";
+            if (!useCache)
+                params["skip-cache"] = "true";
+            const data = await apiGet("/api/ads/x/promoted-tweets", params);
+            if (useCache) {
+                cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1000);
+            }
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeAdsOutput(data, format);
+                return;
+            }
+            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=promoted-tweets.js.map