chilean-rut-formatter 1.0.0

package/README.md

@@ -0,0 +1,150 @@
+# Chilean RUT Formatter
+
+[![npm version](https://badge.fury.io/js/chilean-rut-formatter.svg)](https://www.npmjs.com/package/chilean-rut-formatter)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+High-performance TypeScript library for formatting and validating Chilean RUTs (Rol Único Tributario).
+
+## Features
+
+- ✅ **Validate** RUTs using the official Module 11 algorithm
+- ✅ **Format** with customizable options (dots, dashes, case)
+- ✅ **Clean** and sanitize user input
+- ✅ **TypeScript** - Full type definitions included
+- ✅ **Zero dependencies** - Lightweight and fast
+- ✅ **Secure** - Input sanitization and DoS protection
+- ✅ **Tree-shakeable** - ESM and CJS support
+
+## Installation
+
+```bash
+npm install chilean-rut-formatter
+```
+
+## Usage
+
+### Validate a RUT
+
+```typescript
+import { validateRut, isValidRut } from 'chilean-rut-formatter';
+
+// Full validation with details
+const result = validateRut('12.345.678-5');
+// { isValid: true, rut: '123456785' }
+
+const invalid = validateRut('12345678-0');
+// { isValid: false, error: 'Invalid verification digit' }
+
+// Simple boolean check
+isValidRut('12.345.678-5'); // true
+isValidRut('12345678-0');   // false
+```
+
+### Format a RUT
+
+```typescript
+import { formatRut } from 'chilean-rut-formatter';
+
+// Default: with dots and dash
+formatRut('123456785');         // '12.345.678-5'
+formatRut('12345678K');         // '12.345.678-K'
+
+// Custom options
+formatRut('123456785', { dots: false });       // '12345678-5'
+formatRut('123456785', { dash: false });       // '12.345.6785'
+formatRut('12345678K', { uppercase: false });  // '12.345.678-k'
+
+// Returns empty string if RUT is invalid
+formatRut('12345678-0');  // ''
+```
+
+### Format Partial Input (Real-time)
+
+```typescript
+import { formatRutPartial } from 'chilean-rut-formatter';
+
+// Great for live formatting as user types
+formatRutPartial('1');         // '1'
+formatRutPartial('12');        // '1-2'
+formatRutPartial('12345');     // '1.234-5'
+formatRutPartial('123456789'); // '12.345.678-9'
+```
+
+### Clean a RUT
+
+```typescript
+import { cleanRut } from 'chilean-rut-formatter';
+
+cleanRut('12.345.678-9');    // '123456789'
+cleanRut('12 345 678-k');    // '12345678K'
+cleanRut('  12#345$678%9 '); // '123456789'
+```
+
+### Calculate Verification Digit
+
+```typescript
+import { calculateVerificationDigit } from 'chilean-rut-formatter';
+
+calculateVerificationDigit('12345678');  // '5'
+calculateVerificationDigit('16612277');  // 'K'
+```
+
+## API Reference
+
+### `validateRut(rut: string): ValidationResult`
+
+Validates a Chilean RUT and returns detailed result.
+
+```typescript
+interface ValidationResult {
+  isValid: boolean;
+  rut?: string;    // Cleaned RUT if valid
+  error?: string;  // Error message if invalid
+}
+```
+
+### `isValidRut(rut: string): boolean`
+
+Simple boolean validation check.
+
+### `formatRut(rut: string, options?: FormatOptions): string`
+
+Formats a valid RUT. Returns empty string if RUT is invalid.
+
+```typescript
+interface FormatOptions {
+  dots?: boolean;      // Include dots (default: true)
+  dash?: boolean;      // Include dash (default: true)
+  uppercase?: boolean; // Uppercase K (default: true)
+}
+```
+
+### `formatRutPartial(rut: string, options?: FormatOptions): string`
+
+Formats partial RUT input (useful for real-time formatting).
+
+### `cleanRut(input: string): string`
+
+Removes all non-valid characters from input.
+
+### `calculateVerificationDigit(rutBody: string): string`
+
+Calculates the verification digit for a RUT body.
+
+## Security
+
+- **Input Sanitization**: All inputs are cleaned before processing
+- **DoS Protection**: Maximum input length enforced (50 chars)
+- **No eval/Function**: No dynamic code execution
+- **TypeScript Strict Mode**: Full type safety
+
+## Performance
+
+- **Zero dependencies**: No external library overhead
+- **Pre-compiled regex**: Patterns compiled once at module load
+- **Early returns**: Fast failure for invalid inputs
+- **Minimal allocations**: Optimized for performance
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,119 @@
+/**
+ * Options for formatting a RUT
+ */
+interface FormatOptions {
+    /** Include dots as thousand separators (e.g., 12.345.678-9). Default: true */
+    dots?: boolean;
+    /** Include dash before verification digit. Default: true */
+    dash?: boolean;
+    /** Use uppercase for 'K' verification digit. Default: true */
+    uppercase?: boolean;
+}
+/**
+ * Result of RUT validation
+ */
+interface ValidationResult {
+    /** Whether the RUT is valid */
+    isValid: boolean;
+    /** Clean RUT string (numbers + verification digit) if valid */
+    rut?: string;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Parsed RUT components
+ */
+interface ParsedRut {
+    /** RUT body (numbers only, without verification digit) */
+    body: string;
+    /** Verification digit (0-9 or K) */
+    verificationDigit: string;
+}
+
+/**
+ * Cleans a RUT string by removing all non-valid characters.
+ * Keeps only numbers and 'K'/'k'.
+ *
+ * @param input - Raw RUT input string
+ * @returns Cleaned RUT string with only valid characters
+ *
+ * @example
+ * cleanRut('12.345.678-9') // '123456789'
+ * cleanRut('12345678-K') // '12345678K'
+ * cleanRut('  12-345-678.9  ') // '123456789'
+ */
+declare function cleanRut(input: string): string;
+
+/**
+ * Validates a Chilean RUT (Rol Único Tributario).
+ *
+ * Uses the official Module 11 algorithm to verify the check digit.
+ *
+ * @param rut - RUT string to validate (can include dots, dashes, spaces)
+ * @returns Validation result with isValid flag and cleaned RUT if valid
+ *
+ * @example
+ * validateRut('12.345.678-5') // { isValid: true, rut: '123456785' }
+ * validateRut('12345678-5')   // { isValid: true, rut: '123456785' }
+ * validateRut('12345678-0')   // { isValid: false, error: 'Invalid verification digit' }
+ * validateRut('')             // { isValid: false, error: 'RUT is required' }
+ */
+declare function validateRut(rut: string): ValidationResult;
+/**
+ * Simple boolean check for RUT validity.
+ *
+ * @param rut - RUT string to validate
+ * @returns true if RUT is valid, false otherwise
+ *
+ * @example
+ * isValidRut('12.345.678-5') // true
+ * isValidRut('12345678-0')   // false
+ */
+declare function isValidRut(rut: string): boolean;
+
+/**
+ * Formats a Chilean RUT with the specified options.
+ *
+ * By default, formats as: 12.345.678-9
+ *
+ * @param rut - RUT string to format (can include dots, dashes, spaces)
+ * @param options - Formatting options
+ * @returns Formatted RUT string, or empty string if invalid
+ *
+ * @example
+ * formatRut('123456785')                    // '12.345.678-5'
+ * formatRut('123456785', { dots: false })   // '12345678-5'
+ * formatRut('123456785', { dash: false })   // '12.345.6785'
+ * formatRut('12345678K', { uppercase: false }) // '12.345.678-k'
+ */
+declare function formatRut(rut: string, options?: FormatOptions): string;
+/**
+ * Formats a RUT without validation (use with caution).
+ * Useful when you need to format user input as they type.
+ *
+ * @param rut - RUT string to format
+ * @param options - Formatting options
+ * @returns Formatted RUT string
+ *
+ * @example
+ * formatRutPartial('12345')     // '12.345'
+ * formatRutPartial('123456789') // '12.345.678-9'
+ */
+declare function formatRutPartial(rut: string, options?: FormatOptions): string;
+
+/**
+ * Calculates the verification digit for a RUT body using Module 11 algorithm.
+ *
+ * @param rutBody - RUT body (numbers only, without verification digit)
+ * @returns Calculated verification digit ('0'-'9' or 'K')
+ */
+declare function calculateVerificationDigit(rutBody: string): string;
+/**
+ * Parses a cleaned RUT string into body and verification digit.
+ *
+ * @param cleanedRut - Cleaned RUT string (only numbers and K)
+ * @returns Parsed RUT object or null if invalid format
+ */
+declare function parseRut(cleanedRut: string): ParsedRut | null;
+
+export { type FormatOptions, type ParsedRut, type ValidationResult, calculateVerificationDigit, cleanRut, formatRut, formatRutPartial, isValidRut, parseRut, validateRut };

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Options for formatting a RUT
+ */
+interface FormatOptions {
+    /** Include dots as thousand separators (e.g., 12.345.678-9). Default: true */
+    dots?: boolean;
+    /** Include dash before verification digit. Default: true */
+    dash?: boolean;
+    /** Use uppercase for 'K' verification digit. Default: true */
+    uppercase?: boolean;
+}
+/**
+ * Result of RUT validation
+ */
+interface ValidationResult {
+    /** Whether the RUT is valid */
+    isValid: boolean;
+    /** Clean RUT string (numbers + verification digit) if valid */
+    rut?: string;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Parsed RUT components
+ */
+interface ParsedRut {
+    /** RUT body (numbers only, without verification digit) */
+    body: string;
+    /** Verification digit (0-9 or K) */
+    verificationDigit: string;
+}
+
+/**
+ * Cleans a RUT string by removing all non-valid characters.
+ * Keeps only numbers and 'K'/'k'.
+ *
+ * @param input - Raw RUT input string
+ * @returns Cleaned RUT string with only valid characters
+ *
+ * @example
+ * cleanRut('12.345.678-9') // '123456789'
+ * cleanRut('12345678-K') // '12345678K'
+ * cleanRut('  12-345-678.9  ') // '123456789'
+ */
+declare function cleanRut(input: string): string;
+
+/**
+ * Validates a Chilean RUT (Rol Único Tributario).
+ *
+ * Uses the official Module 11 algorithm to verify the check digit.
+ *
+ * @param rut - RUT string to validate (can include dots, dashes, spaces)
+ * @returns Validation result with isValid flag and cleaned RUT if valid
+ *
+ * @example
+ * validateRut('12.345.678-5') // { isValid: true, rut: '123456785' }
+ * validateRut('12345678-5')   // { isValid: true, rut: '123456785' }
+ * validateRut('12345678-0')   // { isValid: false, error: 'Invalid verification digit' }
+ * validateRut('')             // { isValid: false, error: 'RUT is required' }
+ */
+declare function validateRut(rut: string): ValidationResult;
+/**
+ * Simple boolean check for RUT validity.
+ *
+ * @param rut - RUT string to validate
+ * @returns true if RUT is valid, false otherwise
+ *
+ * @example
+ * isValidRut('12.345.678-5') // true
+ * isValidRut('12345678-0')   // false
+ */
+declare function isValidRut(rut: string): boolean;
+
+/**
+ * Formats a Chilean RUT with the specified options.
+ *
+ * By default, formats as: 12.345.678-9
+ *
+ * @param rut - RUT string to format (can include dots, dashes, spaces)
+ * @param options - Formatting options
+ * @returns Formatted RUT string, or empty string if invalid
+ *
+ * @example
+ * formatRut('123456785')                    // '12.345.678-5'
+ * formatRut('123456785', { dots: false })   // '12345678-5'
+ * formatRut('123456785', { dash: false })   // '12.345.6785'
+ * formatRut('12345678K', { uppercase: false }) // '12.345.678-k'
+ */
+declare function formatRut(rut: string, options?: FormatOptions): string;
+/**
+ * Formats a RUT without validation (use with caution).
+ * Useful when you need to format user input as they type.
+ *
+ * @param rut - RUT string to format
+ * @param options - Formatting options
+ * @returns Formatted RUT string
+ *
+ * @example
+ * formatRutPartial('12345')     // '12.345'
+ * formatRutPartial('123456789') // '12.345.678-9'
+ */
+declare function formatRutPartial(rut: string, options?: FormatOptions): string;
+
+/**
+ * Calculates the verification digit for a RUT body using Module 11 algorithm.
+ *
+ * @param rutBody - RUT body (numbers only, without verification digit)
+ * @returns Calculated verification digit ('0'-'9' or 'K')
+ */
+declare function calculateVerificationDigit(rutBody: string): string;
+/**
+ * Parses a cleaned RUT string into body and verification digit.
+ *
+ * @param cleanedRut - Cleaned RUT string (only numbers and K)
+ * @returns Parsed RUT object or null if invalid format
+ */
+declare function parseRut(cleanedRut: string): ParsedRut | null;
+
+export { type FormatOptions, type ParsedRut, type ValidationResult, calculateVerificationDigit, cleanRut, formatRut, formatRutPartial, isValidRut, parseRut, validateRut };

package/dist/index.js

@@ -0,0 +1,2 @@
+'use strict';var m=/[^0-9kK]/g;function l(t){return typeof t!="string"?"":(t.length>50&&(t=t.slice(0,50)),t.replace(m,"").toUpperCase())}function c(t){let o=[2,3,4,5,6,7],r=0,e=0;for(let a=t.length-1;a>=0;a--){let s=parseInt(t[a],10);r+=s*o[e],e=(e+1)%6;}let n=11-r%11;return n===11?"0":n===10?"K":n.toString()}function u(t){if(t.length<2)return null;let o=t.slice(-1),r=t.slice(0,-1);return !/^\d+$/.test(r)||!/^[0-9K]$/.test(o)?null:{body:r,verificationDigit:o}}var R=2,y=9;function f(t){if(!t||typeof t!="string")return {isValid:false,error:"RUT is required"};let o=l(t);if(o.length<R)return {isValid:false,error:"RUT is too short"};if(o.length>y)return {isValid:false,error:"RUT is too long"};let r=u(o);if(!r)return {isValid:false,error:"Invalid RUT format"};let e=c(r.body);return r.verificationDigit!==e?{isValid:false,error:"Invalid verification digit"}:{isValid:true,rut:o}}function T(t){return f(t).isValid}var p=/\B(?=(\d{3})+(?!\d))/g,d={dots:true,dash:true,uppercase:true};function V(t,o={}){let r={...d,...o},e=l(t),i=u(e);if(!i)return "";let n=c(i.body);if(i.verificationDigit!==n)return "";let a=i.body;r.dots&&(a=i.body.replace(p,"."));let s=i.verificationDigit;r.uppercase||(s=s.toLowerCase());let g=r.dash?"-":"";return `${a}${g}${s}`}function x(t,o={}){let r={...d,...o},e=l(t);if(e.length===0)return "";let i,n;if(e.length>1){let s=e.slice(-1);/[0-9K]/.test(s)?(i=e.slice(0,-1),n=r.uppercase?s:s.toLowerCase()):(i=e,n="");}else i=e,n="";let a=i;if(r.dots&&i.length>0&&(a=i.replace(p,".")),n){let s=r.dash?"-":"";return `${a}${s}${n}`}return a}exports.calculateVerificationDigit=c;exports.cleanRut=l;exports.formatRut=V;exports.formatRutPartial=x;exports.isValidRut=T;exports.parseRut=u;exports.validateRut=f;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/clean.ts","../src/utils.ts","../src/validate.ts","../src/format.ts"],"names":["CLEAN_REGEX","cleanRut","input","calculateVerificationDigit","rutBody","multipliers","sum","multiplierIndex","i","digit","result","parseRut","cleanedRut","verificationDigit","body","MIN_RUT_LENGTH","MAX_RUT_LENGTH","validateRut","rut","cleaned","parsed","expectedDigit","isValidRut","DOTS_REGEX","DEFAULT_OPTIONS","formatRut","options","opts","formattedBody","dv","separator","formatRutPartial","lastChar"],"mappings":"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","file":"index.js","sourcesContent":["// Pre-compiled regex for maximum performance\nconst CLEAN_REGEX = /[^0-9kK]/g;\n\n// Maximum allowed input length for security (prevents DoS)\nconst MAX_INPUT_LENGTH = 50;\n\n/**\n * Cleans a RUT string by removing all non-valid characters.\n * Keeps only numbers and 'K'/'k'.\n * \n * @param input - Raw RUT input string\n * @returns Cleaned RUT string with only valid characters\n * \n * @example\n * cleanRut('12.345.678-9') // '123456789'\n * cleanRut('12345678-K') // '12345678K'\n * cleanRut('  12-345-678.9  ') // '123456789'\n */\nexport function cleanRut(input: string): string {\n    // Security: handle non-string inputs gracefully\n    if (typeof input !== 'string') {\n        return '';\n    }\n\n    // Security: prevent DoS with extremely long inputs\n    if (input.length > MAX_INPUT_LENGTH) {\n        input = input.slice(0, MAX_INPUT_LENGTH);\n    }\n\n    // Remove all non-valid characters and convert to uppercase\n    return input.replace(CLEAN_REGEX, '').toUpperCase();\n}\n","import type { ParsedRut } from './types';\n\n/**\n * Calculates the verification digit for a RUT body using Module 11 algorithm.\n * \n * @param rutBody - RUT body (numbers only, without verification digit)\n * @returns Calculated verification digit ('0'-'9' or 'K')\n */\nexport function calculateVerificationDigit(rutBody: string): string {\n    // Multiplier sequence for Module 11 algorithm\n    const multipliers = [2, 3, 4, 5, 6, 7];\n\n    let sum = 0;\n    let multiplierIndex = 0;\n\n    // Process digits from right to left\n    for (let i = rutBody.length - 1; i >= 0; i--) {\n        const digit = parseInt(rutBody[i], 10);\n        sum += digit * multipliers[multiplierIndex];\n        multiplierIndex = (multiplierIndex + 1) % 6; // Cycle through multipliers\n    }\n\n    // Calculate verification digit\n    const remainder = sum % 11;\n    const result = 11 - remainder;\n\n    // Convert result to verification digit\n    if (result === 11) return '0';\n    if (result === 10) return 'K';\n    return result.toString();\n}\n\n/**\n * Parses a cleaned RUT string into body and verification digit.\n * \n * @param cleanedRut - Cleaned RUT string (only numbers and K)\n * @returns Parsed RUT object or null if invalid format\n */\nexport function parseRut(cleanedRut: string): ParsedRut | null {\n    if (cleanedRut.length < 2) {\n        return null;\n    }\n\n    const verificationDigit = cleanedRut.slice(-1);\n    const body = cleanedRut.slice(0, -1);\n\n    // Body must contain only digits\n    if (!/^\\d+$/.test(body)) {\n        return null;\n    }\n\n    // Verification digit must be a digit or K\n    if (!/^[0-9K]$/.test(verificationDigit)) {\n        return null;\n    }\n\n    return { body, verificationDigit };\n}\n","import type { ValidationResult } from './types';\nimport { cleanRut } from './clean';\nimport { parseRut, calculateVerificationDigit } from './utils';\n\n// Minimum valid RUT (1-9)\nconst MIN_RUT_LENGTH = 2;\n// Maximum valid RUT length (including verification digit)\nconst MAX_RUT_LENGTH = 9;\n\n/**\n * Validates a Chilean RUT (Rol Único Tributario).\n * \n * Uses the official Module 11 algorithm to verify the check digit.\n * \n * @param rut - RUT string to validate (can include dots, dashes, spaces)\n * @returns Validation result with isValid flag and cleaned RUT if valid\n * \n * @example\n * validateRut('12.345.678-5') // { isValid: true, rut: '123456785' }\n * validateRut('12345678-5')   // { isValid: true, rut: '123456785' }\n * validateRut('12345678-0')   // { isValid: false, error: 'Invalid verification digit' }\n * validateRut('')             // { isValid: false, error: 'RUT is required' }\n */\nexport function validateRut(rut: string): ValidationResult {\n    // Handle empty input\n    if (!rut || typeof rut !== 'string') {\n        return { isValid: false, error: 'RUT is required' };\n    }\n\n    // Clean the RUT\n    const cleaned = cleanRut(rut);\n\n    // Check minimum length\n    if (cleaned.length < MIN_RUT_LENGTH) {\n        return { isValid: false, error: 'RUT is too short' };\n    }\n\n    // Check maximum length\n    if (cleaned.length > MAX_RUT_LENGTH) {\n        return { isValid: false, error: 'RUT is too long' };\n    }\n\n    // Parse the RUT\n    const parsed = parseRut(cleaned);\n    if (!parsed) {\n        return { isValid: false, error: 'Invalid RUT format' };\n    }\n\n    // Calculate expected verification digit\n    const expectedDigit = calculateVerificationDigit(parsed.body);\n\n    // Compare with provided verification digit\n    if (parsed.verificationDigit !== expectedDigit) {\n        return { isValid: false, error: 'Invalid verification digit' };\n    }\n\n    return { isValid: true, rut: cleaned };\n}\n\n/**\n * Simple boolean check for RUT validity.\n * \n * @param rut - RUT string to validate\n * @returns true if RUT is valid, false otherwise\n * \n * @example\n * isValidRut('12.345.678-5') // true\n * isValidRut('12345678-0')   // false\n */\nexport function isValidRut(rut: string): boolean {\n    return validateRut(rut).isValid;\n}\n","import type { FormatOptions } from './types';\nimport { cleanRut } from './clean';\nimport { parseRut, calculateVerificationDigit } from './utils';\n\n// Pre-compiled regex for adding dots\nconst DOTS_REGEX = /\\B(?=(\\d{3})+(?!\\d))/g;\n\n/**\n * Default formatting options\n */\nconst DEFAULT_OPTIONS: Required<FormatOptions> = {\n    dots: true,\n    dash: true,\n    uppercase: true,\n};\n\n/**\n * Formats a Chilean RUT with the specified options.\n * \n * By default, formats as: 12.345.678-9\n * \n * @param rut - RUT string to format (can include dots, dashes, spaces)\n * @param options - Formatting options\n * @returns Formatted RUT string, or empty string if invalid\n * \n * @example\n * formatRut('123456785')                    // '12.345.678-5'\n * formatRut('123456785', { dots: false })   // '12345678-5'\n * formatRut('123456785', { dash: false })   // '12.345.6785'\n * formatRut('12345678K', { uppercase: false }) // '12.345.678-k'\n */\nexport function formatRut(rut: string, options: FormatOptions = {}): string {\n    // Merge with defaults\n    const opts: Required<FormatOptions> = { ...DEFAULT_OPTIONS, ...options };\n\n    // Clean the RUT\n    const cleaned = cleanRut(rut);\n\n    // Parse and validate\n    const parsed = parseRut(cleaned);\n    if (!parsed) {\n        return '';\n    }\n\n    // Validate the verification digit\n    const expectedDigit = calculateVerificationDigit(parsed.body);\n    if (parsed.verificationDigit !== expectedDigit) {\n        return '';\n    }\n\n    // Format the body\n    let formattedBody = parsed.body;\n    if (opts.dots) {\n        formattedBody = parsed.body.replace(DOTS_REGEX, '.');\n    }\n\n    // Format the verification digit\n    let dv = parsed.verificationDigit;\n    if (!opts.uppercase) {\n        dv = dv.toLowerCase();\n    }\n\n    // Combine with separator\n    const separator = opts.dash ? '-' : '';\n    return `${formattedBody}${separator}${dv}`;\n}\n\n/**\n * Formats a RUT without validation (use with caution).\n * Useful when you need to format user input as they type.\n * \n * @param rut - RUT string to format\n * @param options - Formatting options\n * @returns Formatted RUT string\n * \n * @example\n * formatRutPartial('12345')     // '12.345'\n * formatRutPartial('123456789') // '12.345.678-9'\n */\nexport function formatRutPartial(rut: string, options: FormatOptions = {}): string {\n    const opts: Required<FormatOptions> = { ...DEFAULT_OPTIONS, ...options };\n    const cleaned = cleanRut(rut);\n\n    if (cleaned.length === 0) {\n        return '';\n    }\n\n    // Separate body and potential verification digit\n    let body: string;\n    let dv: string;\n\n    if (cleaned.length > 1) {\n        // Check if last char could be a verification digit (K or any digit)\n        const lastChar = cleaned.slice(-1);\n        if (/[0-9K]/.test(lastChar)) {\n            body = cleaned.slice(0, -1);\n            dv = opts.uppercase ? lastChar : lastChar.toLowerCase();\n        } else {\n            body = cleaned;\n            dv = '';\n        }\n    } else {\n        body = cleaned;\n        dv = '';\n    }\n\n    // Format body with dots if needed\n    let formattedBody = body;\n    if (opts.dots && body.length > 0) {\n        formattedBody = body.replace(DOTS_REGEX, '.');\n    }\n\n    // Add verification digit if present\n    if (dv) {\n        const separator = opts.dash ? '-' : '';\n        return `${formattedBody}${separator}${dv}`;\n    }\n\n    return formattedBody;\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+var m=/[^0-9kK]/g;function l(t){return typeof t!="string"?"":(t.length>50&&(t=t.slice(0,50)),t.replace(m,"").toUpperCase())}function c(t){let o=[2,3,4,5,6,7],r=0,e=0;for(let a=t.length-1;a>=0;a--){let s=parseInt(t[a],10);r+=s*o[e],e=(e+1)%6;}let n=11-r%11;return n===11?"0":n===10?"K":n.toString()}function u(t){if(t.length<2)return null;let o=t.slice(-1),r=t.slice(0,-1);return !/^\d+$/.test(r)||!/^[0-9K]$/.test(o)?null:{body:r,verificationDigit:o}}var R=2,y=9;function f(t){if(!t||typeof t!="string")return {isValid:false,error:"RUT is required"};let o=l(t);if(o.length<R)return {isValid:false,error:"RUT is too short"};if(o.length>y)return {isValid:false,error:"RUT is too long"};let r=u(o);if(!r)return {isValid:false,error:"Invalid RUT format"};let e=c(r.body);return r.verificationDigit!==e?{isValid:false,error:"Invalid verification digit"}:{isValid:true,rut:o}}function T(t){return f(t).isValid}var p=/\B(?=(\d{3})+(?!\d))/g,d={dots:true,dash:true,uppercase:true};function V(t,o={}){let r={...d,...o},e=l(t),i=u(e);if(!i)return "";let n=c(i.body);if(i.verificationDigit!==n)return "";let a=i.body;r.dots&&(a=i.body.replace(p,"."));let s=i.verificationDigit;r.uppercase||(s=s.toLowerCase());let g=r.dash?"-":"";return `${a}${g}${s}`}function x(t,o={}){let r={...d,...o},e=l(t);if(e.length===0)return "";let i,n;if(e.length>1){let s=e.slice(-1);/[0-9K]/.test(s)?(i=e.slice(0,-1),n=r.uppercase?s:s.toLowerCase()):(i=e,n="");}else i=e,n="";let a=i;if(r.dots&&i.length>0&&(a=i.replace(p,".")),n){let s=r.dash?"-":"";return `${a}${s}${n}`}return a}export{c as calculateVerificationDigit,l as cleanRut,V as formatRut,x as formatRutPartial,T as isValidRut,u as parseRut,f as validateRut};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/clean.ts","../src/utils.ts","../src/validate.ts","../src/format.ts"],"names":["CLEAN_REGEX","cleanRut","input","calculateVerificationDigit","rutBody","multipliers","sum","multiplierIndex","i","digit","result","parseRut","cleanedRut","verificationDigit","body","MIN_RUT_LENGTH","MAX_RUT_LENGTH","validateRut","rut","cleaned","parsed","expectedDigit","isValidRut","DOTS_REGEX","DEFAULT_OPTIONS","formatRut","options","opts","formattedBody","dv","separator","formatRutPartial","lastChar"],"mappings":"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","file":"index.mjs","sourcesContent":["// Pre-compiled regex for maximum performance\nconst CLEAN_REGEX = /[^0-9kK]/g;\n\n// Maximum allowed input length for security (prevents DoS)\nconst MAX_INPUT_LENGTH = 50;\n\n/**\n * Cleans a RUT string by removing all non-valid characters.\n * Keeps only numbers and 'K'/'k'.\n * \n * @param input - Raw RUT input string\n * @returns Cleaned RUT string with only valid characters\n * \n * @example\n * cleanRut('12.345.678-9') // '123456789'\n * cleanRut('12345678-K') // '12345678K'\n * cleanRut('  12-345-678.9  ') // '123456789'\n */\nexport function cleanRut(input: string): string {\n    // Security: handle non-string inputs gracefully\n    if (typeof input !== 'string') {\n        return '';\n    }\n\n    // Security: prevent DoS with extremely long inputs\n    if (input.length > MAX_INPUT_LENGTH) {\n        input = input.slice(0, MAX_INPUT_LENGTH);\n    }\n\n    // Remove all non-valid characters and convert to uppercase\n    return input.replace(CLEAN_REGEX, '').toUpperCase();\n}\n","import type { ParsedRut } from './types';\n\n/**\n * Calculates the verification digit for a RUT body using Module 11 algorithm.\n * \n * @param rutBody - RUT body (numbers only, without verification digit)\n * @returns Calculated verification digit ('0'-'9' or 'K')\n */\nexport function calculateVerificationDigit(rutBody: string): string {\n    // Multiplier sequence for Module 11 algorithm\n    const multipliers = [2, 3, 4, 5, 6, 7];\n\n    let sum = 0;\n    let multiplierIndex = 0;\n\n    // Process digits from right to left\n    for (let i = rutBody.length - 1; i >= 0; i--) {\n        const digit = parseInt(rutBody[i], 10);\n        sum += digit * multipliers[multiplierIndex];\n        multiplierIndex = (multiplierIndex + 1) % 6; // Cycle through multipliers\n    }\n\n    // Calculate verification digit\n    const remainder = sum % 11;\n    const result = 11 - remainder;\n\n    // Convert result to verification digit\n    if (result === 11) return '0';\n    if (result === 10) return 'K';\n    return result.toString();\n}\n\n/**\n * Parses a cleaned RUT string into body and verification digit.\n * \n * @param cleanedRut - Cleaned RUT string (only numbers and K)\n * @returns Parsed RUT object or null if invalid format\n */\nexport function parseRut(cleanedRut: string): ParsedRut | null {\n    if (cleanedRut.length < 2) {\n        return null;\n    }\n\n    const verificationDigit = cleanedRut.slice(-1);\n    const body = cleanedRut.slice(0, -1);\n\n    // Body must contain only digits\n    if (!/^\\d+$/.test(body)) {\n        return null;\n    }\n\n    // Verification digit must be a digit or K\n    if (!/^[0-9K]$/.test(verificationDigit)) {\n        return null;\n    }\n\n    return { body, verificationDigit };\n}\n","import type { ValidationResult } from './types';\nimport { cleanRut } from './clean';\nimport { parseRut, calculateVerificationDigit } from './utils';\n\n// Minimum valid RUT (1-9)\nconst MIN_RUT_LENGTH = 2;\n// Maximum valid RUT length (including verification digit)\nconst MAX_RUT_LENGTH = 9;\n\n/**\n * Validates a Chilean RUT (Rol Único Tributario).\n * \n * Uses the official Module 11 algorithm to verify the check digit.\n * \n * @param rut - RUT string to validate (can include dots, dashes, spaces)\n * @returns Validation result with isValid flag and cleaned RUT if valid\n * \n * @example\n * validateRut('12.345.678-5') // { isValid: true, rut: '123456785' }\n * validateRut('12345678-5')   // { isValid: true, rut: '123456785' }\n * validateRut('12345678-0')   // { isValid: false, error: 'Invalid verification digit' }\n * validateRut('')             // { isValid: false, error: 'RUT is required' }\n */\nexport function validateRut(rut: string): ValidationResult {\n    // Handle empty input\n    if (!rut || typeof rut !== 'string') {\n        return { isValid: false, error: 'RUT is required' };\n    }\n\n    // Clean the RUT\n    const cleaned = cleanRut(rut);\n\n    // Check minimum length\n    if (cleaned.length < MIN_RUT_LENGTH) {\n        return { isValid: false, error: 'RUT is too short' };\n    }\n\n    // Check maximum length\n    if (cleaned.length > MAX_RUT_LENGTH) {\n        return { isValid: false, error: 'RUT is too long' };\n    }\n\n    // Parse the RUT\n    const parsed = parseRut(cleaned);\n    if (!parsed) {\n        return { isValid: false, error: 'Invalid RUT format' };\n    }\n\n    // Calculate expected verification digit\n    const expectedDigit = calculateVerificationDigit(parsed.body);\n\n    // Compare with provided verification digit\n    if (parsed.verificationDigit !== expectedDigit) {\n        return { isValid: false, error: 'Invalid verification digit' };\n    }\n\n    return { isValid: true, rut: cleaned };\n}\n\n/**\n * Simple boolean check for RUT validity.\n * \n * @param rut - RUT string to validate\n * @returns true if RUT is valid, false otherwise\n * \n * @example\n * isValidRut('12.345.678-5') // true\n * isValidRut('12345678-0')   // false\n */\nexport function isValidRut(rut: string): boolean {\n    return validateRut(rut).isValid;\n}\n","import type { FormatOptions } from './types';\nimport { cleanRut } from './clean';\nimport { parseRut, calculateVerificationDigit } from './utils';\n\n// Pre-compiled regex for adding dots\nconst DOTS_REGEX = /\\B(?=(\\d{3})+(?!\\d))/g;\n\n/**\n * Default formatting options\n */\nconst DEFAULT_OPTIONS: Required<FormatOptions> = {\n    dots: true,\n    dash: true,\n    uppercase: true,\n};\n\n/**\n * Formats a Chilean RUT with the specified options.\n * \n * By default, formats as: 12.345.678-9\n * \n * @param rut - RUT string to format (can include dots, dashes, spaces)\n * @param options - Formatting options\n * @returns Formatted RUT string, or empty string if invalid\n * \n * @example\n * formatRut('123456785')                    // '12.345.678-5'\n * formatRut('123456785', { dots: false })   // '12345678-5'\n * formatRut('123456785', { dash: false })   // '12.345.6785'\n * formatRut('12345678K', { uppercase: false }) // '12.345.678-k'\n */\nexport function formatRut(rut: string, options: FormatOptions = {}): string {\n    // Merge with defaults\n    const opts: Required<FormatOptions> = { ...DEFAULT_OPTIONS, ...options };\n\n    // Clean the RUT\n    const cleaned = cleanRut(rut);\n\n    // Parse and validate\n    const parsed = parseRut(cleaned);\n    if (!parsed) {\n        return '';\n    }\n\n    // Validate the verification digit\n    const expectedDigit = calculateVerificationDigit(parsed.body);\n    if (parsed.verificationDigit !== expectedDigit) {\n        return '';\n    }\n\n    // Format the body\n    let formattedBody = parsed.body;\n    if (opts.dots) {\n        formattedBody = parsed.body.replace(DOTS_REGEX, '.');\n    }\n\n    // Format the verification digit\n    let dv = parsed.verificationDigit;\n    if (!opts.uppercase) {\n        dv = dv.toLowerCase();\n    }\n\n    // Combine with separator\n    const separator = opts.dash ? '-' : '';\n    return `${formattedBody}${separator}${dv}`;\n}\n\n/**\n * Formats a RUT without validation (use with caution).\n * Useful when you need to format user input as they type.\n * \n * @param rut - RUT string to format\n * @param options - Formatting options\n * @returns Formatted RUT string\n * \n * @example\n * formatRutPartial('12345')     // '12.345'\n * formatRutPartial('123456789') // '12.345.678-9'\n */\nexport function formatRutPartial(rut: string, options: FormatOptions = {}): string {\n    const opts: Required<FormatOptions> = { ...DEFAULT_OPTIONS, ...options };\n    const cleaned = cleanRut(rut);\n\n    if (cleaned.length === 0) {\n        return '';\n    }\n\n    // Separate body and potential verification digit\n    let body: string;\n    let dv: string;\n\n    if (cleaned.length > 1) {\n        // Check if last char could be a verification digit (K or any digit)\n        const lastChar = cleaned.slice(-1);\n        if (/[0-9K]/.test(lastChar)) {\n            body = cleaned.slice(0, -1);\n            dv = opts.uppercase ? lastChar : lastChar.toLowerCase();\n        } else {\n            body = cleaned;\n            dv = '';\n        }\n    } else {\n        body = cleaned;\n        dv = '';\n    }\n\n    // Format body with dots if needed\n    let formattedBody = body;\n    if (opts.dots && body.length > 0) {\n        formattedBody = body.replace(DOTS_REGEX, '.');\n    }\n\n    // Add verification digit if present\n    if (dv) {\n        const separator = opts.dash ? '-' : '';\n        return `${formattedBody}${separator}${dv}`;\n    }\n\n    return formattedBody;\n}\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "chilean-rut-formatter",
+    "version": "1.0.0",
+    "description": "High-performance library for formatting and validating Chilean RUTs (Rol Único Tributario)",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.mjs",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "lint": "tsc --noEmit",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "rut",
+        "chile",
+        "chilean",
+        "rut-validator",
+        "rut-formatter",
+        "tax-id",
+        "validation"
+    ],
+    "author": "",
+    "license": "MIT",
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "typescript": "^5.3.0",
+        "vitest": "^1.2.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/your-username/chilean-rut-formatter"
+    },
+    "engines": {
+        "node": ">=16"
+    }
+}