ngx-opalbytes-services 1.1.0 → 1.2.0

package/README.md

@@ -2,8 +2,6 @@
 
 Esta biblioteca destina-se a abrigar serviços (`services`) Angular reutilizáveis que encapsulam lógica de negócios, chamadas de API e outras funcionalidades compartilhadas.
 
-**Nota:** Atualmente, esta biblioteca contém apenas um componente de placeholder e ainda não possui serviços implementados.
-
 ---
 ## Compatibilidade
 |Tecnologia  |	Versão  |   Descrição  |
@@ -39,24 +37,24 @@ Esta biblioteca possui as seguintes dependências:
 ---
 ## Como Usar
 
-Quando serviços forem adicionados, eles poderão ser injetados nos seus componentes ou outros serviços via injeção de dependência do Angular.
+Os serviços podem ser injetados nos seus componentes ou outros serviços via injeção de dependência do Angular.
 
 **Exemplo de como um serviço seria utilizado:**
 
 ```typescript
 import { Component, OnInit } from '@angular/core';
-// Supondo a existência de um 'UserService'
-import { UserService } from 'ngx-opalbytes-services';
+import { WebsocketService } from 'ngx-opalbytes-services';
 
 @Component({
   selector: 'app-user-profile',
 })
 export class UserProfileComponent implements OnInit {
   
-  constructor(private userService: UserService) {}
+  private websocketService = inject(WebsocketService)
+  constructor() {}
 
   ngOnInit() {
-    // this.userService.getUsers().subscribe(...);
+    // this.websocketService.connect('ws://localhost:8080');
   }
 }
 ```
@@ -65,21 +63,138 @@ export class UserProfileComponent implements OnInit {
 
 ## Organização de Pastas
 
-Dentro da pasta `src/lib/`, os serviços devem ser organizados em subpastas, se necessário, ou diretamente sob `lib/`. Por exemplo:
+Dentro da pasta `src/lib/`, os serviços são organizados na pasta `services/`.
 
 ```
 src/
 └── lib/
-    ├── services/
-    │   └── user.service.ts
-    └── auth.service.ts
+    └── services/
+        ├── date-pipe.service.ts
+        ├── installer.service.ts
+        └── websocket.service.ts
+```
+
+---
+
+---
+
+## Detalhes dos Serviços
+
+### `CaoDatePipeService`
+Um serviço simples que atua como um wrapper para o `DatePipe` do Angular, facilitando a formatação de datas.
+
+**Métodos**
+
+| Método | Parâmetros | Retorno | Descrição |
+| --- | --- | --- | --- |
+| `getConvertedDatePipe` | `value: Date`, `transform: string` | `string` | Formata uma data de acordo com a string de formato fornecida. |
+
+**Exemplo de Uso**
+```typescript
+import { CaoDatePipeService } from 'ngx-opalbytes-services';
+
+// ...
+
+constructor(private datePipeService: CaoDatePipeService) {}
+
+formatarData() {
+  const dataFormatada = this.datePipeService.getConvertedDatePipe(new Date(), 'dd/MM/yyyy');
+  console.log(dataFormatada); // Ex: 22/12/2025
+}
 ```
 
 ---
 
-## Serviços Disponíveis
+### `CaoInstallationService`
+Este serviço gerencia o download e a instalação de executáveis ou a abertura de arquivos, comumente usado em cenários de instalação de aplicações desktop a partir de uma aplicação web.
+
+**Propriedades**
+
+| Propriedade | Tipo | Descrição |
+| --- | --- | --- |
+| `status$` | `Observable<IStatusInstallation>` | Emite o status atual da instalação. |
 
-Atualmente, não há serviços disponíveis nesta biblioteca.
+**Interfaces**
+```typescript
+interface IStatusInstallation {
+  isInstalled: boolean;
+  version?: string;
+  lastChecked: Date;
+  installationPath?: string;
+}
+
+interface IConfigInstallation {
+  executableName: string;
+  assetPath: string; // URL para o arquivo
+}
+
+interface IBlobConfigInstallation {
+  executableName: string;
+  assetPath: Blob; // Arquivo em formato Blob
+}
+```
+
+**Métodos**
+
+| Método | Parâmetros | Retorno | Descrição |
+| --- | --- | --- | --- |
+| `downloadAndInstall` | `config: IConfigInstallation` | `Observable<boolean>` | Inicia o download e a instalação de um executável. |
+| `downloadAndOpenFile` | `config: IConfigInstallation`, `isTargetBlank?: boolean` | `Observable<boolean>` | Faz o download e abre um arquivo em uma nova aba. |
+| `downloadBlobFile` | `configBlob: IBlobConfigInstallation` | `void` | Inicia o download de um arquivo a partir de um objeto Blob. |
+| `reinstall` | `config: IConfigInstallation` | `Observable<boolean>` | Atalho para o método `downloadAndInstall`. |
+
+---
+
+### `CaoWebSocketService`
+Gerencia uma conexão WebSocket com um servidor, incluindo lógica de reconexão automática.
+
+**Propriedades (Emitters)**
+
+| Propriedade | Tipo | Descrição |
+| --- | --- | --- |
+| `isConnectionEvent` | `EventEmitter<boolean>` | Emite `true` em sucesso e `false` em falha de conexão. |
+| `onErrorConnection` | `EventEmitter<string>` | Emite mensagens de erro durante as tentativas de conexão. |
+| `onSuccessConnection`| `EventEmitter<boolean>`| Emite `true` quando a conexão é estabelecida com sucesso. |
+
+**Métodos**
+
+| Método | Parâmetros | Retorno | Descrição |
+| --- | --- | --- | --- |
+| `startConnection` | `webSocketServer: string` | `void` | Inicia o processo de conexão com o servidor WebSocket. |
+| `connect` | `webSocketServer: string` | `void` | Lógica principal de conexão, com tentativas de reconexão. |
+| `sendMessage` | `msg: any` | `void` | Envia uma mensagem para o servidor. |
+| `getMessages` | - | `Observable<any>` | Retorna um Observable que emite as mensagens recebidas do servidor. |
+| `close` | - | `void` | Fecha a conexão com o WebSocket. |
+
+**Exemplo de Uso**
+```typescript
+import { CaoWebSocketService } from 'ngx-opalbytes-services';
+
+// ...
+private wsService = inject(CaoWebSocketService)
+
+constructor() {}
+
+ngOnInit() {
+  this.wsService.startConnection('wss://meu-servidor.com');
+
+  this.wsService.isConnectionEvent.subscribe(isSuccess => {
+    console.log('Status da conexão:', isSuccess);
+  });
+
+  this.wsService.getMessages().subscribe(message => {
+    console.log('Nova mensagem:', message);
+  });
+}
+
+enviar() {
+  this.wsService.sendMessage({ data: 'Olá, servidor!' });
+}
+
+ngOnDestroy() {
+  this.wsService.close();
+}
+```
 
 ---
 
@@ -87,13 +202,13 @@ Atualmente, não há serviços disponíveis nesta biblioteca.
 
 Para adicionar um novo serviço a esta biblioteca, siga os passos abaixo:
 
-1.  **Crie o arquivo** do seu serviço dentro da pasta `src/lib/`. Por exemplo: `src/lib/user.service.ts`.
+1.  **Crie o arquivo** do seu serviço dentro da pasta `src/lib/services/`. Por exemplo: `src/lib/services/user.service.ts`.
 2.  **Implemente seu serviço**, lembrando de marcá-lo com `@Injectable({ providedIn: 'root' })` para que ele seja "tree-shakable".
 3.  **Exponha o serviço** na API pública da biblioteca, adicionando uma linha de exportação no arquivo `src/public-api.ts`.
 
     ```typescript
     // projects/ngx-opalbytes-services/src/public-api.ts
-    export * from './lib/user.service'; 
+    export * from './lib/services/user.service'; 
     ```
 4.  **Adicione testes unitários** para garantir a qualidade e o funcionamento esperado do seu serviço.
 5.  **Faça o commit** seguindo as [regras de commit do projeto](/README.md#룰-regras-de-commit-com-escopo-obrigatório), usando o escopo `services`.

package/fesm2022/ngx-opalbytes-services.mjs

@@ -1,5 +1,9 @@
 import * as i0 from '@angular/core';
-import { Component } from '@angular/core';
+import { Component, inject, Injectable, EventEmitter } from '@angular/core';
+import { DatePipe } from '@angular/common';
+import { BehaviorSubject, Observable, Subject } from 'rxjs';
+import { catchError, retry } from 'rxjs/operators';
+import { webSocket } from 'rxjs/webSocket';
 
 class NgxOpalbytesServices {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: NgxOpalbytesServices, deps: [], target: i0.ɵɵFactoryTarget.Component });
@@ -18,6 +22,197 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.2", ngImpor
   ` }]
         }] });
 
+class CaoDatePipeService {
+    datePipe = inject(DatePipe);
+    constructor() { }
+    getConvertedDatePipe(value, transform) {
+        const result = this.datePipe.transform(value, transform);
+        return result ?? "";
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoDatePipeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoDatePipeService, providedIn: "root" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoDatePipeService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: "root",
+                }]
+        }], ctorParameters: () => [] });
+
+class CaoInstallationService {
+    installationStatus$ = new BehaviorSubject({
+        isInstalled: false,
+        lastChecked: new Date(),
+    });
+    status$ = this.installationStatus$.asObservable();
+    downloadAndInstall(config) {
+        return new Observable((observer) => {
+            try {
+                const url = config.assetPath;
+                const link = document.createElement("a");
+                link.target = "_blank";
+                link.href = url;
+                link.download = config.executableName || "download";
+                link.style.display = "none";
+                document.body.appendChild(link);
+                link.click();
+                document.body.removeChild(link);
+                setTimeout(() => {
+                    observer.next(true);
+                    observer.complete();
+                }, 100);
+            }
+            catch (error) {
+                console.error("Erro no download:", error);
+                observer.error(error);
+            }
+        });
+    }
+    downloadAndOpenFile(config, isTargetBlank = true) {
+        return new Observable((observer) => {
+            try {
+                const link = document.createElement("a");
+                link.href = config.assetPath;
+                link.target = isTargetBlank ? "_blank" : "";
+                link.rel = "noopener noreferrer";
+                document.body.appendChild(link);
+                link.click();
+                document.body.removeChild(link);
+                observer.next(true);
+                observer.complete();
+            }
+            catch (error) {
+                observer.error(error);
+            }
+        });
+    }
+    downloadBlobFile(configBlob) {
+        const url = window.URL.createObjectURL(configBlob.assetPath);
+        const a = document.createElement("a");
+        a.href = url;
+        a.download = configBlob.executableName;
+        document.body.appendChild(a);
+        a.click();
+        window.URL.revokeObjectURL(url);
+        document.body.removeChild(a);
+    }
+    reinstall(config) {
+        return this.downloadAndInstall(config);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoInstallationService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoInstallationService, providedIn: "root" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoInstallationService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: "root",
+                }]
+        }] });
+
+class CaoWebSocketService {
+    socket$ = null;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    isConnectionSuccess = false;
+    isSocketClosed = false;
+    isConnectionEvent = new EventEmitter();
+    onErrorConnection = new EventEmitter();
+    onSuccessConnection = new EventEmitter();
+    startConnection(webSocketServer) {
+        this.reconnectAttempts = 0;
+        this.isSocketClosed = false;
+        this.connect(webSocketServer);
+    }
+    connect(webSocketServer) {
+        this.socket$ = webSocket({
+            url: webSocketServer,
+            deserializer: (e) => {
+                try {
+                    return JSON.parse(e.data);
+                }
+                catch {
+                    return e.data;
+                }
+            },
+        });
+        this.socket$
+            .pipe(catchError((error) => {
+            if (this.isSocketClosed) {
+                return new Subject();
+            }
+            this.onErrorConnection.emit(error);
+            this.reconnectAttempts++;
+            if (this.reconnectAttempts <= this.maxReconnectAttempts) {
+                this.onErrorConnection.emit(`Tentando reconectar (${this.reconnectAttempts})...`);
+                this.isConnectionSuccess = false;
+                this.emitStatusConnection();
+                setTimeout(() => {
+                    this.connect(webSocketServer);
+                }, 3000);
+                return new Subject();
+            }
+            else {
+                this.onErrorConnection.emit("Máximo de tentativas de reconexão atingido.");
+                this.isConnectionSuccess = false;
+                this.emitStatusConnection();
+                return new Subject();
+            }
+        }), retry(this.maxReconnectAttempts))
+            .subscribe();
+        this.register();
+    }
+    emitStatusConnection() {
+        this.isConnectionEvent.emit(this.isConnectionSuccess);
+    }
+    register() {
+        if (this.socket$ && !this.socket$.closed) {
+            this.isConnectionSuccess = true;
+            this.emitStatusConnection();
+            this.onSuccessConnection.emit(true);
+            this.socket$.next("register:web_client");
+        }
+    }
+    /**
+     *
+     * @returns {void}
+     * Este método permite enviar mensagem para o servidor websocket.
+     */
+    sendMessage(msg) {
+        if (this.socket$ && !this.socket$.closed) {
+            this.socket$.next(msg);
+        }
+    }
+    /**
+     *
+     * @returns {Observable<any>} Observável que emite mensagens da conexão WebSocket..
+     * Este método permite que outros componentes assinem as mensagens recebidas do servidor WebSocket.
+     */
+    getMessages() {
+        return this.socket$.asObservable();
+    }
+    /**
+     *
+     * @returns {void}
+     * Este método fecha a conexão WebSocket.
+     * É importante chamar este método quando a aplicação não precisar mais da conexão WebSocket,
+     */
+    close() {
+        if (this.socket$) {
+            this.isSocketClosed = true;
+            this.socket$.complete();
+            this.socket$ = null;
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoWebSocketService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoWebSocketService, providedIn: "root" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.2", ngImport: i0, type: CaoWebSocketService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: "root",
+                }]
+        }] });
+
 /*
  * Public API Surface of ngx-opalbytes-services
  */
@@ -26,5 +221,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.2", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { NgxOpalbytesServices };
+export { CaoDatePipeService, CaoInstallationService, CaoWebSocketService, NgxOpalbytesServices };
 //# sourceMappingURL=ngx-opalbytes-services.mjs.map

package/fesm2022/ngx-opalbytes-services.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngx-opalbytes-services.mjs","sources":["../../../projects/ngx-opalbytes-services/src/lib/ngx-opalbytes-services.ts","../../../projects/ngx-opalbytes-services/src/public-api.ts","../../../projects/ngx-opalbytes-services/src/ngx-opalbytes-services.ts"],"sourcesContent":["import { Component } from '@angular/core';\n\n@Component({\n  selector: 'cao-ngx-opalbytes-services',\n  imports: [],\n  template: `\n    <p>\n      ngx-opalbytes-services works!\n    </p>\n  `,\n  styles: ``,\n})\nexport class NgxOpalbytesServices {\n\n}\n","/*\n * Public API Surface of ngx-opalbytes-services\n */\n\nexport * from './lib/ngx-opalbytes-services';","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;MAYa,oBAAoB,CAAA;uGAApB,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;AAApB,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,oBAAoB,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,4BAAA,EAAA,QAAA,EAAA,EAAA,EAAA,QAAA,EAPrB;;;;AAIT,EAAA,CAAA,EAAA,QAAA,EAAA,IAAA,EAAA,MAAA,EAAA,CAAA,EAAA,CAAA,EAAA,CAAA;;2FAGU,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAVhC,SAAS;+BACE,4BAA4B,EAAA,OAAA,EAC7B,EAAE,EAAA,QAAA,EACD;;;;AAIT,EAAA,CAAA,EAAA;;;ACTH;;AAEG;;ACFH;;AAEG;;;;"}
+{"version":3,"file":"ngx-opalbytes-services.mjs","sources":["../../../projects/ngx-opalbytes-services/src/lib/ngx-opalbytes-services.ts","../../../projects/ngx-opalbytes-services/src/lib/services/date-pipe.service.ts","../../../projects/ngx-opalbytes-services/src/lib/services/installer.service.ts","../../../projects/ngx-opalbytes-services/src/lib/services/websocket.service.ts","../../../projects/ngx-opalbytes-services/src/public-api.ts","../../../projects/ngx-opalbytes-services/src/ngx-opalbytes-services.ts"],"sourcesContent":["import { Component } from '@angular/core';\n\n@Component({\n  selector: 'cao-ngx-opalbytes-services',\n  imports: [],\n  template: `\n    <p>\n      ngx-opalbytes-services works!\n    </p>\n  `,\n  styles: ``,\n})\nexport class NgxOpalbytesServices {\n\n}\n","import { DatePipe } from \"@angular/common\";\nimport { inject, Injectable } from \"@angular/core\";\n\n@Injectable({\n  providedIn: \"root\",\n})\nexport class CaoDatePipeService {\n  readonly datePipe = inject(DatePipe);\n\n  constructor() {}\n\n  getConvertedDatePipe(value: Date, transform: string): string {\n    const result = this.datePipe.transform(value, transform);\n\n    return result ?? \"\";\n  }\n}\n","import { Injectable } from \"@angular/core\";\n\nimport { Observable, BehaviorSubject } from \"rxjs\";\n\nexport interface IStatusInstallation {\n  isInstalled: boolean;\n  version?: string;\n  lastChecked: Date;\n  installationPath?: string;\n}\n\nexport interface IConfigInstallation {\n  executableName: string;\n  assetPath: string;\n  registryPath?: string;\n  expectedVersion?: string;\n}\n\nexport interface IBlobConfigInstallation {\n  executableName: string;\n  assetPath: Blob;\n}\n\n@Injectable({\n  providedIn: \"root\",\n})\nexport class CaoInstallationService {\n  private readonly installationStatus$ = new BehaviorSubject<IStatusInstallation>({\n    isInstalled: false,\n    lastChecked: new Date(),\n  });\n\n  readonly status$ = this.installationStatus$.asObservable();\n\n  downloadAndInstall(config: IConfigInstallation): Observable<boolean> {\n    return new Observable((observer) => {\n      try {\n        const url = config.assetPath;\n        const link = document.createElement(\"a\");\n\n        link.target = \"_blank\";\n        link.href = url;\n        link.download = config.executableName || \"download\";\n\n        link.style.display = \"none\";\n\n        document.body.appendChild(link);\n        link.click();\n        document.body.removeChild(link);\n\n        setTimeout(() => {\n          observer.next(true);\n          observer.complete();\n        }, 100);\n      } catch (error) {\n        console.error(\"Erro no download:\", error);\n        observer.error(error);\n      }\n    });\n  }\n\n  downloadAndOpenFile(\n    config: IConfigInstallation,\n    isTargetBlank = true\n  ): Observable<boolean> {\n    return new Observable((observer) => {\n      try {\n        const link = document.createElement(\"a\");\n        link.href = config.assetPath;\n        link.target = isTargetBlank ? \"_blank\" : \"\";\n        link.rel = \"noopener noreferrer\";\n\n        document.body.appendChild(link);\n        link.click();\n        document.body.removeChild(link);\n\n        observer.next(true);\n        observer.complete();\n      } catch (error) {\n        observer.error(error);\n      }\n    });\n  }\n\n  downloadBlobFile(configBlob: IBlobConfigInstallation): void {\n    const url = window.URL.createObjectURL(configBlob.assetPath);\n    const a = document.createElement(\"a\");\n    a.href = url;\n    a.download = configBlob.executableName;\n    document.body.appendChild(a);\n    a.click();\n    window.URL.revokeObjectURL(url);\n    document.body.removeChild(a);\n  }\n\n  reinstall(config: IConfigInstallation): Observable<boolean> {\n    return this.downloadAndInstall(config);\n  }\n}","import { EventEmitter, Injectable } from \"@angular/core\";\n\nimport { Observable, Subject } from \"rxjs\";\nimport { catchError, retry } from \"rxjs/operators\";\nimport { webSocket, WebSocketSubject } from \"rxjs/webSocket\";\n\n@Injectable({\n  providedIn: \"root\",\n})\nexport class CaoWebSocketService {\n  protected socket$: WebSocketSubject<unknown> | null = null;\n  protected reconnectAttempts = 0;\n  protected maxReconnectAttempts = 5;\n\n  private isConnectionSuccess = false;\n  private isSocketClosed = false;\n\n  isConnectionEvent: EventEmitter<boolean> = new EventEmitter<boolean>();\n  onErrorConnection: EventEmitter<string> = new EventEmitter<string>()\n  onSuccessConnection: EventEmitter<boolean> = new EventEmitter<boolean>()\n\n  public startConnection(webSocketServer: string) {\n    this.reconnectAttempts = 0;\n    this.isSocketClosed = false;\n    this.connect(webSocketServer);\n  }\n  \n  public connect(webSocketServer: string) {\n    this.socket$ = webSocket({\n      url: webSocketServer,\n      deserializer: (e) => {\n        try {\n          return JSON.parse(e.data);\n        } catch {\n          return e.data;\n        }\n      },\n    });\n\n    this.socket$\n      .pipe(\n        catchError((error) => {\n          if (this.isSocketClosed) {\n            return new Subject();\n          }\n          this.onErrorConnection.emit(error);\n          this.reconnectAttempts++;\n          if (this.reconnectAttempts <= this.maxReconnectAttempts) {\n            this.onErrorConnection.emit(`Tentando reconectar (${this.reconnectAttempts})...`);\n            this.isConnectionSuccess = false;\n            this.emitStatusConnection();\n            setTimeout(() => {\n              this.connect(webSocketServer);\n            }, 3000);\n            return new Subject();\n          } else {\n            this.onErrorConnection.emit(\"Máximo de tentativas de reconexão atingido.\");\n            this.isConnectionSuccess = false;\n            this.emitStatusConnection();\n            return new Subject();\n          }\n        }),\n        retry(this.maxReconnectAttempts)\n      )\n      .subscribe();\n    this.register();\n  }\n\n  emitStatusConnection() {\n    this.isConnectionEvent.emit(this.isConnectionSuccess);\n  }\n\n  register() {\n    if (this.socket$ && !this.socket$.closed) {\n      this.isConnectionSuccess = true;\n      this.emitStatusConnection();\n      this.onSuccessConnection.emit(true)\n      this.socket$.next(\"register:web_client\");\n    }\n  }\n\n  /**\n   *\n   * @returns {void}\n   * Este método permite enviar mensagem para o servidor websocket.\n   */\n  sendMessage(msg: any) {\n    if (this.socket$ && !this.socket$.closed) {\n      this.socket$.next(msg);\n    }\n  }\n\n  /**\n   *\n   * @returns {Observable<any>} Observável que emite mensagens da conexão WebSocket..\n   * Este método permite que outros componentes assinem as mensagens recebidas do servidor WebSocket.\n   */\n  getMessages(): Observable<any> {\n    return this.socket$!.asObservable();\n  }\n\n  /**\n   *\n   * @returns {void}\n   * Este método fecha a conexão WebSocket.\n   * É importante chamar este método quando a aplicação não precisar mais da conexão WebSocket,\n   */\n  close() {\n    if (this.socket$) {\n      this.isSocketClosed = true;\n      this.socket$.complete();\n      this.socket$ = null;\n    }\n  }\n}\n","/*\n * Public API Surface of ngx-opalbytes-services\n */\n\nexport * from './lib/ngx-opalbytes-services';\nexport * from './lib/services/date-pipe.service';\nexport * from './lib/services/installer.service';\nexport * from './lib/services/websocket.service';","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-opalbytes-services",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/types/ngx-opalbytes-services.d.ts

@@ -1,8 +1,84 @@
 import * as i0 from '@angular/core';
+import { EventEmitter } from '@angular/core';
+import { DatePipe } from '@angular/common';
+import { Observable } from 'rxjs';
+import { WebSocketSubject } from 'rxjs/webSocket';
 
 declare class NgxOpalbytesServices {
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxOpalbytesServices, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NgxOpalbytesServices, "cao-ngx-opalbytes-services", never, {}, {}, never, never, true, never>;
 }
 
-export { NgxOpalbytesServices };
+declare class CaoDatePipeService {
+    readonly datePipe: DatePipe;
+    constructor();
+    getConvertedDatePipe(value: Date, transform: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CaoDatePipeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CaoDatePipeService>;
+}
+
+interface IStatusInstallation {
+    isInstalled: boolean;
+    version?: string;
+    lastChecked: Date;
+    installationPath?: string;
+}
+interface IConfigInstallation {
+    executableName: string;
+    assetPath: string;
+    registryPath?: string;
+    expectedVersion?: string;
+}
+interface IBlobConfigInstallation {
+    executableName: string;
+    assetPath: Blob;
+}
+declare class CaoInstallationService {
+    private readonly installationStatus$;
+    readonly status$: Observable<IStatusInstallation>;
+    downloadAndInstall(config: IConfigInstallation): Observable<boolean>;
+    downloadAndOpenFile(config: IConfigInstallation, isTargetBlank?: boolean): Observable<boolean>;
+    downloadBlobFile(configBlob: IBlobConfigInstallation): void;
+    reinstall(config: IConfigInstallation): Observable<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CaoInstallationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CaoInstallationService>;
+}
+
+declare class CaoWebSocketService {
+    protected socket$: WebSocketSubject<unknown> | null;
+    protected reconnectAttempts: number;
+    protected maxReconnectAttempts: number;
+    private isConnectionSuccess;
+    private isSocketClosed;
+    isConnectionEvent: EventEmitter<boolean>;
+    onErrorConnection: EventEmitter<string>;
+    onSuccessConnection: EventEmitter<boolean>;
+    startConnection(webSocketServer: string): void;
+    connect(webSocketServer: string): void;
+    emitStatusConnection(): void;
+    register(): void;
+    /**
+     *
+     * @returns {void}
+     * Este método permite enviar mensagem para o servidor websocket.
+     */
+    sendMessage(msg: any): void;
+    /**
+     *
+     * @returns {Observable<any>} Observável que emite mensagens da conexão WebSocket..
+     * Este método permite que outros componentes assinem as mensagens recebidas do servidor WebSocket.
+     */
+    getMessages(): Observable<any>;
+    /**
+     *
+     * @returns {void}
+     * Este método fecha a conexão WebSocket.
+     * É importante chamar este método quando a aplicação não precisar mais da conexão WebSocket,
+     */
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CaoWebSocketService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CaoWebSocketService>;
+}
+
+export { CaoDatePipeService, CaoInstallationService, CaoWebSocketService, NgxOpalbytesServices };
+export type { IBlobConfigInstallation, IConfigInstallation, IStatusInstallation };