@fluxo-dev/api-client-base 25.2.9 → 25.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxo-dev/api-client-base",
-  "version": "25.2.9",
+  "version": "25.2.10",
   "type": "commonjs",
   "peerDependencies": {
     "react": "^18.3.1",
@@ -8,7 +8,7 @@
     "react-router-dom": "^6.11.2",
     "react-redux": "^8.0.5",
     "@reduxjs/toolkit": "^1.9.1",
-    "@fluxo-dev/state": "^25.2.9"
+    "@fluxo-dev/state": "^25.2.10"
   },
   "main": "./index.cjs.js",
   "types": "./index.cjs.d.ts"

package/src/index.d.ts

@@ -21,3 +21,4 @@ export * from './lib/utils';
 export * from './lib/infrastructure';
 export * from './lib/ravify';
 export * from './lib/bi';
+export * from './lib/session-hub';

package/src/lib/auth/auth-service.d.ts

@@ -13,6 +13,7 @@ export interface FluxoUserProfile {
     twoFactorEnabled: boolean;
     canChangePassword: boolean;
     canHandle2FA: boolean;
+    canHandleAccessTokens: boolean;
 }
 export declare class AuthService {
     private isRefreshingToken;

package/src/lib/configuration/configuration.service.d.ts

@@ -6,6 +6,7 @@ import { DomainRole } from "../security/domain-role/index";
 import { Permission } from "../security/permission/index";
 import { AppMenu } from "./app-menu";
 import { AppMenuCreateCommand } from "./app-menu-create-command";
+import { WebMenuExport } from './models';
 export type InitialConfiguration = {
     apps: FluxoApp[];
     menu: AppMenuItem[];
@@ -39,6 +40,9 @@ export declare class ConfigurationService {
     getSystemFeatures(): Promise<FeatureList>;
     saveAppMenu(webMenuId: number, menu: AppMenuItem[]): Promise<any>;
     createAppMenu(menu: AppMenuCreateCommand): Promise<any>;
+    updateAppMenu(webMenuId: number, menu: AppMenuCreateCommand): Promise<any>;
+    exportAppMenu(webMenuId: number): Promise<WebMenuExport>;
+    importAppMenu(menuDefinition: WebMenuExport): Promise<void>;
     getAppMenuList(): Promise<AppMenu[]>;
     getAppMenu(webMenuId: number): Promise<AppMenuItem[]>;
     getMenuItemPermissions(domainRoleId: string): Promise<Permission[]>;

package/src/lib/configuration/models/index.d.ts

@@ -2,3 +2,4 @@ export * from './module';
 export * from './feature';
 export * from './feature-list';
 export * from './update-routes-command';
+export * from './web-menu-export';

package/src/lib/configuration/models/web-menu-export.d.ts

@@ -0,0 +1,21 @@
+import { AppMenuContextType } from '../app-menu';
+export interface WebMenuExport {
+    name: string | null;
+    frontend: string | null;
+    contextType: AppMenuContextType;
+    domainRoleId: number | null;
+    userId: string | null;
+    items: WebMenuExportItem[];
+}
+export interface WebMenuExportItem {
+    tempId: string | null;
+    parentTempId: string | null;
+    label: string | null;
+    icon: string | null;
+    hasIndex: boolean;
+    routerLink: string | null;
+    isGroup: boolean;
+    menuItemIdentifier: string | null;
+    permissions: string[];
+    children: WebMenuExportItem[];
+}

package/src/lib/fluxo-client-interface.d.ts

@@ -10,6 +10,7 @@ import { ReportingService } from "./reporting";
 import { PrintingService } from "./printing";
 import { WorkflowService } from "./workflow";
 import { BiFacade } from "./bi";
+import { SessionHubService } from "./session-hub";
 export interface FluxoClientInterface {
     get clientConfig(): FluxoClientConfiguration;
     get security(): SecurityFacade;
@@ -23,4 +24,5 @@ export interface FluxoClientInterface {
     get communication(): CommunicationFacade;
     get ravify(): RavifyFacade;
     get bi(): BiFacade;
+    get sessionHub(): SessionHubService;
 }

package/src/lib/fluxo-client.d.ts

@@ -12,6 +12,7 @@ import { FluxoClientInterface } from "./fluxo-client-interface";
 import { CommunicationFacade } from "./communication";
 import { RavifyFacade } from "./ravify/ravify.facade";
 import { BiFacade } from "./bi";
+import { SessionHubService } from "./session-hub";
 export declare abstract class FluxoClientBase implements FluxoClientInterface {
     get modules(): any[];
     static get HttpClient(): HttpClient;
@@ -28,6 +29,7 @@ export declare abstract class FluxoClientBase implements FluxoClientInterface {
     private _config;
     private _ravify;
     private _biFacade;
+    private _sessionHub;
     private _modules;
     register(module: any): void;
     protected abstract AddSetupConfiguration(config: FluxoClientConfiguration): void;
@@ -47,5 +49,6 @@ export declare abstract class FluxoClientBase implements FluxoClientInterface {
     get workflow(): WorkflowService;
     get ravify(): RavifyFacade;
     get bi(): BiFacade;
+    get sessionHub(): SessionHubService;
     private getBearerToken;
 }

package/src/lib/security/apikey/apikey.d.ts

@@ -4,4 +4,5 @@ export interface ApiKey {
     expirationDate: Date;
     isActive: boolean;
     isExpired: boolean;
+    partialKey: string;
 }

package/src/lib/security/user/user.d.ts

@@ -22,4 +22,5 @@ export interface UserData {
 export interface SecurityPolicyInfo {
     canChangePassword: boolean;
     canHandle2FA: boolean;
+    canHandleAccessTokens: boolean;
 }

package/src/lib/session-hub/index.d.ts

@@ -0,0 +1 @@
+export * from './session-hub.service';

package/src/lib/session-hub/session-hub.service.d.ts

@@ -0,0 +1,90 @@
+import { HubConnectionState } from '@microsoft/signalr';
+/**
+ * SessionHubService manages the WebSocket connection to the backend session hub
+ * using SignalR with JWT authentication and automatic reconnection.
+ */
+export declare class SessionHubService {
+    private connection;
+    private hubUrl;
+    private getAccessToken;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelay;
+    private eventHandlers;
+    private reconnectTimeoutId;
+    private isManualStop;
+    constructor(baseUrl: string, getAccessToken: () => string);
+    getConnectedUsers(): Promise<{
+        userId: string;
+        count: number;
+        userName: string;
+        sessions: {
+            wsConnectionId: string;
+            userId: string;
+            userName: string;
+            ipAddress: string;
+            deviceId: string;
+            isPossibleFraud: boolean;
+            currentPage: string;
+            currentPath: string;
+            isActive: boolean;
+            browser: string;
+        }[];
+    }[]>;
+    /**
+     * Initializes and starts the SignalR connection
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the SignalR connection
+     */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to a hub event
+     * @param eventName The name of the event to listen to
+     * @param handler The callback function to execute when the event is received
+     */
+    on(eventName: string, handler: (...args: any[]) => void): void;
+    /**
+     * Unsubscribe from a hub event
+     * @param eventName The name of the event to stop listening to
+     * @param handler The specific handler to remove (optional, removes all if not provided)
+     */
+    off(eventName: string, handler?: (...args: any[]) => void): void;
+    /**
+     * Invoke a method on the server hub
+     * @param methodName The name of the method to invoke
+     * @param args Arguments to pass to the method
+     */
+    invoke<T = any>(methodName: string, ...args: any[]): Promise<T>;
+    /**
+     * Send a message to the server hub (fire and forget)
+     * @param methodName The name of the method to send
+     * @param args Arguments to pass to the method
+     */
+    send(methodName: string, ...args: any[]): Promise<void>;
+    /**
+     * Get the current connection state
+     */
+    get state(): HubConnectionState;
+    /**
+     * Check if the connection is currently active
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the connection ID
+     */
+    get connectionId(): string | null;
+    /**
+     * Setup connection lifecycle handlers
+     */
+    private setupConnectionHandlers;
+    /**
+     * Reattach all registered event handlers after reconnection
+     */
+    private reattachEventHandlers;
+    /**
+     * Schedule a reconnection attempt
+     */
+    private scheduleReconnect;
+}

package/src/lib/utils/device-id-manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Device ID Manager
+ * Gestisce la generazione e il recupero del device-id univoco per il dispositivo
+ */
+export declare class DeviceIdManager {
+    /**
+     * Genera un UUID v4
+     */
+    private static generateUUID;
+    /**
+     * Ottiene il device-id dal localStorage o ne genera uno nuovo
+     */
+    static getDeviceId(): string;
+    /**
+     * Genera forzatamente un nuovo device-id
+     */
+    static regenerateDeviceId(): string;
+    /**
+     * Rimuove il device-id dal localStorage
+     */
+    static clearDeviceId(): void;
+}

package/src/lib/utils/index.d.ts

@@ -1 +1,2 @@
 export * from './server-filter-helper';
+export * from './device-id-manager';