@jaypie/mcp 0.4.1 → 0.6.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 (73) hide show
  1. package/README.md +3 -2
  2. package/dist/createMcpServer.js +34 -0
  3. package/dist/createMcpServer.js.map +1 -0
  4. package/dist/index.js +3 -92
  5. package/dist/index.js.map +1 -1
  6. package/dist/mcpExpressHandler.js +56 -0
  7. package/dist/mcpExpressHandler.js.map +1 -0
  8. package/dist/suite.d.ts +12 -0
  9. package/dist/suite.js +23 -2426
  10. package/dist/suite.js.map +1 -1
  11. package/dist/suites/aws/aws.js +328 -0
  12. package/dist/suites/aws/aws.js.map +1 -0
  13. package/dist/suites/aws/help.md +42 -0
  14. package/dist/suites/aws/index.d.ts +102 -0
  15. package/dist/suites/aws/index.js +258 -0
  16. package/dist/suites/aws/index.js.map +1 -0
  17. package/dist/suites/datadog/datadog.js +828 -0
  18. package/dist/suites/datadog/datadog.js.map +1 -0
  19. package/dist/suites/datadog/help.md +39 -0
  20. package/dist/suites/datadog/index.d.ts +24 -0
  21. package/dist/suites/datadog/index.js +156 -0
  22. package/dist/suites/datadog/index.js.map +1 -0
  23. package/dist/suites/docs/index.d.ts +14 -0
  24. package/dist/suites/docs/index.js +246 -0
  25. package/dist/suites/docs/index.js.map +1 -0
  26. package/dist/suites/docs/release-notes/help.md +37 -0
  27. package/dist/suites/llm/help.md +39 -0
  28. package/dist/suites/llm/index.d.ts +11 -0
  29. package/dist/suites/llm/index.js +61 -0
  30. package/dist/suites/llm/index.js.map +1 -0
  31. package/dist/{llm.d.ts → suites/llm/llm.d.ts} +0 -11
  32. package/dist/suites/llm/llm.js +61 -0
  33. package/dist/suites/llm/llm.js.map +1 -0
  34. package/package.json +4 -3
  35. package/release-notes/aws/1.2.5.md +18 -0
  36. package/release-notes/constructs/1.2.19.md +35 -0
  37. package/release-notes/dynamodb/0.4.0.md +44 -0
  38. package/release-notes/express/1.2.5.md +33 -0
  39. package/release-notes/fabric/0.2.0.md +77 -0
  40. package/release-notes/fabric/0.2.1.md +36 -0
  41. package/release-notes/jaypie/1.2.4.md +11 -0
  42. package/release-notes/jaypie/1.2.5.md +9 -0
  43. package/release-notes/lambda/1.2.4.md +39 -0
  44. package/release-notes/llm/1.2.7.md +12 -0
  45. package/release-notes/mcp/0.5.0.md +70 -0
  46. package/release-notes/mcp/0.5.1.md +23 -0
  47. package/release-notes/mcp/0.6.0.md +19 -0
  48. package/release-notes/testkit/1.2.17.md +30 -0
  49. package/release-notes/testkit/1.2.18.md +16 -0
  50. package/skills/agents.md +2 -2
  51. package/skills/cdk.md +5 -1
  52. package/skills/contents.md +24 -0
  53. package/skills/development.md +19 -0
  54. package/skills/documentation.md +19 -145
  55. package/skills/express.md +158 -0
  56. package/skills/fabric.md +7 -4
  57. package/skills/handlers.md +172 -0
  58. package/skills/infrastructure.md +22 -0
  59. package/skills/lambda.md +164 -0
  60. package/skills/llm.md +4 -1
  61. package/skills/meta.md +17 -0
  62. package/skills/patterns.md +19 -0
  63. package/skills/skills.md +11 -12
  64. package/skills/streaming.md +120 -0
  65. package/skills/style.md +1 -24
  66. package/skills/tools-aws.md +65 -47
  67. package/skills/tools-datadog.md +53 -44
  68. package/skills/tools-dynamodb.md +72 -44
  69. package/skills/tools.md +55 -42
  70. package/skills/vocabulary.md +143 -8
  71. package/skills/websockets.md +203 -0
  72. /package/dist/{aws.d.ts → suites/aws/aws.d.ts} +0 -0
  73. /package/dist/{datadog.d.ts → suites/datadog/datadog.d.ts} +0 -0
@@ -0,0 +1,828 @@
1
+ import * as https from 'node:https';
2
+
3
+ /**
4
+ * Datadog API integration module
5
+ */
6
+ const nullLogger = {
7
+ info: () => { },
8
+ error: () => { },
9
+ };
10
+ /**
11
+ * Get Datadog credentials from environment variables
12
+ */
13
+ function getDatadogCredentials() {
14
+ const apiKey = process.env.DATADOG_API_KEY || process.env.DD_API_KEY;
15
+ const appKey = process.env.DATADOG_APP_KEY ||
16
+ process.env.DATADOG_APPLICATION_KEY ||
17
+ process.env.DD_APP_KEY ||
18
+ process.env.DD_APPLICATION_KEY;
19
+ if (!apiKey || !appKey) {
20
+ return null;
21
+ }
22
+ return { apiKey, appKey };
23
+ }
24
+ /**
25
+ * Validate Datadog API credentials
26
+ */
27
+ async function validateDatadogCredentials(credentials) {
28
+ return new Promise((resolve) => {
29
+ const options = {
30
+ hostname: "api.datadoghq.com",
31
+ port: 443,
32
+ path: "/api/v1/validate",
33
+ method: "GET",
34
+ headers: {
35
+ "DD-API-KEY": credentials.apiKey,
36
+ "DD-APPLICATION-KEY": credentials.appKey,
37
+ },
38
+ };
39
+ const req = https.request(options, (res) => {
40
+ let data = "";
41
+ res.on("data", (chunk) => {
42
+ data += chunk.toString();
43
+ });
44
+ res.on("end", () => {
45
+ if (res.statusCode === 200) {
46
+ resolve({ valid: true });
47
+ }
48
+ else {
49
+ resolve({
50
+ valid: false,
51
+ error: `Datadog API returned status ${res.statusCode}: ${data}`,
52
+ });
53
+ }
54
+ });
55
+ });
56
+ req.on("error", (error) => {
57
+ resolve({ valid: false, error: error.message });
58
+ });
59
+ req.end();
60
+ });
61
+ }
62
+ /**
63
+ * Build query string from environment variables and options
64
+ */
65
+ function buildDatadogQuery(options) {
66
+ const ddEnv = process.env.DD_ENV;
67
+ const ddService = process.env.DD_SERVICE;
68
+ const ddSource = process.env.DD_SOURCE;
69
+ const ddQuery = process.env.DD_QUERY;
70
+ const queryParts = [];
71
+ // Add source (parameter > env var > default 'lambda')
72
+ const effectiveSource = options.source || ddSource || "lambda";
73
+ queryParts.push(`source:${effectiveSource}`);
74
+ // Add env (parameter > env var)
75
+ const effectiveEnv = options.env || ddEnv;
76
+ if (effectiveEnv) {
77
+ queryParts.push(`env:${effectiveEnv}`);
78
+ }
79
+ // Add service (parameter > env var)
80
+ const effectiveService = options.service || ddService;
81
+ if (effectiveService) {
82
+ queryParts.push(`service:${effectiveService}`);
83
+ }
84
+ // Add base query from DD_QUERY if available
85
+ if (ddQuery) {
86
+ queryParts.push(ddQuery);
87
+ }
88
+ // Add user-provided query terms
89
+ if (options.query) {
90
+ queryParts.push(options.query);
91
+ }
92
+ return queryParts.join(" ");
93
+ }
94
+ /**
95
+ * Search Datadog logs
96
+ */
97
+ async function searchDatadogLogs(credentials, options = {}, logger = nullLogger) {
98
+ const effectiveQuery = buildDatadogQuery(options);
99
+ const effectiveFrom = options.from || "now-15m";
100
+ const effectiveTo = options.to || "now";
101
+ const effectiveLimit = Math.min(options.limit || 50, 1000);
102
+ const effectiveSort = options.sort || "-timestamp";
103
+ logger.info(`Effective query: ${effectiveQuery}`);
104
+ logger.info(`Search params: from=${effectiveFrom}, to=${effectiveTo}, limit=${effectiveLimit}, sort=${effectiveSort}`);
105
+ const requestBody = JSON.stringify({
106
+ filter: {
107
+ query: effectiveQuery,
108
+ from: effectiveFrom,
109
+ to: effectiveTo,
110
+ },
111
+ page: {
112
+ limit: effectiveLimit,
113
+ },
114
+ sort: effectiveSort,
115
+ });
116
+ return new Promise((resolve) => {
117
+ const requestOptions = {
118
+ hostname: "api.datadoghq.com",
119
+ port: 443,
120
+ path: "/api/v2/logs/events/search",
121
+ method: "POST",
122
+ headers: {
123
+ "Content-Type": "application/json",
124
+ "DD-API-KEY": credentials.apiKey,
125
+ "DD-APPLICATION-KEY": credentials.appKey,
126
+ "Content-Length": Buffer.byteLength(requestBody),
127
+ },
128
+ };
129
+ const req = https.request(requestOptions, (res) => {
130
+ let data = "";
131
+ res.on("data", (chunk) => {
132
+ data += chunk.toString();
133
+ });
134
+ res.on("end", () => {
135
+ logger.info(`Response status: ${res.statusCode}`);
136
+ if (res.statusCode !== 200) {
137
+ logger.error(`Datadog API error: ${res.statusCode}`);
138
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
139
+ if (res.statusCode === 400) {
140
+ errorMessage = `Invalid query syntax. Check your query: "${effectiveQuery}". Datadog error: ${data}`;
141
+ }
142
+ else if (res.statusCode === 403) {
143
+ errorMessage =
144
+ "Access denied. Verify your API and Application keys have logs_read permission.";
145
+ }
146
+ else if (res.statusCode === 429) {
147
+ errorMessage =
148
+ "Rate limited by Datadog. Wait a moment and try again, or reduce your query scope.";
149
+ }
150
+ resolve({
151
+ success: false,
152
+ query: effectiveQuery,
153
+ timeRange: { from: effectiveFrom, to: effectiveTo },
154
+ logs: [],
155
+ error: errorMessage,
156
+ });
157
+ return;
158
+ }
159
+ try {
160
+ const response = JSON.parse(data);
161
+ const logs = (response.data || []).map((log) => {
162
+ const attrs = log.attributes || {};
163
+ return {
164
+ id: log.id,
165
+ timestamp: attrs.timestamp,
166
+ status: attrs.status,
167
+ service: attrs.service,
168
+ message: attrs.message,
169
+ attributes: attrs.attributes,
170
+ };
171
+ });
172
+ logger.info(`Retrieved ${logs.length} log entries`);
173
+ resolve({
174
+ success: true,
175
+ query: effectiveQuery,
176
+ timeRange: { from: effectiveFrom, to: effectiveTo },
177
+ logs,
178
+ });
179
+ }
180
+ catch (parseError) {
181
+ logger.error("Failed to parse Datadog response:", parseError);
182
+ resolve({
183
+ success: false,
184
+ query: effectiveQuery,
185
+ timeRange: { from: effectiveFrom, to: effectiveTo },
186
+ logs: [],
187
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
188
+ });
189
+ }
190
+ });
191
+ });
192
+ req.on("error", (error) => {
193
+ logger.error("Request error:", error);
194
+ resolve({
195
+ success: false,
196
+ query: effectiveQuery,
197
+ timeRange: { from: effectiveFrom, to: effectiveTo },
198
+ logs: [],
199
+ error: `Connection error: ${error.message}`,
200
+ });
201
+ });
202
+ req.write(requestBody);
203
+ req.end();
204
+ });
205
+ }
206
+ /**
207
+ * Aggregate Datadog logs using the Analytics API
208
+ * Groups logs by specified fields and computes aggregations
209
+ */
210
+ async function aggregateDatadogLogs(credentials, options, logger = nullLogger) {
211
+ const effectiveQuery = buildDatadogQuery(options);
212
+ const effectiveFrom = options.from || "now-15m";
213
+ const effectiveTo = options.to || "now";
214
+ const groupBy = options.groupBy;
215
+ const compute = options.compute || [{ aggregation: "count" }];
216
+ logger.info(`Analytics query: ${effectiveQuery}`);
217
+ logger.info(`Group by: ${groupBy.join(", ")}`);
218
+ logger.info(`Time range: ${effectiveFrom} to ${effectiveTo}`);
219
+ // Build compute array - each item needs aggregation and type
220
+ const computeItems = compute.map((c) => {
221
+ const item = {
222
+ aggregation: c.aggregation,
223
+ type: "total",
224
+ };
225
+ if (c.metric) {
226
+ item.metric = c.metric;
227
+ }
228
+ return item;
229
+ });
230
+ // Build group_by with proper sort configuration
231
+ const groupByItems = groupBy.map((field) => {
232
+ const item = {
233
+ facet: field,
234
+ limit: 100,
235
+ sort: {
236
+ type: "measure",
237
+ order: "desc",
238
+ aggregation: compute[0]?.aggregation || "count",
239
+ },
240
+ };
241
+ return item;
242
+ });
243
+ const requestBody = JSON.stringify({
244
+ filter: {
245
+ query: effectiveQuery,
246
+ from: effectiveFrom,
247
+ to: effectiveTo,
248
+ },
249
+ group_by: groupByItems,
250
+ compute: computeItems,
251
+ page: {
252
+ limit: 100,
253
+ },
254
+ });
255
+ return new Promise((resolve) => {
256
+ const requestOptions = {
257
+ hostname: "api.datadoghq.com",
258
+ port: 443,
259
+ path: "/api/v2/logs/analytics/aggregate",
260
+ method: "POST",
261
+ headers: {
262
+ "Content-Type": "application/json",
263
+ "DD-API-KEY": credentials.apiKey,
264
+ "DD-APPLICATION-KEY": credentials.appKey,
265
+ "Content-Length": Buffer.byteLength(requestBody),
266
+ },
267
+ };
268
+ const req = https.request(requestOptions, (res) => {
269
+ let data = "";
270
+ res.on("data", (chunk) => {
271
+ data += chunk.toString();
272
+ });
273
+ res.on("end", () => {
274
+ logger.info(`Response status: ${res.statusCode}`);
275
+ if (res.statusCode !== 200) {
276
+ logger.error(`Datadog Analytics API error: ${res.statusCode}`);
277
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
278
+ if (res.statusCode === 400) {
279
+ errorMessage = `Invalid query or groupBy fields. Verify facet names exist: ${groupBy.join(", ")}. Datadog error: ${data}`;
280
+ }
281
+ else if (res.statusCode === 403) {
282
+ errorMessage =
283
+ "Access denied. Verify your API and Application keys have logs_read permission.";
284
+ }
285
+ else if (res.statusCode === 429) {
286
+ errorMessage =
287
+ "Rate limited by Datadog. Wait a moment and try again, or reduce your query scope.";
288
+ }
289
+ resolve({
290
+ success: false,
291
+ query: effectiveQuery,
292
+ timeRange: { from: effectiveFrom, to: effectiveTo },
293
+ groupBy,
294
+ buckets: [],
295
+ error: errorMessage,
296
+ });
297
+ return;
298
+ }
299
+ try {
300
+ const response = JSON.parse(data);
301
+ const buckets = (response.data?.buckets || []).map((bucket) => ({
302
+ by: bucket.by || {},
303
+ computes: bucket.computes || {},
304
+ }));
305
+ logger.info(`Retrieved ${buckets.length} aggregation buckets`);
306
+ resolve({
307
+ success: true,
308
+ query: effectiveQuery,
309
+ timeRange: { from: effectiveFrom, to: effectiveTo },
310
+ groupBy,
311
+ buckets,
312
+ });
313
+ }
314
+ catch (parseError) {
315
+ logger.error("Failed to parse Datadog analytics response:", parseError);
316
+ resolve({
317
+ success: false,
318
+ query: effectiveQuery,
319
+ timeRange: { from: effectiveFrom, to: effectiveTo },
320
+ groupBy,
321
+ buckets: [],
322
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
323
+ });
324
+ }
325
+ });
326
+ });
327
+ req.on("error", (error) => {
328
+ logger.error("Request error:", error);
329
+ resolve({
330
+ success: false,
331
+ query: effectiveQuery,
332
+ timeRange: { from: effectiveFrom, to: effectiveTo },
333
+ groupBy,
334
+ buckets: [],
335
+ error: `Connection error: ${error.message}`,
336
+ });
337
+ });
338
+ req.write(requestBody);
339
+ req.end();
340
+ });
341
+ }
342
+ /**
343
+ * List Datadog monitors with optional filtering
344
+ */
345
+ async function listDatadogMonitors(credentials, options = {}, logger = nullLogger) {
346
+ logger.info("Fetching Datadog monitors");
347
+ const queryParams = new URLSearchParams();
348
+ if (options.tags && options.tags.length > 0) {
349
+ queryParams.set("tags", options.tags.join(","));
350
+ }
351
+ if (options.monitorTags && options.monitorTags.length > 0) {
352
+ queryParams.set("monitor_tags", options.monitorTags.join(","));
353
+ }
354
+ if (options.name) {
355
+ queryParams.set("name", options.name);
356
+ }
357
+ const queryString = queryParams.toString();
358
+ const path = `/api/v1/monitor${queryString ? `?${queryString}` : ""}`;
359
+ logger.info(`Request path: ${path}`);
360
+ return new Promise((resolve) => {
361
+ const requestOptions = {
362
+ hostname: "api.datadoghq.com",
363
+ port: 443,
364
+ path,
365
+ method: "GET",
366
+ headers: {
367
+ "DD-API-KEY": credentials.apiKey,
368
+ "DD-APPLICATION-KEY": credentials.appKey,
369
+ },
370
+ };
371
+ const req = https.request(requestOptions, (res) => {
372
+ let data = "";
373
+ res.on("data", (chunk) => {
374
+ data += chunk.toString();
375
+ });
376
+ res.on("end", () => {
377
+ logger.info(`Response status: ${res.statusCode}`);
378
+ if (res.statusCode !== 200) {
379
+ logger.error(`Datadog Monitors API error: ${res.statusCode}`);
380
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
381
+ if (res.statusCode === 403) {
382
+ errorMessage =
383
+ "Access denied. Verify your API and Application keys have monitors_read permission.";
384
+ }
385
+ else if (res.statusCode === 429) {
386
+ errorMessage =
387
+ "Rate limited by Datadog. Wait a moment and try again.";
388
+ }
389
+ resolve({
390
+ success: false,
391
+ monitors: [],
392
+ error: errorMessage,
393
+ });
394
+ return;
395
+ }
396
+ try {
397
+ const response = JSON.parse(data);
398
+ let monitors = response.map((monitor) => ({
399
+ id: monitor.id,
400
+ name: monitor.name,
401
+ type: monitor.type,
402
+ status: monitor.overall_state || "Unknown",
403
+ message: monitor.message,
404
+ tags: monitor.tags || [],
405
+ priority: monitor.priority,
406
+ query: monitor.query,
407
+ overallState: monitor.overall_state,
408
+ }));
409
+ // Filter by status if specified
410
+ if (options.status && options.status.length > 0) {
411
+ monitors = monitors.filter((m) => options.status.includes(m.status));
412
+ }
413
+ logger.info(`Retrieved ${monitors.length} monitors`);
414
+ resolve({
415
+ success: true,
416
+ monitors,
417
+ });
418
+ }
419
+ catch (parseError) {
420
+ logger.error("Failed to parse Datadog monitors response:", parseError);
421
+ resolve({
422
+ success: false,
423
+ monitors: [],
424
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
425
+ });
426
+ }
427
+ });
428
+ });
429
+ req.on("error", (error) => {
430
+ logger.error("Request error:", error);
431
+ resolve({
432
+ success: false,
433
+ monitors: [],
434
+ error: `Connection error: ${error.message}`,
435
+ });
436
+ });
437
+ req.end();
438
+ });
439
+ }
440
+ /**
441
+ * List Datadog Synthetic tests
442
+ */
443
+ async function listDatadogSynthetics(credentials, options = {}, logger = nullLogger) {
444
+ logger.info("Fetching Datadog Synthetic tests");
445
+ return new Promise((resolve) => {
446
+ const requestOptions = {
447
+ hostname: "api.datadoghq.com",
448
+ port: 443,
449
+ path: "/api/v1/synthetics/tests",
450
+ method: "GET",
451
+ headers: {
452
+ "DD-API-KEY": credentials.apiKey,
453
+ "DD-APPLICATION-KEY": credentials.appKey,
454
+ },
455
+ };
456
+ const req = https.request(requestOptions, (res) => {
457
+ let data = "";
458
+ res.on("data", (chunk) => {
459
+ data += chunk.toString();
460
+ });
461
+ res.on("end", () => {
462
+ logger.info(`Response status: ${res.statusCode}`);
463
+ if (res.statusCode !== 200) {
464
+ logger.error(`Datadog Synthetics API error: ${res.statusCode}`);
465
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
466
+ if (res.statusCode === 403) {
467
+ errorMessage =
468
+ "Access denied. Verify your API and Application keys have synthetics_read permission.";
469
+ }
470
+ else if (res.statusCode === 429) {
471
+ errorMessage =
472
+ "Rate limited by Datadog. Wait a moment and try again.";
473
+ }
474
+ resolve({
475
+ success: false,
476
+ tests: [],
477
+ error: errorMessage,
478
+ });
479
+ return;
480
+ }
481
+ try {
482
+ const response = JSON.parse(data);
483
+ let tests = (response.tests || []).map((test) => ({
484
+ publicId: test.public_id,
485
+ name: test.name,
486
+ type: test.type,
487
+ status: test.status,
488
+ tags: test.tags || [],
489
+ locations: test.locations || [],
490
+ message: test.message,
491
+ }));
492
+ // Filter by type if specified
493
+ if (options.type) {
494
+ tests = tests.filter((t) => t.type === options.type);
495
+ }
496
+ // Filter by tags if specified
497
+ if (options.tags && options.tags.length > 0) {
498
+ tests = tests.filter((t) => options.tags.some((tag) => t.tags.includes(tag)));
499
+ }
500
+ logger.info(`Retrieved ${tests.length} synthetic tests`);
501
+ resolve({
502
+ success: true,
503
+ tests,
504
+ });
505
+ }
506
+ catch (parseError) {
507
+ logger.error("Failed to parse Datadog synthetics response:", parseError);
508
+ resolve({
509
+ success: false,
510
+ tests: [],
511
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
512
+ });
513
+ }
514
+ });
515
+ });
516
+ req.on("error", (error) => {
517
+ logger.error("Request error:", error);
518
+ resolve({
519
+ success: false,
520
+ tests: [],
521
+ error: `Connection error: ${error.message}`,
522
+ });
523
+ });
524
+ req.end();
525
+ });
526
+ }
527
+ /**
528
+ * Get recent results for a specific Synthetic test
529
+ */
530
+ async function getDatadogSyntheticResults(credentials, publicId, logger = nullLogger) {
531
+ logger.info(`Fetching results for Synthetic test: ${publicId}`);
532
+ return new Promise((resolve) => {
533
+ const requestOptions = {
534
+ hostname: "api.datadoghq.com",
535
+ port: 443,
536
+ path: `/api/v1/synthetics/tests/${publicId}/results`,
537
+ method: "GET",
538
+ headers: {
539
+ "DD-API-KEY": credentials.apiKey,
540
+ "DD-APPLICATION-KEY": credentials.appKey,
541
+ },
542
+ };
543
+ const req = https.request(requestOptions, (res) => {
544
+ let data = "";
545
+ res.on("data", (chunk) => {
546
+ data += chunk.toString();
547
+ });
548
+ res.on("end", () => {
549
+ logger.info(`Response status: ${res.statusCode}`);
550
+ if (res.statusCode !== 200) {
551
+ logger.error(`Datadog Synthetics Results API error: ${res.statusCode}`);
552
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
553
+ if (res.statusCode === 403) {
554
+ errorMessage =
555
+ "Access denied. Verify your API and Application keys have synthetics_read permission.";
556
+ }
557
+ else if (res.statusCode === 404) {
558
+ errorMessage = `Synthetic test '${publicId}' not found. Use datadog_synthetics (without testId) to list available tests.`;
559
+ }
560
+ else if (res.statusCode === 429) {
561
+ errorMessage =
562
+ "Rate limited by Datadog. Wait a moment and try again.";
563
+ }
564
+ resolve({
565
+ success: false,
566
+ publicId,
567
+ results: [],
568
+ error: errorMessage,
569
+ });
570
+ return;
571
+ }
572
+ try {
573
+ const response = JSON.parse(data);
574
+ const results = (response.results || []).map((result) => ({
575
+ publicId,
576
+ resultId: result.result_id,
577
+ status: result.status,
578
+ checkTime: result.check_time,
579
+ passed: result.result?.passed ?? result.status === 0,
580
+ location: result.dc_id?.toString(),
581
+ }));
582
+ logger.info(`Retrieved ${results.length} synthetic results`);
583
+ resolve({
584
+ success: true,
585
+ publicId,
586
+ results,
587
+ });
588
+ }
589
+ catch (parseError) {
590
+ logger.error("Failed to parse Datadog synthetic results:", parseError);
591
+ resolve({
592
+ success: false,
593
+ publicId,
594
+ results: [],
595
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
596
+ });
597
+ }
598
+ });
599
+ });
600
+ req.on("error", (error) => {
601
+ logger.error("Request error:", error);
602
+ resolve({
603
+ success: false,
604
+ publicId,
605
+ results: [],
606
+ error: `Connection error: ${error.message}`,
607
+ });
608
+ });
609
+ req.end();
610
+ });
611
+ }
612
+ /**
613
+ * Query Datadog metrics
614
+ */
615
+ async function queryDatadogMetrics(credentials, options, logger = nullLogger) {
616
+ logger.info(`Querying metrics: ${options.query}`);
617
+ logger.info(`Time range: ${options.from} to ${options.to}`);
618
+ const queryParams = new URLSearchParams({
619
+ query: options.query,
620
+ from: options.from.toString(),
621
+ to: options.to.toString(),
622
+ });
623
+ return new Promise((resolve) => {
624
+ const requestOptions = {
625
+ hostname: "api.datadoghq.com",
626
+ port: 443,
627
+ path: `/api/v1/query?${queryParams.toString()}`,
628
+ method: "GET",
629
+ headers: {
630
+ "DD-API-KEY": credentials.apiKey,
631
+ "DD-APPLICATION-KEY": credentials.appKey,
632
+ },
633
+ };
634
+ const req = https.request(requestOptions, (res) => {
635
+ let data = "";
636
+ res.on("data", (chunk) => {
637
+ data += chunk.toString();
638
+ });
639
+ res.on("end", () => {
640
+ logger.info(`Response status: ${res.statusCode}`);
641
+ if (res.statusCode !== 200) {
642
+ logger.error(`Datadog Metrics API error: ${res.statusCode}`);
643
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
644
+ if (res.statusCode === 400) {
645
+ errorMessage = `Invalid metric query. Check format: 'aggregation:metric.name{tags}'. Query: "${options.query}". Datadog error: ${data}`;
646
+ }
647
+ else if (res.statusCode === 403) {
648
+ errorMessage =
649
+ "Access denied. Verify your API and Application keys have metrics_read permission.";
650
+ }
651
+ else if (res.statusCode === 429) {
652
+ errorMessage =
653
+ "Rate limited by Datadog. Wait a moment and try again, or reduce your time range.";
654
+ }
655
+ resolve({
656
+ success: false,
657
+ query: options.query,
658
+ timeRange: { from: options.from, to: options.to },
659
+ series: [],
660
+ error: errorMessage,
661
+ });
662
+ return;
663
+ }
664
+ try {
665
+ const response = JSON.parse(data);
666
+ const series = (response.series || []).map((s) => ({
667
+ metric: s.metric,
668
+ scope: s.scope,
669
+ pointlist: s.pointlist,
670
+ unit: s.unit?.[0]?.name,
671
+ }));
672
+ logger.info(`Retrieved ${series.length} metric series`);
673
+ resolve({
674
+ success: true,
675
+ query: options.query,
676
+ timeRange: { from: options.from, to: options.to },
677
+ series,
678
+ });
679
+ }
680
+ catch (parseError) {
681
+ logger.error("Failed to parse Datadog metrics response:", parseError);
682
+ resolve({
683
+ success: false,
684
+ query: options.query,
685
+ timeRange: { from: options.from, to: options.to },
686
+ series: [],
687
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
688
+ });
689
+ }
690
+ });
691
+ });
692
+ req.on("error", (error) => {
693
+ logger.error("Request error:", error);
694
+ resolve({
695
+ success: false,
696
+ query: options.query,
697
+ timeRange: { from: options.from, to: options.to },
698
+ series: [],
699
+ error: `Connection error: ${error.message}`,
700
+ });
701
+ });
702
+ req.end();
703
+ });
704
+ }
705
+ /**
706
+ * Search Datadog RUM events
707
+ */
708
+ async function searchDatadogRum(credentials, options = {}, logger = nullLogger) {
709
+ const effectiveQuery = options.query || "*";
710
+ const effectiveFrom = options.from || "now-15m";
711
+ const effectiveTo = options.to || "now";
712
+ const effectiveLimit = Math.min(options.limit || 50, 1000);
713
+ const effectiveSort = options.sort || "-timestamp";
714
+ logger.info(`RUM query: ${effectiveQuery}`);
715
+ logger.info(`Time range: ${effectiveFrom} to ${effectiveTo}`);
716
+ const requestBody = JSON.stringify({
717
+ filter: {
718
+ query: effectiveQuery,
719
+ from: effectiveFrom,
720
+ to: effectiveTo,
721
+ },
722
+ page: {
723
+ limit: effectiveLimit,
724
+ },
725
+ sort: effectiveSort,
726
+ });
727
+ return new Promise((resolve) => {
728
+ const requestOptions = {
729
+ hostname: "api.datadoghq.com",
730
+ port: 443,
731
+ path: "/api/v2/rum/events/search",
732
+ method: "POST",
733
+ headers: {
734
+ "Content-Type": "application/json",
735
+ "DD-API-KEY": credentials.apiKey,
736
+ "DD-APPLICATION-KEY": credentials.appKey,
737
+ "Content-Length": Buffer.byteLength(requestBody),
738
+ },
739
+ };
740
+ const req = https.request(requestOptions, (res) => {
741
+ let data = "";
742
+ res.on("data", (chunk) => {
743
+ data += chunk.toString();
744
+ });
745
+ res.on("end", () => {
746
+ logger.info(`Response status: ${res.statusCode}`);
747
+ if (res.statusCode !== 200) {
748
+ logger.error(`Datadog RUM API error: ${res.statusCode}`);
749
+ let errorMessage = `Datadog API returned status ${res.statusCode}: ${data}`;
750
+ // Check for specific "No valid indexes" error which means no RUM app is configured
751
+ if (data.includes("No valid indexes")) {
752
+ errorMessage =
753
+ "No RUM application found. Ensure you have a RUM application configured in Datadog and it has collected data. " +
754
+ "You can create a RUM application at https://app.datadoghq.com/rum/list";
755
+ }
756
+ else if (res.statusCode === 400) {
757
+ errorMessage = `Invalid RUM query. Check syntax: "${effectiveQuery}". Datadog error: ${data}`;
758
+ }
759
+ else if (res.statusCode === 403) {
760
+ errorMessage =
761
+ "Access denied. Verify your API and Application keys have rum_read permission.";
762
+ }
763
+ else if (res.statusCode === 429) {
764
+ errorMessage =
765
+ "Rate limited by Datadog. Wait a moment and try again, or reduce your query scope.";
766
+ }
767
+ resolve({
768
+ success: false,
769
+ query: effectiveQuery,
770
+ timeRange: { from: effectiveFrom, to: effectiveTo },
771
+ events: [],
772
+ error: errorMessage,
773
+ });
774
+ return;
775
+ }
776
+ try {
777
+ const response = JSON.parse(data);
778
+ const events = (response.data || []).map((event) => {
779
+ const attrs = event.attributes?.attributes || {};
780
+ return {
781
+ id: event.id,
782
+ type: event.type,
783
+ timestamp: event.attributes?.timestamp,
784
+ sessionId: attrs.session?.id,
785
+ viewUrl: attrs.view?.url,
786
+ viewName: attrs.view?.name,
787
+ errorMessage: attrs.error?.message,
788
+ errorType: attrs.error?.type,
789
+ attributes: attrs,
790
+ };
791
+ });
792
+ logger.info(`Retrieved ${events.length} RUM events`);
793
+ resolve({
794
+ success: true,
795
+ query: effectiveQuery,
796
+ timeRange: { from: effectiveFrom, to: effectiveTo },
797
+ events,
798
+ });
799
+ }
800
+ catch (parseError) {
801
+ logger.error("Failed to parse Datadog RUM response:", parseError);
802
+ resolve({
803
+ success: false,
804
+ query: effectiveQuery,
805
+ timeRange: { from: effectiveFrom, to: effectiveTo },
806
+ events: [],
807
+ error: `Failed to parse response: ${parseError instanceof Error ? parseError.message : "Unknown error"}`,
808
+ });
809
+ }
810
+ });
811
+ });
812
+ req.on("error", (error) => {
813
+ logger.error("Request error:", error);
814
+ resolve({
815
+ success: false,
816
+ query: effectiveQuery,
817
+ timeRange: { from: effectiveFrom, to: effectiveTo },
818
+ events: [],
819
+ error: `Connection error: ${error.message}`,
820
+ });
821
+ });
822
+ req.write(requestBody);
823
+ req.end();
824
+ });
825
+ }
826
+
827
+ export { aggregateDatadogLogs, buildDatadogQuery, getDatadogCredentials, getDatadogSyntheticResults, listDatadogMonitors, listDatadogSynthetics, queryDatadogMetrics, searchDatadogLogs, searchDatadogRum, validateDatadogCredentials };
828
+ //# sourceMappingURL=datadog.js.map