@experteam-mx/ngx-services 20.9.10 → 20.9.11

package/index.d.ts

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { InjectionToken, ModuleWithProviders, EnvironmentProviders } from '@angular/core';
 import { HttpResponse, HttpRequest, HttpHandlerFn, HttpEvent, HttpParams, HttpHeaders } from '@angular/common/http';
 import { Observable, BehaviorSubject } from 'rxjs';
-import { Channel } from 'pusher-js';
+import Pusher, { Channel } from 'pusher-js';
 
 /**
  * Opt-in HTTP cache rule. First matching pattern against `req.urlWithParams` wins.
@@ -28,7 +28,6 @@ type HttpCacheRoute = {
  * - authCookie: The name of the authentication cookie used for user sessions.
  * - cacheRoutes: Optional. Opt-in HTTP cache rules; first matching pattern wins.
  * - printUrl: Optional. The URL used for generating or downloading printable documents.
- * - secretKey: A secret key used for authentication or other secure operations.
  */
 type Environment = {
     apiAuditsUrl?: string;
@@ -63,9 +62,7 @@ type Environment = {
     authCookie?: string;
     cacheRoutes?: HttpCacheRoute[];
     printUrl?: string;
-    secretKey?: string;
     sockets?: {
-        app_key: string;
         debug?: boolean;
         port: number;
         url: string;
@@ -9854,8 +9851,35 @@ declare enum PaymentTypeCode {
 
 declare class WebSocketsService {
     private pusher;
+    private appKey;
+    private connectPromise;
     private environments;
-    constructor();
+    private getAuthToken;
+    private readonly channelAuthHeaders;
+    /**
+     * Stores the Pusher/Soketi application key without opening a connection.
+     * The first `channelSub` / `eventBind` opens Pusher via `ensureConnected`.
+     *
+     * @param {string} appKey - The Pusher/Soketi application key.
+     */
+    setAppKey(appKey: string): void;
+    /**
+     * Registers a live token provider used when authorizing private/presence channels.
+     * The provider is called at subscribe/authorize time; the token is not snapshotted here.
+     *
+     * @param {() => string | null} getToken - Returns the current session token, or null.
+     */
+    setAuthTokenProvider(getToken: () => string | null): void;
+    /**
+     * Connects to Pusher using the given app key and env `sockets` url/port/debug.
+     * No-ops if already connected with the same key; reconnects if the key changed.
+     * Resolves false when `sockets` is missing from the environment.
+     * Apps should store the key with `setAppKey` and let subscribe open the client.
+     *
+     * @param {string} appKey - The Pusher/Soketi application key.
+     * @return {Promise<Pusher | false>} The Pusher instance, or false when sockets are not configured.
+     */
+    connect(appKey: string): Promise<Pusher | false>;
     /**
      * Publishes an event to the specified channel with the given data.
      *
@@ -9867,11 +9891,11 @@ declare class WebSocketsService {
      */
     pub<T>(channel: Channel, eventName: string, data: T): Promise<boolean>;
     /**
-     * Subscribes to a specified channel, retrying multiple times upon failure.
+     * Subscribes to a specified channel and resolves when Pusher reports success.
      *
      * @param {string} channelName - The name of the channel to be subscribed to.
      * @return {Promise<Channel>} A promise that resolves to the subscribed channel object if successful.
-     * @throws {Error} If the subscription fails after the maximum number of retry attempts.
+     * @throws {Error} If the subscription fails.
      */
     channelSub(channelName: string): Promise<Channel>;
     /**
@@ -9892,16 +9916,21 @@ declare class WebSocketsService {
      * @return {Observable<T>} An observable that emits data from the unbound event callback.
      */
     eventUnbind<T>(channel: Channel, event: string): Observable<unknown>;
-    private connect;
-    private wait;
+    /**
+     * Unsubscribes from a channel by name.
+     *
+     * @param {string} channelName - The channel name previously passed to subscribe.
+     */
+    unsubscribe(channelName: string): void;
+    private ensureConnected;
+    private refreshChannelAuthHeader;
     static ɵfac: i0.ɵɵFactoryDeclaration<WebSocketsService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WebSocketsService>;
 }
 
 declare class CryptoService {
-    private environments;
-    encryptAES(plaintext: string): Promise<string>;
-    decryptAES(payload: string): Promise<string>;
+    encryptAES(plaintext: string, secretKey: string): Promise<string>;
+    decryptAES(payload: string, secretKey: string): Promise<string>;
     private loadKey;
     private uint8ArrayToBase64;
     private base64ToUint8Array;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@experteam-mx/ngx-services",
-  "version": "20.9.10",
+  "version": "20.9.11",
   "description": "Angular common services for Experteam apps",
   "author": "Experteam Cía. Ltda.",
   "keywords": [