@esfaenza/extensions 13.1.5 → 13.1.6

package/fesm2020/esfaenza-extensions.mjs

@@ -3,6 +3,7 @@ import { InjectionToken, NgModule, Injectable, Optional, Inject } from '@angular
 import swal from 'sweetalert2';
 import * as i1 from 'ngx-toastr';
 import { Deserialize } from 'cerialize';
+import { Subject } from 'rxjs';
 
 /**
  * Token che identifica il locale da utilizzare per questa libreria, sono supportati i locali 'it-IT' ed 'en-US'
@@ -1755,6 +1756,67 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.1.1", ngImpor
             type: Injectable
         }] });
 
+/** Classe che rappresenta un generico messaggio scambiato fra applicazione e moduli */
+class InterComMessage {
+    /**
+     * Costruttore
+     *
+     * @param type Tipo di messaggio
+     * @param message Contenuto del messaggio
+     */
+    constructor(type, message) {
+        this.type = type;
+        this.message = message;
+    }
+}
+
+// Angular
+/** Service che si occupa di gestire la comunicazione fra i moduli interni ed esterni dell'applicativo */
+class InterComService {
+    constructor() {
+        /** Messaggi in uscita, uno per ogni recipient registratosi dall'entrypoint **register** */
+        this.outbounds = {};
+        /** Messaggi in entrata, unico per applicazione principale */
+        this.inbounds = new Subject();
+    }
+    /**
+     * Metodo che permette di inviare un messaggio dall'applicazione ad un modulo esterno o viceversa
+     *
+     * @param {any} messageType Tipologia di messaggio. Sarà di tipo **InboundMessageTypes** per tutti i messaggi inbound, dinamico per tutti i mesaggi outbound (il tipo dipenderà dagli enum dei messaggi dei moduli esterni)
+     * @param {any} message Messaggio da inviare che può essere un dto in casi complessi ma dovrà essere gestito a dovere lato implementativo
+     * @param {string} recipient Destinatario del messaggio. Per i messaggi inbound dev'essere lasciato vuoto, per i messaggi outbound sarà valorizzato alla chiave del modulo a cui si vuole inviare il messaggio
+     */
+    send(messageType, message, recipient) {
+        let msg = new InterComMessage(messageType, message);
+        // Se non c'è un recipient significa che è un modulo esterno che invia messaggi al modulo main (quindi messaggio in entrata - inbound)
+        // Altrimenti significa che è il modulo main ad inviare messaggi ai moduli esterni (messaggio in uscita - outbound)
+        if (!recipient) {
+            this.inbounds.next(msg);
+        }
+        else {
+            if (!this.outbounds[recipient])
+                console.warn("@esfaenza/extensions - InterComService: Impossibile inviare il messaggio al recipient " + recipient + " assicurarsi che il modulo sia caricato e che effettui la chiamata al metodo 'regisster'");
+            else
+                this.outbounds[recipient].next(msg);
+        }
+    }
+    /**
+     * Permette di registrare un modulo esterno alla lista dei moduli in listening sulla coda di messaggi
+     *
+     * @param {string} key Chiave del modulo da registrare. Tutti i messaggi inbound saranno inviati dall'applicazione principale su questa chiave
+     */
+    register(key) {
+        if (this.outbounds[key])
+            throw "@esfaenza/extensions - InterComService: Impossibile registrare più volte lo stesso modulo";
+        this.outbounds[key] = new Subject();
+    }
+}
+InterComService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.1.1", ngImport: i0, type: InterComService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+InterComService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "13.1.1", ngImport: i0, type: InterComService });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.1.1", ngImport: i0, type: InterComService, decorators: [{
+            type: Injectable
+        }] });
+
 // Angular
 /**
  * Modulo di estensione che registra autonomamente **TUTTI** i servizi di estensione:
@@ -1764,6 +1826,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.1.1", ngImpor
  * HashingService,
  * MessageService,
  * UtilityService
+ * InterComService
  *
  * con eventuali provider che utilizzano
  */
@@ -1778,6 +1841,7 @@ class FullExtensionsModule {
                 HashingService,
                 MessageService,
                 UtilityService,
+                InterComService,
                 { provide: EXT_LOCALE, useValue: config?.locale || 'it-IT' },
                 { provide: EXT_FANCY_ALERTS, useValue: config?.fancy_alerts || true },
                 { provide: APPSEARCH_PREFIX, useValue: config?.appsearch_prefix || 'Hot' },
@@ -1811,6 +1875,13 @@ class CsvHeaders {
 class GenericItem {
 }
 
+/** Enumeratore dei tipi di messaggio che i moduli esterni possono contattare sull'applicazione principale */
+var InboundMessageTypes;
+(function (InboundMessageTypes) {
+    /** Evento di navigazione */
+    InboundMessageTypes[InboundMessageTypes["Navigation"] = 0] = "Navigation";
+})(InboundMessageTypes || (InboundMessageTypes = {}));
+
 /*
  * Public API Surface of extensions
  */
@@ -1819,5 +1890,5 @@ class GenericItem {
  * Generated bundle index. Do not edit.
  */
 
-export { APPSEARCH_PREFIX, CallResult, ClipboardService, CsvHeaders, DateService, EXT_ALLOW_UTC, EXT_FANCY_ALERTS, EXT_LOCALE, Export, ExportAs, ExportDictionary, ExportList, ExportService, ExtensionsModule, FullExtensionsModule, GenericItem, HashingService, MessageService, UtilityService };
+export { APPSEARCH_PREFIX, CallResult, ClipboardService, CsvHeaders, DateService, EXT_ALLOW_UTC, EXT_FANCY_ALERTS, EXT_LOCALE, Export, ExportAs, ExportDictionary, ExportList, ExportService, ExtensionsModule, FullExtensionsModule, GenericItem, HashingService, InboundMessageTypes, InterComMessage, InterComService, MessageService, UtilityService };
 //# sourceMappingURL=esfaenza-extensions.mjs.map