@cesteral/msads-mcp 1.0.0

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 (255) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +179 -0
  3. package/dist/auth/index.d.ts +3 -0
  4. package/dist/auth/index.d.ts.map +1 -0
  5. package/dist/auth/index.js +3 -0
  6. package/dist/auth/index.js.map +1 -0
  7. package/dist/auth/msads-auth-adapter.d.ts +27 -0
  8. package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/msads-auth-adapter.js +79 -0
  10. package/dist/auth/msads-auth-adapter.js.map +1 -0
  11. package/dist/auth/msads-auth-strategy.d.ts +8 -0
  12. package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/msads-auth-strategy.js +36 -0
  14. package/dist/auth/msads-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +112 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +56 -0
  18. package/dist/config/index.js.map +1 -0
  19. package/dist/index.d.ts +3 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +47 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  24. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  25. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +54 -0
  26. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  27. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  28. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  29. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +147 -0
  30. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  31. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
  32. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
  33. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
  34. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -0
  35. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
  36. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
  37. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +55 -0
  38. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
  39. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  40. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  41. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +47 -0
  42. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  43. package/dist/mcp-server/prompts/index.d.ts +9 -0
  44. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  45. package/dist/mcp-server/prompts/index.js +49 -0
  46. package/dist/mcp-server/prompts/index.js.map +1 -0
  47. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  48. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  49. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +84 -0
  50. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  51. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  52. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  53. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +54 -0
  54. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  55. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  56. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  57. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +54 -0
  58. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  59. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
  60. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
  61. package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
  62. package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
  63. package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
  64. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  65. package/dist/mcp-server/resources/definitions/index.js +79 -0
  66. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  67. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
  68. package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
  69. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +64 -0
  70. package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
  71. package/dist/mcp-server/resources/index.d.ts +3 -0
  72. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  73. package/dist/mcp-server/resources/index.js +2 -0
  74. package/dist/mcp-server/resources/index.js.map +1 -0
  75. package/dist/mcp-server/resources/types.d.ts +8 -0
  76. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  77. package/dist/mcp-server/resources/types.js +2 -0
  78. package/dist/mcp-server/resources/types.js.map +1 -0
  79. package/dist/mcp-server/resources/utils/field-rules.d.ts +9 -0
  80. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
  81. package/dist/mcp-server/resources/utils/field-rules.js +106 -0
  82. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
  83. package/dist/mcp-server/server.d.ts +5 -0
  84. package/dist/mcp-server/server.d.ts.map +1 -0
  85. package/dist/mcp-server/server.js +142 -0
  86. package/dist/mcp-server/server.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -0
  88. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  89. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +124 -0
  90. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  91. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +83 -0
  92. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  93. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +68 -0
  94. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  95. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +95 -0
  96. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +102 -0
  98. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +151 -0
  100. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  101. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
  102. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  103. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +111 -0
  104. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  105. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +73 -0
  106. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  107. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +81 -0
  108. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/create-entity.tool.js +74 -0
  110. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
  112. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
  113. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
  114. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
  115. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -0
  116. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  117. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +94 -0
  118. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  119. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
  120. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
  121. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
  122. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
  123. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -0
  124. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  125. package/dist/mcp-server/tools/definitions/download-report.tool.js +85 -0
  126. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  127. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
  128. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
  129. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
  130. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -0
  131. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +68 -0
  132. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  133. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +90 -0
  134. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  135. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +285 -0
  136. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  137. package/dist/mcp-server/tools/definitions/get-entity.tool.js +120 -0
  138. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  139. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +280 -0
  140. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
  141. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +138 -0
  142. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
  143. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +260 -0
  144. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
  145. package/dist/mcp-server/tools/definitions/get-report.tool.js +118 -0
  146. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
  147. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
  148. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
  149. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
  150. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
  151. package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
  152. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  153. package/dist/mcp-server/tools/definitions/index.js +53 -0
  154. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  155. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
  156. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
  157. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
  158. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
  159. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -0
  160. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  161. package/dist/mcp-server/tools/definitions/list-entities.tool.js +100 -0
  162. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  163. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
  164. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
  165. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
  166. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
  167. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
  168. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
  169. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
  170. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
  171. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
  172. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
  173. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
  174. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
  175. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -0
  176. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
  177. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +105 -0
  178. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  179. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +132 -0
  180. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  181. package/dist/mcp-server/tools/definitions/submit-report.tool.js +94 -0
  182. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  183. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +79 -0
  184. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  185. package/dist/mcp-server/tools/definitions/update-entity.tool.js +64 -0
  186. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  187. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +174 -0
  188. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  189. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +142 -0
  190. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  191. package/dist/mcp-server/tools/index.d.ts +2 -0
  192. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  193. package/dist/mcp-server/tools/index.js +2 -0
  194. package/dist/mcp-server/tools/index.js.map +1 -0
  195. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +20 -0
  196. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  197. package/dist/mcp-server/tools/utils/entity-mapping.js +118 -0
  198. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  199. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  200. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  201. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  202. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  203. package/dist/mcp-server/transports/streamable-http-transport.d.ts +55 -0
  204. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  205. package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
  206. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  207. package/dist/services/msads/msads-http-client.d.ts +16 -0
  208. package/dist/services/msads/msads-http-client.d.ts.map +1 -0
  209. package/dist/services/msads/msads-http-client.js +89 -0
  210. package/dist/services/msads/msads-http-client.js.map +1 -0
  211. package/dist/services/msads/msads-reporting-service.d.ts +58 -0
  212. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
  213. package/dist/services/msads/msads-reporting-service.js +153 -0
  214. package/dist/services/msads/msads-reporting-service.js.map +1 -0
  215. package/dist/services/msads/msads-service.d.ts +54 -0
  216. package/dist/services/msads/msads-service.d.ts.map +1 -0
  217. package/dist/services/msads/msads-service.js +179 -0
  218. package/dist/services/msads/msads-service.js.map +1 -0
  219. package/dist/services/msads/rate-limit-keys.d.ts +3 -0
  220. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
  221. package/dist/services/msads/rate-limit-keys.js +3 -0
  222. package/dist/services/msads/rate-limit-keys.js.map +1 -0
  223. package/dist/services/msads/types.d.ts +196 -0
  224. package/dist/services/msads/types.d.ts.map +1 -0
  225. package/dist/services/msads/types.js +47 -0
  226. package/dist/services/msads/types.js.map +1 -0
  227. package/dist/services/session-services.d.ts +22 -0
  228. package/dist/services/session-services.d.ts.map +1 -0
  229. package/dist/services/session-services.js +22 -0
  230. package/dist/services/session-services.js.map +1 -0
  231. package/dist/types-global/mcp.d.ts +2 -0
  232. package/dist/types-global/mcp.d.ts.map +1 -0
  233. package/dist/types-global/mcp.js +2 -0
  234. package/dist/types-global/mcp.js.map +1 -0
  235. package/dist/utils/errors/index.d.ts +2 -0
  236. package/dist/utils/errors/index.d.ts.map +1 -0
  237. package/dist/utils/errors/index.js +2 -0
  238. package/dist/utils/errors/index.js.map +1 -0
  239. package/dist/utils/platform.d.ts +3 -0
  240. package/dist/utils/platform.d.ts.map +1 -0
  241. package/dist/utils/platform.js +5 -0
  242. package/dist/utils/platform.js.map +1 -0
  243. package/dist/utils/security/rate-limiter.d.ts +3 -0
  244. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  245. package/dist/utils/security/rate-limiter.js +5 -0
  246. package/dist/utils/security/rate-limiter.js.map +1 -0
  247. package/dist/utils/telemetry/index.d.ts +2 -0
  248. package/dist/utils/telemetry/index.d.ts.map +1 -0
  249. package/dist/utils/telemetry/index.js +2 -0
  250. package/dist/utils/telemetry/index.js.map +1 -0
  251. package/dist/utils/telemetry/tracing.d.ts +3 -0
  252. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  253. package/dist/utils/telemetry/tracing.js +4 -0
  254. package/dist/utils/telemetry/tracing.js.map +1 -0
  255. package/package.json +56 -0
@@ -0,0 +1,118 @@
1
+ import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
2
+ const ENTITY_CONFIGS = {
3
+ campaign: {
4
+ addOperation: "/Campaigns",
5
+ getByAccountOperation: "/Campaigns/QueryByAccountId",
6
+ getByIdsOperation: "/Campaigns/QueryByIds",
7
+ updateOperation: "/Campaigns",
8
+ deleteOperation: "/Campaigns",
9
+ idField: "Id",
10
+ pluralName: "Campaigns",
11
+ displayName: "Campaign",
12
+ idsField: "CampaignIds",
13
+ batchLimit: 100,
14
+ requiredGetByIdsFields: ["AccountId"],
15
+ },
16
+ adGroup: {
17
+ addOperation: "/AdGroups",
18
+ getByParentOperation: "/AdGroups/QueryByCampaignId",
19
+ getByIdsOperation: "/AdGroups/QueryByIds",
20
+ updateOperation: "/AdGroups",
21
+ deleteOperation: "/AdGroups",
22
+ idField: "Id",
23
+ parentIdField: "CampaignId",
24
+ pluralName: "AdGroups",
25
+ displayName: "Ad Group",
26
+ idsField: "AdGroupIds",
27
+ batchLimit: 1000,
28
+ requiredGetByIdsFields: ["CampaignId"],
29
+ },
30
+ ad: {
31
+ addOperation: "/Ads",
32
+ getByParentOperation: "/Ads/QueryByAdGroupId",
33
+ getByIdsOperation: "/Ads/QueryByIds",
34
+ updateOperation: "/Ads",
35
+ deleteOperation: "/Ads",
36
+ idField: "Id",
37
+ parentIdField: "AdGroupId",
38
+ pluralName: "Ads",
39
+ displayName: "Ad",
40
+ idsField: "AdIds",
41
+ batchLimit: 50,
42
+ requiredGetByIdsFields: ["AdGroupId"],
43
+ },
44
+ keyword: {
45
+ addOperation: "/Keywords",
46
+ getByParentOperation: "/Keywords/QueryByAdGroupId",
47
+ getByIdsOperation: "/Keywords/QueryByIds",
48
+ updateOperation: "/Keywords",
49
+ deleteOperation: "/Keywords",
50
+ idField: "Id",
51
+ parentIdField: "AdGroupId",
52
+ pluralName: "Keywords",
53
+ displayName: "Keyword",
54
+ idsField: "KeywordIds",
55
+ batchLimit: 1000,
56
+ requiredGetByIdsFields: ["AdGroupId"],
57
+ },
58
+ budget: {
59
+ addOperation: "/Budgets",
60
+ getByIdsOperation: "/Budgets/QueryByIds",
61
+ updateOperation: "/Budgets",
62
+ deleteOperation: "/Budgets",
63
+ idField: "Id",
64
+ pluralName: "Budgets",
65
+ displayName: "Budget",
66
+ idsField: "BudgetIds",
67
+ batchLimit: 100,
68
+ },
69
+ adExtension: {
70
+ addOperation: "/AdExtensions",
71
+ getByIdsOperation: "/AdExtensions/QueryByIds",
72
+ updateOperation: "/AdExtensions",
73
+ deleteOperation: "/AdExtensions",
74
+ idField: "Id",
75
+ pluralName: "AdExtensions",
76
+ displayName: "Ad Extension",
77
+ idsField: "AdExtensionIds",
78
+ batchLimit: 100,
79
+ requiredGetByIdsFields: ["AccountId", "AdExtensionType"],
80
+ },
81
+ audience: {
82
+ addOperation: "/Audiences",
83
+ getByIdsOperation: "/Audiences/QueryByIds",
84
+ updateOperation: "/Audiences",
85
+ deleteOperation: "/Audiences",
86
+ idField: "Id",
87
+ pluralName: "Audiences",
88
+ displayName: "Audience",
89
+ idsField: "AudienceIds",
90
+ batchLimit: 100,
91
+ },
92
+ label: {
93
+ addOperation: "/Labels",
94
+ getByIdsOperation: "/Labels/QueryByIds",
95
+ updateOperation: "/Labels",
96
+ deleteOperation: "/Labels",
97
+ idField: "Id",
98
+ pluralName: "Labels",
99
+ displayName: "Label",
100
+ idsField: "LabelIds",
101
+ batchLimit: 100,
102
+ },
103
+ };
104
+ export function getEntityConfig(entityType) {
105
+ const config = ENTITY_CONFIGS[entityType];
106
+ if (!config) {
107
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown Microsoft Ads entity type: ${entityType}`);
108
+ }
109
+ return config;
110
+ }
111
+ export function getSupportedEntityTypes() {
112
+ return Object.keys(ENTITY_CONFIGS);
113
+ }
114
+ export function getEntityTypeEnum() {
115
+ const types = getSupportedEntityTypes();
116
+ return types;
117
+ }
118
+ //# sourceMappingURL=entity-mapping.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { type SessionServices } from "../../../services/session-services.js";
2
+ import type { SdkContext } from "@cesteral/shared";
3
+ export declare function resolveSessionServices(sdkContext?: SdkContext): SessionServices;
4
+ //# sourceMappingURL=resolve-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-session.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,eAAe,CAE/E"}
@@ -0,0 +1,6 @@
1
+ import { resolveSessionServicesFromStore } from "@cesteral/shared";
2
+ import { sessionServiceStore } from "../../../services/session-services.js";
3
+ export function resolveSessionServices(sdkContext) {
4
+ return resolveSessionServicesFromStore(sessionServiceStore, sdkContext);
5
+ }
6
+ //# sourceMappingURL=resolve-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAOlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}
@@ -0,0 +1,55 @@
1
+ import type { Logger } from "pino";
2
+ export declare const createMcpHttpServer: (config: {
3
+ serviceName: string;
4
+ port: number;
5
+ otelServiceName: string;
6
+ mcpAuthMode: "msads-bearer" | "jwt" | "none";
7
+ msadsCampaignApiBaseUrl: string;
8
+ msadsReportingApiBaseUrl: string;
9
+ msadsCustomerApiBaseUrl: string;
10
+ msadsRateLimitPerMinute: number;
11
+ msadsReportPollIntervalMs: number;
12
+ msadsReportMaxPollAttempts: number;
13
+ host: string;
14
+ nodeEnv: "development" | "production" | "test";
15
+ mcpStatefulSessionTimeoutMs: number;
16
+ logLevel: "debug" | "info" | "notice" | "warning" | "error";
17
+ mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
18
+ otelEnabled: boolean;
19
+ msadsAccessToken?: string | undefined;
20
+ msadsDeveloperToken?: string | undefined;
21
+ msadsCustomerId?: string | undefined;
22
+ msadsAccountId?: string | undefined;
23
+ mcpAuthSecretKey?: string | undefined;
24
+ mcpAllowedOrigins?: string | undefined;
25
+ otelExporterOtlpTracesEndpoint?: string | undefined;
26
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
27
+ gcsBucketName?: string | undefined;
28
+ }, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
29
+ serviceName: string;
30
+ port: number;
31
+ otelServiceName: string;
32
+ mcpAuthMode: "msads-bearer" | "jwt" | "none";
33
+ msadsCampaignApiBaseUrl: string;
34
+ msadsReportingApiBaseUrl: string;
35
+ msadsCustomerApiBaseUrl: string;
36
+ msadsRateLimitPerMinute: number;
37
+ msadsReportPollIntervalMs: number;
38
+ msadsReportMaxPollAttempts: number;
39
+ host: string;
40
+ nodeEnv: "development" | "production" | "test";
41
+ mcpStatefulSessionTimeoutMs: number;
42
+ logLevel: "debug" | "info" | "notice" | "warning" | "error";
43
+ mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
44
+ otelEnabled: boolean;
45
+ msadsAccessToken?: string | undefined;
46
+ msadsDeveloperToken?: string | undefined;
47
+ msadsCustomerId?: string | undefined;
48
+ msadsAccountId?: string | undefined;
49
+ mcpAuthSecretKey?: string | undefined;
50
+ mcpAllowedOrigins?: string | undefined;
51
+ otelExporterOtlpTracesEndpoint?: string | undefined;
52
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
53
+ gcsBucketName?: string | undefined;
54
+ }, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
55
+ //# sourceMappingURL=streamable-http-transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAuHnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}
@@ -0,0 +1,86 @@
1
+ import { createMcpServer } from "../server.js";
2
+ import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
3
+ import { MsAdsBearerAuthStrategy } from "../../auth/msads-auth-strategy.js";
4
+ import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
5
+ import { rateLimiter } from "../../utils/platform.js";
6
+ function buildPlatformConfig(config, logger) {
7
+ return {
8
+ authStrategy: config.mcpAuthMode === "msads-bearer"
9
+ ? new MsAdsBearerAuthStrategy(config.msadsCustomerApiBaseUrl)
10
+ : createAuthStrategy(config.mcpAuthMode, {
11
+ jwtSecret: config.mcpAuthSecretKey,
12
+ logger,
13
+ }),
14
+ corsAllowHeaders: [
15
+ "Content-Type",
16
+ "Authorization",
17
+ "Mcp-Session-Id",
18
+ "MCP-Protocol-Version",
19
+ "X-MSAds-Developer-Token",
20
+ "X-MSAds-Customer-Id",
21
+ "X-MSAds-Account-Id",
22
+ ],
23
+ authErrorHint: config.mcpAuthMode === "msads-bearer"
24
+ ? "Provide an OAuth2 access token via Authorization: Bearer <token> header, plus X-MSAds-Developer-Token, X-MSAds-Customer-Id, and X-MSAds-Account-Id headers."
25
+ : "Provide a valid Bearer token in the Authorization header.",
26
+ sessionServiceStore,
27
+ rateLimiter,
28
+ async createSessionForAuth(authResult, sessionId, appConfig, log) {
29
+ const adapter = authResult.platformAuthAdapter;
30
+ if (adapter) {
31
+ const cfg = appConfig;
32
+ const services = createSessionServices(adapter, {
33
+ campaignApiBaseUrl: cfg.msadsCampaignApiBaseUrl,
34
+ reportingApiBaseUrl: cfg.msadsReportingApiBaseUrl,
35
+ customerApiBaseUrl: cfg.msadsCustomerApiBaseUrl,
36
+ reportPollIntervalMs: cfg.msadsReportPollIntervalMs,
37
+ reportMaxPollAttempts: cfg.msadsReportMaxPollAttempts,
38
+ }, log, rateLimiter);
39
+ sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
40
+ return { services };
41
+ }
42
+ if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
43
+ const cfg = appConfig;
44
+ const { msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId } = cfg;
45
+ if (msadsAccessToken && msadsDeveloperToken && msadsCustomerId && msadsAccountId) {
46
+ const { MsAdsAccessTokenAdapter } = await import("../../auth/msads-auth-adapter.js");
47
+ const envAdapter = new MsAdsAccessTokenAdapter(msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId, cfg.msadsCustomerApiBaseUrl);
48
+ await envAdapter.validate();
49
+ const services = createSessionServices(envAdapter, {
50
+ campaignApiBaseUrl: cfg.msadsCampaignApiBaseUrl,
51
+ reportingApiBaseUrl: cfg.msadsReportingApiBaseUrl,
52
+ customerApiBaseUrl: cfg.msadsCustomerApiBaseUrl,
53
+ reportPollIntervalMs: cfg.msadsReportPollIntervalMs,
54
+ reportMaxPollAttempts: cfg.msadsReportMaxPollAttempts,
55
+ }, log, rateLimiter);
56
+ sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
57
+ return { services };
58
+ }
59
+ if (appConfig.mcpAuthMode !== "none") {
60
+ return {
61
+ services: null,
62
+ error: {
63
+ message: "Microsoft Ads credentials required. Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID env vars, or use MCP_AUTH_MODE=msads-bearer.",
64
+ status: 400,
65
+ },
66
+ };
67
+ }
68
+ return { services: null };
69
+ }
70
+ return {
71
+ services: null,
72
+ error: {
73
+ message: "Microsoft Ads API credentials required for this server.",
74
+ status: 400,
75
+ },
76
+ };
77
+ },
78
+ async createMcpServer(log, sessionId, gcsBucket) {
79
+ return createMcpServer(log, sessionId, gcsBucket);
80
+ },
81
+ packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
82
+ serverCard: buildServerCardExtras("msads-mcp"),
83
+ };
84
+ }
85
+ export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
86
+ //# sourceMappingURL=streamable-http-transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streamable-http-transport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { MsAdsAuthAdapter } from "../../auth/msads-auth-adapter.js";
2
+ import type { RequestContext } from "@cesteral/shared";
3
+ export declare class MsAdsHttpClient {
4
+ private readonly authAdapter;
5
+ private readonly baseUrl;
6
+ private readonly logger;
7
+ constructor(authAdapter: MsAdsAuthAdapter, baseUrl: string, logger: import("pino").Logger);
8
+ get(path: string, params?: Record<string, string>, context?: RequestContext): Promise<unknown>;
9
+ post(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
10
+ put(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
11
+ delete(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
12
+ request(method: "GET" | "POST" | "PUT" | "DELETE", path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
13
+ private buildUrl;
14
+ private executeRequest;
15
+ }
16
+ //# sourceMappingURL=msads-http-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"msads-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/msads/msads-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AA2BpE,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM;IAG1C,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAKb,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAOb,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAOb,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAOb,OAAO,CACX,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAanB,OAAO,CAAC,QAAQ;YAYF,cAAc;CA4B7B"}
@@ -0,0 +1,89 @@
1
+ import { fetchWithTimeout, executeWithRetry } from "@cesteral/shared";
2
+ import { withMsAdsApiSpan } from "../../utils/platform.js";
3
+ const MSADS_RETRY_CONFIG = {
4
+ maxRetries: 3,
5
+ initialBackoffMs: 2_000,
6
+ maxBackoffMs: 30_000,
7
+ timeoutMs: 30_000,
8
+ platformName: "Microsoft Ads",
9
+ tokenExpiryHint: "Microsoft Ads token expired. Regenerate via Microsoft identity platform.",
10
+ };
11
+ export class MsAdsHttpClient {
12
+ authAdapter;
13
+ baseUrl;
14
+ logger;
15
+ constructor(authAdapter, baseUrl, logger) {
16
+ this.authAdapter = authAdapter;
17
+ this.baseUrl = baseUrl;
18
+ this.logger = logger;
19
+ }
20
+ async get(path, params, context) {
21
+ const url = this.buildUrl(path, params);
22
+ return this.executeRequest(url, "GET", context);
23
+ }
24
+ async post(path, data, context) {
25
+ const url = this.buildUrl(path);
26
+ return this.executeRequest(url, "POST", context, {
27
+ body: JSON.stringify(data),
28
+ });
29
+ }
30
+ async put(path, data, context) {
31
+ const url = this.buildUrl(path);
32
+ return this.executeRequest(url, "PUT", context, {
33
+ body: JSON.stringify(data),
34
+ });
35
+ }
36
+ async delete(path, data, context) {
37
+ const url = this.buildUrl(path);
38
+ return this.executeRequest(url, "DELETE", context, {
39
+ body: data !== undefined ? JSON.stringify(data) : undefined,
40
+ });
41
+ }
42
+ async request(method, path, data, context) {
43
+ switch (method) {
44
+ case "GET":
45
+ return this.get(path, undefined, context);
46
+ case "POST":
47
+ return this.post(path, data, context);
48
+ case "PUT":
49
+ return this.put(path, data, context);
50
+ case "DELETE":
51
+ return this.delete(path, data, context);
52
+ }
53
+ }
54
+ buildUrl(path, params) {
55
+ const url = new URL(`${this.baseUrl}${path}`);
56
+ if (params) {
57
+ for (const [key, value] of Object.entries(params)) {
58
+ if (value !== undefined && value !== null) {
59
+ url.searchParams.set(key, value);
60
+ }
61
+ }
62
+ }
63
+ return url.toString();
64
+ }
65
+ async executeRequest(url, method, context, options) {
66
+ return withMsAdsApiSpan(`api.${method}`, undefined, async (span) => {
67
+ span.setAttribute("http.request.method", method);
68
+ span.setAttribute("http.url", url);
69
+ return executeWithRetry(MSADS_RETRY_CONFIG, {
70
+ url,
71
+ fetchOptions: { ...options, method },
72
+ context,
73
+ logger: this.logger,
74
+ fetchFn: fetchWithTimeout,
75
+ getHeaders: async () => {
76
+ const accessToken = await this.authAdapter.getAccessToken();
77
+ return {
78
+ Authorization: `Bearer ${accessToken}`,
79
+ DeveloperToken: this.authAdapter.developerToken,
80
+ CustomerId: this.authAdapter.customerId,
81
+ CustomerAccountId: this.authAdapter.accountId,
82
+ "Content-Type": "application/json",
83
+ };
84
+ },
85
+ });
86
+ });
87
+ }
88
+ }
89
+ //# sourceMappingURL=msads-http-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"msads-http-client.js","sourceRoot":"","sources":["../../../src/services/msads/msads-http-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,kBAAkB,GAAgB;IACtC,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,MAAM;IACpB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,eAAe;IAC7B,eAAe,EAAE,0EAA0E;CAC5F,CAAC;AAiBF,MAAM,OAAO,eAAe;IAEP;IACA;IACA;IAHnB,YACmB,WAA6B,EAC7B,OAAe,EACf,MAA6B;QAF7B,gBAAW,GAAX,WAAW,CAAkB;QAC7B,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAuB;IAC7C,CAAC;IAEJ,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,MAA+B,EAC/B,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,IAA0C,EAC1C,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,IAA0C,EAC1C,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE;YAC9C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,IAA0C,EAC1C,OAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE;YACjD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAyC,EACzC,IAAY,EACZ,IAA0C,EAC1C,OAAwB;QAExB,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,KAAK;gBACR,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC5C,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACxC,KAAK,KAAK;gBACR,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACvC,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,MAA+B;QAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,GAAW,EACX,MAAc,EACd,OAAwB,EACxB,OAAqB;QAErB,OAAO,gBAAgB,CAAC,OAAO,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACjE,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACnC,OAAO,gBAAgB,CAAC,kBAAkB,EAAE;gBAC1C,GAAG;gBACH,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE;gBACpC,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,gBAAgB;gBACzB,UAAU,EAAE,KAAK,IAAI,EAAE;oBACrB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;oBAC5D,OAAO;wBACL,aAAa,EAAE,UAAU,WAAW,EAAE;wBACtC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc;wBAC/C,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU;wBACvC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC,SAAS;wBAC7C,cAAc,EAAE,kBAAkB;qBACnC,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -0,0 +1,58 @@
1
+ import type { Logger } from "pino";
2
+ import type { RateLimiter } from "@cesteral/shared";
3
+ import type { MsAdsHttpClient } from "./msads-http-client.js";
4
+ import { type RequestContext } from "@cesteral/shared";
5
+ export interface ReportConfig {
6
+ reportType: string;
7
+ accountId: string;
8
+ columns: string[];
9
+ dateRange: {
10
+ startDate: string;
11
+ endDate: string;
12
+ };
13
+ aggregation?: string;
14
+ filters?: Record<string, unknown>[];
15
+ }
16
+ export declare class MsAdsReportingService {
17
+ private readonly rateLimiter;
18
+ private readonly httpClient;
19
+ private readonly logger;
20
+ private readonly maxPollAttempts;
21
+ private readonly pollIntervalMs;
22
+ constructor(rateLimiter: RateLimiter, httpClient: MsAdsHttpClient, logger: Logger, maxPollAttempts?: number, pollIntervalMs?: number);
23
+ submitReport(config: ReportConfig, context?: RequestContext): Promise<string>;
24
+ pollReport(reportRequestId: string, context?: RequestContext): Promise<string>;
25
+ checkReportStatus(reportRequestId: string, context?: RequestContext): Promise<{
26
+ status: string;
27
+ downloadUrl?: string;
28
+ }>;
29
+ downloadReport(downloadUrl: string, maxRows?: number, context?: RequestContext, options?: {
30
+ includeRawCsv?: boolean;
31
+ }): Promise<{
32
+ headers: string[];
33
+ rows: string[][];
34
+ totalRows: number;
35
+ rawCsv?: string;
36
+ }>;
37
+ getReport(config: ReportConfig, maxRows?: number, context?: RequestContext): Promise<{
38
+ headers: string[];
39
+ rows: string[][];
40
+ totalRows: number;
41
+ reportRequestId: string;
42
+ }>;
43
+ createReportSchedule(config: ReportConfig & {
44
+ scheduleName: string;
45
+ schedule: Record<string, unknown>;
46
+ }, context?: RequestContext): Promise<{
47
+ scheduleId: string;
48
+ scheduleName: string;
49
+ }>;
50
+ listReportSchedules(context?: RequestContext): Promise<{
51
+ note: string;
52
+ }>;
53
+ deleteReportSchedule(scheduleId: string, context?: RequestContext): Promise<void>;
54
+ private buildReportRequest;
55
+ private parseDate;
56
+ private parseCsv;
57
+ }
58
+ //# sourceMappingURL=msads-reporting-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"msads-reporting-service.d.ts","sourceRoot":"","sources":["../../../src/services/msads/msads-reporting-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAuB1B,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACrC;AAMD,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAJd,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAkC,EACnD,cAAc,GAAE,MAAqB;IAMlD,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB7E,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B9E,iBAAiB,CACrB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB9C,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GACxC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBjF,SAAS,CACb,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAazF,oBAAoB,CACxB,MAAM,EAAE,YAAY,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAClF,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAiClD,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAYxE,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvF,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;CA4BjB"}
@@ -0,0 +1,153 @@
1
+ import { fetchWithTimeout, McpError, JsonRpcErrorCode, parseCSV, pollUntilComplete, ReportFailedError, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, } from "@cesteral/shared";
2
+ import { MSADS_READ_KEY, MSADS_WRITE_KEY } from "./rate-limit-keys.js";
3
+ const POLL_BASE_MS = 3_000;
4
+ const POLL_MAX_MS = 30_000;
5
+ const DEFAULT_MAX_POLL_ATTEMPTS = 60;
6
+ export class MsAdsReportingService {
7
+ rateLimiter;
8
+ httpClient;
9
+ logger;
10
+ maxPollAttempts;
11
+ pollIntervalMs;
12
+ constructor(rateLimiter, httpClient, logger, maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS, pollIntervalMs = POLL_BASE_MS) {
13
+ this.rateLimiter = rateLimiter;
14
+ this.httpClient = httpClient;
15
+ this.logger = logger;
16
+ this.maxPollAttempts = maxPollAttempts;
17
+ this.pollIntervalMs = pollIntervalMs;
18
+ }
19
+ async submitReport(config, context) {
20
+ await this.rateLimiter.consume(MSADS_WRITE_KEY, 3);
21
+ const body = this.buildReportRequest(config);
22
+ this.logger.info({ reportType: config.reportType }, "Submitting report");
23
+ const response = (await this.httpClient.post("/GenerateReport/Submit", body, context));
24
+ return response.ReportRequestId;
25
+ }
26
+ async pollReport(reportRequestId, context) {
27
+ this.logger.debug({ reportRequestId }, "Starting report poll");
28
+ try {
29
+ const status = await pollUntilComplete({
30
+ fetchStatus: async () => this.checkReportStatus(reportRequestId, context),
31
+ isComplete: (s) => s.status === "Success" && !!s.downloadUrl,
32
+ isFailed: (s) => s.status === "Error",
33
+ initialDelayMs: this.pollIntervalMs,
34
+ maxDelayMs: POLL_MAX_MS,
35
+ maxAttempts: this.maxPollAttempts,
36
+ });
37
+ this.logger.info({ reportRequestId }, "Report ready");
38
+ return status.downloadUrl;
39
+ }
40
+ catch (err) {
41
+ if (err instanceof ReportFailedError) {
42
+ throw new McpError(JsonRpcErrorCode.InternalError, `Microsoft Ads report failed: reportRequestId=${reportRequestId}`);
43
+ }
44
+ throw err;
45
+ }
46
+ }
47
+ async checkReportStatus(reportRequestId, context) {
48
+ await this.rateLimiter.consume(MSADS_READ_KEY);
49
+ const response = (await this.httpClient.post("/GenerateReport/Poll", { ReportRequestId: reportRequestId }, context));
50
+ return {
51
+ status: response.ReportRequestStatus.Status,
52
+ downloadUrl: response.ReportRequestStatus.ReportDownloadUrl,
53
+ };
54
+ }
55
+ async downloadReport(downloadUrl, maxRows, context, options = {}) {
56
+ this.logger.info({ downloadUrl: downloadUrl.substring(0, 80) }, "Downloading report");
57
+ const response = await fetchWithTimeout(downloadUrl, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, context);
58
+ if (!response.ok) {
59
+ throw new McpError(JsonRpcErrorCode.ServiceUnavailable, `Failed to download report: ${response.status} ${response.statusText}`);
60
+ }
61
+ const text = await response.text();
62
+ const parsed = this.parseCsv(text, maxRows);
63
+ return options.includeRawCsv ? { ...parsed, rawCsv: text } : parsed;
64
+ }
65
+ async getReport(config, maxRows, context) {
66
+ const reportRequestId = await this.submitReport(config, context);
67
+ const downloadUrl = await this.pollReport(reportRequestId, context);
68
+ const data = await this.downloadReport(downloadUrl, maxRows, context);
69
+ return { ...data, reportRequestId };
70
+ }
71
+ async createReportSchedule(config, context) {
72
+ await this.rateLimiter.consume(MSADS_WRITE_KEY, 3);
73
+ const baseRequest = this.buildReportRequest(config).ReportRequest;
74
+ const body = {
75
+ ReportRequest: {
76
+ ...baseRequest,
77
+ ReportName: config.scheduleName,
78
+ Schedule: config.schedule,
79
+ },
80
+ };
81
+ this.logger.info({ scheduleName: config.scheduleName }, "Creating MS Ads report schedule");
82
+ const response = (await this.httpClient.post("/GenerateReport/Submit", body, context));
83
+ this.logger.info({ scheduleId: response.ReportRequestId, scheduleName: config.scheduleName }, "MS Ads report schedule created");
84
+ return { scheduleId: response.ReportRequestId, scheduleName: config.scheduleName };
85
+ }
86
+ async listReportSchedules(context) {
87
+ void context;
88
+ return {
89
+ note: "Microsoft Advertising does not provide an API to list all report schedules. Use the Microsoft Advertising UI (app.ads.microsoft.com) to view existing scheduled reports, or track scheduleIds returned by msads_create_report_schedule.",
90
+ };
91
+ }
92
+ async deleteReportSchedule(scheduleId, context) {
93
+ void context;
94
+ this.logger.info({ scheduleId }, "MS Ads report schedule deletion requested — cancel via Microsoft Advertising UI");
95
+ }
96
+ buildReportRequest(config) {
97
+ const request = {
98
+ ReportName: `${config.reportType}_${Date.now()}`,
99
+ Format: "Csv",
100
+ ReturnOnlyCompleteData: false,
101
+ Aggregation: config.aggregation ?? "Daily",
102
+ Columns: config.columns,
103
+ Scope: {
104
+ AccountIds: [Number(config.accountId)],
105
+ },
106
+ Time: {
107
+ CustomDateRangeStart: this.parseDate(config.dateRange.startDate),
108
+ CustomDateRangeEnd: this.parseDate(config.dateRange.endDate),
109
+ },
110
+ };
111
+ if (config.filters && config.filters.length > 0) {
112
+ request.Filter = config.filters;
113
+ }
114
+ return {
115
+ ReportRequest: {
116
+ Type: config.reportType,
117
+ ...request,
118
+ },
119
+ };
120
+ }
121
+ parseDate(dateStr) {
122
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) {
123
+ throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid date format: "${dateStr}". Expected YYYY-MM-DD.`);
124
+ }
125
+ const [year, month, day] = dateStr.split("-").map(Number);
126
+ return { Year: year, Month: month, Day: day };
127
+ }
128
+ parseCsv(text, maxRows) {
129
+ const stripped = text.replace(/^\uFEFF/, "");
130
+ const filtered = stripped
131
+ .split(/\r?\n/)
132
+ .filter((line) => {
133
+ const trimmed = line.trim();
134
+ if (trimmed.length === 0)
135
+ return false;
136
+ if (trimmed.startsWith("@") || trimmed.startsWith('"@'))
137
+ return false;
138
+ if (trimmed.startsWith("©") || trimmed.startsWith('"©'))
139
+ return false;
140
+ return true;
141
+ })
142
+ .join("\n");
143
+ if (filtered === "") {
144
+ return { headers: [], rows: [], totalRows: 0 };
145
+ }
146
+ const { headers, rows: recordRows } = parseCSV(filtered);
147
+ const rows = recordRows.map((record) => headers.map((h) => record[h] ?? ""));
148
+ const totalRows = rows.length;
149
+ const limitedRows = maxRows ? rows.slice(0, maxRows) : rows;
150
+ return { headers, rows: limitedRows, totalRows };
151
+ }
152
+ }
153
+ //# sourceMappingURL=msads-reporting-service.js.map