ngx-sp-auth 4.2.0 → 4.2.1

package/lib/components/menu-lateral/menu/menu-lateral.component.d.ts

@@ -3,17 +3,18 @@ import { Router } from '@angular/router';
 import { Subject } from 'rxjs';
 import { MsalGuardConfiguration, MsalService } from '@azure/msal-angular';
 import { BsModalService } from 'ngx-bootstrap/modal';
-import { ToastrService } from 'ngx-toastr';
 import { MessageService } from 'ngx-sp-infra';
-import { AuthStorageService } from '../../../storage/auth-storage.service';
+import { ToastrService } from 'ngx-toastr';
 import { LibCustomMenuService } from '../../../custom/lib-custom-menu.service';
 import { ProjectUtilservice } from '../../../project/project-utils.service';
+import { AuthStorageService } from '../../../storage/auth-storage.service';
 import { MenuServicesService } from '../menu-services.service';
 import { AuthService } from '../../../auth.service';
 import { LibCustomEnvironmentService } from '../../../custom/lib-custom-environment.service';
+import { PesquisaTelasGlobalService } from '../../../services/pesquisa-telas-global.service';
+import { DynamicMenu } from '../model/dynamic-menu';
 import { IMenuItemStructure } from '../model/imenu-item-structure.model';
 import { ISubmenuItemStructure } from '../model/isubmenu-item-structure.model';
-import { DynamicMenu } from '../model/dynamic-menu';
 import * as i0 from "@angular/core";
 export declare class MenuLateralComponent implements OnInit, OnDestroy {
     private _msalGuardConfiguration;
@@ -28,7 +29,8 @@ export declare class MenuLateralComponent implements OnInit, OnDestroy {
     private _projectUtilService;
     private _router;
     private _authService;
-    constructor(_msalGuardConfiguration: MsalGuardConfiguration, _msalService: MsalService, _toastrService: ToastrService, _customMenuService: LibCustomMenuService, _customEnvironmentService: LibCustomEnvironmentService, _authStorageService: AuthStorageService, _bsModalService: BsModalService, _menuServices: MenuServicesService, _messageService: MessageService, _projectUtilService: ProjectUtilservice, _router: Router, _authService: AuthService);
+    _pesquisaTelasGlobalService: PesquisaTelasGlobalService;
+    constructor(_msalGuardConfiguration: MsalGuardConfiguration, _msalService: MsalService, _toastrService: ToastrService, _customMenuService: LibCustomMenuService, _customEnvironmentService: LibCustomEnvironmentService, _authStorageService: AuthStorageService, _bsModalService: BsModalService, _menuServices: MenuServicesService, _messageService: MessageService, _projectUtilService: ProjectUtilservice, _router: Router, _authService: AuthService, _pesquisaTelasGlobalService: PesquisaTelasGlobalService);
     ngOnInit(): Promise<void>;
     ngOnDestroy(): void;
     sidebar: ElementRef<HTMLDivElement>;

package/lib/services/pesquisa-telas-global.service.d.ts

@@ -0,0 +1,99 @@
+import { ApplicationRef, ComponentFactoryResolver, Injector } from '@angular/core';
+import { ITelaRota } from 'ngx-sp-infra';
+import * as i0 from "@angular/core";
+/**
+ * Serviço responsável por criar e gerenciar uma instância global do componente SearchInput.
+ *
+ * Este serviço utiliza a API do Angular para criar e renderizar componentes dinamicamente,
+ * anexando-os diretamente ao DOM (fora da hierarquia normal de componentes).
+ *
+ * Características principais:
+ * - Cria apenas uma instância do componente por vez (singleton)
+ * - Gerencia o ciclo de vida do componente (criação, anexação ao DOM, destruição)
+ * - Lida com eventos do componente via RxJS Subjects
+ * - Garante limpeza apropriada de recursos (subscriptions, referencias DOM)
+ *
+ * @example
+ * constructor(private pesquisaService: PesquisaTelasGlobalService) {
+ *   // Para exibir o componente de pesquisa
+ *   pesquisaService.show();
+ *
+ *   // Para esconder o componente
+ *   pesquisaService.hide();
+ * }
+ */
+export declare class PesquisaTelasGlobalService {
+    private componentFactoryResolver;
+    private appRef;
+    private injector;
+    /**
+     * Referência ao componente dinâmico criado.
+     * Usado para gerenciar o ciclo de vida e estado do componente.
+     * Null quando o componente não está visível/criado.
+    */
+    private _componentRef?;
+    /**
+     * Subject que centraliza eventos de fechamento do componente.
+     * Ao invés de tratar o evento onClose diretamente, emitimos neste Subject para permitir um ponto único de tratamento no serviço.
+    */
+    private _onClose$;
+    /**
+     * Agregador de subscriptions de longa duração.
+     * Contém principalmente a inscrição do constructor que observa _onClose$.
+     * Usado para garantir limpeza adequada em ngOnDestroy.
+    */
+    private _subscriptions;
+    /**
+     * Subscription específica do evento onClose do componente atual.
+     * Mantida separadamente para permitir limpeza imediata em hide().
+     * Null quando não há componente ativo.
+    */
+    private _componentCloseSub;
+    telas: ITelaRota[];
+    constructor(componentFactoryResolver: ComponentFactoryResolver, appRef: ApplicationRef, injector: Injector);
+    getTelas(): void;
+    /**
+     * Cria e exibe uma instância do componente SearchInput na tela.
+     *
+     * Este método utiliza a API baixo nível do Angular para criar um componente dinamicamente e anexá-lo ao DOM. O processo envolve:
+     *
+     * 1. Criar o componente via ComponentFactoryResolver
+     * 2. Configurar suas propriedades iniciais
+     * 3. Registrá-lo no mecanismo de detecção de mudanças do Angular
+     * 4. Anexá-lo ao DOM (fora da hierarquia normal de componentes)
+     *
+     * IMPORTANTE: Este método garante que apenas uma instância do componente existe por vez, retornando early se já houver um componente ativo.
+     *
+     * @example
+     * service.show(); // Cria e exibe o componente
+     * service.show(); // Não faz nada (componente já existe)
+    */
+    show(): void;
+    /**
+     * Esconde e destrói a instância atual do componente.
+     *
+     * Este método realiza a limpeza completa do componente:
+     * 1. Define isVisible como false (para animações de saída)
+     * 2. Remove o componente do ciclo de detecção de mudanças
+     * 3. Destrói o componente e sua árvore de componentes
+     * 4. Remove referências e cancela inscrições
+     *
+     * IMPORTANTE: Este método é idempotente - é seguro chamá-lo múltiplas vezes ou quando não há componente ativo.
+    */
+    hide(): void;
+    /**
+     * Lifecycle hook do Angular chamado quando o serviço é destruído.
+     *
+     * Realiza limpeza completa de recursos para evitar memory leaks:
+     * 1. Destrói qualquer instância ativa do componente
+     * 2. Cancela todas as inscrições de longa duração
+     * 3. Completa o Subject de eventos
+     *
+     * NOTA: Como este serviço é providedIn: 'root', ele normalmente
+     * só será destruído quando a aplicação for encerrada. Ainda assim,
+     * manter essa limpeza é uma boa prática e ajuda em testes.
+    */
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PesquisaTelasGlobalService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PesquisaTelasGlobalService>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-sp-auth",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "Biblioteca de utilitários de autenticação.",
   "author": "P&D",
   "keywords": [
@@ -22,7 +22,7 @@
   "peerDependencies": {
     "@azure/msal-angular": "^4.0.16",
     "@azure/msal-browser": "^4.18.0",
-    "ngx-sp-infra": "^6.4.0",
+    "ngx-sp-infra": "^6.4.2",
     "ngx-toastr": "^19.0.0"
   },
   "sideEffects": false,

package/public-api.d.ts

@@ -2,16 +2,18 @@
 export * from './lib/auth.module';
 /** Services */
 export * from './lib/auth.service';
-export * from './lib/custom/lib-custom-environment.service';
 export * from './lib/components/menu-lateral/menu-services.service';
-export * from './lib/storage/auth-storage.service';
+export * from './lib/custom/lib-custom-environment.service';
 export * from './lib/custom/lib-custom-login.service';
 export * from './lib/custom/lib-custom-menu.service';
 export * from './lib/custom/lib-custom-storage.service';
 export * from './lib/custom/lib-menu-config.service';
+export * from './lib/services/pesquisa-telas-global.service';
+export * from './lib/storage/auth-storage.service';
 /** Components */
-export * from './lib/components/login/login.component';
+export * from './lib/components/error-menu-not-allowed/error-menu-not-allowed.component';
 export * from './lib/components/login-os/login-os.component';
+export * from './lib/components/login/login.component';
 export * from './lib/components/menu-lateral/dropdown/primary-dropdown/primary-dropdown.component';
 export * from './lib/components/menu-lateral/dropdown/secondary-dropdown/secondary-dropdown.component';
 export * from './lib/components/menu-lateral/menu/menu-lateral.component';
@@ -19,7 +21,6 @@ export * from './lib/components/menu-lateral/menu/selecao-estabelecimentos-modal
 export * from './lib/components/menu-lateral/submenus/dynamic-menu/dynamic-menu.component';
 export * from './lib/components/menu-lateral/submenus/notif-submenu/notif-submenu.component';
 export * from './lib/components/nova-senha/nova-senhacomponent';
-export * from './lib/components/error-menu-not-allowed/error-menu-not-allowed.component';
 /** Models */
 export * from './lib/components/menu-lateral/model/imenu-item-structure.model';
 export * from './lib/components/menu-lateral/model/imenu.model';
@@ -31,17 +32,17 @@ export * from './lib/components/menu-lateral/model/ret-menu-lateral';
 export * from './lib/components/menu-lateral/model/ret-menu-promise';
 export * from './lib/components/menu-lateral/model/ret-navsubmenu';
 /** Custom */
+export * from './lib/custom/models/icustom-environment-service';
 export * from './lib/custom/models/icustom-login-service';
 export * from './lib/custom/models/icustom-menu-service';
-export * from './lib/custom/models/imenu-config';
 export * from './lib/custom/models/icustom-storage-service';
-export * from './lib/custom/models/icustom-environment-service';
+export * from './lib/custom/models/imenu-config';
 /** Guards */
 export * from './lib/guards/auth-guard';
 export * from './lib/guards/external-login-guard';
+export * from './lib/guards/is-menu-allowed-guard';
 export * from './lib/guards/login-guard';
 export * from './lib/guards/login-os.guard';
-export * from './lib/guards/is-menu-allowed-guard';
 /** Interceptors */
 export * from './lib/interceptors/auth-aplic.interceptor';
 export * from './lib/interceptors/auth-infra.interceptor';