@esfaenza/extensions 20.3.2 → 20.3.3

package/lib/services/extensions.hashing.service.d.ts

@@ -0,0 +1,121 @@
+import * as i0 from "@angular/core";
+/**
+ * Service che fornisce alcuni semplici funzioni di Hashing / GUID / ecc...
+ */
+export declare class HashingService {
+    /**
+     * Generazione di un GUID pseudo-univoco
+     *
+     * @returns {string} il GUID generato
+     */
+    getGUID(): string;
+    /**
+     * Calcolo dell'hash su un oggetto
+     *
+     * @param {any} o Oggetto di cui calcolare l'hash
+     * @param {number} level Livello di ricorsione nel caso venga effettuato l'hash di un oggetto che contiene altri oggetti
+     * @param {boolean} navigateFullDepth Indica se navigare l'oggetto per l'intera lunghezza. In caso contrario si ferma al secondo livello
+     *
+     * @returns {string} Hash generato per l'oggetto in questione
+     */
+    hashObject(o: any, level?: number, navigateFullDepth?: boolean, precise?: boolean): string;
+    /**
+     * Hash più semplice e più veloce dell'md5, ma meno sicuro
+     *
+     * Vedi https://stackoverflow.com/questions/7616461/generate-a-hash-from-string-in-javascript
+     *
+     * @param {string} str Stringa di cui calcolare l'hash
+     */
+    private simpleHash;
+    /**
+     * Blacklist dei tipi da ignorare quando si effettua l'hashing degli oggetti
+     */
+    private objBlacklist;
+    /**
+     * Genera una stringa che identifica univocamente l'oggetto in questione
+     *
+     * @param {any} o Oggetto di cui calcolare la stringa univoca
+     * @param {number} level Livello di ricorsione nel caso venga effettuato l'hash di un oggetto che contiene altri oggetti
+     * @param {boolean} navigateFullDepth Indica se navigare l'oggetto per l'intera lunghezza. In caso contrario si ferma al secondo livello
+     */
+    private stringify;
+    /**
+     * Data una stringa restituisce l'md5
+     *
+     * @param {string} s Stringa di cui calcolare l'md5
+     * @returns {string} md5 della stringa **s**
+     */
+    md5(s: string): string;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private md5cycle;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private cmn;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private ff;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private gg;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private hh;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private ii;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private md51;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private md5blk;
+    /**
+     * Array dei possibili valori di un simbolo esadecimale
+     */
+    private hex_chr;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private rhex;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private hex;
+    /**
+     * @ignore
+     *
+     * Metodo di utilità per il calcolo dell'md5
+     */
+    private add32;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HashingService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<HashingService>;
+}

package/lib/services/extensions.intercom.service.d.ts

@@ -0,0 +1,28 @@
+import { Subject } from "rxjs";
+import { InterComMessage } from "../models/InterComMessage";
+import * as i0 from "@angular/core";
+/** Service che si occupa di gestire la comunicazione fra i moduli interni ed esterni dell'applicativo */
+export declare class InterComService {
+    /** Messaggi in uscita, uno per ogni recipient registratosi dall'entrypoint **register** */
+    outbounds: {
+        [id: string]: Subject<InterComMessage>;
+    };
+    /** Messaggi in entrata, unico per applicazione principale */
+    inbounds: Subject<InterComMessage>;
+    /**
+     * 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: any, message: any, recipient?: string): void;
+    /**
+     * 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: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InterComService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InterComService>;
+}

package/lib/services/extensions.messages.service.d.ts

@@ -0,0 +1,197 @@
+import { Injector } from "@angular/core";
+import { BaseLocalization } from "@esfaenza/localizations";
+import { Observable, Subject } from "rxjs";
+import { CallResult } from "../models/CallResult";
+import { HashingService } from "./extensions.hashing.service";
+import * as i0 from "@angular/core";
+/**
+ * Service che fornisce funzionalità di alert nei tipi fondamentali: success, info, warning e danger
+ */
+export declare class MessageService {
+    private injector;
+    private locProvider;
+    private hash;
+    /** Oggetto statico in supporto alla localizzazione */
+    private loc;
+    /** Template di un warning con richiesta di conferma */
+    private warningSwalWithCancel;
+    /** Template di un warning con richiesta di conferma */
+    private successSwalWithCancel;
+    /** Template di un errore */
+    private errorSwal;
+    /** Template di un messaggio di successo */
+    private successSwal;
+    /** Template di un avviso */
+    private warningSwal;
+    /** Template di un messaggio informativo */
+    private infoSwal;
+    /** Template di un warning per la sessione scaduta */
+    private expiredSessionSwal;
+    /** Getter per il servizio dei toast. ngx-toastr è fatta talmente male che la service dev'essere recuperata in questo modo */
+    private get toastr();
+    /** Supporto all'Embedding */
+    Embedded: boolean;
+    MainWindow: Window;
+    MessageObserver: Subject<{
+        event: any;
+        data: any;
+    }>;
+    isBrowser: boolean;
+    /** Costruttore  @ignore */
+    constructor(injector: Injector, locProvider: BaseLocalization, hash: HashingService, platformId: Object);
+    browserCheck(): boolean;
+    configureEmbeddability(mainWindow: Window, messageObserver: Subject<{
+        event: any;
+        data: any;
+    }>): void;
+    init(): Promise<void>;
+    /**
+     * Presentazione di un semplice messaggio di successo
+     *
+     * Se viene chiamato con le impostazioni di default e toastr è abilitato, viene mostrato al centro
+     * Se viene chiamato con override su toastr vuol dire che è una notifica secondaria e appare in alto a destra
+     *
+     * @param {string} text Testo da mostrare
+     * @param {"toastr" | "swal" | null} secondaryNotificationType Qualora sia una notifica secondaria, ne indica il tipo
+     */
+    simpleSuccess(text: string, secondaryNotificationType?: "toastr" | "swal" | null, secondaryNotificationTimeout?: number): void;
+    /**
+     * Presentazione di un semplice messaggio di informazione
+     *
+     * Se viene chiamato con le impostazioni di default e toastr è abilitato, viene mostrato al centro
+     * Se viene chiamato con override su toastr vuol dire che è una notifica secondaria e appare in alto a destra
+     *
+     * @param {string} text Testo da mostrare
+     * @param {"toastr" | "swal" | null} secondaryNotificationType Qualora sia una notifica secondaria, ne indica il tipo
+     */
+    simpleInfo(text: string, secondaryNotificationType?: "toastr" | "swal" | null, secondaryNotificationTimeout?: number): void;
+    /**
+     * Presentazione di un semplice messaggio di errore
+     *
+     * Se viene chiamato con le impostazioni di default e toastr è abilitato, viene mostrato al centro
+     * Se viene chiamato con override su toastr vuol dire che è una notifica secondaria e appare in alto a destra
+     *
+     * @param {string} text Testo da mostrare
+     * @param {"toastr" | "swal" | null} secondaryNotificationType Qualora sia una notifica secondaria, ne indica il tipo
+     */
+    simpleError(text: string, secondaryNotificationType?: "toastr" | "swal" | null, secondaryNotificationTimeout?: number): void;
+    /**
+     * Presentazione di un semplice messaggio di avviso
+     *
+     * Se viene chiamato con le impostazioni di default e toastr è abilitato, viene mostrato al centro
+     * Se viene chiamato con override su toastr vuol dire che è una notifica secondaria e appare in alto a destra
+     *
+     * @param {string} text Testo da mostrare
+     * @param {"toastr" | "swal" | null} secondaryNotificationType Qualora sia una notifica secondaria, ne indica il tipo
+     */
+    simpleWarning(text: string, secondaryNotificationType?: "toastr" | "swal" | null, secondaryNotificationTimeout?: number): void;
+    /**
+     * Ripulisce tutti i messaggi presenti in un dato momento sullo schermo
+     */
+    clearMessages(): void;
+    /**
+     * Mostra un messaggio di avviso con richiesta di conferma
+     *
+     * @param {string} title Titolo del messaggio
+     * @param {string} text Contenuto del messaggio
+     *
+     * @returns {Promise} Restituisce una Promise col risultato scelto dall'utente (conferma o no)
+     */
+    promiseWarningWithChoice(title: string, text: string): Promise<any>;
+    /**
+     * In base alla configurazione attuale e all'eventuale override per la chiamata del caso indica se bisogna utilizzare toastr o sweetalert
+     *
+     * @param {"toastr" | "swal" | null} providerOverride Override alla modalità configurata
+     *
+     * @returns {"toastr" | "swal"} Indicazione su che provider di messaggi di avviso debba essere utilizzato
+     */
+    private toastrOrSwal;
+    private GuidRepsonseFunctionsMap;
+    simpleWarningWithChoice(title: string, text: string, onsuccess?: Function, onerror?: Function, confirmtext?: string, aborttext?: string): void;
+    simpleSuccessWithChoice(title: string, text: string, onsuccess?: Function, onerror?: Function, confirmtext?: string, aborttext?: string): void;
+    private withChoiceBase;
+    /**
+     * Mostra un messaggio di avviso con richiesta di conferma e gestisce il risultato chiamato i callback **onsuccess** o **onerror**
+     *
+     * @param {string} title Titolo del messaggio
+     * @param {string} text Contenuto del messaggio
+     * @param {Function} onsuccess Callback da chimare su conferma
+     * @param {Function} onerror Callback da chimare su errori
+     */
+    private _simpleWarningWithChoice;
+    /**
+     * Mostra un messaggio di success con richiesta di conferma e gestisce il risultato chiamato i callback **onconfirm** o **onabort**
+     *
+     * @param {string} title Titolo del messaggio
+     * @param {string} text Contenuto del messaggio
+     * @param {Function} onconfirm Callback da chimare su conferma
+     * @param {Function} onabort Callback da chimare su annullamento
+     * @param {string} confirmtext Testo del pulsante di azione
+     * @param {string} aborttext Testo del pulsante di annullamento
+     */
+    private _simpleSuccessWithChoice;
+    /**
+     * Metodo base per richiedere una scelta all'utente
+     *
+     * @param {any} swal Swal mixin da utilizzare per visualizzare il messaggio di choice
+     * @param {string} title Titolo del messaggio
+     * @param {string} text Contenuto del messaggio
+     * @param {Function} onconfirm Callback da chimare su conferma
+     * @param {Function} onabort Callback da chimare su annullamento
+     * @param {string} confirmtext Testo del pulsante di azione
+     * @param {string} aborttext Testo del pulsante di annullamento
+     */
+    private _simpleWithChoice;
+    /**
+     * Mostra un messaggio di avviso con richiesta di conferma e gestisce il risultato chiamato i callback **onsuccess** o **onerror**
+     *
+     * @param {string} title Titolo del messaggio
+     * @param {string} text Contenuto del messaggio
+     */
+    observableSimpleWarningWithChoice(title: string, text: string): Observable<boolean>;
+    /**
+     * Mostra un messaggio di avviso che la sessione corrente è scaduta e propone all'utente di navigare al login. Qualora l'utente decidesse di farlo
+     * verrà chiamata la funzione di callback **onnavigate
+     *
+     * @param {string} title Titolo del messaggio
+     * @param {string} text Contenuto del messaggio
+     * @param {Function} onnavigate Callback da chimare su navigazione in corso
+     */
+    expiredSessionMessage(title: string, text: string, onnavigate?: Function): void;
+    /**
+     * Metodo helper per gestire in maniera standardizzata una risposta di tipo **CallResult**
+     *
+     * @param {CallResult} response Risposta ricevuta dal server
+     * @param {string} successMsg Messaggio da visualizzare in caso di successo
+     * @param {string} errorMsg Messaggio da visualizzare in caso di fallimento
+     * @param {Function} postSuccess Callback da chimare in caso di successo
+     * @param {Function} postFailure Callback da chimare in caso di fallimento
+     */
+    manageCallResultResponse(response: CallResult, successMsg: string, errorMsg: string, postSuccess?: Function, postFailure?: Function): void;
+    /**
+     * Metodo helper per gestire in maniera standardizzata una risposta di tipo **string**, considerando che:
+     *
+     * Stringa vuota --> Tutto bene
+     *
+     * Stringa piena --> Questo è il messaggio d'errore per cui la chiamata è fallita
+     *
+     * @param {string} response Risposta ricevuta dal server
+     * @param {string} successMsg Messaggio da visualizzare in caso di successo
+     * @param {string} errorMsg Messaggio da visualizzare in caso di fallimento
+     * @param {Function} postSuccess Callback da chimare in caso di successo
+     * @param {Function} postFailure Callback da chimare in caso di fallimento
+     */
+    manageStringResponse(response: string, successMsg: string, errorMsg: string, postSuccess?: Function, postFailure?: Function): void;
+    /**
+     * Metodo helper per gestire in maniera standardizzata una risposta di tipo **boolean**
+     *
+     * @param {string} response Risposta ricevuta dal server
+     * @param {string} successMsg Messaggio da visualizzare in caso di successo
+     * @param {string} errorMsg Messaggio da visualizzare in caso di fallimento
+     * @param {Function} postSuccess Callback da chimare in caso di successo
+     * @param {Function} postFailure Callback da chimare in caso di fallimento
+     */
+    manageStringResponseBool(response: boolean, successMsg: string, errorMsg: string, postSuccess?: Function, postFailure?: Function): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MessageService, [null, { optional: true; }, null, null]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MessageService>;
+}

package/lib/services/extensions.utilities.service.d.ts

@@ -0,0 +1,107 @@
+import { Type } from "@angular/core";
+import { NgForm } from "@angular/forms";
+import { TypeCode } from '../models/TypeCode';
+import * as i0 from "@angular/core";
+/**
+ * Service che fornisce metodi di pubblica utilità
+ */
+export declare class UtilityService {
+    /**
+     * Deseleziona il testo eventualmente selezionato
+     */
+    clearTextSelection(): void;
+    /**
+     * Partendo da una lista, dato il nome della proprietà chiave e il valore della chiave selezionata,
+     * trova e restituisce l'oggetto desiderato
+     *
+     * @param {T[]} sourceList Lista di oggetti dentro cui cercare
+     * @param {string} sourceItemIdField Nome della proprietà che rappresenta la chiave di un oggetto di tipo T
+     * @param {string} selectedValue Valore di chiave selezionato
+     *
+     * @returns {T} Oggetto la cui proprietà **sourceItemIdField** assume il valore **selectedValue**
+     */
+    getSelectedItem<T>(sourceList: T[], sourceItemIdField: string, selectedValue: string): T;
+    /**
+     * Effettua il reset di un Form di Angular
+     *
+     * @param {NgForm} form Form da resettare
+     * @param {string} exception1 Campo da non resettare
+     * @param {string} exception2 Campo da non resettare
+     */
+    cleanForm(form: NgForm, exception1?: string, exception2?: string): void;
+    /**
+     * Helper che permette di scaricare un file dato un URL (Generato da una chiamata ad **window.URL.createObjectURL**)
+     *
+     * @param {string} url ObjectURL che rappresenta il file da scaricare
+     * @param {string} filename Nome del file suggerito in fase di salvataggio
+     */
+    fileDownload(url: string, fileName: string): void;
+    /**
+     * Helper per la formattazione di un numero di millisecondi in una stringa più comprensibile per un umano
+     *
+     * @param {number} duration Tempo espresso in millisecondi
+     *
+     * @returns {string} Durata formattata
+     */
+    msToTime(duration: number): string;
+    /**
+     * Helper che permette di scaricare un file in Base64
+     *
+     * @param {string} base64Data Base64 che rappresenta il file da scaricare
+     * @param {string} filename Nome del file suggerito in fase di salvataggio
+     */
+    saveFile(base64Data: string, filename: string): void;
+    /**
+     * Trasforma un Base64 in un ArrayBuffer
+     *
+     * @param {string} base64Data Base64 da trasformare
+     *
+     * @returns {Uint8Array} Array UTF8
+     */
+    private base64ToArrayBuffer;
+    /**
+     * Helper che permette di scaricare un file dato un array di Byte (**Uint8Array**)
+     *
+     * @param {Uint8Array} byte Rappresentazione del file da scaricare
+     * @param {string} filename Nome del file suggerito in fase di salvataggio
+     */
+    private saveByteArray;
+    /**
+     * Utility per lo swap di due elementi di un array
+     *
+     * @param {any[]} array Array di cui invertire due elementi
+     * @param {number} x Indice del primo elemento
+     * @param {number} y Indice del secondo elemento
+     */
+    swap(array: any[], x: number, y: number): void;
+    /**
+     * Helper di trascodifica da tipo c# a tipo Typescript
+     *
+     * @param {TypeCode} type Tipo da trascodificare
+     *
+     * @returns {"boolean" | "number" | "string" | "date"} Tipo Typescript corrispondente
+     */
+    getJsTypeFromTypeCode(type: TypeCode): "boolean" | "number" | "string" | "date";
+    /**
+     * Effettua la clonazione profonda di un oggetto in maniera molto più performante che JSON.parse(JSON.stringify()).
+     *
+     * Usare solo per oggetti puri e quantomeno semplici per evitare complicazioni derivanti dalle semplificazioni che questo metodo assume
+     *
+     * @param {any} source Oggetto da clonare
+     *
+     * @return {any} Clone dell'oggetto passato
+     */
+    deepClone(source: any, type?: Type<any>): any;
+    /**
+     * @ignore
+     * Step ricorsivo per la clonatura degli oggetti. Vedere **deepClone**
+     */
+    private recursiveStep;
+    cast(object: any, clss: Type<any>): any;
+    /** @ignore */
+    private executionTimers;
+    /** @ignore */
+    throttla(id: string, func: Function, throttleTime: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<UtilityService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<UtilityService>;
+}

package/lib/tokens.d.ts

@@ -0,0 +1,11 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * Token che indica il prefisso delle searchView che serve per storicizzarle evitando di tirarsi in memoria anche tutti gli oggetti. Se vuoto viene supposto 'Hot'
+ */
+export declare const APPSEARCH_PREFIX: InjectionToken<string>;
+/**
+ * Token che indica se i metodi di estensione che utilizzano le date permettono l'uso di date in utc
+ */
+export declare const EXT_ALLOW_UTC: InjectionToken<boolean>;
+/** Modalità di Debug */
+export declare const EXT_DEBUG_MODE: InjectionToken<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/extensions",
-  "version": "20.3.2",
+  "version": "20.3.3",
   "dependencies": {
     "tslib": "^2.0.0"
   },

package/public-api.d.ts

@@ -0,0 +1,18 @@
+export * from './lib/modules/extensions.module';
+export * from './lib/services/extensions.base';
+export * from './lib/services/extensions.dates.service';
+export * from './lib/services/extensions.exports.service';
+export * from './lib/services/extensions.clipboard.service';
+export * from './lib/services/extensions.hashing.service';
+export * from './lib/services/extensions.messages.service';
+export * from './lib/services/extensions.utilities.service';
+export * from './lib/services/extensions.embedding.service';
+export * from './lib/tokens';
+export * from './lib/models/CallResult';
+export * from './lib/models/CsvHeaders';
+export * from './lib/models/GenericItem';
+export * from './lib/pipes/loc_date.pipe';
+/** Intercom */
+export * from './lib/models/InboundMessageTypes';
+export * from './lib/models/InterComMessage';
+export * from './lib/services/extensions.intercom.service';