@marcuth/cpfcnpj 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcuth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# cpfcnpj
+
+[![npm version](https://img.shields.io/npm/v/cpfcnpj.svg?style=flat-square)](https://www.npmjs.com/package/cpfcnpj)
+[![npm downloads](https://img.shields.io/npm/dm/cpfcnpj.svg?style=flat-square)](https://www.npmjs.com/package/cpfcnpj)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+
+A lightweight, high-performance TypeScript library for validation, generation, and formatting of Brazilian documents (CPF and CNPJ).
+
+## ✨ Features
+
+- 🏎️ **Ultra-fast**: Minimal overhead and highly optimized algorithms.
+- 🛡️ **Type-safe**: Built with TypeScript for excellent IDE support and reliability.
+- 📦 **Zero Dependencies**: Keeps your bundle size small.
+- 🛠️ **Full Toolkit**: Validate, generate, format, and unformat with ease.
+- 📍 **Region-Aware**: CNPJ generation support for specific Brazilian states.
+- 🆔 **Alphanumeric CNPJ**: Full support for the new 2026 CNPJ format.
+
+## 🚀 Installation
+
+```bash
+npm install cpfcnpj
+# or
+yarn add cpfcnpj
+# or
+pnpm add cpfcnpj
+```
+
+## 📖 Usage
+
+### CPF (Cadastro de Pessoas Físicas)
+
+```typescript
+import { cpf } from 'cpfcnpj';
+
+// Validation
+cpf.validate('123.456.789-00'); // false
+cpf.validate('52998224725');     // true
+
+// Generation
+cpf.generate();                 // '52998224725'
+cpf.generate({ formatted: true }); // '529.982.247-25'
+
+// Formatting
+cpf.format('52998224725');      // '529.982.247-25'
+cpf.unformat('529.982.247-25'); // '52998224725'
+```
+
+### CNPJ (Cadastro Nacional da Pessoa Jurídica)
+
+```typescript
+import { cnpj } from 'cpfcnpj';
+
+// Validation
+cnpj.validate('12.345.678/0001-00'); // false
+cnpj.validate('11.222.333/0001-81');   // true
+cnpj.validate('ABC1D23E/0001-91');     // true (Alphanumeric example)
+
+// Generation
+cnpj.generate();                      // '11222333000181'
+cnpj.generate({ formatted: true });    // '11.222.333/0001-81'
+cnpj.generate({ alphanumeric: true }); // 'ABC1D23E000191'
+cnpj.generate({ state: 'SP', formatted: true }); // SP region CNPJ
+
+// Formatting
+cnpj.format('11222333000181');         // '11.222.333/0001-81'
+cnpj.unformat('11.222.333/0001-81');    // '11222333000181'
+```
+
+## 🛠️ API Reference
+
+### `cpf` & `cnpj`
+
+Both modules export the following methods:
+
+| Method | Signature | Description |
+| :--- | :--- | :--- |
+| `validate` | `(value: string) => boolean` | Validates the check digits and format. |
+| `generate` | `(options?: GenerateOptions) => string` | Generates a valid document. |
+| `format` | `(value: string) => string` | Applies standard formatting (mask). |
+| `unformat` | `(value: string) => string` | Removes all non-digit characters. |
+
+#### `GenerateOptions`
+
+- **CPF**: `{ formatted?: boolean }`
+- **CNPJ**: `{ formatted?: boolean, state?: string, alphanumeric?: boolean }`
+
+## 🧪 Testing
+
+The library is fully tested with Vitest.
+
+```bash
+npm test
+```
+
+## 📄 License
+
+Distributed under the [MIT License](LICENSE).
+
+---
+
+Developed with ❤️ by [Marcuth](https://github.com/marcuth)

package/dist/cnpj.d.ts

@@ -0,0 +1,13 @@
+export declare const regex: {
+    formatted: RegExp;
+    raw: RegExp;
+};
+export declare function unformat(formatted: string): string;
+export declare function format(raw: string): string;
+export declare function validate(raw: string): boolean;
+export type GenerateOptions = {
+    formatted?: boolean;
+    state?: string;
+    alphanumeric?: boolean;
+};
+export declare function generate(options?: GenerateOptions): string;

package/dist/cnpj.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.regex = void 0;
+exports.unformat = unformat;
+exports.format = format;
+exports.validate = validate;
+exports.generate = generate;
+const STATE_TO_DIGIT = {
+    AC: "2",
+    AL: "4",
+    AM: "2",
+    AP: "2",
+    BA: "5",
+    CE: "3",
+    DF: "1",
+    ES: "7",
+    GO: "1",
+    MA: "3",
+    MG: "6",
+    MS: "1",
+    MT: "1",
+    PA: "2",
+    PB: "4",
+    PE: "4",
+    PI: "3",
+    PR: "9",
+    RJ: "7",
+    RN: "4",
+    RO: "2",
+    RR: "2",
+    RS: "0",
+    SC: "9",
+    SE: "5",
+    SP: "8",
+    TO: "1",
+};
+exports.regex = {
+    formatted: /^[A-Z0-9]{2}\.[A-Z0-9]{3}\.[A-Z0-9]{3}\/[A-Z0-9]{4}-\d{2}$/i,
+    raw: /^[A-Z0-9]{12}\d{2}$/i,
+};
+function unformat(formatted) {
+    return formatted.replace(/[^A-Z0-9]/gi, "").toUpperCase();
+}
+function format(raw) {
+    const digits = unformat(raw);
+    if (!exports.regex.raw.test(digits)) {
+        throw new Error("Invalid CNPJ format");
+    }
+    return `${digits.slice(0, 2)}.${digits.slice(2, 5)}.${digits.slice(5, 8)}/${digits.slice(8, 12)}-${digits.slice(12)}`;
+}
+function validate(raw) {
+    const value = unformat(raw);
+    if (!exports.regex.raw.test(value))
+        return false;
+    if (/^(\w)\1{13}$/.test(value))
+        return false;
+    const calc = (n, weightStart) => {
+        let sum = 0;
+        let weight = weightStart;
+        for (let i = 0; i < n; i++) {
+            const charValue = value.charCodeAt(i) - 48;
+            sum += charValue * weight;
+            weight--;
+            if (weight < 2) {
+                weight = 9;
+            }
+        }
+        const remainder = sum % 11;
+        return remainder < 2 ? 0 : 11 - remainder;
+    };
+    return calc(12, 5) === parseInt(value[12], 10) && calc(13, 6) === parseInt(value[13], 10);
+}
+function generate(options = {}) {
+    const values = [];
+    for (let i = 0; i < 8; i++) {
+        if (i === 7 && options.state) {
+            const stateDigit = STATE_TO_DIGIT[options.state.toUpperCase()];
+            if (!stateDigit) {
+                throw new Error(`Invalid state: ${options.state}`);
+            }
+            values.push(parseInt(stateDigit, 10));
+        }
+        else if (options.alphanumeric) {
+            const isLetter = Math.random() > 0.5;
+            if (isLetter) {
+                values.push(Math.floor(Math.random() * 26) + 17);
+            }
+            else {
+                values.push(Math.floor(Math.random() * 10));
+            }
+        }
+        else {
+            values.push(Math.floor(Math.random() * 10));
+        }
+    }
+    values.push(0, 0, 0, 1);
+    const calc = (n, weightStart) => {
+        let sum = 0;
+        let weight = weightStart;
+        for (let i = 0; i < n; i++) {
+            sum += values[i] * weight;
+            weight--;
+            if (weight < 2)
+                weight = 9;
+        }
+        const remainder = sum % 11;
+        return remainder < 2 ? 0 : 11 - remainder;
+    };
+    values.push(calc(12, 5));
+    values.push(calc(13, 6));
+    const raw = values
+        .map((v) => {
+        if (v >= 17)
+            return String.fromCharCode(v + 48);
+        return String(v);
+    })
+        .join("");
+    return options.formatted ? format(raw) : raw;
+}

package/dist/cpf.d.ts

@@ -0,0 +1,11 @@
+export declare const regex: {
+    formatted: RegExp;
+    raw: RegExp;
+};
+export declare function unformat(formatted: string): string;
+export declare function format(raw: string): string;
+export declare function validate(raw: string): boolean;
+export type GenerateOptions = {
+    formatted?: boolean;
+};
+export declare function generate(options?: GenerateOptions): string;

package/dist/cpf.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.regex = void 0;
+exports.unformat = unformat;
+exports.format = format;
+exports.validate = validate;
+exports.generate = generate;
+exports.regex = {
+    formatted: /^\d{3}\.\d{3}\.\d{3}-\d{2}$/,
+    raw: /^\d{11}$/,
+};
+function unformat(formatted) {
+    return formatted.replace(/\D/g, "");
+}
+function format(raw) {
+    const digits = unformat(raw);
+    if (!exports.regex.raw.test(digits)) {
+        throw new Error("Invalid CPF format");
+    }
+    return `${digits.slice(0, 3)}.${digits.slice(3, 6)}.${digits.slice(6, 9)}-${digits.slice(9)}`;
+}
+function validate(raw) {
+    const digits = unformat(raw);
+    if (!exports.regex.raw.test(digits))
+        return false;
+    if (/^(\d)\1{10}$/.test(digits))
+        return false;
+    const calc = (n, weightStart) => {
+        let sum = 0;
+        for (let i = 0; i < n; i++) {
+            sum += parseInt(digits[i], 10) * (weightStart - i);
+        }
+        const remainder = sum % 11;
+        return remainder < 2 ? 0 : 11 - remainder;
+    };
+    return calc(9, 10) === parseInt(digits[9], 10) && calc(10, 11) === parseInt(digits[10], 10);
+}
+function generate(options = {}) {
+    const digits = Array.from({ length: 9 }, () => Math.floor(Math.random() * 10));
+    while (digits.every((d) => d === digits[0])) {
+        digits[0] = Math.floor(Math.random() * 10);
+    }
+    const calc = (n, weightStart) => {
+        let sum = 0;
+        for (let i = 0; i < n; i++) {
+            sum += digits[i] * (weightStart - i);
+        }
+        const remainder = sum % 11;
+        return remainder < 2 ? 0 : 11 - remainder;
+    };
+    digits.push(calc(9, 10));
+    digits.push(calc(10, 11));
+    const raw = digits.join("");
+    return options.formatted ? format(raw) : raw;
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import * as cnpj from "./cnpj";
+import * as cpf from "./cpf";
+export { cnpj, cpf };

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cpf = exports.cnpj = void 0;
+const cnpj = __importStar(require("./cnpj"));
+exports.cnpj = cnpj;
+const cpf = __importStar(require("./cpf"));
+exports.cpf = cpf;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@marcuth/cpfcnpj",
+  "description": "A lightweight, high-performance TypeScript library for validation, generation, and formatting of Brazilian documents (CPF and CNPJ).",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marcuth/cpfcnpj.git"
+  },
+  "homepage": "https://github.com/marcuth/cpfcnpj#readme",
+  "bugs": {
+    "url": "https://github.com/marcuth/cpfcnpj/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/*",
+    "!/**/__tests__"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node ./src/index.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"src/**/*.ts\" --fix",
+    "test": "vitest",
+    "test:cov": "vitest run --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "cpf validator",
+    "cpf generator",
+    "cpf formatter",
+    "cnpj validator",
+    "cnpj generator",
+    "cnpj formatter"
+  ],
+  "author": "Marcuth",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@vitest/coverage-v8": "^4.1.3",
+    "eslint": "^10.2.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "prettier": "^3.8.1",
+    "prettier-plugin-sort-imports": "^1.8.11",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.3"
+  }
+}