@koda-sl/baker-cli 0.22.0-dev.ecc541fb → 0.24.0-dev.55a07065

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/README.md +65 -9
  2. package/dist/cli.js +1 -1
  3. package/dist/commands/actions/create.d.ts +0 -5
  4. package/dist/commands/actions/create.d.ts.map +1 -1
  5. package/dist/commands/actions/create.js +0 -15
  6. package/dist/commands/actions/create.js.map +1 -1
  7. package/dist/commands/actions/update.d.ts +0 -5
  8. package/dist/commands/actions/update.d.ts.map +1 -1
  9. package/dist/commands/actions/update.js +3 -14
  10. package/dist/commands/actions/update.js.map +1 -1
  11. package/dist/commands/ads/index.d.ts.map +1 -1
  12. package/dist/commands/ads/index.js +8 -2
  13. package/dist/commands/ads/index.js.map +1 -1
  14. package/dist/commands/ads/meta/account.d.ts +11 -0
  15. package/dist/commands/ads/meta/account.d.ts.map +1 -0
  16. package/dist/commands/ads/meta/account.js +32 -0
  17. package/dist/commands/ads/meta/account.js.map +1 -0
  18. package/dist/commands/ads/meta/accounts.d.ts +20 -0
  19. package/dist/commands/ads/meta/accounts.d.ts.map +1 -0
  20. package/dist/commands/ads/meta/accounts.js +55 -0
  21. package/dist/commands/ads/meta/accounts.js.map +1 -0
  22. package/dist/commands/ads/meta/activities.d.ts +24 -0
  23. package/dist/commands/ads/meta/activities.d.ts.map +1 -0
  24. package/dist/commands/ads/meta/activities.js +44 -0
  25. package/dist/commands/ads/meta/activities.js.map +1 -0
  26. package/dist/commands/ads/meta/ads.d.ts +32 -0
  27. package/dist/commands/ads/meta/ads.d.ts.map +1 -0
  28. package/dist/commands/ads/meta/ads.js +54 -0
  29. package/dist/commands/ads/meta/ads.js.map +1 -0
  30. package/dist/commands/ads/meta/adsets.d.ts +28 -0
  31. package/dist/commands/ads/meta/adsets.d.ts.map +1 -0
  32. package/dist/commands/ads/meta/adsets.js +47 -0
  33. package/dist/commands/ads/meta/adsets.js.map +1 -0
  34. package/dist/commands/ads/meta/audiences.d.ts +20 -0
  35. package/dist/commands/ads/meta/audiences.d.ts.map +1 -0
  36. package/dist/commands/ads/meta/audiences.js +41 -0
  37. package/dist/commands/ads/meta/audiences.js.map +1 -0
  38. package/dist/commands/ads/meta/businesses.d.ts +12 -0
  39. package/dist/commands/ads/meta/businesses.d.ts.map +1 -0
  40. package/dist/commands/ads/meta/businesses.js +35 -0
  41. package/dist/commands/ads/meta/businesses.js.map +1 -0
  42. package/dist/commands/ads/meta/campaigns.d.ts +24 -0
  43. package/dist/commands/ads/meta/campaigns.d.ts.map +1 -0
  44. package/dist/commands/ads/meta/campaigns.js +48 -0
  45. package/dist/commands/ads/meta/campaigns.js.map +1 -0
  46. package/dist/commands/ads/meta/catalogs.d.ts +17 -0
  47. package/dist/commands/ads/meta/catalogs.d.ts.map +1 -0
  48. package/dist/commands/ads/meta/catalogs.js +37 -0
  49. package/dist/commands/ads/meta/catalogs.js.map +1 -0
  50. package/dist/commands/ads/meta/creatives.d.ts +24 -0
  51. package/dist/commands/ads/meta/creatives.d.ts.map +1 -0
  52. package/dist/commands/ads/meta/creatives.js +51 -0
  53. package/dist/commands/ads/meta/creatives.js.map +1 -0
  54. package/dist/commands/ads/meta/currency.d.ts +11 -0
  55. package/dist/commands/ads/meta/currency.d.ts.map +1 -0
  56. package/dist/commands/ads/meta/currency.js +31 -0
  57. package/dist/commands/ads/meta/currency.js.map +1 -0
  58. package/dist/commands/ads/meta/high-demand-periods.d.ts +17 -0
  59. package/dist/commands/ads/meta/high-demand-periods.d.ts.map +1 -0
  60. package/dist/commands/ads/meta/high-demand-periods.js +33 -0
  61. package/dist/commands/ads/meta/high-demand-periods.js.map +1 -0
  62. package/dist/commands/ads/meta/images.d.ts +24 -0
  63. package/dist/commands/ads/meta/images.d.ts.map +1 -0
  64. package/dist/commands/ads/meta/images.js +45 -0
  65. package/dist/commands/ads/meta/images.js.map +1 -0
  66. package/dist/commands/ads/meta/index.d.ts +2 -0
  67. package/dist/commands/ads/meta/index.d.ts.map +1 -0
  68. package/dist/commands/ads/meta/index.js +76 -0
  69. package/dist/commands/ads/meta/index.js.map +1 -0
  70. package/dist/commands/ads/meta/insights.d.ts +81 -0
  71. package/dist/commands/ads/meta/insights.d.ts.map +1 -0
  72. package/dist/commands/ads/meta/insights.js +178 -0
  73. package/dist/commands/ads/meta/insights.js.map +1 -0
  74. package/dist/commands/ads/meta/labels.d.ts +16 -0
  75. package/dist/commands/ads/meta/labels.d.ts.map +1 -0
  76. package/dist/commands/ads/meta/labels.js +34 -0
  77. package/dist/commands/ads/meta/labels.js.map +1 -0
  78. package/dist/commands/ads/meta/pixels.d.ts +33 -0
  79. package/dist/commands/ads/meta/pixels.d.ts.map +1 -0
  80. package/dist/commands/ads/meta/pixels.js +69 -0
  81. package/dist/commands/ads/meta/pixels.js.map +1 -0
  82. package/dist/commands/ads/meta/presets.d.ts +18 -0
  83. package/dist/commands/ads/meta/presets.d.ts.map +1 -0
  84. package/dist/commands/ads/meta/presets.js +110 -0
  85. package/dist/commands/ads/meta/presets.js.map +1 -0
  86. package/dist/commands/ads/meta/preview.d.ts +32 -0
  87. package/dist/commands/ads/meta/preview.d.ts.map +1 -0
  88. package/dist/commands/ads/meta/preview.js +90 -0
  89. package/dist/commands/ads/meta/preview.js.map +1 -0
  90. package/dist/commands/ads/meta/shared.d.ts +12 -0
  91. package/dist/commands/ads/meta/shared.d.ts.map +1 -0
  92. package/dist/commands/ads/meta/shared.js +59 -0
  93. package/dist/commands/ads/meta/shared.js.map +1 -0
  94. package/dist/commands/ads/meta/studies.d.ts +24 -0
  95. package/dist/commands/ads/meta/studies.d.ts.map +1 -0
  96. package/dist/commands/ads/meta/studies.js +56 -0
  97. package/dist/commands/ads/meta/studies.js.map +1 -0
  98. package/dist/env.d.ts +1 -0
  99. package/dist/env.d.ts.map +1 -1
  100. package/dist/env.js +1 -0
  101. package/dist/env.js.map +1 -1
  102. package/dist/error-handler.d.ts +1 -1
  103. package/dist/error-handler.d.ts.map +1 -1
  104. package/dist/error-handler.js +3 -0
  105. package/dist/error-handler.js.map +1 -1
  106. package/package.json +1 -1
@@ -0,0 +1,45 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
5
+ export const imagesCommand = defineCommand({
6
+ meta: {
7
+ name: "images",
8
+ description: `List ad images in a Meta ad account. AdImages are keyed by per-account hash — references in
9
+ creatives use image_hash, not URL.
10
+
11
+ Examples:
12
+ baker ads meta images --account-id act_123
13
+ baker ads meta images --account-id act_123 --hash a1b2c3...`,
14
+ },
15
+ args: {
16
+ "account-id": { type: "string", description: "Meta ad account ID" },
17
+ hash: { type: "string", description: "Filter to one image hash" },
18
+ limit: { type: "string", description: "Max rows (default 500)" },
19
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
20
+ output: { type: "string", description: "Output format", default: "json" },
21
+ },
22
+ run: async ({ args }) => {
23
+ const accountId = resolveAccountIdArg(args);
24
+ try {
25
+ const params = { "account-id": accountId };
26
+ if (args.hash)
27
+ params.hash = args.hash;
28
+ if (args.limit)
29
+ params.limit = args.limit;
30
+ if (args["skip-cache"])
31
+ params["skip-cache"] = "true";
32
+ const data = await apiGet("/api/ads/meta/images", params);
33
+ const fmt = csvOrJson(args);
34
+ if (fmt !== "json") {
35
+ writeAdsOutput(data, fmt);
36
+ return;
37
+ }
38
+ writeAdsJson({ ok: true, data });
39
+ }
40
+ catch (err) {
41
+ handleMetaError(err);
42
+ }
43
+ },
44
+ });
45
+ //# sourceMappingURL=images.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"images.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;8DAK6C;KAC3D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;QACjE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QAChE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;YACjD,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare const metaCommand: import("citty").CommandDef<import("citty").ArgsDef>;
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,WAAW,qDAuDtB,CAAC"}
@@ -0,0 +1,76 @@
1
+ import { defineCommand } from "citty";
2
+ import { accountCommand } from "./account.js";
3
+ import { accountsCommand } from "./accounts.js";
4
+ import { activitiesCommand } from "./activities.js";
5
+ import { adsListCommand } from "./ads.js";
6
+ import { adsetsCommand } from "./adsets.js";
7
+ import { audiencesCommand } from "./audiences.js";
8
+ import { businessesCommand } from "./businesses.js";
9
+ import { campaignsCommand } from "./campaigns.js";
10
+ import { catalogsCommand } from "./catalogs.js";
11
+ import { creativesCommand } from "./creatives.js";
12
+ import { currencyCommand } from "./currency.js";
13
+ import { highDemandPeriodsCommand } from "./high-demand-periods.js";
14
+ import { imagesCommand } from "./images.js";
15
+ import { insightsCommand } from "./insights.js";
16
+ import { labelsCommand } from "./labels.js";
17
+ import { pixelsCommand } from "./pixels.js";
18
+ import { previewCommand } from "./preview.js";
19
+ import { studiesCommand } from "./studies.js";
20
+ export const metaCommand = defineCommand({
21
+ meta: {
22
+ name: "meta",
23
+ description: `Meta Marketing API (Facebook + Instagram ads).
24
+
25
+ Discovery:
26
+ baker ads meta accounts — accounts in this company's connected scope
27
+ baker ads meta accounts --include-all — every account the token can see
28
+ baker ads meta businesses — Business Manager IDs
29
+
30
+ Account-scoped:
31
+ baker ads meta account --account-id act_123
32
+ baker ads meta currency --account-id act_123
33
+ baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
34
+ baker ads meta adsets --campaign-id 6123
35
+ baker ads meta ads --account-id act_123 --effective-status ACTIVE
36
+ baker ads meta creatives --account-id act_123
37
+ baker ads meta images --account-id act_123
38
+ baker ads meta labels --account-id act_123
39
+ baker ads meta audiences --account-id act_123
40
+ baker ads meta pixels --account-id act_123
41
+ baker ads meta activities --account-id act_123 --days 14
42
+
43
+ Insights + previews:
44
+ baker ads meta insights --object act_123 --preset campaign-performance
45
+ baker ads meta insights --object act_123 --preset placement-breakdown --async
46
+ baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
47
+
48
+ Business-scoped:
49
+ baker ads meta studies --business-id 12345
50
+ baker ads meta catalogs --business-id 12345
51
+
52
+ Other:
53
+ baker ads meta high-demand-periods --campaign-id 6123`,
54
+ },
55
+ subCommands: {
56
+ accounts: accountsCommand,
57
+ account: accountCommand,
58
+ currency: currencyCommand,
59
+ businesses: businessesCommand,
60
+ campaigns: campaignsCommand,
61
+ adsets: adsetsCommand,
62
+ ads: adsListCommand,
63
+ creatives: creativesCommand,
64
+ images: imagesCommand,
65
+ labels: labelsCommand,
66
+ audiences: audiencesCommand,
67
+ pixels: pixelsCommand,
68
+ studies: studiesCommand,
69
+ catalogs: catalogsCommand,
70
+ "high-demand-periods": highDemandPeriodsCommand,
71
+ activities: activitiesCommand,
72
+ insights: insightsCommand,
73
+ preview: previewCommand,
74
+ },
75
+ });
76
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA8BuC;KACrD;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,qBAAqB,EAAE,wBAAwB;QAC/C,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}
@@ -0,0 +1,81 @@
1
+ export declare const insightsCommand: import("citty").CommandDef<{
2
+ readonly object: {
3
+ readonly type: "string";
4
+ readonly description: "Object ID — act_<id> for account, or campaign/adset/ad ID";
5
+ readonly required: true;
6
+ };
7
+ readonly level: {
8
+ readonly type: "string";
9
+ readonly description: "account|campaign|adset|ad";
10
+ };
11
+ readonly fields: {
12
+ readonly type: "string";
13
+ readonly description: "Comma-separated fields list";
14
+ };
15
+ readonly preset: {
16
+ readonly type: "string";
17
+ readonly description: "Insights preset name";
18
+ };
19
+ readonly "list-presets": {
20
+ readonly type: "boolean";
21
+ readonly description: "List available presets and exit";
22
+ };
23
+ readonly "date-preset": {
24
+ readonly type: "string";
25
+ readonly description: "Meta date preset (last_7d, last_28d, today, ...)";
26
+ };
27
+ readonly since: {
28
+ readonly type: "string";
29
+ readonly description: "Custom start date YYYY-MM-DD";
30
+ };
31
+ readonly until: {
32
+ readonly type: "string";
33
+ readonly description: "Custom end date YYYY-MM-DD";
34
+ };
35
+ readonly "time-increment": {
36
+ readonly type: "string";
37
+ readonly description: "1 (day) | monthly | all_days";
38
+ };
39
+ readonly breakdowns: {
40
+ readonly type: "string";
41
+ readonly description: "Comma-separated breakdowns";
42
+ };
43
+ readonly "action-breakdowns": {
44
+ readonly type: "string";
45
+ readonly description: "Comma-separated action_breakdowns";
46
+ };
47
+ readonly filtering: {
48
+ readonly type: "string";
49
+ readonly description: "JSON array of {field,operator,value}";
50
+ };
51
+ readonly "attribution-windows": {
52
+ readonly type: "string";
53
+ readonly description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of Jan 2026";
54
+ };
55
+ readonly "use-account-attribution": {
56
+ readonly type: "boolean";
57
+ readonly description: "Use account-saved attribution setting";
58
+ };
59
+ readonly "use-unified-attribution": {
60
+ readonly type: "boolean";
61
+ readonly description: "Use ad-set unified attribution setting";
62
+ };
63
+ readonly limit: {
64
+ readonly type: "string";
65
+ readonly description: "Max rows (default per preset)";
66
+ };
67
+ readonly async: {
68
+ readonly type: "boolean";
69
+ readonly description: "Submit as async job, poll, then dump results";
70
+ };
71
+ readonly "skip-cache": {
72
+ readonly type: "boolean";
73
+ readonly description: "Bypass server-side cache";
74
+ };
75
+ readonly output: {
76
+ readonly type: "string";
77
+ readonly description: "Output format";
78
+ readonly default: "json";
79
+ };
80
+ }>;
81
+ //# sourceMappingURL=insights.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"AAqHA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2F1B,CAAC"}
@@ -0,0 +1,178 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiPost } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { getPreset, listPresets } from "./presets.js";
5
+ import { csvOrJson, getDateRange, handleMetaError } from "./shared.js";
6
+ const POLL_INTERVAL_MS = 5_000;
7
+ const POLL_MAX_MS = 10 * 60_000;
8
+ function commaSplit(input) {
9
+ if (!input)
10
+ return undefined;
11
+ return input
12
+ .split(",")
13
+ .map((s) => s.trim())
14
+ .filter(Boolean);
15
+ }
16
+ function parseFiltering(raw) {
17
+ if (!raw)
18
+ return undefined;
19
+ try {
20
+ return JSON.parse(raw);
21
+ }
22
+ catch {
23
+ handleMetaError(new Error("Invalid --filtering JSON"));
24
+ }
25
+ }
26
+ function pickLevel(args, preset) {
27
+ const level = args.level ?? preset?.level;
28
+ if (!level) {
29
+ handleMetaError(new Error("--level is required (account|campaign|adset|ad)"));
30
+ }
31
+ return level;
32
+ }
33
+ function pickFields(fieldsArg, preset) {
34
+ const fields = fieldsArg ?? preset?.fields;
35
+ if (!fields || fields.length === 0) {
36
+ handleMetaError(new Error("--fields is required (comma-separated, e.g. impressions,spend,ctr)"));
37
+ }
38
+ return fields;
39
+ }
40
+ function applyDateRange(body, args, preset) {
41
+ const range = getDateRange(args);
42
+ if (range.datePreset)
43
+ body.datePreset = range.datePreset;
44
+ if (range.since)
45
+ body.since = range.since;
46
+ if (range.until)
47
+ body.until = range.until;
48
+ if (!body.datePreset && !(body.since && body.until)) {
49
+ body.datePreset = preset?.defaultDatePreset ?? "last_7d";
50
+ }
51
+ }
52
+ function buildBodyFromArgs(args, preset) {
53
+ const fieldsArg = commaSplit(args.fields);
54
+ const breakdowns = commaSplit(args.breakdowns);
55
+ const actionBreakdowns = commaSplit(args["action-breakdowns"]);
56
+ const attributionWindows = commaSplit(args["attribution-windows"]);
57
+ const body = {
58
+ object: args.object,
59
+ level: pickLevel(args, preset),
60
+ fields: pickFields(fieldsArg, preset),
61
+ timeIncrement: args["time-increment"],
62
+ breakdowns: breakdowns ?? preset?.breakdowns,
63
+ actionBreakdowns: actionBreakdowns ?? preset?.actionBreakdowns,
64
+ filtering: parseFiltering(args.filtering),
65
+ attributionWindows: attributionWindows ?? preset?.attributionWindows,
66
+ useAccountAttributionSetting: Boolean(args["use-account-attribution"]),
67
+ useUnifiedAttributionSetting: Boolean(args["use-unified-attribution"]),
68
+ limit: args.limit ? Number(args.limit) : preset?.defaultLimit,
69
+ skipCache: Boolean(args["skip-cache"]),
70
+ };
71
+ applyDateRange(body, args, preset);
72
+ return body;
73
+ }
74
+ async function pollAsync(reportRunId) {
75
+ const start = Date.now();
76
+ while (Date.now() - start < POLL_MAX_MS) {
77
+ const status = await apiPost(`/api/ads/meta/insights/async/status?report-run-id=${encodeURIComponent(reportRunId)}`, {});
78
+ if (status.async_status === "Job Completed")
79
+ return;
80
+ if (status.async_status === "Job Failed" || status.async_status === "Job Skipped") {
81
+ handleMetaError(new Error(`Async insights job ${status.async_status}`));
82
+ }
83
+ process.stderr.write(`Async insights ${status.async_status ?? "queued"} (${Math.round(status.async_percent_completion ?? 0)}%)…\n`);
84
+ await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
85
+ }
86
+ handleMetaError(new Error("Async insights polling timed out after 10 minutes"));
87
+ }
88
+ export const insightsCommand = defineCommand({
89
+ meta: {
90
+ name: "insights",
91
+ description: `Run Meta Marketing API insights queries.
92
+
93
+ Synchronous unless --async is set, or auto-fallback if Meta returns a "too large" error.
94
+ Use presets for the marketing team's standard reports.
95
+
96
+ Presets (run with --preset <name>):
97
+ ${listPresets()
98
+ .map((p) => ` ${p.name} — ${p.description}`)
99
+ .join("\n")}
100
+
101
+ Examples:
102
+ baker ads meta insights --object act_123 --level ad --fields impressions,spend --date-preset last_7d
103
+ baker ads meta insights --object 6123456 --preset campaign-performance
104
+ baker ads meta insights --object act_123 --preset placement-breakdown --since 2026-01-01 --until 2026-03-31 --async
105
+ baker ads meta insights --object act_123 --level ad --fields ad_id,impressions \\
106
+ --filtering '[{"field":"spend","operator":"GREATER_THAN","value":0}]'`,
107
+ },
108
+ args: {
109
+ object: {
110
+ type: "string",
111
+ description: "Object ID — act_<id> for account, or campaign/adset/ad ID",
112
+ required: true,
113
+ },
114
+ level: { type: "string", description: "account|campaign|adset|ad" },
115
+ fields: { type: "string", description: "Comma-separated fields list" },
116
+ preset: { type: "string", description: "Insights preset name" },
117
+ "list-presets": { type: "boolean", description: "List available presets and exit" },
118
+ "date-preset": { type: "string", description: "Meta date preset (last_7d, last_28d, today, ...)" },
119
+ since: { type: "string", description: "Custom start date YYYY-MM-DD" },
120
+ until: { type: "string", description: "Custom end date YYYY-MM-DD" },
121
+ "time-increment": { type: "string", description: "1 (day) | monthly | all_days" },
122
+ breakdowns: { type: "string", description: "Comma-separated breakdowns" },
123
+ "action-breakdowns": { type: "string", description: "Comma-separated action_breakdowns" },
124
+ filtering: { type: "string", description: "JSON array of {field,operator,value}" },
125
+ "attribution-windows": {
126
+ type: "string",
127
+ description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of Jan 2026",
128
+ },
129
+ "use-account-attribution": { type: "boolean", description: "Use account-saved attribution setting" },
130
+ "use-unified-attribution": { type: "boolean", description: "Use ad-set unified attribution setting" },
131
+ limit: { type: "string", description: "Max rows (default per preset)" },
132
+ async: { type: "boolean", description: "Submit as async job, poll, then dump results" },
133
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
134
+ output: { type: "string", description: "Output format", default: "json" },
135
+ },
136
+ run: async ({ args }) => {
137
+ if (args["list-presets"]) {
138
+ writeAdsJson({ ok: true, data: listPresets() });
139
+ return;
140
+ }
141
+ const presetName = args.preset;
142
+ const preset = presetName ? getPreset(presetName) : undefined;
143
+ if (presetName && !preset) {
144
+ handleMetaError(new Error(`Unknown preset: ${presetName}. Use --list-presets.`));
145
+ }
146
+ const body = buildBodyFromArgs(args, preset);
147
+ try {
148
+ if (args.async) {
149
+ const submit = await apiPost("/api/ads/meta/insights/async", body);
150
+ process.stderr.write(`Submitted async insights job: ${submit.reportRunId}\n`);
151
+ await pollAsync(submit.reportRunId);
152
+ const result = await apiPost("/api/ads/meta/insights/async/result", {
153
+ reportRunId: submit.reportRunId,
154
+ fields: body.fields,
155
+ limit: body.limit,
156
+ });
157
+ const fmt = csvOrJson(args);
158
+ if (fmt !== "json") {
159
+ writeAdsOutput(result, fmt, body.fields);
160
+ return;
161
+ }
162
+ writeAdsJson({ ok: true, data: result });
163
+ return;
164
+ }
165
+ const data = await apiPost("/api/ads/meta/insights", body);
166
+ const fmt = csvOrJson(args);
167
+ if (fmt !== "json") {
168
+ writeAdsOutput(data, fmt, body.fields);
169
+ return;
170
+ }
171
+ writeAdsJson({ ok: true, data });
172
+ }
173
+ catch (err) {
174
+ handleMetaError(err);
175
+ }
176
+ },
177
+ });
178
+ //# sourceMappingURL=insights.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"insights.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ export declare const labelsCommand: import("citty").CommandDef<{
2
+ readonly "account-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta ad account ID";
5
+ };
6
+ readonly "skip-cache": {
7
+ readonly type: "boolean";
8
+ readonly description: "Bypass server-side cache";
9
+ };
10
+ readonly output: {
11
+ readonly type: "string";
12
+ readonly description: "Output format";
13
+ readonly default: "json";
14
+ };
15
+ }>;
16
+ //# sourceMappingURL=labels.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;EA0BxB,CAAC"}
@@ -0,0 +1,34 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
5
+ export const labelsCommand = defineCommand({
6
+ meta: {
7
+ name: "labels",
8
+ description: `List ad labels for a Meta ad account.`,
9
+ },
10
+ args: {
11
+ "account-id": { type: "string", description: "Meta ad account ID" },
12
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
13
+ output: { type: "string", description: "Output format", default: "json" },
14
+ },
15
+ run: async ({ args }) => {
16
+ const accountId = resolveAccountIdArg(args);
17
+ try {
18
+ const params = { "account-id": accountId };
19
+ if (args["skip-cache"])
20
+ params["skip-cache"] = "true";
21
+ const data = await apiGet("/api/ads/meta/labels", params);
22
+ const fmt = csvOrJson(args);
23
+ if (fmt !== "json") {
24
+ writeAdsOutput(data, fmt);
25
+ return;
26
+ }
27
+ writeAdsJson({ ok: true, data });
28
+ }
29
+ catch (err) {
30
+ handleMetaError(err);
31
+ }
32
+ },
33
+ });
34
+ //# sourceMappingURL=labels.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,33 @@
1
+ export declare const pixelsCommand: import("citty").CommandDef<{
2
+ readonly "account-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta ad account ID";
5
+ };
6
+ readonly "pixel-id": {
7
+ readonly type: "string";
8
+ readonly description: "Pixel ID for --stats";
9
+ };
10
+ readonly stats: {
11
+ readonly type: "boolean";
12
+ readonly description: "Fetch firing stats for the pixel";
13
+ };
14
+ readonly aggregation: {
15
+ readonly type: "string";
16
+ readonly description: "stats aggregation: event|browser_type|host|pixel_fire";
17
+ readonly default: "event";
18
+ };
19
+ readonly days: {
20
+ readonly type: "string";
21
+ readonly description: "Lookback days for --stats (default 7)";
22
+ };
23
+ readonly "skip-cache": {
24
+ readonly type: "boolean";
25
+ readonly description: "Bypass server-side cache";
26
+ };
27
+ readonly output: {
28
+ readonly type: "string";
29
+ readonly description: "Output format";
30
+ readonly default: "json";
31
+ };
32
+ }>;
33
+ //# sourceMappingURL=pixels.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pixels.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/pixels.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DxB,CAAC"}
@@ -0,0 +1,69 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from "./shared.js";
5
+ export const pixelsCommand = defineCommand({
6
+ meta: {
7
+ name: "pixels",
8
+ description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
9
+
10
+ Examples:
11
+ baker ads meta pixels --account-id act_123
12
+ baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,
13
+ },
14
+ args: {
15
+ "account-id": { type: "string", description: "Meta ad account ID" },
16
+ "pixel-id": { type: "string", description: "Pixel ID for --stats" },
17
+ stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
18
+ aggregation: {
19
+ type: "string",
20
+ description: "stats aggregation: event|browser_type|host|pixel_fire",
21
+ default: "event",
22
+ },
23
+ days: { type: "string", description: "Lookback days for --stats (default 7)" },
24
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
25
+ output: { type: "string", description: "Output format", default: "json" },
26
+ },
27
+ run: async ({ args }) => {
28
+ try {
29
+ if (args.stats) {
30
+ const pixelId = args["pixel-id"];
31
+ if (!pixelId) {
32
+ handleMetaError(new Error("--pixel-id is required when --stats is set"));
33
+ }
34
+ const days = args.days ? Number(args.days) : 7;
35
+ const params = {
36
+ "pixel-id": pixelId,
37
+ aggregation: args.aggregation ?? "event",
38
+ "start-time": daysAgoIso(days),
39
+ "end-time": todayIso(),
40
+ };
41
+ if (args["skip-cache"])
42
+ params["skip-cache"] = "true";
43
+ const data = await apiGet("/api/ads/meta/pixel-stats", params);
44
+ const fmt = csvOrJson(args);
45
+ if (fmt !== "json") {
46
+ writeAdsOutput(data, fmt);
47
+ return;
48
+ }
49
+ writeAdsJson({ ok: true, data });
50
+ return;
51
+ }
52
+ const accountId = resolveAccountIdArg(args);
53
+ const params = { "account-id": accountId };
54
+ if (args["skip-cache"])
55
+ params["skip-cache"] = "true";
56
+ const data = await apiGet("/api/ads/meta/pixels", params);
57
+ const fmt = csvOrJson(args);
58
+ if (fmt !== "json") {
59
+ writeAdsOutput(data, fmt);
60
+ return;
61
+ }
62
+ writeAdsJson({ ok: true, data });
63
+ }
64
+ catch (err) {
65
+ handleMetaError(err);
66
+ }
67
+ },
68
+ });
69
+ //# sourceMappingURL=pixels.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pixels.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/pixels.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Meta-native insights presets. Names + fields chosen for our marketing team's
3
+ * review workflows — not parity-aligned with the Google Ads presets.
4
+ */
5
+ export interface MetaInsightsPreset {
6
+ name: string;
7
+ description: string;
8
+ level: "account" | "campaign" | "adset" | "ad";
9
+ fields: string[];
10
+ breakdowns?: string[];
11
+ actionBreakdowns?: string[];
12
+ attributionWindows?: string[];
13
+ defaultDatePreset: string;
14
+ defaultLimit: number;
15
+ }
16
+ export declare function getPreset(name: string): MetaInsightsPreset | undefined;
17
+ export declare function listPresets(): MetaInsightsPreset[];
18
+ //# sourceMappingURL=presets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/presets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAsGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED,wBAAgB,WAAW,IAAI,kBAAkB,EAAE,CAElD"}