@fluxo-dev/shell 25.3.8 → 25.4.0

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@fluxo-dev/shell",
-  "version": "25.3.8",
+  "version": "25.4.0",
   "peerDependencies": {
     "react": "^18.3.1",
     "@mantine/core": "^7.12.2",
     "react-router-dom": "^6.11.2",
     "react-redux": "^8.0.5",
     "@reduxjs/toolkit": "^1.9.1",
-    "@fluxo-dev/api-client-base": "^25.3.8",
-    "@fluxo-dev/shell-bi": "^25.3.8",
-    "@fluxo-dev/shell-hub": "^25.3.8",
-    "@fluxo-dev/shell-korebi": "^25.3.8",
-    "@fluxo-dev/shell-mfe": "^25.3.8",
-    "@fluxo-dev/shell-printing": "^25.3.8",
-    "@fluxo-dev/shell-reporting": "^25.3.8",
-    "@fluxo-dev/shell-workflow": "^25.3.8",
-    "@fluxo-dev/shell-ravify": "^25.3.8",
-    "@fluxo-dev/state": "^25.3.8",
-    "@fluxo-dev/ui-components": "^25.3.8",
+    "@fluxo-dev/api-client-base": "^25.4.0",
+    "@fluxo-dev/shell-bi": "^25.4.0",
+    "@fluxo-dev/shell-hub": "^25.4.0",
+    "@fluxo-dev/shell-korebi": "^25.4.0",
+    "@fluxo-dev/shell-mfe": "^25.4.0",
+    "@fluxo-dev/shell-printing": "^25.4.0",
+    "@fluxo-dev/shell-reporting": "^25.4.0",
+    "@fluxo-dev/shell-workflow": "^25.4.0",
+    "@fluxo-dev/shell-ravify": "^25.4.0",
+    "@fluxo-dev/state": "^25.4.0",
+    "@fluxo-dev/ui-components": "^25.4.0",
     "@scalar/api-reference-react": "^0.3.142",
     "@devexpress/analytics-core": "23.1.3",
     "devexpress-dashboard": "23.1.3",

package/src/index.d.ts

@@ -2,6 +2,7 @@ export { FluxoShell, type FluxoShellProps, type ShellFrontend, type ShellUI, She
 export { FrontendSwitch } from './lib/components/frontend-switch';
 export { ScreenSharingProvider, useScreenSharingContext } from './lib/contexts/screen-sharing-context';
 export { ScreenSharingWidget, type ScreenSharingWidgetProps } from './lib/components/screen-sharing-widget';
-export { useSessionHub } from './lib/hooks/use-session-hub';
+export { MessageReceiverModal } from './lib/components/message-receiver-modal';
+export { useSessionHub, type ReceivedMessage, type MessageType, type DisplayType } from './lib/hooks/use-session-hub';
 export { LockedResource, type LockedResourceProps } from './lib/locked-resource';
 export { ShellSessionContext } from './lib/layouts/main/shell-session-provider';

package/src/lib/components/message-receiver-modal.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * Modal per visualizzare i messaggi ricevuti dal server
+ * Supporta 3 modalità di visualizzazione:
+ * - Modal: apre un modal tradizionale
+ * - Toast: notifica bottom-right che resta aperta finché l'utente non la chiude
+ * - NotificationBar: barra full-width fixed top che resta aperta finché l'utente non la chiude
+ *
+ * I messaggi sono persistiti in localStorage e ricompaiono al refresh della pagina
+ */
+export declare const MessageReceiverModal: React.FC;

package/src/lib/components/routes/main-routes.d.ts

@@ -1,3 +1,4 @@
+import { RouteObject } from "react-router-dom";
 import { FluxoShellProps, ShellFrontend } from '../../app';
 export interface MainRoutesProps {
     pluginEndpoint: string;
@@ -5,4 +6,8 @@ export interface MainRoutesProps {
     isAdminFrontend: boolean;
     fluxoShellProps: FluxoShellProps;
 }
-export declare function MainRoutes(props: MainRoutesProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Genera le routes principali come RouteObject[] invece di componente wrapper
+ * Questo evita il remount dei componenti quando si switcha tra sessioni
+ */
+export declare function generateMainRoutes(props: MainRoutesProps, hasAdminAccess: boolean, hasDeveloperAccess: boolean, hasDataAnalystAccess: boolean): RouteObject[];

package/src/lib/components/send-message-modal.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+interface SendMessageModalProps {
+    opened: boolean;
+    onClose: () => void;
+    mode: 'broadcast' | 'user' | 'session' | 'multiple-users';
+    targetId?: string;
+    targetName?: string;
+    availableUsers?: Array<{
+        value: string;
+        label: string;
+    }>;
+    sessionHub: {
+        invoke: <T = any>(methodName: string, ...args: any[]) => Promise<T>;
+    };
+    onMessageSent?: () => void;
+}
+/**
+ * Modal per inviare messaggi agli utenti connessi
+ */
+export declare const SendMessageModal: React.FC<SendMessageModalProps>;
+export {};

package/src/lib/hooks/use-session-hub.d.ts

@@ -1,3 +1,21 @@
+/**
+ * Payload ricevuto dall'evento ReceiveMessage
+ */
+export interface ReceivedMessage {
+    messageType: string;
+    displayType: string;
+    message: string;
+    timestamp: string;
+    targetUserId?: string;
+}
+/**
+ * Tipi di messaggio suggeriti (personalizzabili)
+ */
+export type MessageType = 'Critico' | 'Errore' | 'Avviso' | 'Informazioni' | 'Successo' | 'Alert' | 'Notifica' | string;
+/**
+ * Tipi di visualizzazione suggeriti (personalizzabili)
+ */
+export type DisplayType = 'Toast' | 'Modal' | 'NotificationBar' | string;
 /**
  * Hook to manage SessionHub WebSocket connection lifecycle
  * @param shouldConnect - When true, starts the connection. Use this to delay connection until FluxoClient is initialized
@@ -15,4 +33,8 @@ export declare const useSessionHub: (shouldConnect?: boolean) => {
     reconnect: () => Promise<void>;
     disconnect: () => Promise<void>;
     hasBeenConnectedOnce: boolean;
+    sendBroadcastMessage: (messageType: MessageType, message: string) => Promise<void>;
+    sendMessageToSession: (targetConnectionId: string, messageType: MessageType, message: string) => Promise<void>;
+    sendMessageToUser: (targetUserId: string, messageType: MessageType, message: string) => Promise<void>;
+    onReceiveMessage: (handler: (data: ReceivedMessage) => void) => () => void;
 };