@cesteral/msads-mcp 1.2.0 → 2.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 (223) hide show
  1. package/README.md +44 -30
  2. package/dist/auth/msads-auth-adapter.d.ts.map +1 -1
  3. package/dist/auth/msads-auth-adapter.js +1 -1
  4. package/dist/auth/msads-auth-adapter.js.map +1 -1
  5. package/dist/cesteral-manifest.json +140 -4
  6. package/dist/config/index.d.ts +36 -67
  7. package/dist/config/index.d.ts.map +1 -1
  8. package/dist/index.js +13 -23
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +1 -1
  11. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -1
  12. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +9 -3
  13. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -1
  14. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +1 -1
  15. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -1
  16. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +5 -3
  17. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -1
  18. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +1 -1
  19. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -1
  20. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +9 -6
  21. package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -1
  22. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +1 -1
  23. package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -1
  24. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +1 -1
  25. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -1
  26. package/dist/mcp-server/prompts/index.d.ts +1 -1
  27. package/dist/mcp-server/prompts/index.d.ts.map +1 -1
  28. package/dist/mcp-server/prompts/index.js +15 -0
  29. package/dist/mcp-server/prompts/index.js.map +1 -1
  30. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -1
  31. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +16 -7
  32. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -1
  33. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  34. package/dist/mcp-server/resources/definitions/index.js +10 -9
  35. package/dist/mcp-server/resources/definitions/index.js.map +1 -1
  36. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -1
  37. package/dist/mcp-server/resources/utils/field-rules.js +11 -11
  38. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -1
  39. package/dist/mcp-server/server.d.ts +2 -1
  40. package/dist/mcp-server/server.d.ts.map +1 -1
  41. package/dist/mcp-server/server.js +29 -99
  42. package/dist/mcp-server/server.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +46 -111
  44. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +158 -15
  46. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +51 -44
  48. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +125 -9
  50. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +51 -51
  52. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +132 -7
  54. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -1
  55. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +65 -97
  56. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -1
  57. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +128 -7
  58. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -1
  59. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +24 -62
  60. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -1
  61. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +4 -0
  62. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -1
  63. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +47 -35
  64. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -1
  65. package/dist/mcp-server/tools/definitions/create-entity.tool.js +99 -3
  66. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -1
  67. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +51 -100
  68. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -1
  69. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +113 -33
  70. package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -1
  71. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +47 -53
  72. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -1
  73. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +129 -8
  74. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -1
  75. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +34 -40
  76. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -1
  77. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +79 -25
  78. package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -1
  79. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +84 -214
  80. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -1
  81. package/dist/mcp-server/tools/definitions/download-report.tool.js +7 -2
  82. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -1
  83. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +105 -0
  84. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  85. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +171 -0
  86. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  87. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +12 -32
  88. package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -1
  89. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +6 -2
  90. package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -1
  91. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +24 -244
  92. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -1
  93. package/dist/mcp-server/tools/definitions/get-entity.tool.js +41 -67
  94. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -1
  95. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +2 -0
  96. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
  97. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +20 -0
  98. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
  99. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +104 -204
  100. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -1
  101. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +9 -0
  102. package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -1
  103. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +100 -188
  104. package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -1
  105. package/dist/mcp-server/tools/definitions/get-report.tool.js +9 -1
  106. package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -1
  107. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +57 -0
  108. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  109. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +97 -0
  110. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  111. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +49 -38
  112. package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -1
  113. package/dist/mcp-server/tools/definitions/import-from-google.tool.js +101 -10
  114. package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -1
  115. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  116. package/dist/mcp-server/tools/definitions/index.js +6 -0
  117. package/dist/mcp-server/tools/definitions/index.js.map +1 -1
  118. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +14 -90
  119. package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -1
  120. package/dist/mcp-server/tools/definitions/list-accounts.tool.js +5 -1
  121. package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -1
  122. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +18 -70
  123. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -1
  124. package/dist/mcp-server/tools/definitions/list-entities.tool.js +9 -2
  125. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -1
  126. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +5 -16
  127. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -1
  128. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +4 -3
  129. package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -1
  130. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +46 -37
  131. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -1
  132. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +106 -6
  133. package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -1
  134. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +58 -47
  135. package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -1
  136. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +111 -8
  137. package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -1
  138. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +17 -40
  139. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -1
  140. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +12 -19
  141. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -1
  142. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +57 -89
  143. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -1
  144. package/dist/mcp-server/tools/definitions/submit-report.tool.js +97 -2
  145. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -1
  146. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +39 -1907
  147. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -1
  148. package/dist/mcp-server/tools/definitions/update-entity.tool.js +74 -85
  149. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -1
  150. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +45 -116
  151. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -1
  152. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +3 -2
  153. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -1
  154. package/dist/mcp-server/tools/index.d.ts +4 -1
  155. package/dist/mcp-server/tools/index.d.ts.map +1 -1
  156. package/dist/mcp-server/tools/index.js +7 -1
  157. package/dist/mcp-server/tools/index.js.map +1 -1
  158. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts +9 -0
  159. package/dist/mcp-server/tools/utils/bulk-capacity.d.ts.map +1 -0
  160. package/dist/mcp-server/tools/utils/bulk-capacity.js +96 -0
  161. package/dist/mcp-server/tools/utils/bulk-capacity.js.map +1 -0
  162. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +5 -2
  163. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -1
  164. package/dist/mcp-server/tools/utils/capture-snapshot.js +38 -19
  165. package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -1
  166. package/dist/mcp-server/tools/utils/dry-run.d.ts +17 -2
  167. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -1
  168. package/dist/mcp-server/tools/utils/dry-run.js +71 -6
  169. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -1
  170. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +27 -0
  171. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -1
  172. package/dist/mcp-server/tools/utils/entity-mapping.js +105 -0
  173. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -1
  174. package/dist/mcp-server/tools/utils/parent-ids.d.ts +16 -0
  175. package/dist/mcp-server/tools/utils/parent-ids.d.ts.map +1 -0
  176. package/dist/mcp-server/tools/utils/parent-ids.js +28 -0
  177. package/dist/mcp-server/tools/utils/parent-ids.js.map +1 -0
  178. package/dist/mcp-server/tools/utils/targeting-values.d.ts +9 -0
  179. package/dist/mcp-server/tools/utils/targeting-values.d.ts.map +1 -0
  180. package/dist/mcp-server/tools/utils/targeting-values.js +16 -0
  181. package/dist/mcp-server/tools/utils/targeting-values.js.map +1 -0
  182. package/dist/mcp-server/transports/streamable-http-transport.d.ts +22 -20
  183. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -1
  184. package/dist/mcp-server/transports/streamable-http-transport.js +16 -51
  185. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -1
  186. package/dist/services/msads/msads-http-client.d.ts +5 -1
  187. package/dist/services/msads/msads-http-client.d.ts.map +1 -1
  188. package/dist/services/msads/msads-http-client.js +49 -2
  189. package/dist/services/msads/msads-http-client.js.map +1 -1
  190. package/dist/services/msads/msads-reporting-service.d.ts +3 -9
  191. package/dist/services/msads/msads-reporting-service.d.ts.map +1 -1
  192. package/dist/services/msads/msads-reporting-service.js +62 -27
  193. package/dist/services/msads/msads-reporting-service.js.map +1 -1
  194. package/dist/services/msads/msads-service.d.ts +53 -5
  195. package/dist/services/msads/msads-service.d.ts.map +1 -1
  196. package/dist/services/msads/msads-service.js +235 -35
  197. package/dist/services/msads/msads-service.js.map +1 -1
  198. package/dist/services/msads/partial-errors.d.ts +34 -0
  199. package/dist/services/msads/partial-errors.d.ts.map +1 -0
  200. package/dist/services/msads/partial-errors.js +149 -0
  201. package/dist/services/msads/partial-errors.js.map +1 -0
  202. package/dist/services/msads/rate-limit-keys.d.ts +8 -2
  203. package/dist/services/msads/rate-limit-keys.d.ts.map +1 -1
  204. package/dist/services/msads/rate-limit-keys.js +16 -2
  205. package/dist/services/msads/rate-limit-keys.js.map +1 -1
  206. package/dist/services/msads/types.d.ts +1 -2
  207. package/dist/services/msads/types.d.ts.map +1 -1
  208. package/dist/services/msads/types.js.map +1 -1
  209. package/dist/services/session-services.d.ts +2 -2
  210. package/dist/services/session-services.d.ts.map +1 -1
  211. package/dist/services/session-services.js +10 -10
  212. package/dist/services/session-services.js.map +1 -1
  213. package/dist/services/session-wiring.d.ts +7 -0
  214. package/dist/services/session-wiring.d.ts.map +1 -0
  215. package/dist/services/session-wiring.js +20 -0
  216. package/dist/services/session-wiring.js.map +1 -0
  217. package/dist/testkit/fixtures/index.d.ts +4 -0
  218. package/dist/testkit/fixtures/index.d.ts.map +1 -1
  219. package/dist/testkit/fixtures/index.js +105 -3
  220. package/dist/testkit/fixtures/index.js.map +1 -1
  221. package/dist/testkit/types.d.ts +2 -2
  222. package/dist/testkit/types.d.ts.map +1 -1
  223. package/package.json +8 -8
@@ -1 +1 @@
1
- {"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
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,16 @@
1
+ import { z } from "zod";
2
+ import type { DryRunValidationError } from "@cesteral/shared";
3
+ export declare const parentIdInputFields: {
4
+ accountId: z.ZodOptional<z.ZodString>;
5
+ campaignId: z.ZodOptional<z.ZodString>;
6
+ adGroupId: z.ZodOptional<z.ZodString>;
7
+ };
8
+ export interface ParentIdInput {
9
+ entityType: string;
10
+ accountId?: string;
11
+ campaignId?: string;
12
+ adGroupId?: string;
13
+ }
14
+ export declare function resolveParentId(input: ParentIdInput): string | undefined;
15
+ export declare function validateParentId(input: ParentIdInput): DryRunValidationError[];
16
+ //# sourceMappingURL=parent-ids.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parent-ids.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/parent-ids.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAO9D,eAAO,MAAM,mBAAmB;;;;CAmB/B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAGxE;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,qBAAqB,EAAE,CAK9E"}
@@ -0,0 +1,28 @@
1
+ import { z } from "zod";
2
+ import { getWriteParent, missingWriteParentMessage, } from "./entity-mapping.js";
3
+ export const parentIdInputFields = {
4
+ accountId: z
5
+ .string()
6
+ .optional()
7
+ .describe("Required for campaign and adExtension: the account that owns them, sent as the request-body AccountId"),
8
+ campaignId: z
9
+ .string()
10
+ .optional()
11
+ .describe("Required for adGroup: the campaign that owns every ad group in this call, sent as the request-body CampaignId"),
12
+ adGroupId: z
13
+ .string()
14
+ .optional()
15
+ .describe("Required for ad and keyword: the ad group that owns every item in this call, sent as the request-body AdGroupId"),
16
+ };
17
+ export function resolveParentId(input) {
18
+ const parent = getWriteParent(input.entityType);
19
+ return parent ? input[parent.inputKey] : undefined;
20
+ }
21
+ export function validateParentId(input) {
22
+ const message = missingWriteParentMessage(input.entityType, input);
23
+ if (!message)
24
+ return [];
25
+ const parent = getWriteParent(input.entityType);
26
+ return [{ code: "MISSING_PARENT_ID", message, field: parent?.inputKey ?? "parentId" }];
27
+ }
28
+ //# sourceMappingURL=parent-ids.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parent-ids.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/parent-ids.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,cAAc,EACd,yBAAyB,GAE1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uGAAuG,CACxG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+GAA+G,CAChH;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;CACJ,CAAC;AAUF,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,UAA6B,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,UAA6B,EAAE,KAAK,CAAC,CAAC;IACtF,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,UAA6B,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,IAAI,UAAU,EAAE,CAAC,CAAC;AACzF,CAAC"}
@@ -0,0 +1,9 @@
1
+ export declare const MSADS_AGE_RANGES: ReadonlyArray<{
2
+ Id: string;
3
+ Name: string;
4
+ }>;
5
+ export declare const MSADS_GENDERS: ReadonlyArray<{
6
+ Id: string;
7
+ Name: string;
8
+ }>;
9
+ //# sourceMappingURL=targeting-values.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"targeting-values.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/targeting-values.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CASxE,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAIrE,CAAC"}
@@ -0,0 +1,16 @@
1
+ export const MSADS_AGE_RANGES = [
2
+ { Id: "EighteenToTwentyFour", Name: "18-24" },
3
+ { Id: "TwentyFiveToThirtyFour", Name: "25-34" },
4
+ { Id: "ThirtyFiveToFourtyNine", Name: "35-49" },
5
+ { Id: "ThirtyFiveToFiftyFour", Name: "35-54" },
6
+ { Id: "FiftyToSixtyFour", Name: "50-64" },
7
+ { Id: "FiftyFiveAndAbove", Name: "55+" },
8
+ { Id: "SixtyFiveAndAbove", Name: "65+" },
9
+ { Id: "Unknown", Name: "Unknown age" },
10
+ ];
11
+ export const MSADS_GENDERS = [
12
+ { Id: "Male", Name: "Male" },
13
+ { Id: "Female", Name: "Female" },
14
+ { Id: "Unknown", Name: "Unknown (Audience campaign ad groups only)" },
15
+ ];
16
+ //# sourceMappingURL=targeting-values.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"targeting-values.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/targeting-values.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,gBAAgB,GAAgD;IAC3E,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7C,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/C,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/C,EAAE,EAAE,EAAE,uBAAuB,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9C,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE;IACzC,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE;IACxC,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE;IACxC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE;CACvC,CAAC;AAMF,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5B,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,4CAA4C,EAAE;CACtE,CAAC"}
@@ -1,5 +1,11 @@
1
1
  import type { Logger } from "pino";
2
2
  export declare const createMcpHttpServer: (config: {
3
+ host: string;
4
+ nodeEnv: "development" | "production" | "test";
5
+ mcpStatefulSessionTimeoutMs: number;
6
+ logLevel: "error" | "info" | "debug" | "warning" | "notice";
7
+ mcpLogLevel: "error" | "info" | "debug" | "warning" | "notice";
8
+ otelEnabled: boolean;
3
9
  serviceName: string;
4
10
  port: number;
5
11
  otelServiceName: string;
@@ -10,22 +16,23 @@ export declare const createMcpHttpServer: (config: {
10
16
  msadsRateLimitPerMinute: number;
11
17
  msadsReportPollIntervalMs: number;
12
18
  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
19
  mcpAuthSecretKey?: string | undefined;
24
20
  mcpAllowedOrigins?: string | undefined;
21
+ mcpAllowedHosts?: string | undefined;
25
22
  otelExporterOtlpTracesEndpoint?: string | undefined;
26
23
  otelExporterOtlpMetricsEndpoint?: string | undefined;
27
24
  gcsBucketName?: string | undefined;
25
+ msadsAccessToken?: string | undefined;
26
+ msadsDeveloperToken?: string | undefined;
27
+ msadsCustomerId?: string | undefined;
28
+ msadsAccountId?: string | undefined;
28
29
  }, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
30
+ host: string;
31
+ nodeEnv: "development" | "production" | "test";
32
+ mcpStatefulSessionTimeoutMs: number;
33
+ logLevel: "error" | "info" | "debug" | "warning" | "notice";
34
+ mcpLogLevel: "error" | "info" | "debug" | "warning" | "notice";
35
+ otelEnabled: boolean;
29
36
  serviceName: string;
30
37
  port: number;
31
38
  otelServiceName: string;
@@ -36,20 +43,15 @@ export declare const createMcpHttpServer: (config: {
36
43
  msadsRateLimitPerMinute: number;
37
44
  msadsReportPollIntervalMs: number;
38
45
  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
46
  mcpAuthSecretKey?: string | undefined;
50
47
  mcpAllowedOrigins?: string | undefined;
48
+ mcpAllowedHosts?: string | undefined;
51
49
  otelExporterOtlpTracesEndpoint?: string | undefined;
52
50
  otelExporterOtlpMetricsEndpoint?: string | undefined;
53
51
  gcsBucketName?: string | undefined;
52
+ msadsAccessToken?: string | undefined;
53
+ msadsDeveloperToken?: string | undefined;
54
+ msadsCustomerId?: string | undefined;
55
+ msadsAccountId?: string | undefined;
54
56
  }, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
55
57
  //# sourceMappingURL=streamable-http-transport.d.ts.map
@@ -1 +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"}
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;AAqEnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}
@@ -1,8 +1,10 @@
1
1
  import { createMcpServer } from "../server.js";
2
- import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
2
+ import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, createSessionForAuthWithEnvFallback, } from "@cesteral/shared";
3
3
  import { MsAdsBearerAuthStrategy } from "../../auth/msads-auth-strategy.js";
4
- import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
4
+ import { sessionServiceStore } from "../../services/session-services.js";
5
+ import { buildEnvAuthAdapter, buildSessionServices } from "../../services/session-wiring.js";
5
6
  import { rateLimiter } from "../../utils/platform.js";
7
+ import { MSADS_RETRY_CONFIG } from "../../services/msads/msads-http-client.js";
6
8
  function buildPlatformConfig(config, logger) {
7
9
  return {
8
10
  authStrategy: config.mcpAuthMode === "msads-bearer"
@@ -16,6 +18,7 @@ function buildPlatformConfig(config, logger) {
16
18
  "Authorization",
17
19
  "Mcp-Session-Id",
18
20
  "MCP-Protocol-Version",
21
+ "X-Cesteral-Decision-Token",
19
22
  "X-MSAds-Developer-Token",
20
23
  "X-MSAds-Customer-Id",
21
24
  "X-MSAds-Account-Id",
@@ -25,56 +28,18 @@ function buildPlatformConfig(config, logger) {
25
28
  : "Provide a valid Bearer token in the Authorization header.",
26
29
  sessionServiceStore,
27
30
  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
- };
31
+ retryDescriptor: {
32
+ maxRetries: MSADS_RETRY_CONFIG.maxRetries,
77
33
  },
34
+ createSessionForAuth: createSessionForAuthWithEnvFallback({
35
+ sessionServiceStore,
36
+ adapterFromAuth: (authResult) => authResult.platformAuthAdapter,
37
+ validateAuthAdapter: false,
38
+ buildServices: buildSessionServices,
39
+ buildEnvAdapter: buildEnvAuthAdapter,
40
+ credentialsRequiredMessage: "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.",
41
+ unsupportedModeMessage: "Microsoft Ads API credentials required for this server.",
42
+ }),
78
43
  async createMcpServer(log, sessionId, gcsBucket) {
79
44
  return createMcpServer(log, sessionId, gcsBucket);
80
45
  },
@@ -1 +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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"}
1
+ {"version":3,"file":"streamable-http-transport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAGlB,qBAAqB,EACrB,0BAA0B,EAC1B,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E,SAAS,mBAAmB,CAAC,MAAiB,EAAE,MAAc;IAC5D,OAAO;QACL,YAAY,EACV,MAAM,CAAC,WAAW,KAAK,cAAc;YACnC,CAAC,CAAC,IAAI,uBAAuB,CAAC,MAAM,CAAC,uBAAuB,CAAC;YAC7D,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,WAAuB,EAAE;gBACjD,SAAS,EAAE,MAAM,CAAC,gBAAgB;gBAClC,MAAM;aACP,CAAC;QACR,gBAAgB,EAAE;YAChB,cAAc;YACd,eAAe;YACf,gBAAgB;YAChB,sBAAsB;YACtB,2BAA2B;YAC3B,yBAAyB;YACzB,qBAAqB;YACrB,oBAAoB;SACrB;QACD,aAAa,EACX,MAAM,CAAC,WAAW,KAAK,cAAc;YACnC,CAAC,CAAC,6JAA6J;YAC/J,CAAC,CAAC,2DAA2D;QACjE,mBAAmB;QACnB,WAAW;QAKX,eAAe,EAAE;YACf,UAAU,EAAE,kBAAkB,CAAC,UAAU;SAC1C;QACD,oBAAoB,EAAE,mCAAmC,CAAC;YACxD,mBAAmB;YACnB,eAAe,EAAE,CAAC,UAAU,EAAE,EAAE,CAC9B,UAAU,CAAC,mBAAmD;YAChE,mBAAmB,EAAE,KAAK;YAC1B,aAAa,EAAE,oBAAoB;YACnC,eAAe,EAAE,mBAAmB;YACpC,0BAA0B,EACxB,yKAAyK;YAC3K,sBAAsB,EAAE,yDAAyD;SAClF,CAAC;QACF,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS;YAC7C,OAAO,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,eAAe,EAAE,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ;QAC3E,UAAU,EAAE,qBAAqB,CAAC,WAAW,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,GACnD,0BAA0B,CAAY,mBAAmB,CAAC,CAAC"}
@@ -1,5 +1,9 @@
1
1
  import type { MsAdsAuthAdapter } from "../../auth/msads-auth-adapter.js";
2
- import type { RequestContext } from "@cesteral/shared";
2
+ import { JsonRpcErrorCode } from "@cesteral/shared";
3
+ import type { RequestContext, RetryConfig } from "@cesteral/shared";
4
+ export declare const MSADS_RETRY_CONFIG: RetryConfig;
5
+ export declare function msadsThrottleDelayMs(_status: number, errorBody: string): number | undefined;
6
+ export declare function mapMsAdsStatusCode(status: number, errorBody: string): JsonRpcErrorCode;
3
7
  export declare class MsAdsHttpClient {
4
8
  private readonly authAdapter;
5
9
  private readonly baseUrl;
@@ -1 +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"}
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;AACzE,OAAO,EAGL,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpE,eAAO,MAAM,kBAAkB,EAAE,WAOhC,CAAC;AAoDF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB3F;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAItF;AAED,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;CA8B7B"}
@@ -1,6 +1,6 @@
1
- import { fetchWithTimeout, executeWithRetry } from "@cesteral/shared";
1
+ import { fetchWithTimeout, executeWithRetry, JsonRpcErrorCode, mapHttpStatusToJsonRpc, } from "@cesteral/shared";
2
2
  import { withMsAdsApiSpan } from "../../utils/platform.js";
3
- const MSADS_RETRY_CONFIG = {
3
+ export const MSADS_RETRY_CONFIG = {
4
4
  maxRetries: 3,
5
5
  initialBackoffMs: 2_000,
6
6
  maxBackoffMs: 30_000,
@@ -8,6 +8,51 @@ const MSADS_RETRY_CONFIG = {
8
8
  platformName: "Microsoft Ads",
9
9
  tokenExpiryHint: "Microsoft Ads token expired. Regenerate via Microsoft identity platform.",
10
10
  };
11
+ const MSADS_THROTTLE_WAITS = [
12
+ { code: 117, symbol: "CallRateExceeded", waitMs: 60_000 },
13
+ { code: 4204, symbol: "BulkServiceNoMoreCallsPermittedForTheTimePeriod", waitMs: 15 * 60_000 },
14
+ ];
15
+ function collectErrorCodes(node, out) {
16
+ if (Array.isArray(node)) {
17
+ for (const child of node)
18
+ collectErrorCodes(child, out);
19
+ return;
20
+ }
21
+ if (!node || typeof node !== "object")
22
+ return;
23
+ for (const [key, value] of Object.entries(node)) {
24
+ if ((key === "Code" || key === "ErrorCode") &&
25
+ (typeof value === "number" || typeof value === "string")) {
26
+ out.push(value);
27
+ }
28
+ else if (typeof value === "object") {
29
+ collectErrorCodes(value, out);
30
+ }
31
+ }
32
+ }
33
+ export function msadsThrottleDelayMs(_status, errorBody) {
34
+ let parsed;
35
+ try {
36
+ parsed = JSON.parse(errorBody);
37
+ }
38
+ catch {
39
+ return undefined;
40
+ }
41
+ const codes = [];
42
+ collectErrorCodes(parsed, codes);
43
+ let wait;
44
+ for (const { code, symbol, waitMs } of MSADS_THROTTLE_WAITS) {
45
+ if (codes.some((c) => c === code || c === String(code) || c === symbol)) {
46
+ wait = Math.max(wait ?? 0, waitMs);
47
+ }
48
+ }
49
+ return wait;
50
+ }
51
+ export function mapMsAdsStatusCode(status, errorBody) {
52
+ return msadsThrottleDelayMs(status, errorBody) !== undefined
53
+ ? JsonRpcErrorCode.RateLimited
54
+ : mapHttpStatusToJsonRpc(status);
55
+ }
11
56
  export class MsAdsHttpClient {
12
57
  authAdapter;
13
58
  baseUrl;
@@ -72,6 +117,8 @@ export class MsAdsHttpClient {
72
117
  context,
73
118
  logger: this.logger,
74
119
  fetchFn: fetchWithTimeout,
120
+ mapStatusCode: mapMsAdsStatusCode,
121
+ throttleDelayMs: msadsThrottleDelayMs,
75
122
  getHeaders: async () => {
76
123
  const accessToken = await this.authAdapter.getAccessToken();
77
124
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"msads-http-client.js","sourceRoot":"","sources":["../../../src/services/msads/msads-http-client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"msads-http-client.js","sourceRoot":"","sources":["../../../src/services/msads/msads-http-client.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,7 @@ import type { Logger } from "pino";
2
2
  import type { RateLimiter } from "@cesteral/shared";
3
3
  import type { MsAdsHttpClient } from "./msads-http-client.js";
4
4
  import { type RequestContext } from "@cesteral/shared";
5
+ import { type MsAdsQuotaScope } from "./rate-limit-keys.js";
5
6
  export interface ReportConfig {
6
7
  reportType: string;
7
8
  accountId: string;
@@ -17,9 +18,10 @@ export declare class MsAdsReportingService {
17
18
  private readonly rateLimiter;
18
19
  private readonly httpClient;
19
20
  private readonly logger;
21
+ private readonly quotaScope;
20
22
  private readonly maxPollAttempts;
21
23
  private readonly pollIntervalMs;
22
- constructor(rateLimiter: RateLimiter, httpClient: MsAdsHttpClient, logger: Logger, maxPollAttempts?: number, pollIntervalMs?: number);
24
+ constructor(rateLimiter: RateLimiter, httpClient: MsAdsHttpClient, logger: Logger, quotaScope: MsAdsQuotaScope, maxPollAttempts?: number, pollIntervalMs?: number);
23
25
  submitReport(config: ReportConfig, context?: RequestContext): Promise<string>;
24
26
  pollReport(reportRequestId: string, context?: RequestContext): Promise<string>;
25
27
  checkReportStatus(reportRequestId: string, context?: RequestContext): Promise<{
@@ -40,17 +42,9 @@ export declare class MsAdsReportingService {
40
42
  totalRows: number;
41
43
  reportRequestId: string;
42
44
  }>;
43
- createReportSchedule(config: ReportConfig & {
44
- scheduleName: string;
45
- schedule: Record<string, unknown>;
46
- }, context?: RequestContext): Promise<{
47
- scheduleId: string;
48
- scheduleName: string;
49
- }>;
50
45
  listReportSchedules(context?: RequestContext): Promise<{
51
46
  note: string;
52
47
  }>;
53
- deleteReportSchedule(scheduleId: string, context?: RequestContext): Promise<void>;
54
48
  private buildReportRequest;
55
49
  private parseDate;
56
50
  private parseCsv;
@@ -1 +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"}
1
+ {"version":3,"file":"msads-reporting-service.d.ts","sourceRoot":"","sources":["../../../src/services/msads/msads-reporting-service.ts"],"names":[],"mappings":"AAIA,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;AAC1B,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAsB/E,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,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBALd,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,eAAe,EAC3B,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;IAgCjF,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;IAgBzF,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAO9E,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;CAmCjB"}
@@ -1,5 +1,6 @@
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";
1
+ import { inflateRawSync } from "node:zlib";
2
+ import { fetchGuardedDownload, McpError, JsonRpcErrorCode, parseCSV, pollUntilComplete, ReportFailedError, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, } from "@cesteral/shared";
3
+ import { consumeMsAdsQuota } from "./rate-limit-keys.js";
3
4
  const POLL_BASE_MS = 3_000;
4
5
  const POLL_MAX_MS = 30_000;
5
6
  const DEFAULT_MAX_POLL_ATTEMPTS = 60;
@@ -7,17 +8,19 @@ export class MsAdsReportingService {
7
8
  rateLimiter;
8
9
  httpClient;
9
10
  logger;
11
+ quotaScope;
10
12
  maxPollAttempts;
11
13
  pollIntervalMs;
12
- constructor(rateLimiter, httpClient, logger, maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS, pollIntervalMs = POLL_BASE_MS) {
14
+ constructor(rateLimiter, httpClient, logger, quotaScope, maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS, pollIntervalMs = POLL_BASE_MS) {
13
15
  this.rateLimiter = rateLimiter;
14
16
  this.httpClient = httpClient;
15
17
  this.logger = logger;
18
+ this.quotaScope = quotaScope;
16
19
  this.maxPollAttempts = maxPollAttempts;
17
20
  this.pollIntervalMs = pollIntervalMs;
18
21
  }
19
22
  async submitReport(config, context) {
20
- await this.rateLimiter.consume(MSADS_WRITE_KEY, 3);
23
+ await consumeMsAdsQuota(this.rateLimiter, this.quotaScope, "write", 3);
21
24
  const body = this.buildReportRequest(config);
22
25
  this.logger.info({ reportType: config.reportType }, "Submitting report");
23
26
  const response = (await this.httpClient.post("/GenerateReport/Submit", body, context));
@@ -45,7 +48,7 @@ export class MsAdsReportingService {
45
48
  }
46
49
  }
47
50
  async checkReportStatus(reportRequestId, context) {
48
- await this.rateLimiter.consume(MSADS_READ_KEY);
51
+ await consumeMsAdsQuota(this.rateLimiter, this.quotaScope, "read");
49
52
  const response = (await this.httpClient.post("/GenerateReport/Poll", { ReportRequestId: reportRequestId }, context));
50
53
  return {
51
54
  status: response.ReportRequestStatus.Status,
@@ -54,11 +57,15 @@ export class MsAdsReportingService {
54
57
  }
55
58
  async downloadReport(downloadUrl, maxRows, context, options = {}) {
56
59
  this.logger.info({ downloadUrl: downloadUrl.substring(0, 80) }, "Downloading report");
57
- const response = await fetchWithTimeout(downloadUrl, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, context);
60
+ const response = await fetchGuardedDownload(downloadUrl, {
61
+ timeoutMs: DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS,
62
+ context,
63
+ });
58
64
  if (!response.ok) {
59
65
  throw new McpError(JsonRpcErrorCode.ServiceUnavailable, `Failed to download report: ${response.status} ${response.statusText}`);
60
66
  }
61
- const text = await response.text();
67
+ const buffer = Buffer.from(await response.arrayBuffer());
68
+ const text = isZipArchive(buffer) ? inflateSingleZipEntry(buffer) : buffer.toString("utf-8");
62
69
  const parsed = this.parseCsv(text, maxRows);
63
70
  return options.includeRawCsv ? { ...parsed, rawCsv: text } : parsed;
64
71
  }
@@ -68,31 +75,12 @@ export class MsAdsReportingService {
68
75
  const data = await this.downloadReport(downloadUrl, maxRows, context);
69
76
  return { ...data, reportRequestId };
70
77
  }
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
78
  async listReportSchedules(context) {
87
79
  void context;
88
80
  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.",
81
+ note: "Microsoft Advertising Reporting API v13 has no report schedules — it exposes only GenerateReport/Submit and GenerateReport/Poll — so there are no schedules to list via the API. Run one-off reports with msads_submit_report / msads_get_report.",
90
82
  };
91
83
  }
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
84
  buildReportRequest(config) {
97
85
  const request = {
98
86
  ReportName: `${config.reportType}_${Date.now()}`,
@@ -127,6 +115,7 @@ export class MsAdsReportingService {
127
115
  }
128
116
  parseCsv(text, maxRows) {
129
117
  const stripped = text.replace(/^\uFEFF/, "");
118
+ let headerSeen = false;
130
119
  const filtered = stripped
131
120
  .split(/\r?\n/)
132
121
  .filter((line) => {
@@ -137,6 +126,9 @@ export class MsAdsReportingService {
137
126
  return false;
138
127
  if (trimmed.startsWith("©") || trimmed.startsWith('"©'))
139
128
  return false;
129
+ if (!headerSeen && /^"[A-Za-z ]+:\s/.test(trimmed))
130
+ return false;
131
+ headerSeen = true;
140
132
  return true;
141
133
  })
142
134
  .join("\n");
@@ -150,4 +142,47 @@ export class MsAdsReportingService {
150
142
  return { headers, rows: limitedRows, totalRows };
151
143
  }
152
144
  }
145
+ const ZIP_LOCAL_FILE_SIG = 0x04034b50;
146
+ const ZIP_CENTRAL_DIR_SIG = 0x02014b50;
147
+ const ZIP_EOCD_SIG = 0x06054b50;
148
+ function isZipArchive(buffer) {
149
+ return buffer.length >= 4 && buffer.readUInt32LE(0) === ZIP_LOCAL_FILE_SIG;
150
+ }
151
+ function inflateSingleZipEntry(buffer) {
152
+ let eocd = -1;
153
+ for (let i = buffer.length - 22; i >= 0; i--) {
154
+ if (buffer.readUInt32LE(i) === ZIP_EOCD_SIG) {
155
+ eocd = i;
156
+ break;
157
+ }
158
+ }
159
+ if (eocd === -1) {
160
+ throw new McpError(JsonRpcErrorCode.InternalError, "Malformed report archive: ZIP end-of-central-directory record not found");
161
+ }
162
+ const centralDirOffset = buffer.readUInt32LE(eocd + 16);
163
+ if (buffer.readUInt32LE(centralDirOffset) !== ZIP_CENTRAL_DIR_SIG) {
164
+ throw new McpError(JsonRpcErrorCode.InternalError, "Malformed report archive: ZIP central-directory header not found");
165
+ }
166
+ const method = buffer.readUInt16LE(centralDirOffset + 10);
167
+ const compressedSize = buffer.readUInt32LE(centralDirOffset + 20);
168
+ const localHeaderOffset = buffer.readUInt32LE(centralDirOffset + 42);
169
+ if (buffer.readUInt32LE(localHeaderOffset) !== ZIP_LOCAL_FILE_SIG) {
170
+ throw new McpError(JsonRpcErrorCode.InternalError, "Malformed report archive: ZIP local-file header not found");
171
+ }
172
+ const localNameLength = buffer.readUInt16LE(localHeaderOffset + 26);
173
+ const localExtraLength = buffer.readUInt16LE(localHeaderOffset + 28);
174
+ const dataStart = localHeaderOffset + 30 + localNameLength + localExtraLength;
175
+ const compressed = buffer.subarray(dataStart, dataStart + compressedSize);
176
+ let decoded;
177
+ if (method === 0) {
178
+ decoded = Buffer.from(compressed);
179
+ }
180
+ else if (method === 8) {
181
+ decoded = inflateRawSync(compressed);
182
+ }
183
+ else {
184
+ throw new McpError(JsonRpcErrorCode.InternalError, `Unsupported ZIP compression method in report archive: ${method}`);
185
+ }
186
+ return decoded.toString("utf-8");
187
+ }
153
188
  //# sourceMappingURL=msads-reporting-service.js.map