@nommos/events_angular 0.0.6 → 0.0.7

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 +24 -13
  2. package/fesm2022/nommos-events_angular.mjs.map +1 -1
  3. package/index.d.ts +40 -36
  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,7 +118,7 @@ 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 });
121
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackClickDirective, deps: [{ token: TrackerService }], target: i0.ɵɵFactoryTarget.Directive });
114
122
  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 });
115
123
  }
116
124
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackClickDirective, decorators: [{
@@ -118,7 +126,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImpo
118
126
  args: [{
119
127
  selector: '[nommosTrackClick]',
120
128
  }]
121
- }], propDecorators: { action: [{
129
+ }], ctorParameters: () => [{ type: TrackerService }], propDecorators: { action: [{
122
130
  type: Input,
123
131
  args: ['nommosTrackClick']
124
132
  }], state: [{
@@ -151,6 +159,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImpo
151
159
  * ```
152
160
  */
153
161
  class TrackSubmitDirective {
162
+ trackerService;
154
163
  /**
155
164
  * The action to be tracked.
156
165
  * @type {ANALYTICS_ACTION}
@@ -167,11 +176,13 @@ class TrackSubmitDirective {
167
176
  * @type {string}
168
177
  */
169
178
  userId = '';
170
- trackerService = inject(TrackerService);
179
+ constructor(trackerService) {
180
+ this.trackerService = trackerService;
181
+ }
171
182
  onClick() {
172
183
  this.trackerService.trackEvent(this.action, ANALYTICS_ACTION_STATE.SUBMIT, this.data, false, null, this.userId);
173
184
  }
174
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackSubmitDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
185
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackSubmitDirective, deps: [{ token: TrackerService }], target: i0.ɵɵFactoryTarget.Directive });
175
186
  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 });
176
187
  }
177
188
  i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImport: i0, type: TrackSubmitDirective, decorators: [{
@@ -179,7 +190,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.11", ngImpo
179
190
  args: [{
180
191
  selector: '[nommosTrackSubmit]',
181
192
  }]
182
- }], propDecorators: { action: [{
193
+ }], ctorParameters: () => [{ type: TrackerService }], propDecorators: { action: [{
183
194
  type: Input,
184
195
  args: ['nommosTrackSubmit']
185
196
  }], data: [{
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})\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})\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 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":["i1.TrackerService"],"mappings":"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"}
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';
2
+ import { OnDestroy, ModuleWithProviders, Provider } from '@angular/core';
3
+ import { EventTracker, ANALYTICS_ACTION, ANALYTICS_ACTION_STATE, ConnectionConfig, UrlTrackingKey } from '@nommos/core';
4
4
  import * as i1 from '@angular/common';
5
+ import { Router } from '@angular/router';
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,7 +90,7 @@ 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
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, true, never>;
@@ -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,7 +128,7 @@ 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
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, true, never>;
@@ -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.7",
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.7",
11
11
  "tslib": "^2.3.0"
12
12
  },
13
13
  "engines": {