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.
- package/LICENSE +21 -0
- package/README.md +486 -0
- package/dist/cjs/context/ContextManager.js +197 -0
- package/dist/cjs/context/ContextManager.js.map +1 -0
- package/dist/cjs/core/BootstrapGuard.js +81 -0
- package/dist/cjs/core/BootstrapGuard.js.map +1 -0
- package/dist/cjs/core/ConfigManager.js +133 -0
- package/dist/cjs/core/ConfigManager.js.map +1 -0
- package/dist/cjs/core/ObservabilitySDK.js +355 -0
- package/dist/cjs/core/ObservabilitySDK.js.map +1 -0
- package/dist/cjs/errors/ErrorBoundary.js +187 -0
- package/dist/cjs/errors/ErrorBoundary.js.map +1 -0
- package/dist/cjs/index.js +110 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/logger/LoggerService.js +256 -0
- package/dist/cjs/logger/LoggerService.js.map +1 -0
- package/dist/cjs/logs/LogsManager.js +112 -0
- package/dist/cjs/logs/LogsManager.js.map +1 -0
- package/dist/cjs/network/NetworkInterceptor.js +185 -0
- package/dist/cjs/network/NetworkInterceptor.js.map +1 -0
- package/dist/cjs/performance/PerformanceMonitor.js +290 -0
- package/dist/cjs/performance/PerformanceMonitor.js.map +1 -0
- package/dist/cjs/resources/ResourceProvisioner.js +210 -0
- package/dist/cjs/resources/ResourceProvisioner.js.map +1 -0
- package/dist/cjs/resources/templates/dashboard.js +333 -0
- package/dist/cjs/resources/templates/dashboard.js.map +1 -0
- package/dist/cjs/resources/templates/monitors.js +120 -0
- package/dist/cjs/resources/templates/monitors.js.map +1 -0
- package/dist/cjs/resources/templates/slos.js +79 -0
- package/dist/cjs/resources/templates/slos.js.map +1 -0
- package/dist/cjs/rum/RumManager.js +164 -0
- package/dist/cjs/rum/RumManager.js.map +1 -0
- package/dist/cjs/types/config.js +13 -0
- package/dist/cjs/types/config.js.map +1 -0
- package/dist/cjs/types/events.js +26 -0
- package/dist/cjs/types/events.js.map +1 -0
- package/dist/cjs/types/index.js +20 -0
- package/dist/cjs/types/index.js.map +1 -0
- package/dist/cjs/types/logger.js +13 -0
- package/dist/cjs/types/logger.js.map +1 -0
- package/dist/cjs/utils/EventEmitter.js +49 -0
- package/dist/cjs/utils/EventEmitter.js.map +1 -0
- package/dist/cjs/utils/fingerprint.js +48 -0
- package/dist/cjs/utils/fingerprint.js.map +1 -0
- package/dist/cjs/utils/retry.js +35 -0
- package/dist/cjs/utils/retry.js.map +1 -0
- package/dist/cjs/utils/sanitizer.js +106 -0
- package/dist/cjs/utils/sanitizer.js.map +1 -0
- package/dist/cjs/utils/storage.js +99 -0
- package/dist/cjs/utils/storage.js.map +1 -0
- package/dist/cli/commands/setup.js +178 -0
- package/dist/cli/commands/setup.js.map +1 -0
- package/dist/cli/commands/status.js +103 -0
- package/dist/cli/commands/status.js.map +1 -0
- package/dist/cli/index.js +111 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/prompt.js +140 -0
- package/dist/cli/prompt.js.map +1 -0
- package/dist/esm/context/ContextManager.js +193 -0
- package/dist/esm/context/ContextManager.js.map +1 -0
- package/dist/esm/core/BootstrapGuard.js +77 -0
- package/dist/esm/core/BootstrapGuard.js.map +1 -0
- package/dist/esm/core/ConfigManager.js +129 -0
- package/dist/esm/core/ConfigManager.js.map +1 -0
- package/dist/esm/core/ObservabilitySDK.js +351 -0
- package/dist/esm/core/ObservabilitySDK.js.map +1 -0
- package/dist/esm/errors/ErrorBoundary.js +183 -0
- package/dist/esm/errors/ErrorBoundary.js.map +1 -0
- package/dist/esm/index.js +87 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/logger/LoggerService.js +251 -0
- package/dist/esm/logger/LoggerService.js.map +1 -0
- package/dist/esm/logs/LogsManager.js +108 -0
- package/dist/esm/logs/LogsManager.js.map +1 -0
- package/dist/esm/network/NetworkInterceptor.js +181 -0
- package/dist/esm/network/NetworkInterceptor.js.map +1 -0
- package/dist/esm/performance/PerformanceMonitor.js +286 -0
- package/dist/esm/performance/PerformanceMonitor.js.map +1 -0
- package/dist/esm/resources/ResourceProvisioner.js +206 -0
- package/dist/esm/resources/ResourceProvisioner.js.map +1 -0
- package/dist/esm/resources/templates/dashboard.js +330 -0
- package/dist/esm/resources/templates/dashboard.js.map +1 -0
- package/dist/esm/resources/templates/monitors.js +117 -0
- package/dist/esm/resources/templates/monitors.js.map +1 -0
- package/dist/esm/resources/templates/slos.js +76 -0
- package/dist/esm/resources/templates/slos.js.map +1 -0
- package/dist/esm/rum/RumManager.js +160 -0
- package/dist/esm/rum/RumManager.js.map +1 -0
- package/dist/esm/types/config.js +10 -0
- package/dist/esm/types/config.js.map +1 -0
- package/dist/esm/types/events.js +23 -0
- package/dist/esm/types/events.js.map +1 -0
- package/dist/esm/types/index.js +4 -0
- package/dist/esm/types/index.js.map +1 -0
- package/dist/esm/types/logger.js +10 -0
- package/dist/esm/types/logger.js.map +1 -0
- package/dist/esm/utils/EventEmitter.js +45 -0
- package/dist/esm/utils/EventEmitter.js.map +1 -0
- package/dist/esm/utils/fingerprint.js +44 -0
- package/dist/esm/utils/fingerprint.js.map +1 -0
- package/dist/esm/utils/retry.js +32 -0
- package/dist/esm/utils/retry.js.map +1 -0
- package/dist/esm/utils/sanitizer.js +102 -0
- package/dist/esm/utils/sanitizer.js.map +1 -0
- package/dist/esm/utils/storage.js +95 -0
- package/dist/esm/utils/storage.js.map +1 -0
- package/dist/resources/ResourceProvisioner.js +207 -0
- package/dist/resources/ResourceProvisioner.js.map +1 -0
- package/dist/resources/templates/dashboard.js +333 -0
- package/dist/resources/templates/dashboard.js.map +1 -0
- package/dist/resources/templates/monitors.js +120 -0
- package/dist/resources/templates/monitors.js.map +1 -0
- package/dist/resources/templates/slos.js +79 -0
- package/dist/resources/templates/slos.js.map +1 -0
- package/dist/types/config.js +13 -0
- package/dist/types/config.js.map +1 -0
- package/dist/types/context/ContextManager.d.ts +63 -0
- package/dist/types/context/ContextManager.d.ts.map +1 -0
- package/dist/types/core/BootstrapGuard.d.ts +46 -0
- package/dist/types/core/BootstrapGuard.d.ts.map +1 -0
- package/dist/types/core/ConfigManager.d.ts +13 -0
- package/dist/types/core/ConfigManager.d.ts.map +1 -0
- package/dist/types/core/ObservabilitySDK.d.ts +141 -0
- package/dist/types/core/ObservabilitySDK.d.ts.map +1 -0
- package/dist/types/errors/ErrorBoundary.d.ts +55 -0
- package/dist/types/errors/ErrorBoundary.d.ts.map +1 -0
- package/dist/types/events.js +26 -0
- package/dist/types/events.js.map +1 -0
- package/dist/types/index.d.ts +75 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +20 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/logger/LoggerService.d.ts +104 -0
- package/dist/types/logger/LoggerService.d.ts.map +1 -0
- package/dist/types/logger.js +13 -0
- package/dist/types/logger.js.map +1 -0
- package/dist/types/logs/LogsManager.d.ts +41 -0
- package/dist/types/logs/LogsManager.d.ts.map +1 -0
- package/dist/types/network/NetworkInterceptor.d.ts +35 -0
- package/dist/types/network/NetworkInterceptor.d.ts.map +1 -0
- package/dist/types/performance/PerformanceMonitor.d.ts +44 -0
- package/dist/types/performance/PerformanceMonitor.d.ts.map +1 -0
- package/dist/types/resources/ResourceProvisioner.d.ts +46 -0
- package/dist/types/resources/ResourceProvisioner.d.ts.map +1 -0
- package/dist/types/resources/templates/dashboard.d.ts +6 -0
- package/dist/types/resources/templates/dashboard.d.ts.map +1 -0
- package/dist/types/resources/templates/monitors.d.ts +11 -0
- package/dist/types/resources/templates/monitors.d.ts.map +1 -0
- package/dist/types/resources/templates/slos.d.ts +18 -0
- package/dist/types/resources/templates/slos.d.ts.map +1 -0
- package/dist/types/rum/RumManager.d.ts +70 -0
- package/dist/types/rum/RumManager.d.ts.map +1 -0
- package/dist/types/types/config.d.ts +271 -0
- package/dist/types/types/config.d.ts.map +1 -0
- package/dist/types/types/events.d.ts +71 -0
- package/dist/types/types/events.d.ts.map +1 -0
- package/dist/types/types/index.d.ts +4 -0
- package/dist/types/types/index.d.ts.map +1 -0
- package/dist/types/types/logger.d.ts +102 -0
- package/dist/types/types/logger.d.ts.map +1 -0
- package/dist/types/utils/EventEmitter.d.ts +14 -0
- package/dist/types/utils/EventEmitter.d.ts.map +1 -0
- package/dist/types/utils/fingerprint.d.ts +10 -0
- package/dist/types/utils/fingerprint.d.ts.map +1 -0
- package/dist/types/utils/retry.d.ts +9 -0
- package/dist/types/utils/retry.d.ts.map +1 -0
- package/dist/types/utils/sanitizer.d.ts +14 -0
- package/dist/types/utils/sanitizer.d.ts.map +1 -0
- package/dist/types/utils/storage.d.ts +17 -0
- package/dist/types/utils/storage.d.ts.map +1 -0
- package/dist/utils/retry.js +35 -0
- package/dist/utils/retry.js.map +1 -0
- 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 @@
|
|
|
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":"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"}
|
|
@@ -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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"}
|