inputs-sanitize 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joan Lozano
+
+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,423 @@
+# inputs-sanitize 🛡️
+
+A lightweight, zero-dependency utility to sanitize and filter input strings. Perfect for React, Vue, Angular, Svelte and other JavaScript/TypeScript frameworks.
+
+**Supports both CommonJS and ES Modules (ESM)** for maximum compatibility with npm, yarn, and pnpm.
+
+## Features
+
+- ✅ **Multiple sanitization modes** (text, numbers, alphanumeric, safe)
+- ✅ **TypeScript support** with full type definitions
+- ✅ **Framework agnostic** - works with React, Vue, Angular, Svelte, etc.
+- ✅ **Dual module support** - CommonJS & ESM
+- ✅ **Zero dependencies**
+- ✅ **Small bundle size** (~1KB minified)
+
+## Installation
+
+```bash
+# using npm
+npm install inputs-sanitize
+
+# using yarn
+yarn add inputs-sanitize
+
+# using pnpm
+pnpm add inputs-sanitize
+```
+
+## API
+
+### `sanitize(value: string, mode?: SanitizeMode, options?: NumberOptions): string`
+
+Sanitizes input strings based on the specified mode.
+
+#### SanitizeMode Types
+
+**`"text"`** - Letras con acentos, espacios, puntos y comas
+- ✓ Permite: `a-z`, `A-Z`, `áéíóúÁÉÍÓÚñÑ`, espacios, `.`, `,`
+- ✗ Elimina: números, caracteres especiales
+- **Uso:** Nombres, direcciones, descripciones
+- **Ejemplo:** `"José María, México."` → `"José María, México."`
+
+**`"numbers"`** - Solo números con soporte decimal y negativo opcional
+- ✓ Permite: `0-9`, `.` (decimal si `allowDecimal=true`), `-` (negativo si `allowNegative=true`)
+- ✗ Elimina: letras, caracteres especiales
+- **Opciones:** `allowDecimal` (default: true), `allowNegative` (default: true)
+- **Uso:** Precios, cantidades, edades, códigos numéricos
+- **Ejemplo:** 
+  - `"$99.99"` → `"99.99"`
+  - `"-42.5"` (con opciones) → `"-42.5"`
+  - `"-42.5"` (sin negativos) → `"42.5"`
+
+**`"alphanumeric"`** - Combinación de TEXT + NUMBERS
+- ✓ Permite: `a-z`, `A-Z`, `áéíóúÁÉÍÓÚñÑ`, `0-9`, espacios, `.`, `,`
+- ✗ Elimina: caracteres especiales (@ ! # $ % etc.)
+- **Uso:** Direcciones con números, nombres con códigos, descripciones con valores
+- **Ejemplo:** `"Calle 123, Apto 45, México."` → `"Calle 123, Apto 45, México."`
+
+**`"safe"`** - Solo letras, números y espacios (sin acentos)
+- ✓ Permite: `a-z`, `A-Z`, `0-9`, espacios
+- ✗ Elimina: acentos, puntos, comas, caracteres especiales
+- **Uso:** Usernames, códigos, referencias
+- **Ejemplo:** `"josé_user@123"` → `"jos user123"`
+
+**`"all"`** - Sin cambios (valor por defecto)
+- ✓ Permite: Todo
+- **Uso:** Cuando no necesitas filtrado
+- **Ejemplo:** `"José: $123.45!"` → `"José: $123.45!"`
+
+#### NumberOptions
+
+```typescript
+interface NumberOptions {
+  allowDecimal?: boolean;    // default: true
+  allowNegative?: boolean;   // default: true
+}
+```
+
+Estas opciones **solo aplican al modo `"numbers"`**:
+
+- **`allowDecimal`**: Permite caracteres de punto (`.`) para números decimales
+  - `true` (default): `"99.99"` es válido
+  - `false`: `"99.99"` → `"9999"`
+
+- **`allowNegative`**: Permite caracteres de guion (`-`) para números negativos
+  - `true` (default): `"-42"` es válido
+  - `false`: `"-42"` → `"42"`
+
+### Input Type Handling
+
+La función maneja automáticamente diferentes tipos de entrada:
+
+| Input | Tipo | Comportamiento |
+|-------|------|----------------|
+| `"José María"` | string | ✅ Se sanitiza normalmente |
+| `123` | number | ✅ Se convierte a string |
+| `null` | null | ✅ Devuelve `""` (vacío) |
+| `undefined` | undefined | ✅ Devuelve `""` (vacío) |
+| `[1, 2, 3]` | array | ✅ Rechaza, devuelve `""` |
+| `{name: 'José'}` | object | ✅ Rechaza, devuelve `""` |
+| `() => {}` | function | ✅ Rechaza, devuelve `""` |
+
+**Notas importantes:**
+- ✅ Solo acepta `string` y `number` como valores válidos
+- ✅ Automáticamente trimea espacios en blanco
+- ✅ Rechaza objetos, arrays y funciones (devuelve vacío en lugar de error)
+- ✅ Nunca lanza excepciones
+
+## Usage Examples
+
+### React
+
+```jsx
+import { sanitize } from 'inputs-sanitize';
+import { useState } from 'react';
+
+export default function MyComponent() {
+  const [email, setEmail] = useState('');
+  const [username, setUsername] = useState('');
+
+  const handleEmailChange = (e) => {
+    const sanitized = sanitize(e.target.value, 'safe');
+    setEmail(sanitized);
+  };
+
+  const handleUsernameChange = (e) => {
+    const sanitized = sanitize(e.target.value, 'alphanumeric');
+    setUsername(sanitized);
+  };
+
+  return (
+    <div>
+      <input
+        type="email"
+        value={email}
+        onChange={handleEmailChange}
+        placeholder="Email"
+      />
+      <input
+        type="text"
+        value={username}
+        onChange={handleUsernameChange}
+        placeholder="Username"
+      />
+    </div>
+  );
+}
+```
+
+### Vue 3
+
+```vue
+<template>
+  <div>
+    <input 
+      v-model="email"
+      @input="email = sanitize($event.target.value, 'safe')"
+      type="email"
+      placeholder="Email"
+    />
+    <input
+      v-model="amount"
+      @input="amount = sanitize($event.target.value, 'numbers', { allowDecimal: true })"
+      type="number"
+      placeholder="Amount"
+    />
+  </div>
+</template>
+
+<script setup>
+import { ref } from 'vue';
+import { sanitize } from 'inputs-sanitize';
+
+const email = ref('');
+const amount = ref('');
+</script>
+```
+
+### Vue 2
+
+```vue
+<template>
+  <div>
+    <input 
+      v-model="name"
+      @input="handleNameChange"
+      type="text"
+      placeholder="Full Name"
+    />
+    <input
+      v-model="phone"
+      @input="handlePhoneChange"
+      type="tel"
+      placeholder="Phone (numbers only)"
+    />
+  </div>
+</template>
+
+<script>
+import { sanitize } from 'inputs-sanitize';
+
+export default {
+  data() {
+    return {
+      name: '',
+      phone: ''
+    };
+  },
+  methods: {
+    handleNameChange() {
+      this.name = sanitize(this.name, 'text');
+    },
+    handlePhoneChange() {
+      this.phone = sanitize(this.phone, 'numbers', { allowNegative: false });
+    }
+  }
+};
+</script>
+```
+
+### Vanilla JavaScript
+
+```javascript
+import { sanitize } from 'inputs-sanitize';
+
+// CommonJS
+// const { sanitize } = require('inputs-sanitize');
+
+const input = document.getElementById('myInput');
+input.addEventListener('input', (e) => {
+  e.target.value = sanitize(e.target.value, 'alphanumeric');
+});
+```
+
+## Examples by Mode
+
+### Text Mode
+
+```typescript
+import { sanitize } from 'inputs-sanitize';
+
+// Permitir: letras (acentos), espacios, puntos, comas
+// Eliminar: números, caracteres especiales
+
+sanitize('José María, México 123!', 'text');
+// → "José María, México "
+
+sanitize('Dr. Juan Pérez, Médico.', 'text');
+// → "Dr. Juan Pérez, Médico."
+```
+
+### Numbers Mode
+
+```typescript
+// Permitir: números, decimales (opcional), negativos (opcional)
+// Eliminar: letras, caracteres especiales
+
+// Con decimales y negativos (default)
+sanitize('Price: $99.99', 'numbers');
+// → "99.99"
+
+sanitize('Temperature: -15.5°C', 'numbers');
+// → "-15.5"
+
+// Sin decimales
+sanitize('$99.99', 'numbers', { allowDecimal: false });
+// → "9999"
+
+// Sin negativos
+sanitize('-42.5', 'numbers', { allowNegative: false });
+// → "42.5"
+
+// Sin ambos
+sanitize('-$99.99', 'numbers', { allowDecimal: false, allowNegative: false });
+// → "9999"
+```
+
+### Alphanumeric Mode
+
+```typescript
+// Permitir: letras (acentos), números, espacios, puntos, comas
+// Eliminar: caracteres especiales (@!#$%^&*)
+
+sanitize('Calle Principal 123, Apto 4A.', 'alphanumeric');
+// → "Calle Principal 123, Apto 4A."
+
+sanitize('José María: $123.45 @user!', 'alphanumeric');
+// → "José María 123.45 user"
+
+sanitize('Order #12345, Amount: $99.99, Client: María-José', 'alphanumeric');
+// → "Order 12345, Amount 99.99, Client MaríaJosé"
+```
+
+### Safe Mode
+
+```typescript
+// Permitir: letras (sin acentos), números, espacios
+// Eliminar: acentos, puntos, comas, caracteres especiales
+
+sanitize('<script>alert("xss")</script>', 'safe');
+// → "scriptalertxssscript"
+
+sanitize('user@email.com', 'safe');
+// → "useremailcom"
+
+sanitize('José_123@domain', 'safe');
+// → "Jos 123domain"
+```
+
+### All Mode
+
+```typescript
+// Permitir: todo (sin cambios)
+
+sanitize('José María: $123.45 @user!', 'all');
+// → "José María: $123.45 @user!"
+
+sanitize('<script>dangerous</script>', 'all');
+// → "<script>dangerous</script>"
+```
+
+## Comparison Table
+
+### Character Support by Mode
+
+| Carácter | text | numbers | alphanumeric | safe | all |
+|----------|------|---------|--------------|------|-----|
+| **Letras** (a-z, A-Z) | ✓ | ✗ | ✓ | ✓ | ✓ |
+| **Acentuadas** (á, é, í, ó, ú, ñ) | ✓ | ✗ | ✓ | ✗ | ✓ |
+| **Números** (0-9) | ✗ | ✓ | ✓ | ✓ | ✓ |
+| **Punto** (.) | ✓ | ✓* | ✓ | ✗ | ✓ |
+| **Coma** (,) | ✓ | ✗ | ✓ | ✗ | ✓ |
+| **Guion** (-) | ✗ | ✓* | ✗ | ✗ | ✓ |
+| **Espacio** | ✓ | ✗ | ✓ | ✓ | ✓ |
+| **Especiales** (@!#$%^&*) | ✗ | ✗ | ✗ | ✗ | ✓ |
+
+*`numbers mode`: punto (.) = decimal si `allowDecimal=true`, guion (-) = negativo si `allowNegative=true`
+
+## Framework Integration
+
+### TypeScript with React
+
+```typescript
+import { sanitize, SanitizeMode } from 'inputs-sanitize';
+import { ChangeEvent, useState } from 'react';
+
+interface FormData {
+  username: string;
+  amount: string;
+  description: string;
+}
+
+export function MyForm() {
+  const [data, setData] = useState<FormData>({
+    username: '',
+    amount: '',
+    description: ''
+  });
+
+  const handleChange = (
+    e: ChangeEvent<HTMLInputElement>,
+    mode: SanitizeMode
+  ) => {
+    const { name, value } = e.target;
+    setData(prev => ({
+      ...prev,
+      [name]: sanitize(value, mode)
+    }));
+  };
+
+  return (
+    <form>
+      <input
+        name="username"
+        value={data.username}
+        onChange={(e) => handleChange(e, 'alphanumeric')}
+        placeholder="Username"
+      />
+      <input
+        name="amount"
+        value={data.amount}
+        onChange={(e) => handleChange(e, 'numbers')}
+        placeholder="Amount"
+      />
+      <textarea
+        name="description"
+        value={data.description}
+        onChange={(e) => 
+          setData(prev => ({
+            ...prev,
+            description: sanitize(e.target.value, 'safe')
+          }))
+        }
+        placeholder="Description"
+      />
+    </form>
+  );
+}
+```
+
+## Package Compatibility
+
+| Package Manager | Support |
+|-----------------|---------|
+| npm             | ✅ Yes  |
+| yarn            | ✅ Yes  |
+| pnpm            | ✅ Yes  |
+| Node.js         | ✅ 14+  |
+| Browser ES2020+ | ✅ Yes  |
+
+## Module Formats
+
+This package supports both module formats:
+
+- **CommonJS** (`dist/cjs/index.js`) - for Node.js and older build tools
+- **ESM** (`dist/esm/index.js`) - for modern applications and bundlers
+
+The correct format is automatically selected based on your environment.
+
+## License
+
+MIT
+

package/dist/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export { sanitize } from "./sanitize";
+export type { SanitizeMode, NumberOptions } from "./sanitize";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitize = void 0;
+var sanitize_1 = require("./sanitize");
+Object.defineProperty(exports, "sanitize", { enumerable: true, get: function () { return sanitize_1.sanitize; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA"}

package/dist/cjs/sanitize.d.ts

@@ -0,0 +1,7 @@
+export type SanitizeMode = "text" | "numbers" | "alphanumeric" | "safe" | "all";
+export interface NumberOptions {
+    allowDecimal?: boolean;
+    allowNegative?: boolean;
+}
+export declare function sanitize(value: string | number | null | undefined | any, mode?: SanitizeMode, options?: NumberOptions): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/cjs/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAClB,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CACpB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,EAC/C,IAAI,GAAE,YAAoB,EAC1B,OAAO,GAAE,aAAkB,GAC5B,MAAM,CA8DR"}

package/dist/cjs/sanitize.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitize = sanitize;
+function sanitize(value, mode = "all", options = {}) {
+    // Rechazar valores null y undefined
+    if (value === null || value === undefined) {
+        return "";
+    }
+    // Solo aceptar string y number
+    // Rechazar objetos, arrays, funciones, símbolos, etc.
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        return "";
+    }
+    // Convertir a string
+    let stringValue = String(value).trim();
+    if (!stringValue)
+        return "";
+    switch (mode) {
+        case "text":
+            return stringValue.replace(/[^a-zA-ZáéíóúÁÉÍÓÚñÑ\s.,]/g, "");
+        case "numbers": {
+            const { allowDecimal = true, allowNegative = true } = options;
+            let result = stringValue;
+            // quitar notación científica
+            result = result.replace(/[eE]/g, "");
+            // solo números básicos
+            result = result.replace(/[^0-9.\-]/g, "");
+            if (!allowDecimal) {
+                result = result.replace(/\./g, "");
+            }
+            else {
+                const parts = result.split(".");
+                if (parts.length > 2) {
+                    result = parts[0] + "." + parts.slice(1).join("");
+                }
+            }
+            if (!allowNegative) {
+                result = result.replace(/-/g, "");
+            }
+            else {
+                result = result.replace(/(?!^)-/g, "");
+            }
+            return result;
+        }
+        case "alphanumeric":
+            // Combina text + numbers: letras (con acentos), números, espacios, puntos, comas
+            return stringValue.replace(/[^a-zA-ZáéíóúÁÉÍÓÚñÑ0-9\s.,]/g, "");
+        case "safe":
+            // Solo letras, números y espacios
+            return stringValue.replace(/[^a-zA-Z0-9\s]/g, "");
+        case "all":
+        default:
+            return stringValue;
+    }
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/cjs/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/sanitize.ts"],"names":[],"mappings":";;AAYA,4BAkEC;AAlED,SAAgB,QAAQ,CACpB,KAA+C,EAC/C,OAAqB,KAAK,EAC1B,UAAyB,EAAE;IAE3B,oCAAoC;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,sDAAsD;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,EAAE,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,IAAI,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5B,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,MAAM;YACP,OAAO,WAAW,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;QAEjE,KAAK,SAAS,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YAE9D,IAAI,MAAM,GAAG,WAAW,CAAC;YAEzB,6BAA6B;YAC7B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAErC,uBAAuB;YACvB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtD,CAAC;YACL,CAAC;YAED,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,KAAK,cAAc;YACf,iFAAiF;YACjF,OAAO,WAAW,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;QAEpE,KAAK,MAAM;YACP,kCAAkC;YAClC,OAAO,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAEtD,KAAK,KAAK,CAAC;QACX;YACI,OAAO,WAAW,CAAC;IAC3B,CAAC;AACL,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+export { sanitize } from "./sanitize";
+export type { SanitizeMode, NumberOptions } from "./sanitize";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export { sanitize } from "./sanitize";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/sanitize.d.ts

@@ -0,0 +1,7 @@
+export type SanitizeMode = "text" | "numbers" | "alphanumeric" | "safe" | "all";
+export interface NumberOptions {
+    allowDecimal?: boolean;
+    allowNegative?: boolean;
+}
+export declare function sanitize(value: string | number | null | undefined | any, mode?: SanitizeMode, options?: NumberOptions): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/esm/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAClB,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CACpB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,EAC/C,IAAI,GAAE,YAAoB,EAC1B,OAAO,GAAE,aAAkB,GAC5B,MAAM,CA8DR"}

package/dist/esm/sanitize.js

@@ -0,0 +1,53 @@
+export function sanitize(value, mode = "all", options = {}) {
+    // Rechazar valores null y undefined
+    if (value === null || value === undefined) {
+        return "";
+    }
+    // Solo aceptar string y number
+    // Rechazar objetos, arrays, funciones, símbolos, etc.
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        return "";
+    }
+    // Convertir a string
+    let stringValue = String(value).trim();
+    if (!stringValue)
+        return "";
+    switch (mode) {
+        case "text":
+            return stringValue.replace(/[^a-zA-ZáéíóúÁÉÍÓÚñÑ\s.,]/g, "");
+        case "numbers": {
+            const { allowDecimal = true, allowNegative = true } = options;
+            let result = stringValue;
+            // quitar notación científica
+            result = result.replace(/[eE]/g, "");
+            // solo números básicos
+            result = result.replace(/[^0-9.\-]/g, "");
+            if (!allowDecimal) {
+                result = result.replace(/\./g, "");
+            }
+            else {
+                const parts = result.split(".");
+                if (parts.length > 2) {
+                    result = parts[0] + "." + parts.slice(1).join("");
+                }
+            }
+            if (!allowNegative) {
+                result = result.replace(/-/g, "");
+            }
+            else {
+                result = result.replace(/(?!^)-/g, "");
+            }
+            return result;
+        }
+        case "alphanumeric":
+            // Combina text + numbers: letras (con acentos), números, espacios, puntos, comas
+            return stringValue.replace(/[^a-zA-ZáéíóúÁÉÍÓÚñÑ0-9\s.,]/g, "");
+        case "safe":
+            // Solo letras, números y espacios
+            return stringValue.replace(/[^a-zA-Z0-9\s]/g, "");
+        case "all":
+        default:
+            return stringValue;
+    }
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/esm/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/sanitize.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,QAAQ,CACpB,KAA+C,EAC/C,OAAqB,KAAK,EAC1B,UAAyB,EAAE;IAE3B,oCAAoC;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,sDAAsD;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,EAAE,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,IAAI,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAE5B,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,MAAM;YACP,OAAO,WAAW,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;QAEjE,KAAK,SAAS,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YAE9D,IAAI,MAAM,GAAG,WAAW,CAAC;YAEzB,6BAA6B;YAC7B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAErC,uBAAuB;YACvB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtD,CAAC;YACL,CAAC;YAED,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,KAAK,cAAc;YACf,iFAAiF;YACjF,OAAO,WAAW,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;QAEpE,KAAK,MAAM;YACP,kCAAkC;YAClC,OAAO,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAEtD,KAAK,KAAK,CAAC;QACX;YACI,OAAO,WAAW,CAAC;IAC3B,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "inputs-sanitize",
+  "version": "1.0.0",
+  "description": "Lightweight utility to sanitize and filter input strings for React, Vue and other frameworks",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/esm/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:cjs": "tsc --module commonjs --outDir dist/cjs",
+    "build:esm": "tsc --module esnext --outDir dist/esm",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "sanitize",
+    "input",
+    "validation",
+    "filter",
+    "react",
+    "vue",
+    "angular",
+    "svelte"
+  ],
+  "author": "Joan Lozano",
+  "license": "MIT",
+  "packageManager": "pnpm@10.15.0",
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}