ngx-vector-components 6.27.0 → 6.28.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [6.28.0] (11/09/2026)
+
+### Feat
+
+- Added `AnalyticsService` (`services/analytics.service.ts`), moved from logtech: single point of contact with the GTM `dataLayer` and Microsoft Clarity. Public API: `pageView(url)`, `userAction(action, extra)`, `appEvent(action, extra)`; exported types `AnalyticsEvent`, `AnalyticsPage`, `AnalyticsUser`. Reads `ENVIRONMENT`, `APP_NAME` and `MENU_OPTIONS` (all optional) to fill `env`, `app`, `page_name` and `page_module`. Each app must call `pageView` on `NavigationEnd` in its `AppComponent`.
+- Added optional `environmentLabel` to the `Environment` interface (`injections/index.ts`), used by `AnalyticsService` for the `env` field (`local`, `tst`, `hml`; `production` when `production` is `true`). No breaking change: apps that do not provide it fall back to `non-production`.
+
 ## [6.27.0] (08/09/2026)
 
 ### Feat

package/fesm2022/ngx-vector-components.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Input, Component, Pipe, NgModule, InjectionToken, Injectable, Inject, EventEmitter, Output, ViewChild, signal, ViewEncapsulation, HostBinding, inject, HostListener, input, output, Optional } from '@angular/core';
+import { Input, Component, Pipe, NgModule, InjectionToken, Injectable, Inject, EventEmitter, Output, Optional, ViewChild, signal, ViewEncapsulation, HostBinding, inject, HostListener, input, output } from '@angular/core';
 import * as i1 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i2 from 'primeng/tooltip';
@@ -1999,6 +1999,329 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
                 }]
         }] });
 
+class StorageService {
+    clear() {
+        sessionStorage.clear();
+        localStorage.clear();
+    }
+    clearSession() {
+        sessionStorage.clear();
+    }
+    get(key) {
+        const storageItem = localStorage.getItem(key);
+        try {
+            return storageItem ? JSON.parse(storageItem) : '';
+        }
+        catch (e) {
+            return storageItem;
+        }
+    }
+    set(key, value) {
+        localStorage.setItem(key, typeof value === 'string' ? value : JSON.stringify(value));
+    }
+    remove(key) {
+        localStorage.removeItem(key);
+    }
+    getSession(key) {
+        const storageItem = sessionStorage.getItem(key);
+        try {
+            return storageItem ? JSON.parse(storageItem) : '';
+        }
+        catch (e) {
+            return storageItem;
+        }
+    }
+    setSession(key, value) {
+        sessionStorage.setItem(key, typeof value === 'string' ? value : JSON.stringify(value));
+    }
+    removeSession(key) {
+        sessionStorage.removeItem(key);
+    }
+    getToken() {
+        return localStorage.getItem('token') || '';
+    }
+    setToken(token) {
+        localStorage.setItem('token', token);
+    }
+    removeToken() {
+        localStorage.removeItem('token');
+    }
+    getRefreshToken() {
+        return sessionStorage.getItem('refreshToken') || '';
+    }
+    setRefreshToken(refreshToken) {
+        sessionStorage.setItem('refreshToken', refreshToken);
+    }
+    removeRefreshToken() {
+        sessionStorage.removeItem('refreshToken');
+    }
+    getUsername() {
+        return sessionStorage.getItem('username') || '';
+    }
+    setUsername(username) {
+        sessionStorage.setItem('username', username);
+    }
+    removeUsername() {
+        sessionStorage.removeItem('username');
+    }
+    getUserId() {
+        const userId = sessionStorage.getItem('userId');
+        return userId ? +atob(userId) : 0;
+    }
+    setUserId(userId) {
+        sessionStorage.setItem('userId', btoa(`${userId}`));
+    }
+    clearUserId() {
+        sessionStorage.removeItem('userId');
+    }
+    getRole() {
+        return atob(sessionStorage.getItem('role') || '');
+    }
+    setRole(role) {
+        sessionStorage.setItem('role', role || '');
+    }
+    clearRole() {
+        sessionStorage.removeItem('role');
+    }
+    getProfile() {
+        const data = sessionStorage.getItem('profile') || '';
+        return data ? JSON.parse(data) : data;
+    }
+    setProfile(profiles) {
+        sessionStorage.setItem('profile', JSON.stringify(profiles || ''));
+    }
+    removeProfile() {
+        sessionStorage.removeItem('profile');
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: StorageService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: StorageService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: StorageService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+class AnalyticsService {
+    static { this.ID_SEGMENT = /^(\d+|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i; }
+    static { this.MAX_LABEL_LENGTH = 60; }
+    constructor(storageService, appName = null, menuOptions = null, environment = null) {
+        this.storageService = storageService;
+        this.appName = appName;
+        this.menuOptions = menuOptions;
+        this.environment = environment;
+        this.currentPage = { page_path: '', page_name: '', page_module: '' };
+        if (!this.isProduction) {
+            window.__analytics = this;
+        }
+    }
+    /**
+     * Registra a troca de tela. Chamado apenas pelo AppComponent, no NavigationEnd.
+     * Alem do `page_view`, sincroniza a identificacao do usuario no Clarity --
+     * que precisa ser reenviada a cada rota por se tratar de uma SPA.
+     */
+    pageView(url) {
+        this.safely(() => {
+            this.currentPage = this.resolvePage(url);
+            const user = this.getUser();
+            this.push({ event: 'page_view' }, user);
+            this.syncClarity(this.currentPage, user);
+        });
+    }
+    /**
+     * INTERATIVO -- o usuario fez algo deliberado: clicou, buscou, exportou, salvou.
+     * Chamado a mao pelo componente, no inicio do handler.
+     *
+     * @param action nome no formato `objeto_verbo`, sem repetir a tela (`page_name` ja vai junto)
+     * @param extra `label` para o identificador do alvo, `context` para detalhe livre
+     *
+     * @example this.analyticsService.userAction('heat_map_search', { context: { uf: 'SP' } });
+     */
+    userAction(action, extra = {}) {
+        this.safely(() => {
+            this.push({ event: 'user_action', action, interaction: true, ...extra });
+            this.sendClarityEvent(action, extra['label']);
+        });
+    }
+    /**
+     * NAO INTERATIVO -- o sistema respondeu ou exibiu algo: resultado carregado,
+     * lista vazia, erro de negocio, modal automatico.
+     *
+     * @example this.analyticsService.appEvent('heat_map_empty', { context: { points: 0 } });
+     */
+    appEvent(action, extra = {}) {
+        this.safely(() => this.push({ event: 'app_event', action, interaction: false, ...extra }));
+    }
+    push(payload, user = this.getUser()) {
+        if (!this.isProduction) {
+            console.debug('[analytics]', payload['event'], payload['action'] ?? this.currentPage.page_path);
+        }
+        this.dataLayer.push({
+            app: this.appName ?? 'UNKNOWN',
+            env: this.env,
+            is_iframe: window.parent !== window,
+            ...this.currentPage,
+            ...user,
+            ...payload,
+        });
+    }
+    get dataLayer() {
+        const target = window;
+        target.dataLayer = target.dataLayer || [];
+        return target.dataLayer;
+    }
+    get isProduction() {
+        return !!this.environment?.production;
+    }
+    get env() {
+        if (this.isProduction) {
+            return 'production';
+        }
+        return this.environment?.environmentLabel?.toLowerCase() || 'non-production';
+    }
+    getUser() {
+        const info = this.storageService.getSession('userInfo') || {};
+        return {
+            user_id: this.storageService.getUserId() || undefined,
+            profile_name: info.profileName,
+            profile_type_id: info.profileTypeId,
+            shipper_id: this.realId(info.shipper),
+            carrier_id: this.realId(info.carrierId),
+            is_etcd: !!info.isEtcd,
+        };
+    }
+    realId(value) {
+        return typeof value === 'number' && value > 0 ? value : undefined;
+    }
+    get clarity() {
+        const candidate = window.clarity;
+        return typeof candidate === 'function' ? candidate : undefined;
+    }
+    sendClarityEvent(action, label) {
+        const clarity = this.clarity;
+        if (!clarity) {
+            return;
+        }
+        const name = [action, this.slug(String(label ?? ''))]
+            .filter(Boolean)
+            .join('_')
+            .slice(0, AnalyticsService.MAX_LABEL_LENGTH);
+        if (name) {
+            clarity('event', name);
+        }
+    }
+    slug(value) {
+        return value
+            .normalize('NFD')
+            .replace(/[̀-ͯ]/g, '')
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '_')
+            .replace(/^_+|_+$/g, '');
+    }
+    syncClarity(page, user) {
+        const clarity = this.clarity;
+        if (!clarity) {
+            return;
+        }
+        if (user.user_id) {
+            // O proprio Clarity faz o hash do id no cliente antes de enviar.
+            clarity('identify', String(user.user_id), undefined, page.page_path);
+        }
+        this.setClarityTag(clarity, 'app', this.appName);
+        this.setClarityTag(clarity, 'env', this.env);
+        this.setClarityTag(clarity, 'page_name', page.page_name);
+        this.setClarityTag(clarity, 'profile_name', user.profile_name);
+        this.setClarityTag(clarity, 'profile_type_id', user.profile_type_id);
+        this.setClarityTag(clarity, 'shipper_id', user.shipper_id);
+    }
+    setClarityTag(clarity, key, value) {
+        if (value === undefined || value === null || value === '') {
+            return;
+        }
+        clarity('set', key, String(value));
+    }
+    resolvePage(url) {
+        const path = this.normalizePath(url);
+        const menu = this.findMenu(path);
+        return {
+            page_path: path,
+            page_name: menu?.name || path,
+            page_module: menu?.module || '',
+        };
+    }
+    normalizePath(url) {
+        const path = url.split('?')[0].split('#')[0];
+        return path
+            .split('/')
+            .map((segment) => (AnalyticsService.ID_SEGMENT.test(segment) ? ':id' : segment))
+            .join('/');
+    }
+    findMenu(path) {
+        const index = this.getMenuIndex();
+        const segments = path.split('/').filter(Boolean);
+        for (let size = segments.length; size > 0; size--) {
+            const candidate = `/${segments.slice(0, size).join('/')}`;
+            const found = index.get(candidate);
+            if (found) {
+                return found;
+            }
+        }
+        return undefined;
+    }
+    getMenuIndex() {
+        if (!this.menuIndex) {
+            this.menuIndex = new Map();
+            this.indexMenu(this.menuOptions || [], '');
+        }
+        return this.menuIndex;
+    }
+    /** Achata o menuOptions em `rota -> { nome da tela, modulo }`. */
+    indexMenu(items, moduleLabel) {
+        items.forEach((item) => {
+            const currentModule = moduleLabel || item.label;
+            if (item.route) {
+                const key = this.normalizePath(`/${item.route}`);
+                if (!this.menuIndex?.has(key)) {
+                    this.menuIndex?.set(key, { name: item.label, module: currentModule });
+                }
+            }
+            if (item.children?.length) {
+                this.indexMenu(item.children, currentModule);
+            }
+        });
+    }
+    safely(operation) {
+        try {
+            operation();
+        }
+        catch (error) {
+            if (!this.isProduction) {
+                console.warn('[analytics] evento ignorado', error);
+            }
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AnalyticsService, deps: [{ token: StorageService }, { token: APP_NAME, optional: true }, { token: MENU_OPTIONS, optional: true }, { token: ENVIRONMENT, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AnalyticsService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: AnalyticsService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: StorageService }, { type: AppName, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [APP_NAME]
+                }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [MENU_OPTIONS]
+                }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [ENVIRONMENT]
+                }] }] });
+
 class AuthService {
     constructor(environment, http, storageService, profileService, activatedRoute) {
         this.environment = environment;
@@ -2164,108 +2487,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImpo
             args: [{ providedIn: 'root' }]
         }] });
 
-class StorageService {
-    clear() {
-        sessionStorage.clear();
-        localStorage.clear();
-    }
-    clearSession() {
-        sessionStorage.clear();
-    }
-    get(key) {
-        const storageItem = localStorage.getItem(key);
-        try {
-            return storageItem ? JSON.parse(storageItem) : '';
-        }
-        catch (e) {
-            return storageItem;
-        }
-    }
-    set(key, value) {
-        localStorage.setItem(key, typeof value === 'string' ? value : JSON.stringify(value));
-    }
-    remove(key) {
-        localStorage.removeItem(key);
-    }
-    getSession(key) {
-        const storageItem = sessionStorage.getItem(key);
-        try {
-            return storageItem ? JSON.parse(storageItem) : '';
-        }
-        catch (e) {
-            return storageItem;
-        }
-    }
-    setSession(key, value) {
-        sessionStorage.setItem(key, typeof value === 'string' ? value : JSON.stringify(value));
-    }
-    removeSession(key) {
-        sessionStorage.removeItem(key);
-    }
-    getToken() {
-        return localStorage.getItem('token') || '';
-    }
-    setToken(token) {
-        localStorage.setItem('token', token);
-    }
-    removeToken() {
-        localStorage.removeItem('token');
-    }
-    getRefreshToken() {
-        return sessionStorage.getItem('refreshToken') || '';
-    }
-    setRefreshToken(refreshToken) {
-        sessionStorage.setItem('refreshToken', refreshToken);
-    }
-    removeRefreshToken() {
-        sessionStorage.removeItem('refreshToken');
-    }
-    getUsername() {
-        return sessionStorage.getItem('username') || '';
-    }
-    setUsername(username) {
-        sessionStorage.setItem('username', username);
-    }
-    removeUsername() {
-        sessionStorage.removeItem('username');
-    }
-    getUserId() {
-        const userId = sessionStorage.getItem('userId');
-        return userId ? +atob(userId) : 0;
-    }
-    setUserId(userId) {
-        sessionStorage.setItem('userId', btoa(`${userId}`));
-    }
-    clearUserId() {
-        sessionStorage.removeItem('userId');
-    }
-    getRole() {
-        return atob(sessionStorage.getItem('role') || '');
-    }
-    setRole(role) {
-        sessionStorage.setItem('role', role || '');
-    }
-    clearRole() {
-        sessionStorage.removeItem('role');
-    }
-    getProfile() {
-        const data = sessionStorage.getItem('profile') || '';
-        return data ? JSON.parse(data) : data;
-    }
-    setProfile(profiles) {
-        sessionStorage.setItem('profile', JSON.stringify(profiles || ''));
-    }
-    removeProfile() {
-        sessionStorage.removeItem('profile');
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: StorageService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: StorageService, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: StorageService, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }] });
-
 class ProfileService {
     constructor(http, storageService) {
         this.http = http;
@@ -6899,5 +7120,5 @@ const getSelectedCrudItemResolver = (routeSnapshot) => {
  * Generated bundle index. Do not edit.
  */
 
-export { APP_NAME, AppName, AuthService, BadgeComponent, BadgeModule, BooleanType, BreadcrumbComponent, BreadcrumbModule, BreadcrumbService, ButtonComponent, CalendarComponent, CheckboxFieldComponent, CpfCnpjValidator, CrudBaseComponent, CrudBaseService, CrudFooterComponent, CrudHeaderComponent, CrudHeaderModule, CrudHistory, CrudHistoryComponent, CrudHistoryModule, CrudMode, CurrencyBrlPipe, CurrencyFieldComponent, DataTableComponent, DocumentType, DrawerComponent, DrawerModule, DropdownFieldComponent, ENVIRONMENT, EnumService, ErrorMessageService, FieldErrorMessageComponent, FieldType, FieldsModule, FileUtil, FiltersComponent, FooterModule, FormatDocumentPipe, GenericErrorModalComponent, GenericErrorModalModule, GenericModalComponent, GenericModalModule, GeolocationService, HttpInterceptorProvider, INPUT_FILE_ACCEPT_EXTENSIONS, InputFileComponent, InputNumberFieldComponent, InputOtpComponent, InputSwitchFieldComponent, LoadingService, MENU_OPTIONS, MaskPipe, MaskUtil, MenuComponent, MenuModule, MenuService, MessageStatus, ModalService, MultiselectFieldComponent, NotHiddenPipe, NotificationsService, ObjectUtil, OnlyActivePipe, PanelComponent, PanelModule, PercentageFieldComponent, PipesModule, ProfileModuleActionType, ProfileModuleType, ProfileService, ProfileTypeEnum, RadioButtonFieldComponent, RangeValueComponent, RemoveLastChildPipe, Role, ScoreComponent, ScoreModule, SearchFieldComponent, SelectButtonFieldComponent, SelectionType, SnackbarComponent, SnackbarModule, Status, StepperComponent, StepperModule, StorageService, StringUtil, SubMenusListComponent, TableColumnType, TextFieldComponent, TextareaFieldComponent, TopBarComponent, TopBarModule, UnreadNotificationsPipe, ValidationUtil, VectorPreset, View, WindowUtil, createUploadMultipleForm, createUploadSingleForm, crudListHasItemsGuard, getSelectedCrudItemResolver, getTokenByGuidGuard, hasPermissionGuard, provideVectorPrimeNG, roleGuard, tokenIsPresentGuard };
+export { APP_NAME, AnalyticsService, AppName, AuthService, BadgeComponent, BadgeModule, BooleanType, BreadcrumbComponent, BreadcrumbModule, BreadcrumbService, ButtonComponent, CalendarComponent, CheckboxFieldComponent, CpfCnpjValidator, CrudBaseComponent, CrudBaseService, CrudFooterComponent, CrudHeaderComponent, CrudHeaderModule, CrudHistory, CrudHistoryComponent, CrudHistoryModule, CrudMode, CurrencyBrlPipe, CurrencyFieldComponent, DataTableComponent, DocumentType, DrawerComponent, DrawerModule, DropdownFieldComponent, ENVIRONMENT, EnumService, ErrorMessageService, FieldErrorMessageComponent, FieldType, FieldsModule, FileUtil, FiltersComponent, FooterModule, FormatDocumentPipe, GenericErrorModalComponent, GenericErrorModalModule, GenericModalComponent, GenericModalModule, GeolocationService, HttpInterceptorProvider, INPUT_FILE_ACCEPT_EXTENSIONS, InputFileComponent, InputNumberFieldComponent, InputOtpComponent, InputSwitchFieldComponent, LoadingService, MENU_OPTIONS, MaskPipe, MaskUtil, MenuComponent, MenuModule, MenuService, MessageStatus, ModalService, MultiselectFieldComponent, NotHiddenPipe, NotificationsService, ObjectUtil, OnlyActivePipe, PanelComponent, PanelModule, PercentageFieldComponent, PipesModule, ProfileModuleActionType, ProfileModuleType, ProfileService, ProfileTypeEnum, RadioButtonFieldComponent, RangeValueComponent, RemoveLastChildPipe, Role, ScoreComponent, ScoreModule, SearchFieldComponent, SelectButtonFieldComponent, SelectionType, SnackbarComponent, SnackbarModule, Status, StepperComponent, StepperModule, StorageService, StringUtil, SubMenusListComponent, TableColumnType, TextFieldComponent, TextareaFieldComponent, TopBarComponent, TopBarModule, UnreadNotificationsPipe, ValidationUtil, VectorPreset, View, WindowUtil, createUploadMultipleForm, createUploadSingleForm, crudListHasItemsGuard, getSelectedCrudItemResolver, getTokenByGuidGuard, hasPermissionGuard, provideVectorPrimeNG, roleGuard, tokenIsPresentGuard };
 //# sourceMappingURL=ngx-vector-components.mjs.map