@su-labs/visit-tracker 1.0.3 → 19.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,79 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [22.1.1] - 2026-11-14
9
+
10
+ ### Changed
11
+ - Package homepage now points to the website with a live demo
12
+ - Pins `@su-labs/core` to exactly 1.8.0
13
+
14
+ ## [22.1.0] - 2026-11-05
15
+
16
+ ### Changed
17
+ - Visit tracking moved to the framework-agnostic `@su-labs/core/visit-tracker`; `SuVisitTrackerService` is now a thin wrapper with the same API
18
+ - `SuVisitTrackerConfig` and `SuVisitData` are now re-exported from `@su-labs/core/visit-tracker`
19
+ - Added `@su-labs/core` as a dependency
20
+ - README links to the `@su-labs/core` installation guides for non-Angular projects
21
+
22
+ ### Fixed
23
+ - Corrupted or invalid saved data no longer throws; counting starts over
24
+ - `init()` no longer sorts the `milestoneVisits` array passed in the config
25
+ - Safe to call during server-side rendering (no `localStorage` access without a browser)
26
+ - README now documents the actual API (`milestone()` signal, `init()` required)
27
+ - Repair table of contents links in README.md
28
+
29
+ ## [22.0.0] - 2026-11-04
30
+
31
+ ### Changed
32
+ - Upgrade to Angular 22 (peer dependencies now `^22.0.0`)
33
+ - Remove emojis from README.md
34
+
35
+ ## [21.0.5] - 2026-02-04
36
+
37
+ ### Changed
38
+ - Update README.md
39
+
40
+ ## [21.0.4] - 2026-02-03
41
+
42
+ ### Changed
43
+ - **BREAKING:** Updated to Angular 21 support. This version requires Angular 21.0.0 or higher.
44
+ - Updated peer dependencies to `@angular/common: ^21.0.0` and `@angular/core: ^21.0.0`.
45
+ - Aligned package version with Angular major version for clearer compatibility (v21.x.x = Angular 21 support).
46
+
47
+ ### Notes
48
+ - Projects using Angular 20 or below should continue using version 1.0.3.
49
+ - This release maintains full backward compatibility with the 1.x API - only the Angular version requirement has changed.
50
+ s
51
+
52
+ ## [1.0.3] - 2025-08-30
53
+
54
+ ### Fixed
55
+ - Removed unintended `.spec.ts` exports from the public API surface.
56
+ - Ensured `"license": "MIT"` is correctly reflected in the published package metadata.
57
+
58
+
59
+ ## [1.0.2] - 2025-08-30
60
+
61
+ ### Note
62
+ - This version was published with incorrect package content and is deprecated. Please use `1.0.4`.
63
+
64
+ ## [1.0.1] - 2025-08-27
65
+
66
+ ### Changed
67
+ - Updated documentation (`README.md`) to reflect new scoped package import:
68
+ from `./su-visit-tracker.service` → `@su-labs/visit-tracker`.
69
+
70
+ ## [1.0.0] - 2024-08-26
71
+
72
+ ### Added
73
+
74
+ - Initial public release of the @su-labs/visit-tracker library.
75
+ - Introduction of SuVisitTrackerService, a lightweight service for tracking user visits.
76
+ - Reactive `Signal`s for `count`, `lastVisit`, `isTenthVisit`, and `isHundredthVisit`.
77
+ - Persistent storage of visit data in `localStorage`.
78
+ - Support for custom milestone visits via `milestoneVisits` configuration.
79
+ - Full support for modern Angular applications using `inject()` and `provideAppInitializer`.
package/README.md CHANGED
@@ -1,12 +1,50 @@
1
1
  # SuVisitTrackerService
2
2
 
3
+ `@su-labs/visit-tracker`
4
+
5
+ ![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white)
6
+ ![Angular Version](https://img.shields.io/badge/Angular-v22-DD0031?style=for-the-badge&logo=angular&logoColor=white)
7
+ ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
8
+ ![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)
9
+ ![NPM](https://img.shields.io/badge/NPM-CB3837?style=for-the-badge&logo=npm&logoColor=white)
10
+ ![Size](https://img.shields.io/badge/Size-Small-green.svg?style=for-the-badge)
11
+ ![Downloads](https://img.shields.io/npm/dt/@su-labs/visit-tracker?style=for-the-badge)
12
+ ![Version](https://img.shields.io/npm/v/@su-labs/visit-tracker?style=for-the-badge)
13
+
3
14
  A lightweight Angular service to track user visits. Provides reactive signals for visit count, last visit date, and milestone visits.
4
15
 
16
+ > **Not using Angular?** The same visit tracker is available for React, Vue, Svelte and vanilla JavaScript in [`@su-labs/core`](https://www.npmjs.com/package/@su-labs/core). See the [installation guides](https://github.com/Greezaaa/settings-utils-lib/blob/main/docs/README.md).
17
+
18
+ ## Table of Contents
19
+
20
+ - [Why Use This Library?](#why-use-this-library)
21
+ - [Features](#features)
22
+ - [Installation](#installation)
23
+ - [Quick Start](#quick-start)
24
+ - [Usage](#usage)
25
+ - [API Reference](#api-reference)
26
+ - [Configuration Options](#configuration-options)
27
+ - [Browser Compatibility](#browser-compatibility)
28
+ - [Related Libraries](#related-libraries)
29
+ - [Troubleshooting](#troubleshooting)
30
+ - [Support](#support)
31
+ - [Contributing](#contributing)
32
+ - [License](#license)
33
+
34
+ ## Why Use This Library?
35
+
36
+ - **Lightweight** - Minimal bundle size
37
+ - **Reactive** - Built with Angular Signals
38
+ - **Type-Safe** - Full TypeScript support
39
+ - **SSR Safe** - No browser APIs are touched on the server
40
+ - **Well Tested** - Comprehensive test coverage
41
+ - **Well Documented** - Clear examples and API docs
42
+
5
43
  ## Features
6
44
 
7
45
  * Tracks number of visits per user.
8
46
  * Persists visit data in `localStorage`.
9
- * Signals for milestones (e.g., 10th, 100th visit).
47
+ * Milestone signal (e.g., 10th, 100th visit).
10
48
  * Reactive last visit date signal.
11
49
  * Configurable storage key and milestones.
12
50
  * Works seamlessly with standalone components and reactive Angular setups.
@@ -24,29 +62,60 @@ npm install @su-labs/visit-tracker
24
62
  This library requires the following peer dependencies:
25
63
 
26
64
  ```sh
27
- npm install @angular/common@^20.1.0 @angular/core@^20.1.0
65
+ npm install @angular/common@^22 @angular/core@^22
66
+ ```
67
+
68
+ ## Quick Start
69
+
70
+ 1. Record the visit once at startup in `app.config.ts`:
71
+
72
+ ```typescript
73
+ import { ApplicationConfig, inject, provideAppInitializer } from '@angular/core';
74
+ import { SuVisitTrackerService } from '@su-labs/visit-tracker';
75
+
76
+ export const appConfig: ApplicationConfig = {
77
+ providers: [
78
+ provideAppInitializer(() => {
79
+ inject(SuVisitTrackerService).init();
80
+ }),
81
+ ],
82
+ };
83
+ ```
84
+
85
+ 2. Read the signals in any component:
86
+
87
+ ```typescript
88
+ import { Component, inject } from '@angular/core';
89
+ import { SuVisitTrackerService } from '@su-labs/visit-tracker';
90
+
91
+ @Component({
92
+ selector: 'app-root',
93
+ template: `<p>Visits: {{ visitService.count() }}</p>`,
94
+ })
95
+ export class AppComponent {
96
+ protected readonly visitService = inject(SuVisitTrackerService);
97
+ }
28
98
  ```
29
99
 
30
100
  ## Usage
31
- ### Example 1: Basic initialization
32
- The service should be provided at the root level. To use it in a component, simply inject it:
33
101
 
34
- ```TypeScript
102
+ ### Example 1: Welcome back message
103
+ After `init()` has run (see [Quick Start](#quick-start)), inject the service wherever you need it:
35
104
 
105
+ ```TypeScript
36
106
  import { Component, inject } from '@angular/core';
37
- import { CommonModule, DatePipe } from '@angular/common';
107
+ import { DatePipe } from '@angular/common';
38
108
  import { SuVisitTrackerService } from '@su-labs/visit-tracker';
39
109
 
40
110
  @Component({
41
111
  selector: 'app-root',
42
- standalone: true,
43
- imports: [CommonModule, DatePipe],
112
+ imports: [DatePipe],
44
113
  template: `
45
114
  <h1>Welcome back!</h1>
46
115
  <p>You have visited {{ visitService.count() }} times.</p>
47
- <ng-container *ngIf="visitService.lastVisit() as last">
48
- <p>Last visit: {{ last | date:'medium' }}</p>
49
- </ng-container>
116
+ @if (visitService.lastVisit(); as last) {
117
+ <p>Last visit: {{ last | date: 'medium' }}</p>
118
+ }
50
119
  `,
51
120
  })
52
121
  export class AppComponent {
@@ -54,29 +123,28 @@ export class AppComponent {
54
123
  }
55
124
  ```
56
125
 
57
- ✅ Automatically increments the visit count and updates the last visit timestamp.
126
+ Each `init()` call increments the visit count and saves the start of this visit for next time.
58
127
 
59
128
  ### Example 2: Checking milestone visits
60
- You can reactively check if a milestone visit has been reached:
129
+ `milestone()` holds the milestone reached on this visit, or `null`:
61
130
 
62
131
  ```HTML
63
-
64
- @if(visitService.isTenthVisit()){
65
- <p>🎉 Congratulations on your 10th visit!</p>
132
+ @switch (visitService.milestone()) {
133
+ @case (10) {
134
+ <p>Congratulations on your 10th visit!</p>
66
135
  }
67
-
68
- @if(visitService.isHundredthVisit()){
69
- <p>🏆 100 visits! You're a power user!</p>
136
+ @case (100) {
137
+ <p>100 visits! You're a power user!</p>
70
138
  }
139
+ }
71
140
  ```
72
141
 
73
- Signals `isTenthVisit` and `isHundredthVisit` update automatically on service initialization.
142
+ The signal is set when `init()` runs.
74
143
 
75
144
  ### Example 3: Custom configuration
76
145
  For standalone apps, use provideAppInitializer to initialize the tracker with a custom storage key or milestones:
77
146
 
78
147
  ```TypeScript
79
-
80
148
  import { provideAppInitializer, inject } from '@angular/core';
81
149
  import { SuVisitTrackerService, SuVisitTrackerConfig } from '@su-labs/visit-tracker';
82
150
 
@@ -93,24 +161,48 @@ export const appConfig = {
93
161
  }),
94
162
  ],
95
163
  };
96
-
97
164
  ```
98
- ✅ Allows overriding the localStorage key and defining custom milestone visits.
99
165
 
100
- ### Example 4: Using last visit date
166
+ Allows overriding the localStorage key and defining custom milestone visits.
101
167
 
102
- ```HTML
168
+ ### Example 4: Using last visit date
103
169
 
104
- @if(visitService.lastVisit() as last) {
170
+ ```HTML
171
+ @if (visitService.lastVisit(); as last) {
105
172
  <p>
106
173
  Your last visit was on {{ last | date:'fullDate' }} at {{ last | date:'shortTime' }}
107
174
  </p>
108
- }
175
+ }
109
176
  ```
110
177
 
111
178
  The service stores last visit as an ISO string (e.g., "2025-08-25T12:34:56.789Z"), so it can easily be used in Angular date pipes.
112
179
 
113
- ## Configuration Options
180
+ ## API Reference
181
+
182
+ ### Signals
183
+
184
+ | Signal | Type | Description |
185
+ |--------|------|-------------|
186
+ | `count()` | `number` | Visit count including this visit (`0` before `init()`) |
187
+ | `lastVisit()` | `string \| null` | Start of the previous visit as an ISO string, or `null` on the first visit |
188
+ | `milestone()` | `number \| null` | Milestone reached on this visit, or `null` |
189
+
190
+ ### Methods
191
+
192
+ | Method | Parameters | Description |
193
+ |--------|------------|-------------|
194
+ | `init(config?)` | `SuVisitTrackerConfig` | Record the current visit. Call once at startup. |
195
+
196
+ ### Types
197
+
198
+ ```typescript
199
+ interface SuVisitTrackerConfig {
200
+ storageKey?: string; // Default: 'su:visits'
201
+ milestoneVisits?: number[]; // Default: [10, 100]
202
+ }
203
+ ```
204
+
205
+ ## Configuration Options
114
206
 
115
207
  The service can be configured to fit your application's needs. You can customize the storage key and milestone values by passing a configuration object to the `init()` method.
116
208
 
@@ -119,15 +211,59 @@ The service can be configured to fit your application's needs. You can customize
119
211
  | `storageKey` | The key used to persist the visit data in `localStorage`. | `'su:visits'` |
120
212
  | `milestoneVisits` | An array of numbers representing visits to track as milestones. | `[10, 100]` |
121
213
 
122
- ## Notes
214
+ ## Browser Compatibility
215
+
216
+ Works in all modern browsers that support:
217
+ - localStorage API
218
+ - Angular 22+
219
+ - ES2022+
123
220
 
124
- - Signals-based API: Perfect for standalone components and reactive Angular templates.
221
+ | Browser | Version |
222
+ |---------|---------|
223
+ | Chrome | ≥ 90 |
224
+ | Firefox | ≥ 88 |
225
+ | Safari | ≥ 14 |
226
+ | Edge | ≥ 90 |
125
227
 
126
- - Persistence: Visit count and last visit are automatically stored in localStorage.
228
+ ## Related Libraries
127
229
 
128
- - Lightweight: No external dependencies and minimal memory footprint.
230
+ Part of the **@su-labs** suite:
129
231
 
130
- - Custom milestones: Track any number of user visit milestones reactively.
232
+ - [@su-labs/theme](https://www.npmjs.com/package/@su-labs/theme) - Theme management with dark mode support
233
+ - [@su-labs/notifications](https://www.npmjs.com/package/@su-labs/notifications) - Toast notification system
234
+ - [@su-labs/scroll-spy](https://www.npmjs.com/package/@su-labs/scroll-spy) - Scroll position tracking
235
+ - [@su-labs/font-size](https://www.npmjs.com/package/@su-labs/font-size) - Accessible font size controls
236
+
237
+ ## Troubleshooting
238
+
239
+ ### Visit count not persisting?
240
+
241
+ Make sure localStorage is enabled in your browser and not blocked by privacy settings.
242
+
243
+ ### Count stays at 0?
244
+
245
+ The visit is only recorded when `init()` runs. Call it once at startup, as shown in [Quick Start](#quick-start).
246
+
247
+ ### Milestone signal not updating?
248
+
249
+ Milestones are only checked when `init()` runs, once per visit.
250
+
251
+ ### TypeScript errors?
252
+
253
+ Ensure you have Angular 22+ and TypeScript 6.0+ installed.
254
+
255
+ ## Support
256
+
257
+ - Found a bug? [Open an issue](https://github.com/Greezaaa/settings-utils-lib/issues)
258
+ - Have a feature request? [Start a discussion](https://github.com/Greezaaa/settings-utils-lib/discussions)
259
+ - Like this library? [Give it a star!](https://github.com/Greezaaa/settings-utils-lib)
260
+
261
+ ## Notes
262
+
263
+ - **Signals-based API**: Perfect for standalone components and reactive Angular templates.
264
+ - **Persistence**: Visit count and last visit are automatically stored in localStorage.
265
+ - **Lightweight**: Minimal memory footprint.
266
+ - **Custom milestones**: Track any number of user visit milestones reactively.
131
267
 
132
268
  ## Contributing
133
269
 
@@ -137,5 +273,4 @@ To contribute code, please ensure your changes include unit tests to maintain co
137
273
 
138
274
  ## License
139
275
 
140
- This project is licensed under the MIT License. See the [**LICENSE**](https://github.com/Greezaaa/settings-utils-lib/blob/main/projects/su-labs/visit-tracker/LICENSE) file for details.
141
-
276
+ This project is licensed under the MIT License. See the [**LICENSE**](https://github.com/Greezaaa/settings-utils-lib/blob/main/projects/su-labs/visit-tracker/LICENSE) file for details.
@@ -1,52 +1,48 @@
1
1
  import * as i0 from '@angular/core';
2
2
  import { signal, Injectable } from '@angular/core';
3
+ import { SuVisitTrackerController } from '@su-labs/core/visit-tracker';
3
4
 
5
+ /**
6
+ * Angular service for tracking user visits.
7
+ *
8
+ * Thin wrapper around the framework-agnostic `SuVisitTrackerController` from
9
+ * `@su-labs/core/visit-tracker` that exposes the visit data as Angular signals.
10
+ */
4
11
  class SuVisitTrackerService {
5
- /** Key used for localStorage */
6
- storageKey = 'su:visits';
7
- /** Milestones to track */
8
- _milestones = [10, 100];
9
- /** Current visit count */
10
- count = signal(0, ...(ngDevMode ? [{ debugName: "count" }] : []));
11
- /** Last visit date as ISO string */
12
- lastVisit = signal(null, ...(ngDevMode ? [{ debugName: "lastVisit" }] : []));
12
+ /** Framework-agnostic visit tracking logic */
13
+ controller = new SuVisitTrackerController();
14
+ /** Current visit count (0 until {@link init} runs) */
15
+ count = signal(0);
16
+ /** Start of the previous visit as an ISO string, or null on the first visit */
17
+ lastVisit = signal(null);
13
18
  /** The number of the milestone reached on the current visit, or null */
14
- milestone = signal(null, ...(ngDevMode ? [{ debugName: "milestone" }] : []));
15
- /** Initialize the service and update signals */
19
+ milestone = signal(null);
20
+ /** Stops syncing the controller's state into the signals */
21
+ unsubscribe = this.controller.visit.subscribe((visit) => {
22
+ this.count.set(visit.count);
23
+ this.lastVisit.set(visit.lastVisit);
24
+ this.milestone.set(visit.milestone);
25
+ });
26
+ /**
27
+ * Record the current visit and update the signals.
28
+ * Call once at application startup.
29
+ * @param config Optional storage key and milestones.
30
+ */
16
31
  init(config) {
17
- if (config?.storageKey) {
18
- this.storageKey = config.storageKey;
19
- }
20
- if (config?.milestoneVisits && Array.isArray(config.milestoneVisits)) {
21
- this._milestones = config.milestoneVisits.sort((a, b) => a - b);
22
- }
23
- const storedData = localStorage.getItem(this.storageKey);
24
- const stored = storedData ? JSON.parse(storedData) : {};
25
- const prevCount = stored.count ?? 0;
26
- const prevDate = stored.lastVisit ?? null;
27
- const newCount = prevCount + 1;
28
- this.count.set(newCount);
29
- this.lastVisit.set(prevDate);
30
- this.updateMilestone(newCount);
31
- localStorage.setItem(this.storageKey, JSON.stringify({ count: newCount, lastVisit: new Date().toISOString() }));
32
+ this.controller.init(config);
32
33
  }
33
- /** Update the milestone signal based on the current count */
34
- updateMilestone(count) {
35
- const reachedMilestone = this._milestones.find(m => m === count);
36
- this.milestone.set(reachedMilestone ?? null);
34
+ /** Angular lifecycle hook for service destruction */
35
+ ngOnDestroy() {
36
+ this.unsubscribe();
37
37
  }
38
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.7", ngImport: i0, type: SuVisitTrackerService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
39
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.7", ngImport: i0, type: SuVisitTrackerService, providedIn: 'root' });
38
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: SuVisitTrackerService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
39
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: SuVisitTrackerService, providedIn: 'root' });
40
40
  }
41
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.7", ngImport: i0, type: SuVisitTrackerService, decorators: [{
41
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: SuVisitTrackerService, decorators: [{
42
42
  type: Injectable,
43
43
  args: [{ providedIn: 'root' }]
44
44
  }] });
45
45
 
46
- /*
47
- * Public API Surface of visit-tracker
48
- */
49
-
50
46
  /**
51
47
  * Generated bundle index. Do not edit.
52
48
  */
@@ -1 +1 @@
1
- {"version":3,"file":"su-labs-visit-tracker.mjs","sources":["../../../../projects/su-labs/visit-tracker/src/lib/visit-tracker.service.ts","../../../../projects/su-labs/visit-tracker/src/public-api.ts","../../../../projects/su-labs/visit-tracker/src/su-labs-visit-tracker.ts"],"sourcesContent":["import { Injectable, signal, WritableSignal } from '@angular/core';\nimport { SuVisitData, SuVisitTrackerConfig } from './visit-tracker.types';\n\n@Injectable({ providedIn: 'root' })\nexport class SuVisitTrackerService {\n /** Key used for localStorage */\n private storageKey = 'su:visits';\n\n /** Milestones to track */\n private _milestones: number[] = [10, 100];\n\n /** Current visit count */\n public count: WritableSignal<number> = signal(0);\n\n /** Last visit date as ISO string */\n public lastVisit: WritableSignal<string | null> = signal(null);\n\n /** The number of the milestone reached on the current visit, or null */\n public milestone: WritableSignal<number | null> = signal(null);\n\n /** Initialize the service and update signals */\n public init(config?: SuVisitTrackerConfig): void {\n if (config?.storageKey) {\n this.storageKey = config.storageKey;\n }\n if (config?.milestoneVisits && Array.isArray(config.milestoneVisits)) {\n this._milestones = config.milestoneVisits.sort((a, b) => a - b);\n }\n\n const storedData = localStorage.getItem(this.storageKey);\n const stored: Partial<SuVisitData> = storedData ? JSON.parse(storedData) : {};\n\n const prevCount = stored.count ?? 0;\n const prevDate = stored.lastVisit ?? null;\n const newCount = prevCount + 1;\n\n this.count.set(newCount);\n this.lastVisit.set(prevDate);\n\n this.updateMilestone(newCount);\n\n localStorage.setItem(\n this.storageKey,\n JSON.stringify({ count: newCount, lastVisit: new Date().toISOString() }),\n );\n }\n\n /** Update the milestone signal based on the current count */\n private updateMilestone(count: number): void {\n const reachedMilestone = this._milestones.find(m => m === count);\n this.milestone.set(reachedMilestone ?? null);\n }\n}\n","/*\n * Public API Surface of visit-tracker\n */\n\nexport * from './lib/visit-tracker.types';\nexport * from './lib/visit-tracker.service';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;MAIa,qBAAqB,CAAA;;IAExB,UAAU,GAAG,WAAW;;AAGxB,IAAA,WAAW,GAAa,CAAC,EAAE,EAAE,GAAG,CAAC;;AAGlC,IAAA,KAAK,GAA2B,MAAM,CAAC,CAAC,iDAAC;;AAGzC,IAAA,SAAS,GAAkC,MAAM,CAAC,IAAI,qDAAC;;AAGvD,IAAA,SAAS,GAAkC,MAAM,CAAC,IAAI,qDAAC;;AAGvD,IAAA,IAAI,CAAC,MAA6B,EAAA;AACvC,QAAA,IAAI,MAAM,EAAE,UAAU,EAAE;AACtB,YAAA,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU;;AAErC,QAAA,IAAI,MAAM,EAAE,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE;YACpE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;;QAGjE,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;AACxD,QAAA,MAAM,MAAM,GAAyB,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE;AAE7E,QAAA,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;AACnC,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI;AACzC,QAAA,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC;AAE9B,QAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;AACxB,QAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE5B,QAAA,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;QAE9B,YAAY,CAAC,OAAO,CAClB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CACzE;;;AAIK,IAAA,eAAe,CAAC,KAAa,EAAA;AACnC,QAAA,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC;QAChE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;;uGA9CnC,qBAAqB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAArB,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,qBAAqB,cADR,MAAM,EAAA,CAAA;;2FACnB,qBAAqB,EAAA,UAAA,EAAA,CAAA;kBADjC,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;ACHlC;;AAEG;;ACFH;;AAEG;;;;"}
1
+ {"version":3,"file":"su-labs-visit-tracker.mjs","sources":["../../../../compat/angular-19/build/visit-tracker/src/lib/visit-tracker.service.ts","../../../../compat/angular-19/build/visit-tracker/src/su-labs-visit-tracker.ts"],"sourcesContent":["import { Injectable, OnDestroy, signal, WritableSignal } from '@angular/core';\nimport { SuVisitTrackerConfig, SuVisitTrackerController } from '@su-labs/core/visit-tracker';\n\n/**\n * Angular service for tracking user visits.\n *\n * Thin wrapper around the framework-agnostic `SuVisitTrackerController` from\n * `@su-labs/core/visit-tracker` that exposes the visit data as Angular signals.\n */\n@Injectable({ providedIn: 'root' })\nexport class SuVisitTrackerService implements OnDestroy {\n /** Framework-agnostic visit tracking logic */\n private readonly controller = new SuVisitTrackerController();\n\n /** Current visit count (0 until {@link init} runs) */\n public count: WritableSignal<number> = signal(0);\n\n /** Start of the previous visit as an ISO string, or null on the first visit */\n public lastVisit: WritableSignal<string | null> = signal(null);\n\n /** The number of the milestone reached on the current visit, or null */\n public milestone: WritableSignal<number | null> = signal(null);\n\n /** Stops syncing the controller's state into the signals */\n private readonly unsubscribe = this.controller.visit.subscribe((visit) => {\n this.count.set(visit.count);\n this.lastVisit.set(visit.lastVisit);\n this.milestone.set(visit.milestone);\n });\n\n /**\n * Record the current visit and update the signals.\n * Call once at application startup.\n * @param config Optional storage key and milestones.\n */\n public init(config?: SuVisitTrackerConfig): void {\n this.controller.init(config);\n }\n\n /** Angular lifecycle hook for service destruction */\n ngOnDestroy(): void {\n this.unsubscribe();\n }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;AAGA;;;;;AAKG;MAEU,qBAAqB,CAAA;;AAEf,IAAA,UAAU,GAAG,IAAI,wBAAwB,EAAE;;AAGrD,IAAA,KAAK,GAA2B,MAAM,CAAC,CAAC,CAAC;;AAGzC,IAAA,SAAS,GAAkC,MAAM,CAAC,IAAI,CAAC;;AAGvD,IAAA,SAAS,GAAkC,MAAM,CAAC,IAAI,CAAC;;AAG7C,IAAA,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,KAAI;QACvE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;AACrC,IAAA,CAAC,CAAC;AAEF;;;;AAIG;AACI,IAAA,IAAI,CAAC,MAA6B,EAAA;AACvC,QAAA,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;IAC9B;;IAGA,WAAW,GAAA;QACT,IAAI,CAAC,WAAW,EAAE;IACpB;wGAhCW,qBAAqB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAArB,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,SAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,qBAAqB,cADR,MAAM,EAAA,CAAA;;4FACnB,qBAAqB,EAAA,UAAA,EAAA,CAAA;kBADjC,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;ACTlC;;AAEG;;;;"}
package/index.d.ts CHANGED
@@ -1,41 +1,5 @@
1
- import * as i0 from '@angular/core';
2
- import { WritableSignal } from '@angular/core';
3
-
4
1
  /**
5
- * Configuration options for SuVisitTrackerService
2
+ * Generated bundle index. Do not edit.
6
3
  */
7
- interface SuVisitTrackerConfig {
8
- /** Key used for storing visit data in localStorage (default: 'su:visits') */
9
- storageKey?: string;
10
- /** Milestones to track, e.g., 10th visit, 100th visit */
11
- milestoneVisits?: number[];
12
- }
13
- /**
14
- * Shape of the data stored in localStorage
15
- */
16
- interface SuVisitData {
17
- count: number;
18
- lastVisit: string;
19
- }
20
-
21
- declare class SuVisitTrackerService {
22
- /** Key used for localStorage */
23
- private storageKey;
24
- /** Milestones to track */
25
- private _milestones;
26
- /** Current visit count */
27
- count: WritableSignal<number>;
28
- /** Last visit date as ISO string */
29
- lastVisit: WritableSignal<string | null>;
30
- /** The number of the milestone reached on the current visit, or null */
31
- milestone: WritableSignal<number | null>;
32
- /** Initialize the service and update signals */
33
- init(config?: SuVisitTrackerConfig): void;
34
- /** Update the milestone signal based on the current count */
35
- private updateMilestone;
36
- static ɵfac: i0.ɵɵFactoryDeclaration<SuVisitTrackerService, never>;
37
- static ɵprov: i0.ɵɵInjectableDeclaration<SuVisitTrackerService>;
38
- }
39
-
40
- export { SuVisitTrackerService };
41
- export type { SuVisitData, SuVisitTrackerConfig };
4
+ /// <amd-module name="@su-labs/visit-tracker" />
5
+ export * from './public-api';
@@ -0,0 +1,31 @@
1
+ import { OnDestroy, WritableSignal } from '@angular/core';
2
+ import { SuVisitTrackerConfig } from '@su-labs/core/visit-tracker';
3
+ import * as i0 from "@angular/core";
4
+ /**
5
+ * Angular service for tracking user visits.
6
+ *
7
+ * Thin wrapper around the framework-agnostic `SuVisitTrackerController` from
8
+ * `@su-labs/core/visit-tracker` that exposes the visit data as Angular signals.
9
+ */
10
+ export declare class SuVisitTrackerService implements OnDestroy {
11
+ /** Framework-agnostic visit tracking logic */
12
+ private readonly controller;
13
+ /** Current visit count (0 until {@link init} runs) */
14
+ count: WritableSignal<number>;
15
+ /** Start of the previous visit as an ISO string, or null on the first visit */
16
+ lastVisit: WritableSignal<string | null>;
17
+ /** The number of the milestone reached on the current visit, or null */
18
+ milestone: WritableSignal<number | null>;
19
+ /** Stops syncing the controller's state into the signals */
20
+ private readonly unsubscribe;
21
+ /**
22
+ * Record the current visit and update the signals.
23
+ * Call once at application startup.
24
+ * @param config Optional storage key and milestones.
25
+ */
26
+ init(config?: SuVisitTrackerConfig): void;
27
+ /** Angular lifecycle hook for service destruction */
28
+ ngOnDestroy(): void;
29
+ static ɵfac: i0.ɵɵFactoryDeclaration<SuVisitTrackerService, never>;
30
+ static ɵprov: i0.ɵɵInjectableDeclaration<SuVisitTrackerService>;
31
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@su-labs/visit-tracker",
3
- "version": "1.0.3",
3
+ "version": "19.1.1",
4
4
  "keywords": [
5
5
  "angular",
6
6
  "user-tracking",
@@ -14,13 +14,14 @@
14
14
  "metrics"
15
15
  ],
16
16
  "peerDependencies": {
17
- "@angular/common": "^20.1.0",
18
- "@angular/core": "^20.1.0"
17
+ "@angular/common": "^19.0.0",
18
+ "@angular/core": "^19.0.0"
19
19
  },
20
20
  "dependencies": {
21
+ "@su-labs/core": "1.8.0",
21
22
  "tslib": "^2.3.0"
22
23
  },
23
- "homepage": "https://github.com/Greezaaa/settings-utils-lib/tree/main/projects/su-labs/font-size#readme",
24
+ "homepage": "https://su-labs.dev/visit-tracker/",
24
25
  "author": {
25
26
  "name": "Yevheniy Alekseyev",
26
27
  "email": "yev.alekseyev@gmail.com",
@@ -29,7 +30,7 @@
29
30
  "repository": {
30
31
  "type": "git",
31
32
  "url": "https://github.com/Greezaaa/settings-utils-lib.git",
32
- "directory": "projects/su-labs/font-size"
33
+ "directory": "projects/su-labs/visit-tracker"
33
34
  },
34
35
  "bugs": {
35
36
  "url": "https://github.com/Greezaaa/settings-utils-lib/issues"
@@ -0,0 +1,2 @@
1
+ export type { SuVisitData, SuVisitTrackerConfig } from '@su-labs/core/visit-tracker';
2
+ export * from './lib/visit-tracker.service';