utilitify-core 1.0.0

package/dist/security/index.d.cts

@@ -0,0 +1,216 @@
+/**
+ * Password strength result
+ */
+interface PasswordStrength {
+    /** Score from 0-4 (0 = very weak, 4 = very strong) */
+    score: 0 | 1 | 2 | 3 | 4;
+    /** Human-readable strength label */
+    label: 'very-weak' | 'weak' | 'fair' | 'strong' | 'very-strong';
+    /** Improvement suggestions */
+    suggestions: string[];
+    /** Requirements met */
+    requirements: {
+        minLength: boolean;
+        hasUppercase: boolean;
+        hasLowercase: boolean;
+        hasNumber: boolean;
+        hasSymbol: boolean;
+        noCommonPatterns: boolean;
+    };
+    /** Estimated crack time description */
+    crackTime: string;
+}
+/**
+ * Password strength options
+ */
+interface PasswordStrengthOptions {
+    /** Minimum length (default: 8) */
+    minLength?: number;
+    /** Require uppercase (default: true) */
+    requireUppercase?: boolean;
+    /** Require lowercase (default: true) */
+    requireLowercase?: boolean;
+    /** Require number (default: true) */
+    requireNumber?: boolean;
+    /** Require symbol (default: false) */
+    requireSymbol?: boolean;
+}
+/**
+ * Check password strength
+ *
+ * @param password - Password to check
+ * @param options - Strength options
+ * @returns Password strength result
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = checkPasswordStrength('MyP@ssw0rd!');
+ * console.log(result.score); // 4
+ * console.log(result.label); // 'very-strong'
+ * ```
+ */
+declare function checkPasswordStrength(password: string, options?: PasswordStrengthOptions): PasswordStrength;
+/**
+ * Check if password meets requirements
+ *
+ * @param password - Password to check
+ * @param requirements - Requirements to check
+ * @returns true if all requirements met
+ */
+declare function meetsRequirements(password: string, requirements: Partial<PasswordStrengthOptions>): boolean;
+/**
+ * Check if password is strong enough
+ *
+ * @param password - Password to check
+ * @param minScore - Minimum score (default: 3)
+ * @returns true if strong enough
+ */
+declare function isStrongPassword(password: string, minScore?: number): boolean;
+/**
+ * Get password feedback message
+ *
+ * @param password - Password to check
+ * @returns Feedback message
+ */
+declare function getPasswordFeedback(password: string): string;
+
+/**
+ * Hash a string using SHA-256
+ * Uses Web Crypto API for browser compatibility
+ *
+ * @param data - String to hash
+ * @returns SHA-256 hash as hex string
+ *
+ * @example
+ * ```typescript
+ * const hash = await hashSHA256('hello world');
+ * // 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ * ```
+ */
+declare function hashSHA256(data: string): Promise<string>;
+/**
+ * Hash a string using SHA-512
+ *
+ * @param data - String to hash
+ * @returns SHA-512 hash as hex string
+ */
+declare function hashSHA512(data: string): Promise<string>;
+/**
+ * Hash a string using MD5 (NOT SECURE - use for checksums only)
+ *
+ * @deprecated MD5 is cryptographically broken. Use SHA-256 for security-sensitive hashing.
+ * @param data - String to hash
+ * @returns MD5 hash as hex string
+ */
+declare function hashMD5(data: string): Promise<string>;
+/**
+ * Hash password using bcrypt (requires bcryptjs)
+ *
+ * @param password - Password to hash
+ * @param rounds - Salt rounds (default: 10)
+ * @returns Bcrypt hash
+ */
+declare function hashBcrypt(password: string, rounds?: number): Promise<string>;
+/**
+ * Verify password against bcrypt hash
+ *
+ * @param password - Password to verify
+ * @param hash - Bcrypt hash
+ * @returns true if password matches
+ */
+declare function verifyBcrypt(password: string, hash: string): Promise<boolean>;
+/**
+ * Hash with HMAC-SHA256
+ *
+ * @param data - Data to hash
+ * @param key - Secret key
+ * @returns HMAC hash
+ */
+declare function hmacSHA256(data: string, key: string): Promise<string>;
+/**
+ * Compare two strings in constant time (timing-safe)
+ * This prevents timing attacks that could leak information about the string contents.
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns true if equal
+ */
+declare function timingSafeCompare(a: string, b: string): boolean;
+
+/**
+ * Generate UUID v4 (random)
+ *
+ * @returns UUID v4 string
+ * @throws Error if crypto API is not available
+ *
+ * @example
+ * ```typescript
+ * generateUUID(); // '550e8400-e29b-41d4-a716-446655440000'
+ * ```
+ */
+declare function generateUUID(): string;
+/**
+ * Generate UUID v7 (time-sortable)
+ * Based on Unix Epoch timestamp
+ *
+ * @returns UUID v7 string
+ */
+declare function generateUUIDv7(): string;
+/**
+ * Generate a secure random token
+ *
+ * @param length - Token length in bytes (default: 32)
+ * @returns Hex-encoded token
+ */
+declare function generateToken(length?: number): string;
+/**
+ * Generate a cryptographically secure token
+ *
+ * @param length - Token length in bytes
+ * @returns Hex-encoded secure token
+ */
+declare function generateSecureToken(length?: number): string;
+/**
+ * Generate a Base64 encoded token
+ *
+ * @param length - Token length in bytes
+ * @returns Base64-encoded token
+ */
+declare function generateBase64Token(length?: number): string;
+/**
+ * Generate URL-safe token
+ *
+ * @param length - Token length
+ * @returns URL-safe token
+ */
+declare function generateUrlSafeToken(length?: number): string;
+/**
+ * Validate UUID format
+ *
+ * @param uuid - String to validate
+ * @returns true if valid UUID
+ */
+declare function isValidUUID(uuid: string): boolean;
+/**
+ * Extract timestamp from UUID v7
+ *
+ * @param uuid - UUID v7 string
+ * @returns Date or null
+ */
+declare function getUUIDv7Timestamp(uuid: string): Date | null;
+/**
+ * Generate short ID (8 characters)
+ *
+ * @returns Short ID
+ */
+declare function generateShortId(): string;
+/**
+ * Generate nano ID style token
+ *
+ * @param length - Length (default: 21)
+ * @returns NanoID-style token
+ */
+declare function generateNanoId(length?: number): string;
+
+export { type PasswordStrength, type PasswordStrengthOptions, checkPasswordStrength, generateBase64Token, generateNanoId, generateSecureToken, generateShortId, generateToken, generateUUID, generateUUIDv7, generateUrlSafeToken, getPasswordFeedback, getUUIDv7Timestamp, hashBcrypt, hashMD5, hashSHA256, hashSHA512, hmacSHA256, isStrongPassword, isValidUUID, meetsRequirements, timingSafeCompare, verifyBcrypt };

package/dist/security/index.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Password strength result
+ */
+interface PasswordStrength {
+    /** Score from 0-4 (0 = very weak, 4 = very strong) */
+    score: 0 | 1 | 2 | 3 | 4;
+    /** Human-readable strength label */
+    label: 'very-weak' | 'weak' | 'fair' | 'strong' | 'very-strong';
+    /** Improvement suggestions */
+    suggestions: string[];
+    /** Requirements met */
+    requirements: {
+        minLength: boolean;
+        hasUppercase: boolean;
+        hasLowercase: boolean;
+        hasNumber: boolean;
+        hasSymbol: boolean;
+        noCommonPatterns: boolean;
+    };
+    /** Estimated crack time description */
+    crackTime: string;
+}
+/**
+ * Password strength options
+ */
+interface PasswordStrengthOptions {
+    /** Minimum length (default: 8) */
+    minLength?: number;
+    /** Require uppercase (default: true) */
+    requireUppercase?: boolean;
+    /** Require lowercase (default: true) */
+    requireLowercase?: boolean;
+    /** Require number (default: true) */
+    requireNumber?: boolean;
+    /** Require symbol (default: false) */
+    requireSymbol?: boolean;
+}
+/**
+ * Check password strength
+ *
+ * @param password - Password to check
+ * @param options - Strength options
+ * @returns Password strength result
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const result = checkPasswordStrength('MyP@ssw0rd!');
+ * console.log(result.score); // 4
+ * console.log(result.label); // 'very-strong'
+ * ```
+ */
+declare function checkPasswordStrength(password: string, options?: PasswordStrengthOptions): PasswordStrength;
+/**
+ * Check if password meets requirements
+ *
+ * @param password - Password to check
+ * @param requirements - Requirements to check
+ * @returns true if all requirements met
+ */
+declare function meetsRequirements(password: string, requirements: Partial<PasswordStrengthOptions>): boolean;
+/**
+ * Check if password is strong enough
+ *
+ * @param password - Password to check
+ * @param minScore - Minimum score (default: 3)
+ * @returns true if strong enough
+ */
+declare function isStrongPassword(password: string, minScore?: number): boolean;
+/**
+ * Get password feedback message
+ *
+ * @param password - Password to check
+ * @returns Feedback message
+ */
+declare function getPasswordFeedback(password: string): string;
+
+/**
+ * Hash a string using SHA-256
+ * Uses Web Crypto API for browser compatibility
+ *
+ * @param data - String to hash
+ * @returns SHA-256 hash as hex string
+ *
+ * @example
+ * ```typescript
+ * const hash = await hashSHA256('hello world');
+ * // 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ * ```
+ */
+declare function hashSHA256(data: string): Promise<string>;
+/**
+ * Hash a string using SHA-512
+ *
+ * @param data - String to hash
+ * @returns SHA-512 hash as hex string
+ */
+declare function hashSHA512(data: string): Promise<string>;
+/**
+ * Hash a string using MD5 (NOT SECURE - use for checksums only)
+ *
+ * @deprecated MD5 is cryptographically broken. Use SHA-256 for security-sensitive hashing.
+ * @param data - String to hash
+ * @returns MD5 hash as hex string
+ */
+declare function hashMD5(data: string): Promise<string>;
+/**
+ * Hash password using bcrypt (requires bcryptjs)
+ *
+ * @param password - Password to hash
+ * @param rounds - Salt rounds (default: 10)
+ * @returns Bcrypt hash
+ */
+declare function hashBcrypt(password: string, rounds?: number): Promise<string>;
+/**
+ * Verify password against bcrypt hash
+ *
+ * @param password - Password to verify
+ * @param hash - Bcrypt hash
+ * @returns true if password matches
+ */
+declare function verifyBcrypt(password: string, hash: string): Promise<boolean>;
+/**
+ * Hash with HMAC-SHA256
+ *
+ * @param data - Data to hash
+ * @param key - Secret key
+ * @returns HMAC hash
+ */
+declare function hmacSHA256(data: string, key: string): Promise<string>;
+/**
+ * Compare two strings in constant time (timing-safe)
+ * This prevents timing attacks that could leak information about the string contents.
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns true if equal
+ */
+declare function timingSafeCompare(a: string, b: string): boolean;
+
+/**
+ * Generate UUID v4 (random)
+ *
+ * @returns UUID v4 string
+ * @throws Error if crypto API is not available
+ *
+ * @example
+ * ```typescript
+ * generateUUID(); // '550e8400-e29b-41d4-a716-446655440000'
+ * ```
+ */
+declare function generateUUID(): string;
+/**
+ * Generate UUID v7 (time-sortable)
+ * Based on Unix Epoch timestamp
+ *
+ * @returns UUID v7 string
+ */
+declare function generateUUIDv7(): string;
+/**
+ * Generate a secure random token
+ *
+ * @param length - Token length in bytes (default: 32)
+ * @returns Hex-encoded token
+ */
+declare function generateToken(length?: number): string;
+/**
+ * Generate a cryptographically secure token
+ *
+ * @param length - Token length in bytes
+ * @returns Hex-encoded secure token
+ */
+declare function generateSecureToken(length?: number): string;
+/**
+ * Generate a Base64 encoded token
+ *
+ * @param length - Token length in bytes
+ * @returns Base64-encoded token
+ */
+declare function generateBase64Token(length?: number): string;
+/**
+ * Generate URL-safe token
+ *
+ * @param length - Token length
+ * @returns URL-safe token
+ */
+declare function generateUrlSafeToken(length?: number): string;
+/**
+ * Validate UUID format
+ *
+ * @param uuid - String to validate
+ * @returns true if valid UUID
+ */
+declare function isValidUUID(uuid: string): boolean;
+/**
+ * Extract timestamp from UUID v7
+ *
+ * @param uuid - UUID v7 string
+ * @returns Date or null
+ */
+declare function getUUIDv7Timestamp(uuid: string): Date | null;
+/**
+ * Generate short ID (8 characters)
+ *
+ * @returns Short ID
+ */
+declare function generateShortId(): string;
+/**
+ * Generate nano ID style token
+ *
+ * @param length - Length (default: 21)
+ * @returns NanoID-style token
+ */
+declare function generateNanoId(length?: number): string;
+
+export { type PasswordStrength, type PasswordStrengthOptions, checkPasswordStrength, generateBase64Token, generateNanoId, generateSecureToken, generateShortId, generateToken, generateUUID, generateUUIDv7, generateUrlSafeToken, getPasswordFeedback, getUUIDv7Timestamp, hashBcrypt, hashMD5, hashSHA256, hashSHA512, hmacSHA256, isStrongPassword, isValidUUID, meetsRequirements, timingSafeCompare, verifyBcrypt };

package/dist/security/index.js

@@ -0,0 +1,5 @@
+export { checkPasswordStrength, generateBase64Token, generateNanoId, generateSecureToken, generateShortId, generateToken, generateUUID, generateUUIDv7, generateUrlSafeToken, getPasswordFeedback, getUUIDv7Timestamp, hashBcrypt, hashMD5, hashSHA256, hashSHA512, hmacSHA256, isStrongPassword, isValidUUID, meetsRequirements, timingSafeCompare, verifyBcrypt } from '../chunk-SD6P3WEJ.js';
+import '../chunk-ETWGPOPY.js';
+import '../chunk-4CV4JOE5.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/string/index.cjs

@@ -0,0 +1,153 @@
+'use strict';
+
+var chunkC75J62CV_cjs = require('../chunk-C75J62CV.cjs');
+require('../chunk-CZLDE2OZ.cjs');
+
+
+
+Object.defineProperty(exports, "capitalize", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.capitalize; }
+});
+Object.defineProperty(exports, "ellipsis", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.ellipsis; }
+});
+Object.defineProperty(exports, "generateBase64String", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generateBase64String; }
+});
+Object.defineProperty(exports, "generateHexString", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generateHexString; }
+});
+Object.defineProperty(exports, "generateOTP", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generateOTP; }
+});
+Object.defineProperty(exports, "generatePassphrase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generatePassphrase; }
+});
+Object.defineProperty(exports, "generatePassword", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generatePassword; }
+});
+Object.defineProperty(exports, "generateRandomString", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generateRandomString; }
+});
+Object.defineProperty(exports, "generateUrlSafeString", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.generateUrlSafeString; }
+});
+Object.defineProperty(exports, "isValidSlug", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.isValidSlug; }
+});
+Object.defineProperty(exports, "maskCreditCard", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.maskCreditCard; }
+});
+Object.defineProperty(exports, "maskEmail", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.maskEmail; }
+});
+Object.defineProperty(exports, "maskIP", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.maskIP; }
+});
+Object.defineProperty(exports, "maskName", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.maskName; }
+});
+Object.defineProperty(exports, "maskPhone", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.maskPhone; }
+});
+Object.defineProperty(exports, "maskString", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.maskString; }
+});
+Object.defineProperty(exports, "needsTruncation", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.needsTruncation; }
+});
+Object.defineProperty(exports, "slugify", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.slugify; }
+});
+Object.defineProperty(exports, "swapCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.swapCase; }
+});
+Object.defineProperty(exports, "toCamelCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toCamelCase; }
+});
+Object.defineProperty(exports, "toConstantCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toConstantCase; }
+});
+Object.defineProperty(exports, "toDotCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toDotCase; }
+});
+Object.defineProperty(exports, "toKebabCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toKebabCase; }
+});
+Object.defineProperty(exports, "toPascalCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toPascalCase; }
+});
+Object.defineProperty(exports, "toSentenceCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toSentenceCase; }
+});
+Object.defineProperty(exports, "toSlug", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toSlug; }
+});
+Object.defineProperty(exports, "toSnakeCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toSnakeCase; }
+});
+Object.defineProperty(exports, "toTitleCase", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.toTitleCase; }
+});
+Object.defineProperty(exports, "transliterate", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.transliterate; }
+});
+Object.defineProperty(exports, "truncate", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.truncate; }
+});
+Object.defineProperty(exports, "truncateFilename", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.truncateFilename; }
+});
+Object.defineProperty(exports, "truncateHtml", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.truncateHtml; }
+});
+Object.defineProperty(exports, "truncateSentences", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.truncateSentences; }
+});
+Object.defineProperty(exports, "truncateWords", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.truncateWords; }
+});
+Object.defineProperty(exports, "uncapitalize", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.uncapitalize; }
+});
+Object.defineProperty(exports, "uniqueSlug", {
+  enumerable: true,
+  get: function () { return chunkC75J62CV_cjs.uniqueSlug; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/string/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}