@tracelog/lib 0.6.1 → 0.6.4
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 +8 -8
- package/dist/browser/tracelog.esm.js +579 -571
- package/dist/browser/tracelog.esm.js.map +1 -1
- package/dist/browser/tracelog.js +2 -2
- package/dist/browser/tracelog.js.map +1 -1
- package/dist/cjs/api.d.ts +1 -1
- package/dist/cjs/api.js +1 -1
- package/dist/cjs/app.d.ts +1 -1
- package/dist/cjs/app.js +4 -4
- 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/sender.manager.js +4 -5
- 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 +2 -2
- package/dist/cjs/types/index.d.ts +1 -0
- package/dist/cjs/types/index.js +1 -0
- package/dist/cjs/types/state.types.d.ts +1 -1
- package/dist/cjs/types/tag.types.d.ts +43 -0
- package/dist/cjs/types/tag.types.js +31 -0
- package/dist/cjs/types/test-bridge.types.d.ts +1 -1
- package/dist/cjs/utils/network/url.utils.d.ts +1 -1
- package/dist/cjs/utils/network/url.utils.js +10 -10
- package/dist/cjs/utils/validations/config-validations.utils.d.ts +2 -2
- package/dist/cjs/utils/validations/config-validations.utils.js +16 -13
- package/dist/esm/api.d.ts +1 -1
- package/dist/esm/api.js +1 -1
- package/dist/esm/app.d.ts +1 -1
- package/dist/esm/app.js +5 -5
- 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/sender.manager.js +4 -5
- 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 +2 -2
- package/dist/esm/types/index.d.ts +1 -0
- package/dist/esm/types/index.js +1 -0
- package/dist/esm/types/state.types.d.ts +1 -1
- package/dist/esm/types/tag.types.d.ts +43 -0
- package/dist/esm/types/tag.types.js +28 -0
- package/dist/esm/types/test-bridge.types.d.ts +1 -1
- package/dist/esm/utils/network/url.utils.d.ts +1 -1
- package/dist/esm/utils/network/url.utils.js +8 -8
- package/dist/esm/utils/validations/config-validations.utils.d.ts +2 -2
- package/dist/esm/utils/validations/config-validations.utils.js +16 -13
- package/package.json +6 -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
|
|
|
@@ -148,7 +148,7 @@ await tracelog.init({
|
|
|
148
148
|
- `scrollContainerSelectors`: Custom scroll containers
|
|
149
149
|
- `integrations`:
|
|
150
150
|
- `tracelog.projectId`: TraceLog SaaS
|
|
151
|
-
- `custom.
|
|
151
|
+
- `custom.collectApiUrl`: Custom backend
|
|
152
152
|
- `custom.allowHttp`: Enable HTTP for testing
|
|
153
153
|
- `googleAnalytics.measurementId`: GA4
|
|
154
154
|
|
|
@@ -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
|
```
|