MicProtocol / packages /ui /src /security.ts
Benaah's picture
Upload folder using huggingface_hub
43842af verified
Raw History Blame Contribute Delete
5.14 kB
/**
* ─── MicProtocol Input Security & Attack Immunity Suite ─────────
* Defense-in-depth sanitization, boundary enforcement, and injection
* prevention for all form and input components across web & mobile.
*/
export const SAFE_MAX_LENGTHS = {
email: 254, // RFC 5321 limit
password: 128, // Prevents bcrypt / argon2 DoS via long inputs
name: 100,
title: 200,
url: 2048, // Maximum safe URL length
search: 120, // Prevents Meilisearch / DB algorithmic complexity DoS
phone: 32,
shortText: 255,
longText: 5000,
code: 64,
} as const;
/**
* Regex to detect dangerous Trojan Source Unicode Bidirectional control characters.
* U+202A to U+202E (LRE, RLE, PDF, LRO, RLO)
* U+2066 to U+2069 (LRI, RLI, FSI, PDI)
* U+200E, U+200F (LRM, RLM)
* U+061C (ALM), U+FEFF (BOM)
*/
const BIDI_REGEX = /[\u202A-\u202E\u2066-\u2069\u200E\u200F\u061C\uFEFF]/g;
/**
* Regex to detect raw ASCII control characters (0x00-0x08, 0x0B, 0x0C, 0x0E-0x1F, 0x7F).
* Null byte \0 is explicitly targeted to prevent null byte injection and path traversal.
*/
const CONTROL_CHARS_REGEX = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
/**
* Regex for script tags, javascript: pseudo-protocols, and inline event handlers.
*/
const DANGEROUS_HTML_REGEX = /<\s*script[^>]*>.*?<\s*\/\s*script\s*>|<\s*script[^>]*>|javascript:|vbscript:|data:text\/html|on\w+\s*=/gi;
export interface SanitizeOptions {
maxLength?: number;
allowNewlines?: boolean;
trim?: boolean;
stripHtml?: boolean;
}
/**
* Sanitizes generic user input:
* 1. Strips null bytes (\0) and invisible control characters.
* 2. Neutralizes Trojan Source BiDi override attacks.
* 3. Strips script tags, javascript: pseudo-protocols, and inline events.
* 4. Enforces max length boundaries.
*/
export function sanitizeText(input: unknown, options: SanitizeOptions = {}): string {
if (input == null) return "";
let str = String(input);
// 1. Strip null bytes & control chars
str = str.replace(CONTROL_CHARS_REGEX, "");
// 2. Strip BiDi overrides
str = str.replace(BIDI_REGEX, "");
// 3. Strip dangerous scripts & event handlers
str = str.replace(DANGEROUS_HTML_REGEX, "");
// 4. Handle newlines
if (!options.allowNewlines) {
str = str.replace(/[\r\n]+/g, " ");
}
// 5. Trim if requested
if (options.trim !== false) {
str = str.trim();
}
// 6. Enforce max length
const max = options.maxLength ?? SAFE_MAX_LENGTHS.shortText;
if (str.length > max) {
str = str.slice(0, max);
}
return str;
}
/**
* Sanitizes and validates email addresses against RFC limits:
* - Trims whitespace
* - Enforces max length of 254 characters (RFC 5321)
* - Converts to lower-case
* - Strips control characters and quotes
*/
export function sanitizeEmail(email: unknown): string {
if (email == null) return "";
let str = String(email).replace(CONTROL_CHARS_REGEX, "").replace(BIDI_REGEX, "").trim();
if (str.length > SAFE_MAX_LENGTHS.email) {
str = str.slice(0, SAFE_MAX_LENGTHS.email);
}
return str.toLowerCase();
}
/**
* Strict URL sanitization:
* Only permits http:, https:, mailto:, and tel: protocols.
* Explicitly rejects javascript:, data:, blob:, file:, and invalid URI formats.
*/
export function sanitizeUrl(url: unknown): string {
if (url == null) return "";
let str = String(url).replace(CONTROL_CHARS_REGEX, "").replace(BIDI_REGEX, "").trim();
if (str.length > SAFE_MAX_LENGTHS.url) {
str = str.slice(0, SAFE_MAX_LENGTHS.url);
}
// Reject javascript:, data:, vbscript:
const lower = str.toLowerCase();
if (
lower.startsWith("javascript:") ||
lower.startsWith("vbscript:") ||
lower.startsWith("data:") ||
lower.startsWith("blob:") ||
lower.startsWith("file:")
) {
return "";
}
return str;
}
/**
* Detects common malicious injection signatures for early warning/blocking:
* - SQL Injection (UNION SELECT, OR 1=1, DROP TABLE, --)
* - Path traversal (../, ..\)
* - Prototype pollution (__proto__, constructor.prototype)
* - XSS patterns
*/
export function detectMaliciousPayload(input: string): { isMalicious: boolean; reason?: string } {
if (!input) return { isMalicious: false };
// Prototype pollution
if (/__proto__|constructor\s*\[\s*['"]prototype['"]\s*\]/i.test(input)) {
return { isMalicious: true, reason: "Prototype pollution pattern detected" };
}
// Path traversal
if (/\.\.[\/\\]/.test(input)) {
return { isMalicious: true, reason: "Path traversal pattern detected" };
}
// Common SQL injection meta-patterns
const sqlPatterns = [
/\bunion\s+(all\s+)?select\b/i,
/\bdrop\s+table\b/i,
/;\s*select\b/i,
/;\s*delete\s+from\b/i,
/;\s*update\s+\w+\s+set\b/i,
/['"]\s*or\s+['"]?1['"]?\s*=\s*['"]?1/i,
];
for (const pattern of sqlPatterns) {
if (pattern.test(input)) {
return { isMalicious: true, reason: "SQL injection pattern detected" };
}
}
// Script injection
if (/<script|javascript:|onerror\s*=/i.test(input)) {
return { isMalicious: true, reason: "Script injection pattern detected" };
}
return { isMalicious: false };
}