validation-br 1.6.0 → 1.6.1

package/dist/renavam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renavam.js","sourceRoot":"","sources":["../../src/renavam.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;;;;AAEH,wFAAgE;AAChE,mCAAsF;AAEtF;;;;;;GAMG;AACI,MAAM,EAAE,GAAG,CAAC,KAAsB,EAAU,EAAE;IACnD,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,KAAK,EAAE,EAAE,EAAE;QACpC,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAA,gCAAwB,EAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACpF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;IAE5C,OAAO,GAAG,GAAG,EAAE,CAAC;AAClB,CAAC,CAAC;AAXW,QAAA,EAAE,MAWb;AAEF;;;;;GAKG;AACI,MAAM,IAAI,GAAG,CAAC,KAAsB,EAAU,EAAE,CAAC,IAAA,iBAAS,EAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAA5E,QAAA,IAAI,QAAwE;AAEzF;;;;;GAKG;AACI,MAAM,IAAI,GAAG,CAAC,WAAoB,KAAK,EAAU,EAAE;IACxD,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,GAAG,KAAK,GAAG,IAAA,UAAE,EAAC,KAAK,CAAC,EAAE,CAAC;IAEvC,IAAI,QAAQ;QAAE,OAAO,IAAA,YAAI,EAAC,OAAO,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AARW,QAAA,IAAI,QAQf;AAEF;;;;;;;GAOG;AACI,MAAM,cAAc,GAAG,CAAC,KAAsB,EAAW,EAAE;IAChE,MAAM,OAAO,GAAG,IAAA,iBAAS,EAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,IAAA,UAAE,EAAC,OAAO,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,2BAAiB,CAAC,UAAU,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AARW,QAAA,cAAc,kBAQzB;AAEF;;;;;;GAMG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAW,EAAE;IAC1D,IAAI,CAAC;QACH,OAAO,IAAA,sBAAc,EAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AANW,QAAA,QAAQ,YAMnB;AAEF;;;;;GAKG;AACI,MAAM,SAAS,GAAG,CAAC,KAAsB,EAAU,EAAE;IAC1D,OAAO,IAAA,kBAAU,EAAC,KAAK,EAAE,EAAE,EAAE;QAC3B,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,kBAAkB,EAAE,IAAI;QACxB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;AACL,CAAC,CAAC;AAPW,QAAA,SAAS,aAOpB;AAEF,kBAAe,gBAAQ,CAAC"}

package/dist/tituloEleitor.d.ts

@@ -0,0 +1,100 @@
+/**
+ * isTitulo()
+ * Calcula se um título eleitoral é válido
+ *
+ * @doc
+ * Título de eleitor deve possuir 12 dígitos.
+ *
+ * - Os caracteres 1 a 8 são números sequenciais.
+ *
+ * - Os caracteres 9 e 10 representam os estados da federação onde o título
+ *   foi emitido (01 = SP, 02 = MG, 03 = RJ, 04 = RS, 05 = BA, 06 = PR, 07 = CE, 08 = PE,
+ *   09 = SC, 10 = GO,  11 = MA12 = PB, 13 = PA, 14 = ES, 15 = PI, 16 = RN, 17 = AL,
+ *   18 = MT, 19 = MS, 20 = DF, 21 = SE, 22 = AM, 23 = RO, 24 = AC, 25 = AP, 26 = RR,
+ *   27 = TO, 28 = Exterior(ZZ).
+ *
+ * - Os caracteres 11 e 12 são dígitos verificadores.
+ *
+ * 1) Partes do número
+ * ------------------------------------------------
+ * |       Número Sequencial      |  UF   |   DV  |
+ *  1   0   2   3   8   5   0   1   0   6   7   1
+ *
+ * 2) Cálculo do primeiro DV.
+ *
+ *  - Soma-se o produto das algarismos 1 a 8 pelos números 2, 3, 4, 5, 6, 7, 8 e 9.
+ *
+ *   1   0   2   3   8   5   0   1
+ *   x   x   x   x   x   x   x   x
+ *   2   3   4   5   6   7   8   9
+ * = 2 + 0 + 8 +15 +48 +35 + 0 + 9  = 117
+ *
+ *  - O somatório encontrado é dividido por 11. O DV1 é o resto da divisão. Se o
+ *    resto for 10, o DV1 é 0.
+ *
+ * 2.1) 117 / 11 tem resto igual a 7.
+ *
+ * 3) Cálculo do segundo DV
+ *
+ * - Soma-se o produto dos algarismos 9 a 11 (relativos aos 2 dígitos da UF e o novo
+ *   DV1 que acabou de ser calculado) e os multiplicam pelos números 7, 8 e 9. Se o
+ *   resto for 10, DV2 será 0.
+ *   0   6   7
+ *   x   x   x
+ *   7   8   9
+ * = 0 +48 +63 = 111
+ *
+ * 3.1) 111 / 11 tem resto igual a 1.
+ *
+ * Fonte: http://clubes.obmep.org.br/blog/a-matematica-nos-documentos-titulo-de-eleitor/
+ *
+ * @param {String} value Título eleitoral
+ * @returns {Boolean}
+ */
+/**
+ * dv()
+ * Calcula o dígito verificador
+ *
+ * @param {Number|String} value
+ * @returns {String}
+ */
+export declare const dv: (value: string | number) => string;
+/**
+ * Aplica uma máscara ao número informado
+ *
+ * @param {String} value Número de Processo
+ * @returns {String} Valor com a máscara
+ */
+export declare const mask: (value: string | number) => string;
+/**
+ * fake()
+ * Gera um número válido
+ *
+ * @returns {String}
+ */
+export declare const fake: (withMask?: boolean) => string;
+/**
+ * validateOrFail()
+ * Valida se um número é válido e
+ * retorna uma exceção se não estiver
+ *
+ * @param {String|Number} value Número a ser validado
+ * @returns {Boolean}
+ */
+export declare const validateOrFail: (value: string | number) => boolean;
+/**
+ * validate()
+ * Valida se um número é válido
+ *
+ * @param {String|Number} value Número a ser validado
+ * @returns {Boolean}
+ */
+export declare const validate: (value: string | number) => boolean;
+/**
+ * Retorna String sem máscara
+ *
+ * @param {String|Number} value Valor a remover máscara
+ * @returns {String}
+ */
+export declare const normalize: (value: string | number) => string;
+export default validate;

package/dist/tituloEleitor.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * isTitulo()
+ * Calcula se um título eleitoral é válido
+ *
+ * @doc
+ * Título de eleitor deve possuir 12 dígitos.
+ *
+ * - Os caracteres 1 a 8 são números sequenciais.
+ *
+ * - Os caracteres 9 e 10 representam os estados da federação onde o título
+ *   foi emitido (01 = SP, 02 = MG, 03 = RJ, 04 = RS, 05 = BA, 06 = PR, 07 = CE, 08 = PE,
+ *   09 = SC, 10 = GO,  11 = MA12 = PB, 13 = PA, 14 = ES, 15 = PI, 16 = RN, 17 = AL,
+ *   18 = MT, 19 = MS, 20 = DF, 21 = SE, 22 = AM, 23 = RO, 24 = AC, 25 = AP, 26 = RR,
+ *   27 = TO, 28 = Exterior(ZZ).
+ *
+ * - Os caracteres 11 e 12 são dígitos verificadores.
+ *
+ * 1) Partes do número
+ * ------------------------------------------------
+ * |       Número Sequencial      |  UF   |   DV  |
+ *  1   0   2   3   8   5   0   1   0   6   7   1
+ *
+ * 2) Cálculo do primeiro DV.
+ *
+ *  - Soma-se o produto das algarismos 1 a 8 pelos números 2, 3, 4, 5, 6, 7, 8 e 9.
+ *
+ *   1   0   2   3   8   5   0   1
+ *   x   x   x   x   x   x   x   x
+ *   2   3   4   5   6   7   8   9
+ * = 2 + 0 + 8 +15 +48 +35 + 0 + 9  = 117
+ *
+ *  - O somatório encontrado é dividido por 11. O DV1 é o resto da divisão. Se o
+ *    resto for 10, o DV1 é 0.
+ *
+ * 2.1) 117 / 11 tem resto igual a 7.
+ *
+ * 3) Cálculo do segundo DV
+ *
+ * - Soma-se o produto dos algarismos 9 a 11 (relativos aos 2 dígitos da UF e o novo
+ *   DV1 que acabou de ser calculado) e os multiplicam pelos números 7, 8 e 9. Se o
+ *   resto for 10, DV2 será 0.
+ *   0   6   7
+ *   x   x   x
+ *   7   8   9
+ * = 0 +48 +63 = 111
+ *
+ * 3.1) 111 / 11 tem resto igual a 1.
+ *
+ * Fonte: http://clubes.obmep.org.br/blog/a-matematica-nos-documentos-titulo-de-eleitor/
+ *
+ * @param {String} value Título eleitoral
+ * @returns {Boolean}
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalize = exports.validate = exports.validateOrFail = exports.fake = exports.mask = exports.dv = void 0;
+const ValidationBRError_1 = __importDefault(require("./_exceptions/ValidationBRError"));
+const utils_1 = require("./utils");
+/**
+ * dv()
+ * Calcula o dígito verificador
+ *
+ * @param {Number|String} value
+ * @returns {String}
+ */
+const dv = (value) => {
+    const titulo = (0, utils_1.clearValue)(value, 10, {
+        fillZerosAtLeft: true,
+        trimAtRight: true,
+        rejectEmpty: true,
+    });
+    const uf = titulo.substring(8, 10);
+    if (uf > '28') {
+        throw new ValidationBRError_1.default(`A UF ${uf} é inválida`);
+    }
+    const sum1 = (0, utils_1.sumElementsByMultipliers)(titulo.substring(0, 8), [2, 3, 4, 5, 6, 7, 8, 9]);
+    const dv1 = sum1 % 11 >= 10 ? 0 : sum1 % 11;
+    const sum2 = (0, utils_1.sumElementsByMultipliers)(titulo.substring(8, 10) + dv1, [7, 8, 9]);
+    const dv2 = sum2 % 11 >= 10 ? 0 : sum2 % 11;
+    return `${dv1}${dv2}`;
+};
+exports.dv = dv;
+/**
+ * Aplica uma máscara ao número informado
+ *
+ * @param {String} value Número de Processo
+ * @returns {String} Valor com a máscara
+ */
+const mask = (value) => (0, utils_1.applyMask)(value, '0000.0000.0000');
+exports.mask = mask;
+/**
+ * fake()
+ * Gera um número válido
+ *
+ * @returns {String}
+ */
+const fake = (withMask = false) => {
+    const num = (0, utils_1.fakeNumber)(8, true);
+    const uf = (Math.random() * 27 + 1).toFixed(0).padStart(2, '0');
+    const titulo = `${num}${uf}${(0, exports.dv)(num + uf)}`;
+    if (withMask)
+        return (0, exports.mask)(titulo);
+    return titulo;
+};
+exports.fake = fake;
+/**
+ * validateOrFail()
+ * Valida se um número é válido e
+ * retorna uma exceção se não estiver
+ *
+ * @param {String|Number} value Número a ser validado
+ * @returns {Boolean}
+ */
+const validateOrFail = (value) => {
+    const titulo = (0, exports.normalize)(value);
+    if ((0, exports.dv)(titulo) !== titulo.substring(10, 12)) {
+        throw ValidationBRError_1.default.INVALID_DV;
+    }
+    return true;
+};
+exports.validateOrFail = validateOrFail;
+/**
+ * validate()
+ * Valida se um número é válido
+ *
+ * @param {String|Number} value Número a ser validado
+ * @returns {Boolean}
+ */
+const validate = (value) => {
+    try {
+        return (0, exports.validateOrFail)(value);
+    }
+    catch (error) {
+        return false;
+    }
+};
+exports.validate = validate;
+/**
+ * Retorna String sem máscara
+ *
+ * @param {String|Number} value Valor a remover máscara
+ * @returns {String}
+ */
+const normalize = (value) => {
+    return (0, utils_1.clearValue)(value, 12, {
+        fillZerosAtLeft: true,
+        rejectEmpty: true,
+        rejectHigherLength: true,
+        rejectEqualSequence: true,
+    });
+};
+exports.normalize = normalize;
+exports.default = exports.validate;
+//# sourceMappingURL=tituloEleitor.js.map

package/dist/tituloEleitor.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Calcula o DV verificador a partir das regras do MOD11:
+ * O valor da soma é dividido por 11. O resultado é o resto da divisão. Caso o resto seja
+ * menor que 2, ou seja, o valor da divisão seja 10 ou 11, o resultado é 0.
+ *
+ * @param {Integer} sum Soma
+ * @returns {Integer}
+ */
+export declare function sumToDV(sum: number): number;
+/**
+ * Checa se o número repassado possui todos os digitos iguais
+ *
+ * @example
+ * checkRepeatedSequence(12345678)
+ * // -> false
+ * checkRepeatedSequence(11111111)
+ * // -> true
+ *
+ */
+export declare function checkRepeatedSequence(value: string): boolean;
+/**
+ * Multiplica os elementos de uma string com os elementos de outra, ou de um array
+ * e soma o resultado ao final
+ *
+ * @example
+ *   sumElementsByMultipliers('123', '987')      //-> 46
+ *   sumElementsByMultipliers('123', [9, 8, 7])  //-> 46
+ *
+ * @param {String} value
+ * @param {String|Array} multiplier
+ * @returns {Integer} Somatório
+ */
+export declare function sumElementsByMultipliers(value: string, multiplier: number[]): number;
+/**
+ * fakeNumber()
+ * Cria um número aleatório com o número de caracteres
+ *
+ * @example
+ * fakeNumber(8, true) // -> 00083159
+ * fakeNumber(4) // -> 831
+ *
+ * @param {Integer} length
+ * @param {Boolean} forceLength Adiciona zeros à esquerda para ter os números de caractes exatos
+ * @returns {String}
+ */
+export declare function fakeNumber(length: number, forceLength?: boolean, isAlpha?: boolean): string;
+/**
+ * Limpa um número informado, retirando caracteres diferentes de números,
+ * preenchendo com zeros à esquerda se for menor que o tamanho exato e
+ * removendo uma parte do número se for maior que tamanho definido.
+ *
+ * 1) Retira caracteres não-numéricos
+ * 2) Preenche com zeros à esquerda se 'value' for menor que 'length'
+ * 3) Remove caracteres à direita se 'value' for maior que 'length'
+ *
+ * @example
+ *  clearValue(12345-6, 6) // -> 123456
+ *  clearValue(12345678, 3) // -> 123
+ *  clearValue(12345, 10) // -> 0000001234
+ *
+ * @param {Number|String} value
+ * @param {Number} length Tamanho exato. Se for null, só retira os caracteres não-numéricos
+ * @returns {String} Número com o tamanho exato
+ */
+export declare function clearValue(value: string | number, length?: number | null, options?: ClearValueOptions): string;
+/**
+ * insertAtPosition()
+ * Insere um conjunto de caracteres em um local específico de uma string
+ *
+ * @example
+ * insertAtPosition('AAABBB', 'C', 3) // -> AAACBBB
+ * insertAtPosition('000011122223445555', 99, 7) // -> 00001119922223445555
+ *
+ * @param {String|Number} value Valor original
+ * @param {String|Number} insertValue Valor que será inserido
+ * @param {String|Number} position Posição que receberá o novo valor
+ * @returns {String}
+ *
+ */
+export declare function insertAtPosition(value: string, insertValue: string, position: number): string;
+/**
+ * removeFromPosition()
+ * Retira um conjunto de caracteres de um local específico de uma string
+ *
+ * @example
+ * removeFromPosition('00001119922223445555', 7,9) // -> 000011122223445555
+ * removeFromPosition('AAACBBB', 3,4) // -> AAABBB
+ *
+ * @param {String|Number} value Valor original
+ * @param {String|Number} startPosition
+ * @param {String|Number} endPosition
+ * @returns {String}
+ *
+ */
+export declare function removeFromPosition(value: string, startPosition: number, endPosition: number): string;
+/**
+ * applyMask()
+ * Aplica uma máscara a uma string
+ *
+ * @example
+ * applyMask('59650000', '00.000-000') // -> 59.650-000
+ * applyMask('99877665544', '(00) 0 0000-0000') // -> (99) 8 7766-5544
+ *
+ * @param {String|Number} value Valor original
+ * @param {String} mask
+ * @returns {String}
+ *
+ */
+export declare function applyMask(value: string | number, mask: string): string;
+/**
+ * randomLetter()
+ * Pega uma letra maiúscula aleatoriamente
+ *
+ * @example
+ * randomLetter() // -> A
+ * randomLetter() // -> S
+ *
+ * @returns {String}
+ */
+export declare function randomLetter(): string;
+/**
+ * Opções do clearValue
+ */
+interface ClearValueOptions {
+    fillZerosAtLeft?: boolean;
+    trimAtRight?: boolean;
+    rejectEmpty?: boolean;
+    rejectHigherLength?: boolean;
+    rejectEqualSequence?: boolean;
+}
+export {};

package/dist/utils.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sumToDV = sumToDV;
+exports.checkRepeatedSequence = checkRepeatedSequence;
+exports.sumElementsByMultipliers = sumElementsByMultipliers;
+exports.fakeNumber = fakeNumber;
+exports.clearValue = clearValue;
+exports.insertAtPosition = insertAtPosition;
+exports.removeFromPosition = removeFromPosition;
+exports.applyMask = applyMask;
+exports.randomLetter = randomLetter;
+const ValidationBRError_1 = __importDefault(require("./_exceptions/ValidationBRError"));
+/**
+ * Calcula o DV verificador a partir das regras do MOD11:
+ * O valor da soma é dividido por 11. O resultado é o resto da divisão. Caso o resto seja
+ * menor que 2, ou seja, o valor da divisão seja 10 ou 11, o resultado é 0.
+ *
+ * @param {Integer} sum Soma
+ * @returns {Integer}
+ */
+function sumToDV(sum) {
+    return sum % 11 < 2 ? 0 : 11 - (sum % 11);
+}
+/**
+ * Checa se o número repassado possui todos os digitos iguais
+ *
+ * @example
+ * checkRepeatedSequence(12345678)
+ * // -> false
+ * checkRepeatedSequence(11111111)
+ * // -> true
+ *
+ */
+function checkRepeatedSequence(value) {
+    return [...value].every(digit => digit === value[0]);
+}
+/**
+ * Multiplica os elementos de uma string com os elementos de outra, ou de um array
+ * e soma o resultado ao final
+ *
+ * @example
+ *   sumElementsByMultipliers('123', '987')      //-> 46
+ *   sumElementsByMultipliers('123', [9, 8, 7])  //-> 46
+ *
+ * @param {String} value
+ * @param {String|Array} multiplier
+ * @returns {Integer} Somatório
+ */
+function sumElementsByMultipliers(value, multiplier) {
+    return multiplier.reduce((accu, curr, i) => accu + curr * Number(value[i]), 0);
+}
+/**
+ * fakeNumber()
+ * Cria um número aleatório com o número de caracteres
+ *
+ * @example
+ * fakeNumber(8, true) // -> 00083159
+ * fakeNumber(4) // -> 831
+ *
+ * @param {Integer} length
+ * @param {Boolean} forceLength Adiciona zeros à esquerda para ter os números de caractes exatos
+ * @returns {String}
+ */
+function fakeNumber(length, forceLength = false, isAlpha = false) {
+    let value;
+    if (isAlpha)
+        value = Math.round(Math.random() * 36 ** length).toString(36).toLocaleUpperCase();
+    else
+        value = Math.floor(Math.random() * 10 ** length).toString();
+    if (forceLength)
+        return String(value).padStart(length, '0');
+    return String(value);
+}
+/**
+ * Limpa um número informado, retirando caracteres diferentes de números,
+ * preenchendo com zeros à esquerda se for menor que o tamanho exato e
+ * removendo uma parte do número se for maior que tamanho definido.
+ *
+ * 1) Retira caracteres não-numéricos
+ * 2) Preenche com zeros à esquerda se 'value' for menor que 'length'
+ * 3) Remove caracteres à direita se 'value' for maior que 'length'
+ *
+ * @example
+ *  clearValue(12345-6, 6) // -> 123456
+ *  clearValue(12345678, 3) // -> 123
+ *  clearValue(12345, 10) // -> 0000001234
+ *
+ * @param {Number|String} value
+ * @param {Number} length Tamanho exato. Se for null, só retira os caracteres não-numéricos
+ * @returns {String} Número com o tamanho exato
+ */
+function clearValue(value, length = null, options) {
+    let clearedValue = String(value).replace(/([/.-\s]+)/gi, '');
+    if (options) {
+        const shouldRejectEmpty = options.rejectEmpty === true && clearedValue.length === 0;
+        if (shouldRejectEmpty) {
+            throw ValidationBRError_1.default.EMPTY_VALUE;
+        }
+        const shouldRejectHigherLength = options.rejectHigherLength === true && length && clearedValue.length > length;
+        if (shouldRejectHigherLength) {
+            throw ValidationBRError_1.default.MAX_LEN_EXCEDEED;
+        }
+        const shouldRejectEqualSequence = options.rejectEqualSequence === true && length;
+        if (shouldRejectEqualSequence) {
+            if (checkRepeatedSequence(clearedValue))
+                throw ValidationBRError_1.default.REPEATED_SEQUENCE;
+        }
+        if (length && options.fillZerosAtLeft)
+            clearedValue = clearedValue.padStart(length, '0');
+        if (length && options.trimAtRight)
+            clearedValue = clearedValue.substring(0, length);
+    }
+    return clearedValue;
+}
+/**
+ * insertAtPosition()
+ * Insere um conjunto de caracteres em um local específico de uma string
+ *
+ * @example
+ * insertAtPosition('AAABBB', 'C', 3) // -> AAACBBB
+ * insertAtPosition('000011122223445555', 99, 7) // -> 00001119922223445555
+ *
+ * @param {String|Number} value Valor original
+ * @param {String|Number} insertValue Valor que será inserido
+ * @param {String|Number} position Posição que receberá o novo valor
+ * @returns {String}
+ *
+ */
+function insertAtPosition(value, insertValue, position) {
+    return `${value.substring(0, position)}${insertValue}${value.substring(position)}`;
+}
+/**
+ * removeFromPosition()
+ * Retira um conjunto de caracteres de um local específico de uma string
+ *
+ * @example
+ * removeFromPosition('00001119922223445555', 7,9) // -> 000011122223445555
+ * removeFromPosition('AAACBBB', 3,4) // -> AAABBB
+ *
+ * @param {String|Number} value Valor original
+ * @param {String|Number} startPosition
+ * @param {String|Number} endPosition
+ * @returns {String}
+ *
+ */
+function removeFromPosition(value, startPosition, endPosition) {
+    return [value.slice(0, startPosition), value.slice(endPosition)].join('');
+}
+/**
+ * applyMask()
+ * Aplica uma máscara a uma string
+ *
+ * @example
+ * applyMask('59650000', '00.000-000') // -> 59.650-000
+ * applyMask('99877665544', '(00) 0 0000-0000') // -> (99) 8 7766-5544
+ *
+ * @param {String|Number} value Valor original
+ * @param {String} mask
+ * @returns {String}
+ *
+ */
+function applyMask(value, mask) {
+    const maskLen = clearValue(mask).length;
+    let masked = clearValue(value, maskLen, { fillZerosAtLeft: true, trimAtRight: true });
+    const specialChars = ['/', '-', '.', '(', ')', ' '];
+    for (let position = 0; position < mask.length; position += 1) {
+        const current = mask[position];
+        if (specialChars.includes(current))
+            masked = insertAtPosition(masked, current, position);
+    }
+    return masked;
+}
+/**
+ * randomLetter()
+ * Pega uma letra maiúscula aleatoriamente
+ *
+ * @example
+ * randomLetter() // -> A
+ * randomLetter() // -> S
+ *
+ * @returns {String}
+ */
+function randomLetter() {
+    const idx = Math.floor(1 + Math.random() * 26);
+    return String.fromCharCode(idx + 64);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,18 +1,29 @@
 {
   "name": "validation-br",
   "description": "Brazilian personal documents validation - cpf, cnpj, titulo, pis/pasep, cnh, renavam, processos judiciais, protocolo federal, código de rastreamento dos correios",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json",
+    "package-lock.json",
+    "readme.md"
+  ],
+  
   "author": "Cláudio Medeiros <klawdyo@gmail.com>",
   "license": "MIT",
   "scripts": {
-    "build": "tsc",
+    "build": "./publish.sh",
+    "prepublish": "npm run build",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --collectCoverageFrom=src/**/*.ts --coverage",
     "format": "prettier --write \"./**/*.{js,ts,json}\"",
-    "prepublish": "npm run build"
+    
+    
+    "__:build": "rm dist -r && tsc && rm -r dist/test && mv dist/src/* dist && rm dist/src -r && cp package*.json readme.md dist"
+    
   },
   "lint-staged": {
     "*.{js,ts}": [

package/readme.md

@@ -76,7 +76,7 @@ validateOrFail('01234567890'); // -> true
 - [PIS](#pis) - Validação de PIS, PASEP, NIS e NIT
 - [Código de Rastreamento Postal](#código-de-rastreamento-postal-dos-correios) - Validação de Objetos Registrados dos Correios
 - [Renavam](#renavam) - Validação de RENAVAM
-- [Titulo de Eleitor](#titulo-de-eleitor) - Validação do Título de Eleitor
+- [Titulo de Eleitor](#título-de-eleitor) - Validação do Título de Eleitor
 
 ## Usando em outras bibliotecas de validação
 

package/.prettierignore

@@ -1 +0,0 @@
-dist/

package/.prettierrc.js

@@ -1,7 +0,0 @@
-module.exports = {
-  semi: true,
-  trailingComma: 'all',
-  singleQuote: true,
-  printWidth: 100,
-  tabWidth: 2,
-}

package/dist/test/cnh.test.d.ts

@@ -1 +0,0 @@
-export {};