@cesteral/msads-mcp 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +201 -0
- package/README.md +179 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/msads-auth-adapter.d.ts +27 -0
- package/dist/auth/msads-auth-adapter.d.ts.map +1 -0
- package/dist/auth/msads-auth-adapter.js +79 -0
- package/dist/auth/msads-auth-adapter.js.map +1 -0
- package/dist/auth/msads-auth-strategy.d.ts +8 -0
- package/dist/auth/msads-auth-strategy.d.ts.map +1 -0
- package/dist/auth/msads-auth-strategy.js +36 -0
- package/dist/auth/msads-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +112 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +56 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +47 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +54 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +147 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js +73 -0
- package/dist/mcp-server/prompts/definitions/google-import-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js +55 -0
- package/dist/mcp-server/prompts/definitions/reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +47 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +49 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +84 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +54 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +54 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js +28 -0
- package/dist/mcp-server/resources/definitions/field-rules.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +7 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +79 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js +64 -0
- package/dist/mcp-server/resources/definitions/reporting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts +9 -0
- package/dist/mcp-server/resources/utils/field-rules.d.ts.map +1 -0
- package/dist/mcp-server/resources/utils/field-rules.js +106 -0
- package/dist/mcp-server/resources/utils/field-rules.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +142 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +175 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +124 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +83 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +68 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +95 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +102 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +151 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts +111 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js +73 -0
- package/dist/mcp-server/tools/definitions/check-report-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +74 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts +160 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js +108 -0
- package/dist/mcp-server/tools/definitions/create-report-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +98 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +94 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/delete-report-schedule.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts +287 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/download-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js +85 -0
- package/dist/mcp-server/tools/definitions/get-ad-details.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +90 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +285 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +120 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts +280 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js +138 -0
- package/dist/mcp-server/tools/definitions/get-report-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts +260 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js +118 -0
- package/dist/mcp-server/tools/definitions/get-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/import-from-google.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +3 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +53 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts +135 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/list-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +120 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +100 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts +47 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js +57 -0
- package/dist/mcp-server/tools/definitions/list-report-schedules.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js +81 -0
- package/dist/mcp-server/tools/definitions/manage-ad-extensions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts +90 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js +92 -0
- package/dist/mcp-server/tools/definitions/manage-criterions.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +105 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts +132 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js +94 -0
- package/dist/mcp-server/tools/definitions/submit-report.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +79 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +64 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +174 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +142 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +20 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +118 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +55 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +86 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/msads/msads-http-client.d.ts +16 -0
- package/dist/services/msads/msads-http-client.d.ts.map +1 -0
- package/dist/services/msads/msads-http-client.js +89 -0
- package/dist/services/msads/msads-http-client.js.map +1 -0
- package/dist/services/msads/msads-reporting-service.d.ts +58 -0
- package/dist/services/msads/msads-reporting-service.d.ts.map +1 -0
- package/dist/services/msads/msads-reporting-service.js +153 -0
- package/dist/services/msads/msads-reporting-service.js.map +1 -0
- package/dist/services/msads/msads-service.d.ts +54 -0
- package/dist/services/msads/msads-service.d.ts.map +1 -0
- package/dist/services/msads/msads-service.js +179 -0
- package/dist/services/msads/msads-service.js.map +1 -0
- package/dist/services/msads/rate-limit-keys.d.ts +3 -0
- package/dist/services/msads/rate-limit-keys.d.ts.map +1 -0
- package/dist/services/msads/rate-limit-keys.js +3 -0
- package/dist/services/msads/rate-limit-keys.js.map +1 -0
- package/dist/services/msads/types.d.ts +196 -0
- package/dist/services/msads/types.d.ts.map +1 -0
- package/dist/services/msads/types.js +47 -0
- package/dist/services/msads/types.js.map +1 -0
- package/dist/services/session-services.d.ts +22 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +22 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +56 -0
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import { JsonRpcErrorCode, McpError } from "@cesteral/shared";
|
|
2
|
+
const ENTITY_CONFIGS = {
|
|
3
|
+
campaign: {
|
|
4
|
+
addOperation: "/Campaigns",
|
|
5
|
+
getByAccountOperation: "/Campaigns/QueryByAccountId",
|
|
6
|
+
getByIdsOperation: "/Campaigns/QueryByIds",
|
|
7
|
+
updateOperation: "/Campaigns",
|
|
8
|
+
deleteOperation: "/Campaigns",
|
|
9
|
+
idField: "Id",
|
|
10
|
+
pluralName: "Campaigns",
|
|
11
|
+
displayName: "Campaign",
|
|
12
|
+
idsField: "CampaignIds",
|
|
13
|
+
batchLimit: 100,
|
|
14
|
+
requiredGetByIdsFields: ["AccountId"],
|
|
15
|
+
},
|
|
16
|
+
adGroup: {
|
|
17
|
+
addOperation: "/AdGroups",
|
|
18
|
+
getByParentOperation: "/AdGroups/QueryByCampaignId",
|
|
19
|
+
getByIdsOperation: "/AdGroups/QueryByIds",
|
|
20
|
+
updateOperation: "/AdGroups",
|
|
21
|
+
deleteOperation: "/AdGroups",
|
|
22
|
+
idField: "Id",
|
|
23
|
+
parentIdField: "CampaignId",
|
|
24
|
+
pluralName: "AdGroups",
|
|
25
|
+
displayName: "Ad Group",
|
|
26
|
+
idsField: "AdGroupIds",
|
|
27
|
+
batchLimit: 1000,
|
|
28
|
+
requiredGetByIdsFields: ["CampaignId"],
|
|
29
|
+
},
|
|
30
|
+
ad: {
|
|
31
|
+
addOperation: "/Ads",
|
|
32
|
+
getByParentOperation: "/Ads/QueryByAdGroupId",
|
|
33
|
+
getByIdsOperation: "/Ads/QueryByIds",
|
|
34
|
+
updateOperation: "/Ads",
|
|
35
|
+
deleteOperation: "/Ads",
|
|
36
|
+
idField: "Id",
|
|
37
|
+
parentIdField: "AdGroupId",
|
|
38
|
+
pluralName: "Ads",
|
|
39
|
+
displayName: "Ad",
|
|
40
|
+
idsField: "AdIds",
|
|
41
|
+
batchLimit: 50,
|
|
42
|
+
requiredGetByIdsFields: ["AdGroupId"],
|
|
43
|
+
},
|
|
44
|
+
keyword: {
|
|
45
|
+
addOperation: "/Keywords",
|
|
46
|
+
getByParentOperation: "/Keywords/QueryByAdGroupId",
|
|
47
|
+
getByIdsOperation: "/Keywords/QueryByIds",
|
|
48
|
+
updateOperation: "/Keywords",
|
|
49
|
+
deleteOperation: "/Keywords",
|
|
50
|
+
idField: "Id",
|
|
51
|
+
parentIdField: "AdGroupId",
|
|
52
|
+
pluralName: "Keywords",
|
|
53
|
+
displayName: "Keyword",
|
|
54
|
+
idsField: "KeywordIds",
|
|
55
|
+
batchLimit: 1000,
|
|
56
|
+
requiredGetByIdsFields: ["AdGroupId"],
|
|
57
|
+
},
|
|
58
|
+
budget: {
|
|
59
|
+
addOperation: "/Budgets",
|
|
60
|
+
getByIdsOperation: "/Budgets/QueryByIds",
|
|
61
|
+
updateOperation: "/Budgets",
|
|
62
|
+
deleteOperation: "/Budgets",
|
|
63
|
+
idField: "Id",
|
|
64
|
+
pluralName: "Budgets",
|
|
65
|
+
displayName: "Budget",
|
|
66
|
+
idsField: "BudgetIds",
|
|
67
|
+
batchLimit: 100,
|
|
68
|
+
},
|
|
69
|
+
adExtension: {
|
|
70
|
+
addOperation: "/AdExtensions",
|
|
71
|
+
getByIdsOperation: "/AdExtensions/QueryByIds",
|
|
72
|
+
updateOperation: "/AdExtensions",
|
|
73
|
+
deleteOperation: "/AdExtensions",
|
|
74
|
+
idField: "Id",
|
|
75
|
+
pluralName: "AdExtensions",
|
|
76
|
+
displayName: "Ad Extension",
|
|
77
|
+
idsField: "AdExtensionIds",
|
|
78
|
+
batchLimit: 100,
|
|
79
|
+
requiredGetByIdsFields: ["AccountId", "AdExtensionType"],
|
|
80
|
+
},
|
|
81
|
+
audience: {
|
|
82
|
+
addOperation: "/Audiences",
|
|
83
|
+
getByIdsOperation: "/Audiences/QueryByIds",
|
|
84
|
+
updateOperation: "/Audiences",
|
|
85
|
+
deleteOperation: "/Audiences",
|
|
86
|
+
idField: "Id",
|
|
87
|
+
pluralName: "Audiences",
|
|
88
|
+
displayName: "Audience",
|
|
89
|
+
idsField: "AudienceIds",
|
|
90
|
+
batchLimit: 100,
|
|
91
|
+
},
|
|
92
|
+
label: {
|
|
93
|
+
addOperation: "/Labels",
|
|
94
|
+
getByIdsOperation: "/Labels/QueryByIds",
|
|
95
|
+
updateOperation: "/Labels",
|
|
96
|
+
deleteOperation: "/Labels",
|
|
97
|
+
idField: "Id",
|
|
98
|
+
pluralName: "Labels",
|
|
99
|
+
displayName: "Label",
|
|
100
|
+
idsField: "LabelIds",
|
|
101
|
+
batchLimit: 100,
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
export function getEntityConfig(entityType) {
|
|
105
|
+
const config = ENTITY_CONFIGS[entityType];
|
|
106
|
+
if (!config) {
|
|
107
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Unknown Microsoft Ads entity type: ${entityType}`);
|
|
108
|
+
}
|
|
109
|
+
return config;
|
|
110
|
+
}
|
|
111
|
+
export function getSupportedEntityTypes() {
|
|
112
|
+
return Object.keys(ENTITY_CONFIGS);
|
|
113
|
+
}
|
|
114
|
+
export function getEntityTypeEnum() {
|
|
115
|
+
const types = getSupportedEntityTypes();
|
|
116
|
+
return types;
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=entity-mapping.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"entity-mapping.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/entity-mapping.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve-session.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,eAAe,CAE/E"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { resolveSessionServicesFromStore } from "@cesteral/shared";
|
|
2
|
+
import { sessionServiceStore } from "../../../services/session-services.js";
|
|
3
|
+
export function resolveSessionServices(sdkContext) {
|
|
4
|
+
return resolveSessionServicesFromStore(sessionServiceStore, sdkContext);
|
|
5
|
+
}
|
|
6
|
+
//# sourceMappingURL=resolve-session.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/utils/resolve-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uCAAuC,CAAC;AAOlG,MAAM,UAAU,sBAAsB,CAAC,UAAuB;IAC5D,OAAO,+BAA+B,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import type { Logger } from "pino";
|
|
2
|
+
export declare const createMcpHttpServer: (config: {
|
|
3
|
+
serviceName: string;
|
|
4
|
+
port: number;
|
|
5
|
+
otelServiceName: string;
|
|
6
|
+
mcpAuthMode: "msads-bearer" | "jwt" | "none";
|
|
7
|
+
msadsCampaignApiBaseUrl: string;
|
|
8
|
+
msadsReportingApiBaseUrl: string;
|
|
9
|
+
msadsCustomerApiBaseUrl: string;
|
|
10
|
+
msadsRateLimitPerMinute: number;
|
|
11
|
+
msadsReportPollIntervalMs: number;
|
|
12
|
+
msadsReportMaxPollAttempts: number;
|
|
13
|
+
host: string;
|
|
14
|
+
nodeEnv: "development" | "production" | "test";
|
|
15
|
+
mcpStatefulSessionTimeoutMs: number;
|
|
16
|
+
logLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
17
|
+
mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
18
|
+
otelEnabled: boolean;
|
|
19
|
+
msadsAccessToken?: string | undefined;
|
|
20
|
+
msadsDeveloperToken?: string | undefined;
|
|
21
|
+
msadsCustomerId?: string | undefined;
|
|
22
|
+
msadsAccountId?: string | undefined;
|
|
23
|
+
mcpAuthSecretKey?: string | undefined;
|
|
24
|
+
mcpAllowedOrigins?: string | undefined;
|
|
25
|
+
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
26
|
+
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
27
|
+
gcsBucketName?: string | undefined;
|
|
28
|
+
}, logger: Logger) => ReturnType<typeof import("@cesteral/shared").createMcpHttpTransport>, startHttpServer: (config: {
|
|
29
|
+
serviceName: string;
|
|
30
|
+
port: number;
|
|
31
|
+
otelServiceName: string;
|
|
32
|
+
mcpAuthMode: "msads-bearer" | "jwt" | "none";
|
|
33
|
+
msadsCampaignApiBaseUrl: string;
|
|
34
|
+
msadsReportingApiBaseUrl: string;
|
|
35
|
+
msadsCustomerApiBaseUrl: string;
|
|
36
|
+
msadsRateLimitPerMinute: number;
|
|
37
|
+
msadsReportPollIntervalMs: number;
|
|
38
|
+
msadsReportMaxPollAttempts: number;
|
|
39
|
+
host: string;
|
|
40
|
+
nodeEnv: "development" | "production" | "test";
|
|
41
|
+
mcpStatefulSessionTimeoutMs: number;
|
|
42
|
+
logLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
43
|
+
mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
|
|
44
|
+
otelEnabled: boolean;
|
|
45
|
+
msadsAccessToken?: string | undefined;
|
|
46
|
+
msadsDeveloperToken?: string | undefined;
|
|
47
|
+
msadsCustomerId?: string | undefined;
|
|
48
|
+
msadsAccountId?: string | undefined;
|
|
49
|
+
mcpAuthSecretKey?: string | undefined;
|
|
50
|
+
mcpAllowedOrigins?: string | undefined;
|
|
51
|
+
otelExporterOtlpTracesEndpoint?: string | undefined;
|
|
52
|
+
otelExporterOtlpMetricsEndpoint?: string | undefined;
|
|
53
|
+
gcsBucketName?: string | undefined;
|
|
54
|
+
}, logger: Logger) => Promise<import("@cesteral/shared").McpHttpServer>;
|
|
55
|
+
//# sourceMappingURL=streamable-http-transport.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"streamable-http-transport.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAuHnC,eAAO,MAAQ,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;4FAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;uEACS,CAAC"}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { createMcpServer } from "../server.js";
|
|
2
|
+
import { createAuthStrategy, buildServerCardExtras, createTransportEntrypoints, } from "@cesteral/shared";
|
|
3
|
+
import { MsAdsBearerAuthStrategy } from "../../auth/msads-auth-strategy.js";
|
|
4
|
+
import { createSessionServices, sessionServiceStore } from "../../services/session-services.js";
|
|
5
|
+
import { rateLimiter } from "../../utils/platform.js";
|
|
6
|
+
function buildPlatformConfig(config, logger) {
|
|
7
|
+
return {
|
|
8
|
+
authStrategy: config.mcpAuthMode === "msads-bearer"
|
|
9
|
+
? new MsAdsBearerAuthStrategy(config.msadsCustomerApiBaseUrl)
|
|
10
|
+
: createAuthStrategy(config.mcpAuthMode, {
|
|
11
|
+
jwtSecret: config.mcpAuthSecretKey,
|
|
12
|
+
logger,
|
|
13
|
+
}),
|
|
14
|
+
corsAllowHeaders: [
|
|
15
|
+
"Content-Type",
|
|
16
|
+
"Authorization",
|
|
17
|
+
"Mcp-Session-Id",
|
|
18
|
+
"MCP-Protocol-Version",
|
|
19
|
+
"X-MSAds-Developer-Token",
|
|
20
|
+
"X-MSAds-Customer-Id",
|
|
21
|
+
"X-MSAds-Account-Id",
|
|
22
|
+
],
|
|
23
|
+
authErrorHint: config.mcpAuthMode === "msads-bearer"
|
|
24
|
+
? "Provide an OAuth2 access token via Authorization: Bearer <token> header, plus X-MSAds-Developer-Token, X-MSAds-Customer-Id, and X-MSAds-Account-Id headers."
|
|
25
|
+
: "Provide a valid Bearer token in the Authorization header.",
|
|
26
|
+
sessionServiceStore,
|
|
27
|
+
rateLimiter,
|
|
28
|
+
async createSessionForAuth(authResult, sessionId, appConfig, log) {
|
|
29
|
+
const adapter = authResult.platformAuthAdapter;
|
|
30
|
+
if (adapter) {
|
|
31
|
+
const cfg = appConfig;
|
|
32
|
+
const services = createSessionServices(adapter, {
|
|
33
|
+
campaignApiBaseUrl: cfg.msadsCampaignApiBaseUrl,
|
|
34
|
+
reportingApiBaseUrl: cfg.msadsReportingApiBaseUrl,
|
|
35
|
+
customerApiBaseUrl: cfg.msadsCustomerApiBaseUrl,
|
|
36
|
+
reportPollIntervalMs: cfg.msadsReportPollIntervalMs,
|
|
37
|
+
reportMaxPollAttempts: cfg.msadsReportMaxPollAttempts,
|
|
38
|
+
}, log, rateLimiter);
|
|
39
|
+
sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
|
|
40
|
+
return { services };
|
|
41
|
+
}
|
|
42
|
+
if (appConfig.mcpAuthMode === "none" || appConfig.mcpAuthMode === "jwt") {
|
|
43
|
+
const cfg = appConfig;
|
|
44
|
+
const { msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId } = cfg;
|
|
45
|
+
if (msadsAccessToken && msadsDeveloperToken && msadsCustomerId && msadsAccountId) {
|
|
46
|
+
const { MsAdsAccessTokenAdapter } = await import("../../auth/msads-auth-adapter.js");
|
|
47
|
+
const envAdapter = new MsAdsAccessTokenAdapter(msadsAccessToken, msadsDeveloperToken, msadsCustomerId, msadsAccountId, cfg.msadsCustomerApiBaseUrl);
|
|
48
|
+
await envAdapter.validate();
|
|
49
|
+
const services = createSessionServices(envAdapter, {
|
|
50
|
+
campaignApiBaseUrl: cfg.msadsCampaignApiBaseUrl,
|
|
51
|
+
reportingApiBaseUrl: cfg.msadsReportingApiBaseUrl,
|
|
52
|
+
customerApiBaseUrl: cfg.msadsCustomerApiBaseUrl,
|
|
53
|
+
reportPollIntervalMs: cfg.msadsReportPollIntervalMs,
|
|
54
|
+
reportMaxPollAttempts: cfg.msadsReportMaxPollAttempts,
|
|
55
|
+
}, log, rateLimiter);
|
|
56
|
+
sessionServiceStore.set(sessionId, services, authResult.credentialFingerprint);
|
|
57
|
+
return { services };
|
|
58
|
+
}
|
|
59
|
+
if (appConfig.mcpAuthMode !== "none") {
|
|
60
|
+
return {
|
|
61
|
+
services: null,
|
|
62
|
+
error: {
|
|
63
|
+
message: "Microsoft Ads credentials required. Set MSADS_ACCESS_TOKEN, MSADS_DEVELOPER_TOKEN, MSADS_CUSTOMER_ID, and MSADS_ACCOUNT_ID env vars, or use MCP_AUTH_MODE=msads-bearer.",
|
|
64
|
+
status: 400,
|
|
65
|
+
},
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
return { services: null };
|
|
69
|
+
}
|
|
70
|
+
return {
|
|
71
|
+
services: null,
|
|
72
|
+
error: {
|
|
73
|
+
message: "Microsoft Ads API credentials required for this server.",
|
|
74
|
+
status: 400,
|
|
75
|
+
},
|
|
76
|
+
};
|
|
77
|
+
},
|
|
78
|
+
async createMcpServer(log, sessionId, gcsBucket) {
|
|
79
|
+
return createMcpServer(log, sessionId, gcsBucket);
|
|
80
|
+
},
|
|
81
|
+
packageJsonPath: new URL("../../../package.json", import.meta.url).pathname,
|
|
82
|
+
serverCard: buildServerCardExtras("msads-mcp"),
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
export const { createMcpHttpServer, startHttpServer } = createTransportEntrypoints(buildPlatformConfig);
|
|
86
|
+
//# sourceMappingURL=streamable-http-transport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"streamable-http-transport.js","sourceRoot":"","sources":["../../../src/mcp-server/transports/streamable-http-transport.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { MsAdsAuthAdapter } from "../../auth/msads-auth-adapter.js";
|
|
2
|
+
import type { RequestContext } from "@cesteral/shared";
|
|
3
|
+
export declare class MsAdsHttpClient {
|
|
4
|
+
private readonly authAdapter;
|
|
5
|
+
private readonly baseUrl;
|
|
6
|
+
private readonly logger;
|
|
7
|
+
constructor(authAdapter: MsAdsAuthAdapter, baseUrl: string, logger: import("pino").Logger);
|
|
8
|
+
get(path: string, params?: Record<string, string>, context?: RequestContext): Promise<unknown>;
|
|
9
|
+
post(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
|
|
10
|
+
put(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
|
|
11
|
+
delete(path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
|
|
12
|
+
request(method: "GET" | "POST" | "PUT" | "DELETE", path: string, data?: Record<string, unknown> | unknown[], context?: RequestContext): Promise<unknown>;
|
|
13
|
+
private buildUrl;
|
|
14
|
+
private executeRequest;
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=msads-http-client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"msads-http-client.d.ts","sourceRoot":"","sources":["../../../src/services/msads/msads-http-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AA2BpE,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM;IAG1C,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAKb,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAOb,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAOb,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAOb,OAAO,CACX,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC;IAanB,OAAO,CAAC,QAAQ;YAYF,cAAc;CA4B7B"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { fetchWithTimeout, executeWithRetry } from "@cesteral/shared";
|
|
2
|
+
import { withMsAdsApiSpan } from "../../utils/platform.js";
|
|
3
|
+
const MSADS_RETRY_CONFIG = {
|
|
4
|
+
maxRetries: 3,
|
|
5
|
+
initialBackoffMs: 2_000,
|
|
6
|
+
maxBackoffMs: 30_000,
|
|
7
|
+
timeoutMs: 30_000,
|
|
8
|
+
platformName: "Microsoft Ads",
|
|
9
|
+
tokenExpiryHint: "Microsoft Ads token expired. Regenerate via Microsoft identity platform.",
|
|
10
|
+
};
|
|
11
|
+
export class MsAdsHttpClient {
|
|
12
|
+
authAdapter;
|
|
13
|
+
baseUrl;
|
|
14
|
+
logger;
|
|
15
|
+
constructor(authAdapter, baseUrl, logger) {
|
|
16
|
+
this.authAdapter = authAdapter;
|
|
17
|
+
this.baseUrl = baseUrl;
|
|
18
|
+
this.logger = logger;
|
|
19
|
+
}
|
|
20
|
+
async get(path, params, context) {
|
|
21
|
+
const url = this.buildUrl(path, params);
|
|
22
|
+
return this.executeRequest(url, "GET", context);
|
|
23
|
+
}
|
|
24
|
+
async post(path, data, context) {
|
|
25
|
+
const url = this.buildUrl(path);
|
|
26
|
+
return this.executeRequest(url, "POST", context, {
|
|
27
|
+
body: JSON.stringify(data),
|
|
28
|
+
});
|
|
29
|
+
}
|
|
30
|
+
async put(path, data, context) {
|
|
31
|
+
const url = this.buildUrl(path);
|
|
32
|
+
return this.executeRequest(url, "PUT", context, {
|
|
33
|
+
body: JSON.stringify(data),
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
async delete(path, data, context) {
|
|
37
|
+
const url = this.buildUrl(path);
|
|
38
|
+
return this.executeRequest(url, "DELETE", context, {
|
|
39
|
+
body: data !== undefined ? JSON.stringify(data) : undefined,
|
|
40
|
+
});
|
|
41
|
+
}
|
|
42
|
+
async request(method, path, data, context) {
|
|
43
|
+
switch (method) {
|
|
44
|
+
case "GET":
|
|
45
|
+
return this.get(path, undefined, context);
|
|
46
|
+
case "POST":
|
|
47
|
+
return this.post(path, data, context);
|
|
48
|
+
case "PUT":
|
|
49
|
+
return this.put(path, data, context);
|
|
50
|
+
case "DELETE":
|
|
51
|
+
return this.delete(path, data, context);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
buildUrl(path, params) {
|
|
55
|
+
const url = new URL(`${this.baseUrl}${path}`);
|
|
56
|
+
if (params) {
|
|
57
|
+
for (const [key, value] of Object.entries(params)) {
|
|
58
|
+
if (value !== undefined && value !== null) {
|
|
59
|
+
url.searchParams.set(key, value);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
return url.toString();
|
|
64
|
+
}
|
|
65
|
+
async executeRequest(url, method, context, options) {
|
|
66
|
+
return withMsAdsApiSpan(`api.${method}`, undefined, async (span) => {
|
|
67
|
+
span.setAttribute("http.request.method", method);
|
|
68
|
+
span.setAttribute("http.url", url);
|
|
69
|
+
return executeWithRetry(MSADS_RETRY_CONFIG, {
|
|
70
|
+
url,
|
|
71
|
+
fetchOptions: { ...options, method },
|
|
72
|
+
context,
|
|
73
|
+
logger: this.logger,
|
|
74
|
+
fetchFn: fetchWithTimeout,
|
|
75
|
+
getHeaders: async () => {
|
|
76
|
+
const accessToken = await this.authAdapter.getAccessToken();
|
|
77
|
+
return {
|
|
78
|
+
Authorization: `Bearer ${accessToken}`,
|
|
79
|
+
DeveloperToken: this.authAdapter.developerToken,
|
|
80
|
+
CustomerId: this.authAdapter.customerId,
|
|
81
|
+
CustomerAccountId: this.authAdapter.accountId,
|
|
82
|
+
"Content-Type": "application/json",
|
|
83
|
+
};
|
|
84
|
+
},
|
|
85
|
+
});
|
|
86
|
+
});
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=msads-http-client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"msads-http-client.js","sourceRoot":"","sources":["../../../src/services/msads/msads-http-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { Logger } from "pino";
|
|
2
|
+
import type { RateLimiter } from "@cesteral/shared";
|
|
3
|
+
import type { MsAdsHttpClient } from "./msads-http-client.js";
|
|
4
|
+
import { type RequestContext } from "@cesteral/shared";
|
|
5
|
+
export interface ReportConfig {
|
|
6
|
+
reportType: string;
|
|
7
|
+
accountId: string;
|
|
8
|
+
columns: string[];
|
|
9
|
+
dateRange: {
|
|
10
|
+
startDate: string;
|
|
11
|
+
endDate: string;
|
|
12
|
+
};
|
|
13
|
+
aggregation?: string;
|
|
14
|
+
filters?: Record<string, unknown>[];
|
|
15
|
+
}
|
|
16
|
+
export declare class MsAdsReportingService {
|
|
17
|
+
private readonly rateLimiter;
|
|
18
|
+
private readonly httpClient;
|
|
19
|
+
private readonly logger;
|
|
20
|
+
private readonly maxPollAttempts;
|
|
21
|
+
private readonly pollIntervalMs;
|
|
22
|
+
constructor(rateLimiter: RateLimiter, httpClient: MsAdsHttpClient, logger: Logger, maxPollAttempts?: number, pollIntervalMs?: number);
|
|
23
|
+
submitReport(config: ReportConfig, context?: RequestContext): Promise<string>;
|
|
24
|
+
pollReport(reportRequestId: string, context?: RequestContext): Promise<string>;
|
|
25
|
+
checkReportStatus(reportRequestId: string, context?: RequestContext): Promise<{
|
|
26
|
+
status: string;
|
|
27
|
+
downloadUrl?: string;
|
|
28
|
+
}>;
|
|
29
|
+
downloadReport(downloadUrl: string, maxRows?: number, context?: RequestContext, options?: {
|
|
30
|
+
includeRawCsv?: boolean;
|
|
31
|
+
}): Promise<{
|
|
32
|
+
headers: string[];
|
|
33
|
+
rows: string[][];
|
|
34
|
+
totalRows: number;
|
|
35
|
+
rawCsv?: string;
|
|
36
|
+
}>;
|
|
37
|
+
getReport(config: ReportConfig, maxRows?: number, context?: RequestContext): Promise<{
|
|
38
|
+
headers: string[];
|
|
39
|
+
rows: string[][];
|
|
40
|
+
totalRows: number;
|
|
41
|
+
reportRequestId: string;
|
|
42
|
+
}>;
|
|
43
|
+
createReportSchedule(config: ReportConfig & {
|
|
44
|
+
scheduleName: string;
|
|
45
|
+
schedule: Record<string, unknown>;
|
|
46
|
+
}, context?: RequestContext): Promise<{
|
|
47
|
+
scheduleId: string;
|
|
48
|
+
scheduleName: string;
|
|
49
|
+
}>;
|
|
50
|
+
listReportSchedules(context?: RequestContext): Promise<{
|
|
51
|
+
note: string;
|
|
52
|
+
}>;
|
|
53
|
+
deleteReportSchedule(scheduleId: string, context?: RequestContext): Promise<void>;
|
|
54
|
+
private buildReportRequest;
|
|
55
|
+
private parseDate;
|
|
56
|
+
private parseCsv;
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=msads-reporting-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"msads-reporting-service.d.ts","sourceRoot":"","sources":["../../../src/services/msads/msads-reporting-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
import { fetchWithTimeout, McpError, JsonRpcErrorCode, parseCSV, pollUntilComplete, ReportFailedError, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, } from "@cesteral/shared";
|
|
2
|
+
import { MSADS_READ_KEY, MSADS_WRITE_KEY } from "./rate-limit-keys.js";
|
|
3
|
+
const POLL_BASE_MS = 3_000;
|
|
4
|
+
const POLL_MAX_MS = 30_000;
|
|
5
|
+
const DEFAULT_MAX_POLL_ATTEMPTS = 60;
|
|
6
|
+
export class MsAdsReportingService {
|
|
7
|
+
rateLimiter;
|
|
8
|
+
httpClient;
|
|
9
|
+
logger;
|
|
10
|
+
maxPollAttempts;
|
|
11
|
+
pollIntervalMs;
|
|
12
|
+
constructor(rateLimiter, httpClient, logger, maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS, pollIntervalMs = POLL_BASE_MS) {
|
|
13
|
+
this.rateLimiter = rateLimiter;
|
|
14
|
+
this.httpClient = httpClient;
|
|
15
|
+
this.logger = logger;
|
|
16
|
+
this.maxPollAttempts = maxPollAttempts;
|
|
17
|
+
this.pollIntervalMs = pollIntervalMs;
|
|
18
|
+
}
|
|
19
|
+
async submitReport(config, context) {
|
|
20
|
+
await this.rateLimiter.consume(MSADS_WRITE_KEY, 3);
|
|
21
|
+
const body = this.buildReportRequest(config);
|
|
22
|
+
this.logger.info({ reportType: config.reportType }, "Submitting report");
|
|
23
|
+
const response = (await this.httpClient.post("/GenerateReport/Submit", body, context));
|
|
24
|
+
return response.ReportRequestId;
|
|
25
|
+
}
|
|
26
|
+
async pollReport(reportRequestId, context) {
|
|
27
|
+
this.logger.debug({ reportRequestId }, "Starting report poll");
|
|
28
|
+
try {
|
|
29
|
+
const status = await pollUntilComplete({
|
|
30
|
+
fetchStatus: async () => this.checkReportStatus(reportRequestId, context),
|
|
31
|
+
isComplete: (s) => s.status === "Success" && !!s.downloadUrl,
|
|
32
|
+
isFailed: (s) => s.status === "Error",
|
|
33
|
+
initialDelayMs: this.pollIntervalMs,
|
|
34
|
+
maxDelayMs: POLL_MAX_MS,
|
|
35
|
+
maxAttempts: this.maxPollAttempts,
|
|
36
|
+
});
|
|
37
|
+
this.logger.info({ reportRequestId }, "Report ready");
|
|
38
|
+
return status.downloadUrl;
|
|
39
|
+
}
|
|
40
|
+
catch (err) {
|
|
41
|
+
if (err instanceof ReportFailedError) {
|
|
42
|
+
throw new McpError(JsonRpcErrorCode.InternalError, `Microsoft Ads report failed: reportRequestId=${reportRequestId}`);
|
|
43
|
+
}
|
|
44
|
+
throw err;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
async checkReportStatus(reportRequestId, context) {
|
|
48
|
+
await this.rateLimiter.consume(MSADS_READ_KEY);
|
|
49
|
+
const response = (await this.httpClient.post("/GenerateReport/Poll", { ReportRequestId: reportRequestId }, context));
|
|
50
|
+
return {
|
|
51
|
+
status: response.ReportRequestStatus.Status,
|
|
52
|
+
downloadUrl: response.ReportRequestStatus.ReportDownloadUrl,
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
async downloadReport(downloadUrl, maxRows, context, options = {}) {
|
|
56
|
+
this.logger.info({ downloadUrl: downloadUrl.substring(0, 80) }, "Downloading report");
|
|
57
|
+
const response = await fetchWithTimeout(downloadUrl, DEFAULT_REPORT_DOWNLOAD_TIMEOUT_MS, context);
|
|
58
|
+
if (!response.ok) {
|
|
59
|
+
throw new McpError(JsonRpcErrorCode.ServiceUnavailable, `Failed to download report: ${response.status} ${response.statusText}`);
|
|
60
|
+
}
|
|
61
|
+
const text = await response.text();
|
|
62
|
+
const parsed = this.parseCsv(text, maxRows);
|
|
63
|
+
return options.includeRawCsv ? { ...parsed, rawCsv: text } : parsed;
|
|
64
|
+
}
|
|
65
|
+
async getReport(config, maxRows, context) {
|
|
66
|
+
const reportRequestId = await this.submitReport(config, context);
|
|
67
|
+
const downloadUrl = await this.pollReport(reportRequestId, context);
|
|
68
|
+
const data = await this.downloadReport(downloadUrl, maxRows, context);
|
|
69
|
+
return { ...data, reportRequestId };
|
|
70
|
+
}
|
|
71
|
+
async createReportSchedule(config, context) {
|
|
72
|
+
await this.rateLimiter.consume(MSADS_WRITE_KEY, 3);
|
|
73
|
+
const baseRequest = this.buildReportRequest(config).ReportRequest;
|
|
74
|
+
const body = {
|
|
75
|
+
ReportRequest: {
|
|
76
|
+
...baseRequest,
|
|
77
|
+
ReportName: config.scheduleName,
|
|
78
|
+
Schedule: config.schedule,
|
|
79
|
+
},
|
|
80
|
+
};
|
|
81
|
+
this.logger.info({ scheduleName: config.scheduleName }, "Creating MS Ads report schedule");
|
|
82
|
+
const response = (await this.httpClient.post("/GenerateReport/Submit", body, context));
|
|
83
|
+
this.logger.info({ scheduleId: response.ReportRequestId, scheduleName: config.scheduleName }, "MS Ads report schedule created");
|
|
84
|
+
return { scheduleId: response.ReportRequestId, scheduleName: config.scheduleName };
|
|
85
|
+
}
|
|
86
|
+
async listReportSchedules(context) {
|
|
87
|
+
void context;
|
|
88
|
+
return {
|
|
89
|
+
note: "Microsoft Advertising does not provide an API to list all report schedules. Use the Microsoft Advertising UI (app.ads.microsoft.com) to view existing scheduled reports, or track scheduleIds returned by msads_create_report_schedule.",
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
async deleteReportSchedule(scheduleId, context) {
|
|
93
|
+
void context;
|
|
94
|
+
this.logger.info({ scheduleId }, "MS Ads report schedule deletion requested — cancel via Microsoft Advertising UI");
|
|
95
|
+
}
|
|
96
|
+
buildReportRequest(config) {
|
|
97
|
+
const request = {
|
|
98
|
+
ReportName: `${config.reportType}_${Date.now()}`,
|
|
99
|
+
Format: "Csv",
|
|
100
|
+
ReturnOnlyCompleteData: false,
|
|
101
|
+
Aggregation: config.aggregation ?? "Daily",
|
|
102
|
+
Columns: config.columns,
|
|
103
|
+
Scope: {
|
|
104
|
+
AccountIds: [Number(config.accountId)],
|
|
105
|
+
},
|
|
106
|
+
Time: {
|
|
107
|
+
CustomDateRangeStart: this.parseDate(config.dateRange.startDate),
|
|
108
|
+
CustomDateRangeEnd: this.parseDate(config.dateRange.endDate),
|
|
109
|
+
},
|
|
110
|
+
};
|
|
111
|
+
if (config.filters && config.filters.length > 0) {
|
|
112
|
+
request.Filter = config.filters;
|
|
113
|
+
}
|
|
114
|
+
return {
|
|
115
|
+
ReportRequest: {
|
|
116
|
+
Type: config.reportType,
|
|
117
|
+
...request,
|
|
118
|
+
},
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
parseDate(dateStr) {
|
|
122
|
+
if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) {
|
|
123
|
+
throw new McpError(JsonRpcErrorCode.InvalidParams, `Invalid date format: "${dateStr}". Expected YYYY-MM-DD.`);
|
|
124
|
+
}
|
|
125
|
+
const [year, month, day] = dateStr.split("-").map(Number);
|
|
126
|
+
return { Year: year, Month: month, Day: day };
|
|
127
|
+
}
|
|
128
|
+
parseCsv(text, maxRows) {
|
|
129
|
+
const stripped = text.replace(/^\uFEFF/, "");
|
|
130
|
+
const filtered = stripped
|
|
131
|
+
.split(/\r?\n/)
|
|
132
|
+
.filter((line) => {
|
|
133
|
+
const trimmed = line.trim();
|
|
134
|
+
if (trimmed.length === 0)
|
|
135
|
+
return false;
|
|
136
|
+
if (trimmed.startsWith("@") || trimmed.startsWith('"@'))
|
|
137
|
+
return false;
|
|
138
|
+
if (trimmed.startsWith("©") || trimmed.startsWith('"©'))
|
|
139
|
+
return false;
|
|
140
|
+
return true;
|
|
141
|
+
})
|
|
142
|
+
.join("\n");
|
|
143
|
+
if (filtered === "") {
|
|
144
|
+
return { headers: [], rows: [], totalRows: 0 };
|
|
145
|
+
}
|
|
146
|
+
const { headers, rows: recordRows } = parseCSV(filtered);
|
|
147
|
+
const rows = recordRows.map((record) => headers.map((h) => record[h] ?? ""));
|
|
148
|
+
const totalRows = rows.length;
|
|
149
|
+
const limitedRows = maxRows ? rows.slice(0, maxRows) : rows;
|
|
150
|
+
return { headers, rows: limitedRows, totalRows };
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
//# sourceMappingURL=msads-reporting-service.js.map
|