@nr1e/commons 0.3.2 → 0.3.4

package/README.md

@@ -1,7 +1,6 @@
 # Commons JS
 
 [![NPM Version][npm-image]][npm-url]
-[![GitHub Actions][github-image]][github-url]
 
 This project provides reusable components commonly needed in TypeScript projects.
 
@@ -17,7 +16,5 @@ This project provides reusable components commonly needed in TypeScript projects
 | `@nr1e/commons/os`         | Operating system utilities including environment variable helpers                             |
 | `@nr1e/commons/validator`  | Input validation utilities                                                                    |
 
-[github-url]: https://github.com/nr1etech/lib-js/actions
-[github-image]: https://github.com/nr1etech/lib-js/workflows/ci/badge.svg
 [npm-url]: https://npmjs.org/package/@nr1e/commons-js
 [npm-image]: https://img.shields.io/npm/v/@nre1/commons-js.svg

package/dist/business/index.d.mts

@@ -0,0 +1,2 @@
+export * from './us-state-to-code.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/business/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/business/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/business/index.mjs

@@ -0,0 +1,2 @@
+export * from './us-state-to-code.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/business/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/business/index.mts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/business/us-state-to-code.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Converts a US state name or abbreviation to a 2-letter state code.
+ * - Case insensitive
+ * - Ignores spaces, hyphens, dots
+ * - Handles common misspellings
+ * - Handles state codes
+ */
+export declare function usStateToCode(input?: string | null): string | null;
+//# sourceMappingURL=us-state-to-code.d.mts.map

package/dist/business/us-state-to-code.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"us-state-to-code.d.mts","sourceRoot":"","sources":["../../src/business/us-state-to-code.mts"],"names":[],"mappings":"AAkLA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAclE"}

package/dist/business/us-state-to-code.mjs

@@ -0,0 +1,149 @@
+const STATE_ALIASES = {
+    alabama: 'AL',
+    alabma: 'AL',
+    al: 'AL',
+    alaska: 'AK',
+    ak: 'AK',
+    arizona: 'AZ',
+    arizonia: 'AZ',
+    az: 'AZ',
+    arkansas: 'AR',
+    arkansaw: 'AR',
+    ar: 'AR',
+    california: 'CA',
+    calif: 'CA',
+    californa: 'CA',
+    calfornia: 'CA',
+    ca: 'CA',
+    colorado: 'CO',
+    colarado: 'CO',
+    co: 'CO',
+    connecticut: 'CT',
+    conecticut: 'CT',
+    conneticut: 'CT',
+    ct: 'CT',
+    delaware: 'DE',
+    de: 'DE',
+    florida: 'FL',
+    floridia: 'FL',
+    fl: 'FL',
+    georgia: 'GA',
+    ga: 'GA',
+    hawaii: 'HI',
+    hawai: 'HI',
+    hi: 'HI',
+    idaho: 'ID',
+    id: 'ID',
+    illinois: 'IL',
+    illinios: 'IL',
+    il: 'IL',
+    indiana: 'IN',
+    in: 'IN',
+    iowa: 'IA',
+    ia: 'IA',
+    kansas: 'KS',
+    ks: 'KS',
+    kentucky: 'KY',
+    kentuckey: 'KY',
+    ky: 'KY',
+    louisiana: 'LA',
+    louisianna: 'LA',
+    la: 'LA',
+    maine: 'ME',
+    main: 'ME',
+    maryland: 'MD',
+    marlyand: 'MD',
+    md: 'MD',
+    massachusetts: 'MA',
+    massachussetts: 'MA',
+    massachusets: 'MA',
+    ma: 'MA',
+    michigan: 'MI',
+    michegan: 'MI',
+    mi: 'MI',
+    minnesota: 'MN',
+    minnesotta: 'MN',
+    mn: 'MN',
+    mississippi: 'MS',
+    mississipi: 'MS',
+    ms: 'MS',
+    missouri: 'MO',
+    missourri: 'MO',
+    mo: 'MO',
+    montana: 'MT',
+    mt: 'MT',
+    nebraska: 'NE',
+    ne: 'NE',
+    nevada: 'NV',
+    nv: 'NV',
+    newhampshire: 'NH',
+    nh: 'NH',
+    newjersey: 'NJ',
+    nj: 'NJ',
+    newmexico: 'NM',
+    nm: 'NM',
+    newyork: 'NY',
+    ny: 'NY',
+    northcarolina: 'NC',
+    nc: 'NC',
+    northdakota: 'ND',
+    nd: 'ND',
+    ohio: 'OH',
+    oh: 'OH',
+    oklahoma: 'OK',
+    okalahoma: 'OK',
+    ok: 'OK',
+    oregon: 'OR',
+    or: 'OR',
+    pennsylvania: 'PA',
+    pensylvania: 'PA',
+    pa: 'PA',
+    rhodeisland: 'RI',
+    ri: 'RI',
+    southcarolina: 'SC',
+    sc: 'SC',
+    southdakota: 'SD',
+    sd: 'SD',
+    tennessee: 'TN',
+    tennesee: 'TN',
+    tn: 'TN',
+    texas: 'TX',
+    tx: 'TX',
+    utah: 'UT',
+    ut: 'UT',
+    vermont: 'VT',
+    vt: 'VT',
+    virginia: 'VA',
+    va: 'VA',
+    washington: 'WA',
+    washinton: 'WA',
+    wa: 'WA',
+    westvirginia: 'WV',
+    wv: 'WV',
+    wisconsin: 'WI',
+    wisconson: 'WI',
+    wi: 'WI',
+    wyoming: 'WY',
+    wy: 'WY',
+};
+/**
+ * Converts a US state name or abbreviation to a 2-letter state code.
+ * - Case insensitive
+ * - Ignores spaces, hyphens, dots
+ * - Handles common misspellings
+ * - Handles state codes
+ */
+export function usStateToCode(input) {
+    if (!input)
+        return null;
+    const normalized = input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z]/g, '');
+    // Already a valid 2-letter code
+    if (normalized.length === 2) {
+        return normalized.toUpperCase();
+    }
+    return STATE_ALIASES[normalized] ?? null;
+}
+//# sourceMappingURL=us-state-to-code.mjs.map

package/dist/business/us-state-to-code.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"us-state-to-code.mjs","sourceRoot":"","sources":["../../src/business/us-state-to-code.mts"],"names":[],"mappings":"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"}

package/dist/business/us-state-to-code.test.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=us-state-to-code.test.d.mts.map

package/dist/business/us-state-to-code.test.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"us-state-to-code.test.d.mts","sourceRoot":"","sources":["../../src/business/us-state-to-code.test.mts"],"names":[],"mappings":""}

package/dist/business/us-state-to-code.test.mjs

@@ -0,0 +1,334 @@
+import { test, expect, describe } from 'vitest';
+import { usStateToCode } from './us-state-to-code.mjs';
+describe('usStateToCode', () => {
+    describe('null and empty inputs', () => {
+        test('returns null for null input', () => {
+            expect(usStateToCode(null)).toBe(null);
+        });
+        test('returns null for undefined input', () => {
+            expect(usStateToCode(undefined)).toBe(null);
+        });
+        test('returns null for empty string', () => {
+            expect(usStateToCode('')).toBe(null);
+        });
+        test('returns null for whitespace-only string', () => {
+            expect(usStateToCode('   ')).toBe(null);
+        });
+    });
+    describe('2-letter state codes', () => {
+        test('returns uppercase code for lowercase input', () => {
+            expect(usStateToCode('ca')).toBe('CA');
+            expect(usStateToCode('ny')).toBe('NY');
+            expect(usStateToCode('tx')).toBe('TX');
+        });
+        test('returns uppercase code for uppercase input', () => {
+            expect(usStateToCode('CA')).toBe('CA');
+            expect(usStateToCode('NY')).toBe('NY');
+            expect(usStateToCode('TX')).toBe('TX');
+        });
+        test('returns uppercase code for mixed case input', () => {
+            expect(usStateToCode('Ca')).toBe('CA');
+            expect(usStateToCode('nY')).toBe('NY');
+            expect(usStateToCode('Tx')).toBe('TX');
+        });
+        test('handles all 50 state codes', () => {
+            const stateCodes = [
+                'AL',
+                'AK',
+                'AZ',
+                'AR',
+                'CA',
+                'CO',
+                'CT',
+                'DE',
+                'FL',
+                'GA',
+                'HI',
+                'ID',
+                'IL',
+                'IN',
+                'IA',
+                'KS',
+                'KY',
+                'LA',
+                'ME',
+                'MD',
+                'MA',
+                'MI',
+                'MN',
+                'MS',
+                'MO',
+                'MT',
+                'NE',
+                'NV',
+                'NH',
+                'NJ',
+                'NM',
+                'NY',
+                'NC',
+                'ND',
+                'OH',
+                'OK',
+                'OR',
+                'PA',
+                'RI',
+                'SC',
+                'SD',
+                'TN',
+                'TX',
+                'UT',
+                'VT',
+                'VA',
+                'WA',
+                'WV',
+                'WI',
+                'WY',
+            ];
+            stateCodes.forEach((code) => {
+                expect(usStateToCode(code.toLowerCase())).toBe(code);
+            });
+        });
+    });
+    describe('full state names', () => {
+        test('converts lowercase state names', () => {
+            expect(usStateToCode('california')).toBe('CA');
+            expect(usStateToCode('texas')).toBe('TX');
+            expect(usStateToCode('florida')).toBe('FL');
+            expect(usStateToCode('newyork')).toBe('NY');
+        });
+        test('converts uppercase state names', () => {
+            expect(usStateToCode('CALIFORNIA')).toBe('CA');
+            expect(usStateToCode('TEXAS')).toBe('TX');
+            expect(usStateToCode('FLORIDA')).toBe('FL');
+        });
+        test('converts proper case state names', () => {
+            expect(usStateToCode('California')).toBe('CA');
+            expect(usStateToCode('Texas')).toBe('TX');
+            expect(usStateToCode('Florida')).toBe('FL');
+        });
+        test('handles state names with spaces', () => {
+            expect(usStateToCode('New York')).toBe('NY');
+            expect(usStateToCode('New Jersey')).toBe('NJ');
+            expect(usStateToCode('New Mexico')).toBe('NM');
+            expect(usStateToCode('New Hampshire')).toBe('NH');
+            expect(usStateToCode('North Carolina')).toBe('NC');
+            expect(usStateToCode('North Dakota')).toBe('ND');
+            expect(usStateToCode('South Carolina')).toBe('SC');
+            expect(usStateToCode('South Dakota')).toBe('SD');
+            expect(usStateToCode('West Virginia')).toBe('WV');
+            expect(usStateToCode('Rhode Island')).toBe('RI');
+        });
+        test('handles state names with hyphens', () => {
+            expect(usStateToCode('New-York')).toBe('NY');
+            expect(usStateToCode('North-Carolina')).toBe('NC');
+        });
+        test('handles state names with dots', () => {
+            expect(usStateToCode('N.Y.')).toBe('NY');
+            expect(usStateToCode('N.C.')).toBe('NC');
+        });
+        test('handles state names with mixed spaces and special characters', () => {
+            expect(usStateToCode('New   York')).toBe('NY');
+            expect(usStateToCode('North - Carolina')).toBe('NC');
+            expect(usStateToCode('West  Virginia')).toBe('WV');
+        });
+        test('converts all 50 state names', () => {
+            const stateNames = [
+                { name: 'Alabama', code: 'AL' },
+                { name: 'Alaska', code: 'AK' },
+                { name: 'Arizona', code: 'AZ' },
+                { name: 'Arkansas', code: 'AR' },
+                { name: 'California', code: 'CA' },
+                { name: 'Colorado', code: 'CO' },
+                { name: 'Connecticut', code: 'CT' },
+                { name: 'Delaware', code: 'DE' },
+                { name: 'Florida', code: 'FL' },
+                { name: 'Georgia', code: 'GA' },
+                { name: 'Hawaii', code: 'HI' },
+                { name: 'Idaho', code: 'ID' },
+                { name: 'Illinois', code: 'IL' },
+                { name: 'Indiana', code: 'IN' },
+                { name: 'Iowa', code: 'IA' },
+                { name: 'Kansas', code: 'KS' },
+                { name: 'Kentucky', code: 'KY' },
+                { name: 'Louisiana', code: 'LA' },
+                { name: 'Maine', code: 'ME' },
+                { name: 'Maryland', code: 'MD' },
+                { name: 'Massachusetts', code: 'MA' },
+                { name: 'Michigan', code: 'MI' },
+                { name: 'Minnesota', code: 'MN' },
+                { name: 'Mississippi', code: 'MS' },
+                { name: 'Missouri', code: 'MO' },
+                { name: 'Montana', code: 'MT' },
+                { name: 'Nebraska', code: 'NE' },
+                { name: 'Nevada', code: 'NV' },
+                { name: 'New Hampshire', code: 'NH' },
+                { name: 'New Jersey', code: 'NJ' },
+                { name: 'New Mexico', code: 'NM' },
+                { name: 'New York', code: 'NY' },
+                { name: 'North Carolina', code: 'NC' },
+                { name: 'North Dakota', code: 'ND' },
+                { name: 'Ohio', code: 'OH' },
+                { name: 'Oklahoma', code: 'OK' },
+                { name: 'Oregon', code: 'OR' },
+                { name: 'Pennsylvania', code: 'PA' },
+                { name: 'Rhode Island', code: 'RI' },
+                { name: 'South Carolina', code: 'SC' },
+                { name: 'South Dakota', code: 'SD' },
+                { name: 'Tennessee', code: 'TN' },
+                { name: 'Texas', code: 'TX' },
+                { name: 'Utah', code: 'UT' },
+                { name: 'Vermont', code: 'VT' },
+                { name: 'Virginia', code: 'VA' },
+                { name: 'Washington', code: 'WA' },
+                { name: 'West Virginia', code: 'WV' },
+                { name: 'Wisconsin', code: 'WI' },
+                { name: 'Wyoming', code: 'WY' },
+            ];
+            stateNames.forEach(({ name, code }) => {
+                expect(usStateToCode(name)).toBe(code);
+            });
+        });
+    });
+    describe('common misspellings', () => {
+        test('handles Alabama misspellings', () => {
+            expect(usStateToCode('alabma')).toBe('AL');
+        });
+        test('handles Arizona misspellings', () => {
+            expect(usStateToCode('arizonia')).toBe('AZ');
+        });
+        test('handles Arkansas misspellings', () => {
+            expect(usStateToCode('arkansaw')).toBe('AR');
+        });
+        test('handles California misspellings', () => {
+            expect(usStateToCode('calif')).toBe('CA');
+            expect(usStateToCode('californa')).toBe('CA');
+            expect(usStateToCode('calfornia')).toBe('CA');
+        });
+        test('handles Colorado misspellings', () => {
+            expect(usStateToCode('colarado')).toBe('CO');
+        });
+        test('handles Connecticut misspellings', () => {
+            expect(usStateToCode('conecticut')).toBe('CT');
+            expect(usStateToCode('conneticut')).toBe('CT');
+        });
+        test('handles Florida misspellings', () => {
+            expect(usStateToCode('floridia')).toBe('FL');
+        });
+        test('handles Hawaii misspellings', () => {
+            expect(usStateToCode('hawai')).toBe('HI');
+        });
+        test('handles Illinois misspellings', () => {
+            expect(usStateToCode('illinios')).toBe('IL');
+        });
+        test('handles Kentucky misspellings', () => {
+            expect(usStateToCode('kentuckey')).toBe('KY');
+        });
+        test('handles Louisiana misspellings', () => {
+            expect(usStateToCode('louisianna')).toBe('LA');
+        });
+        test('handles Maine misspellings', () => {
+            expect(usStateToCode('main')).toBe('ME');
+        });
+        test('handles Maryland misspellings', () => {
+            expect(usStateToCode('marlyand')).toBe('MD');
+        });
+        test('handles Massachusetts misspellings', () => {
+            expect(usStateToCode('massachussetts')).toBe('MA');
+            expect(usStateToCode('massachusets')).toBe('MA');
+        });
+        test('handles Michigan misspellings', () => {
+            expect(usStateToCode('michegan')).toBe('MI');
+        });
+        test('handles Minnesota misspellings', () => {
+            expect(usStateToCode('minnesotta')).toBe('MN');
+        });
+        test('handles Mississippi misspellings', () => {
+            expect(usStateToCode('mississipi')).toBe('MS');
+        });
+        test('handles Missouri misspellings', () => {
+            expect(usStateToCode('missourri')).toBe('MO');
+        });
+        test('handles Oklahoma misspellings', () => {
+            expect(usStateToCode('okalahoma')).toBe('OK');
+        });
+        test('handles Pennsylvania misspellings', () => {
+            expect(usStateToCode('pensylvania')).toBe('PA');
+        });
+        test('handles Tennessee misspellings', () => {
+            expect(usStateToCode('tennesee')).toBe('TN');
+        });
+        test('handles Washington misspellings', () => {
+            expect(usStateToCode('washinton')).toBe('WA');
+        });
+        test('handles Wisconsin misspellings', () => {
+            expect(usStateToCode('wisconson')).toBe('WI');
+        });
+    });
+    describe('invalid inputs', () => {
+        test('returns null for non-existent state names', () => {
+            expect(usStateToCode('Atlantis')).toBe(null);
+            expect(usStateToCode('Narnia')).toBe(null);
+            expect(usStateToCode('Wakanda')).toBe(null);
+        });
+        test('returns null for random strings', () => {
+            expect(usStateToCode('xyz')).toBe(null);
+            expect(usStateToCode('abcd')).toBe(null);
+            expect(usStateToCode('foobar')).toBe(null);
+        });
+        test('returns null for numbers only', () => {
+            expect(usStateToCode('123')).toBe(null);
+            expect(usStateToCode('12')).toBe(null);
+        });
+        test('returns null for special characters only', () => {
+            expect(usStateToCode('!!!')).toBe(null);
+            expect(usStateToCode('###')).toBe(null);
+        });
+        test('returns null for invalid 2-letter codes', () => {
+            expect(usStateToCode('zz')).toBe('ZZ'); // Note: function returns uppercase for any 2-letter input
+            expect(usStateToCode('xx')).toBe('XX');
+        });
+    });
+    describe('edge cases', () => {
+        test('handles strings with multiple spaces', () => {
+            expect(usStateToCode('  California  ')).toBe('CA');
+            expect(usStateToCode('New     York')).toBe('NY');
+        });
+        test('handles strings with multiple special characters', () => {
+            expect(usStateToCode('N...Y...')).toBe('NY');
+            expect(usStateToCode('N---Y---')).toBe('NY');
+            expect(usStateToCode('C@A#L$I%F')).toBe('CA');
+        });
+        test('handles very long invalid strings', () => {
+            expect(usStateToCode('ThisIsAVeryLongStringThatIsNotAStateName')).toBe(null);
+        });
+        test('handles single character input', () => {
+            expect(usStateToCode('a')).toBe(null);
+            expect(usStateToCode('C')).toBe(null);
+        });
+        test('handles three character input', () => {
+            expect(usStateToCode('abc')).toBe(null);
+            expect(usStateToCode('CAL')).toBe(null);
+        });
+        test('handles mixed numbers and letters', () => {
+            expect(usStateToCode('Ca1ifornia')).toBe(null); // normalized to 'california'
+            expect(usStateToCode('N3w Y0rk')).toBe(null); // normalized to 'newyork'
+        });
+    });
+    describe('trimming and normalization', () => {
+        test('trims leading and trailing whitespace', () => {
+            expect(usStateToCode('  California')).toBe('CA');
+            expect(usStateToCode('California  ')).toBe('CA');
+            expect(usStateToCode('  California  ')).toBe('CA');
+        });
+        test('removes all non-alphabetic characters', () => {
+            expect(usStateToCode('C@a#l$i%f^o&r*n(i)a')).toBe('CA');
+            expect(usStateToCode('1T2e3x4a5s6')).toBe('TX');
+        });
+        test('handles tab and newline characters', () => {
+            expect(usStateToCode('New\tYork')).toBe('NY');
+            expect(usStateToCode('New\nYork')).toBe('NY');
+            expect(usStateToCode('Texas\r\n')).toBe('TX');
+        });
+    });
+});
+//# sourceMappingURL=us-state-to-code.test.mjs.map

package/dist/business/us-state-to-code.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"us-state-to-code.test.mjs","sourceRoot":"","sources":["../../src/business/us-state-to-code.test.mts"],"names":[],"mappings":"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"}

package/dist/encryption/rsa-encryption.browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"rsa-encryption.browser.d.mts","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.browser.mts"],"names":[],"mappings":"AAAA;;;GAGG;;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0DD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EAEjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,QAAQ,GAAG,SAAoB,GACpC,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C"}
+{"version":3,"file":"rsa-encryption.browser.d.mts","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.browser.mts"],"names":[],"mappings":"AAAA;;;GAGG;;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0DD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,SAAS,EAAE,MAAM,EAEjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,QAAQ,GAAG,SAAoB,GACpC,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C"}

package/dist/encryption/rsa-encryption.browser.mjs

@@ -80,7 +80,7 @@ _options) {
         return btoa(binaryString);
     }
     catch (error) {
-        throw new Error(`Failed to encrypt data: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        throw new Error(`Failed to encrypt data: ${error instanceof Error ? error.message : 'Unknown error'}`, { cause: error });
     }
 }
 /**

package/dist/encryption/rsa-encryption.browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rsa-encryption.browser.mjs","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.browser.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rsa-encryption.browser.mjs","sourceRoot":"","sources":["../../src/encryption/rsa-encryption.browser.mts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.mts

@@ -1,2 +1,3 @@
 export * from './errors.mjs';
+export * from './safe.mjs';
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/errors/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/errors/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/errors/index.mjs

@@ -1,2 +1,3 @@
 export * from './errors.mjs';
+export * from './safe.mjs';
 //# sourceMappingURL=index.mjs.map

package/dist/errors/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/errors/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/errors/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/errors/safe.d.mts

@@ -0,0 +1,15 @@
+export type SafeResult<T> = {
+    success: true;
+    output: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Wraps a throwing function and returns a non-throwing result.
+ *
+ * @param fn - Function that may throw
+ * @param defaultMessage - Message to use if a non-Error is thrown
+ */
+export declare function safeCall<T>(fn: () => T, defaultMessage?: string): SafeResult<T>;
+//# sourceMappingURL=safe.d.mts.map

package/dist/errors/safe.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.mts","sourceRoot":"","sources":["../../src/errors/safe.mts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAC,GAC1B;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,CAAC,EACX,cAAc,SAAkB,GAC/B,UAAU,CAAC,CAAC,CAAC,CASf"}

package/dist/errors/safe.mjs

@@ -0,0 +1,18 @@
+/**
+ * Wraps a throwing function and returns a non-throwing result.
+ *
+ * @param fn - Function that may throw
+ * @param defaultMessage - Message to use if a non-Error is thrown
+ */
+export function safeCall(fn, defaultMessage = 'Unknown error') {
+    try {
+        return { success: true, output: fn() };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err instanceof Error ? err.message : defaultMessage,
+        };
+    }
+}
+//# sourceMappingURL=safe.mjs.map

package/dist/errors/safe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.mjs","sourceRoot":"","sources":["../../src/errors/safe.mts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,EAAW,EACX,cAAc,GAAG,eAAe;IAEhC,IAAI,CAAC;QACH,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc;SAC3D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lang/amount.d.mts

@@ -0,0 +1,38 @@
+import { SafeResult } from '../errors/index.mjs';
+/**
+ * Parses an amount in the format "0.00", "0.0" or "0" and converts it to a
+ * number. Both positive and negative values are supported. This will throw
+ * an error if the amount is not in the expected format.
+ *
+ * @param amount - The amount string to parse
+ * @returns The parsed amount as a number
+ * @throws Error if the amount is not in the expected format or is not a finite number
+ */
+export declare function parseAmount(amount: string): number;
+/**
+ * Parses an amount in the format "0.00", "0.0" or "0" and converts it to a
+ * number. Both positive and negative values are supported. This will return
+ * an error message if the amount is not in the expected format.
+ *
+ * @param input - The amount string to parse
+ * @returns A safe result containing the parsed amount as a number, or an error message if the amount is invalid.
+ */
+export declare function safeParseAmount(input: string): SafeResult<number>;
+/**
+ * Formats a number into a canonical "0.00" amount string. Numbers must be two
+ * decimal places or less. Both positive and negative values are supported.
+ *
+ * @param value - The number to format
+ * @returns The formatted amount string, e.g., "10.00" or "-10.00"
+ * @throws Error if the value is not finite or exceeds two decimal places
+ */
+export declare function formatAmount(value: number): string;
+/**
+ * Formats a number into a canonical "0.00" amount string. Numbers must be two
+ * decimal places or less. Both positive and negative values are supported.
+ *
+ * @param value - The number to format
+ * @returns A safe result containing the formatted amount string, or an error message if the value is invalid.
+ */
+export declare function safeFormatAmount(value: number): SafeResult<string>;
+//# sourceMappingURL=amount.d.mts.map

package/dist/lang/amount.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.mts","sourceRoot":"","sources":["../../src/lang/amount.mts"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAelD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBlD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAElE"}

package/dist/lang/amount.mjs

@@ -0,0 +1,70 @@
+import { safeCall } from '../errors/index.mjs';
+/**
+ * Parses an amount in the format "0.00", "0.0" or "0" and converts it to a
+ * number. Both positive and negative values are supported. This will throw
+ * an error if the amount is not in the expected format.
+ *
+ * @param amount - The amount string to parse
+ * @returns The parsed amount as a number
+ * @throws Error if the amount is not in the expected format or is not a finite number
+ */
+export function parseAmount(amount) {
+    const trimmed = amount.trim();
+    const AMOUNT_REGEX = /^-?\d+(\.\d{1,2})?$/;
+    if (!AMOUNT_REGEX.test(trimmed)) {
+        throw new Error(`Invalid amount format: "${amount}"`);
+    }
+    const value = Number(trimmed);
+    if (!Number.isFinite(value)) {
+        throw new Error(`Invalid numeric value: "${amount}"`);
+    }
+    return value;
+}
+/**
+ * Parses an amount in the format "0.00", "0.0" or "0" and converts it to a
+ * number. Both positive and negative values are supported. This will return
+ * an error message if the amount is not in the expected format.
+ *
+ * @param input - The amount string to parse
+ * @returns A safe result containing the parsed amount as a number, or an error message if the amount is invalid.
+ */
+export function safeParseAmount(input) {
+    return safeCall(() => parseAmount(input), 'Invalid amount format');
+}
+/**
+ * Formats a number into a canonical "0.00" amount string. Numbers must be two
+ * decimal places or less. Both positive and negative values are supported.
+ *
+ * @param value - The number to format
+ * @returns The formatted amount string, e.g., "10.00" or "-10.00"
+ * @throws Error if the value is not finite or exceeds two decimal places
+ */
+export function formatAmount(value) {
+    if (!Number.isFinite(value)) {
+        throw new Error('Amount must be a finite number');
+    }
+    if (Number.isNaN(value)) {
+        throw new Error('Amount must be a valid number');
+    }
+    // Normalize -0 → 0
+    const normalized = Object.is(value, -0) ? 0 : value;
+    // Convert to string without scientific notation
+    const asString = normalized.toString();
+    // Validate decimal precision (max 2 decimal places)
+    const DECIMAL_REGEX = /^-?\d+(\.\d{1,2})?$/;
+    if (!DECIMAL_REGEX.test(asString)) {
+        throw new Error(`Invalid amount format: "${asString}"`);
+    }
+    return normalized.toFixed(2);
+}
+/**
+ * Formats a number into a canonical "0.00" amount string. Numbers must be two
+ * decimal places or less. Both positive and negative values are supported.
+ *
+ * @param value - The number to format
+ * @returns A safe result containing the formatted amount string, or an error message if the value is invalid.
+ */
+export function safeFormatAmount(value) {
+    return safeCall(() => formatAmount(value), 'Invalid amount');
+}
+//# sourceMappingURL=amount.mjs.map

package/dist/lang/amount.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.mjs","sourceRoot":"","sources":["../../src/lang/amount.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAa,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,qBAAqB,CAAC;IAE3C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpD,gDAAgD;IAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IAEvC,oDAAoD;IACpD,MAAM,aAAa,GAAG,qBAAqB,CAAC;IAE5C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAC/D,CAAC"}

package/dist/lang/amount.test.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=amount.test.d.mts.map

package/dist/lang/amount.test.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.test.d.mts","sourceRoot":"","sources":["../../src/lang/amount.test.mts"],"names":[],"mappings":""}

package/dist/lang/amount.test.mjs

@@ -0,0 +1,104 @@
+import { test, expect, describe } from 'vitest';
+import { parseAmount, safeParseAmount, formatAmount, safeFormatAmount, } from './amount.mjs';
+describe('parseAmount', () => {
+    test('parses valid integer formats', () => {
+        expect(parseAmount('0')).toBe(0);
+        expect(parseAmount('10')).toBe(10);
+        expect(parseAmount('100')).toBe(100);
+    });
+    test('parses valid decimal formats', () => {
+        expect(parseAmount('10.0')).toBe(10);
+        expect(parseAmount('10.00')).toBe(10);
+        expect(parseAmount('10.5')).toBe(10.5);
+        expect(parseAmount('10.99')).toBe(10.99);
+        expect(parseAmount('0.01')).toBe(0.01);
+    });
+    test('parses negative values', () => {
+        expect(parseAmount('-10')).toBe(-10);
+        expect(parseAmount('-10.50')).toBe(-10.5);
+        expect(parseAmount('-0.01')).toBe(-0.01);
+    });
+    test('handles whitespace', () => {
+        expect(parseAmount('  10.00  ')).toBe(10);
+        expect(parseAmount('\t10.50\n')).toBe(10.5);
+    });
+    test('throws on invalid formats', () => {
+        expect(() => parseAmount('')).toThrow('Invalid amount format');
+        expect(() => parseAmount('   ')).toThrow('Invalid amount format');
+        expect(() => parseAmount('abc')).toThrow('Invalid amount format');
+        expect(() => parseAmount('10.000')).toThrow('Invalid amount format');
+        expect(() => parseAmount('10.')).toThrow('Invalid amount format');
+        expect(() => parseAmount('.10')).toThrow('Invalid amount format');
+        expect(() => parseAmount('10.5.5')).toThrow('Invalid amount format');
+        expect(() => parseAmount('$10.00')).toThrow('Invalid amount format');
+        expect(() => parseAmount('10,000.00')).toThrow('Invalid amount format');
+    });
+    test('throws on special numeric values', () => {
+        expect(() => parseAmount('NaN')).toThrow('Invalid amount format');
+        expect(() => parseAmount('Infinity')).toThrow('Invalid amount format');
+        expect(() => parseAmount('-Infinity')).toThrow('Invalid amount format');
+    });
+});
+describe('safeParseAmount', () => {
+    test('returns success for valid amounts', () => {
+        const result = safeParseAmount('10.50');
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.output).toBe(10.5);
+        }
+    });
+    test('returns error for invalid amounts', () => {
+        const result = safeParseAmount('invalid');
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error).toContain('Invalid amount format');
+        }
+    });
+});
+describe('formatAmount', () => {
+    test('formats integers with two decimal places', () => {
+        expect(formatAmount(0)).toBe('0.00');
+        expect(formatAmount(10)).toBe('10.00');
+        expect(formatAmount(100)).toBe('100.00');
+    });
+    test('formats decimals with two decimal places', () => {
+        expect(formatAmount(10.5)).toBe('10.50');
+        expect(formatAmount(10.99)).toBe('10.99');
+        expect(formatAmount(0.01)).toBe('0.01');
+    });
+    test('formats negative values', () => {
+        expect(formatAmount(-10)).toBe('-10.00');
+        expect(formatAmount(-10.5)).toBe('-10.50');
+        expect(formatAmount(-0.01)).toBe('-0.01');
+    });
+    test('normalizes negative zero', () => {
+        expect(formatAmount(-0)).toBe('0.00');
+    });
+    test('throws on non-finite numbers', () => {
+        expect(() => formatAmount(NaN)).toThrow('Amount must be a finite number');
+        expect(() => formatAmount(Infinity)).toThrow('Amount must be a finite number');
+        expect(() => formatAmount(-Infinity)).toThrow('Amount must be a finite number');
+    });
+    test('throws on excessive decimal precision', () => {
+        expect(() => formatAmount(10.999)).toThrow('Invalid amount format');
+        expect(() => formatAmount(0.001)).toThrow('Invalid amount format');
+        expect(() => formatAmount(10.123456)).toThrow('Invalid amount format');
+    });
+});
+describe('safeFormatAmount', () => {
+    test('returns success for valid amounts', () => {
+        const result = safeFormatAmount(10.5);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.output).toBe('10.50');
+        }
+    });
+    test('returns error for invalid amounts', () => {
+        const result = safeFormatAmount(NaN);
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error).toBe('Amount must be a finite number');
+        }
+    });
+});
+//# sourceMappingURL=amount.test.mjs.map

package/dist/lang/amount.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.test.mjs","sourceRoot":"","sources":["../../src/lang/amount.test.mts"],"names":[],"mappings":"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"}

package/dist/lang/currency.d.mts

@@ -1,10 +1,23 @@
+import { SafeResult } from '../errors/index.mjs';
 /**
- * Formats a currency amount using the Intl.NumberFormat API
+ * Formats a currency amount using the Intl.NumberFormat API.
+ * All inputs are validated and normalized to two decimal places.
  *
- * @param amount - The amount in cents (e.g., 1000 for $10.00) as number or string
- * @param currency - The currency code (e.g., 'USD', 'EUR')
- * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @param amount   - Amount as number or string ("0", "0.0", "0.00")
+ * @param currency - Currency code (e.g., 'USD', 'EUR')
+ * @param locale   - Locale (defaults to 'en-US')
  * @returns Formatted currency string
+ * @throws Error if the amount is invalid
  */
-export declare const formatCurrency: (amount: number | string, currency: string, locale?: string) => string;
+export declare function formatCurrency(amount: number | string, currency: string, locale?: string): string;
+/**
+ * Safely formats a currency amount.
+ *
+ * @param amount   - Amount as number or string
+ * @param currency - Currency code (e.g., 'USD')
+ * @param locale   - Locale (defaults to 'en-US')
+ * @returns A safe result containing the formatted currency string,
+ *          or an error message if the amount is invalid.
+ */
+export declare function safeFormatCurrency(amount: number | string, currency: string, locale?: string): SafeResult<string>;
 //# sourceMappingURL=currency.d.mts.map

package/dist/lang/currency.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"currency.d.mts","sourceRoot":"","sources":["../../src/lang/currency.mts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WACjB,MAAM,GAAG,MAAM,YACb,MAAM,WACP,MAAM,KACd,MAOF,CAAC"}
+{"version":3,"file":"currency.d.mts","sourceRoot":"","sources":["../../src/lang/currency.mts"],"names":[],"mappings":"AACA,OAAO,EAAW,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAgBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,UAAU,CAAC,MAAM,CAAC,CAKpB"}

package/dist/lang/currency.mjs

@@ -1,16 +1,42 @@
+import { formatAmount, parseAmount } from './amount.mjs';
+import { safeCall } from '../errors/index.mjs';
 /**
- * Formats a currency amount using the Intl.NumberFormat API
+ * Formats a currency amount using the Intl.NumberFormat API.
+ * All inputs are validated and normalized to two decimal places.
  *
- * @param amount - The amount in cents (e.g., 1000 for $10.00) as number or string
- * @param currency - The currency code (e.g., 'USD', 'EUR')
- * @param locale - The locale to use (e.g., 'en-US', 'fr-FR') - defaults to 'en-US'
+ * @param amount   - Amount as number or string ("0", "0.0", "0.00")
+ * @param currency - Currency code (e.g., 'USD', 'EUR')
+ * @param locale   - Locale (defaults to 'en-US')
  * @returns Formatted currency string
+ * @throws Error if the amount is invalid
  */
-export const formatCurrency = (amount, currency, locale) => {
-    const numericAmount = typeof amount === 'string' ? parseFloat(amount) : amount;
+export function formatCurrency(amount, currency, locale) {
+    let numericAmount;
+    if (typeof amount === 'string') {
+        // strict string validation: disallows "0.000", etc.
+        numericAmount = parseAmount(amount);
+    }
+    else {
+        // strict numeric validation + normalization
+        numericAmount = parseFloat(formatAmount(amount));
+    }
     return new Intl.NumberFormat(locale ?? 'en-US', {
         style: 'currency',
         currency: currency.toUpperCase(),
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
     }).format(numericAmount);
-};
+}
+/**
+ * Safely formats a currency amount.
+ *
+ * @param amount   - Amount as number or string
+ * @param currency - Currency code (e.g., 'USD')
+ * @param locale   - Locale (defaults to 'en-US')
+ * @returns A safe result containing the formatted currency string,
+ *          or an error message if the amount is invalid.
+ */
+export function safeFormatCurrency(amount, currency, locale) {
+    return safeCall(() => formatCurrency(amount, currency, locale), 'Invalid currency amount');
+}
 //# sourceMappingURL=currency.mjs.map

package/dist/lang/currency.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"currency.mjs","sourceRoot":"","sources":["../../src/lang/currency.mts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAuB,EACvB,QAAgB,EAChB,MAAe,EACP,EAAE;IACV,MAAM,aAAa,GACjB,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3D,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,OAAO,EAAE;QAC9C,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;KACjC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAC3B,CAAC,CAAC"}
+{"version":3,"file":"currency.mjs","sourceRoot":"","sources":["../../src/lang/currency.mts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AACvD,OAAO,EAAC,QAAQ,EAAa,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAuB,EACvB,QAAgB,EAChB,MAAe;IAEf,IAAI,aAAqB,CAAC;IAC1B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,oDAAoD;QACpD,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,4CAA4C;QAC5C,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,IAAI,OAAO,EAAE;QAC9C,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;QAChC,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;KACzB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAuB,EACvB,QAAgB,EAChB,MAAe;IAEf,OAAO,QAAQ,CACb,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAC9C,yBAAyB,CAC1B,CAAC;AACJ,CAAC"}

package/dist/lang/currency.test.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=currency.test.d.mts.map

package/dist/lang/currency.test.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.test.d.mts","sourceRoot":"","sources":["../../src/lang/currency.test.mts"],"names":[],"mappings":""}

package/dist/lang/currency.test.mjs

@@ -0,0 +1,97 @@
+import { test, expect, describe } from 'vitest';
+import { formatCurrency, safeFormatCurrency } from './currency.mjs';
+describe('formatCurrency', () => {
+    test('formats string amounts with USD', () => {
+        expect(formatCurrency('10', 'USD')).toBe('$10.00');
+        expect(formatCurrency('10.5', 'USD')).toBe('$10.50');
+        expect(formatCurrency('10.99', 'USD')).toBe('$10.99');
+        expect(formatCurrency('0', 'USD')).toBe('$0.00');
+    });
+    test('formats number amounts with USD', () => {
+        expect(formatCurrency(10, 'USD')).toBe('$10.00');
+        expect(formatCurrency(10.5, 'USD')).toBe('$10.50');
+        expect(formatCurrency(10.99, 'USD')).toBe('$10.99');
+        expect(formatCurrency(0, 'USD')).toBe('$0.00');
+    });
+    test('formats negative amounts', () => {
+        expect(formatCurrency('-10.50', 'USD')).toBe('-$10.50');
+        expect(formatCurrency(-10.5, 'USD')).toBe('-$10.50');
+    });
+    test('handles different currencies', () => {
+        expect(formatCurrency('10', 'EUR')).toBe('€10.00');
+        expect(formatCurrency('10', 'GBP')).toBe('£10.00');
+        expect(formatCurrency('10', 'JPY')).toBe('¥10.00');
+    });
+    test('handles lowercase currency codes', () => {
+        expect(formatCurrency('10', 'usd')).toBe('$10.00');
+        expect(formatCurrency('10', 'eur')).toBe('€10.00');
+    });
+    test('formats with different locales', () => {
+        // German locale uses different formatting
+        expect(formatCurrency('1234.56', 'EUR', 'de-DE')).toBe('1.234,56\u00A0€');
+        // Japanese locale (uses fullwidth yen symbol ￥)
+        expect(formatCurrency('1234.56', 'JPY', 'ja-JP')).toBe('￥1,234.56');
+        // US locale (default)
+        expect(formatCurrency('1234.56', 'USD', 'en-US')).toBe('$1,234.56');
+    });
+    test('validates and normalizes numeric precision', () => {
+        // Numbers with valid precision are formatted correctly
+        expect(formatCurrency(10.5, 'USD')).toBe('$10.50');
+        expect(formatCurrency(10.99, 'USD')).toBe('$10.99');
+    });
+    test('throws on invalid string amounts', () => {
+        expect(() => formatCurrency('invalid', 'USD')).toThrow('Invalid amount format');
+        expect(() => formatCurrency('10.000', 'USD')).toThrow('Invalid amount format');
+        expect(() => formatCurrency('$10.00', 'USD')).toThrow('Invalid amount format');
+    });
+    test('throws on invalid numeric amounts', () => {
+        expect(() => formatCurrency(NaN, 'USD')).toThrow('Amount must be a finite number');
+        expect(() => formatCurrency(Infinity, 'USD')).toThrow('Amount must be a finite number');
+        expect(() => formatCurrency(10.999, 'USD')).toThrow('Invalid amount format');
+    });
+    test('uses en-US locale by default', () => {
+        expect(formatCurrency('1234.56', 'USD')).toBe('$1,234.56');
+    });
+    test('handles large amounts', () => {
+        expect(formatCurrency('1000000', 'USD')).toBe('$1,000,000.00');
+        expect(formatCurrency('1000000.99', 'USD')).toBe('$1,000,000.99');
+    });
+});
+describe('safeFormatCurrency', () => {
+    test('returns success for valid string amounts', () => {
+        const result = safeFormatCurrency('10.50', 'USD');
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.output).toBe('$10.50');
+        }
+    });
+    test('returns success for valid numeric amounts', () => {
+        const result = safeFormatCurrency(10.5, 'USD');
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.output).toBe('$10.50');
+        }
+    });
+    test('returns error for invalid string amounts', () => {
+        const result = safeFormatCurrency('invalid', 'USD');
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error).toBe('Invalid amount format: "invalid"');
+        }
+    });
+    test('returns error for invalid numeric amounts', () => {
+        const result = safeFormatCurrency(NaN, 'USD');
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error).toBe('Amount must be a finite number');
+        }
+    });
+    test('returns error for excessive precision', () => {
+        const result = safeFormatCurrency(10.999, 'USD');
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error).toBe('Invalid amount format: "10.999"');
+        }
+    });
+});
+//# sourceMappingURL=currency.test.mjs.map

package/dist/lang/currency.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.test.mjs","sourceRoot":"","sources":["../../src/lang/currency.test.mts"],"names":[],"mappings":"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"}

package/dist/lang/index.d.mts

@@ -1,3 +1,4 @@
+export * from './amount.mjs';
 export * from './currency.mjs';
 export * from './datetime.mjs';
 export * from './equality.mjs';

package/dist/lang/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/lang/index.mjs

@@ -1,3 +1,4 @@
+export * from './amount.mjs';
 export * from './currency.mjs';
 export * from './datetime.mjs';
 export * from './equality.mjs';

package/dist/lang/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/lang/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nr1e/commons",
   "description": "Common utilities for TypeScript projects",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "type": "module",
   "author": "NR1E, Inc.",
   "publishConfig": {
@@ -10,20 +10,20 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/nr1etech/lib-js.git"
+    "url": "https://github.com/nr1etech/public.git"
   },
   "files": [
     "dist"
   ],
   "devDependencies": {
     "@eslint/js": "latest",
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.2.0",
     "@types/uuid": "^10.0.0",
     "eslint": "9.39.2",
     "prettier": "3.8.1",
     "typescript": "5.4.5",
     "typescript-eslint": "8.38.0",
-    "vitest": "4.0.6"
+    "vitest": "4.0.18"
   },
   "dependencies": {
     "tslib": "^2.8.1",
@@ -35,6 +35,10 @@
       "import": "./dist/bitsnbytes/index.mjs",
       "types": "./dist/bitsnbytes/index.d.mts"
     },
+    "./business": {
+      "import": "./dist/business/index.mjs",
+      "types": "./dist/business/index.d.mts"
+    },
     "./encryption": {
       "import": "./dist/encryption/index.mjs",
       "types": "./dist/encryption/index.d.mts"
@@ -72,7 +76,7 @@
     "prebuild": "prettier --check . && eslint .",
     "build": "tsc",
     "watch": "tsc -w",
-    "test": "vitest run",
+    "test": "vitest run src",
     "clean": "rm -rf dist",
     "fmt": "prettier --write ."
   }