@esfaenza/extensions 11.2.21 → 11.2.24

package/fesm2015/esfaenza-extensions.js

@@ -2,8 +2,7 @@ import { InjectionToken, NgModule, Injectable, Optional, Inject } from '@angular
 import { ToastrService } from 'ngx-toastr';
 import swal from 'sweetalert2';
 import { Deserialize } from 'cerialize';
-import { first, tap } from 'rxjs/operators';
-import { of } from 'rxjs';
+import { Subject } from 'rxjs';
 
 /**
  * Token che identifica il locale da utilizzare per questa libreria, sono supportati i locali 'it-IT' ed 'en-US'
@@ -686,7 +685,7 @@ class DateService {
             tryThis = toCall(date, this.cfg.smallDate);
         else if (length == this.cfg.fulldateNoSS.length)
             tryThis = toCall(date, this.cfg.fulldateNoSS);
-        if (tryThis.isValid())
+        if (tryThis && tryThis.isValid())
             return tryThis;
         // Se niente funziona, null. 
         // Ricondurre l'Input ad una data non è possibile.
@@ -1737,230 +1736,63 @@ UtilityService.decorators = [
     { type: Injectable }
 ];
 
-/**
- * Classe che gestisce la scrittura delle informazioni nello store locale.
- * Questo store locale potrebbe essere il localStorage (implementazione di default data dal **DefaultStorageProvider**),
- * oppure un'implementazione custom facente capo a un DB esterno.
- *
- * In questo ultimo caso però sarà necessario implementarsi un proprio **BaseSessionRetriever**
- * che generi una chiave univoca di sessione su cui tutte le operazioni di questa classe saranno eseguite
- */
-class BaseStorageProvider {
-    /** @ignore Costruttore */
-    constructor(session) {
-        this.session = session;
-    }
+/** Classe che rappresenta un generico messaggio scambiato fra applicazione e moduli */
+class InterComMessage {
     /**
-    * Ottiene la chiave "Reale" da utilizzare per la persistenza di una chiave generica
-    *
-    * @param {string} key Chiave da storicizzare
-    *
-    * @returns {string} Unione fra l'identificativo della sessione e la chiave specificata
-    */
-    getKey(key) {
-        return this.session.getSessionKey() + "§" + key + "§";
+     * Costruttore
+     *
+     * @param type Tipo di messaggio
+     * @param message Contenuto del messaggio
+     */
+    constructor(type, message) {
+        this.type = type;
+        this.message = message;
     }
 }
 
-/**
- * Classe astratta che si occupa di recuperare l'Id sessione univoco per applicazione ed utente collegato
- */
-class BaseSessionRetriever {
-}
-
 // Angular
-/**
- * @deprecated Utilizzare "PreferencesService" dalla libreria "@esfaenza/preferences"
- *
- * Service che fornisce funzionalità di base per storicizzazione e recupero oggetti dallo Storage Locale
- *
- * N.B: In ogni chiamata è presente l'operatore rxjs **first()** per far sì che a prescindere dall'implementazione utente/default gli
- * observable effettuino l'unsubscribe automaticamente terminata la prima operazine
- */
-class StorageService {
-    /**
-     * Costruttore
-     *
-     * @ignore
-     */
-    constructor(APPSEARCH_PREFIX, _session, _storage) {
-        this.APPSEARCH_PREFIX = APPSEARCH_PREFIX;
-        this._session = _session;
-        this._storage = _storage;
+/** 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();
     }
     /**
-     * Inserisce un oggetto che funga da contenitore di oggetti nel local storage, ripulendone gli oggetti (supponendo che sia una view di ricerca) e marcandolo come
-     * salvato, in modo che quando viene recuperato il sistema non pensi che sia un oggetto vuoto ma che sappia che gli oggetti son stati ripuliti per risparmiare spazio
+     * Metodo che permette di inviare un messaggio dall'applicazione ad un modulo esterno o viceversa
      *
-     * @param {string} storeName Chiave del localStorage in cui storicizzare l'oggetto **itemsContainer**
-     * @param {{ items: any[] }} itemsContainer Oggetto da storicizzare
+     * @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
      */
-    setItem(storeName, item) {
-        var finalItem;
-        //Se sto salvando un oggetto con "items" e "page" vuol dire che è un appsearch, la ripulisco
-        if (item.items && item.page) {
-            finalItem = JSON.parse(JSON.stringify(item));
-            finalItem.items = [];
-            finalItem.savedstate = true;
-            finalItem.savedprefix = this.APPSEARCH_PREFIX || 'Hot';
+    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);
         }
-        else
-            finalItem = item;
-        return this._storage.setItem(storeName, finalItem).pipe(first(), tap(res => {
-            if (res == false)
-                console.error("Impossibile effettuare il salvataggio dell'oggetto all'interno dello Storage Locale per la chiave " + storeName);
-        }));
-    }
-    /**
-     * Recupera un oggetto dallo Storage Locale
-     *
-     * @param {string} storeName Chiave del localStorage da cui recuperare l'oggetto
-     *
-     * @returns {any} Oggetto recuperato e deserializzato
-     */
-    getItem(storeName) {
-        return this._storage.getItem(storeName).pipe(first(), tap(res => {
-            if (res == null)
-                console.warn("Impossibile ottenere l'oggetto salvato con chiave " + storeName);
-        }));
-    }
-    /**
-     * Ripulisce lo Storage Locale
-     *
-     * @param {string} storeName Chiave del localStorage da ripulire
-     */
-    removeItem(storeName) {
-        return this._storage.removeItem(storeName).pipe(first(), tap(res => {
-            if (res == false)
-                console.warn("Impossibile rimuovere l'oggetto salvato con chiave " + storeName);
-        }));
-    }
-    /**
-     * Ripulisce lo Storage Locale di ogni cosa salvata
-     *
-     * @param {string} storeName Chiave del localStorage da ripulire
-     */
-    clear() {
-        return this._storage.clear().pipe(first(), tap(res => {
-            if (res == false)
-                console.warn("Impossibile ripulire lo Storage Locale");
-        }));
     }
     /**
-     * Restituisce tutte le chiavi-valore associate alla sessione corrente
+     * Permette di registrare un modulo esterno alla lista dei moduli in listening sulla coda di messaggi
      *
-     * @returns {Observable<{ [index: string]: string; }>} Risultato della query
+     * @param {string} key Chiave del modulo da registrare. Tutti i messaggi inbound saranno inviati dall'applicazione principale su questa chiave
      */
-    getAll() {
-        return this._storage.getAll().pipe(first());
+    register(key) {
+        if (this.outbounds[key])
+            throw "@esfaenza/extensions - InterComService: Impossibile registrare più volte lo stesso modulo";
+        this.outbounds[key] = new Subject();
     }
 }
-StorageService.decorators = [
+InterComService.decorators = [
     { type: Injectable }
-];
-StorageService.ctorParameters = () => [
-    { type: String, decorators: [{ type: Optional }, { type: Inject, args: [APPSEARCH_PREFIX,] }] },
-    { type: BaseSessionRetriever },
-    { type: BaseStorageProvider }
-];
-
-/**
- * Implementazione di default per la classe **BaseSessionRetriever**
- */
-class DefaultSessionRetriever extends BaseSessionRetriever {
-    /**
-     * Costruttore
-     *
-     * @ignore
-     */
-    constructor() { super(); }
-    /**
-     * Ottiene un ID sessione
-     *
-     * @returns {string} ID sessione
-     */
-    getSessionKey() {
-        return "DUMMY_SESSION";
-    }
-}
-DefaultSessionRetriever.decorators = [
-    { type: Injectable }
-];
-DefaultSessionRetriever.ctorParameters = () => [];
-
-/** Implementazione di default per la classe **BaseStorageProvider** */
-class DefaultStorageProvider extends BaseStorageProvider {
-    /** @ignore Costruttore */
-    constructor(session) { super(session); }
-    /** @ignore Implementazione di Default con localStorage. Identity viene ignorata perché essendo già nel localStorage è già per sito */
-    setItem(key, value) {
-        try {
-            localStorage.setItem(key, JSON.stringify(value));
-            return of(true);
-        }
-        catch (_a) {
-            // Potrebbe arrivarmi un prefisso di salvataggio nella modalità di default. Questo serve per ripulire le stesse cose con quel prefisso e sperare di liberare spazio
-            if (value.savedprefix) {
-                console.warn("Spazio del local Storage insufficiente, prova a ripulirlo e risalvare");
-                //Pulisco tutte le view con nome che parta per "Hot"
-                for (let key in localStorage) {
-                    if (localStorage.hasOwnProperty(key) && key.startsWith(value.savedprefix))
-                        delete localStorage[key];
-                }
-                try {
-                    localStorage.setItem(key, JSON.stringify(value));
-                }
-                catch (e) {
-                    console.error("Spazio del local Storage insufficiente per salvare i risultati di ricerca con solo filtri. Non salvo nulla");
-                }
-            }
-            return of(false);
-        }
-    }
-    /** @ignore Implementazione di Default con localStorage. Identity viene ignorata perché essendo già nel localStorage è già per sito */
-    getItem(key) {
-        try {
-            var ret = JSON.parse(localStorage.getItem(key));
-            return of(ret);
-        }
-        catch (_a) {
-            return of(null);
-        }
-    }
-    /** @ignore Implementazione di Default con localStorage. Identity viene ignorata perché essendo già nel localStorage è già per sito */
-    removeItem(key) {
-        try {
-            localStorage.removeItem(key);
-            return of(true);
-        }
-        catch (_a) {
-            return of(false);
-        }
-    }
-    /** @ignore Implementazione di Default con localStorage. Identity viene ignorata perché essendo già nel localStorage è già per sito */
-    clear() {
-        try {
-            localStorage.clear();
-            return of(true);
-        }
-        catch (_a) {
-            return of(false);
-        }
-    }
-    /** @ignore Implementazione di Default con localStorage. Identity viene ignorata perché essendo già nel localStorage è già per sito */
-    getAll() {
-        var ret = {};
-        for (let key in localStorage) {
-            ret[key] = localStorage[key];
-        }
-        return of(ret);
-    }
-}
-DefaultStorageProvider.decorators = [
-    { type: Injectable }
-];
-DefaultStorageProvider.ctorParameters = () => [
-    { type: BaseSessionRetriever }
 ];
 
 // Angular
@@ -1971,8 +1803,8 @@ DefaultStorageProvider.ctorParameters = () => [
  * ExportService,
  * HashingService,
  * MessageService,
- * UtilityService,
- * StorageService,
+ * UtilityService
+ * InterComService
  *
  * con eventuali provider che utilizzano
  */
@@ -1987,13 +1819,11 @@ class FullExtensionsModule {
                 HashingService,
                 MessageService,
                 UtilityService,
-                StorageService,
+                InterComService,
                 { provide: EXT_LOCALE, useValue: (config === null || config === void 0 ? void 0 : config.locale) || 'it-IT' },
                 { provide: EXT_FANCY_ALERTS, useValue: (config === null || config === void 0 ? void 0 : config.fancy_alerts) || true },
                 { provide: APPSEARCH_PREFIX, useValue: (config === null || config === void 0 ? void 0 : config.appsearch_prefix) || 'Hot' },
-                { provide: EXT_ALLOW_UTC, useValue: (config === null || config === void 0 ? void 0 : config.allow_utc) == null ? false : config === null || config === void 0 ? void 0 : config.allow_utc },
-                { provide: BaseSessionRetriever, useClass: (config === null || config === void 0 ? void 0 : config.sessionRetriever) || DefaultSessionRetriever },
-                { provide: BaseStorageProvider, useClass: (config === null || config === void 0 ? void 0 : config.storageProvider) || DefaultStorageProvider },
+                { provide: EXT_ALLOW_UTC, useValue: (config === null || config === void 0 ? void 0 : config.allow_utc) == null ? false : config === null || config === void 0 ? void 0 : config.allow_utc }
             ]
         };
     }
@@ -2020,6 +1850,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
  */
@@ -2028,5 +1865,5 @@ class GenericItem {
  * Generated bundle index. Do not edit.
  */
 
-export { APPSEARCH_PREFIX, BaseSessionRetriever, BaseStorageProvider, CallResult, ClipboardService, CsvHeaders, DateService, EXT_ALLOW_UTC, EXT_FANCY_ALERTS, EXT_LOCALE, Export, ExportAs, ExportDictionary, ExportList, ExportService, ExtensionsModule, FullExtensionsModule, GenericItem, HashingService, MessageService, StorageService, UtilityService, DefaultSessionRetriever as ɵa, DefaultStorageProvider as ɵb };
+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.js.map