@rtorcato/js-common 2.8.2 → 3.0.0

package/dist/cli/cli.mjs

@@ -7,6 +7,7 @@ import gradient from 'gradient-string';
 import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { functionCategories } from './catalog.js';
 // Get current directory
 const currentDir = dirname(fileURLToPath(import.meta.url));
 // Get package version
@@ -15,62 +16,6 @@ program
     .name('js-common')
     .description(chalk.cyan('✨ CLI utilities from @rtorcato/js-common'))
     .version(packageJson.version);
-// Function categories for list and interactive mode
-const functionCategories = {
-    date: {
-        name: '📅 Date & Time',
-        functions: [
-            { name: 'today', description: "Get today's date (YYYY-MM-DD)" },
-            { name: 'now', description: 'Get current timestamp' },
-            { name: 'between', description: 'Calculate days between dates' },
-        ],
-    },
-    math: {
-        name: '🔢 Mathematical',
-        functions: [
-            { name: 'sum', description: 'Calculate sum of numbers' },
-            { name: 'avg', description: 'Calculate average of numbers' },
-            { name: 'random', description: 'Generate random number' },
-            { name: 'round', description: 'Round to decimal places' },
-            { name: 'clamp', description: 'Clamp between min/max' },
-        ],
-    },
-    text: {
-        name: '📝 Text Formatting',
-        functions: [
-            { name: 'capitalize', description: 'Capitalize first letter' },
-            { name: 'title', description: 'Convert to title case' },
-            { name: 'pad', description: 'Pad with leading zeros' },
-        ],
-    },
-    file: {
-        name: '📁 File Operations',
-        functions: [
-            { name: 'exists', description: 'Check if file exists' },
-            { name: 'ext', description: 'Get file extension' },
-        ],
-    },
-    security: {
-        name: '🔒 Security',
-        functions: [
-            { name: 'password', description: 'Check password strength' },
-            { name: 'token', description: 'Generate secure token' },
-        ],
-    },
-    validate: {
-        name: '✅ Validation',
-        functions: [{ name: 'url', description: 'Validate URL format' }],
-    },
-    system: {
-        name: '💻 System Info',
-        functions: [
-            { name: 'pid', description: 'Get process ID' },
-            { name: 'uptime', description: 'Get process uptime' },
-            { name: 'ci', description: 'Check CI environment' },
-            { name: 'node-version', description: 'Get Node.js version' },
-        ],
-    },
-};
 // List all functions - add as a separate command
 program
     .command('list')
@@ -212,7 +157,7 @@ program
             message: chalk.cyan(`Select ${selectedCategory.name} functions to add:`),
             choices: selectedCategory.functions.map((func) => ({
                 name: `${func.name} - ${func.description}`,
-                value: func.name,
+                value: func,
                 checked: false,
             })),
             pageSize: 10,
@@ -222,20 +167,25 @@ program
             console.log(chalk.yellow('\n📝 No functions selected. Exiting...\n'));
             return;
         }
+        // A category can span several modules (math → numbers + random), so
+        // group by subpath and print one import per module.
+        const bySubpath = new Map();
+        for (const func of functions) {
+            bySubpath.set(func.subpath, [...(bySubpath.get(func.subpath) ?? []), func.exportName]);
+        }
         console.log(chalk.green('\n📦 Import Statement:'));
-        console.log(chalk.white(`import { ${functions.join(', ')} } from '@rtorcato/js-common/${category}'`));
+        for (const [subpath, exportNames] of bySubpath) {
+            console.log(chalk.white(`import { ${exportNames.join(', ')} } from '@rtorcato/js-common/${subpath}'`));
+        }
         console.log(chalk.green('\n📝 Usage Examples:'));
-        functions.forEach((func) => {
-            const funcInfo = selectedCategory.functions.find((f) => f.name === func);
-            if (funcInfo) {
-                console.log(chalk.gray(`\n// ${funcInfo.description}`));
-                generateUsageExample(category, func);
-            }
-        });
+        for (const func of functions) {
+            console.log(chalk.gray(`\n// ${func.description}`));
+            console.log(chalk.white(func.example));
+        }
         console.log(chalk.green('\n📚 Documentation:'));
         console.log(chalk.blue(`https://github.com/rtorcato/js-common#${category}-utilities`));
         console.log(chalk.yellow('\n💡 Tip: Run ') +
-            chalk.green(`js-common ${category} ${functions[0]} --help`) +
+            chalk.green(`js-common ${category} ${functions[0]?.name} --help`) +
             chalk.yellow(' for detailed CLI usage\n'));
     }
     catch (error) {
@@ -248,49 +198,6 @@ program
         process.exit(1);
     }
 });
-// Helper function to generate usage examples
-function generateUsageExample(category, functionName) {
-    const examples = {
-        date: {
-            today: `const today = today(); // "${new Date().toISOString().split('T')[0]}"`,
-            now: `const timestamp = now(); // ${Date.now()}`,
-            between: `const days = daysBetween('2023-01-01', '2023-12-31'); // 364`,
-        },
-        math: {
-            sum: `const total = sum([1, 2, 3, 4, 5]); // 15`,
-            avg: `const average = avg([10, 20, 30]); // 20`,
-            random: `const num = randomBetween(1, 100); // 42`,
-            round: `const rounded = roundTo(3.14159, 2); // 3.14`,
-            clamp: `const clamped = clamp(150, 0, 100); // 100`,
-        },
-        text: {
-            capitalize: `const text = capitalize('hello world'); // "Hello world"`,
-            title: `const title = toTitleCase('hello world'); // "Hello World"`,
-            pad: `const padded = padWithZeros(42, 5); // "00042"`,
-        },
-        file: {
-            exists: `const exists = await fileExists('package.json'); // true`,
-            ext: `const extension = getFileExtension('file.txt'); // "txt"`,
-        },
-        security: {
-            password: `const isStrong = checkPasswordStrength('MyPass123!'); // true`,
-            token: `const token = generateSecureToken(32); // "abc123..."`,
-        },
-        validate: {
-            url: `const isValid = isValidUrl('https://example.com'); // true`,
-        },
-        system: {
-            pid: `const processId = getProcessId(); // 12345`,
-            uptime: `const uptime = getProcessUptime(); // 123.45`,
-            ci: `const isCI = isCiEnvironment(); // false`,
-            'node-version': `const version = getNodeVersion(); // "18.17.0"`,
-        },
-    };
-    const example = examples[category]?.[functionName];
-    if (example) {
-        console.log(chalk.white(example));
-    }
-}
 // Date commands
 const dateCmd = program.command('date').description('📅 Date and time utilities');
 dateCmd

package/dist/colors/index.d.ts

@@ -1,11 +1,24 @@
 /**
  * Generates a random hex color string.
  *
+ * @example
+ * ```typescript
+ * randomColor() // '#a1b2c3'
+ * randomColor() // '#0f9e21'
+ * ```
+ *
  * @returns {string} A string representing a random color in hexadecimal format (e.g., `#a1b2c3`).
  */
 export declare function randomColor(): string;
 /**
- * Generates a random color with a given alpha value.
+ * Picks the readable text colour (`#000` or `#fff`) for a hex background.
+ *
+ * @example
+ * ```typescript
+ * matchingTextColor('#ffffff') // '#000'
+ * matchingTextColor('#000000') // '#fff'
+ * matchingTextColor('#1e90ff') // '#fff'
+ * ```
  *
  * @export
  * @param {string} color
@@ -15,6 +28,13 @@ export declare function matchingTextColor(color: string): "#000" | "#fff";
 /**
  * Converts a hex color string to an RGB object.
  *
+ * @example
+ * ```typescript
+ * hexToRgb('#ff8800') // { r: 255, g: 136, b: 0 }
+ * hexToRgb('ff8800') // { r: 255, g: 136, b: 0 }
+ * hexToRgb('nope') // null
+ * ```
+ *
  * @export
  * @param {string} hex
  * @return {*}  {({ r: number; g: number; b: number } | null)}
@@ -35,11 +55,11 @@ export declare function hexToRgb(hex: string): {
  */
 export declare function rgbToHex(r: number, g: number, b: number): string;
 /**
- * Converts a hex color string to an HSL object.
+ * Checks whether a string is a valid 3- or 6-digit hex colour.
  *
  * @export
  * @param {string} hex
- * @return {*}  {({ h: number; s: number; l: number } | null)}
+ * @return {*}  {boolean}
  */
 export declare function isValidHex(hex: string): boolean;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/colors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,mBAO9C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQhF;AAED;;;;;;;;GAQG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/colors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,mBAO9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQhF;AAED;;;;;;;;GAQG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/console/index.d.ts

@@ -4,11 +4,23 @@
  */
 /**
  * Disables console output in production environment.
+ *
+ * @example
+ * ```typescript
+ * process.env.NODE_ENV = 'production'
+ * disableConsole()
+ * console.log('hidden') // no output
+ * ```
  */
 export declare const disableConsole: () => void;
 /**
  * Clears the console.
  *
+ * @example
+ * ```typescript
+ * clearConsole() // terminal is wiped, cursor back at the top-left
+ * ```
+ *
  * @export
  * @return {*}  {void}
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,YAK1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,YAK1B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAA"}

package/dist/crypto/index.d.ts

@@ -1,5 +1,13 @@
 /**
  * Hashes a string using the specified algorithm.
+ *
+ * @example
+ * ```typescript
+ * hashString('hello')
+ * // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ * hashString('hello', 'md5') // '5d41402abc4b2a76b9719d911017c592'
+ * ```
+ *
  * @param str The string to hash.
  * @param algorithm The hash algorithm (default: 'sha256').
  * @returns The hex-encoded hash.
@@ -7,12 +15,27 @@
 export declare function hashString(str: string, algorithm?: string): string;
 /**
  * Generates a random hex string of the specified length (in bytes).
+ *
+ * @example
+ * ```typescript
+ * randomHex(4) // '9f3c1ab7' (8 hex chars)
+ * randomHex() // 32 hex chars (16 bytes)
+ * ```
+ *
  * @param length The number of bytes (not hex chars).
  * @returns A random hex string.
  */
 export declare function randomHex(length?: number): string;
 /**
  * Creates an HMAC hash of a string using a secret and algorithm.
+ *
+ * @example
+ * ```typescript
+ * hmacHash('payload', 's3cret')
+ * // 'd1d0f5b6...' (64 hex chars, stable for the same input + secret)
+ * hmacHash('payload', 's3cret', 'sha1') // 40 hex chars
+ * ```
+ *
  * @param str The string to hash.
  * @param secret The secret key.
  * @param algorithm The hash algorithm (default: 'sha256').

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAEpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/currency/index.d.ts

@@ -153,18 +153,4 @@ export declare function isValidCurrencyCode(code: string): Promise<boolean>;
  * ```
  */
 export declare function isValidCurrency(code: string): boolean;
-/**
- * Rounds a given number to a specified number of decimal places.
- *
- * @param value - The number to be rounded.
- * @param decimals - The number of decimal places to round to. Defaults to 2.
- * @returns The rounded number.
- *
- * @example
- * ```typescript
- * roundTo(3.14159, 2) // 3.14
- * roundTo(10.5, 0) // 11
- * ```
- */
-export declare function roundTo(value: number, decimals?: number): number;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,SAY7D,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,GAAG,SAAS,CAMnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkC1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,SAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,SAAQ,EAChB,MAAM,CAAC,EAAE,MAAM,GACb,MAAM,CAQR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAavD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA2C9F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAG3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,SAY7D,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,GAAG,SAAS,CAMnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkC1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,SAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,SAAQ,EAChB,MAAM,CAAC,EAAE,MAAM,GACb,MAAM,CAQR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAevD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA2C9F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD"}

package/dist/currency/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";var o=null;async function a(){if(o)return o;let{default:r}=await import("./currencies.js");return o=r,r}var l=r=>{try{let n=new Intl.NumberFormat("en",{currency:r,style:"currency"}).formatToParts(0).find(e=>e.type==="currency");return n?.value==="\xA4"?void 0:n?.value}catch{return}};function m(r,n="en"){try{return new Intl.DisplayNames([n],{type:"currency"}).of(r.toUpperCase())}catch{return}}function i(r){return{USD:"en-US",EUR:"de-DE",GBP:"en-GB",JPY:"ja-JP",CNY:"zh-CN",CAD:"en-CA",AUD:"en-AU",CHF:"de-CH",NZD:"en-NZ",SGD:"en-SG",HKD:"zh-HK",KRW:"ko-KR",INR:"en-IN",BRL:"pt-BR",MXN:"es-MX",RUB:"ru-RU",ZAR:"en-ZA",SEK:"sv-SE",NOK:"nb-NO",DKK:"da-DK",PLN:"pl-PL",TRY:"tr-TR",THB:"th-TH",MYR:"ms-MY",PHP:"en-PH",IDR:"id-ID",CZK:"cs-CZ",HUF:"hu-HU",ILS:"he-IL",TWD:"zh-TW"}[r.toUpperCase()]??"en"}function p(r,n="USD",e){let t=e??i(n);return new Intl.NumberFormat(t,{style:"currency",currency:n}).format(Number(r))}function d(r,n="USD",e){let t=e??i(n);return new Intl.NumberFormat(t,{style:"currency",currency:n,notation:"compact",compactDisplay:"short"}).format(Number(r))}function s(r){let n=/\d+\.\d{3},\d{2}$/.test(r),e=r;n&&(e=r.replace(/\./g,"").replace(",","."));let t=e.replace(/[^0-9.-]+/g,""),c=Number.parseFloat(t);return Number.isNaN(c)?null:c}function f(r){let n={$:"USD","\u20AC":"EUR","\xA3":"GBP","\xA5":"JPY","\u20B9":"INR","\u20BD":"RUB",R$:"BRL","\u20A9":"KRW","\u0E3F":"THB","\u20AA":"ILS","\u20B1":"PHP","\u20AB":"VND",kr:"SEK",CHF:"CHF",C$:"CAD",A$:"AUD",NZ$:"NZD",HK$:"HKD",S$:"SGD"},e=r.match(/\b([A-Z]{3})\b/);if(e?.[1]){let t=s(r);if(t!==null)return{amount:t,currency:e[1]}}for(let[t,c]of Object.entries(n))if(r.includes(t)){let u=s(r);if(u!==null)return{amount:u,currency:c}}return null}function y(r,n,e=2){return Number.parseFloat((r*n).toFixed(e))}async function g(r){return(await a()).includes(r.toUpperCase())}function b(r){try{return new Intl.NumberFormat("en",{style:"currency",currency:r}),!0}catch{return!1}}function C(r,n=2){let e=10**n;return Math.round(r*e)/e}export{y as convertCurrency,p as formatPrice,d as formatPriceCompact,i as getCurrencyLocale,m as getCurrencyName,l as getCurrencySymbol,b as isValidCurrency,g as isValidCurrencyCode,f as parseCurrencyString,s as parsePrice,C as roundTo};
+import"../chunks/chunk-ANN5UYCF.js";var o=null;async function a(){if(o)return o;let{default:r}=await import("./currencies.js");return o=r,r}var l=r=>{try{let e=new Intl.NumberFormat("en",{currency:r,style:"currency"}).formatToParts(0).find(n=>n.type==="currency");return e?.value==="\xA4"?void 0:e?.value}catch{return}};function m(r,e="en"){try{return new Intl.DisplayNames([e],{type:"currency"}).of(r.toUpperCase())}catch{return}}function i(r){return{USD:"en-US",EUR:"de-DE",GBP:"en-GB",JPY:"ja-JP",CNY:"zh-CN",CAD:"en-CA",AUD:"en-AU",CHF:"de-CH",NZD:"en-NZ",SGD:"en-SG",HKD:"zh-HK",KRW:"ko-KR",INR:"en-IN",BRL:"pt-BR",MXN:"es-MX",RUB:"ru-RU",ZAR:"en-ZA",SEK:"sv-SE",NOK:"nb-NO",DKK:"da-DK",PLN:"pl-PL",TRY:"tr-TR",THB:"th-TH",MYR:"ms-MY",PHP:"en-PH",IDR:"id-ID",CZK:"cs-CZ",HUF:"hu-HU",ILS:"he-IL",TWD:"zh-TW"}[r.toUpperCase()]??"en"}function p(r,e="USD",n){let t=n??i(e);return new Intl.NumberFormat(t,{style:"currency",currency:e}).format(Number(r))}function y(r,e="USD",n){let t=n??i(e);return new Intl.NumberFormat(t,{style:"currency",currency:e,notation:"compact",compactDisplay:"short"}).format(Number(r))}function s(r){let e=/\d\.\d{3},\d{2}$/.test(r),n=r;e&&(n=r.replace(/\./g,"").replace(",","."));let t=n.replace(/[^0-9.-]+/g,""),c=Number.parseFloat(t);return Number.isNaN(c)?null:c}function d(r){let e={$:"USD","\u20AC":"EUR","\xA3":"GBP","\xA5":"JPY","\u20B9":"INR","\u20BD":"RUB",R$:"BRL","\u20A9":"KRW","\u0E3F":"THB","\u20AA":"ILS","\u20B1":"PHP","\u20AB":"VND",kr:"SEK",CHF:"CHF",C$:"CAD",A$:"AUD",NZ$:"NZD",HK$:"HKD",S$:"SGD"},n=r.match(/\b([A-Z]{3})\b/);if(n?.[1]){let t=s(r);if(t!==null)return{amount:t,currency:n[1]}}for(let[t,c]of Object.entries(e))if(r.includes(t)){let u=s(r);if(u!==null)return{amount:u,currency:c}}return null}function f(r,e,n=2){return Number.parseFloat((r*e).toFixed(n))}async function g(r){return(await a()).includes(r.toUpperCase())}function C(r){try{return new Intl.NumberFormat("en",{style:"currency",currency:r}),!0}catch{return!1}}export{f as convertCurrency,p as formatPrice,y as formatPriceCompact,i as getCurrencyLocale,m as getCurrencyName,l as getCurrencySymbol,C as isValidCurrency,g as isValidCurrencyCode,d as parseCurrencyString,s as parsePrice};

package/dist/date/index.d.ts

@@ -1,13 +1,29 @@
 /**
  * Returns today's date as a YYYY-MM-DD string.
+ *
+ * @example
+ * ```typescript
+ * today() // '2026-08-11'
+ * ```
  */
 export declare function today(): string;
 /**
  * Returns a Date object from a YYYY-MM-DD string (parsed as local time).
+ *
+ * @example
+ * ```typescript
+ * parseDate('2026-08-11') // Date for 2026-08-11 00:00:00 local time
+ * parseDate('2026-08-11').getFullYear() // 2026
+ * ```
  */
 export declare function parseDate(dateStr: string): Date;
 /**
  * Formats a Date object as YYYY-MM-DD (UTC).
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date('2026-08-11T23:30:00Z')) // '2026-08-11'
+ * ```
  */
 export declare function formatDate(date: Date): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAInE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIlD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAQ7E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAQlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAInE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIlD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAQ7E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAQlF"}

package/dist/datetime/index.d.ts

@@ -1,19 +1,37 @@
 /**
- * Returns the current date and time as an ISO string (YYYY-MM-DDTHH:mm:ss.sssZ).
+ * Returns the current date and time as an ISO string (`YYYY-MM-DDTHH:mm:ss.sssZ`).
+ *
+ * @example
+ * ```typescript
+ * nowIso() // '2026-08-11T14:03:27.913Z'
+ * ```
  */
 export declare function nowIso(): string;
 /**
  * Parses an ISO date-time string to a Date object. Returns null if invalid.
+ *
+ * @example
+ * ```typescript
+ * parseIsoDateTime('2026-08-11T14:03:27Z')?.getUTCHours() // 14
+ * parseIsoDateTime('not-a-date') // null
+ * ```
+ *
  * @param iso The ISO string.
  */
 export declare function parseIsoDateTime(iso: string): Date | null;
 /**
- * Formats a Date as YYYY-MM-DD HH:mm:ss (local time).
+ * Formats a Date as `YYYY-MM-DD HH:mm:ss` (local time).
+ *
+ * @example
+ * ```typescript
+ * formatDateTimeLocal(new Date(2026, 7, 11, 9, 5, 3)) // '2026-08-11 09:05:03'
+ * ```
+ *
  * @param date The Date object.
  */
 export declare function formatDateTimeLocal(date: Date): string;
 /**
- * Returns the timezone offset in minutes for a given date (local - UTC).
+ * Returns the timezone offset in minutes for a given date (local − UTC).
  * @param date The Date object.
  */
 export declare function getTimezoneOffset(date?: Date): number;
@@ -30,12 +48,6 @@ export declare function unixTimestamp(): number;
  * Returns the number of milliseconds since the Unix epoch.
  */
 export declare function unixMillis(): number;
-/**
- * Returns the difference in seconds between two Date objects.
- * @param a First date.
- * @param b Second date.
- */
-export declare function secondsBetween(a: Date, b: Date): number;
 /**
  * Returns the ISO week number (1–53) of a given date using UTC.
  * @param date A JavaScript Date object.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datetime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAY1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAoB7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datetime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAY1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAoB7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBzE"}

package/dist/datetime/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function i(){return new Date().toISOString()}function c(e){let t=new Date(e);return Number.isNaN(t.getTime())?null:t}function T(e){let t=n=>n.toString().padStart(2,"0");return`${e.getFullYear()}-${t(e.getMonth()+1)}-${t(e.getDate())} ${t(e.getHours())}:${t(e.getMinutes())}:${t(e.getSeconds())}`}function l(e=new Date){return e.getTimezoneOffset()}function f(e){return new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()))}function m(){return Math.floor(Date.now()/1e3)}function w(){return Date.now()}function U(e,t){return Math.floor((t.getTime()-e.getTime())/1e3)}function C(e){let t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate())),n=t.getUTCDay(),s=n===0?7:n;t.setUTCDate(t.getUTCDate()+4-s);let o=new Date(Date.UTC(t.getUTCFullYear(),0,1)).getUTCDay(),a=o===0?7:o,D=new Date(Date.UTC(t.getUTCFullYear(),0,1+(4-a))),u=t.getTime()-D.getTime();return 1+Math.round(u/(10080*60*1e3))}function y(e){let t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate()));t.setUTCDate(t.getUTCDate()+4-(t.getUTCDay()||7));let n=t.getUTCFullYear(),r=new Date(Date.UTC(n,0,1)).getUTCDay()||7,o=new Date(Date.UTC(n,0,1-r+1+(r>4?7:0))),a=t.getTime()-o.getTime();return{week:Math.floor(a/(10080*60*1e3))+1,year:n}}export{T as formatDateTimeLocal,C as getIsoWeek,y as getIsoWeekInfo,l as getTimezoneOffset,i as nowIso,c as parseIsoDateTime,U as secondsBetween,f as toUtcDate,w as unixMillis,m as unixTimestamp};
+import"../chunks/chunk-ANN5UYCF.js";function i(){return new Date().toISOString()}function c(e){let t=new Date(e);return Number.isNaN(t.getTime())?null:t}function T(e){let t=n=>n.toString().padStart(2,"0");return`${e.getFullYear()}-${t(e.getMonth()+1)}-${t(e.getDate())} ${t(e.getHours())}:${t(e.getMinutes())}:${t(e.getSeconds())}`}function l(e=new Date){return e.getTimezoneOffset()}function f(e){return new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()))}function m(){return Math.floor(Date.now()/1e3)}function U(){return Date.now()}function w(e){let t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate())),n=t.getUTCDay(),s=n===0?7:n;t.setUTCDate(t.getUTCDate()+4-s);let o=new Date(Date.UTC(t.getUTCFullYear(),0,1)).getUTCDay(),a=o===0?7:o,D=new Date(Date.UTC(t.getUTCFullYear(),0,1+(4-a))),u=t.getTime()-D.getTime();return 1+Math.round(u/(10080*60*1e3))}function C(e){let t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate()));t.setUTCDate(t.getUTCDate()+4-(t.getUTCDay()||7));let n=t.getUTCFullYear(),r=new Date(Date.UTC(n,0,1)).getUTCDay()||7,o=new Date(Date.UTC(n,0,1-r+1+(r>4?7:0))),a=t.getTime()-o.getTime();return{week:Math.floor(a/(10080*60*1e3))+1,year:n}}export{T as formatDateTimeLocal,w as getIsoWeek,C as getIsoWeekInfo,l as getTimezoneOffset,i as nowIso,c as parseIsoDateTime,f as toUtcDate,U as unixMillis,m as unixTimestamp};

package/dist/emails/index.d.ts

@@ -1,17 +1,39 @@
 /**
  * Validates if a string is a valid email address (simple regex).
+ *
+ * @example
+ * ```typescript
+ * isValidEmail('user@example.com') // true
+ * isValidEmail('user@example') // false
+ * isValidEmail('not an email') // false
+ * ```
+ *
  * @param email The email address to validate.
  * @returns True if valid, false otherwise.
  */
 export declare function isValidEmail(email: string): boolean;
 /**
  * Normalizes an email address by trimming and converting to lowercase.
+ *
+ * @example
+ * ```typescript
+ * normalizeEmail('  User@Example.COM ') // 'user@example.com'
+ * ```
+ *
  * @param email The email address to normalize.
  * @returns The normalized email address.
  */
 export declare function normalizeEmail(email: string): string;
 /**
  * Masks an email address for privacy (e.g., j***@domain.com).
+ *
+ * @example
+ * ```typescript
+ * maskEmail('jane@example.com') // 'j***@example.com'
+ * maskEmail('a@example.com') // '*@example.com'
+ * maskEmail('nope') // 'nope'
+ * ```
+ *
  * @param email The email address to mask.
  * @returns The masked email address.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emails/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/emails/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function e(t){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)}function s(t){return t.trim().toLowerCase()}function a(t){let[o,r]=t.split("@");return!o||!r?t:o.length<=1?`*@${r}`:`${o[0]}${"*".repeat(Math.max(1,o.length-1))}@${r}`}function n(t){let o=t.split("@");return o.length===2?o[1]??"":""}var i=["gmail.com","yahoo.com","outlook.com","hotmail.com","icloud.com","aol.com","zoho.com","mail.com"];function m(t){return i.includes(n(t))}export{n as getEmailDomain,m as isFreeEmailProvider,e as isValidEmail,a as maskEmail,s as normalizeEmail};
+import"../chunks/chunk-ANN5UYCF.js";function e(t){return/^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/.test(t)}function s(t){return t.trim().toLowerCase()}function a(t){let[o,r]=t.split("@");return!o||!r?t:o.length<=1?`*@${r}`:`${o[0]}${"*".repeat(Math.max(1,o.length-1))}@${r}`}function n(t){let o=t.split("@");return o.length===2?o[1]??"":""}var i=["gmail.com","yahoo.com","outlook.com","hotmail.com","icloud.com","aol.com","zoho.com","mail.com"];function m(t){return i.includes(n(t))}export{n as getEmailDomain,m as isFreeEmailProvider,e as isValidEmail,a as maskEmail,s as normalizeEmail};

package/dist/env/index.d.ts

@@ -2,6 +2,14 @@ import { z } from 'zod';
 /**
  * Retrieves the value of an environment variable by its key.
  *
+ * @example
+ * ```typescript
+ * process.env.API_URL = 'https://api.example.com'
+ * getENV('API_URL') // 'https://api.example.com'
+ * getENV('MISSING', 'fallback') // 'fallback'
+ * getENV('MISSING') // throws Error: Undefined ENV variable - MISSING
+ * ```
+ *
  * @param key - The name of the environment variable to retrieve.
  * @param defaultValue - An optional default value to return if the environment variable is not defined.
  * @returns The value of the environment variable if it exists, otherwise the default value if provided.
@@ -11,12 +19,28 @@ export declare const getENV: (key: string, defaultValue?: string) => string;
 /**
  * Determines if the current environment is set to development.
  *
+ * @example
+ * ```typescript
+ * process.env.NODE_ENV = 'development'
+ * isDev() // true
+ * process.env.NODE_ENV = 'production'
+ * isDev() // false
+ * ```
+ *
  * @returns {boolean} `true` if `process.env.NODE_ENV` is `'development'`, otherwise `false`.
  */
 export declare const isDev: () => boolean;
 /**
  * Determines if the current environment is set to production.
  *
+ * @example
+ * ```typescript
+ * process.env.NODE_ENV = 'production'
+ * isProd() // true
+ * process.env.NODE_ENV = 'test'
+ * isProd() // false
+ * ```
+ *
  * @returns {boolean} `true` if `process.env.NODE_ENV` is `'production'`, otherwise `false`.
  */
 export declare const isProd: () => boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,WAUxD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAO,OAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAC/C,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACzB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,oCAc1D;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAI3B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,WAUxD,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,QAAO,OAExB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAO,OAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,MAE7B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAC/C,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACzB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,oCAc1D;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAI3B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/errors/index.d.ts

@@ -1,5 +1,14 @@
 /**
  * Creates a new Error with a custom name and message.
+ *
+ * @example
+ * ```typescript
+ * const err = createCustomError('NotFoundError', 'user 42 is missing')
+ * err.name // 'NotFoundError'
+ * err.message // 'user 42 is missing'
+ * err instanceof Error // true
+ * ```
+ *
  * @param name The error name.
  * @param message The error message.
  * @returns The custom Error object.
@@ -7,6 +16,15 @@
 export declare function createCustomError(name: string, message: string): Error;
 /**
  * Checks if an error is an instance of a specific error name.
+ *
+ * @example
+ * ```typescript
+ * const err = createCustomError('NotFoundError', 'missing')
+ * isErrorName(err, 'NotFoundError') // true
+ * isErrorName(err, 'TypeError') // false
+ * isErrorName('oops', 'TypeError') // false
+ * ```
+ *
  * @param error The error to check.
  * @param name The error name to match.
  * @returns True if the error matches the name, false otherwise.
@@ -14,6 +32,14 @@ export declare function createCustomError(name: string, message: string): Error;
 export declare function isErrorName(error: unknown, name: string): boolean;
 /**
  * Gets the error message from an unknown error value.
+ *
+ * @example
+ * ```typescript
+ * getErrorMessage(new Error('boom')) // 'boom'
+ * getErrorMessage('boom') // 'boom'
+ * getErrorMessage({ code: 500 }) // '{"code":500}'
+ * ```
+ *
  * @param error The error value.
  * @returns The error message, or a stringified version if not an Error.
  */
@@ -32,8 +58,10 @@ export declare function assert(condition: unknown, message: string): asserts con
  * @param fallback The fallback value to return on error.
  *
  * @example
- * const result = await tryWithFallback(async () => fetchData(), [])
- * // result will be [] if fetchData throws
+ * ```typescript
+ * await tryWithFallback(async () => fetchData(), []) // the data, or [] if it throws
+ * await tryWithFallback(() => JSON.parse('{'), {}) // {}
+ * ```
  */
 export declare function tryWithFallback<T>(fn: () => Promise<T> | T, fallback: T): Promise<T>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAItE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;;GAIG;AAEH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI7E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM1F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAItE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;;GAIG;AAEH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM1F"}