datadog-frontend-toolkit 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 (173) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +486 -0
  3. package/dist/cjs/context/ContextManager.js +197 -0
  4. package/dist/cjs/context/ContextManager.js.map +1 -0
  5. package/dist/cjs/core/BootstrapGuard.js +81 -0
  6. package/dist/cjs/core/BootstrapGuard.js.map +1 -0
  7. package/dist/cjs/core/ConfigManager.js +133 -0
  8. package/dist/cjs/core/ConfigManager.js.map +1 -0
  9. package/dist/cjs/core/ObservabilitySDK.js +355 -0
  10. package/dist/cjs/core/ObservabilitySDK.js.map +1 -0
  11. package/dist/cjs/errors/ErrorBoundary.js +187 -0
  12. package/dist/cjs/errors/ErrorBoundary.js.map +1 -0
  13. package/dist/cjs/index.js +110 -0
  14. package/dist/cjs/index.js.map +1 -0
  15. package/dist/cjs/logger/LoggerService.js +256 -0
  16. package/dist/cjs/logger/LoggerService.js.map +1 -0
  17. package/dist/cjs/logs/LogsManager.js +112 -0
  18. package/dist/cjs/logs/LogsManager.js.map +1 -0
  19. package/dist/cjs/network/NetworkInterceptor.js +185 -0
  20. package/dist/cjs/network/NetworkInterceptor.js.map +1 -0
  21. package/dist/cjs/performance/PerformanceMonitor.js +290 -0
  22. package/dist/cjs/performance/PerformanceMonitor.js.map +1 -0
  23. package/dist/cjs/resources/ResourceProvisioner.js +210 -0
  24. package/dist/cjs/resources/ResourceProvisioner.js.map +1 -0
  25. package/dist/cjs/resources/templates/dashboard.js +333 -0
  26. package/dist/cjs/resources/templates/dashboard.js.map +1 -0
  27. package/dist/cjs/resources/templates/monitors.js +120 -0
  28. package/dist/cjs/resources/templates/monitors.js.map +1 -0
  29. package/dist/cjs/resources/templates/slos.js +79 -0
  30. package/dist/cjs/resources/templates/slos.js.map +1 -0
  31. package/dist/cjs/rum/RumManager.js +164 -0
  32. package/dist/cjs/rum/RumManager.js.map +1 -0
  33. package/dist/cjs/types/config.js +13 -0
  34. package/dist/cjs/types/config.js.map +1 -0
  35. package/dist/cjs/types/events.js +26 -0
  36. package/dist/cjs/types/events.js.map +1 -0
  37. package/dist/cjs/types/index.js +20 -0
  38. package/dist/cjs/types/index.js.map +1 -0
  39. package/dist/cjs/types/logger.js +13 -0
  40. package/dist/cjs/types/logger.js.map +1 -0
  41. package/dist/cjs/utils/EventEmitter.js +49 -0
  42. package/dist/cjs/utils/EventEmitter.js.map +1 -0
  43. package/dist/cjs/utils/fingerprint.js +48 -0
  44. package/dist/cjs/utils/fingerprint.js.map +1 -0
  45. package/dist/cjs/utils/retry.js +35 -0
  46. package/dist/cjs/utils/retry.js.map +1 -0
  47. package/dist/cjs/utils/sanitizer.js +106 -0
  48. package/dist/cjs/utils/sanitizer.js.map +1 -0
  49. package/dist/cjs/utils/storage.js +99 -0
  50. package/dist/cjs/utils/storage.js.map +1 -0
  51. package/dist/cli/commands/setup.js +178 -0
  52. package/dist/cli/commands/setup.js.map +1 -0
  53. package/dist/cli/commands/status.js +103 -0
  54. package/dist/cli/commands/status.js.map +1 -0
  55. package/dist/cli/index.js +111 -0
  56. package/dist/cli/index.js.map +1 -0
  57. package/dist/cli/prompt.js +140 -0
  58. package/dist/cli/prompt.js.map +1 -0
  59. package/dist/esm/context/ContextManager.js +193 -0
  60. package/dist/esm/context/ContextManager.js.map +1 -0
  61. package/dist/esm/core/BootstrapGuard.js +77 -0
  62. package/dist/esm/core/BootstrapGuard.js.map +1 -0
  63. package/dist/esm/core/ConfigManager.js +129 -0
  64. package/dist/esm/core/ConfigManager.js.map +1 -0
  65. package/dist/esm/core/ObservabilitySDK.js +351 -0
  66. package/dist/esm/core/ObservabilitySDK.js.map +1 -0
  67. package/dist/esm/errors/ErrorBoundary.js +183 -0
  68. package/dist/esm/errors/ErrorBoundary.js.map +1 -0
  69. package/dist/esm/index.js +87 -0
  70. package/dist/esm/index.js.map +1 -0
  71. package/dist/esm/logger/LoggerService.js +251 -0
  72. package/dist/esm/logger/LoggerService.js.map +1 -0
  73. package/dist/esm/logs/LogsManager.js +108 -0
  74. package/dist/esm/logs/LogsManager.js.map +1 -0
  75. package/dist/esm/network/NetworkInterceptor.js +181 -0
  76. package/dist/esm/network/NetworkInterceptor.js.map +1 -0
  77. package/dist/esm/performance/PerformanceMonitor.js +286 -0
  78. package/dist/esm/performance/PerformanceMonitor.js.map +1 -0
  79. package/dist/esm/resources/ResourceProvisioner.js +206 -0
  80. package/dist/esm/resources/ResourceProvisioner.js.map +1 -0
  81. package/dist/esm/resources/templates/dashboard.js +330 -0
  82. package/dist/esm/resources/templates/dashboard.js.map +1 -0
  83. package/dist/esm/resources/templates/monitors.js +117 -0
  84. package/dist/esm/resources/templates/monitors.js.map +1 -0
  85. package/dist/esm/resources/templates/slos.js +76 -0
  86. package/dist/esm/resources/templates/slos.js.map +1 -0
  87. package/dist/esm/rum/RumManager.js +160 -0
  88. package/dist/esm/rum/RumManager.js.map +1 -0
  89. package/dist/esm/types/config.js +10 -0
  90. package/dist/esm/types/config.js.map +1 -0
  91. package/dist/esm/types/events.js +23 -0
  92. package/dist/esm/types/events.js.map +1 -0
  93. package/dist/esm/types/index.js +4 -0
  94. package/dist/esm/types/index.js.map +1 -0
  95. package/dist/esm/types/logger.js +10 -0
  96. package/dist/esm/types/logger.js.map +1 -0
  97. package/dist/esm/utils/EventEmitter.js +45 -0
  98. package/dist/esm/utils/EventEmitter.js.map +1 -0
  99. package/dist/esm/utils/fingerprint.js +44 -0
  100. package/dist/esm/utils/fingerprint.js.map +1 -0
  101. package/dist/esm/utils/retry.js +32 -0
  102. package/dist/esm/utils/retry.js.map +1 -0
  103. package/dist/esm/utils/sanitizer.js +102 -0
  104. package/dist/esm/utils/sanitizer.js.map +1 -0
  105. package/dist/esm/utils/storage.js +95 -0
  106. package/dist/esm/utils/storage.js.map +1 -0
  107. package/dist/resources/ResourceProvisioner.js +207 -0
  108. package/dist/resources/ResourceProvisioner.js.map +1 -0
  109. package/dist/resources/templates/dashboard.js +333 -0
  110. package/dist/resources/templates/dashboard.js.map +1 -0
  111. package/dist/resources/templates/monitors.js +120 -0
  112. package/dist/resources/templates/monitors.js.map +1 -0
  113. package/dist/resources/templates/slos.js +79 -0
  114. package/dist/resources/templates/slos.js.map +1 -0
  115. package/dist/types/config.js +13 -0
  116. package/dist/types/config.js.map +1 -0
  117. package/dist/types/context/ContextManager.d.ts +63 -0
  118. package/dist/types/context/ContextManager.d.ts.map +1 -0
  119. package/dist/types/core/BootstrapGuard.d.ts +46 -0
  120. package/dist/types/core/BootstrapGuard.d.ts.map +1 -0
  121. package/dist/types/core/ConfigManager.d.ts +13 -0
  122. package/dist/types/core/ConfigManager.d.ts.map +1 -0
  123. package/dist/types/core/ObservabilitySDK.d.ts +141 -0
  124. package/dist/types/core/ObservabilitySDK.d.ts.map +1 -0
  125. package/dist/types/errors/ErrorBoundary.d.ts +55 -0
  126. package/dist/types/errors/ErrorBoundary.d.ts.map +1 -0
  127. package/dist/types/events.js +26 -0
  128. package/dist/types/events.js.map +1 -0
  129. package/dist/types/index.d.ts +75 -0
  130. package/dist/types/index.d.ts.map +1 -0
  131. package/dist/types/index.js +20 -0
  132. package/dist/types/index.js.map +1 -0
  133. package/dist/types/logger/LoggerService.d.ts +104 -0
  134. package/dist/types/logger/LoggerService.d.ts.map +1 -0
  135. package/dist/types/logger.js +13 -0
  136. package/dist/types/logger.js.map +1 -0
  137. package/dist/types/logs/LogsManager.d.ts +41 -0
  138. package/dist/types/logs/LogsManager.d.ts.map +1 -0
  139. package/dist/types/network/NetworkInterceptor.d.ts +35 -0
  140. package/dist/types/network/NetworkInterceptor.d.ts.map +1 -0
  141. package/dist/types/performance/PerformanceMonitor.d.ts +44 -0
  142. package/dist/types/performance/PerformanceMonitor.d.ts.map +1 -0
  143. package/dist/types/resources/ResourceProvisioner.d.ts +46 -0
  144. package/dist/types/resources/ResourceProvisioner.d.ts.map +1 -0
  145. package/dist/types/resources/templates/dashboard.d.ts +6 -0
  146. package/dist/types/resources/templates/dashboard.d.ts.map +1 -0
  147. package/dist/types/resources/templates/monitors.d.ts +11 -0
  148. package/dist/types/resources/templates/monitors.d.ts.map +1 -0
  149. package/dist/types/resources/templates/slos.d.ts +18 -0
  150. package/dist/types/resources/templates/slos.d.ts.map +1 -0
  151. package/dist/types/rum/RumManager.d.ts +70 -0
  152. package/dist/types/rum/RumManager.d.ts.map +1 -0
  153. package/dist/types/types/config.d.ts +271 -0
  154. package/dist/types/types/config.d.ts.map +1 -0
  155. package/dist/types/types/events.d.ts +71 -0
  156. package/dist/types/types/events.d.ts.map +1 -0
  157. package/dist/types/types/index.d.ts +4 -0
  158. package/dist/types/types/index.d.ts.map +1 -0
  159. package/dist/types/types/logger.d.ts +102 -0
  160. package/dist/types/types/logger.d.ts.map +1 -0
  161. package/dist/types/utils/EventEmitter.d.ts +14 -0
  162. package/dist/types/utils/EventEmitter.d.ts.map +1 -0
  163. package/dist/types/utils/fingerprint.d.ts +10 -0
  164. package/dist/types/utils/fingerprint.d.ts.map +1 -0
  165. package/dist/types/utils/retry.d.ts +9 -0
  166. package/dist/types/utils/retry.d.ts.map +1 -0
  167. package/dist/types/utils/sanitizer.d.ts +14 -0
  168. package/dist/types/utils/sanitizer.d.ts.map +1 -0
  169. package/dist/types/utils/storage.d.ts +17 -0
  170. package/dist/types/utils/storage.d.ts.map +1 -0
  171. package/dist/utils/retry.js +35 -0
  172. package/dist/utils/retry.js.map +1 -0
  173. package/package.json +84 -0
@@ -0,0 +1,251 @@
1
+ import { LogLevel } from '../types/config';
2
+ import { LOG_LEVEL_PRIORITY } from '../types/logger';
3
+ import { SDKEvent } from '../types/events';
4
+ import { Sanitizer } from '../utils/sanitizer';
5
+ import { generateErrorFingerprint } from '../utils/fingerprint';
6
+ /**
7
+ * Enterprise-grade logger service with structured logging, context enrichment,
8
+ * automatic Datadog forwarding, and PII sanitization.
9
+ *
10
+ * Supports all standard log levels: debug, info, warn, error, critical.
11
+ * Warns and errors are automatically forwarded to Datadog.
12
+ *
13
+ * Usage:
14
+ * const logger = observatory.getLogger();
15
+ * logger.info('User signed in', { userId: '123' });
16
+ * logger.error('Payment failed', new Error('timeout'), { orderId: 'abc' });
17
+ */
18
+ export class LoggerService {
19
+ logsManager;
20
+ contextManager;
21
+ emitter;
22
+ sanitizer;
23
+ minLevel;
24
+ consoleOutput;
25
+ service;
26
+ env;
27
+ version;
28
+ scopeContext = {};
29
+ constructor(logsManager, contextManager, emitter, options) {
30
+ this.logsManager = logsManager;
31
+ this.contextManager = contextManager;
32
+ this.emitter = emitter;
33
+ this.sanitizer = new Sanitizer(options.piiFields);
34
+ this.minLevel = options.minLevel;
35
+ this.consoleOutput = options.consoleOutput;
36
+ this.service = options.service;
37
+ this.env = options.env;
38
+ this.version = options.version;
39
+ }
40
+ /**
41
+ * Creates a child logger with additional scoped context.
42
+ * Useful for module-specific logging without polluting global context.
43
+ */
44
+ child(context) {
45
+ return new ChildLogger(this, context);
46
+ }
47
+ /**
48
+ * Logs a debug message. Not sent to Datadog by default.
49
+ */
50
+ debug(message, context) {
51
+ this.log(LogLevel.DEBUG, message, undefined, context);
52
+ }
53
+ /**
54
+ * Logs an informational message.
55
+ */
56
+ info(message, context) {
57
+ this.log(LogLevel.INFO, message, undefined, context);
58
+ }
59
+ warn(message, errorOrContext, context) {
60
+ const { error, ctx } = this.parseErrorArgs(errorOrContext, context);
61
+ this.log(LogLevel.WARN, message, error, ctx);
62
+ }
63
+ error(message, errorOrContext, context) {
64
+ const { error, ctx } = this.parseErrorArgs(errorOrContext, context);
65
+ this.log(LogLevel.ERROR, message, error, ctx);
66
+ }
67
+ critical(message, errorOrContext, context) {
68
+ const { error, ctx } = this.parseErrorArgs(errorOrContext, context);
69
+ this.log(LogLevel.CRITICAL, message, error, ctx);
70
+ }
71
+ /**
72
+ * Measures execution time of an async operation.
73
+ */
74
+ async time(label, fn, context) {
75
+ const start = performance.now();
76
+ try {
77
+ const result = await fn();
78
+ const duration = performance.now() - start;
79
+ this.info(`${label} completed`, { ...context, duration_ms: Math.round(duration) });
80
+ return result;
81
+ }
82
+ catch (err) {
83
+ const duration = performance.now() - start;
84
+ this.error(`${label} failed`, err instanceof Error ? err : new Error(String(err)), {
85
+ ...context,
86
+ duration_ms: Math.round(duration),
87
+ });
88
+ throw err;
89
+ }
90
+ }
91
+ /**
92
+ * Adds persistent context to this logger instance.
93
+ */
94
+ setContext(context) {
95
+ this.scopeContext = { ...this.scopeContext, ...context };
96
+ }
97
+ /**
98
+ * Clears scoped context.
99
+ */
100
+ clearContext() {
101
+ this.scopeContext = {};
102
+ }
103
+ /** @internal Core log method */
104
+ log(level, message, error, context) {
105
+ if (!this.shouldLog(level)) {
106
+ return;
107
+ }
108
+ const serializedError = error ? this.serializeError(error) : undefined;
109
+ const mergedContext = this.sanitizer.sanitize({
110
+ ...this.scopeContext,
111
+ ...context,
112
+ });
113
+ const entry = {
114
+ level,
115
+ message: this.sanitizer.sanitizeString(message),
116
+ timestamp: new Date().toISOString(),
117
+ service: this.service,
118
+ env: this.env,
119
+ version: this.version,
120
+ context: mergedContext,
121
+ error: serializedError,
122
+ url: typeof window !== 'undefined' ? window.location.href : undefined,
123
+ view: this.contextManager.getView(),
124
+ user: this.contextManager.getUser(),
125
+ fingerprint: serializedError?.fingerprint,
126
+ tags: [],
127
+ };
128
+ // Console output
129
+ if (this.consoleOutput) {
130
+ this.writeToConsole(entry);
131
+ }
132
+ // Forward to Datadog (warn, error, critical always; others based on config)
133
+ if (this.shouldForwardToDatadog(level)) {
134
+ this.logsManager.log(level, entry.message, mergedContext, serializedError);
135
+ }
136
+ // Emit event
137
+ this.emitter.emit(SDKEvent.LOG_SENT, {
138
+ type: SDKEvent.LOG_SENT,
139
+ timestamp: Date.now(),
140
+ data: { level, message: entry.message },
141
+ });
142
+ }
143
+ shouldLog(level) {
144
+ return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.minLevel];
145
+ }
146
+ shouldForwardToDatadog(level) {
147
+ return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[LogLevel.WARN];
148
+ }
149
+ serializeError(error) {
150
+ return {
151
+ name: error.name,
152
+ message: this.sanitizer.sanitizeString(error.message),
153
+ stack: error.stack ? this.sanitizer.sanitizeString(error.stack) : undefined,
154
+ cause: error.cause instanceof Error ? this.serializeError(error.cause) : undefined,
155
+ type: error.constructor.name,
156
+ fingerprint: generateErrorFingerprint(error),
157
+ metadata: this.extractErrorMetadata(error),
158
+ };
159
+ }
160
+ extractErrorMetadata(error) {
161
+ const metadata = {};
162
+ const knownKeys = new Set(['name', 'message', 'stack', 'cause']);
163
+ for (const key of Object.getOwnPropertyNames(error)) {
164
+ if (!knownKeys.has(key)) {
165
+ metadata[key] = error[key];
166
+ }
167
+ }
168
+ return Object.keys(metadata).length > 0 ? metadata : {};
169
+ }
170
+ parseErrorArgs(errorOrContext, context) {
171
+ if (errorOrContext instanceof Error) {
172
+ return { error: errorOrContext, ctx: context };
173
+ }
174
+ return { error: undefined, ctx: errorOrContext };
175
+ }
176
+ writeToConsole(entry) {
177
+ const prefix = `[${entry.service}] [${entry.level.toUpperCase()}]`;
178
+ const args = [prefix, entry.message];
179
+ if (entry.context && Object.keys(entry.context).length > 0) {
180
+ args.push(entry.context);
181
+ }
182
+ if (entry.error) {
183
+ args.push(entry.error);
184
+ }
185
+ switch (entry.level) {
186
+ case LogLevel.DEBUG:
187
+ // eslint-disable-next-line no-console
188
+ console.debug(...args);
189
+ break;
190
+ case LogLevel.INFO:
191
+ // eslint-disable-next-line no-console
192
+ console.info(...args);
193
+ break;
194
+ case LogLevel.WARN:
195
+ // eslint-disable-next-line no-console
196
+ console.warn(...args);
197
+ break;
198
+ case LogLevel.ERROR:
199
+ case LogLevel.CRITICAL:
200
+ // eslint-disable-next-line no-console
201
+ console.error(...args);
202
+ break;
203
+ }
204
+ }
205
+ }
206
+ /**
207
+ * Child logger with scoped context.
208
+ * Delegates all logging to the parent LoggerService.
209
+ */
210
+ export class ChildLogger {
211
+ parent;
212
+ childContext;
213
+ constructor(parent, context) {
214
+ this.parent = parent;
215
+ this.childContext = context;
216
+ }
217
+ debug(message, context) {
218
+ this.parent.log(LogLevel.DEBUG, message, undefined, { ...this.childContext, ...context });
219
+ }
220
+ info(message, context) {
221
+ this.parent.log(LogLevel.INFO, message, undefined, { ...this.childContext, ...context });
222
+ }
223
+ warn(message, errorOrContext, context) {
224
+ if (errorOrContext instanceof Error) {
225
+ this.parent.log(LogLevel.WARN, message, errorOrContext, { ...this.childContext, ...context });
226
+ }
227
+ else {
228
+ this.parent.log(LogLevel.WARN, message, undefined, { ...this.childContext, ...errorOrContext });
229
+ }
230
+ }
231
+ error(message, errorOrContext, context) {
232
+ if (errorOrContext instanceof Error) {
233
+ this.parent.log(LogLevel.ERROR, message, errorOrContext, { ...this.childContext, ...context });
234
+ }
235
+ else {
236
+ this.parent.log(LogLevel.ERROR, message, undefined, { ...this.childContext, ...errorOrContext });
237
+ }
238
+ }
239
+ critical(message, errorOrContext, context) {
240
+ if (errorOrContext instanceof Error) {
241
+ this.parent.log(LogLevel.CRITICAL, message, errorOrContext, { ...this.childContext, ...context });
242
+ }
243
+ else {
244
+ this.parent.log(LogLevel.CRITICAL, message, undefined, { ...this.childContext, ...errorOrContext });
245
+ }
246
+ }
247
+ child(context) {
248
+ return new ChildLogger(this.parent, { ...this.childContext, ...context });
249
+ }
250
+ }
251
+ //# sourceMappingURL=LoggerService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LoggerService.js","sourceRoot":"","sources":["../../../src/logger/LoggerService.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,108 @@
1
+ import { datadogLogs } from '@datadog/browser-logs';
2
+ import { LogLevel } from '../types/config';
3
+ /**
4
+ * Manages Datadog Browser Logs SDK initialization and log forwarding.
5
+ * Acts as the transport layer between LoggerService and Datadog.
6
+ * Follows the Adapter pattern to normalize log levels and context.
7
+ */
8
+ export class LogsManager {
9
+ config;
10
+ contextManager;
11
+ initialized = false;
12
+ constructor(config, contextManager) {
13
+ this.config = config;
14
+ this.contextManager = contextManager;
15
+ }
16
+ /**
17
+ * Initializes the Datadog Browser Logs SDK.
18
+ */
19
+ init() {
20
+ if (this.initialized) {
21
+ return;
22
+ }
23
+ datadogLogs.init({
24
+ clientToken: this.config.clientToken,
25
+ site: this.config.site,
26
+ service: this.config.service,
27
+ env: this.config.env,
28
+ version: this.config.version,
29
+ forwardErrorsToLogs: this.config.errorTracking.consoleErrors,
30
+ forwardConsoleLogs: this.config.debug ? 'all' : [],
31
+ sessionSampleRate: this.config.sampling.logSampleRate,
32
+ proxy: this.config.proxy,
33
+ ...this.config.logsOverrides,
34
+ });
35
+ // Set initial global context
36
+ const globalContext = this.contextManager.getGlobalContext();
37
+ for (const [key, value] of Object.entries(globalContext)) {
38
+ datadogLogs.setGlobalContextProperty(key, value);
39
+ }
40
+ // Set user context
41
+ const user = this.contextManager.getUser();
42
+ if (user) {
43
+ datadogLogs.setUser({
44
+ id: user.id,
45
+ name: user.name,
46
+ email: user.email,
47
+ ...user,
48
+ });
49
+ }
50
+ this.initialized = true;
51
+ }
52
+ /**
53
+ * Sends a log entry to Datadog.
54
+ */
55
+ log(level, message, context, error) {
56
+ if (!this.initialized)
57
+ return;
58
+ const enrichedContext = {
59
+ ...this.contextManager.getFullContext(),
60
+ ...context,
61
+ ...(error ? { error } : {}),
62
+ };
63
+ const ddLevel = this.mapLogLevel(level);
64
+ datadogLogs.logger[ddLevel](message, enrichedContext);
65
+ }
66
+ /**
67
+ * Sets a global context property in Logs SDK.
68
+ */
69
+ setGlobalContext(key, value) {
70
+ if (!this.initialized)
71
+ return;
72
+ datadogLogs.setGlobalContextProperty(key, value);
73
+ }
74
+ /**
75
+ * Removes a global context property from Logs SDK.
76
+ */
77
+ removeGlobalContext(key) {
78
+ if (!this.initialized)
79
+ return;
80
+ datadogLogs.removeGlobalContextProperty(key);
81
+ }
82
+ /**
83
+ * Returns whether the Logs SDK is initialized.
84
+ */
85
+ isInitialized() {
86
+ return this.initialized;
87
+ }
88
+ /**
89
+ * Maps toolkit log levels to Datadog SDK log levels.
90
+ * CRITICAL maps to 'error' since Datadog SDK doesn't have a critical level.
91
+ */
92
+ mapLogLevel(level) {
93
+ switch (level) {
94
+ case LogLevel.DEBUG:
95
+ return 'debug';
96
+ case LogLevel.INFO:
97
+ return 'info';
98
+ case LogLevel.WARN:
99
+ return 'warn';
100
+ case LogLevel.ERROR:
101
+ case LogLevel.CRITICAL:
102
+ return 'error';
103
+ default:
104
+ return 'info';
105
+ }
106
+ }
107
+ }
108
+ //# sourceMappingURL=LogsManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LogsManager.js","sourceRoot":"","sources":["../../../src/logs/LogsManager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,181 @@
1
+ import { SDKEvent } from '../types/events';
2
+ /**
3
+ * Intercepts XHR and Fetch requests to track network performance,
4
+ * detect failures, and enrich Datadog context with API call data.
5
+ *
6
+ * Uses the Proxy/Decorator pattern to wrap native browser APIs
7
+ * without breaking existing functionality.
8
+ */
9
+ export class NetworkInterceptor {
10
+ config;
11
+ logger;
12
+ emitter;
13
+ installed = false;
14
+ originalFetch;
15
+ originalXhrOpen;
16
+ originalXhrSend;
17
+ constructor(config, logger, emitter) {
18
+ this.config = config;
19
+ this.logger = logger;
20
+ this.emitter = emitter;
21
+ }
22
+ /**
23
+ * Installs network interceptors for Fetch and XHR.
24
+ */
25
+ install() {
26
+ if (this.installed || typeof window === 'undefined') {
27
+ return;
28
+ }
29
+ this.interceptFetch();
30
+ this.interceptXhr();
31
+ this.installed = true;
32
+ }
33
+ /**
34
+ * Restores original Fetch and XHR implementations.
35
+ */
36
+ uninstall() {
37
+ if (!this.installed || typeof window === 'undefined') {
38
+ return;
39
+ }
40
+ if (this.originalFetch) {
41
+ window.fetch = this.originalFetch;
42
+ }
43
+ if (this.originalXhrOpen && this.originalXhrSend) {
44
+ XMLHttpRequest.prototype.open = this.originalXhrOpen;
45
+ XMLHttpRequest.prototype.send = this.originalXhrSend;
46
+ }
47
+ this.installed = false;
48
+ }
49
+ interceptFetch() {
50
+ if (typeof fetch === 'undefined')
51
+ return;
52
+ this.originalFetch = window.fetch.bind(window);
53
+ const self = this;
54
+ window.fetch = async function (input, init) {
55
+ const url = self.extractUrl(input);
56
+ const method = init?.method || 'GET';
57
+ if (self.shouldExclude(url)) {
58
+ return self.originalFetch(input, init);
59
+ }
60
+ const startTime = performance.now();
61
+ try {
62
+ const response = await self.originalFetch(input, init);
63
+ const duration = performance.now() - startTime;
64
+ self.reportRequest({
65
+ method: method.toUpperCase(),
66
+ url,
67
+ status: response.status,
68
+ duration,
69
+ responseSize: self.getContentLength(response.headers),
70
+ });
71
+ if (!response.ok) {
72
+ self.logger.warn(`HTTP ${response.status} ${method.toUpperCase()} ${url}`, {
73
+ status: response.status,
74
+ statusText: response.statusText,
75
+ duration_ms: Math.round(duration),
76
+ url,
77
+ method: method.toUpperCase(),
78
+ });
79
+ }
80
+ return response;
81
+ }
82
+ catch (error) {
83
+ const duration = performance.now() - startTime;
84
+ self.reportRequest({
85
+ method: method.toUpperCase(),
86
+ url,
87
+ status: 0,
88
+ duration,
89
+ error: error instanceof Error ? error.message : 'Network error',
90
+ });
91
+ self.logger.error(`Network error: ${method.toUpperCase()} ${url}`, error instanceof Error ? error : new Error(String(error)), {
92
+ duration_ms: Math.round(duration),
93
+ url,
94
+ method: method.toUpperCase(),
95
+ });
96
+ throw error;
97
+ }
98
+ };
99
+ }
100
+ interceptXhr() {
101
+ if (typeof XMLHttpRequest === 'undefined')
102
+ return;
103
+ this.originalXhrOpen = XMLHttpRequest.prototype.open;
104
+ this.originalXhrSend = XMLHttpRequest.prototype.send;
105
+ const self = this;
106
+ XMLHttpRequest.prototype.open = function (method, url, ...args) {
107
+ this._ddMethod = method.toUpperCase();
108
+ this._ddUrl = url.toString();
109
+ return self.originalXhrOpen.apply(this, [method, url, ...args]);
110
+ };
111
+ XMLHttpRequest.prototype.send = function (body) {
112
+ const xhrMethod = this._ddMethod || 'UNKNOWN';
113
+ const xhrUrl = this._ddUrl || 'unknown';
114
+ if (self.shouldExclude(xhrUrl)) {
115
+ return self.originalXhrSend.call(this, body);
116
+ }
117
+ const startTime = performance.now();
118
+ this.addEventListener('loadend', function () {
119
+ const duration = performance.now() - startTime;
120
+ self.reportRequest({
121
+ method: xhrMethod,
122
+ url: xhrUrl,
123
+ status: this.status,
124
+ duration,
125
+ });
126
+ if (this.status >= 400 || this.status === 0) {
127
+ self.logger.warn(`XHR ${this.status} ${xhrMethod} ${xhrUrl}`, {
128
+ status: this.status,
129
+ duration_ms: Math.round(duration),
130
+ url: xhrUrl,
131
+ method: xhrMethod,
132
+ });
133
+ }
134
+ });
135
+ this.addEventListener('error', function () {
136
+ const duration = performance.now() - startTime;
137
+ self.reportRequest({
138
+ method: xhrMethod,
139
+ url: xhrUrl,
140
+ status: 0,
141
+ duration,
142
+ error: 'XHR network error',
143
+ });
144
+ });
145
+ return self.originalXhrSend.call(this, body);
146
+ };
147
+ }
148
+ shouldExclude(url) {
149
+ return this.config.network.excludeUrls.some((pattern) => {
150
+ if (typeof pattern === 'string') {
151
+ return url.includes(pattern);
152
+ }
153
+ return pattern.test(url);
154
+ });
155
+ }
156
+ extractUrl(input) {
157
+ if (typeof input === 'string')
158
+ return input;
159
+ if (input instanceof URL)
160
+ return input.href;
161
+ if (input instanceof Request)
162
+ return input.url;
163
+ return 'unknown';
164
+ }
165
+ getContentLength(headers) {
166
+ const cl = headers.get('content-length');
167
+ return cl ? parseInt(cl, 10) : undefined;
168
+ }
169
+ reportRequest(data) {
170
+ if (this.config.network.failedOnly && data.status > 0 && data.status < 400) {
171
+ return;
172
+ }
173
+ const payload = {
174
+ type: SDKEvent.NETWORK_REQUEST,
175
+ timestamp: Date.now(),
176
+ data,
177
+ };
178
+ this.emitter.emit(SDKEvent.NETWORK_REQUEST, payload);
179
+ }
180
+ }
181
+ //# sourceMappingURL=NetworkInterceptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"NetworkInterceptor.js","sourceRoot":"","sources":["../../../src/network/NetworkInterceptor.ts"],"names":[],"mappings":"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"}