@fluxo-dev/shell 25.2.9 → 25.2.11

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@fluxo-dev/shell",
-  "version": "25.2.9",
+  "version": "25.2.11",
   "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.2.9",
-    "@fluxo-dev/shell-bi": "^25.2.9",
-    "@fluxo-dev/shell-hub": "^25.2.9",
-    "@fluxo-dev/shell-korebi": "^25.2.9",
-    "@fluxo-dev/shell-mfe": "^25.2.9",
-    "@fluxo-dev/shell-printing": "^25.2.9",
-    "@fluxo-dev/shell-reporting": "^25.2.9",
-    "@fluxo-dev/shell-workflow": "^25.2.9",
-    "@fluxo-dev/shell-ravify": "^25.2.9",
-    "@fluxo-dev/state": "^25.2.9",
-    "@fluxo-dev/ui-components": "^25.2.9",
+    "@fluxo-dev/api-client-base": "^25.2.11",
+    "@fluxo-dev/shell-bi": "^25.2.11",
+    "@fluxo-dev/shell-hub": "^25.2.11",
+    "@fluxo-dev/shell-korebi": "^25.2.11",
+    "@fluxo-dev/shell-mfe": "^25.2.11",
+    "@fluxo-dev/shell-printing": "^25.2.11",
+    "@fluxo-dev/shell-reporting": "^25.2.11",
+    "@fluxo-dev/shell-workflow": "^25.2.11",
+    "@fluxo-dev/shell-ravify": "^25.2.11",
+    "@fluxo-dev/state": "^25.2.11",
+    "@fluxo-dev/ui-components": "^25.2.11",
     "@scalar/api-reference-react": "^0.3.142",
     "@devexpress/analytics-core": "23.1.3",
     "devexpress-dashboard": "23.1.3",

package/src/index.d.ts

@@ -1,2 +1,5 @@
 export { FluxoShell, type FluxoShellProps, type ShellFrontend, type ShellUI, ShellUINavigation } from './lib/app';
 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';

package/src/lib/app.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { EmbeddedModule, InitialConfiguration } from '@fluxo-dev/api-client-base';
+import { EmbeddedModule, FluxoUserProfile, InitialConfiguration, User } from '@fluxo-dev/api-client-base';
 import './app.module.css';
 import 'dayjs/locale/it';
 import { FrontendSwitcherUiProps } from './pages/frontend-switcher/frontend-switcher';
@@ -38,6 +38,15 @@ export interface ShellUI {
     withMultipleSessions?: boolean;
     frontendSwitcher?: FrontendSwitcherUiProps;
 }
+export interface ShellSlots {
+    administrationSecurityUserProfile?: (data: {
+        user: User;
+        onClose: () => void;
+    }) => JSX.Element;
+    userProfile?: (data: {
+        user: FluxoUserProfile;
+    }) => JSX.Element;
+}
 export interface FluxoShellProps {
     pluginEndpoint: string;
     appVersion: string;
@@ -45,6 +54,7 @@ export interface FluxoShellProps {
     clientInitialization: () => Promise<void>;
     brandName?: string;
     ui: ShellUI;
+    slots?: ShellSlots;
     routing?: {
         basename?: string;
     };

package/src/lib/components/screen-sharing-consent-modal.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface ScreenSharingConsentModalProps {
+    opened: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+/**
+ * Modale per richiedere il consenso alla condivisione dello schermo
+ */
+export declare const ScreenSharingConsentModal: React.FC<ScreenSharingConsentModalProps>;
+export {};

package/src/lib/components/screen-sharing-widget.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+export interface ScreenSharingWidgetProps {
+    /**
+     * Dimensione del widget
+     * - 'xs': Extra small
+     * - 'sm': Small (default)
+     * - 'md': Medium
+     * - 'lg': Large
+     */
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /**
+     * Testo personalizzato per il pulsante di blocco
+     * Default: "Blocca condivisione"
+     */
+    blockButtonLabel?: string;
+}
+/**
+ * Widget per gestire lo screen sharing.
+ * Mostra un indicatore quando lo schermo è sotto osservazione e permette di bloccare la condivisione.
+ * Il widget è responsive: su desktop mostra badge e pulsante separati, su mobile mostra un badge cliccabile compatto.
+ *
+ * @example
+ * // Nel tuo layout custom
+ * <ScreenSharingWidget />
+ *
+ * @example
+ * // Con testo personalizzato
+ * <ScreenSharingWidget blockButtonLabel="Interrompi" />
+ *
+ * @example
+ * // Con dimensione maggiore
+ * <ScreenSharingWidget size="md" />
+ */
+export declare const ScreenSharingWidget: React.FC<ScreenSharingWidgetProps>;

package/src/lib/components/screen-viewer-modal.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+interface ScreenViewerModalProps {
+    opened: boolean;
+    onClose: () => void;
+    connectionId?: string;
+    userName?: string;
+    sessionHub: {
+        on: (eventName: string, handler: (...args: any[]) => void) => void;
+        off: (eventName: string, handler?: (...args: any[]) => void) => void;
+        invoke: <T = any>(methodName: string, ...args: any[]) => Promise<T>;
+    };
+}
+/**
+ * Modal per visualizzare lo schermo condiviso di un utente in tempo reale
+ */
+export declare const ScreenViewerModal: React.FC<ScreenViewerModalProps>;
+export {};

package/src/lib/contexts/screen-sharing-context.d.ts

@@ -0,0 +1,29 @@
+import React, { ReactNode } from 'react';
+interface ScreenSharingContextValue {
+    isBeingWatched: boolean;
+    startSharing: () => void;
+    stopSharing: () => void;
+    isSupported: boolean;
+    error: string | null;
+    needsUserPermission: boolean;
+}
+interface ScreenSharingProviderProps {
+    children: ReactNode;
+    sessionHub: {
+        on: (eventName: string, handler: (...args: any[]) => void) => void;
+        off: (eventName: string, handler?: (...args: any[]) => void) => void;
+        send: (methodName: string, ...args: any[]) => Promise<void>;
+        isConnected: (() => boolean) | boolean;
+    };
+}
+/**
+ * Provider che gestisce lo screen sharing a livello globale
+ * DEVE essere usato una sola volta nell'app per evitare richieste duplicate
+ */
+export declare const ScreenSharingProvider: React.FC<ScreenSharingProviderProps>;
+/**
+ * Hook per accedere allo stato dello screen sharing
+ * Può essere usato in qualsiasi componente figlio del Provider
+ */
+export declare const useScreenSharingContext: () => ScreenSharingContextValue;
+export {};

package/src/lib/hooks/use-screen-sharing.d.ts

@@ -0,0 +1,19 @@
+interface ScreenSharingHook {
+    isBeingWatched: boolean;
+    startSharing: () => void;
+    stopSharing: () => void;
+    isSupported: boolean;
+    error: string | null;
+    needsUserPermission: boolean;
+}
+/**
+ * Hook per gestire lo screen sharing lato utente usando getDisplayMedia
+ * Cattura nativa del browser - richiede permesso utente ma qualità perfetta
+ */
+export declare const useScreenSharing: (sessionHub: {
+    on: (eventName: string, handler: (...args: any[]) => void) => void;
+    off: (eventName: string, handler?: (...args: any[]) => void) => void;
+    send: (methodName: string, ...args: any[]) => Promise<void>;
+    isConnected: (() => boolean) | boolean;
+}) => ScreenSharingHook;
+export {};

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

@@ -0,0 +1,16 @@
+/**
+ * Hook to manage SessionHub WebSocket connection lifecycle
+ * @param shouldConnect - When true, starts the connection. Use this to delay connection until FluxoClient is initialized
+ */
+export declare const useSessionHub: (shouldConnect?: boolean) => {
+    on: (eventName: string, handler: (...args: any[]) => void) => void;
+    off: (eventName: string, handler?: (...args: any[]) => void) => void;
+    invoke: <T = any>(methodName: string, ...args: any[]) => Promise<T>;
+    send: (methodName: string, ...args: any[]) => Promise<void>;
+    getState: () => import("@microsoft/signalr").HubConnectionState;
+    isConnected: () => boolean;
+    connected: boolean;
+    reconnect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    hasBeenConnectedOnce: boolean;
+};

package/src/lib/layouts/main/hooks/usePageTracker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook personalizzato per tracciare i cambiamenti di pagina e titolo
+ * e inviare gli aggiornamenti al server via SessionHub
+ */
+export declare const usePageTracker: (sessionHub: {
+    isConnected: () => boolean;
+    invoke: <T = any>(methodName: string, ...args: any[]) => Promise<T>;
+}) => void;

package/src/lib/pages/login/user-profile.d.ts

@@ -1,2 +1,5 @@
-export declare function UserProfile(): import("react/jsx-runtime").JSX.Element;
+import { ShellSlots } from '../../app';
+export declare function UserProfile(props: {
+    slots?: ShellSlots;
+}): import("react/jsx-runtime").JSX.Element;
 export default UserProfile;

package/src/lib/pages/settings/connected-users/connected-users.d.ts

@@ -0,0 +1 @@
+export declare function ConnectedUsers(): import("react/jsx-runtime").JSX.Element;

package/src/lib/pages/settings/menu-designer/menu-designer.d.ts

@@ -1,4 +1,4 @@
-import { ShellFrontend } from "@fluxo-dev/shell";
+import { ShellFrontend } from '../../../app';
 export interface MenuDesignerProps {
     frontends: ShellFrontend[];
 }

package/src/lib/pages/settings/menu-designer/menu-edit-form.d.ts

@@ -0,0 +1,7 @@
+import { AppMenu } from "@fluxo-dev/api-client-base";
+export interface MenuEditFormProps {
+    menu: AppMenu;
+    onUpdated: () => void;
+    onCancel: () => void;
+}
+export declare function MenuEditForm(props: MenuEditFormProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/pages/settings/menu-designer/menu-import-form.d.ts

@@ -0,0 +1,9 @@
+import { DomainRole, User } from '@fluxo-dev/api-client-base';
+export interface MenuImportFormProps {
+    menuDefinition: any;
+    domainRoles: DomainRole[];
+    users: User[];
+    onCancel: () => void;
+    onImported: () => void;
+}
+export declare function MenuImportForm(props: MenuImportFormProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/pages/settings/security/components/user/users-grid.d.ts

@@ -1 +1,4 @@
-export declare function UsersGrid(): import("react/jsx-runtime").JSX.Element;
+import { ShellSlots } from '../../../../../app';
+export declare function UsersGrid(props: {
+    slots?: ShellSlots;
+}): import("react/jsx-runtime").JSX.Element;

package/src/lib/pages/settings/settings.d.ts

@@ -1,7 +1,8 @@
+import { ShellFrontend, ShellSlots } from '../../app';
 import '@scalar/api-reference-react/style.css';
-import { ShellFrontend } from "../../app";
 export interface SettingsProps {
     pluginEndpoint: string;
     frontends: ShellFrontend[];
+    slots?: ShellSlots;
 }
 export declare function Settings(props: SettingsProps): import("react/jsx-runtime").JSX.Element;

package/src/lib/pages/settings/token/token-row.d.ts

@@ -1,4 +1,5 @@
 import { ApiKey } from "@fluxo-dev/api-client-base";
+import 'dayjs/locale/it';
 interface TokenRowProps {
     token: ApiKey;
     onChange: () => void;