@koda-sl/baker-cli 0.23.0 → 0.25.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 (98) hide show
  1. package/README.md +96 -0
  2. package/dist/cli.js +1 -1
  3. package/dist/commands/ads/index.d.ts.map +1 -1
  4. package/dist/commands/ads/index.js +8 -2
  5. package/dist/commands/ads/index.js.map +1 -1
  6. package/dist/commands/ads/meta/account.d.ts +11 -0
  7. package/dist/commands/ads/meta/account.d.ts.map +1 -0
  8. package/dist/commands/ads/meta/account.js +32 -0
  9. package/dist/commands/ads/meta/account.js.map +1 -0
  10. package/dist/commands/ads/meta/accounts.d.ts +20 -0
  11. package/dist/commands/ads/meta/accounts.d.ts.map +1 -0
  12. package/dist/commands/ads/meta/accounts.js +55 -0
  13. package/dist/commands/ads/meta/accounts.js.map +1 -0
  14. package/dist/commands/ads/meta/activities.d.ts +24 -0
  15. package/dist/commands/ads/meta/activities.d.ts.map +1 -0
  16. package/dist/commands/ads/meta/activities.js +44 -0
  17. package/dist/commands/ads/meta/activities.js.map +1 -0
  18. package/dist/commands/ads/meta/ads.d.ts +36 -0
  19. package/dist/commands/ads/meta/ads.d.ts.map +1 -0
  20. package/dist/commands/ads/meta/ads.js +57 -0
  21. package/dist/commands/ads/meta/ads.js.map +1 -0
  22. package/dist/commands/ads/meta/adsets.d.ts +32 -0
  23. package/dist/commands/ads/meta/adsets.d.ts.map +1 -0
  24. package/dist/commands/ads/meta/adsets.js +50 -0
  25. package/dist/commands/ads/meta/adsets.js.map +1 -0
  26. package/dist/commands/ads/meta/audiences.d.ts +20 -0
  27. package/dist/commands/ads/meta/audiences.d.ts.map +1 -0
  28. package/dist/commands/ads/meta/audiences.js +41 -0
  29. package/dist/commands/ads/meta/audiences.js.map +1 -0
  30. package/dist/commands/ads/meta/businesses.d.ts +12 -0
  31. package/dist/commands/ads/meta/businesses.d.ts.map +1 -0
  32. package/dist/commands/ads/meta/businesses.js +35 -0
  33. package/dist/commands/ads/meta/businesses.js.map +1 -0
  34. package/dist/commands/ads/meta/campaigns.d.ts +28 -0
  35. package/dist/commands/ads/meta/campaigns.d.ts.map +1 -0
  36. package/dist/commands/ads/meta/campaigns.js +51 -0
  37. package/dist/commands/ads/meta/campaigns.js.map +1 -0
  38. package/dist/commands/ads/meta/catalogs.d.ts +17 -0
  39. package/dist/commands/ads/meta/catalogs.d.ts.map +1 -0
  40. package/dist/commands/ads/meta/catalogs.js +37 -0
  41. package/dist/commands/ads/meta/catalogs.js.map +1 -0
  42. package/dist/commands/ads/meta/creatives.d.ts +24 -0
  43. package/dist/commands/ads/meta/creatives.d.ts.map +1 -0
  44. package/dist/commands/ads/meta/creatives.js +51 -0
  45. package/dist/commands/ads/meta/creatives.js.map +1 -0
  46. package/dist/commands/ads/meta/currency.d.ts +11 -0
  47. package/dist/commands/ads/meta/currency.d.ts.map +1 -0
  48. package/dist/commands/ads/meta/currency.js +31 -0
  49. package/dist/commands/ads/meta/currency.js.map +1 -0
  50. package/dist/commands/ads/meta/high-demand-periods.d.ts +17 -0
  51. package/dist/commands/ads/meta/high-demand-periods.d.ts.map +1 -0
  52. package/dist/commands/ads/meta/high-demand-periods.js +33 -0
  53. package/dist/commands/ads/meta/high-demand-periods.js.map +1 -0
  54. package/dist/commands/ads/meta/images.d.ts +24 -0
  55. package/dist/commands/ads/meta/images.d.ts.map +1 -0
  56. package/dist/commands/ads/meta/images.js +45 -0
  57. package/dist/commands/ads/meta/images.js.map +1 -0
  58. package/dist/commands/ads/meta/index.d.ts +17 -0
  59. package/dist/commands/ads/meta/index.d.ts.map +1 -0
  60. package/dist/commands/ads/meta/index.js +79 -0
  61. package/dist/commands/ads/meta/index.js.map +1 -0
  62. package/dist/commands/ads/meta/insights.d.ts +93 -0
  63. package/dist/commands/ads/meta/insights.d.ts.map +1 -0
  64. package/dist/commands/ads/meta/insights.js +254 -0
  65. package/dist/commands/ads/meta/insights.js.map +1 -0
  66. package/dist/commands/ads/meta/labels.d.ts +16 -0
  67. package/dist/commands/ads/meta/labels.d.ts.map +1 -0
  68. package/dist/commands/ads/meta/labels.js +34 -0
  69. package/dist/commands/ads/meta/labels.js.map +1 -0
  70. package/dist/commands/ads/meta/pixels.d.ts +33 -0
  71. package/dist/commands/ads/meta/pixels.d.ts.map +1 -0
  72. package/dist/commands/ads/meta/pixels.js +69 -0
  73. package/dist/commands/ads/meta/pixels.js.map +1 -0
  74. package/dist/commands/ads/meta/presets.d.ts +30 -0
  75. package/dist/commands/ads/meta/presets.d.ts.map +1 -0
  76. package/dist/commands/ads/meta/presets.js +86 -0
  77. package/dist/commands/ads/meta/presets.js.map +1 -0
  78. package/dist/commands/ads/meta/preview.d.ts +32 -0
  79. package/dist/commands/ads/meta/preview.d.ts.map +1 -0
  80. package/dist/commands/ads/meta/preview.js +90 -0
  81. package/dist/commands/ads/meta/preview.js.map +1 -0
  82. package/dist/commands/ads/meta/shared.d.ts +18 -0
  83. package/dist/commands/ads/meta/shared.d.ts.map +1 -0
  84. package/dist/commands/ads/meta/shared.js +74 -0
  85. package/dist/commands/ads/meta/shared.js.map +1 -0
  86. package/dist/commands/ads/meta/studies.d.ts +24 -0
  87. package/dist/commands/ads/meta/studies.d.ts.map +1 -0
  88. package/dist/commands/ads/meta/studies.js +56 -0
  89. package/dist/commands/ads/meta/studies.js.map +1 -0
  90. package/dist/env.d.ts +1 -0
  91. package/dist/env.d.ts.map +1 -1
  92. package/dist/env.js +1 -0
  93. package/dist/env.js.map +1 -1
  94. package/dist/error-handler.d.ts +1 -1
  95. package/dist/error-handler.d.ts.map +1 -1
  96. package/dist/error-handler.js +3 -0
  97. package/dist/error-handler.js.map +1 -1
  98. package/package.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audiences.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/audiences.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,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;gDAI+B;KAC7C;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;QAClD,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,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,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC7F,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,12 @@
1
+ export declare const businessesCommand: import("citty").CommandDef<{
2
+ readonly "skip-cache": {
3
+ readonly type: "boolean";
4
+ readonly description: "Bypass server-side cache";
5
+ };
6
+ readonly output: {
7
+ readonly type: "string";
8
+ readonly description: "Output format";
9
+ readonly default: "json";
10
+ };
11
+ }>;
12
+ //# sourceMappingURL=businesses.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"businesses.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/businesses.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB;;;;;;;;;;EA2B5B,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, handleMetaError } from "./shared.js";
5
+ export const businessesCommand = defineCommand({
6
+ meta: {
7
+ name: "businesses",
8
+ description: `List Meta Business Manager accounts the connected user has access to. Required for ad-studies and product-catalogs commands.
9
+
10
+ Examples:
11
+ baker ads meta businesses`,
12
+ },
13
+ args: {
14
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
15
+ output: { type: "string", description: "Output format", default: "json" },
16
+ },
17
+ run: async ({ args }) => {
18
+ try {
19
+ const params = {};
20
+ if (args["skip-cache"])
21
+ params["skip-cache"] = "true";
22
+ const data = await apiGet("/api/ads/meta/businesses", params);
23
+ const fmt = csvOrJson(args);
24
+ if (fmt !== "json") {
25
+ writeAdsOutput(data, fmt);
26
+ return;
27
+ }
28
+ writeAdsJson({ ok: true, data });
29
+ }
30
+ catch (err) {
31
+ handleMetaError(err);
32
+ }
33
+ },
34
+ });
35
+ //# sourceMappingURL=businesses.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"businesses.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/businesses.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,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;4BAGW;KACzB;IACD,IAAI,EAAE;QACJ,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,0BAA0B,EAAE,MAAM,CAAC,CAAC;YAC9F,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,28 @@
1
+ export declare const campaignsCommand: import("citty").CommandDef<{
2
+ readonly "account-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta ad account ID";
5
+ };
6
+ readonly "effective-status": {
7
+ readonly type: "string";
8
+ readonly description: "Comma-separated effective_status filter (overrides default)";
9
+ };
10
+ readonly "all-statuses": {
11
+ readonly type: "boolean";
12
+ readonly description: "Drop the default ACTIVE filter and return everything";
13
+ };
14
+ readonly limit: {
15
+ readonly type: "string";
16
+ readonly description: "Max rows (default 1000)";
17
+ };
18
+ readonly "skip-cache": {
19
+ readonly type: "boolean";
20
+ readonly description: "Bypass server-side cache";
21
+ };
22
+ readonly output: {
23
+ readonly type: "string";
24
+ readonly description: "Output format";
25
+ readonly default: "json";
26
+ };
27
+ }>;
28
+ //# sourceMappingURL=campaigns.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC3B,CAAC"}
@@ -0,0 +1,51 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, handleMetaError, resolveAccountIdArg, resolveEffectiveStatus } from "./shared.js";
5
+ export const campaignsCommand = defineCommand({
6
+ meta: {
7
+ name: "campaigns",
8
+ description: `List campaigns for a Meta ad account. Defaults to ACTIVE only — pass --all-statuses to widen.
9
+
10
+ In Meta's API "campaign" is the top-of-tree object (what marketers usually call a campaign group).
11
+ The dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
12
+
13
+ Examples:
14
+ baker ads meta campaigns --account-id act_123 # ACTIVE only
15
+ baker ads meta campaigns --account-id act_123 --all-statuses # everything
16
+ baker ads meta campaigns --account-id act_123 --effective-status ACTIVE,PAUSED # custom set
17
+ baker ads meta campaigns --account-id act_123 --output csv`,
18
+ },
19
+ args: {
20
+ "account-id": { type: "string", description: "Meta ad account ID" },
21
+ "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
22
+ "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
23
+ limit: { type: "string", description: "Max rows (default 1000)" },
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
+ const accountId = resolveAccountIdArg(args);
29
+ const effectiveStatus = resolveEffectiveStatus(args);
30
+ try {
31
+ const params = { "account-id": accountId };
32
+ if (effectiveStatus)
33
+ params["effective-status"] = effectiveStatus;
34
+ if (args.limit)
35
+ params.limit = args.limit;
36
+ if (args["skip-cache"])
37
+ params["skip-cache"] = "true";
38
+ const data = await apiGet("/api/ads/meta/campaigns", params);
39
+ const fmt = csvOrJson(args);
40
+ if (fmt !== "json") {
41
+ writeAdsOutput(data, fmt);
42
+ return;
43
+ }
44
+ writeAdsJson({ ok: true, data });
45
+ }
46
+ catch (err) {
47
+ handleMetaError(err);
48
+ }
49
+ },
50
+ });
51
+ //# sourceMappingURL=campaigns.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.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,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;;6DAS4C;KAC1D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sDAAsD,EAAE;QACxG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,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,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,eAAe;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC;YAClE,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,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC7F,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,17 @@
1
+ export declare const catalogsCommand: import("citty").CommandDef<{
2
+ readonly "business-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta Business Manager ID";
5
+ readonly required: true;
6
+ };
7
+ readonly "skip-cache": {
8
+ readonly type: "boolean";
9
+ readonly description: "Bypass server-side cache";
10
+ };
11
+ readonly output: {
12
+ readonly type: "string";
13
+ readonly description: "Output format";
14
+ readonly default: "json";
15
+ };
16
+ }>;
17
+ //# sourceMappingURL=catalogs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalogs.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/catalogs.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EA6B1B,CAAC"}
@@ -0,0 +1,37 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, handleMetaError } from "./shared.js";
5
+ export const catalogsCommand = defineCommand({
6
+ meta: {
7
+ name: "catalogs",
8
+ description: `List product catalogs owned by a Meta Business. Vertical (commerce, hotels, vehicles, etc.)
9
+ is immutable once set.
10
+
11
+ Examples:
12
+ baker ads meta catalogs --business-id 1234567890`,
13
+ },
14
+ args: {
15
+ "business-id": { type: "string", description: "Meta Business Manager ID", required: true },
16
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
17
+ output: { type: "string", description: "Output format", default: "json" },
18
+ },
19
+ run: async ({ args }) => {
20
+ try {
21
+ const params = { "business-id": args["business-id"] };
22
+ if (args["skip-cache"])
23
+ params["skip-cache"] = "true";
24
+ const data = await apiGet("/api/ads/meta/catalogs", params);
25
+ const fmt = csvOrJson(args);
26
+ if (fmt !== "json") {
27
+ writeAdsOutput(data, fmt);
28
+ return;
29
+ }
30
+ writeAdsJson({ ok: true, data });
31
+ }
32
+ catch (err) {
33
+ handleMetaError(err);
34
+ }
35
+ },
36
+ });
37
+ //# sourceMappingURL=catalogs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/catalogs.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,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;mDAIkC;KAChD;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1F,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,CAAW,EAAE,CAAC;YACxF,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,wBAAwB,EAAE,MAAM,CAAC,CAAC;YAC5F,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,24 @@
1
+ export declare const creativesCommand: import("citty").CommandDef<{
2
+ readonly "account-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta ad account ID (required if no --creative-id)";
5
+ };
6
+ readonly "creative-id": {
7
+ readonly type: "string";
8
+ readonly description: "Single creative ID";
9
+ };
10
+ readonly limit: {
11
+ readonly type: "string";
12
+ readonly description: "Max rows (default 500)";
13
+ };
14
+ readonly "skip-cache": {
15
+ readonly type: "boolean";
16
+ readonly description: "Bypass server-side cache";
17
+ };
18
+ readonly output: {
19
+ readonly type: "string";
20
+ readonly description: "Output format";
21
+ readonly default: "json";
22
+ };
23
+ }>;
24
+ //# sourceMappingURL=creatives.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creatives.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/creatives.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EAyC3B,CAAC"}
@@ -0,0 +1,51 @@
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 creativesCommand = defineCommand({
6
+ meta: {
7
+ name: "creatives",
8
+ description: `List ad creatives in an account, or fetch a single creative by ID.
9
+
10
+ Important: Meta creatives are effectively immutable once attached to an ad. Editing copy/image/CTA = create
11
+ a new creative + reattach. Bake this into any agentic edit workflow.
12
+
13
+ Examples:
14
+ baker ads meta creatives --account-id act_123
15
+ baker ads meta creatives --creative-id 23842... # fetch one`,
16
+ },
17
+ args: {
18
+ "account-id": { type: "string", description: "Meta ad account ID (required if no --creative-id)" },
19
+ "creative-id": { type: "string", description: "Single creative ID" },
20
+ limit: { type: "string", description: "Max rows (default 500)" },
21
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
22
+ output: { type: "string", description: "Output format", default: "json" },
23
+ },
24
+ run: async ({ args }) => {
25
+ try {
26
+ const params = {};
27
+ if (args["creative-id"]) {
28
+ params["creative-id"] = args["creative-id"];
29
+ }
30
+ else {
31
+ const accountId = resolveAccountIdArg(args);
32
+ params["account-id"] = accountId;
33
+ }
34
+ if (args.limit)
35
+ params.limit = args.limit;
36
+ if (args["skip-cache"])
37
+ params["skip-cache"] = "true";
38
+ const data = await apiGet("/api/ads/meta/creatives", params);
39
+ const fmt = csvOrJson(args);
40
+ if (Array.isArray(data) && fmt !== "json") {
41
+ writeAdsOutput(data, fmt);
42
+ return;
43
+ }
44
+ writeAdsJson({ ok: true, data });
45
+ }
46
+ catch (err) {
47
+ handleMetaError(err);
48
+ }
49
+ },
50
+ });
51
+ //# sourceMappingURL=creatives.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creatives.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/creatives.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,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;gEAO+C;KAC7D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAClG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACpE,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;YACnC,CAAC;YACD,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,CAAU,yBAAyB,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBAC1C,cAAc,CAAC,IAAsC,EAAE,GAAG,CAAC,CAAC;gBAC5D,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,11 @@
1
+ export declare const currencyCommand: 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
+ }>;
11
+ //# sourceMappingURL=currency.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/currency.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe;;;;;;;;;EA0B1B,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson } from "../output.js";
4
+ import { handleMetaError, resolveAccountIdArg } from "./shared.js";
5
+ export const currencyCommand = defineCommand({
6
+ meta: {
7
+ name: "currency",
8
+ description: `Lookup the currency + timezone for a Meta ad account. Lightweight wrapper around the account detail endpoint, cached 1 day.
9
+
10
+ Examples:
11
+ baker ads meta currency --account-id act_123`,
12
+ },
13
+ args: {
14
+ "account-id": { type: "string", description: "Meta ad account ID" },
15
+ "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
16
+ },
17
+ run: async ({ args }) => {
18
+ const accountId = resolveAccountIdArg(args);
19
+ try {
20
+ const params = { "account-id": accountId };
21
+ if (args["skip-cache"])
22
+ params["skip-cache"] = "true";
23
+ const data = await apiGet("/api/ads/meta/currency", params);
24
+ writeAdsJson({ ok: true, data });
25
+ }
26
+ catch (err) {
27
+ handleMetaError(err);
28
+ }
29
+ },
30
+ });
31
+ //# sourceMappingURL=currency.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"currency.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/currency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;+CAG8B;KAC5C;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;KAC3E;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,CACvB,wBAAwB,EACxB,MAAM,CACP,CAAC;YACF,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,17 @@
1
+ export declare const highDemandPeriodsCommand: import("citty").CommandDef<{
2
+ readonly "campaign-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta campaign ID";
5
+ readonly required: true;
6
+ };
7
+ readonly "skip-cache": {
8
+ readonly type: "boolean";
9
+ readonly description: "Bypass server-side cache";
10
+ };
11
+ readonly output: {
12
+ readonly type: "string";
13
+ readonly description: "Output format";
14
+ readonly default: "json";
15
+ };
16
+ }>;
17
+ //# sourceMappingURL=high-demand-periods.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"high-demand-periods.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/high-demand-periods.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAyBnC,CAAC"}
@@ -0,0 +1,33 @@
1
+ import { defineCommand } from "citty";
2
+ import { apiGet } from "../../../client.js";
3
+ import { writeAdsJson, writeAdsOutput } from "../output.js";
4
+ import { csvOrJson, handleMetaError } from "./shared.js";
5
+ export const highDemandPeriodsCommand = defineCommand({
6
+ meta: {
7
+ name: "high-demand-periods",
8
+ description: `List scheduled budget bumps (e.g. Black Friday windows) on a campaign.`,
9
+ },
10
+ args: {
11
+ "campaign-id": { type: "string", description: "Meta campaign ID", required: true },
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
+ try {
17
+ const params = { "campaign-id": args["campaign-id"] };
18
+ if (args["skip-cache"])
19
+ params["skip-cache"] = "true";
20
+ const data = await apiGet("/api/ads/meta/high-demand-periods", params);
21
+ const fmt = csvOrJson(args);
22
+ if (fmt !== "json") {
23
+ writeAdsOutput(data, fmt);
24
+ return;
25
+ }
26
+ writeAdsJson({ ok: true, data });
27
+ }
28
+ catch (err) {
29
+ handleMetaError(err);
30
+ }
31
+ },
32
+ });
33
+ //# sourceMappingURL=high-demand-periods.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"high-demand-periods.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/high-demand-periods.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,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC;IACpD,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,wEAAwE;KACtF;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClF,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,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,CAAW,EAAE,CAAC;YACxF,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,mCAAmC,EAAE,MAAM,CAAC,CAAC;YACvG,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,24 @@
1
+ export declare const imagesCommand: import("citty").CommandDef<{
2
+ readonly "account-id": {
3
+ readonly type: "string";
4
+ readonly description: "Meta ad account ID";
5
+ };
6
+ readonly hash: {
7
+ readonly type: "string";
8
+ readonly description: "Filter to one image hash";
9
+ };
10
+ readonly limit: {
11
+ readonly type: "string";
12
+ readonly description: "Max rows (default 500)";
13
+ };
14
+ readonly "skip-cache": {
15
+ readonly type: "boolean";
16
+ readonly description: "Bypass server-side cache";
17
+ };
18
+ readonly output: {
19
+ readonly type: "string";
20
+ readonly description: "Output format";
21
+ readonly default: "json";
22
+ };
23
+ }>;
24
+ //# sourceMappingURL=images.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/images.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;EAmCxB,CAAC"}
@@ -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,17 @@
1
+ /**
2
+ * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.
3
+ *
4
+ * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,
5
+ * high-demand-periods, currency lookup). They're intentionally not surfaced as
6
+ * CLI commands because AI agents rarely need them in isolation. Hit them via
7
+ * curl against the API if you need them.
8
+ *
9
+ * Default behaviors that matter:
10
+ * - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.
11
+ * - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.
12
+ * - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).
13
+ * - Heavy insights queries auto-fall to async (poll loop hidden).
14
+ * - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.
15
+ */
16
+ export declare const metaCommand: import("citty").CommandDef<import("citty").ArgsDef>;
17
+ //# 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":"AAcA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,qDAiDtB,CAAC"}
@@ -0,0 +1,79 @@
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 { creativesCommand } from "./creatives.js";
11
+ import { insightsCommand } from "./insights.js";
12
+ import { pixelsCommand } from "./pixels.js";
13
+ import { previewCommand } from "./preview.js";
14
+ /**
15
+ * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.
16
+ *
17
+ * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,
18
+ * high-demand-periods, currency lookup). They're intentionally not surfaced as
19
+ * CLI commands because AI agents rarely need them in isolation. Hit them via
20
+ * curl against the API if you need them.
21
+ *
22
+ * Default behaviors that matter:
23
+ * - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.
24
+ * - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.
25
+ * - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).
26
+ * - Heavy insights queries auto-fall to async (poll loop hidden).
27
+ * - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.
28
+ */
29
+ export const metaCommand = defineCommand({
30
+ meta: {
31
+ name: "meta",
32
+ description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).
33
+
34
+ Discovery:
35
+ baker ads meta accounts — accounts in this company's connected scope
36
+ baker ads meta accounts --include-all — every account the token can see
37
+ baker ads meta businesses — Business Manager IDs
38
+
39
+ Snapshot a running account (default = ACTIVE only):
40
+ baker ads meta campaigns --account-id act_123
41
+ baker ads meta adsets --campaign-id 6123
42
+ baker ads meta ads --adset-id 6123
43
+ baker ads meta campaigns --account-id act_123 --all-statuses — include paused, archived
44
+
45
+ Drill in:
46
+ baker ads meta account --account-id act_123 — currency, balance, business
47
+ baker ads meta creatives --creative-id 9988 — single creative detail
48
+ baker ads meta audiences --account-id act_123
49
+ baker ads meta pixels --account-id act_123 — pixel list
50
+ baker ads meta pixels --pixel-id 9988 --stats --days 7 — firing health
51
+
52
+ Performance (the workhorse):
53
+ baker ads meta insights --object act_123 — defaults: level=account, intent=baseline, last_7d
54
+ baker ads meta insights --object act_123 --intent revenue --date-preset last_28d
55
+ baker ads meta insights --object act_123 --level ad --intent ranking — flag creatives to refresh
56
+ baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age — placement × age
57
+ baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31 — auto-async
58
+ baker ads meta insights --list-presets
59
+
60
+ Audit & review:
61
+ baker ads meta activities --account-id act_123 --days 14
62
+ baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html`,
63
+ },
64
+ subCommands: {
65
+ accounts: accountsCommand,
66
+ account: accountCommand,
67
+ businesses: businessesCommand,
68
+ campaigns: campaignsCommand,
69
+ adsets: adsetsCommand,
70
+ ads: adsListCommand,
71
+ creatives: creativesCommand,
72
+ audiences: audiencesCommand,
73
+ pixels: pixelsCommand,
74
+ activities: activitiesCommand,
75
+ insights: insightsCommand,
76
+ preview: previewCommand,
77
+ },
78
+ });
79
+ //# 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,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oGA8BmF;KACjG;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}