ngx-sp-auth 4.5.0 → 4.5.2

package/lib/services/indexed-db.service.d.ts

@@ -19,7 +19,9 @@ export declare class IndexedDBService {
     private _customEnvironment;
     private _restored?;
     private _dbName;
-    protected database?: IDBDatabase;
+    private _lock;
+    private _isInitialized;
+    private _initPromise?;
     protected request?: IDBPDatabase<unknown>;
     constructor(_customEnvironment: LibCustomEnvironmentService);
     /**
@@ -32,7 +34,6 @@ export declare class IndexedDBService {
     /**
      * Busca um valor na base dentro de um objectStore.
      *
-     * @param storeName Nome do objectStore
      * @param key Valor da chave única
      * @returns Promise<> com o valor encontrado ou undefined se não encontrar
      */
@@ -49,28 +50,60 @@ export declare class IndexedDBService {
      * @param key Valor da chave única
      */
     delete(key: string): Promise<void>;
+    /**
+     * Garante que a database foi inicializada antes de usar qualquer operação.
+     * Se `initializeDatabase()` foi chamado mas ainda não completou, aguarda a promise.
+     * Previne race conditions ao tentar usar operações durante a inicialização.
+     *
+     * @private
+     */
+    private _ensureInitialized;
     /**
      * Inicializa as configurações iniciais do IndexedDB e já cria o objectStore que será utilizado caso não exista.
      *
-     * O object store que será criado terá sua chave inline na propriedade `key` e o índice será a propriedade `context`, portanto todos os valores que forem inseridos **DEVEM** ser um objeto com pelo menos a propriedade `key` e `context`.
-     * Deve ser chamado no constructor do seu componente para garantir inicialização correta pelo componente
+     * ⚠️ IMPORTANTE: Deve ser chamado com `await` no ngOnInit() do seu componente, não no constructor!
      *
-     * @param dbName Nome da base de dados que será usada
+     * O object store que será criado terá sua chave inline na propriedade `key` e o índice será a propriedade `context`,
+     * portanto todos os valores que forem inseridos **DEVEM** ser um objeto com pelo menos a propriedade `key` e `context`.
+     *
+     * @example
+     * async ngOnInit() {
+     *   await this._indexedDB.initializeDatabase();
+     *   const restored = await this._indexedDB.get('minha-chave');
+     * }
     */
     initializeDatabase(): Promise<void>;
+    /**
+     * Executa a inicialização real da database.
+     * @private
+     */
+    private _performInitialization;
     /**
      * Exclui uma database do IndexedDB com base no nome.
      *
-     * @param name Nome da database
+     * Deve ser chamado durante o logout para limpar dados do usuário.
+     *
+     * @example
+     * await this._indexedDB.closeOpenConnection();
+     * await this._indexedDB.deleteDatabase();
     */
     deleteDatabase(): Promise<void>;
     /**
      * Fecha a conexão persistente (se existir) sem excluir a database.
      * Útil para cenários onde se precisa liberar a conexão antes de chamar `deleteDatabase()`.
+     *
+     * @example
+     * await this._indexedDB.closeOpenConnection();
     */
     closeOpenConnection(): Promise<void>;
     /**
-     * Valida se já existe um valor cadastrado na base com a chave-única que foi informada, se houver retorna ele, caso contrário cria um registro placeholder para poder atualizar depois.
+     * Executa o fechamento real da conexão.
+     * @private
+     */
+    private _closeConnection;
+    /**
+     * Valida se já existe um valor cadastrado na base com a chave-única que foi informada,
+     * se houver retorna ele, caso contrário cria um registro placeholder para poder atualizar depois.
      *
      * @param key Valor da chave única
      * @param value (opcional) Valor placeholder caso não exista um valor previamente criado

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-sp-auth",
-  "version": "4.5.0",
+  "version": "4.5.2",
   "description": "Biblioteca de utilitários de autenticação.",
   "author": "P&D",
   "keywords": [
@@ -23,7 +23,7 @@
     "@azure/msal-angular": "^4.0.16",
     "@azure/msal-browser": "^4.18.0",
     "idb": "^8.0.3",
-    "ngx-sp-infra": "^6.7.0",
+    "ngx-sp-infra": "^6.7.4",
     "ngx-toastr": "^19.0.0"
   },
   "sideEffects": false,