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,160 @@
1
+ import { datadogRum } from '@datadog/browser-rum';
2
+ /**
3
+ * Manages Datadog RUM (Real User Monitoring) initialization and lifecycle.
4
+ * Encapsulates all RUM SDK interactions behind a clean interface.
5
+ * Follows the Facade pattern to simplify RUM SDK complexity.
6
+ */
7
+ export class RumManager {
8
+ config;
9
+ contextManager;
10
+ initialized = false;
11
+ constructor(config, contextManager) {
12
+ this.config = config;
13
+ this.contextManager = contextManager;
14
+ }
15
+ /**
16
+ * Initializes the Datadog RUM SDK with resolved configuration.
17
+ */
18
+ init() {
19
+ if (this.initialized) {
20
+ return;
21
+ }
22
+ datadogRum.init({
23
+ applicationId: this.config.applicationId,
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
+ sessionSampleRate: this.config.sampling.sessionSampleRate,
30
+ sessionReplaySampleRate: this.config.sampling.sessionReplaySampleRate,
31
+ trackUserInteractions: this.config.actions.trackUserInteractions,
32
+ trackResources: true,
33
+ trackLongTasks: this.config.performance.longTasks,
34
+ defaultPrivacyLevel: this.config.privacy.defaultPrivacyLevel,
35
+ allowedTracingUrls: this.config.allowedTracingUrls,
36
+ proxy: this.config.proxy,
37
+ trackViewsManually: this.config.actions.trackViewsManually,
38
+ ...this.config.rumOverrides,
39
+ });
40
+ // Set initial global context
41
+ const globalContext = this.contextManager.getGlobalContext();
42
+ for (const [key, value] of Object.entries(globalContext)) {
43
+ datadogRum.setGlobalContextProperty(key, value);
44
+ }
45
+ // Set initial user context
46
+ const user = this.contextManager.getUser();
47
+ if (user) {
48
+ this.setUser(user);
49
+ }
50
+ this.initialized = true;
51
+ }
52
+ /**
53
+ * Starts session replay recording.
54
+ */
55
+ startSessionReplay() {
56
+ if (!this.initialized)
57
+ return;
58
+ datadogRum.startSessionReplayRecording();
59
+ }
60
+ /**
61
+ * Stops session replay recording.
62
+ */
63
+ stopSessionReplay() {
64
+ if (!this.initialized)
65
+ return;
66
+ datadogRum.stopSessionReplayRecording();
67
+ }
68
+ /**
69
+ * Sets user information in RUM context.
70
+ */
71
+ setUser(user) {
72
+ if (!this.initialized)
73
+ return;
74
+ datadogRum.setUser({
75
+ id: user.id,
76
+ name: user.name,
77
+ email: user.email,
78
+ ...user,
79
+ });
80
+ }
81
+ /**
82
+ * Clears user information from RUM context.
83
+ */
84
+ clearUser() {
85
+ if (!this.initialized)
86
+ return;
87
+ datadogRum.clearUser();
88
+ }
89
+ /**
90
+ * Sets a global context property.
91
+ */
92
+ setGlobalContext(key, value) {
93
+ if (!this.initialized)
94
+ return;
95
+ datadogRum.setGlobalContextProperty(key, value);
96
+ }
97
+ /**
98
+ * Removes a global context property.
99
+ */
100
+ removeGlobalContext(key) {
101
+ if (!this.initialized)
102
+ return;
103
+ datadogRum.removeGlobalContextProperty(key);
104
+ }
105
+ /**
106
+ * Adds a custom action event.
107
+ */
108
+ addAction(name, context) {
109
+ if (!this.initialized)
110
+ return;
111
+ datadogRum.addAction(name, context);
112
+ }
113
+ /**
114
+ * Adds a custom error to RUM.
115
+ */
116
+ addError(error, context) {
117
+ if (!this.initialized)
118
+ return;
119
+ datadogRum.addError(error, context);
120
+ }
121
+ /**
122
+ * Adds a custom timing measurement.
123
+ */
124
+ addTiming(name, time) {
125
+ if (!this.initialized)
126
+ return;
127
+ datadogRum.addTiming(name, time);
128
+ }
129
+ /**
130
+ * Starts a new RUM view.
131
+ */
132
+ startView(name) {
133
+ if (!this.initialized)
134
+ return;
135
+ datadogRum.startView({ name });
136
+ }
137
+ /**
138
+ * Gets the current RUM internal context (session ID, view ID, etc.).
139
+ */
140
+ getInternalContext() {
141
+ if (!this.initialized)
142
+ return undefined;
143
+ return datadogRum.getInternalContext();
144
+ }
145
+ /**
146
+ * Returns whether the SDK is initialized.
147
+ */
148
+ isInitialized() {
149
+ return this.initialized;
150
+ }
151
+ /**
152
+ * Stops RUM collection. Cannot be restarted.
153
+ */
154
+ stop() {
155
+ // Datadog RUM SDK doesn't have an explicit stop method —
156
+ // we simply mark as uninitialized to prevent further operations.
157
+ this.initialized = false;
158
+ }
159
+ }
160
+ //# sourceMappingURL=RumManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RumManager.js","sourceRoot":"","sources":["../../../src/rum/RumManager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /** Log levels supported by the toolkit */
2
+ export var LogLevel;
3
+ (function (LogLevel) {
4
+ LogLevel["DEBUG"] = "debug";
5
+ LogLevel["INFO"] = "info";
6
+ LogLevel["WARN"] = "warn";
7
+ LogLevel["ERROR"] = "error";
8
+ LogLevel["CRITICAL"] = "critical";
9
+ })(LogLevel || (LogLevel = {}));
10
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":"AAGA,0CAA0C;AAC1C,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,iCAAqB,CAAA;AACvB,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB"}
@@ -0,0 +1,23 @@
1
+ /** Event types emitted by the SDK */
2
+ export var SDKEvent;
3
+ (function (SDKEvent) {
4
+ SDKEvent["INITIALIZED"] = "sdk:initialized";
5
+ SDKEvent["DESTROYED"] = "sdk:destroyed";
6
+ SDKEvent["ERROR_CAPTURED"] = "sdk:error_captured";
7
+ SDKEvent["LOG_SENT"] = "sdk:log_sent";
8
+ SDKEvent["SESSION_STARTED"] = "sdk:session_started";
9
+ SDKEvent["SESSION_ENDED"] = "sdk:session_ended";
10
+ SDKEvent["USER_SET"] = "sdk:user_set";
11
+ SDKEvent["CONTEXT_UPDATED"] = "sdk:context_updated";
12
+ SDKEvent["CONSENT_GRANTED"] = "sdk:consent_granted";
13
+ SDKEvent["CONSENT_REVOKED"] = "sdk:consent_revoked";
14
+ SDKEvent["PERFORMANCE_ENTRY"] = "sdk:performance_entry";
15
+ SDKEvent["NETWORK_REQUEST"] = "sdk:network_request";
16
+ SDKEvent["VIEW_CHANGED"] = "sdk:view_changed";
17
+ SDKEvent["ACTION_TRACKED"] = "sdk:action_tracked";
18
+ SDKEvent["RESOURCE_PROVISIONED"] = "sdk:resource_provisioned";
19
+ SDKEvent["PLUGIN_LOADED"] = "sdk:plugin_loaded";
20
+ SDKEvent["PLUGIN_ERROR"] = "sdk:plugin_error";
21
+ SDKEvent["THROTTLE_ACTIVATED"] = "sdk:throttle_activated";
22
+ })(SDKEvent || (SDKEvent = {}));
23
+ //# sourceMappingURL=events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/types/events.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAN,IAAY,QAmBX;AAnBD,WAAY,QAAQ;IAClB,2CAA+B,CAAA;IAC/B,uCAA2B,CAAA;IAC3B,iDAAqC,CAAA;IACrC,qCAAyB,CAAA;IACzB,mDAAuC,CAAA;IACvC,+CAAmC,CAAA;IACnC,qCAAyB,CAAA;IACzB,mDAAuC,CAAA;IACvC,mDAAuC,CAAA;IACvC,mDAAuC,CAAA;IACvC,uDAA2C,CAAA;IAC3C,mDAAuC,CAAA;IACvC,6CAAiC,CAAA;IACjC,iDAAqC,CAAA;IACrC,6DAAiD,CAAA;IACjD,+CAAmC,CAAA;IACnC,6CAAiC,CAAA;IACjC,yDAA6C,CAAA;AAC/C,CAAC,EAnBW,QAAQ,KAAR,QAAQ,QAmBnB"}
@@ -0,0 +1,4 @@
1
+ export * from './config';
2
+ export * from './logger';
3
+ export * from './events';
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
@@ -0,0 +1,10 @@
1
+ import { LogLevel } from './config';
2
+ /** Log level numeric values for comparison */
3
+ export const LOG_LEVEL_PRIORITY = {
4
+ [LogLevel.DEBUG]: 0,
5
+ [LogLevel.INFO]: 1,
6
+ [LogLevel.WARN]: 2,
7
+ [LogLevel.ERROR]: 3,
8
+ [LogLevel.CRITICAL]: 4,
9
+ };
10
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/types/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AA4GpC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;CACvB,CAAC"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Type-safe event emitter for SDK lifecycle events.
3
+ * Implements the Observer pattern for loose coupling between modules.
4
+ */
5
+ export class EventEmitter {
6
+ listeners = new Map();
7
+ on(event, handler) {
8
+ if (!this.listeners.has(event)) {
9
+ this.listeners.set(event, new Set());
10
+ }
11
+ this.listeners.get(event).add(handler);
12
+ }
13
+ off(event, handler) {
14
+ this.listeners.get(event)?.delete(handler);
15
+ }
16
+ emit(event, payload) {
17
+ const handlers = this.listeners.get(event);
18
+ if (!handlers)
19
+ return;
20
+ for (const handler of handlers) {
21
+ try {
22
+ handler(payload);
23
+ }
24
+ catch {
25
+ // Prevent listener errors from breaking the SDK
26
+ }
27
+ }
28
+ }
29
+ once(event, handler) {
30
+ const wrappedHandler = (payload) => {
31
+ this.off(event, wrappedHandler);
32
+ handler(payload);
33
+ };
34
+ this.on(event, wrappedHandler);
35
+ }
36
+ removeAllListeners(event) {
37
+ if (event) {
38
+ this.listeners.delete(event);
39
+ }
40
+ else {
41
+ this.listeners.clear();
42
+ }
43
+ }
44
+ }
45
+ //# sourceMappingURL=EventEmitter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../../../src/utils/EventEmitter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAAqC,IAAI,GAAG,EAAE,CAAC;IAEhE,EAAE,CAA4B,KAAe,EAAE,OAAwB;QACrE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAC;IAC1D,CAAC;IAED,GAAG,CAA4B,KAAe,EAAE,OAAwB;QACtE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAuB,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAA4B,KAAe,EAAE,OAAU;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAA4B,KAAe,EAAE,OAAwB;QACvE,MAAM,cAAc,GAAoB,CAAC,OAAO,EAAE,EAAE;YAClD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAChC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACjC,CAAC;IAED,kBAAkB,CAAC,KAAgB;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Generates a deterministic fingerprint for an error based on its key properties.
3
+ * Used to group duplicate errors and prevent noise.
4
+ */
5
+ export function generateErrorFingerprint(error) {
6
+ const parts = [
7
+ error.name || 'UnknownError',
8
+ error.message || '',
9
+ extractRelevantStack(error.stack),
10
+ ];
11
+ return hashString(parts.join('|'));
12
+ }
13
+ /**
14
+ * Extracts the most relevant stack frame (first non-library frame).
15
+ */
16
+ function extractRelevantStack(stack) {
17
+ if (!stack)
18
+ return '';
19
+ const lines = stack.split('\n').filter((line) => line.trim().startsWith('at '));
20
+ const relevantLine = lines.find((line) => !line.includes('node_modules') &&
21
+ !line.includes('datadog-frontend-toolkit') &&
22
+ !line.includes('<anonymous>'));
23
+ return (relevantLine || lines[0] || '').trim();
24
+ }
25
+ /**
26
+ * Simple but fast string hash (djb2 algorithm).
27
+ * Produces a hex string fingerprint.
28
+ */
29
+ function hashString(str) {
30
+ let hash = 5381;
31
+ for (let i = 0; i < str.length; i++) {
32
+ hash = ((hash << 5) + hash + str.charCodeAt(i)) & 0xffffffff;
33
+ }
34
+ return (hash >>> 0).toString(16).padStart(8, '0');
35
+ }
36
+ /**
37
+ * Generates a session-unique ID.
38
+ */
39
+ export function generateId() {
40
+ const timestamp = Date.now().toString(36);
41
+ const random = Math.random().toString(36).substring(2, 10);
42
+ return `${timestamp}-${random}`;
43
+ }
44
+ //# sourceMappingURL=fingerprint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../src/utils/fingerprint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAY;IACnD,MAAM,KAAK,GAAa;QACtB,KAAK,CAAC,IAAI,IAAI,cAAc;QAC5B,KAAK,CAAC,OAAO,IAAI,EAAE;QACnB,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC;KAClC,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC9B,CAAC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAC1C,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAChC,CAAC;IAEF,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;AAClC,CAAC"}
@@ -0,0 +1,32 @@
1
+ const DEFAULT_OPTIONS = {
2
+ maxAttempts: 3,
3
+ baseDelay: 1000,
4
+ maxDelay: 30000,
5
+ backoffMultiplier: 2,
6
+ };
7
+ export async function withRetry(fn, options = {}) {
8
+ const config = { ...DEFAULT_OPTIONS, ...options };
9
+ let lastError;
10
+ for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {
11
+ try {
12
+ return await fn();
13
+ }
14
+ catch (error) {
15
+ lastError = error;
16
+ if (attempt === config.maxAttempts) {
17
+ break;
18
+ }
19
+ if (config.shouldRetry && !config.shouldRetry(error, attempt)) {
20
+ break;
21
+ }
22
+ const delay = Math.min(config.baseDelay * Math.pow(config.backoffMultiplier, attempt - 1), config.maxDelay);
23
+ const jitter = delay * (0.5 + Math.random() * 0.5);
24
+ await sleep(jitter);
25
+ }
26
+ }
27
+ throw lastError;
28
+ }
29
+ function sleep(ms) {
30
+ return new Promise((resolve) => setTimeout(resolve, ms));
31
+ }
32
+ //# sourceMappingURL=retry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/utils/retry.ts"],"names":[],"mappings":"AAQA,MAAM,eAAe,GAAiB;IACpC,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK;IACf,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAClD,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAElB,IAAI,OAAO,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;gBACnC,MAAM;YACR,CAAC;YAED,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC9D,MAAM;YACR,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,GAAG,CAAC,CAAC,EAClE,MAAM,CAAC,QAAQ,CAChB,CAAC;YACF,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,102 @@
1
+ const DEFAULT_PII_PATTERNS = [
2
+ /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g, // emails
3
+ /\b\d{3}[-.]?\d{3}[-.]?\d{4}\b/g, // phone numbers
4
+ /\b\d{4}[- ]?\d{4}[- ]?\d{4}[- ]?\d{4}\b/g, // credit cards
5
+ /\b\d{3}-\d{2}-\d{4}\b/g, // SSN
6
+ ];
7
+ const DEFAULT_SENSITIVE_KEYS = [
8
+ 'password', 'passwd', 'secret', 'token', 'apikey', 'api_key',
9
+ 'authorization', 'auth', 'credential', 'private_key', 'privatekey',
10
+ 'access_token', 'refresh_token', 'ssn', 'credit_card', 'creditcard',
11
+ 'cvv', 'pin', 'otp',
12
+ ];
13
+ const REDACTED = '[REDACTED]';
14
+ const MAX_DEPTH = 10;
15
+ const MAX_STRING_LENGTH = 10000;
16
+ const MAX_ARRAY_LENGTH = 100;
17
+ export class Sanitizer {
18
+ piiPatterns;
19
+ sensitiveKeys;
20
+ maxDepth;
21
+ maxStringLength;
22
+ constructor(piiFields = [], maxDepth = MAX_DEPTH, maxStringLength = MAX_STRING_LENGTH) {
23
+ this.sensitiveKeys = new Set([
24
+ ...DEFAULT_SENSITIVE_KEYS,
25
+ ...piiFields.map((f) => f.toLowerCase()),
26
+ ]);
27
+ this.piiPatterns = [...DEFAULT_PII_PATTERNS];
28
+ this.maxDepth = maxDepth;
29
+ this.maxStringLength = maxStringLength;
30
+ }
31
+ sanitize(data) {
32
+ return this.deepSanitize(data, 0, new WeakSet());
33
+ }
34
+ sanitizeString(value) {
35
+ let result = value;
36
+ for (const pattern of this.piiPatterns) {
37
+ const cloned = new RegExp(pattern.source, pattern.flags);
38
+ result = result.replace(cloned, REDACTED);
39
+ }
40
+ return this.truncateString(result);
41
+ }
42
+ deepSanitize(value, depth, seen) {
43
+ if (depth > this.maxDepth) {
44
+ return '[MAX_DEPTH_EXCEEDED]';
45
+ }
46
+ if (value === null || value === undefined) {
47
+ return value;
48
+ }
49
+ if (typeof value === 'string') {
50
+ return this.sanitizeString(value);
51
+ }
52
+ if (typeof value === 'number' || typeof value === 'boolean') {
53
+ return value;
54
+ }
55
+ if (value instanceof Date) {
56
+ return value.toISOString();
57
+ }
58
+ if (value instanceof Error) {
59
+ return this.sanitizeError(value, depth, seen);
60
+ }
61
+ if (Array.isArray(value)) {
62
+ const limited = value.slice(0, MAX_ARRAY_LENGTH);
63
+ return limited.map((item) => this.deepSanitize(item, depth + 1, seen));
64
+ }
65
+ if (typeof value === 'object') {
66
+ if (seen.has(value)) {
67
+ return '[CIRCULAR_REFERENCE]';
68
+ }
69
+ seen.add(value);
70
+ const sanitized = {};
71
+ for (const [key, val] of Object.entries(value)) {
72
+ if (this.isSensitiveKey(key)) {
73
+ sanitized[key] = REDACTED;
74
+ }
75
+ else {
76
+ sanitized[key] = this.deepSanitize(val, depth + 1, seen);
77
+ }
78
+ }
79
+ return sanitized;
80
+ }
81
+ return String(value);
82
+ }
83
+ sanitizeError(error, depth, seen) {
84
+ return {
85
+ name: error.name,
86
+ message: this.sanitizeString(error.message),
87
+ stack: error.stack ? this.sanitizeString(error.stack) : undefined,
88
+ cause: error.cause ? this.deepSanitize(error.cause, depth + 1, seen) : undefined,
89
+ };
90
+ }
91
+ isSensitiveKey(key) {
92
+ const lower = key.toLowerCase();
93
+ return this.sensitiveKeys.has(lower) || this.sensitiveKeys.has(lower.replace(/[-_]/g, ''));
94
+ }
95
+ truncateString(value) {
96
+ if (value.length <= this.maxStringLength) {
97
+ return value;
98
+ }
99
+ return value.substring(0, this.maxStringLength) + `... [truncated, total: ${value.length}]`;
100
+ }
101
+ }
102
+ //# sourceMappingURL=sanitizer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAa;IACrC,sDAAsD,EAAE,SAAS;IACjE,gCAAgC,EAAE,gBAAgB;IAClD,0CAA0C,EAAE,eAAe;IAC3D,wBAAwB,EAAE,MAAM;CACjC,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS;IAC5D,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY;IAClE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY;IACnE,KAAK,EAAE,KAAK,EAAE,KAAK;CACpB,CAAC;AAEF,MAAM,QAAQ,GAAG,YAAY,CAAC;AAC9B,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,MAAM,OAAO,SAAS;IACH,WAAW,CAAW;IACtB,aAAa,CAAc;IAC3B,QAAQ,CAAS;IACjB,eAAe,CAAS;IAEzC,YACE,YAAsB,EAAE,EACxB,WAAmB,SAAS,EAC5B,kBAA0B,iBAAiB;QAE3C,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC;YAC3B,GAAG,sBAAsB;YACzB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,QAAQ,CAAI,IAAO;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,OAAO,EAAE,CAAM,CAAC;IACxD,CAAC;IAED,cAAc,CAAC,KAAa;QAC1B,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,YAAY,CAAC,KAAc,EAAE,KAAa,EAAE,IAAqB;QACvE,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,EAAE,CAAC;gBAC9B,OAAO,sBAAsB,CAAC;YAChC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;YAE1B,MAAM,SAAS,GAA4B,EAAE,CAAC;YAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBAC1E,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7B,SAAS,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAEO,aAAa,CACnB,KAAY,EACZ,KAAa,EACb,IAAqB;QAErB,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SACjF,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,GAAW;QAChC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,0BAA0B,KAAK,CAAC,MAAM,GAAG,CAAC;IAC9F,CAAC;CACF"}
@@ -0,0 +1,95 @@
1
+ const STORAGE_PREFIX = 'dd_toolkit_';
2
+ /**
3
+ * Safe localStorage wrapper that handles SSR, private browsing,
4
+ * and storage quota exceeded scenarios.
5
+ */
6
+ export class StorageManager {
7
+ prefix;
8
+ memoryFallback;
9
+ useMemory;
10
+ constructor(prefix = STORAGE_PREFIX) {
11
+ this.prefix = prefix;
12
+ this.memoryFallback = new Map();
13
+ this.useMemory = !this.isLocalStorageAvailable();
14
+ }
15
+ get(key, defaultValue) {
16
+ try {
17
+ const raw = this.useMemory
18
+ ? this.memoryFallback.get(this.prefixKey(key))
19
+ : localStorage.getItem(this.prefixKey(key));
20
+ if (raw === null || raw === undefined) {
21
+ return defaultValue;
22
+ }
23
+ return JSON.parse(raw);
24
+ }
25
+ catch {
26
+ return defaultValue;
27
+ }
28
+ }
29
+ set(key, value) {
30
+ try {
31
+ const serialized = JSON.stringify(value);
32
+ if (this.useMemory) {
33
+ this.memoryFallback.set(this.prefixKey(key), serialized);
34
+ }
35
+ else {
36
+ localStorage.setItem(this.prefixKey(key), serialized);
37
+ }
38
+ }
39
+ catch {
40
+ // Storage full or unavailable — fallback silently
41
+ this.useMemory = true;
42
+ this.memoryFallback.set(this.prefixKey(key), JSON.stringify(value));
43
+ }
44
+ }
45
+ remove(key) {
46
+ try {
47
+ if (this.useMemory) {
48
+ this.memoryFallback.delete(this.prefixKey(key));
49
+ }
50
+ else {
51
+ localStorage.removeItem(this.prefixKey(key));
52
+ }
53
+ }
54
+ catch {
55
+ this.memoryFallback.delete(this.prefixKey(key));
56
+ }
57
+ }
58
+ clear() {
59
+ try {
60
+ if (this.useMemory) {
61
+ this.memoryFallback.clear();
62
+ return;
63
+ }
64
+ const keys = [];
65
+ for (let i = 0; i < localStorage.length; i++) {
66
+ const key = localStorage.key(i);
67
+ if (key?.startsWith(this.prefix)) {
68
+ keys.push(key);
69
+ }
70
+ }
71
+ keys.forEach((key) => localStorage.removeItem(key));
72
+ }
73
+ catch {
74
+ this.memoryFallback.clear();
75
+ }
76
+ }
77
+ prefixKey(key) {
78
+ return `${this.prefix}${key}`;
79
+ }
80
+ isLocalStorageAvailable() {
81
+ try {
82
+ if (typeof window === 'undefined' || !window.localStorage) {
83
+ return false;
84
+ }
85
+ const testKey = `${this.prefix}__test__`;
86
+ localStorage.setItem(testKey, 'test');
87
+ localStorage.removeItem(testKey);
88
+ return true;
89
+ }
90
+ catch {
91
+ return false;
92
+ }
93
+ }
94
+ }
95
+ //# sourceMappingURL=storage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/utils/storage.ts"],"names":[],"mappings":"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"}