@cesteral/meta-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 (336) hide show
  1. package/LICENSE.md +201 -0
  2. package/README.md +337 -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/meta-auth-adapter.d.ts +37 -0
  8. package/dist/auth/meta-auth-adapter.d.ts.map +1 -0
  9. package/dist/auth/meta-auth-adapter.js +109 -0
  10. package/dist/auth/meta-auth-adapter.js.map +1 -0
  11. package/dist/auth/meta-auth-strategy.d.ts +13 -0
  12. package/dist/auth/meta-auth-strategy.d.ts.map +1 -0
  13. package/dist/auth/meta-auth-strategy.js +47 -0
  14. package/dist/auth/meta-auth-strategy.js.map +1 -0
  15. package/dist/config/index.d.ts +108 -0
  16. package/dist/config/index.d.ts.map +1 -0
  17. package/dist/config/index.js +51 -0
  18. package/dist/config/index.js.map +1 -0
  19. package/dist/config/insights-catalog.json +95 -0
  20. package/dist/container/index.d.ts +5 -0
  21. package/dist/container/index.d.ts.map +1 -0
  22. package/dist/container/index.js +14 -0
  23. package/dist/container/index.js.map +1 -0
  24. package/dist/container/registrations/core.d.ts +3 -0
  25. package/dist/container/registrations/core.d.ts.map +1 -0
  26. package/dist/container/registrations/core.js +16 -0
  27. package/dist/container/registrations/core.js.map +1 -0
  28. package/dist/container/registrations/mcp.d.ts +2 -0
  29. package/dist/container/registrations/mcp.d.ts.map +1 -0
  30. package/dist/container/registrations/mcp.js +3 -0
  31. package/dist/container/registrations/mcp.js.map +1 -0
  32. package/dist/container/tokens.d.ts +6 -0
  33. package/dist/container/tokens.d.ts.map +1 -0
  34. package/dist/container/tokens.js +6 -0
  35. package/dist/container/tokens.js.map +1 -0
  36. package/dist/index.d.ts +3 -0
  37. package/dist/index.d.ts.map +1 -0
  38. package/dist/index.js +40 -0
  39. package/dist/index.js.map +1 -0
  40. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
  41. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
  42. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +244 -0
  43. package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
  44. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
  45. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
  46. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +111 -0
  47. package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
  48. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
  49. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
  50. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +160 -0
  51. package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
  52. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
  53. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
  54. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
  55. package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
  56. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
  57. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
  58. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
  59. package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
  60. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
  61. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
  62. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +234 -0
  63. package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
  64. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
  65. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
  66. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +159 -0
  67. package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
  68. package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts +4 -0
  69. package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.d.ts.map +1 -0
  70. package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js +79 -0
  71. package/dist/mcp-server/prompts/definitions/insights-reporting-workflow.prompt.js.map +1 -0
  72. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
  73. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
  74. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +289 -0
  75. package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
  76. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
  77. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
  78. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +109 -0
  79. package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
  80. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
  81. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
  82. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +77 -0
  83. package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
  84. package/dist/mcp-server/prompts/index.d.ts +9 -0
  85. package/dist/mcp-server/prompts/index.d.ts.map +1 -0
  86. package/dist/mcp-server/prompts/index.js +97 -0
  87. package/dist/mcp-server/prompts/index.js.map +1 -0
  88. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
  89. package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
  90. package/dist/mcp-server/resources/definitions/entity-examples.resource.js +140 -0
  91. package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
  92. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
  93. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
  94. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +117 -0
  95. package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
  96. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
  97. package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
  98. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +125 -0
  99. package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
  100. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
  101. package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
  102. package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
  103. package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
  104. package/dist/mcp-server/resources/definitions/findings.resource.d.ts +8 -0
  105. package/dist/mcp-server/resources/definitions/findings.resource.d.ts.map +1 -0
  106. package/dist/mcp-server/resources/definitions/findings.resource.js +33 -0
  107. package/dist/mcp-server/resources/definitions/findings.resource.js.map +1 -0
  108. package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
  109. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  110. package/dist/mcp-server/resources/definitions/index.js +81 -0
  111. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  112. package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts +3 -0
  113. package/dist/mcp-server/resources/definitions/insights-reference.resource.d.ts.map +1 -0
  114. package/dist/mcp-server/resources/definitions/insights-reference.resource.js +113 -0
  115. package/dist/mcp-server/resources/definitions/insights-reference.resource.js.map +1 -0
  116. package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
  117. package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
  118. package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +98 -0
  119. package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
  120. package/dist/mcp-server/resources/index.d.ts +3 -0
  121. package/dist/mcp-server/resources/index.d.ts.map +1 -0
  122. package/dist/mcp-server/resources/index.js +2 -0
  123. package/dist/mcp-server/resources/index.js.map +1 -0
  124. package/dist/mcp-server/resources/types.d.ts +8 -0
  125. package/dist/mcp-server/resources/types.d.ts.map +1 -0
  126. package/dist/mcp-server/resources/types.js +2 -0
  127. package/dist/mcp-server/resources/types.js.map +1 -0
  128. package/dist/mcp-server/resources/utils/field-rules.d.ts +18 -0
  129. package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
  130. package/dist/mcp-server/resources/utils/field-rules.js +103 -0
  131. package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
  132. package/dist/mcp-server/server.d.ts +5 -0
  133. package/dist/mcp-server/server.d.ts.map +1 -0
  134. package/dist/mcp-server/server.js +133 -0
  135. package/dist/mcp-server/server.js.map +1 -0
  136. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +221 -0
  137. package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
  138. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +178 -0
  139. package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
  140. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +143 -0
  141. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
  142. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +108 -0
  143. package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
  144. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +180 -0
  145. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
  146. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +125 -0
  147. package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
  148. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +140 -0
  149. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
  150. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
  151. package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
  152. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +148 -0
  153. package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
  154. package/dist/mcp-server/tools/definitions/check-report-status.tool.js +107 -0
  155. package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
  156. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +115 -0
  157. package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
  158. package/dist/mcp-server/tools/definitions/create-entity.tool.js +104 -0
  159. package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
  160. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +93 -0
  161. package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
  162. package/dist/mcp-server/tools/definitions/delete-entity.tool.js +102 -0
  163. package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
  164. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +183 -0
  165. package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
  166. package/dist/mcp-server/tools/definitions/download-report.tool.js +109 -0
  167. package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
  168. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +115 -0
  169. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
  170. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +98 -0
  171. package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
  172. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +69 -0
  173. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
  174. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +63 -0
  175. package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
  176. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +69 -0
  177. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
  178. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +68 -0
  179. package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
  180. package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts +91 -0
  181. package/dist/mcp-server/tools/definitions/get-available-metrics.tool.d.ts.map +1 -0
  182. package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js +85 -0
  183. package/dist/mcp-server/tools/definitions/get-available-metrics.tool.js.map +1 -0
  184. package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts +82 -0
  185. package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.d.ts.map +1 -0
  186. package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js +72 -0
  187. package/dist/mcp-server/tools/definitions/get-delivery-estimate.tool.js.map +1 -0
  188. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +90 -0
  189. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  190. package/dist/mcp-server/tools/definitions/get-entity.tool.js +83 -0
  191. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  192. package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts +277 -0
  193. package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.d.ts.map +1 -0
  194. package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js +175 -0
  195. package/dist/mcp-server/tools/definitions/get-insights-breakdowns.tool.js.map +1 -0
  196. package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts +274 -0
  197. package/dist/mcp-server/tools/definitions/get-insights.tool.d.ts.map +1 -0
  198. package/dist/mcp-server/tools/definitions/get-insights.tool.js +188 -0
  199. package/dist/mcp-server/tools/definitions/get-insights.tool.js.map +1 -0
  200. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts +141 -0
  201. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.d.ts.map +1 -0
  202. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js +157 -0
  203. package/dist/mcp-server/tools/definitions/get-pacing-status.tool.js.map +1 -0
  204. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +81 -0
  205. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
  206. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +73 -0
  207. package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
  208. package/dist/mcp-server/tools/definitions/index.d.ts +29 -0
  209. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  210. package/dist/mcp-server/tools/definitions/index.js +87 -0
  211. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  212. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts +147 -0
  213. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map +1 -0
  214. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js +83 -0
  215. package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map +1 -0
  216. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +184 -0
  217. package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
  218. package/dist/mcp-server/tools/definitions/list-entities.tool.js +105 -0
  219. package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
  220. package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts +128 -0
  221. package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.d.ts.map +1 -0
  222. package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js +145 -0
  223. package/dist/mcp-server/tools/definitions/manage-budget-schedule.tool.js.map +1 -0
  224. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +89 -0
  225. package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
  226. package/dist/mcp-server/tools/definitions/search-targeting.tool.js +87 -0
  227. package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
  228. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +192 -0
  229. package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
  230. package/dist/mcp-server/tools/definitions/submit-report.tool.js +131 -0
  231. package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
  232. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +1714 -0
  233. package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
  234. package/dist/mcp-server/tools/definitions/update-entity.tool.js +146 -0
  235. package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
  236. package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +88 -0
  237. package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
  238. package/dist/mcp-server/tools/definitions/upload-image.tool.js +89 -0
  239. package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
  240. package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +94 -0
  241. package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
  242. package/dist/mcp-server/tools/definitions/upload-video.tool.js +151 -0
  243. package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
  244. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +169 -0
  245. package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
  246. package/dist/mcp-server/tools/definitions/validate-entity.tool.js +103 -0
  247. package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
  248. package/dist/mcp-server/tools/index.d.ts +2 -0
  249. package/dist/mcp-server/tools/index.d.ts.map +1 -0
  250. package/dist/mcp-server/tools/index.js +2 -0
  251. package/dist/mcp-server/tools/index.js.map +1 -0
  252. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts +8 -0
  253. package/dist/mcp-server/tools/utils/capture-snapshot.d.ts.map +1 -0
  254. package/dist/mcp-server/tools/utils/capture-snapshot.js +70 -0
  255. package/dist/mcp-server/tools/utils/capture-snapshot.js.map +1 -0
  256. package/dist/mcp-server/tools/utils/dry-run.d.ts +11 -0
  257. package/dist/mcp-server/tools/utils/dry-run.d.ts.map +1 -0
  258. package/dist/mcp-server/tools/utils/dry-run.js +60 -0
  259. package/dist/mcp-server/tools/utils/dry-run.js.map +1 -0
  260. package/dist/mcp-server/tools/utils/entity-mapping.d.ts +14 -0
  261. package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
  262. package/dist/mcp-server/tools/utils/entity-mapping.js +138 -0
  263. package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
  264. package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
  265. package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
  266. package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
  267. package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
  268. package/dist/mcp-server/transports/streamable-http-transport.d.ts +53 -0
  269. package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
  270. package/dist/mcp-server/transports/streamable-http-transport.js +80 -0
  271. package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
  272. package/dist/services/meta/meta-graph-api-client.d.ts +19 -0
  273. package/dist/services/meta/meta-graph-api-client.d.ts.map +1 -0
  274. package/dist/services/meta/meta-graph-api-client.js +226 -0
  275. package/dist/services/meta/meta-graph-api-client.js.map +1 -0
  276. package/dist/services/meta/meta-insights-service.d.ts +76 -0
  277. package/dist/services/meta/meta-insights-service.d.ts.map +1 -0
  278. package/dist/services/meta/meta-insights-service.js +209 -0
  279. package/dist/services/meta/meta-insights-service.js.map +1 -0
  280. package/dist/services/meta/meta-service.d.ts +64 -0
  281. package/dist/services/meta/meta-service.d.ts.map +1 -0
  282. package/dist/services/meta/meta-service.js +177 -0
  283. package/dist/services/meta/meta-service.js.map +1 -0
  284. package/dist/services/meta/meta-targeting-service.d.ts +13 -0
  285. package/dist/services/meta/meta-targeting-service.d.ts.map +1 -0
  286. package/dist/services/meta/meta-targeting-service.js +38 -0
  287. package/dist/services/meta/meta-targeting-service.js.map +1 -0
  288. package/dist/services/meta/types.d.ts +227 -0
  289. package/dist/services/meta/types.d.ts.map +1 -0
  290. package/dist/services/meta/types.js +55 -0
  291. package/dist/services/meta/types.js.map +1 -0
  292. package/dist/services/session-services.d.ts +19 -0
  293. package/dist/services/session-services.d.ts.map +1 -0
  294. package/dist/services/session-services.js +19 -0
  295. package/dist/services/session-services.js.map +1 -0
  296. package/dist/testkit/fixtures/index.d.ts +9 -0
  297. package/dist/testkit/fixtures/index.d.ts.map +1 -0
  298. package/dist/testkit/fixtures/index.js +201 -0
  299. package/dist/testkit/fixtures/index.js.map +1 -0
  300. package/dist/testkit/index.d.ts +6 -0
  301. package/dist/testkit/index.d.ts.map +1 -0
  302. package/dist/testkit/index.js +26 -0
  303. package/dist/testkit/index.js.map +1 -0
  304. package/dist/testkit/types.d.ts +17 -0
  305. package/dist/testkit/types.d.ts.map +1 -0
  306. package/dist/testkit/types.js +2 -0
  307. package/dist/testkit/types.js.map +1 -0
  308. package/dist/types-global/mcp.d.ts +2 -0
  309. package/dist/types-global/mcp.d.ts.map +1 -0
  310. package/dist/types-global/mcp.js +2 -0
  311. package/dist/types-global/mcp.js.map +1 -0
  312. package/dist/utils/errors/index.d.ts +2 -0
  313. package/dist/utils/errors/index.d.ts.map +1 -0
  314. package/dist/utils/errors/index.js +2 -0
  315. package/dist/utils/errors/index.js.map +1 -0
  316. package/dist/utils/internal/request-context.d.ts +20 -0
  317. package/dist/utils/internal/request-context.d.ts.map +1 -0
  318. package/dist/utils/internal/request-context.js +19 -0
  319. package/dist/utils/internal/request-context.js.map +1 -0
  320. package/dist/utils/platform.d.ts +3 -0
  321. package/dist/utils/platform.d.ts.map +1 -0
  322. package/dist/utils/platform.js +5 -0
  323. package/dist/utils/platform.js.map +1 -0
  324. package/dist/utils/security/rate-limiter.d.ts +3 -0
  325. package/dist/utils/security/rate-limiter.d.ts.map +1 -0
  326. package/dist/utils/security/rate-limiter.js +5 -0
  327. package/dist/utils/security/rate-limiter.js.map +1 -0
  328. package/dist/utils/telemetry/index.d.ts +2 -0
  329. package/dist/utils/telemetry/index.d.ts.map +1 -0
  330. package/dist/utils/telemetry/index.js +2 -0
  331. package/dist/utils/telemetry/index.js.map +1 -0
  332. package/dist/utils/telemetry/tracing.d.ts +3 -0
  333. package/dist/utils/telemetry/tracing.d.ts.map +1 -0
  334. package/dist/utils/telemetry/tracing.js +4 -0
  335. package/dist/utils/telemetry/tracing.js.map +1 -0
  336. package/package.json +66 -0
@@ -0,0 +1,109 @@
1
+ import { extractHeader, fetchWithTimeout, fingerprintCredentials, JsonRpcErrorCode, McpError, OAuth2RefreshAdapterBase, } from "@cesteral/shared";
2
+ const DEFAULT_META_GRAPH_API_BASE_URL = "https://graph.facebook.com/v25.0";
3
+ async function fetchMetaUserId(token, baseUrl) {
4
+ const response = await fetchWithTimeout(`${baseUrl}/me?fields=id,name`, 10_000, undefined, {
5
+ headers: { Authorization: `Bearer ${token}` },
6
+ });
7
+ if (!response.ok) {
8
+ const errorBody = await response.text().catch(() => "");
9
+ throw new McpError(JsonRpcErrorCode.Unauthorized, `Meta token validation failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
10
+ }
11
+ const data = (await response.json());
12
+ return data.id;
13
+ }
14
+ export class MetaAccessTokenAdapter {
15
+ accessToken;
16
+ baseUrl;
17
+ validated = false;
18
+ _userId = "";
19
+ constructor(accessToken, baseUrl = DEFAULT_META_GRAPH_API_BASE_URL) {
20
+ this.accessToken = accessToken;
21
+ this.baseUrl = baseUrl;
22
+ }
23
+ get userId() {
24
+ return this._userId;
25
+ }
26
+ async getAccessToken() {
27
+ return this.accessToken;
28
+ }
29
+ async validate() {
30
+ if (this.validated)
31
+ return;
32
+ this._userId = await fetchMetaUserId(this.accessToken, this.baseUrl);
33
+ this.validated = true;
34
+ }
35
+ }
36
+ export class MetaRefreshTokenAdapter extends OAuth2RefreshAdapterBase {
37
+ baseUrl;
38
+ _userId = "";
39
+ static EXPIRY_BUFFER_MS = 24 * 60 * 60 * 1000;
40
+ static INDEFINITE_EXPIRES_IN_SECONDS = 100 * 365 * 24 * 60 * 60;
41
+ constructor(initialToken, appCredentials, baseUrl = DEFAULT_META_GRAPH_API_BASE_URL) {
42
+ super({
43
+ platformName: "Meta",
44
+ credentials: {
45
+ appId: appCredentials.appId,
46
+ appSecret: appCredentials.appSecret,
47
+ refreshToken: initialToken,
48
+ },
49
+ expiryBufferMs: MetaRefreshTokenAdapter.EXPIRY_BUFFER_MS,
50
+ requestToken: async (tokenToExchange) => {
51
+ const params = new URLSearchParams({
52
+ grant_type: "fb_exchange_token",
53
+ client_id: appCredentials.appId,
54
+ client_secret: appCredentials.appSecret,
55
+ fb_exchange_token: tokenToExchange,
56
+ });
57
+ const response = await fetchWithTimeout(`${baseUrl}/oauth/access_token`, 10_000, undefined, {
58
+ method: "POST",
59
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
60
+ body: params.toString(),
61
+ });
62
+ if (!response.ok) {
63
+ const errorBody = await response.text().catch(() => "");
64
+ throw new McpError(JsonRpcErrorCode.InternalError, `Meta token exchange failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
65
+ }
66
+ const data = (await response.json());
67
+ if (!data.access_token) {
68
+ throw new McpError(JsonRpcErrorCode.InternalError, "Meta token exchange returned no access_token");
69
+ }
70
+ return {
71
+ access_token: data.access_token,
72
+ expires_in: data.expires_in ?? MetaRefreshTokenAdapter.INDEFINITE_EXPIRES_IN_SECONDS,
73
+ refresh_token: data.access_token,
74
+ };
75
+ },
76
+ });
77
+ this.baseUrl = baseUrl;
78
+ }
79
+ get userId() {
80
+ return this._userId;
81
+ }
82
+ async validate() {
83
+ const token = await this.getAccessToken();
84
+ this._userId = await fetchMetaUserId(token, this.baseUrl);
85
+ }
86
+ }
87
+ export function parseMetaTokenFromHeaders(headers) {
88
+ const authHeader = extractHeader(headers, "authorization");
89
+ if (!authHeader) {
90
+ throw new Error("Missing required Authorization header");
91
+ }
92
+ const match = authHeader.match(/^Bearer\s+(.+)$/i);
93
+ if (!match || !match[1]) {
94
+ throw new Error("Authorization header must use Bearer scheme");
95
+ }
96
+ return match[1];
97
+ }
98
+ export function parseMetaAppCredentialsFromHeaders(headers) {
99
+ const appId = extractHeader(headers, "x-meta-app-id");
100
+ const appSecret = extractHeader(headers, "x-meta-app-secret");
101
+ if (!appId || !appSecret) {
102
+ return undefined;
103
+ }
104
+ return { appId, appSecret };
105
+ }
106
+ export function getMetaCredentialFingerprint(accessToken) {
107
+ return fingerprintCredentials(accessToken);
108
+ }
109
+ //# sourceMappingURL=meta-auth-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"meta-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/meta-auth-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { Logger } from "pino";
2
+ import { BearerAuthStrategyBase, type BearerAdapterResult } from "@cesteral/shared";
3
+ export declare class MetaBearerAuthStrategy extends BearerAuthStrategyBase {
4
+ private readonly baseUrl;
5
+ protected readonly authType = "meta-bearer";
6
+ protected readonly platformName = "Meta";
7
+ constructor(baseUrl: string, logger?: Logger);
8
+ protected resolveRefreshBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult | null>;
9
+ protected resolveAccessBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult>;
10
+ protected getRefreshFingerprint(headers: Record<string, string | string[] | undefined>): string | undefined;
11
+ protected getTokenFingerprint(headers: Record<string, string | string[] | undefined>): string;
12
+ }
13
+ //# sourceMappingURL=meta-auth-strategy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"meta-auth-strategy.d.ts","sourceRoot":"","sources":["../../src/auth/meta-auth-strategy.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AASpF,qBAAa,sBAAuB,SAAQ,sBAAsB;IAK9D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,SAAS,CAAC,QAAQ,CAAC,QAAQ,iBAAiB;IAC5C,SAAS,CAAC,QAAQ,CAAC,YAAY,UAAU;gBAGtB,OAAO,EAAE,MAAM,EAChC,MAAM,CAAC,EAAE,MAAM;cAKD,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;cAiBtB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,CAAC;IAa/B,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,GAAG,SAAS;IAMrB,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM;CAI9F"}
@@ -0,0 +1,47 @@
1
+ import { BearerAuthStrategyBase } from "@cesteral/shared";
2
+ import { MetaAccessTokenAdapter, MetaRefreshTokenAdapter, parseMetaTokenFromHeaders, parseMetaAppCredentialsFromHeaders, getMetaCredentialFingerprint, } from "./meta-auth-adapter.js";
3
+ export class MetaBearerAuthStrategy extends BearerAuthStrategyBase {
4
+ baseUrl;
5
+ authType = "meta-bearer";
6
+ platformName = "Meta";
7
+ constructor(baseUrl, logger) {
8
+ super(logger);
9
+ this.baseUrl = baseUrl;
10
+ }
11
+ async resolveRefreshBranch(headers) {
12
+ const appCreds = parseMetaAppCredentialsFromHeaders(headers);
13
+ if (!appCreds)
14
+ return null;
15
+ const token = parseMetaTokenFromHeaders(headers);
16
+ const adapter = new MetaRefreshTokenAdapter(token, appCreds, this.baseUrl);
17
+ await adapter.validate();
18
+ return {
19
+ adapter,
20
+ fingerprint: getMetaCredentialFingerprint(appCreds.appId),
21
+ userId: adapter.userId,
22
+ authFlow: "token-exchange",
23
+ };
24
+ }
25
+ async resolveAccessBranch(headers) {
26
+ const token = parseMetaTokenFromHeaders(headers);
27
+ const adapter = new MetaAccessTokenAdapter(token, this.baseUrl);
28
+ await adapter.validate();
29
+ return {
30
+ adapter,
31
+ fingerprint: getMetaCredentialFingerprint(token),
32
+ userId: adapter.userId,
33
+ authFlow: "static-token",
34
+ };
35
+ }
36
+ getRefreshFingerprint(headers) {
37
+ const appCreds = parseMetaAppCredentialsFromHeaders(headers);
38
+ if (!appCreds)
39
+ return undefined;
40
+ return getMetaCredentialFingerprint(appCreds.appId);
41
+ }
42
+ getTokenFingerprint(headers) {
43
+ const token = parseMetaTokenFromHeaders(headers);
44
+ return getMetaCredentialFingerprint(token);
45
+ }
46
+ }
47
+ //# sourceMappingURL=meta-auth-strategy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"meta-auth-strategy.js","sourceRoot":"","sources":["../../src/auth/meta-auth-strategy.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,sBAAsB,EAA4B,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,kCAAkC,EAClC,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,sBAAuB,SAAQ,sBAAsB;IAK7C;IAJA,QAAQ,GAAG,aAAa,CAAC;IACzB,YAAY,GAAG,MAAM,CAAC;IAEzC,YACmB,OAAe,EAChC,MAAe;QAEf,KAAK,CAAC,MAAM,CAAC,CAAC;QAHG,YAAO,GAAP,OAAO,CAAQ;IAIlC,CAAC;IAES,KAAK,CAAC,oBAAoB,CAClC,OAAsD;QAGtD,MAAM,QAAQ,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3E,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YACP,WAAW,EAAE,4BAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,gBAAgB;SAC3B,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,mBAAmB,CACjC,OAAsD;QAEtD,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YACP,WAAW,EAAE,4BAA4B,CAAC,KAAK,CAAC;YAChD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,cAAc;SACzB,CAAC;IACJ,CAAC;IAES,qBAAqB,CAC7B,OAAsD;QAEtD,MAAM,QAAQ,GAAG,kCAAkC,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,OAAO,4BAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAES,mBAAmB,CAAC,OAAsD;QAClF,MAAM,KAAK,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}
@@ -0,0 +1,108 @@
1
+ import { z } from "zod";
2
+ declare const ConfigSchema: z.ZodObject<{
3
+ host: z.ZodDefault<z.ZodString>;
4
+ nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
5
+ mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
6
+ mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
7
+ mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
8
+ logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
9
+ mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
10
+ otelEnabled: z.ZodDefault<z.ZodBoolean>;
11
+ otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
12
+ otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
13
+ gcsBucketName: z.ZodOptional<z.ZodString>;
14
+ } & {
15
+ serviceName: z.ZodDefault<z.ZodString>;
16
+ port: z.ZodDefault<z.ZodNumber>;
17
+ otelServiceName: z.ZodDefault<z.ZodString>;
18
+ mcpAuthMode: z.ZodDefault<z.ZodEnum<["meta-bearer", "jwt", "none"]>>;
19
+ metaApiBaseUrl: z.ZodDefault<z.ZodString>;
20
+ metaApiVersion: z.ZodDefault<z.ZodString>;
21
+ metaRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
22
+ metaAccessToken: z.ZodOptional<z.ZodString>;
23
+ metaVideoUploadPollIntervalMs: z.ZodDefault<z.ZodNumber>;
24
+ metaVideoUploadMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
25
+ metaVideoUploadMaxBufferedBytes: z.ZodDefault<z.ZodNumber>;
26
+ metaAppId: z.ZodOptional<z.ZodString>;
27
+ metaAppSecret: z.ZodOptional<z.ZodString>;
28
+ }, "strip", z.ZodTypeAny, {
29
+ serviceName: string;
30
+ port: number;
31
+ otelServiceName: string;
32
+ mcpAuthMode: "meta-bearer" | "jwt" | "none";
33
+ metaApiBaseUrl: string;
34
+ metaApiVersion: string;
35
+ metaRateLimitPerMinute: number;
36
+ metaVideoUploadPollIntervalMs: number;
37
+ metaVideoUploadMaxPollAttempts: number;
38
+ metaVideoUploadMaxBufferedBytes: 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
+ metaAccessToken?: string | undefined;
46
+ metaAppId?: string | undefined;
47
+ metaAppSecret?: string | undefined;
48
+ mcpAuthSecretKey?: string | undefined;
49
+ mcpAllowedOrigins?: string | undefined;
50
+ otelExporterOtlpTracesEndpoint?: string | undefined;
51
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
52
+ gcsBucketName?: string | undefined;
53
+ }, {
54
+ serviceName?: string | undefined;
55
+ port?: number | undefined;
56
+ otelServiceName?: string | undefined;
57
+ mcpAuthMode?: "meta-bearer" | "jwt" | "none" | undefined;
58
+ metaApiBaseUrl?: string | undefined;
59
+ metaApiVersion?: string | undefined;
60
+ metaRateLimitPerMinute?: number | undefined;
61
+ metaAccessToken?: string | undefined;
62
+ metaVideoUploadPollIntervalMs?: number | undefined;
63
+ metaVideoUploadMaxPollAttempts?: number | undefined;
64
+ metaVideoUploadMaxBufferedBytes?: number | undefined;
65
+ metaAppId?: string | undefined;
66
+ metaAppSecret?: string | undefined;
67
+ host?: string | undefined;
68
+ nodeEnv?: "development" | "production" | "test" | undefined;
69
+ mcpStatefulSessionTimeoutMs?: number | undefined;
70
+ mcpAuthSecretKey?: string | undefined;
71
+ mcpAllowedOrigins?: string | undefined;
72
+ logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
73
+ mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
74
+ otelEnabled?: boolean | undefined;
75
+ otelExporterOtlpTracesEndpoint?: string | undefined;
76
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
77
+ gcsBucketName?: string | undefined;
78
+ }>;
79
+ export type AppConfig = z.infer<typeof ConfigSchema>;
80
+ export declare function parseConfig(): AppConfig;
81
+ export declare const mcpConfig: {
82
+ serviceName: string;
83
+ port: number;
84
+ otelServiceName: string;
85
+ mcpAuthMode: "meta-bearer" | "jwt" | "none";
86
+ metaApiBaseUrl: string;
87
+ metaApiVersion: string;
88
+ metaRateLimitPerMinute: number;
89
+ metaVideoUploadPollIntervalMs: number;
90
+ metaVideoUploadMaxPollAttempts: number;
91
+ metaVideoUploadMaxBufferedBytes: number;
92
+ host: string;
93
+ nodeEnv: "development" | "production" | "test";
94
+ mcpStatefulSessionTimeoutMs: number;
95
+ logLevel: "debug" | "info" | "notice" | "warning" | "error";
96
+ mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
97
+ otelEnabled: boolean;
98
+ metaAccessToken?: string | undefined;
99
+ metaAppId?: string | undefined;
100
+ metaAppSecret?: string | undefined;
101
+ mcpAuthSecretKey?: string | undefined;
102
+ mcpAllowedOrigins?: string | undefined;
103
+ otelExporterOtlpTracesEndpoint?: string | undefined;
104
+ otelExporterOtlpMetricsEndpoint?: string | undefined;
105
+ gcsBucketName?: string | undefined;
106
+ };
107
+ export {};
108
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgChB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CAsCvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}
@@ -0,0 +1,51 @@
1
+ import { z } from "zod";
2
+ import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
3
+ loadDotEnv();
4
+ const ConfigSchema = BaseConfigSchema.extend({
5
+ serviceName: z.string().default("meta-mcp"),
6
+ port: z.number().int().min(1).max(65535).default(3005),
7
+ otelServiceName: z.string().default("meta-mcp"),
8
+ mcpAuthMode: z.enum(["meta-bearer", "jwt", "none"]).default("meta-bearer"),
9
+ metaApiBaseUrl: z.string().url().default("https://graph.facebook.com/v25.0"),
10
+ metaApiVersion: z.string().default("v25.0"),
11
+ metaRateLimitPerMinute: z.number().default(20),
12
+ metaAccessToken: z.string().optional(),
13
+ metaVideoUploadPollIntervalMs: z.number().default(15_000),
14
+ metaVideoUploadMaxPollAttempts: z.number().default(20),
15
+ metaVideoUploadMaxBufferedBytes: z
16
+ .number()
17
+ .int()
18
+ .positive()
19
+ .default(256 * 1024 * 1024),
20
+ metaAppId: z.string().optional(),
21
+ metaAppSecret: z.string().optional(),
22
+ });
23
+ export function parseConfig() {
24
+ const defaultHost = getDefaultHost();
25
+ const rawConfig = {
26
+ ...getBaseEnvConfig(defaultHost),
27
+ serviceName: process.env.SERVICE_NAME,
28
+ ...(process.env.META_MCP_PORT ? { port: Number(process.env.META_MCP_PORT) } : {}),
29
+ host: process.env.META_MCP_HOST || defaultHost,
30
+ metaApiBaseUrl: process.env.META_API_BASE_URL,
31
+ metaApiVersion: process.env.META_API_VERSION,
32
+ metaRateLimitPerMinute: process.env.META_RATE_LIMIT_PER_MINUTE
33
+ ? Number(process.env.META_RATE_LIMIT_PER_MINUTE)
34
+ : undefined,
35
+ metaVideoUploadPollIntervalMs: process.env.META_VIDEO_UPLOAD_POLL_INTERVAL_MS
36
+ ? Number(process.env.META_VIDEO_UPLOAD_POLL_INTERVAL_MS)
37
+ : undefined,
38
+ metaVideoUploadMaxPollAttempts: process.env.META_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS
39
+ ? Number(process.env.META_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS)
40
+ : undefined,
41
+ metaVideoUploadMaxBufferedBytes: process.env.META_VIDEO_UPLOAD_MAX_BUFFERED_BYTES
42
+ ? Number(process.env.META_VIDEO_UPLOAD_MAX_BUFFERED_BYTES)
43
+ : undefined,
44
+ metaAccessToken: process.env.META_ACCESS_TOKEN,
45
+ metaAppId: process.env.META_APP_ID,
46
+ metaAppSecret: process.env.META_APP_SECRET,
47
+ };
48
+ return parseConfigWithSchema(ConfigSchema, rawConfig);
49
+ }
50
+ export const mcpConfig = parseConfig();
51
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,95 @@
1
+ {
2
+ "description": "Static catalog of Meta Marketing API v24.0+ Insights fields, breakdowns, and action breakdowns. Seeded from https://developers.facebook.com/docs/marketing-api/insights/parameters. Keep in sync as the API evolves.",
3
+ "levels": ["account", "campaign", "adset", "ad"],
4
+ "metrics": {
5
+ "delivery": ["impressions", "reach", "frequency", "spend", "cpm", "cpp"],
6
+ "engagement": [
7
+ "clicks",
8
+ "unique_clicks",
9
+ "cpc",
10
+ "unique_cpc",
11
+ "ctr",
12
+ "unique_ctr",
13
+ "inline_link_clicks",
14
+ "inline_link_click_ctr",
15
+ "cost_per_inline_link_click",
16
+ "inline_post_engagement",
17
+ "cost_per_inline_post_engagement"
18
+ ],
19
+ "video": [
20
+ "video_play_actions",
21
+ "video_thruplay_watched_actions",
22
+ "video_p25_watched_actions",
23
+ "video_p50_watched_actions",
24
+ "video_p75_watched_actions",
25
+ "video_p95_watched_actions",
26
+ "video_p100_watched_actions",
27
+ "video_avg_time_watched_actions",
28
+ "cost_per_thruplay"
29
+ ],
30
+ "conversions": [
31
+ "actions",
32
+ "action_values",
33
+ "unique_actions",
34
+ "cost_per_action_type",
35
+ "cost_per_unique_action_type",
36
+ "conversions",
37
+ "conversion_values",
38
+ "cost_per_conversion",
39
+ "purchase_roas",
40
+ "website_purchase_roas"
41
+ ],
42
+ "attribution": ["attribution_setting", "mobile_app_purchase_roas"],
43
+ "quality": ["quality_ranking", "engagement_rate_ranking", "conversion_rate_ranking"],
44
+ "other": [
45
+ "date_start",
46
+ "date_stop",
47
+ "account_id",
48
+ "account_name",
49
+ "account_currency",
50
+ "campaign_id",
51
+ "campaign_name",
52
+ "adset_id",
53
+ "adset_name",
54
+ "ad_id",
55
+ "ad_name",
56
+ "objective",
57
+ "optimization_goal",
58
+ "buying_type"
59
+ ]
60
+ },
61
+ "breakdowns": [
62
+ "age",
63
+ "gender",
64
+ "country",
65
+ "region",
66
+ "dma",
67
+ "impression_device",
68
+ "publisher_platform",
69
+ "platform_position",
70
+ "device_platform",
71
+ "product_id",
72
+ "hourly_stats_aggregated_by_advertiser_time_zone",
73
+ "hourly_stats_aggregated_by_audience_time_zone",
74
+ "frequency_value"
75
+ ],
76
+ "actionBreakdowns": [
77
+ "action_type",
78
+ "action_target_id",
79
+ "action_destination",
80
+ "action_device",
81
+ "action_video_sound",
82
+ "action_video_type",
83
+ "action_carousel_card_id",
84
+ "action_carousel_card_name",
85
+ "action_converted_product_id",
86
+ "action_reaction",
87
+ "standard_event_content_type"
88
+ ],
89
+ "notes": [
90
+ "`breakdowns` and `action_breakdowns` may be combined; some pairs are invalid (e.g. impression_device + publisher_platform cross-breakdowns) — the API will reject invalid combinations with error code 100.",
91
+ "`attribution_setting` controls the attribution window; default is the ad account's default setting.",
92
+ "`quality_ranking`, `engagement_rate_ranking`, `conversion_rate_ranking` require ads with sufficient delivery (typically 500+ impressions over the last 7 days).",
93
+ "This catalog is a snapshot. For the authoritative current list, see the Meta Marketing API docs or call Meta's own field-introspection endpoints."
94
+ ]
95
+ }
@@ -0,0 +1,5 @@
1
+ import "reflect-metadata";
2
+ import type { Logger } from "pino";
3
+ export declare function composeContainer(logger?: Logger): void;
4
+ export * as Tokens from "./tokens.js";
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAStD;AAED,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}
@@ -0,0 +1,14 @@
1
+ import "reflect-metadata";
2
+ import { registerCoreServices } from "./registrations/core.js";
3
+ import { registerMcpServices } from "./registrations/mcp.js";
4
+ let isContainerComposed = false;
5
+ export function composeContainer(logger) {
6
+ if (isContainerComposed) {
7
+ return;
8
+ }
9
+ registerCoreServices(logger);
10
+ registerMcpServices();
11
+ isContainerComposed = true;
12
+ }
13
+ export * as Tokens from "./tokens.js";
14
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,EAAE,CAAC;IAEtB,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC;AAED,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Logger } from "pino";
2
+ export declare function registerCoreServices(logger?: Logger): void;
3
+ //# sourceMappingURL=core.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/container/registrations/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAW1D"}
@@ -0,0 +1,16 @@
1
+ import { container } from "tsyringe";
2
+ import { createLogger } from "@cesteral/shared";
3
+ import { appConfig } from "../../config/index.js";
4
+ import * as Tokens from "../tokens.js";
5
+ import { rateLimiter } from "../../utils/security/rate-limiter.js";
6
+ import { requestContextService } from "@cesteral/shared";
7
+ export function registerCoreServices(logger) {
8
+ container.register(Tokens.AppConfig, { useValue: appConfig });
9
+ const loggerInstance = logger || createLogger("meta-mcp");
10
+ container.register(Tokens.Logger, { useValue: loggerInstance });
11
+ container.register(Tokens.RequestContextService, { useValue: requestContextService });
12
+ container.register(Tokens.RateLimiterService, {
13
+ useValue: rateLimiter,
14
+ });
15
+ }
16
+ //# sourceMappingURL=core.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/container/registrations/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9D,MAAM,cAAc,GAAG,MAAM,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1D,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;IAEhE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAEtF,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC5C,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function registerMcpServices(): void;
2
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/container/registrations/mcp.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}
@@ -0,0 +1,3 @@
1
+ export function registerMcpServices() {
2
+ }
3
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/container/registrations/mcp.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB;AAInC,CAAC"}
@@ -0,0 +1,6 @@
1
+ export declare const AppConfig: unique symbol;
2
+ export declare const Logger: unique symbol;
3
+ export declare const RateLimiterService: unique symbol;
4
+ export declare const RequestContextService: unique symbol;
5
+ export declare const ResourceRegistry: unique symbol;
6
+ //# sourceMappingURL=tokens.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/container/tokens.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS,eAAsB,CAAC;AAC7C,eAAO,MAAM,MAAM,eAAmB,CAAC;AAGvC,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAGrE,eAAO,MAAM,gBAAgB,eAA6B,CAAC"}
@@ -0,0 +1,6 @@
1
+ export const AppConfig = Symbol("AppConfig");
2
+ export const Logger = Symbol("Logger");
3
+ export const RateLimiterService = Symbol("RateLimiterService");
4
+ export const RequestContextService = Symbol("RequestContextService");
5
+ export const ResourceRegistry = Symbol("ResourceRegistry");
6
+ //# sourceMappingURL=tokens.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/container/tokens.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAGvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAGrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
package/dist/index.js ADDED
@@ -0,0 +1,40 @@
1
+ #!/usr/bin/env node
2
+ import { mcpConfig } from "./config/index.js";
3
+ import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
4
+ import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
5
+ import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
6
+ import { MetaAccessTokenAdapter } from "./auth/meta-auth-adapter.js";
7
+ import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
8
+ import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
9
+ import { rateLimiter } from "./utils/platform.js";
10
+ const transportMode = detectTransportMode();
11
+ const logger = createServerLogger("meta-mcp", transportMode, otelLogMixin());
12
+ async function setupStdioCredentials(sessionId) {
13
+ const accessToken = mcpConfig.metaAccessToken;
14
+ if (!accessToken) {
15
+ logger.warn("No Meta credentials found in env vars. " + "Set META_ACCESS_TOKEN for stdio mode.");
16
+ return false;
17
+ }
18
+ const authAdapter = new MetaAccessTokenAdapter(accessToken, mcpConfig.metaApiBaseUrl);
19
+ await authAdapter.validate();
20
+ const services = createSessionServices(authAdapter, { baseUrl: mcpConfig.metaApiBaseUrl }, logger, rateLimiter);
21
+ sessionServiceStore.set(sessionId, services);
22
+ logger.info("Stdio session services created successfully");
23
+ return true;
24
+ }
25
+ bootstrapMcpServer({
26
+ serviceName: "meta-mcp",
27
+ config: mcpConfig,
28
+ logger,
29
+ transportMode,
30
+ initOtel: initializeOpenTelemetry,
31
+ setupStdioSession: setupStdioCredentials,
32
+ createMcpServer,
33
+ runStdio: runStdioServer,
34
+ startHttp: startHttpServer,
35
+ onShutdown: () => rateLimiter.destroy(),
36
+ }).catch((err) => {
37
+ logger.fatal({ err }, "Failed to start meta-mcp");
38
+ process.exit(1);
39
+ });
40
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAM7E,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,eAAe,CAAC;IAE9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CACT,yCAAyC,GAAG,uCAAuC,CACpF,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAGtF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX,EAAE,OAAO,EAAE,SAAS,CAAC,cAAc,EAAE,EACrC,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
2
+ export declare const bulkOperationsWorkflowPrompt: Prompt;
3
+ export declare function getBulkOperationsWorkflowMessage(args?: Record<string, string>): string;
4
+ //# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAmOtF"}