@sankhyalabs/core 0.0.0-bugfix-dev-KB-6165.0

package/dist/utils/NumberUtils.js

@@ -0,0 +1,245 @@
+import { StringUtils } from "./StringUtils.js";
+const NUMBERINPUTS_REGEX_SCIENTIFIC_PARTS = /^([+-])?(\d+).?(\d*)[eE]([-+]?\d+)$/;
+/**
+ * `NumberUtils`: Utilizado para manipulação de numerais.
+ */
+export class NumberUtils {
+    /**
+    * Realiza o arredondamento de casas decimais de um numero.
+    *
+    * @param value - Numeral a ser arredondado.
+    * @param decimals - Quantidade de casas decimais ussada no arredondamento.
+    *
+    * @returns - O próprio numeral arredondado com a quantidade de casas decimais do argumento decimals.
+    *
+    * @example
+    * Informo: (100.12)       |   100.12
+    * Informo: (100,12)       |   NaN
+    
+    * Informo: ("100.12", 1)  |   100.1
+    * Informo: ("100.12", 2)  |   100.12
+    * Informo: ("100.12", 3)  |   100.12
+    
+    * Informo: ("100.15", 1)  |   100.2
+    * Informo: ("100.15", 2)  |   100.15
+    * Informo: ("100.15", 3)  |   100.15
+    
+    * Informo: ("100.16", 1)  |   100.2
+    * Informo: ("100.16", 2)  |   100.16
+    * Informo: ("100.16", 3)  |   100.16
+    */
+    static round(value, decimals = 2) {
+        const multiplier = Math.pow(10, decimals);
+        return Math.round(value * multiplier) / multiplier;
+    }
+    /**
+    * Determina a ordem de umeros.
+    *
+    * @param a - Primeio número para comparação.
+    * @param b - Segundo número para comparação.
+    * @returns - Um numeral negativo se o primeiro argumento é menor que o segundo, zero se os dois são iguais e um numeral positivo quando o primeiro é maior que o segundo.
+    */
+    static compare(a, b) {
+        if (a === undefined) {
+            return b === undefined ? 0 : 1;
+        }
+        else if (b === undefined) {
+            return -1;
+        }
+        if (a === null) {
+            return b === null ? 0 : 1;
+        }
+        else if (b === null) {
+            return -1;
+        }
+        return a > b ? 1 : (a < b ? -1 : 0);
+    }
+}
+/**
+* Converte o dado numérico de string para number.
+*
+* @param value Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico: ######.##).
+* @returns - Numeral passado.
+* @example
+* @"100,12"     |       100.12
+* @"100.12"     |       100.12
+* @"-100,12"    |       -100.12
+* @"R$100,12"   |       100.12
+* @"-R$100,12"  |       -100.12
+* @"string"     |       NaN
+*/
+NumberUtils.stringToNumber = (value) => {
+    if (value === '' || value === null || value === undefined) {
+        return NaN;
+    }
+    if (value) {
+        value = value.toString();
+        const negative = (value.charAt(0) === '-');
+        if (!NUMBERINPUTS_REGEX_SCIENTIFIC_PARTS.test(value)) {
+            value = value.replace(/[^\d.,]/g, '');
+        }
+        else {
+            value = value.replace(/^-/g, '');
+        }
+        //In case of simple string such as: "@@@@@@@"
+        if (value === '') {
+            return Number(NaN);
+        }
+        const indexV = value.indexOf(',');
+        const indexP = value.indexOf('.');
+        if (indexP > indexV) {
+            value = value.replace(',', '');
+        }
+        else if (indexP < indexV) {
+            value = value.replace(/\./g, '@').replace(',', '.').replace(/@/g, '');
+        }
+        if (negative) {
+            value = '-' + value;
+        }
+    }
+    return Number(value);
+};
+/**
+* Formata o numeral com a precisão informada.
+*
+* @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
+* @param precision - Quantidade de casas decimais.
+* @param prettyPrecision - Quantidade de zeros nos decimais.
+* @param defaultValue - Valor padrão caso o value não seja um valor numérico válido.
+*
+* @returns - Numeral em formato de String formatado em PT-BR.
+* @example
+* Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+* Informado: (undefined, 3, 3) | Retorna: NaN
+* Informado: (undefined, 3, 3, '0,00') | Retorna: 0,00
+*/
+NumberUtils.format = (value, precision, prettyPrecision = NaN, defaultValue = NaN.toString()) => {
+    if (value === '' || value === undefined || value === "NaN") {
+        return defaultValue;
+    }
+    const newValue = NumberUtils.stringToNumber(value);
+    if (isNaN(newValue)) {
+        return defaultValue;
+    }
+    //Validation "precision":
+    // Case1: precision < 0 => does not use precision
+    // Case2: presicion not int => does not use precision
+    if (precision < 0 || Math.abs(Math.round(precision * 1) / 1) !== precision) {
+        //Once stringToNumber returns number format, we need to change to pt-br
+        return NumberUtils.changeFormat(newValue.toString());
+    }
+    //Validation "prettyPrecision"
+    let prettyPrecisionInternal = 0;
+    // Case1: prettyPrecision < 0 => prettyPrecision does not change de format that means: prettyPrecisionInternal = precision;
+    // Case2: prettyPrecision not int => prettyPrecision does not change de format that means: prettyPrecisionInternal = precision;
+    if (isNaN(prettyPrecision) || Math.abs(Math.round(prettyPrecision * 1) / 1) !== prettyPrecision) {
+        prettyPrecisionInternal = precision;
+    }
+    else {
+        prettyPrecisionInternal = prettyPrecision;
+    }
+    let newValueStr;
+    newValueStr = (Math.round(newValue * Math.pow(10, precision)) / Math.pow(10, precision)).toLocaleString('pt-br', { minimumFractionDigits: precision });
+    //prettyPrecision
+    const varSettingPP = precision - prettyPrecisionInternal;
+    if (varSettingPP > 0) {
+        for (let i = 0; i < varSettingPP; i++) {
+            if (newValueStr.substring(newValueStr.length - 1) == "0" && precision > 0) {
+                newValueStr = newValueStr.substring(0, newValueStr.length - 1);
+            }
+        }
+    }
+    //in Case "." or "," in the end of the string
+    if (newValueStr.substring(newValueStr.length - 1) == "." || newValueStr.substring(newValueStr.length - 1) == ",") {
+        newValueStr = newValueStr.substring(0, newValueStr.length - 1);
+    }
+    return newValueStr;
+};
+/**
+* Formata o numeral com a precisão informada e o valor default 0,00 caso o value não seja um numero valido.
+*
+* @param value - Numeral em formato de string a ser convertido (Importante: formato PT-BR ou já em formato numérico - sem separador de milhares: ######.##).
+* @param precision - Quantidade de casas decimais.
+* @param prettyPrecision - Quantidade de zeros nos decimais.
+*
+* @returns - Numeral em formato de String formatado em PT-BR.
+* @example
+* Informado: ('10,9845444', 3, 3) | Retorna: '10,985'
+* Informado: (undefined, 3, 3) | Retorna: 0,00
+*/
+NumberUtils.safeFormat = (value, precision, prettyPrecision = NaN) => {
+    return NumberUtils.format(value, precision, prettyPrecision, "0,00");
+};
+/**
+* Retira os separadores de milhar de um numeral em formato de string.
+*
+* @param value - Numeral em formato de string a ser convertido.
+* @param formatnumber - Formatação de ENTRADA e SAÍDA do utilitário: pt-BR="###.###,##" en-US="###,###.##"; Default: "pt-BR".
+*
+* @returns - Numeral em formato de string formatado apenas com separador decimal.
+* @example
+* Informado: '95.12' | Retorna: '9512'
+*/
+NumberUtils.keepOnlyDecimalSeparator = (value, formatnumber = 'pt-BR') => {
+    //Formatting formatnumber to be able to get lowercases
+    formatnumber = formatnumber.toUpperCase();
+    //Formatting value following formatnumber parameter
+    //keep only decimal character in order to correct format the string
+    //This transformation is due the "stringtoNumber" method is a general method that tries to convert all formated strings
+    if (formatnumber === 'EN-US') {
+        value = value.replace(/\,/g, '');
+    }
+    else {
+        value = value.replace(/\./g, '');
+    }
+    return value;
+};
+/**
+* Troca o formato do numeral(string) de "PT-BR" para "EN-US" e vice-versa.
+*
+* @param value - Numeral em formato de string a ser convertido.
+*
+* @returns - Numeral em formato de string formatado de "PT-BR" para "EN-US" e vice-versa.
+* @example
+* Informo: "15,55"     | Obtenho: "15.55"
+* @example
+* Informo: "27.99"     | Obtenho: "27,99"
+*/
+NumberUtils.changeFormat = (value) => {
+    //Formatting output following formatnumber
+    return value.replace(/\./g, '_').replace(/\,/g, '.').replace(/\_/g, ',');
+};
+/**
+* Obtém o valor ou o valor padrão, caso o valor seja inválido(NaN/undefined).
+*
+* @param value - Valor a ser validado.
+* @param defaultValue - Valor padrão a ser retornado caso o value seja inválido.
+*
+* @returns - O próprio numeral passado ou zero.
+*
+* @example
+* Informo: value: 30, defaultValue: 0     | Obtenho: 30
+* @example
+* Informo: value: "30", defaultValue: 0   | Obtenho: 30
+* @example
+* Informo: value: "30abc", defaultValue: 0   | Obtenho: 0
+*/
+NumberUtils.getValueOrDefault = (value, defaultValue) => {
+    value = StringUtils.isEmpty(value) ? undefined : value;
+    value = Number(value);
+    if (isNaN(value)) {
+        return Number(defaultValue);
+    }
+    return value;
+};
+/**
+* Obtém o valor ou zero, caso o valor seja inválido(NaN/undefined).
+*
+* @param value - Numeral a ser validado.
+*
+* @returns - O próprio numeral passado. Caso esse seja inválido retorna zero.
+*/
+NumberUtils.getValueOrZero = (value) => {
+    return NumberUtils.getValueOrDefault(value, 0);
+};
+//# sourceMappingURL=NumberUtils.js.map

package/dist/utils/NumberUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberUtils.js","sourceRoot":"","sources":["../../src/utils/NumberUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/ObjectUtils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `ObjectUtils`: Utilizado para manipulação de objetos.
+ */
+export default class ObjectUtils {
+    /**
+     * Faz a cópia do objeto.
+     *
+     * @param data - Objeto a ser copiado.
+     * @returns - A cópia do objeto válido.
+     */
+    static copy<T>(data: Object | Array<Object>): T;
+    /**
+     * Converte um objeto em string/JSON.
+     *
+     * @param data - Objeto a ser convertido.
+     * @returns - Uma string JSON.
+     *
+     * @example
+     * @Informado: ```{nome : "Sankhya", cidade: "Uberlandia"}``` | Obtenho: ```"{"nome" : "Sankhya", "cidade":"Uberlandia"}"```
+     */
+    static objectToString(data: Object | Array<Object>): string;
+    /**
+     * Converte uma string/JSON em objeto.
+     *
+     * @param data - String a ser convertida.
+     * @returns - Um objeto válido.
+     *
+     * @example
+     * Informado: ```"{"nome" : "Sankhya", "cidade":"Uberlandia"}"``` | Obtenho: ```{nome : "Sankhya", cidade: "Uberlandia"}```
+     */
+    static stringToObject(data: string): Object | Array<Object>;
+    /**
+     * Faz a ordenação de um objeto por uma propriedade.
+     *
+     * @param data - Objeto a ser ordenado.
+     * @param property - Nome da propriedade a ser ordenada.
+     * @returns - O objeto ordenado pela propriedade.
+     */
+    static sortByProperty(data: any, property: string): any;
+    /**
+     * Remove atributos nulos e indefinidos de um objeto.
+     *
+     * @param data - Objeto a ser filtrado.
+     * @returns - O objeto com as propriedades válidas.
+     */
+    static removeEmptyValues(obj: object): object;
+}

package/dist/utils/ObjectUtils.js

@@ -0,0 +1,68 @@
+/**
+ * `ObjectUtils`: Utilizado para manipulação de objetos.
+ */
+export default class ObjectUtils {
+    /**
+     * Faz a cópia do objeto.
+     *
+     * @param data - Objeto a ser copiado.
+     * @returns - A cópia do objeto válido.
+     */
+    static copy(data) {
+        return this.stringToObject(this.objectToString(data));
+    }
+    /**
+     * Converte um objeto em string/JSON.
+     *
+     * @param data - Objeto a ser convertido.
+     * @returns - Uma string JSON.
+     *
+     * @example
+     * @Informado: ```{nome : "Sankhya", cidade: "Uberlandia"}``` | Obtenho: ```"{"nome" : "Sankhya", "cidade":"Uberlandia"}"```
+     */
+    static objectToString(data) {
+        return JSON.stringify(data);
+    }
+    /**
+     * Converte uma string/JSON em objeto.
+     *
+     * @param data - String a ser convertida.
+     * @returns - Um objeto válido.
+     *
+     * @example
+     * Informado: ```"{"nome" : "Sankhya", "cidade":"Uberlandia"}"``` | Obtenho: ```{nome : "Sankhya", cidade: "Uberlandia"}```
+     */
+    static stringToObject(data) {
+        return JSON.parse(data);
+    }
+    /**
+     * Faz a ordenação de um objeto por uma propriedade.
+     *
+     * @param data - Objeto a ser ordenado.
+     * @param property - Nome da propriedade a ser ordenada.
+     * @returns - O objeto ordenado pela propriedade.
+     */
+    static sortByProperty(data, property) {
+        return Object.keys(data)
+            .sort(function (keyA, keyB) {
+            const x = data[keyA][property];
+            const y = data[keyB][property];
+            return x < y ? -1 : x > y ? 1 : 0;
+        }).reduce((obj, key) => {
+            obj[key] = data[key];
+            return obj;
+        }, {});
+    }
+    /**
+     * Remove atributos nulos e indefinidos de um objeto.
+     *
+     * @param data - Objeto a ser filtrado.
+     * @returns - O objeto com as propriedades válidas.
+     */
+    static removeEmptyValues(obj) {
+        return Object.fromEntries(Object.entries(obj)
+            .filter(([, v]) => v != null)
+            .map(([k, v]) => [k, v === Object(v) ? ObjectUtils.removeEmptyValues(v) : v]));
+    }
+}
+//# sourceMappingURL=ObjectUtils.js.map

package/dist/utils/ObjectUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectUtils.js","sourceRoot":"","sources":["../../src/utils/ObjectUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAG5B;;;;;OAKG;IACI,MAAM,CAAC,IAAI,CAAI,IAA2B;QAC7C,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAM,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,cAAc,CAAC,IAA2B;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,cAAc,CAAC,IAAW;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,cAAc,CAAC,IAAS,EAAE,QAAgB;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACrB,IAAI,CAAC,UAAS,IAAY,EAAE,IAAY;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,GAAW,EAAE,EAAE;YAClC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,iBAAiB,CAAC,GAAW;QACzC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChF,CAAC;IAEJ,CAAC;CACJ"}

package/dist/utils/OnboardingUtils.d.ts

@@ -0,0 +1,17 @@
+export declare class OnboardingUtils {
+    private static readonly USER_GUIDE_TAG_ID;
+    private static instance;
+    private constructor();
+    static getInstance(): OnboardingUtils;
+    init(apiKey: string, ctx: EnvironmentContext): Promise<void>;
+    private injectScript;
+    private register;
+}
+export declare class EnvironmentContext {
+    userID: string;
+    userName: string;
+    partnerName: string;
+    sysVersion: string;
+    environment: string;
+    clientGaId: string;
+}

package/dist/utils/OnboardingUtils.js

@@ -0,0 +1,41 @@
+export class OnboardingUtils {
+    constructor() { }
+    static getInstance() {
+        if (this.instance == null) {
+            this.instance = new OnboardingUtils();
+        }
+        return this.instance;
+    }
+    init(apiKey, ctx) {
+        if (!apiKey) {
+            return Promise.resolve();
+        }
+        this.injectScript(apiKey);
+        this.register(ctx);
+        return Promise.resolve();
+    }
+    injectScript(apiKey) {
+        if (window.document.head.querySelector(`script#${OnboardingUtils.USER_GUIDE_TAG_ID}`)) {
+            return;
+        }
+        const scriptEl = document.createElement('script');
+        scriptEl.setAttribute("id", OnboardingUtils.USER_GUIDE_TAG_ID);
+        scriptEl.innerText = `(function(g,u,i,d,e,s){g[e]=g[e]||[];var f=u.getElementsByTagName(i)[0];var k=u.createElement(i);k.async=true;k.src='https://static.userguiding.com/media/user-guiding-'+s+'-embedded.js';f.parentNode.insertBefore(k,f);if(g[d])return;var ug=g[d]={q:[]};ug.c=function(n){return function(){ug.q.push([n,arguments])};};var m=['previewGuide','finishPreview','track','identify','hideChecklist','launchChecklist'];for(var j=0;j<m.length;j+=1){ug[m[j]]=ug.c(m[j]);}})(window,document,'script','userGuiding','userGuidingLayer','${apiKey}');`;
+        window.document.head.appendChild(scriptEl);
+    }
+    register(ctx) {
+        window.userGuiding.identify(`${ctx.userID}-${ctx.userName}-${ctx.clientGaId}`, ctx);
+    }
+}
+OnboardingUtils.USER_GUIDE_TAG_ID = "userGuideSnippet";
+export class EnvironmentContext {
+    constructor() {
+        this.userID = "";
+        this.userName = "";
+        this.partnerName = "";
+        this.sysVersion = "";
+        this.environment = "";
+        this.clientGaId = "";
+    }
+}
+//# sourceMappingURL=OnboardingUtils.js.map

package/dist/utils/OnboardingUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnboardingUtils.js","sourceRoot":"","sources":["../../src/utils/OnboardingUtils.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IAIxB,gBAAsB,CAAC;IAEhB,MAAM,CAAC,WAAW;QACrB,IAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAC;YACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;SACzC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,IAAI,CAAC,MAAc,EAAE,GAAuB;QAC/C,IAAG,CAAC,MAAM,EAAC;YACP,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;SAC5B;QACD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAEO,YAAY,CAAC,MAAc;QAC/B,IAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,eAAe,CAAC,iBAAiB,EAAE,CAAC,EAAC;YACjF,OAAO;SACV;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAClD,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC/D,QAAQ,CAAC,SAAS,GAAG,ygBAAygB,MAAM,KAAK,CAAC;QAC1iB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,QAAQ,CAAC,GAAuB;QACnC,MAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;IACjG,CAAC;;AAlCuB,iCAAiB,GAAG,kBAAkB,CAAC;AAqCnE,MAAM,OAAO,kBAAkB;IAA/B;QACK,WAAM,GAAW,EAAE,CAAC;QACpB,aAAQ,GAAW,EAAE,CAAC;QACtB,gBAAW,GAAW,EAAE,CAAC;QACzB,eAAU,GAAW,EAAE,CAAC;QACxB,gBAAW,GAAW,EAAE,CAAC;QACzB,eAAU,GAAW,EAAE,CAAC;IAC7B,CAAC;CAAA"}

package/dist/utils/ReadyUtil.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `ReadyUtil`: Registra processos que serão invocados após a conclusão de operações.
+ */
+export default class ReadyUtil {
+    private resolve;
+    private promise;
+    /**
+     * Limpa o estado da instancia ao finalizar a execução do processo registrado.
+     */
+    private clean;
+    /**
+     * Inicializa o estado da instancia ao registrar processo.
+     */
+    private start;
+    /**
+     * Executa processo atribuído.
+     */
+    end(): void;
+    /**
+     *  Atribui processo que será executado por operações que o invocarem no método 'end'.
+     * @returns Promise que deve conter o código do processo.
+     */
+    whenReady(): Promise<unknown>;
+}

package/dist/utils/ReadyUtil.js

@@ -0,0 +1,41 @@
+/**
+ * `ReadyUtil`: Registra processos que serão invocados após a conclusão de operações.
+ */
+export default class ReadyUtil {
+    /**
+     * Limpa o estado da instancia ao finalizar a execução do processo registrado.
+     */
+    clean() {
+        this.resolve = undefined;
+        this.promise = undefined;
+    }
+    /**
+     * Inicializa o estado da instancia ao registrar processo.
+     */
+    start() {
+        if (!this.promise)
+            this.promise = new Promise((accept) => {
+                this.resolve = () => accept(true);
+            });
+    }
+    /**
+     * Executa processo atribuído.
+     */
+    end() {
+        this.resolve && this.resolve();
+    }
+    /**
+     *  Atribui processo que será executado por operações que o invocarem no método 'end'.
+     * @returns Promise que deve conter o código do processo.
+     */
+    whenReady() {
+        this.start();
+        return new Promise((accept) => {
+            this.promise.then(() => {
+                accept(true);
+                this.clean();
+            });
+        });
+    }
+}
+//# sourceMappingURL=ReadyUtil.js.map

package/dist/utils/ReadyUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadyUtil.js","sourceRoot":"","sources":["../../src/utils/ReadyUtil.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAI1B;;OAEG;IACK,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,KAAK;QACT,IAAG,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBACpD,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC,CAAC,CAAA;IACN,CAAC;IAED;;OAEG;IACH,GAAG;QACC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,SAAS;QACL,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;gBACnB,MAAM,CAAC,IAAI,CAAC,CAAC;gBACb,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}