@tracelog/lib 0.6.0 → 0.6.3
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/README.md +9 -9
- package/dist/browser/tracelog.esm.js +406 -304
- package/dist/browser/tracelog.esm.js.map +1 -0
- package/dist/browser/tracelog.js +2 -2
- package/dist/browser/tracelog.js.map +1 -0
- package/dist/cjs/api.d.ts +1 -1
- package/dist/cjs/api.js +13 -4
- package/dist/cjs/app.d.ts +1 -1
- package/dist/cjs/app.js +4 -4
- package/dist/cjs/constants/config.constants.d.ts +3 -0
- package/dist/cjs/constants/config.constants.js +5 -2
- package/dist/cjs/handlers/click.handler.js +2 -2
- package/dist/cjs/handlers/scroll.handler.js +1 -1
- package/dist/cjs/handlers/session.handler.js +1 -1
- package/dist/cjs/managers/event.manager.d.ts +3 -0
- package/dist/cjs/managers/event.manager.js +47 -6
- package/dist/cjs/managers/sender.manager.js +4 -5
- package/dist/cjs/managers/storage.manager.d.ts +5 -0
- package/dist/cjs/managers/storage.manager.js +95 -6
- package/dist/cjs/public-api.d.ts +1 -1
- package/dist/cjs/test-bridge.d.ts +1 -1
- package/dist/cjs/test-bridge.js +1 -1
- package/dist/cjs/types/config.types.d.ts +4 -4
- package/dist/cjs/types/state.types.d.ts +1 -1
- package/dist/cjs/types/test-bridge.types.d.ts +1 -1
- package/dist/cjs/utils/logging.utils.d.ts +16 -1
- package/dist/cjs/utils/logging.utils.js +65 -4
- package/dist/cjs/utils/network/url.utils.d.ts +1 -1
- package/dist/cjs/utils/network/url.utils.js +11 -12
- package/dist/cjs/utils/validations/config-validations.utils.d.ts +2 -2
- package/dist/cjs/utils/validations/config-validations.utils.js +30 -18
- package/dist/esm/api.d.ts +1 -1
- package/dist/esm/api.js +13 -4
- package/dist/esm/app.d.ts +1 -1
- package/dist/esm/app.js +5 -5
- package/dist/esm/constants/config.constants.d.ts +3 -0
- package/dist/esm/constants/config.constants.js +3 -0
- package/dist/esm/handlers/click.handler.js +2 -2
- package/dist/esm/handlers/scroll.handler.js +1 -1
- package/dist/esm/handlers/session.handler.js +1 -1
- package/dist/esm/managers/event.manager.d.ts +3 -0
- package/dist/esm/managers/event.manager.js +48 -7
- package/dist/esm/managers/sender.manager.js +4 -5
- package/dist/esm/managers/storage.manager.d.ts +5 -0
- package/dist/esm/managers/storage.manager.js +95 -6
- package/dist/esm/public-api.d.ts +1 -1
- package/dist/esm/test-bridge.d.ts +1 -1
- package/dist/esm/test-bridge.js +1 -1
- package/dist/esm/types/config.types.d.ts +4 -4
- package/dist/esm/types/state.types.d.ts +1 -1
- package/dist/esm/types/test-bridge.types.d.ts +1 -1
- package/dist/esm/utils/logging.utils.d.ts +16 -1
- package/dist/esm/utils/logging.utils.js +65 -4
- package/dist/esm/utils/network/url.utils.d.ts +1 -1
- package/dist/esm/utils/network/url.utils.js +9 -10
- package/dist/esm/utils/validations/config-validations.utils.d.ts +2 -2
- package/dist/esm/utils/validations/config-validations.utils.js +30 -18
- package/package.json +7 -6
package/README.md
CHANGED
|
@@ -35,7 +35,7 @@ npm install @tracelog/lib
|
|
|
35
35
|
import { tracelog } from '@tracelog/lib';
|
|
36
36
|
|
|
37
37
|
// Standalone mode (no backend required)
|
|
38
|
-
tracelog.init(
|
|
38
|
+
tracelog.init();
|
|
39
39
|
|
|
40
40
|
// OR with TraceLog SaaS integration
|
|
41
41
|
tracelog.init({
|
|
@@ -56,7 +56,7 @@ tracelog.event('user_action', { data: 'example' });
|
|
|
56
56
|
<script src="https://cdn.jsdelivr.net/npm/@tracelog/lib@latest/dist/browser/tracelog.js"></script>
|
|
57
57
|
<script>
|
|
58
58
|
// Standalone mode
|
|
59
|
-
tracelog.init(
|
|
59
|
+
tracelog.init();
|
|
60
60
|
|
|
61
61
|
// OR with TraceLog SaaS
|
|
62
62
|
tracelog.init({
|
|
@@ -76,7 +76,7 @@ tracelog.event('user_action', { data: 'example' });
|
|
|
76
76
|
<script type="module">
|
|
77
77
|
import { tracelog } from 'https://cdn.jsdelivr.net/npm/@tracelog/lib@latest/dist/browser/tracelog.esm.js';
|
|
78
78
|
|
|
79
|
-
await tracelog.init(
|
|
79
|
+
await tracelog.init(); // Standalone mode
|
|
80
80
|
tracelog.event('page_view');
|
|
81
81
|
</script>
|
|
82
82
|
```
|
|
@@ -110,7 +110,7 @@ await tracelog.init({
|
|
|
110
110
|
// With custom backend
|
|
111
111
|
await tracelog.init({
|
|
112
112
|
integrations: {
|
|
113
|
-
custom: {
|
|
113
|
+
custom: { collectApiUrl: 'https://your-api.com/collect' }
|
|
114
114
|
}
|
|
115
115
|
});
|
|
116
116
|
|
|
@@ -145,11 +145,11 @@ await tracelog.init({
|
|
|
145
145
|
- `samplingRate`: Event sampling rate 0-1 (default: 1.0)
|
|
146
146
|
- `errorSampling`: Error sampling rate 0-1 (default: 1.0)
|
|
147
147
|
- `sensitiveQueryParams`: Query params to remove from URLs
|
|
148
|
-
- `allowHttp`: Enable HTTP for testing
|
|
149
148
|
- `scrollContainerSelectors`: Custom scroll containers
|
|
150
149
|
- `integrations`:
|
|
151
150
|
- `tracelog.projectId`: TraceLog SaaS
|
|
152
|
-
- `custom.
|
|
151
|
+
- `custom.collectApiUrl`: Custom backend
|
|
152
|
+
- `custom.allowHttp`: Enable HTTP for testing
|
|
153
153
|
- `googleAnalytics.measurementId`: GA4
|
|
154
154
|
|
|
155
155
|
## Event Data Structure
|
|
@@ -211,7 +211,7 @@ Each event contains a base structure with type-specific data:
|
|
|
211
211
|
tracelog.on('event', (data) => console.log('Event:', data.type));
|
|
212
212
|
tracelog.on('queue', (data) => console.log('Queued:', data.events.length));
|
|
213
213
|
|
|
214
|
-
await tracelog.init(
|
|
214
|
+
await tracelog.init();
|
|
215
215
|
```
|
|
216
216
|
|
|
217
217
|
**Note**: Listeners are buffered if registered before `init()`, ensuring you don't miss initial events.
|
|
@@ -243,7 +243,7 @@ window.__traceLogDisabled = true;
|
|
|
243
243
|
Enable QA mode: `?tlog_mode=qa` URL parameter
|
|
244
244
|
|
|
245
245
|
```typescript
|
|
246
|
-
tracelog.init(
|
|
246
|
+
tracelog.init();
|
|
247
247
|
console.log(tracelog.isInitialized()); // true
|
|
248
248
|
```
|
|
249
249
|
|
|
@@ -278,7 +278,7 @@ npm run test:coverage # Run tests with coverage
|
|
|
278
278
|
## Testing
|
|
279
279
|
|
|
280
280
|
```bash
|
|
281
|
-
npm run
|
|
281
|
+
npm run docs:dev # Demo at localhost:3000
|
|
282
282
|
npm run test:unit # Unit tests
|
|
283
283
|
npm run test:e2e # E2E tests
|
|
284
284
|
```
|