@nr1e/commons 0.3.1 → 0.3.3

package/README.md

@@ -5,6 +5,18 @@
 
 This project provides reusable components commonly needed in TypeScript projects.
 
+| Module                     | Description                                                                                   |
+| -------------------------- | --------------------------------------------------------------------------------------------- |
+| `@nr1e/commons/bitsnbytes` | Base64 encoding/decoding utilities                                                            |
+| `@nr1e/commons/encryption` | Cryptographic utilities including AES encryption and RSA encryption                           |
+| `@nr1e/commons/errors`     | Error handling utilities and custom error types                                               |
+| `@nr1e/commons/http`       | HTTP status codes and HTTP method constants                                                   |
+| `@nr1e/commons/ids`        | ID generation utilities (UUID v4/v7, KSUID)                                                   |
+| `@nr1e/commons/lang`       | Language utilities for currency, datetime, equality, merge, sleep, string, and type functions |
+| `@nr1e/commons/oauth`      | OAuth 2.0 cryptographic functions (PKCE)                                                      |
+| `@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

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":"AAAA,OAAO,EAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAC,cAAc,EAAE,kBAAkB,EAAC,MAAM,gBAAgB,CAAC;AAElE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;QAC1C,0CAA0C;QAC1C,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1E,gDAAgD;QAChD,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpE,sBAAsB;QACtB,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACtD,uDAAuD;QACvD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CACpD,uBAAuB,CACxB,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CACnD,uBAAuB,CACxB,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CACnD,uBAAuB,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAC9C,gCAAgC,CACjC,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CACnD,gCAAgC,CACjC,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CACjD,uBAAuB,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/D,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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.1",
+  "version": "0.3.3",
   "type": "module",
   "author": "NR1E, Inc.",
   "publishConfig": {
@@ -17,10 +17,10 @@
   ],
   "devDependencies": {
     "@eslint/js": "latest",
-    "@types/node": "^20.19.0",
+    "@types/node": "^25.0.10",
     "@types/uuid": "^10.0.0",
-    "eslint": "9.32.0",
-    "prettier": "3.6.2",
+    "eslint": "9.39.2",
+    "prettier": "3.8.1",
     "typescript": "5.4.5",
     "typescript-eslint": "8.38.0",
     "vitest": "4.0.6"
@@ -72,7 +72,7 @@
     "prebuild": "prettier --check . && eslint .",
     "build": "tsc",
     "watch": "tsc -w",
-    "test": "vitest run",
+    "test": "vitest run src",
     "clean": "rm -rf dist",
     "fmt": "prettier --write ."
   }