@nommos/events_angular 0.0.6 → 0.0.8

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 (4) hide show
  1. package/fesm2022/nommos-events_angular.mjs +31 -17
  2. package/fesm2022/nommos-events_angular.mjs.map +1 -1
  3. package/index.d.ts +44 -40
  4. package/package.json +5 -5
package/fesm2022/nommos-events_angular.mjs CHANGED
@@ -1,8 +1,9 @@
1
1
  import * as i0 from '@angular/core';
2
- import { inject, Injectable, HostListener, Input, Directive, NgModule } from '@angular/core';
2
+ import { Injectable, HostListener, Input, Directive, NgModule } from '@angular/core';
3
3
  import { CommonModule } from '@angular/common';
4
- import { EventTracker, ANALYTICS_ACTION_STATE } from '@nommos/core';
5
- import { Router } from '@angular/router';
4
+ import * as i1 from '@nommos/core';
5
+ import { ANALYTICS_ACTION_STATE, EventTracker } from '@nommos/core';
6
+ import * as i2 from '@angular/router';
6
7
 
7
8
  /**
8
9
  * TrackerService
@@ -18,8 +19,12 @@ import { Router } from '@angular/router';
18
19
  * ```
19
20
  */
20
21
  class TrackerService {
21
- eventTracker = inject(EventTracker);
22
- router = inject(Router);
22
+ eventTracker;
23
+ router;
24
+ constructor(eventTracker, router) {
25
+ this.eventTracker = eventTracker;
26
+ this.router = router;
27
+ }
23
28
  /**
24
29
  * collects tracked actions carried with associated informations and publishes them for storage.
25
30
  *
@@ -38,7 +43,7 @@ class TrackerService {
38
43
  ngOnDestroy() {
39
44
  this.eventTracker.unsubscribe();
40
45
  }
41
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackerService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
46
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackerService, deps: [{ token: i1.EventTracker }, { token: i2.Router }], target: i0.ɵɵFactoryTarget.Injectable });
42
47
  static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackerService, providedIn: 'root' });
43
48
  }
44
49
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackerService, decorators: [{
@@ -46,7 +51,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImpo
46
51
  args: [{
47
52
  providedIn: 'root',
48
53
  }]
49
- }] });
54
+ }], ctorParameters: () => [{ type: i1.EventTracker }, { type: i2.Router }] });
50
55
 
51
56
  /**
52
57
  * TrackClickDirective
@@ -63,6 +68,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImpo
63
68
  * ```
64
69
  */
65
70
  class TrackClickDirective {
71
+ trackerService;
66
72
  /**
67
73
  * The action to be tracked.
68
74
  * @type {ANALYTICS_ACTION}
@@ -100,7 +106,9 @@ class TrackClickDirective {
100
106
  */
101
107
  userId = '';
102
108
  clicked = false;
103
- trackerService = inject(TrackerService);
109
+ constructor(trackerService) {
110
+ this.trackerService = trackerService;
111
+ }
104
112
  onClick() {
105
113
  if (this.multi) {
106
114
  this.clicked = !this.clicked;
@@ -110,15 +118,16 @@ class TrackClickDirective {
110
118
  this.trackerService.trackEvent(this.action, this.state, this.data, this.toggle, null, this.userId);
111
119
  }
112
120
  }
113
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackClickDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
114
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.11", type: TrackClickDirective, isStandalone: true, selector: "[nommosTrackClick]", inputs: { action: ["nommosTrackClick", "action"], state: "state", data: "data", toggle: "toggle", multi: "multi", userId: "userId" }, host: { listeners: { "click": "onClick()" } }, ngImport: i0 });
121
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackClickDirective, deps: [{ token: TrackerService }], target: i0.ɵɵFactoryTarget.Directive });
122
+ static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.11", type: TrackClickDirective, isStandalone: false, selector: "[nommosTrackClick]", inputs: { action: ["nommosTrackClick", "action"], state: "state", data: "data", toggle: "toggle", multi: "multi", userId: "userId" }, host: { listeners: { "click": "onClick()" } }, ngImport: i0 });
115
123
  }
116
124
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackClickDirective, decorators: [{
117
125
  type: Directive,
118
126
  args: [{
119
127
  selector: '[nommosTrackClick]',
128
+ standalone: false,
120
129
  }]
121
- }], propDecorators: { action: [{
130
+ }], ctorParameters: () => [{ type: TrackerService }], propDecorators: { action: [{
122
131
  type: Input,
123
132
  args: ['nommosTrackClick']
124
133
  }], state: [{
@@ -151,6 +160,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImpo
151
160
  * ```
152
161
  */
153
162
  class TrackSubmitDirective {
163
+ trackerService;
154
164
  /**
155
165
  * The action to be tracked.
156
166
  * @type {ANALYTICS_ACTION}
@@ -167,19 +177,22 @@ class TrackSubmitDirective {
167
177
  * @type {string}
168
178
  */
169
179
  userId = '';
170
- trackerService = inject(TrackerService);
180
+ constructor(trackerService) {
181
+ this.trackerService = trackerService;
182
+ }
171
183
  onClick() {
172
184
  this.trackerService.trackEvent(this.action, ANALYTICS_ACTION_STATE.SUBMIT, this.data, false, null, this.userId);
173
185
  }
174
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackSubmitDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
175
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.11", type: TrackSubmitDirective, isStandalone: true, selector: "[nommosTrackSubmit]", inputs: { action: ["nommosTrackSubmit", "action"], data: "data", userId: "userId" }, host: { listeners: { "ngSubmit": "onClick()", "submit": "onClick()" } }, ngImport: i0 });
186
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackSubmitDirective, deps: [{ token: TrackerService }], target: i0.ɵɵFactoryTarget.Directive });
187
+ static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "20.3.11", type: TrackSubmitDirective, isStandalone: false, selector: "[nommosTrackSubmit]", inputs: { action: ["nommosTrackSubmit", "action"], data: "data", userId: "userId" }, host: { listeners: { "ngSubmit": "onClick()", "submit": "onClick()" } }, ngImport: i0 });
176
188
  }
177
189
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackSubmitDirective, decorators: [{
178
190
  type: Directive,
179
191
  args: [{
180
192
  selector: '[nommosTrackSubmit]',
193
+ standalone: false,
181
194
  }]
182
- }], propDecorators: { action: [{
195
+ }], ctorParameters: () => [{ type: TrackerService }], propDecorators: { action: [{
183
196
  type: Input,
184
197
  args: ['nommosTrackSubmit']
185
198
  }], data: [{
@@ -220,13 +233,14 @@ class ActivityTrackerModule {
220
233
  };
221
234
  }
222
235
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: ActivityTrackerModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
223
- static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.11", ngImport: i0, type: ActivityTrackerModule, imports: [CommonModule, TrackClickDirective, TrackSubmitDirective], exports: [TrackClickDirective, TrackSubmitDirective] });
236
+ static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.11", ngImport: i0, type: ActivityTrackerModule, declarations: [TrackClickDirective, TrackSubmitDirective], imports: [CommonModule], exports: [TrackClickDirective, TrackSubmitDirective] });
224
237
  static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: ActivityTrackerModule, imports: [CommonModule] });
225
238
  }
226
239
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: ActivityTrackerModule, decorators: [{
227
240
  type: NgModule,
228
241
  args: [{
229
- imports: [CommonModule, TrackClickDirective, TrackSubmitDirective],
242
+ declarations: [TrackClickDirective, TrackSubmitDirective],
243
+ imports: [CommonModule],
230
244
  exports: [TrackClickDirective, TrackSubmitDirective],
231
245
  }]
232
246
  }] });
package/fesm2022/nommos-events_angular.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"nommos-events_angular.mjs","sources":["../../../../nommos/angular/src/services/tracker/tracker.service.ts","../../../../nommos/angular/src/directives/track-click/track-click.directive.ts","../../../../nommos/angular/src/directives/track-submit/track-submit.directive.ts","../../../../nommos/angular/src/activity-tracker.module.ts","../../../../nommos/angular/src/nommos-events_angular.ts"],"sourcesContent":["import { Injectable, OnDestroy, inject } from '@angular/core';\r\nimport { Router } from '@angular/router';\r\nimport {\r\n ANALYTICS_ACTION,\r\n ANALYTICS_ACTION_STATE,\r\n EventTracker,\r\n} from '@nommos/core';\r\n\r\n/**\r\n * TrackerService\r\n * -----------------------\r\n * An angular utility designed to record user actions such as clicks,\r\n * form submissions, and custom events for analytics of carried out .\r\n *\r\n * @example\r\n * ```ts\r\n * constructor(private tracker: TrackerService) {}\r\n *\r\n * this.tracker.trackEvent(ANALYTICS_ACTION_GROUPS.SIGN_IN, ANALYTICS_ACTION_STATE.SUBMIT, { login: 'johndoh@example.com' }, false, null, 'u123-456-789');\r\n * ```\r\n */\r\n\r\n@Injectable({\r\n providedIn: 'root',\r\n})\r\nexport class TrackerService implements OnDestroy {\r\n private readonly eventTracker = inject(EventTracker);\r\n private readonly router = inject(Router);\r\n\r\n /**\r\n * collects tracked actions carried with associated informations and publishes them for storage.\r\n *\r\n * @param action - Name of action to be tracked.\r\n * @param state - State associated to the action being tracked.\r\n * @param data - Optional: information associated with the action being tracked.\r\n * @param toggle - Enables toggling between two actions(select/unselect) for an action.\r\n * @param selected - State of an event with select action (selected or unselected)\r\n * @param userId - Optional: user ID associated to the current user carrying out the action.\r\n */\r\n trackEvent(\r\n action: ANALYTICS_ACTION,\r\n state: ANALYTICS_ACTION_STATE,\r\n data: Record<string, unknown> | null = null,\r\n toggle = true,\r\n selected: boolean | null = null,\r\n userId = ''\r\n ): void {\r\n if (this.eventTracker.trackingIsEnabled()) {\r\n this.eventTracker.trackEvent(\r\n action,\r\n state,\r\n data,\r\n toggle,\r\n selected,\r\n userId,\r\n this.router.url\r\n );\r\n }\r\n }\r\n\r\n ngOnDestroy(): void {\r\n this.eventTracker.unsubscribe();\r\n }\r\n}\r\n","import { Directive, HostListener, Input, inject } from '@angular/core';\r\nimport { ANALYTICS_ACTION, ANALYTICS_ACTION_STATE } from '@nommos/core';\r\nimport { TrackerService } from '../../services/tracker/tracker.service';\r\n\r\n/**\r\n * TrackClickDirective\r\n * --------------------\r\n * An attribute directive that automatically pushes setup action with associated information on clicks\r\n *\r\n * @example\r\n * ```html\r\n * <button\r\n * [nommosTrackClick]=\"ANALYTICS_ACTION_GROUPS.REGISTRATION\"\r\n * >\r\n * Sign Up\r\n * </button>\r\n * ```\r\n */\r\n@Directive({\r\n selector: '[nommosTrackClick]',\r\n})\r\nexport class TrackClickDirective {\r\n /**\r\n * The action to be tracked.\r\n * @type {ANALYTICS_ACTION}\r\n */\r\n @Input('nommosTrackClick') action!: ANALYTICS_ACTION;\r\n\r\n /**\r\n * The state of the action carried to be tracked.\r\n * @default ANALYTICS_ACTION_STATE.SELECT\r\n * @type {ANALYTICS_ACTION_STATE}\r\n */\r\n @Input() state: ANALYTICS_ACTION_STATE = ANALYTICS_ACTION_STATE.SELECT;\r\n\r\n /**\r\n * Optional Information on the action carried out being tracked.\r\n * @type {Record<string, unknown>}\r\n */\r\n @Input() data?: Record<string, unknown>;\r\n\r\n /**\r\n * Permits to toggle the selection state (ANALYTICS_ACTION_STATE.SELECT to/from ANALYTICS_ACTION_STATE.UN_SELECT)\r\n * of an action by any element when clicked.\r\n * **Default:** `true`\r\n * @type {boolean}\r\n */\r\n @Input() toggle = true;\r\n\r\n /**\r\n * Permits multiple elements to change the selection state of an action.\r\n * It has priority over the **toggle** input.\r\n * **Default:** `false`\r\n * @type {boolean}\r\n */\r\n @Input() multi = false;\r\n\r\n /**\r\n * The user ID associated to the current user carrying out the action.\r\n * **Default:** `''`\r\n * @type {string}\r\n */\r\n @Input() userId = '';\r\n clicked = false;\r\n\r\n private readonly trackerService = inject(TrackerService);\r\n\r\n @HostListener('click')\r\n onClick(): void {\r\n if (this.multi) {\r\n this.clicked = !this.clicked;\r\n this.trackerService.trackEvent(\r\n this.action,\r\n this.state,\r\n this.data,\r\n this.toggle,\r\n this.clicked,\r\n this.userId\r\n );\r\n } else {\r\n this.trackerService.trackEvent(\r\n this.action,\r\n this.state,\r\n this.data,\r\n this.toggle,\r\n null,\r\n this.userId\r\n );\r\n }\r\n }\r\n}\r\n","import { Directive, HostListener, inject, Input } from '@angular/core';\r\nimport { ANALYTICS_ACTION, ANALYTICS_ACTION_STATE } from '@nommos/core';\r\nimport { TrackerService } from '../../services/tracker/tracker.service';\r\n\r\n/**\r\n * TrackSubmitDirective\r\n * --------------------\r\n * An attribute directive that automatically pushes setup action with associated information on form submissions\r\n *\r\n * @example\r\n * ```html\r\n * <button\r\n * [nommosTrackSubmit]=\"ANALYTICS_ACTION_GROUPS.REGISTRATION\"\r\n * >\r\n * Sign Up\r\n * </button>\r\n * ```\r\n */\r\n@Directive({\r\n selector: '[nommosTrackSubmit]',\r\n})\r\nexport class TrackSubmitDirective {\r\n /**\r\n * The action to be tracked.\r\n * @type {ANALYTICS_ACTION}\r\n */\r\n @Input('nommosTrackSubmit') action!: ANALYTICS_ACTION;\r\n\r\n /**\r\n * Optional Information on the action carried out being tracked.\r\n * @type {Record<string, unknown>}\r\n */\r\n @Input() data?: Record<string, unknown>;\r\n\r\n\r\n /**\r\n * The user ID associated to the current user carrying out the action.\r\n * @default ''\r\n * @type {string}\r\n */\r\n @Input() userId = '';\r\n\r\n private readonly trackerService = inject(TrackerService);\r\n\r\n @HostListener('ngSubmit')\r\n @HostListener('submit')\r\n onClick(): void {\r\n this.trackerService.trackEvent(\r\n this.action,\r\n ANALYTICS_ACTION_STATE.SUBMIT,\r\n this.data,\r\n false,\r\n null,\r\n this.userId\r\n );\r\n }\r\n}\r\n","import { ModuleWithProviders, NgModule, Provider } from '@angular/core';\r\nimport { CommonModule } from '@angular/common';\r\nimport { ConnectionConfig, EventTracker, UrlTrackingKey } from '@nommos/core';\r\nimport { TrackerService } from './services/tracker/tracker.service';\r\nimport { TrackClickDirective, TrackSubmitDirective } from './directives';\r\n\r\n@NgModule({\r\n imports: [CommonModule, TrackClickDirective, TrackSubmitDirective],\r\n exports: [TrackClickDirective, TrackSubmitDirective],\r\n})\r\nexport class ActivityTrackerModule {\r\n /**\r\n * Registers the ActivityTrackerModule using the Angular `forRoot()` pattern.\r\n *\r\n * This is intended for NgModule-based applications. It initializes the\r\n * analytics engine with the provided connection configuration and URL\r\n * tracking key.\r\n *\r\n * @param config - Connection configuration used by the `EventTracker` (a token)\r\n * @param urlTrackingKey - Optional key for extracting tracking identifiers\r\n * from the URL (e.g affiliate key)\r\n * @returns A `ModuleWithProviders` containing the module and its providers\r\n */\r\n\r\n static forRoot(\r\n config: ConnectionConfig,\r\n urlTrackingKey: UrlTrackingKey\r\n ): ModuleWithProviders<ActivityTrackerModule> {\r\n return {\r\n ngModule: ActivityTrackerModule,\r\n providers: [\r\n {\r\n provide: EventTracker,\r\n useValue: new EventTracker(config, urlTrackingKey),\r\n },\r\n TrackerService,\r\n ],\r\n };\r\n }\r\n}\r\n\r\n/**\r\n * Standalone-friendly provider registration for the Activity Tracker.\r\n *\r\n * This function is recommended for Angular applications using the\r\n * Standalone API (`bootstrapApplication`) and cannot use `forRoot()`.\r\n *\r\n * @example\r\n * ```ts\r\n * bootstrapApplication(AppComponent, {\r\n * providers: [\r\n * ...provideActivityTracker(config, urlTrackingKey)\r\n * ]\r\n * });\r\n * ```\r\n *\r\n * @param config - Connection configuration used by `EventTracker`\r\n * @param urlTrackingKey - Key used to extract tracking identifiers from URLs\r\n * @returns An array of Angular providers for use in standalone environments\r\n */\r\nexport function provideActivityTracker(\r\n config: ConnectionConfig,\r\n urlTrackingKey: UrlTrackingKey\r\n): Provider[] {\r\n return [\r\n {\r\n provide: EventTracker,\r\n useValue: new EventTracker(config, urlTrackingKey),\r\n },\r\n TrackerService,\r\n ];\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"nommos-events_angular.mjs","sources":["../../../../nommos/angular/src/services/tracker/tracker.service.ts","../../../../nommos/angular/src/directives/track-click/track-click.directive.ts","../../../../nommos/angular/src/directives/track-submit/track-submit.directive.ts","../../../../nommos/angular/src/activity-tracker.module.ts","../../../../nommos/angular/src/nommos-events_angular.ts"],"sourcesContent":["import { Injectable, OnDestroy } from '@angular/core';\r\nimport { Router } from '@angular/router';\r\nimport {\r\n ANALYTICS_ACTION,\r\n ANALYTICS_ACTION_STATE,\r\n EventTracker,\r\n} from '@nommos/core';\r\n\r\n/**\r\n * TrackerService\r\n * -----------------------\r\n * An angular utility designed to record user actions such as clicks,\r\n * form submissions, and custom events for analytics of carried out .\r\n *\r\n * @example\r\n * ```ts\r\n * constructor(private tracker: TrackerService) {}\r\n *\r\n * this.tracker.trackEvent(ANALYTICS_ACTION_GROUPS.SIGN_IN, ANALYTICS_ACTION_STATE.SUBMIT, { login: 'johndoh@example.com' }, false, null, 'u123-456-789');\r\n * ```\r\n */\r\n\r\n@Injectable({\r\n providedIn: 'root',\r\n})\r\nexport class TrackerService implements OnDestroy {\r\n constructor(\r\n private readonly eventTracker: EventTracker,\r\n private readonly router: Router\r\n ) {}\r\n\r\n /**\r\n * collects tracked actions carried with associated informations and publishes them for storage.\r\n *\r\n * @param action - Name of action to be tracked.\r\n * @param state - State associated to the action being tracked.\r\n * @param data - Optional: information associated with the action being tracked.\r\n * @param toggle - Enables toggling between two actions(select/unselect) for an action.\r\n * @param selected - State of an event with select action (selected or unselected)\r\n * @param userId - Optional: user ID associated to the current user carrying out the action.\r\n */\r\n trackEvent(\r\n action: ANALYTICS_ACTION,\r\n state: ANALYTICS_ACTION_STATE,\r\n data: Record<string, unknown> | null = null,\r\n toggle = true,\r\n selected: boolean | null = null,\r\n userId = ''\r\n ): void {\r\n if (this.eventTracker.trackingIsEnabled()) {\r\n this.eventTracker.trackEvent(\r\n action,\r\n state,\r\n data,\r\n toggle,\r\n selected,\r\n userId,\r\n this.router.url\r\n );\r\n }\r\n }\r\n\r\n ngOnDestroy(): void {\r\n this.eventTracker.unsubscribe();\r\n }\r\n}\r\n","import { Directive, HostListener, Input } from '@angular/core';\r\nimport { ANALYTICS_ACTION, ANALYTICS_ACTION_STATE } from '@nommos/core';\r\nimport { TrackerService } from '../../services/tracker/tracker.service';\r\n\r\n/**\r\n * TrackClickDirective\r\n * --------------------\r\n * An attribute directive that automatically pushes setup action with associated information on clicks\r\n *\r\n * @example\r\n * ```html\r\n * <button\r\n * [nommosTrackClick]=\"ANALYTICS_ACTION_GROUPS.REGISTRATION\"\r\n * >\r\n * Sign Up\r\n * </button>\r\n * ```\r\n */\r\n@Directive({\r\n selector: '[nommosTrackClick]',\r\n standalone: false,\r\n})\r\nexport class TrackClickDirective {\r\n /**\r\n * The action to be tracked.\r\n * @type {ANALYTICS_ACTION}\r\n */\r\n @Input('nommosTrackClick') action!: ANALYTICS_ACTION;\r\n\r\n /**\r\n * The state of the action carried to be tracked.\r\n * @default ANALYTICS_ACTION_STATE.SELECT\r\n * @type {ANALYTICS_ACTION_STATE}\r\n */\r\n @Input() state: ANALYTICS_ACTION_STATE = ANALYTICS_ACTION_STATE.SELECT;\r\n\r\n /**\r\n * Optional Information on the action carried out being tracked.\r\n * @type {Record<string, unknown>}\r\n */\r\n @Input() data?: Record<string, unknown>;\r\n\r\n /**\r\n * Permits to toggle the selection state (ANALYTICS_ACTION_STATE.SELECT to/from ANALYTICS_ACTION_STATE.UN_SELECT)\r\n * of an action by any element when clicked.\r\n * **Default:** `true`\r\n * @type {boolean}\r\n */\r\n @Input() toggle = true;\r\n\r\n /**\r\n * Permits multiple elements to change the selection state of an action.\r\n * It has priority over the **toggle** input.\r\n * **Default:** `false`\r\n * @type {boolean}\r\n */\r\n @Input() multi = false;\r\n\r\n /**\r\n * The user ID associated to the current user carrying out the action.\r\n * **Default:** `''`\r\n * @type {string}\r\n */\r\n @Input() userId = '';\r\n clicked = false;\r\n\r\n constructor(private readonly trackerService: TrackerService) {}\r\n\r\n @HostListener('click')\r\n onClick(): void {\r\n if (this.multi) {\r\n this.clicked = !this.clicked;\r\n this.trackerService.trackEvent(\r\n this.action,\r\n this.state,\r\n this.data,\r\n this.toggle,\r\n this.clicked,\r\n this.userId\r\n );\r\n } else {\r\n this.trackerService.trackEvent(\r\n this.action,\r\n this.state,\r\n this.data,\r\n this.toggle,\r\n null,\r\n this.userId\r\n );\r\n }\r\n }\r\n}\r\n","import { Directive, HostListener, Input } from '@angular/core';\r\nimport { ANALYTICS_ACTION, ANALYTICS_ACTION_STATE } from '@nommos/core';\r\nimport { TrackerService } from '../../services/tracker/tracker.service';\r\n\r\n/**\r\n * TrackSubmitDirective\r\n * --------------------\r\n * An attribute directive that automatically pushes setup action with associated information on form submissions\r\n *\r\n * @example\r\n * ```html\r\n * <button\r\n * [nommosTrackSubmit]=\"ANALYTICS_ACTION_GROUPS.REGISTRATION\"\r\n * >\r\n * Sign Up\r\n * </button>\r\n * ```\r\n */\r\n@Directive({\r\n selector: '[nommosTrackSubmit]',\r\n standalone: false,\r\n})\r\nexport class TrackSubmitDirective {\r\n /**\r\n * The action to be tracked.\r\n * @type {ANALYTICS_ACTION}\r\n */\r\n @Input('nommosTrackSubmit') action!: ANALYTICS_ACTION;\r\n\r\n /**\r\n * Optional Information on the action carried out being tracked.\r\n * @type {Record<string, unknown>}\r\n */\r\n @Input() data?: Record<string, unknown>;\r\n\r\n\r\n /**\r\n * The user ID associated to the current user carrying out the action.\r\n * @default ''\r\n * @type {string}\r\n */\r\n @Input() userId = '';\r\n\r\n constructor(private readonly trackerService: TrackerService) {}\r\n\r\n @HostListener('ngSubmit')\r\n @HostListener('submit')\r\n onClick(): void {\r\n this.trackerService.trackEvent(\r\n this.action,\r\n ANALYTICS_ACTION_STATE.SUBMIT,\r\n this.data,\r\n false,\r\n null,\r\n this.userId\r\n );\r\n }\r\n}\r\n","import { ModuleWithProviders, NgModule, Provider } from '@angular/core';\r\nimport { CommonModule } from '@angular/common';\r\nimport { ConnectionConfig, EventTracker, UrlTrackingKey } from '@nommos/core';\r\nimport { TrackerService } from './services/tracker/tracker.service';\r\nimport { TrackClickDirective, TrackSubmitDirective } from './directives';\r\n\r\n@NgModule({\r\n declarations: [TrackClickDirective, TrackSubmitDirective],\r\n imports: [CommonModule],\r\n exports: [TrackClickDirective, TrackSubmitDirective],\r\n})\r\nexport class ActivityTrackerModule {\r\n /**\r\n * Registers the ActivityTrackerModule using the Angular `forRoot()` pattern.\r\n *\r\n * This is intended for NgModule-based applications. It initializes the\r\n * analytics engine with the provided connection configuration and URL\r\n * tracking key.\r\n *\r\n * @param config - Connection configuration used by the `EventTracker` (a token)\r\n * @param urlTrackingKey - Optional key for extracting tracking identifiers\r\n * from the URL (e.g affiliate key)\r\n * @returns A `ModuleWithProviders` containing the module and its providers\r\n */\r\n\r\n static forRoot(\r\n config: ConnectionConfig,\r\n urlTrackingKey: UrlTrackingKey\r\n ): ModuleWithProviders<ActivityTrackerModule> {\r\n return {\r\n ngModule: ActivityTrackerModule,\r\n providers: [\r\n {\r\n provide: EventTracker,\r\n useValue: new EventTracker(config, urlTrackingKey),\r\n },\r\n TrackerService,\r\n ],\r\n };\r\n }\r\n}\r\n\r\n/**\r\n * Standalone-friendly provider registration for the Activity Tracker.\r\n *\r\n * This function is recommended for Angular applications using the\r\n * Standalone API (`bootstrapApplication`) and cannot use `forRoot()`.\r\n *\r\n * @example\r\n * ```ts\r\n * bootstrapApplication(AppComponent, {\r\n * providers: [\r\n * ...provideActivityTracker(config, urlTrackingKey)\r\n * ]\r\n * });\r\n * ```\r\n *\r\n * @param config - Connection configuration used by `EventTracker`\r\n * @param urlTrackingKey - Key used to extract tracking identifiers from URLs\r\n * @returns An array of Angular providers for use in standalone environments\r\n */\r\nexport function provideActivityTracker(\r\n config: ConnectionConfig,\r\n urlTrackingKey: UrlTrackingKey\r\n): Provider[] {\r\n return [\r\n {\r\n provide: EventTracker,\r\n useValue: new EventTracker(config, urlTrackingKey),\r\n },\r\n TrackerService,\r\n ];\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["i1.TrackerService"],"mappings":";;;;;;;AAQA;;;;;;;;;;;;AAYG;MAKU,cAAc,CAAA;AAEN,IAAA,YAAA;AACA,IAAA,MAAA;IAFnB,WAAA,CACmB,YAA0B,EAC1B,MAAc,EAAA;QADd,IAAA,CAAA,YAAY,GAAZ,YAAY;QACZ,IAAA,CAAA,MAAM,GAAN,MAAM;IACtB;AAEH;;;;;;;;;AASG;AACH,IAAA,UAAU,CACR,MAAwB,EACxB,KAA6B,EAC7B,OAAuC,IAAI,EAC3C,MAAM,GAAG,IAAI,EACb,QAAA,GAA2B,IAAI,EAC/B,MAAM,GAAG,EAAE,EAAA;AAEX,QAAA,IAAI,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE;YACzC,IAAI,CAAC,YAAY,CAAC,UAAU,CAC1B,MAAM,EACN,KAAK,EACL,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,GAAG,CAChB;QACH;IACF;IAEA,WAAW,GAAA;AACT,QAAA,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;IACjC;wGAvCW,cAAc,EAAA,IAAA,EAAA,CAAA,EAAA,KAAA,EAAA,EAAA,CAAA,YAAA,EAAA,EAAA,EAAA,KAAA,EAAA,EAAA,CAAA,MAAA,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAAd,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,cAAc,cAFb,MAAM,EAAA,CAAA;;4FAEP,cAAc,EAAA,UAAA,EAAA,CAAA;kBAH1B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;;ACpBD;;;;;;;;;;;;;AAaG;MAKU,mBAAmB,CAAA;AA4CD,IAAA,cAAA;AA3C7B;;;AAGG;AACwB,IAAA,MAAM;AAEjC;;;;AAIG;AACM,IAAA,KAAK,GAA2B,sBAAsB,CAAC,MAAM;AAEtE;;;AAGG;AACM,IAAA,IAAI;AAEb;;;;;AAKG;IACM,MAAM,GAAG,IAAI;AAEtB;;;;;AAKG;IACM,KAAK,GAAG,KAAK;AAEtB;;;;AAIG;IACM,MAAM,GAAG,EAAE;IACpB,OAAO,GAAG,KAAK;AAEf,IAAA,WAAA,CAA6B,cAA8B,EAAA;QAA9B,IAAA,CAAA,cAAc,GAAd,cAAc;IAAmB;IAG9D,OAAO,GAAA;AACL,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;AACd,YAAA,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO;AAC5B,YAAA,IAAI,CAAC,cAAc,CAAC,UAAU,CAC5B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,MAAM,CACZ;QACH;aAAO;YACL,IAAI,CAAC,cAAc,CAAC,UAAU,CAC5B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,MAAM,EACX,IAAI,EACJ,IAAI,CAAC,MAAM,CACZ;QACH;IACF;wGApEW,mBAAmB,EAAA,IAAA,EAAA,CAAA,EAAA,KAAA,EAAAA,cAAA,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;4FAAnB,mBAAmB,EAAA,YAAA,EAAA,KAAA,EAAA,QAAA,EAAA,oBAAA,EAAA,MAAA,EAAA,EAAA,MAAA,EAAA,CAAA,kBAAA,EAAA,QAAA,CAAA,EAAA,KAAA,EAAA,OAAA,EAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAAA,QAAA,EAAA,KAAA,EAAA,OAAA,EAAA,MAAA,EAAA,QAAA,EAAA,EAAA,IAAA,EAAA,EAAA,SAAA,EAAA,EAAA,OAAA,EAAA,WAAA,EAAA,EAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA;;4FAAnB,mBAAmB,EAAA,UAAA,EAAA,CAAA;kBAJ/B,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,QAAQ,EAAE,oBAAoB;AAC9B,oBAAA,UAAU,EAAE,KAAK;AAClB,iBAAA;;sBAME,KAAK;uBAAC,kBAAkB;;sBAOxB;;sBAMA;;sBAQA;;sBAQA;;sBAOA;;sBAKA,YAAY;uBAAC,OAAO;;;AChEvB;;;;;;;;;;;;;AAaG;MAKU,oBAAoB,CAAA;AAqBF,IAAA,cAAA;AApB7B;;;AAGG;AACyB,IAAA,MAAM;AAElC;;;AAGG;AACM,IAAA,IAAI;AAGb;;;;AAIG;IACM,MAAM,GAAG,EAAE;AAEpB,IAAA,WAAA,CAA6B,cAA8B,EAAA;QAA9B,IAAA,CAAA,cAAc,GAAd,cAAc;IAAmB;IAI9D,OAAO,GAAA;QACL,IAAI,CAAC,cAAc,CAAC,UAAU,CAC5B,IAAI,CAAC,MAAM,EACX,sBAAsB,CAAC,MAAM,EAC7B,IAAI,CAAC,IAAI,EACT,KAAK,EACL,IAAI,EACJ,IAAI,CAAC,MAAM,CACZ;IACH;wGAlCW,oBAAoB,EAAA,IAAA,EAAA,CAAA,EAAA,KAAA,EAAAA,cAAA,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;4FAApB,oBAAoB,EAAA,YAAA,EAAA,KAAA,EAAA,QAAA,EAAA,qBAAA,EAAA,MAAA,EAAA,EAAA,MAAA,EAAA,CAAA,mBAAA,EAAA,QAAA,CAAA,EAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAAA,QAAA,EAAA,EAAA,IAAA,EAAA,EAAA,SAAA,EAAA,EAAA,UAAA,EAAA,WAAA,EAAA,QAAA,EAAA,WAAA,EAAA,EAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA;;4FAApB,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAJhC,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,QAAQ,EAAE,qBAAqB;AAC/B,oBAAA,UAAU,EAAE,KAAK;AAClB,iBAAA;;sBAME,KAAK;uBAAC,mBAAmB;;sBAMzB;;sBAQA;;sBAIA,YAAY;uBAAC,UAAU;;sBACvB,YAAY;uBAAC,QAAQ;;;MCnCX,qBAAqB,CAAA;AAChC;;;;;;;;;;;AAWG;AAEH,IAAA,OAAO,OAAO,CACZ,MAAwB,EACxB,cAA8B,EAAA;QAE9B,OAAO;AACL,YAAA,QAAQ,EAAE,qBAAqB;AAC/B,YAAA,SAAS,EAAE;AACT,gBAAA;AACE,oBAAA,OAAO,EAAE,YAAY;AACrB,oBAAA,QAAQ,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC;AACnD,iBAAA;gBACD,cAAc;AACf,aAAA;SACF;IACH;wGA5BW,qBAAqB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,QAAA,EAAA,CAAA;yGAArB,qBAAqB,EAAA,YAAA,EAAA,CAJjB,mBAAmB,EAAE,oBAAoB,aAC9C,YAAY,CAAA,EAAA,OAAA,EAAA,CACZ,mBAAmB,EAAE,oBAAoB,CAAA,EAAA,CAAA;AAExC,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,mBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,qBAAqB,YAHtB,YAAY,CAAA,EAAA,CAAA;;4FAGX,qBAAqB,EAAA,UAAA,EAAA,CAAA;kBALjC,QAAQ;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,YAAY,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;oBACzD,OAAO,EAAE,CAAC,YAAY,CAAC;AACvB,oBAAA,OAAO,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;AACrD,iBAAA;;AAgCD;;;;;;;;;;;;;;;;;;AAkBG;AACG,SAAU,sBAAsB,CACpC,MAAwB,EACxB,cAA8B,EAAA;IAE9B,OAAO;AACL,QAAA;AACE,YAAA,OAAO,EAAE,YAAY;AACrB,YAAA,QAAQ,EAAE,IAAI,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC;AACnD,SAAA;QACD,cAAc;KACf;AACH;;ACxEA;;AAEG;;;;"}
package/index.d.ts CHANGED
@@ -1,7 +1,41 @@
1
1
  import * as i0 from '@angular/core';
2
- import { ModuleWithProviders, Provider, OnDestroy } from '@angular/core';
3
- import { ANALYTICS_ACTION, ANALYTICS_ACTION_STATE, ConnectionConfig, UrlTrackingKey } from '@nommos/core';
4
- import * as i1 from '@angular/common';
2
+ import { OnDestroy, ModuleWithProviders, Provider } from '@angular/core';
3
+ import { EventTracker, ANALYTICS_ACTION, ANALYTICS_ACTION_STATE, ConnectionConfig, UrlTrackingKey } from '@nommos/core';
4
+ import { Router } from '@angular/router';
5
+ import * as i3 from '@angular/common';
6
+
7
+ /**
8
+ * TrackerService
9
+ * -----------------------
10
+ * An angular utility designed to record user actions such as clicks,
11
+ * form submissions, and custom events for analytics of carried out .
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * constructor(private tracker: TrackerService) {}
16
+ *
17
+ * this.tracker.trackEvent(ANALYTICS_ACTION_GROUPS.SIGN_IN, ANALYTICS_ACTION_STATE.SUBMIT, { login: 'johndoh@example.com' }, false, null, 'u123-456-789');
18
+ * ```
19
+ */
20
+ declare class TrackerService implements OnDestroy {
21
+ private readonly eventTracker;
22
+ private readonly router;
23
+ constructor(eventTracker: EventTracker, router: Router);
24
+ /**
25
+ * collects tracked actions carried with associated informations and publishes them for storage.
26
+ *
27
+ * @param action - Name of action to be tracked.
28
+ * @param state - State associated to the action being tracked.
29
+ * @param data - Optional: information associated with the action being tracked.
30
+ * @param toggle - Enables toggling between two actions(select/unselect) for an action.
31
+ * @param selected - State of an event with select action (selected or unselected)
32
+ * @param userId - Optional: user ID associated to the current user carrying out the action.
33
+ */
34
+ trackEvent(action: ANALYTICS_ACTION, state: ANALYTICS_ACTION_STATE, data?: Record<string, unknown> | null, toggle?: boolean, selected?: boolean | null, userId?: string): void;
35
+ ngOnDestroy(): void;
36
+ static ɵfac: i0.ɵɵFactoryDeclaration<TrackerService, never>;
37
+ static ɵprov: i0.ɵɵInjectableDeclaration<TrackerService>;
38
+ }
5
39
 
6
40
  /**
7
41
  * TrackClickDirective
@@ -18,6 +52,7 @@ import * as i1 from '@angular/common';
18
52
  * ```
19
53
  */
20
54
  declare class TrackClickDirective {
55
+ private readonly trackerService;
21
56
  /**
22
57
  * The action to be tracked.
23
58
  * @type {ANALYTICS_ACTION}
@@ -55,10 +90,10 @@ declare class TrackClickDirective {
55
90
  */
56
91
  userId: string;
57
92
  clicked: boolean;
58
- private readonly trackerService;
93
+ constructor(trackerService: TrackerService);
59
94
  onClick(): void;
60
95
  static ɵfac: i0.ɵɵFactoryDeclaration<TrackClickDirective, never>;
61
- static ɵdir: i0.ɵɵDirectiveDeclaration<TrackClickDirective, "[nommosTrackClick]", never, { "action": { "alias": "nommosTrackClick"; "required": false; }; "state": { "alias": "state"; "required": false; }; "data": { "alias": "data"; "required": false; }; "toggle": { "alias": "toggle"; "required": false; }; "multi": { "alias": "multi"; "required": false; }; "userId": { "alias": "userId"; "required": false; }; }, {}, never, never, true, never>;
96
+ static ɵdir: i0.ɵɵDirectiveDeclaration<TrackClickDirective, "[nommosTrackClick]", never, { "action": { "alias": "nommosTrackClick"; "required": false; }; "state": { "alias": "state"; "required": false; }; "data": { "alias": "data"; "required": false; }; "toggle": { "alias": "toggle"; "required": false; }; "multi": { "alias": "multi"; "required": false; }; "userId": { "alias": "userId"; "required": false; }; }, {}, never, never, false, never>;
62
97
  }
63
98
 
64
99
  /**
@@ -76,6 +111,7 @@ declare class TrackClickDirective {
76
111
  * ```
77
112
  */
78
113
  declare class TrackSubmitDirective {
114
+ private readonly trackerService;
79
115
  /**
80
116
  * The action to be tracked.
81
117
  * @type {ANALYTICS_ACTION}
@@ -92,10 +128,10 @@ declare class TrackSubmitDirective {
92
128
  * @type {string}
93
129
  */
94
130
  userId: string;
95
- private readonly trackerService;
131
+ constructor(trackerService: TrackerService);
96
132
  onClick(): void;
97
133
  static ɵfac: i0.ɵɵFactoryDeclaration<TrackSubmitDirective, never>;
98
- static ɵdir: i0.ɵɵDirectiveDeclaration<TrackSubmitDirective, "[nommosTrackSubmit]", never, { "action": { "alias": "nommosTrackSubmit"; "required": false; }; "data": { "alias": "data"; "required": false; }; "userId": { "alias": "userId"; "required": false; }; }, {}, never, never, true, never>;
134
+ static ɵdir: i0.ɵɵDirectiveDeclaration<TrackSubmitDirective, "[nommosTrackSubmit]", never, { "action": { "alias": "nommosTrackSubmit"; "required": false; }; "data": { "alias": "data"; "required": false; }; "userId": { "alias": "userId"; "required": false; }; }, {}, never, never, false, never>;
99
135
  }
100
136
 
101
137
  declare class ActivityTrackerModule {
@@ -113,7 +149,7 @@ declare class ActivityTrackerModule {
113
149
  */
114
150
  static forRoot(config: ConnectionConfig, urlTrackingKey: UrlTrackingKey): ModuleWithProviders<ActivityTrackerModule>;
115
151
  static ɵfac: i0.ɵɵFactoryDeclaration<ActivityTrackerModule, never>;
116
- static ɵmod: i0.ɵɵNgModuleDeclaration<ActivityTrackerModule, never, [typeof i1.CommonModule, typeof TrackClickDirective, typeof TrackSubmitDirective], [typeof TrackClickDirective, typeof TrackSubmitDirective]>;
152
+ static ɵmod: i0.ɵɵNgModuleDeclaration<ActivityTrackerModule, [typeof TrackClickDirective, typeof TrackSubmitDirective], [typeof i3.CommonModule], [typeof TrackClickDirective, typeof TrackSubmitDirective]>;
117
153
  static ɵinj: i0.ɵɵInjectorDeclaration<ActivityTrackerModule>;
118
154
  }
119
155
  /**
@@ -137,36 +173,4 @@ declare class ActivityTrackerModule {
137
173
  */
138
174
  declare function provideActivityTracker(config: ConnectionConfig, urlTrackingKey: UrlTrackingKey): Provider[];
139
175
 
140
- /**
141
- * TrackerService
142
- * -----------------------
143
- * An angular utility designed to record user actions such as clicks,
144
- * form submissions, and custom events for analytics of carried out .
145
- *
146
- * @example
147
- * ```ts
148
- * constructor(private tracker: TrackerService) {}
149
- *
150
- * this.tracker.trackEvent(ANALYTICS_ACTION_GROUPS.SIGN_IN, ANALYTICS_ACTION_STATE.SUBMIT, { login: 'johndoh@example.com' }, false, null, 'u123-456-789');
151
- * ```
152
- */
153
- declare class TrackerService implements OnDestroy {
154
- private readonly eventTracker;
155
- private readonly router;
156
- /**
157
- * collects tracked actions carried with associated informations and publishes them for storage.
158
- *
159
- * @param action - Name of action to be tracked.
160
- * @param state - State associated to the action being tracked.
161
- * @param data - Optional: information associated with the action being tracked.
162
- * @param toggle - Enables toggling between two actions(select/unselect) for an action.
163
- * @param selected - State of an event with select action (selected or unselected)
164
- * @param userId - Optional: user ID associated to the current user carrying out the action.
165
- */
166
- trackEvent(action: ANALYTICS_ACTION, state: ANALYTICS_ACTION_STATE, data?: Record<string, unknown> | null, toggle?: boolean, selected?: boolean | null, userId?: string): void;
167
- ngOnDestroy(): void;
168
- static ɵfac: i0.ɵɵFactoryDeclaration<TrackerService, never>;
169
- static ɵprov: i0.ɵɵInjectableDeclaration<TrackerService>;
170
- }
171
-
172
176
  export { ActivityTrackerModule, TrackClickDirective, TrackSubmitDirective, TrackerService, provideActivityTracker };
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "@nommos/events_angular",
3
- "version": "0.0.6",
3
+ "version": "0.0.8",
4
4
  "peerDependencies": {
5
- "@angular/common": ">=14.0.0 <=22.0.0",
6
- "@angular/core": ">=14.0.0 <=22.0.0",
7
- "@angular/router": ">=14.0.0 <=22.0.0"
5
+ "@angular/common": ">=12.0.0 <=22.0.0",
6
+ "@angular/core": ">=12.0.0 <=22.0.0",
7
+ "@angular/router": ">=12.0.0 <=22.0.0"
8
8
  },
9
9
  "dependencies": {
10
- "@nommos/core": "0.0.6",
10
+ "@nommos/core": "0.0.8",
11
11
  "tslib": "^2.3.0"
12
12
  },
13
13
  "engines": {