@xylabs/pixel 5.0.84 → 5.0.86

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 (2) hide show
  1. package/README.md +205 -697
  2. package/package.json +8 -8
package/README.md CHANGED
@@ -15,6 +15,8 @@
15
15
 
16
16
  Event Client for xylabs ESB
17
17
 
18
+
19
+
18
20
  ## Reference
19
21
 
20
22
  **@xylabs/pixel**
@@ -23,28 +25,34 @@ Event Client for xylabs ESB
23
25
 
24
26
  ## Classes
25
27
 
26
- - [PixelApi](#classes/PixelApi)
27
- - [XyPixel](#classes/XyPixel)
28
- - [Referrer](#classes/Referrer)
29
- - [UniqueUserId](#classes/UniqueUserId)
30
- - [UserEventHandler](#classes/UserEventHandler)
31
- - [UtmFields](#classes/UtmFields)
32
- - [XyUserEventHandler](#classes/XyUserEventHandler)
28
+ | Class | Description |
29
+ | ------ | ------ |
30
+ | [PixelApi](#classes/PixelApi) | HTTP client for sending tracking events to the XY Labs pixel API. |
31
+ | [XyPixel](#classes/XyPixel) | Singleton pixel tracker that queues and sends user events to the XY Labs tracking API. |
32
+ | [Referrer](#classes/Referrer) | Tracks and persists the document referrer in both session and local storage. |
33
+ | [UniqueUserId](#classes/UniqueUserId) | Generates and persists a unique user identifier in localStorage. |
34
+ | [UserEventHandler](#classes/UserEventHandler) | Abstract base class for handling user tracking events. |
35
+ | [UtmFields](#classes/UtmFields) | Tracks UTM campaign parameters from query strings, persisting history in localStorage. |
36
+ | [XyUserEventHandler](#classes/XyUserEventHandler) | Concrete event handler that sends tracking events through the XyPixel singleton. |
33
37
 
34
38
  ## Interfaces
35
39
 
36
- - [UserEvent](#interfaces/UserEvent)
37
- - [CommonFields](#interfaces/CommonFields)
38
- - [FunnelStartedFields](#interfaces/FunnelStartedFields)
39
- - [PurchaseFields](#interfaces/PurchaseFields)
40
- - [TestStartedFields](#interfaces/TestStartedFields)
41
- - [UserClickFields](#interfaces/UserClickFields)
42
- - [ViewContentFields](#interfaces/ViewContentFields)
43
- - [XyLabsTrackingEventJson](#interfaces/XyLabsTrackingEventJson)
40
+ | Interface | Description |
41
+ | ------ | ------ |
42
+ | [UserEvent](#interfaces/UserEvent) | Represents a single user tracking event to be sent to the pixel API. |
43
+ | [CommonFields](#interfaces/CommonFields) | Common fields shared across all tracking event types. |
44
+ | [FunnelStartedFields](#interfaces/FunnelStartedFields) | Fields for a funnel-started tracking event. |
45
+ | [PurchaseFields](#interfaces/PurchaseFields) | Fields for a purchase tracking event. |
46
+ | [TestStartedFields](#interfaces/TestStartedFields) | Fields for a test-started tracking event (e.g. A/B test). |
47
+ | [UserClickFields](#interfaces/UserClickFields) | Fields for a user click tracking event. |
48
+ | [ViewContentFields](#interfaces/ViewContentFields) | Fields for a view-content tracking event. |
49
+ | [XyLabsTrackingEventJson](#interfaces/XyLabsTrackingEventJson) | JSON structure for an XY Labs tracking event as stored or transmitted. |
44
50
 
45
51
  ## Type Aliases
46
52
 
47
- - [UserEventSystem](#type-aliases/UserEventSystem)
53
+ | Type Alias | Description |
54
+ | ------ | ------ |
55
+ | [UserEventSystem](#type-aliases/UserEventSystem) | Parsed browser/OS/engine information from the user agent string. |
48
56
 
49
57
  ### classes
50
58
 
@@ -61,14 +69,14 @@ HTTP client for sending tracking events to the XY Labs pixel API.
61
69
  ### Constructor
62
70
 
63
71
  ```ts
64
- new PixelApi(baseUri?): PixelApi;
72
+ new PixelApi(baseUri?: string): PixelApi;
65
73
  ```
66
74
 
67
75
  ### Parameters
68
76
 
69
- #### baseUri?
70
-
71
- `string` = `'prod'`
77
+ | Parameter | Type | Default value |
78
+ | ------ | ------ | ------ |
79
+ | `baseUri` | `string` | `'prod'` |
72
80
 
73
81
  ### Returns
74
82
 
@@ -79,18 +87,16 @@ new PixelApi(baseUri?): PixelApi;
79
87
  ### trackEvents()
80
88
 
81
89
  ```ts
82
- trackEvents(events): Promise<any>;
90
+ trackEvents(events: UserEvent[]): Promise<any>;
83
91
  ```
84
92
 
85
93
  Sends an array of user events to the tracking API.
86
94
 
87
95
  ### Parameters
88
96
 
89
- #### events
90
-
91
- [`UserEvent`](#../interfaces/UserEvent)[]
92
-
93
- The events to submit
97
+ | Parameter | Type | Description |
98
+ | ------ | ------ | ------ |
99
+ | `events` | [`UserEvent`](#../interfaces/UserEvent)[] | The events to submit |
94
100
 
95
101
  ### Returns
96
102
 
@@ -120,19 +126,10 @@ new Referrer(): Referrer;
120
126
 
121
127
  ## Properties
122
128
 
123
- ### local
124
-
125
- ```ts
126
- local: string;
127
- ```
128
-
129
- ***
130
-
131
- ### session
132
-
133
- ```ts
134
- session: string;
135
- ```
129
+ | Property | Type |
130
+ | ------ | ------ |
131
+ | <a id="local"></a> `local` | `string` |
132
+ | <a id="session"></a> `session` | `string` |
136
133
 
137
134
  ## Methods
138
135
 
@@ -181,11 +178,9 @@ new UniqueUserId(): UniqueUserId;
181
178
 
182
179
  ## Properties
183
180
 
184
- ### id
185
-
186
- ```ts
187
- id: string;
188
- ```
181
+ | Property | Type |
182
+ | ------ | ------ |
183
+ | <a id="id"></a> `id` | `string` |
189
184
 
190
185
  ## Methods
191
186
 
@@ -215,9 +210,9 @@ Abstract base class for handling user tracking events.
215
210
 
216
211
  ## Type Parameters
217
212
 
218
- ### TData
219
-
220
- `TData` *extends* `EmptyObject`
213
+ | Type Parameter |
214
+ | ------ |
215
+ | `TData` *extends* `EmptyObject` |
221
216
 
222
217
  ## Constructors
223
218
 
@@ -236,22 +231,22 @@ new UserEventHandler<TData>(): UserEventHandler<TData>;
236
231
  ### funnelStarted()
237
232
 
238
233
  ```ts
239
- abstract funnelStarted<T>(fields): Promisable<void>;
234
+ abstract funnelStarted<T>(fields: FunnelStartedFields | T): Promisable<void>;
240
235
  ```
241
236
 
242
237
  Tracks a funnel-started event.
243
238
 
244
239
  ### Type Parameters
245
240
 
246
- #### T
247
-
248
- `T` *extends* `object`
241
+ | Type Parameter |
242
+ | ------ |
243
+ | `T` *extends* `object` |
249
244
 
250
245
  ### Parameters
251
246
 
252
- #### fields
253
-
254
- [`FunnelStartedFields`](#../interfaces/FunnelStartedFields) | `T`
247
+ | Parameter | Type |
248
+ | ------ | ------ |
249
+ | `fields` | [`FunnelStartedFields`](#../interfaces/FunnelStartedFields) \| `T` |
255
250
 
256
251
  ### Returns
257
252
 
@@ -262,22 +257,22 @@ Tracks a funnel-started event.
262
257
  ### testStarted()
263
258
 
264
259
  ```ts
265
- abstract testStarted<T>(fields): Promisable<void>;
260
+ abstract testStarted<T>(fields: TestStartedFields | T): Promisable<void>;
266
261
  ```
267
262
 
268
263
  Tracks a test-started event.
269
264
 
270
265
  ### Type Parameters
271
266
 
272
- #### T
273
-
274
- `T` *extends* `object`
267
+ | Type Parameter |
268
+ | ------ |
269
+ | `T` *extends* `object` |
275
270
 
276
271
  ### Parameters
277
272
 
278
- #### fields
279
-
280
- [`TestStartedFields`](#../interfaces/TestStartedFields) | `T`
273
+ | Parameter | Type |
274
+ | ------ | ------ |
275
+ | `fields` | [`TestStartedFields`](#../interfaces/TestStartedFields) \| `T` |
281
276
 
282
277
  ### Returns
283
278
 
@@ -288,22 +283,22 @@ Tracks a test-started event.
288
283
  ### userClick()
289
284
 
290
285
  ```ts
291
- abstract userClick<T>(fields): Promisable<void>;
286
+ abstract userClick<T>(fields: UserClickFields | T): Promisable<void>;
292
287
  ```
293
288
 
294
289
  Tracks a user click event.
295
290
 
296
291
  ### Type Parameters
297
292
 
298
- #### T
299
-
300
- `T` *extends* `object`
293
+ | Type Parameter |
294
+ | ------ |
295
+ | `T` *extends* `object` |
301
296
 
302
297
  ### Parameters
303
298
 
304
- #### fields
305
-
306
- [`UserClickFields`](#../interfaces/UserClickFields) | `T`
299
+ | Parameter | Type |
300
+ | ------ | ------ |
301
+ | `fields` | [`UserClickFields`](#../interfaces/UserClickFields) \| `T` |
307
302
 
308
303
  ### Returns
309
304
 
@@ -314,22 +309,22 @@ Tracks a user click event.
314
309
  ### viewContent()
315
310
 
316
311
  ```ts
317
- abstract viewContent<T>(fields): Promisable<void>;
312
+ abstract viewContent<T>(fields: T | ViewContentFields): Promisable<void>;
318
313
  ```
319
314
 
320
315
  Tracks a view-content event.
321
316
 
322
317
  ### Type Parameters
323
318
 
324
- #### T
325
-
326
- `T` *extends* `object`
319
+ | Type Parameter |
320
+ | ------ |
321
+ | `T` *extends* `object` |
327
322
 
328
323
  ### Parameters
329
324
 
330
- #### fields
331
-
332
- `T` | [`ViewContentFields`](#../interfaces/ViewContentFields)
325
+ | Parameter | Type |
326
+ | ------ | ------ |
327
+ | `fields` | `T` \| [`ViewContentFields`](#../interfaces/ViewContentFields) |
333
328
 
334
329
  ### Returns
335
330
 
@@ -357,11 +352,9 @@ new UtmFields(): UtmFields;
357
352
 
358
353
  ## Properties
359
354
 
360
- ### fields
361
-
362
- ```ts
363
- fields: Record<string, string>[] = [];
364
- ```
355
+ | Property | Type | Default value |
356
+ | ------ | ------ | ------ |
357
+ | <a id="fields"></a> `fields` | `Record`\<`string`, `string`\>[] | `[]` |
365
358
 
366
359
  ## Methods
367
360
 
@@ -419,59 +412,15 @@ Singleton pixel tracker that queues and sends user events to the XY Labs trackin
419
412
 
420
413
  ## Properties
421
414
 
422
- ### api
423
-
424
- ```ts
425
- static api: PixelApi;
426
- ```
427
-
428
- ***
429
-
430
- ### cid
431
-
432
- ```ts
433
- cid: string;
434
- ```
435
-
436
- ***
437
-
438
- ### email?
439
-
440
- ```ts
441
- optional email: string;
442
- ```
443
-
444
- ***
445
-
446
- ### email\_hash?
447
-
448
- ```ts
449
- optional email_hash: string | null;
450
- ```
451
-
452
- ***
453
-
454
- ### exids?
455
-
456
- ```ts
457
- optional exids: ExIds;
458
- ```
459
-
460
- ***
461
-
462
- ### pixelId?
463
-
464
- ```ts
465
- optional pixelId: string;
466
- ```
467
-
468
- ***
469
-
470
- ### queue
471
-
472
- ```ts
473
- queue: UserEvent[] = [];
474
- ```
415
+ | Property | Modifier | Type | Default value |
416
+ | ------ | ------ | ------ | ------ |
417
+ | <a id="api"></a> `api` | `static` | [`PixelApi`](#PixelApi) | `undefined` |
418
+ | <a id="cid"></a> `cid` | `public` | `string` | `undefined` |
419
+ | <a id="email"></a> `email?` | `public` | `string` | `undefined` |
420
+ | <a id="email_hash"></a> `email_hash?` | `public` | `string` \| `null` | `undefined` |
421
+ | <a id="exids"></a> `exids?` | `public` | `ExIds` | `undefined` |
422
+ | <a id="pixelid"></a> `pixelId?` | `public` | `string` | `undefined` |
423
+ | <a id="queue"></a> `queue` | `public` | [`UserEvent`](#../interfaces/UserEvent)[] | `[]` |
475
424
 
476
425
  ## Accessors
477
426
 
@@ -494,18 +443,16 @@ Returns the singleton XyPixel instance, throwing if not yet initialized.
494
443
  ### init()
495
444
 
496
445
  ```ts
497
- static init(pixelId): XyPixel;
446
+ static init(pixelId: string): XyPixel;
498
447
  ```
499
448
 
500
449
  Initializes the XyPixel singleton with the given pixel ID.
501
450
 
502
451
  ### Parameters
503
452
 
504
- #### pixelId
505
-
506
- `string`
507
-
508
- The pixel identifier for this tracking instance
453
+ | Parameter | Type | Description |
454
+ | ------ | ------ | ------ |
455
+ | `pixelId` | `string` | The pixel identifier for this tracking instance |
509
456
 
510
457
  ### Returns
511
458
 
@@ -518,18 +465,16 @@ The newly created XyPixel instance
518
465
  ### selectApi()
519
466
 
520
467
  ```ts
521
- static selectApi(api): void;
468
+ static selectApi(api: PixelApi): void;
522
469
  ```
523
470
 
524
471
  Replaces the default PixelApi instance used for sending events.
525
472
 
526
473
  ### Parameters
527
474
 
528
- #### api
529
-
530
- [`PixelApi`](#PixelApi)
531
-
532
- The PixelApi instance to use
475
+ | Parameter | Type | Description |
476
+ | ------ | ------ | ------ |
477
+ | `api` | [`PixelApi`](#PixelApi) | The PixelApi instance to use |
533
478
 
534
479
  ### Returns
535
480
 
@@ -540,18 +485,16 @@ The PixelApi instance to use
540
485
  ### identify()
541
486
 
542
487
  ```ts
543
- identify(email?): void;
488
+ identify(email?: string): void;
544
489
  ```
545
490
 
546
491
  Associates an email address with this pixel instance, hashing it for privacy.
547
492
 
548
493
  ### Parameters
549
494
 
550
- #### email?
551
-
552
- `string`
553
-
554
- The email address to identify the user with
495
+ | Parameter | Type | Description |
496
+ | ------ | ------ | ------ |
497
+ | `email?` | `string` | The email address to identify the user with |
555
498
 
556
499
  ### Returns
557
500
 
@@ -563,38 +506,26 @@ The email address to identify the user with
563
506
 
564
507
  ```ts
565
508
  send<T>(
566
- event,
567
- fields?,
568
- eventId?): Promise<void>;
509
+ event: string,
510
+ fields?: T,
511
+ eventId?: string): Promise<void>;
569
512
  ```
570
513
 
571
514
  Queues a tracking event and attempts to flush the queue to the API.
572
515
 
573
516
  ### Type Parameters
574
517
 
575
- #### T
576
-
577
- `T` *extends* `Record`\<`string`, `unknown`\>
518
+ | Type Parameter |
519
+ | ------ |
520
+ | `T` *extends* `Record`\<`string`, `unknown`\> |
578
521
 
579
522
  ### Parameters
580
523
 
581
- #### event
582
-
583
- `string`
584
-
585
- The event name
586
-
587
- #### fields?
588
-
589
- `T`
590
-
591
- Optional event-specific fields
592
-
593
- #### eventId?
594
-
595
- `string`
596
-
597
- Optional unique event identifier
524
+ | Parameter | Type | Description |
525
+ | ------ | ------ | ------ |
526
+ | `event` | `string` | The event name |
527
+ | `fields?` | `T` | Optional event-specific fields |
528
+ | `eventId?` | `string` | Optional unique event identifier |
598
529
 
599
530
  ### Returns
600
531
 
@@ -614,9 +545,9 @@ Concrete event handler that sends tracking events through the XyPixel singleton.
614
545
 
615
546
  ## Type Parameters
616
547
 
617
- ### T
618
-
619
- `T` *extends* `EmptyObject` = `EmptyObject`
548
+ | Type Parameter | Default type |
549
+ | ------ | ------ |
550
+ | `T` *extends* `EmptyObject` | `EmptyObject` |
620
551
 
621
552
  ## Constructors
622
553
 
@@ -639,16 +570,16 @@ new XyUserEventHandler<T>(): XyUserEventHandler<T>;
639
570
  ### funnelStarted()
640
571
 
641
572
  ```ts
642
- funnelStarted(fields): Promise<void>;
573
+ funnelStarted(fields: FunnelStartedFields | T): Promise<void>;
643
574
  ```
644
575
 
645
576
  Sends a funnel-started event via the pixel API.
646
577
 
647
578
  ### Parameters
648
579
 
649
- #### fields
650
-
651
- [`FunnelStartedFields`](#../interfaces/FunnelStartedFields) | `T`
580
+ | Parameter | Type |
581
+ | ------ | ------ |
582
+ | `fields` | [`FunnelStartedFields`](#../interfaces/FunnelStartedFields) \| `T` |
652
583
 
653
584
  ### Returns
654
585
 
@@ -663,16 +594,16 @@ Sends a funnel-started event via the pixel API.
663
594
  ### purchase()
664
595
 
665
596
  ```ts
666
- purchase(fields): Promise<void>;
597
+ purchase(fields: PurchaseFields | T): Promise<void>;
667
598
  ```
668
599
 
669
600
  Sends a purchase event via the pixel API.
670
601
 
671
602
  ### Parameters
672
603
 
673
- #### fields
674
-
675
- [`PurchaseFields`](#../interfaces/PurchaseFields) | `T`
604
+ | Parameter | Type |
605
+ | ------ | ------ |
606
+ | `fields` | [`PurchaseFields`](#../interfaces/PurchaseFields) \| `T` |
676
607
 
677
608
  ### Returns
678
609
 
@@ -683,16 +614,16 @@ Sends a purchase event via the pixel API.
683
614
  ### testStarted()
684
615
 
685
616
  ```ts
686
- testStarted(fields): Promise<void>;
617
+ testStarted(fields: TestStartedFields | T): Promise<void>;
687
618
  ```
688
619
 
689
620
  Sends a test-started event via the pixel API.
690
621
 
691
622
  ### Parameters
692
623
 
693
- #### fields
694
-
695
- [`TestStartedFields`](#../interfaces/TestStartedFields) | `T`
624
+ | Parameter | Type |
625
+ | ------ | ------ |
626
+ | `fields` | [`TestStartedFields`](#../interfaces/TestStartedFields) \| `T` |
696
627
 
697
628
  ### Returns
698
629
 
@@ -707,16 +638,16 @@ Sends a test-started event via the pixel API.
707
638
  ### userClick()
708
639
 
709
640
  ```ts
710
- userClick(fields): Promise<void>;
641
+ userClick(fields: UserClickFields | T): Promise<void>;
711
642
  ```
712
643
 
713
644
  Sends a user click event via the pixel API.
714
645
 
715
646
  ### Parameters
716
647
 
717
- #### fields
718
-
719
- [`UserClickFields`](#../interfaces/UserClickFields) | `T`
648
+ | Parameter | Type |
649
+ | ------ | ------ |
650
+ | `fields` | [`UserClickFields`](#../interfaces/UserClickFields) \| `T` |
720
651
 
721
652
  ### Returns
722
653
 
@@ -731,16 +662,16 @@ Sends a user click event via the pixel API.
731
662
  ### viewContent()
732
663
 
733
664
  ```ts
734
- viewContent(fields): Promise<void>;
665
+ viewContent(fields: ViewContentFields | T): Promise<void>;
735
666
  ```
736
667
 
737
668
  Sends a view-content event via the pixel API.
738
669
 
739
670
  ### Parameters
740
671
 
741
- #### fields
742
-
743
- [`ViewContentFields`](#../interfaces/ViewContentFields) | `T`
672
+ | Parameter | Type |
673
+ | ------ | ------ |
674
+ | `fields` | [`ViewContentFields`](#../interfaces/ViewContentFields) \| `T` |
744
675
 
745
676
  ### Returns
746
677
 
@@ -770,19 +701,10 @@ Common fields shared across all tracking event types.
770
701
 
771
702
  ## Properties
772
703
 
773
- ### funnel?
774
-
775
- ```ts
776
- optional funnel: string;
777
- ```
778
-
779
- ***
780
-
781
- ### testData?
782
-
783
- ```ts
784
- optional testData: string;
785
- ```
704
+ | Property | Type |
705
+ | ------ | ------ |
706
+ | <a id="funnel"></a> `funnel?` | `string` |
707
+ | <a id="testdata"></a> `testData?` | `string` |
786
708
 
787
709
  ### <a id="FunnelStartedFields"></a>FunnelStartedFields
788
710
 
@@ -798,35 +720,11 @@ Fields for a funnel-started tracking event.
798
720
 
799
721
  ## Properties
800
722
 
801
- ### funnel?
802
-
803
- ```ts
804
- optional funnel: string;
805
- ```
806
-
807
- ### Inherited from
808
-
809
- [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel)
810
-
811
- ***
812
-
813
- ### testData?
814
-
815
- ```ts
816
- optional testData: string;
817
- ```
818
-
819
- ### Inherited from
820
-
821
- [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata)
822
-
823
- ***
824
-
825
- ### name
826
-
827
- ```ts
828
- name: string;
829
- ```
723
+ | Property | Type | Inherited from |
724
+ | ------ | ------ | ------ |
725
+ | <a id="funnel"></a> `funnel?` | `string` | [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel) |
726
+ | <a id="testdata"></a> `testData?` | `string` | [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata) |
727
+ | <a id="name"></a> `name` | `string` | - |
830
728
 
831
729
  ### <a id="PurchaseFields"></a>PurchaseFields
832
730
 
@@ -842,59 +740,14 @@ Fields for a purchase tracking event.
842
740
 
843
741
  ## Properties
844
742
 
845
- ### funnel?
846
-
847
- ```ts
848
- optional funnel: string;
849
- ```
850
-
851
- ### Inherited from
852
-
853
- [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel)
854
-
855
- ***
856
-
857
- ### testData?
858
-
859
- ```ts
860
- optional testData: string;
861
- ```
862
-
863
- ### Inherited from
864
-
865
- [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata)
866
-
867
- ***
868
-
869
- ### id
870
-
871
- ```ts
872
- id: string;
873
- ```
874
-
875
- ***
876
-
877
- ### name?
878
-
879
- ```ts
880
- optional name: string;
881
- ```
882
-
883
- ***
884
-
885
- ### price?
886
-
887
- ```ts
888
- optional price: number;
889
- ```
890
-
891
- ***
892
-
893
- ### value?
894
-
895
- ```ts
896
- optional value: number;
897
- ```
743
+ | Property | Type | Inherited from |
744
+ | ------ | ------ | ------ |
745
+ | <a id="funnel"></a> `funnel?` | `string` | [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel) |
746
+ | <a id="testdata"></a> `testData?` | `string` | [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata) |
747
+ | <a id="id"></a> `id` | `string` | - |
748
+ | <a id="name"></a> `name?` | `string` | - |
749
+ | <a id="price"></a> `price?` | `number` | - |
750
+ | <a id="value"></a> `value?` | `number` | - |
898
751
 
899
752
  ### <a id="TestStartedFields"></a>TestStartedFields
900
753
 
@@ -910,35 +763,11 @@ Fields for a test-started tracking event (e.g. A/B test).
910
763
 
911
764
  ## Properties
912
765
 
913
- ### funnel?
914
-
915
- ```ts
916
- optional funnel: string;
917
- ```
918
-
919
- ### Inherited from
920
-
921
- [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel)
922
-
923
- ***
924
-
925
- ### testData?
926
-
927
- ```ts
928
- optional testData: string;
929
- ```
930
-
931
- ### Inherited from
932
-
933
- [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata)
934
-
935
- ***
936
-
937
- ### name
938
-
939
- ```ts
940
- name: string;
941
- ```
766
+ | Property | Type | Inherited from |
767
+ | ------ | ------ | ------ |
768
+ | <a id="funnel"></a> `funnel?` | `string` | [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel) |
769
+ | <a id="testdata"></a> `testData?` | `string` | [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata) |
770
+ | <a id="name"></a> `name` | `string` | - |
942
771
 
943
772
  ### <a id="UserClickFields"></a>UserClickFields
944
773
 
@@ -954,59 +783,14 @@ Fields for a user click tracking event.
954
783
 
955
784
  ## Properties
956
785
 
957
- ### funnel?
958
-
959
- ```ts
960
- optional funnel: string;
961
- ```
962
-
963
- ### Inherited from
964
-
965
- [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel)
966
-
967
- ***
968
-
969
- ### testData?
970
-
971
- ```ts
972
- optional testData: string;
973
- ```
974
-
975
- ### Inherited from
976
-
977
- [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata)
978
-
979
- ***
980
-
981
- ### elementName
982
-
983
- ```ts
984
- elementName: string;
985
- ```
986
-
987
- ***
988
-
989
- ### elementType
990
-
991
- ```ts
992
- elementType: string;
993
- ```
994
-
995
- ***
996
-
997
- ### intent?
998
-
999
- ```ts
1000
- optional intent: string;
1001
- ```
1002
-
1003
- ***
1004
-
1005
- ### placement?
1006
-
1007
- ```ts
1008
- optional placement: string;
1009
- ```
786
+ | Property | Type | Inherited from |
787
+ | ------ | ------ | ------ |
788
+ | <a id="funnel"></a> `funnel?` | `string` | [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel) |
789
+ | <a id="testdata"></a> `testData?` | `string` | [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata) |
790
+ | <a id="elementname"></a> `elementName` | `string` | - |
791
+ | <a id="elementtype"></a> `elementType` | `string` | - |
792
+ | <a id="intent"></a> `intent?` | `string` | - |
793
+ | <a id="placement"></a> `placement?` | `string` | - |
1010
794
 
1011
795
  ### <a id="UserEvent"></a>UserEvent
1012
796
 
@@ -1018,151 +802,27 @@ Represents a single user tracking event to be sent to the pixel API.
1018
802
 
1019
803
  ## Properties
1020
804
 
1021
- ### cid
1022
-
1023
- ```ts
1024
- cid: string;
1025
- ```
1026
-
1027
- ***
1028
-
1029
- ### create\_time?
1030
-
1031
- ```ts
1032
- optional create_time: number;
1033
- ```
1034
-
1035
- ***
1036
-
1037
- ### email?
1038
-
1039
- ```ts
1040
- optional email: string;
1041
- ```
1042
-
1043
- ***
1044
-
1045
- ### email\_hash?
1046
-
1047
- ```ts
1048
- optional email_hash: string;
1049
- ```
1050
-
1051
- ***
1052
-
1053
- ### event?
1054
-
1055
- ```ts
1056
- optional event: string;
1057
- ```
1058
-
1059
- ***
1060
-
1061
- ### event\_id?
1062
-
1063
- ```ts
1064
- optional event_id: string;
1065
- ```
1066
-
1067
- ***
1068
-
1069
- ### exids?
1070
-
1071
- ```ts
1072
- optional exids: ExIds;
1073
- ```
1074
-
1075
- ***
1076
-
1077
- ### fields?
1078
-
1079
- ```ts
1080
- optional fields: Record<string, unknown>;
1081
- ```
1082
-
1083
- ***
1084
-
1085
- ### host?
1086
-
1087
- ```ts
1088
- optional host: string;
1089
- ```
1090
-
1091
- ***
1092
-
1093
- ### pathname?
1094
-
1095
- ```ts
1096
- optional pathname: string;
1097
- ```
1098
-
1099
- ***
1100
-
1101
- ### pixel?
1102
-
1103
- ```ts
1104
- optional pixel: string;
1105
- ```
1106
-
1107
- ***
1108
-
1109
- ### receive\_time?
1110
-
1111
- ```ts
1112
- optional receive_time: number;
1113
- ```
1114
-
1115
- ***
1116
-
1117
- ### referrer?
1118
-
1119
- ```ts
1120
- optional referrer: object;
1121
- ```
1122
-
1123
- ### local
1124
-
1125
- ```ts
1126
- local: string;
1127
- ```
1128
-
1129
- ### session
1130
-
1131
- ```ts
1132
- session: string;
1133
- ```
1134
-
1135
- ***
1136
-
1137
- ### rid?
1138
-
1139
- ```ts
1140
- optional rid: string;
1141
- ```
1142
-
1143
- ***
1144
-
1145
- ### system?
1146
-
1147
- ```ts
1148
- optional system: ParsedResult;
1149
- ```
1150
-
1151
- ***
1152
-
1153
- ### uid?
1154
-
1155
- ```ts
1156
- optional uid: string;
1157
- ```
1158
-
1159
- ***
1160
-
1161
- ### utm?
1162
-
1163
- ```ts
1164
- optional utm: Record<string, string>[] | Record<string, string[]>;
1165
- ```
805
+ | Property | Type |
806
+ | ------ | ------ |
807
+ | <a id="cid"></a> `cid` | `string` |
808
+ | <a id="create_time"></a> `create_time?` | `number` |
809
+ | <a id="email"></a> `email?` | `string` |
810
+ | <a id="email_hash"></a> `email_hash?` | `string` |
811
+ | <a id="event"></a> `event?` | `string` |
812
+ | <a id="event_id"></a> `event_id?` | `string` |
813
+ | <a id="exids"></a> `exids?` | `ExIds` |
814
+ | <a id="fields"></a> `fields?` | `Record`\<`string`, `unknown`\> |
815
+ | <a id="host"></a> `host?` | `string` |
816
+ | <a id="pathname"></a> `pathname?` | `string` |
817
+ | <a id="pixel"></a> `pixel?` | `string` |
818
+ | <a id="receive_time"></a> `receive_time?` | `number` |
819
+ | <a id="referrer"></a> `referrer?` | \{ `local`: `string`; `session`: `string`; \} |
820
+ | `referrer.local` | `string` |
821
+ | `referrer.session` | `string` |
822
+ | <a id="rid"></a> `rid?` | `string` |
823
+ | <a id="system"></a> `system?` | `ParsedResult` |
824
+ | <a id="uid"></a> `uid?` | `string` |
825
+ | <a id="utm"></a> `utm?` | `Record`\<`string`, `string`\>[] \| `Record`\<`string`, `string`[]\> |
1166
826
 
1167
827
  ### <a id="ViewContentFields"></a>ViewContentFields
1168
828
 
@@ -1178,43 +838,12 @@ Fields for a view-content tracking event.
1178
838
 
1179
839
  ## Properties
1180
840
 
1181
- ### funnel?
1182
-
1183
- ```ts
1184
- optional funnel: string;
1185
- ```
1186
-
1187
- ### Inherited from
1188
-
1189
- [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel)
1190
-
1191
- ***
1192
-
1193
- ### testData?
1194
-
1195
- ```ts
1196
- optional testData: string;
1197
- ```
1198
-
1199
- ### Inherited from
1200
-
1201
- [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata)
1202
-
1203
- ***
1204
-
1205
- ### name
1206
-
1207
- ```ts
1208
- name: string;
1209
- ```
1210
-
1211
- ***
1212
-
1213
- ### path
1214
-
1215
- ```ts
1216
- path: string;
1217
- ```
841
+ | Property | Type | Inherited from |
842
+ | ------ | ------ | ------ |
843
+ | <a id="funnel"></a> `funnel?` | `string` | [`CommonFields`](#CommonFields).[`funnel`](CommonFields.md#funnel) |
844
+ | <a id="testdata"></a> `testData?` | `string` | [`CommonFields`](#CommonFields).[`testData`](CommonFields.md#testdata) |
845
+ | <a id="name"></a> `name` | `string` | - |
846
+ | <a id="path"></a> `path` | `string` | - |
1218
847
 
1219
848
  ### <a id="XyLabsTrackingEventJson"></a>XyLabsTrackingEventJson
1220
849
 
@@ -1226,147 +855,26 @@ JSON structure for an XY Labs tracking event as stored or transmitted.
1226
855
 
1227
856
  ## Properties
1228
857
 
1229
- ### cid
1230
-
1231
- ```ts
1232
- cid: string;
1233
- ```
1234
-
1235
- ***
1236
-
1237
- ### create\_time?
1238
-
1239
- ```ts
1240
- optional create_time: number;
1241
- ```
1242
-
1243
- ***
1244
-
1245
- ### email?
1246
-
1247
- ```ts
1248
- optional email: string;
1249
- ```
1250
-
1251
- ***
1252
-
1253
- ### email\_hash?
1254
-
1255
- ```ts
1256
- optional email_hash: string;
1257
- ```
1258
-
1259
- ***
1260
-
1261
- ### event?
1262
-
1263
- ```ts
1264
- optional event: string;
1265
- ```
1266
-
1267
- ***
1268
-
1269
- ### event\_id?
1270
-
1271
- ```ts
1272
- optional event_id: string;
1273
- ```
1274
-
1275
- ***
1276
-
1277
- ### exids?
1278
-
1279
- ```ts
1280
- optional exids: Record<string, string>;
1281
- ```
1282
-
1283
- ***
1284
-
1285
- ### fields?
1286
-
1287
- ```ts
1288
- optional fields: Record<string, unknown>;
1289
- ```
1290
-
1291
- ***
1292
-
1293
- ### host?
1294
-
1295
- ```ts
1296
- optional host: string;
1297
- ```
1298
-
1299
- ***
1300
-
1301
- ### ip?
1302
-
1303
- ```ts
1304
- optional ip: string;
1305
- ```
1306
-
1307
- ***
1308
-
1309
- ### pathname?
1310
-
1311
- ```ts
1312
- optional pathname: string;
1313
- ```
1314
-
1315
- ***
1316
-
1317
- ### pixel?
1318
-
1319
- ```ts
1320
- optional pixel: string;
1321
- ```
1322
-
1323
- ***
1324
-
1325
- ### receive\_time?
1326
-
1327
- ```ts
1328
- optional receive_time: number;
1329
- ```
1330
-
1331
- ***
1332
-
1333
- ### rid?
1334
-
1335
- ```ts
1336
- optional rid: string;
1337
- ```
1338
-
1339
- ***
1340
-
1341
- ### system?
1342
-
1343
- ```ts
1344
- optional system: unknown;
1345
- ```
1346
-
1347
- ***
1348
-
1349
- ### ua?
1350
-
1351
- ```ts
1352
- optional ua: string;
1353
- ```
1354
-
1355
- ***
1356
-
1357
- ### uid?
1358
-
1359
- ```ts
1360
- optional uid: string;
1361
- ```
1362
-
1363
- ***
1364
-
1365
- ### utm?
1366
-
1367
- ```ts
1368
- optional utm: Record<string, string>[] | Record<string, string[]>;
1369
- ```
858
+ | Property | Type |
859
+ | ------ | ------ |
860
+ | <a id="cid"></a> `cid` | `string` |
861
+ | <a id="create_time"></a> `create_time?` | `number` |
862
+ | <a id="email"></a> `email?` | `string` |
863
+ | <a id="email_hash"></a> `email_hash?` | `string` |
864
+ | <a id="event"></a> `event?` | `string` |
865
+ | <a id="event_id"></a> `event_id?` | `string` |
866
+ | <a id="exids"></a> `exids?` | `Record`\<`string`, `string`\> |
867
+ | <a id="fields"></a> `fields?` | `Record`\<`string`, `unknown`\> |
868
+ | <a id="host"></a> `host?` | `string` |
869
+ | <a id="ip"></a> `ip?` | `string` |
870
+ | <a id="pathname"></a> `pathname?` | `string` |
871
+ | <a id="pixel"></a> `pixel?` | `string` |
872
+ | <a id="receive_time"></a> `receive_time?` | `number` |
873
+ | <a id="rid"></a> `rid?` | `string` |
874
+ | <a id="system"></a> `system?` | `unknown` |
875
+ | <a id="ua"></a> `ua?` | `string` |
876
+ | <a id="uid"></a> `uid?` | `string` |
877
+ | <a id="utm"></a> `utm?` | `Record`\<`string`, `string`\>[] \| `Record`\<`string`, `string`[]\> |
1370
878
 
1371
879
  ### type-aliases
1372
880
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xylabs/pixel",
3
- "version": "5.0.84",
3
+ "version": "5.0.86",
4
4
  "description": "Event Client for xylabs ESB",
5
5
  "homepage": "https://xylabs.com",
6
6
  "bugs": {
@@ -35,10 +35,10 @@
35
35
  "!**/*.test.*"
36
36
  ],
37
37
  "dependencies": {
38
- "@xylabs/assert": "~5.0.84",
39
- "@xylabs/object": "~5.0.84",
40
- "@xylabs/promise": "~5.0.84",
41
- "@xylabs/typeof": "~5.0.84",
38
+ "@xylabs/assert": "~5.0.86",
39
+ "@xylabs/object": "~5.0.86",
40
+ "@xylabs/promise": "~5.0.86",
41
+ "@xylabs/typeof": "~5.0.86",
42
42
  "async-mutex": "~0.5.0",
43
43
  "bowser": "2.14.1",
44
44
  "fast-deep-equal": "~3.1.3",
@@ -49,9 +49,9 @@
49
49
  "@types/js-cookie": "~3.0.6",
50
50
  "@types/node": "~25.4.0",
51
51
  "@types/spark-md5": "~3.0.5",
52
- "@xylabs/ts-scripts-yarn3": "~7.4.13",
53
- "@xylabs/tsconfig": "~7.4.13",
54
- "@xylabs/tsconfig-dom": "~7.4.13",
52
+ "@xylabs/ts-scripts-yarn3": "~7.4.16",
53
+ "@xylabs/tsconfig": "~7.4.16",
54
+ "@xylabs/tsconfig-dom": "~7.4.16",
55
55
  "axios": "^1.13.6",
56
56
  "typescript": "~5.9.3",
57
57
  "vitest": "~4.0.18"