@cranberry-money/shared-utils 4.6.0 → 4.8.0

package/dist/index.d.ts

@@ -11,5 +11,9 @@ export type { BadgeVariant, BadgeSize, BadgeConfig, BadgeStyle } from './badge';
 export { createBadge, BADGE_VARIANTS, BADGE_SIZES } from './badge';
 export type { StatusBadgeStyle, TradeStatus, WithdrawalStatus, LiquidationStatus, TargetTradeStatus, } from './badge-status';
 export { getTradeStatusBadge, getWithdrawalStatusBadge, getLiquidationStatusBadge, getTargetTradeStatusBadge, } from './badge-status';
-export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCashAllocation, } from './portfolio';
+export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCashAllocation } from './portfolio';
+export type { LiquidationProgress } from './withdrawal';
+export { formatWithdrawalAmount, formatLiquidationValue, formatSharesQuantity, calculateLiquidationProgress, getTotalEstimatedValue, } from './withdrawal';
+export type { PasswordValidation, EmailConfirmationValidation, ExtendedPasswordValidation } from './validation';
+export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, } from './validation';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGjF,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,EACrC,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGnE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGjF,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,EACrC,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGnE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhH,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAChH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -13,4 +13,6 @@ export { NUMBER_FORMAT_OPTIONS_CURRENCY, NUMBER_FORMAT_OPTIONS_CURRENCY_SIGNED,
 export { createBadge, BADGE_VARIANTS, BADGE_SIZES } from './badge';
 export { getTradeStatusBadge, getWithdrawalStatusBadge, getLiquidationStatusBadge, getTargetTradeStatusBadge, } from './badge-status';
 // Portfolio utilities
-export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCashAllocation, } from './portfolio';
+export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCashAllocation } from './portfolio';
+export { formatWithdrawalAmount, formatLiquidationValue, formatSharesQuantity, calculateLiquidationProgress, getTotalEstimatedValue, } from './withdrawal';
+export { isNumericOnly, validatePassword, isValidTokenFormat, formatVerificationToken, validateEmailConfirmation, isValidEmail, hasUppercase, hasLowercase, hasSpecialCharacter, hasDigit, validatePasswordExtended, isValidPhoneNumber, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, } from './validation';

package/dist/portfolio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../src/portfolio.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAItG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIrG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAInG"}
+{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../src/portfolio.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAItG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIrG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAInG"}

package/dist/portfolio.js

@@ -5,7 +5,7 @@
  * allocations, and formatting. All functions handle string or number inputs
  * for flexibility with API responses.
  */
-import { LOCALE_AUSTRALIA, DEFAULT_NUMERIC_ZERO, DEFAULT_EMPTY_STRING, CURRENCY_AUD } from '@cranberry-money/shared-constants';
+import { LOCALE_AUSTRALIA, DEFAULT_NUMERIC_ZERO, DEFAULT_EMPTY_STRING, CURRENCY_AUD, } from '@cranberry-money/shared-constants';
 import { NUMBER_FORMAT_OPTIONS_CURRENCY } from './currency';
 /**
  * Formats a portfolio value as currency with AUD

package/dist/validation.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Validation utility functions
+ */
+/**
+ * Checks if a string contains only numeric characters
+ * @param str - The string to validate
+ * @returns true if the string contains only digits, false otherwise
+ */
+export declare function isNumericOnly(str: string): boolean;
+/**
+ * Password validation result interface
+ */
+export interface PasswordValidation {
+    lengthValid: boolean;
+    notNumeric: boolean;
+}
+/**
+ * Validates password strength based on minimum requirements
+ * @param password - The password to validate
+ * @param minLength - Minimum password length (default: 8)
+ * @returns An object containing validation results
+ */
+export declare function validatePassword(password: string, minLength?: number): PasswordValidation;
+/**
+ * Validates if a verification token is in the expected format
+ * @param token - The verification token to validate
+ * @param minLength - Minimum token length (default: 6)
+ * @returns true if token appears to be valid format, false otherwise
+ */
+export declare function isValidTokenFormat(token: string, minLength?: number): boolean;
+/**
+ * Formats a verification token by removing whitespace and converting to uppercase
+ * @param token - The token to format
+ * @returns The formatted token
+ */
+export declare function formatVerificationToken(token: string): string;
+/**
+ * Email confirmation validation result interface
+ */
+export interface EmailConfirmationValidation {
+    isValid: boolean;
+    isEmpty: boolean;
+    isValidFormat: boolean;
+}
+/**
+ * Validates email confirmation form data
+ * @param token - The verification token
+ * @param minLength - Minimum token length (default: 6)
+ * @returns An object containing validation results
+ */
+export declare function validateEmailConfirmation(token: string, minLength?: number): EmailConfirmationValidation;
+/**
+ * Validates if an email address is in a valid format
+ * @param email - The email address to validate
+ * @returns true if email format is valid, false otherwise
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validates if a string contains at least one uppercase letter
+ * @param str - The string to validate
+ * @returns true if contains uppercase, false otherwise
+ */
+export declare function hasUppercase(str: string): boolean;
+/**
+ * Validates if a string contains at least one lowercase letter
+ * @param str - The string to validate
+ * @returns true if contains lowercase, false otherwise
+ */
+export declare function hasLowercase(str: string): boolean;
+/**
+ * Validates if a string contains at least one special character
+ * @param str - The string to validate
+ * @returns true if contains special character, false otherwise
+ */
+export declare function hasSpecialCharacter(str: string): boolean;
+/**
+ * Validates if a string contains at least one digit
+ * @param str - The string to validate
+ * @returns true if contains digit, false otherwise
+ */
+export declare function hasDigit(str: string): boolean;
+/**
+ * Extended password validation result interface
+ */
+export interface ExtendedPasswordValidation extends PasswordValidation {
+    hasUppercase: boolean;
+    hasLowercase: boolean;
+    hasSpecialCharacter: boolean;
+    hasDigit: boolean;
+}
+/**
+ * Performs extended password validation with additional strength checks
+ * @param password - The password to validate
+ * @param minLength - Minimum password length (default: 8)
+ * @returns An object containing detailed validation results
+ */
+export declare function validatePasswordExtended(password: string, minLength?: number): ExtendedPasswordValidation;
+/**
+ * Validates if a phone number is in a valid format
+ * @param phoneNumber - The phone number to validate
+ * @returns true if phone number format is valid, false otherwise
+ */
+export declare function isValidPhoneNumber(phoneNumber: string): boolean;
+/**
+ * Validates if a URL is in a valid format
+ * @param url - The URL to validate
+ * @returns true if URL format is valid, false otherwise
+ */
+export declare function isValidUrl(url: string): boolean;
+/**
+ * Validates if a date string is in a valid format
+ * @param dateString - The date string to validate
+ * @returns true if date format is valid, false otherwise
+ */
+export declare function isValidDate(dateString: string): boolean;
+/**
+ * Validates if a string is empty or contains only whitespace
+ * @param str - The string to validate
+ * @returns true if string is empty or whitespace only, false otherwise
+ */
+export declare function isEmptyOrWhitespace(str: string): boolean;
+/**
+ * Validates if a string meets a minimum length requirement
+ * @param str - The string to validate
+ * @param minLength - The minimum length required
+ * @returns true if string meets minimum length, false otherwise
+ */
+export declare function meetsMinLength(str: string, minLength: number): boolean;
+/**
+ * Validates if a string meets a maximum length requirement
+ * @param str - The string to validate
+ * @param maxLength - The maximum length allowed
+ * @returns true if string meets maximum length, false otherwise
+ */
+export declare function meetsMaxLength(str: string, maxLength: number): boolean;
+/**
+ * Validates if a number is within a specified range
+ * @param value - The number to validate
+ * @param min - The minimum value (inclusive)
+ * @param max - The maximum value (inclusive)
+ * @returns true if number is within range, false otherwise
+ */
+export declare function isInRange(value: number, min: number, max: number): boolean;
+/**
+ * Validates if a value is a positive number
+ * @param value - The value to validate
+ * @returns true if value is a positive number, false otherwise
+ */
+export declare function isPositiveNumber(value: number): boolean;
+/**
+ * Validates if a value is a non-negative number
+ * @param value - The value to validate
+ * @returns true if value is a non-negative number, false otherwise
+ */
+export declare function isNonNegativeNumber(value: number): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,kBAAkB,CAKpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,OAAO,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,2BAA2B,CAQnG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,0BAA0B,CAUpG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/validation.js

@@ -0,0 +1,199 @@
+/**
+ * Validation utility functions
+ */
+/**
+ * Checks if a string contains only numeric characters
+ * @param str - The string to validate
+ * @returns true if the string contains only digits, false otherwise
+ */
+export function isNumericOnly(str) {
+    return /^\d+$/.test(str);
+}
+/**
+ * Validates password strength based on minimum requirements
+ * @param password - The password to validate
+ * @param minLength - Minimum password length (default: 8)
+ * @returns An object containing validation results
+ */
+export function validatePassword(password, minLength = 8) {
+    return {
+        lengthValid: password.length >= minLength,
+        notNumeric: !isNumericOnly(password),
+    };
+}
+/**
+ * Validates if a verification token is in the expected format
+ * @param token - The verification token to validate
+ * @param minLength - Minimum token length (default: 6)
+ * @returns true if token appears to be valid format, false otherwise
+ */
+export function isValidTokenFormat(token, minLength = 6) {
+    const trimmedToken = token.trim();
+    // Assuming tokens are alphanumeric and meet minimum length
+    return trimmedToken.length >= minLength && /^[a-zA-Z0-9]+$/.test(trimmedToken);
+}
+/**
+ * Formats a verification token by removing whitespace and converting to uppercase
+ * @param token - The token to format
+ * @returns The formatted token
+ */
+export function formatVerificationToken(token) {
+    return token.trim().toUpperCase();
+}
+/**
+ * Validates email confirmation form data
+ * @param token - The verification token
+ * @param minLength - Minimum token length (default: 6)
+ * @returns An object containing validation results
+ */
+export function validateEmailConfirmation(token, minLength = 6) {
+    const formattedToken = formatVerificationToken(token);
+    return {
+        isValid: formattedToken.length > 0 && isValidTokenFormat(formattedToken, minLength),
+        isEmpty: formattedToken.length === 0,
+        isValidFormat: isValidTokenFormat(formattedToken, minLength),
+    };
+}
+/**
+ * Validates if an email address is in a valid format
+ * @param email - The email address to validate
+ * @returns true if email format is valid, false otherwise
+ */
+export function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email.trim());
+}
+/**
+ * Validates if a string contains at least one uppercase letter
+ * @param str - The string to validate
+ * @returns true if contains uppercase, false otherwise
+ */
+export function hasUppercase(str) {
+    return /[A-Z]/.test(str);
+}
+/**
+ * Validates if a string contains at least one lowercase letter
+ * @param str - The string to validate
+ * @returns true if contains lowercase, false otherwise
+ */
+export function hasLowercase(str) {
+    return /[a-z]/.test(str);
+}
+/**
+ * Validates if a string contains at least one special character
+ * @param str - The string to validate
+ * @returns true if contains special character, false otherwise
+ */
+export function hasSpecialCharacter(str) {
+    return /[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?]/.test(str);
+}
+/**
+ * Validates if a string contains at least one digit
+ * @param str - The string to validate
+ * @returns true if contains digit, false otherwise
+ */
+export function hasDigit(str) {
+    return /\d/.test(str);
+}
+/**
+ * Performs extended password validation with additional strength checks
+ * @param password - The password to validate
+ * @param minLength - Minimum password length (default: 8)
+ * @returns An object containing detailed validation results
+ */
+export function validatePasswordExtended(password, minLength = 8) {
+    const basicValidation = validatePassword(password, minLength);
+    return {
+        ...basicValidation,
+        hasUppercase: hasUppercase(password),
+        hasLowercase: hasLowercase(password),
+        hasSpecialCharacter: hasSpecialCharacter(password),
+        hasDigit: hasDigit(password),
+    };
+}
+/**
+ * Validates if a phone number is in a valid format
+ * @param phoneNumber - The phone number to validate
+ * @returns true if phone number format is valid, false otherwise
+ */
+export function isValidPhoneNumber(phoneNumber) {
+    // Remove common formatting characters
+    const cleaned = phoneNumber.replace(/[\s\-\(\)\.]/g, '');
+    // Check if it's a valid phone number (digits only, 10-15 digits)
+    return /^\+?\d{10,15}$/.test(cleaned);
+}
+/**
+ * Validates if a URL is in a valid format
+ * @param url - The URL to validate
+ * @returns true if URL format is valid, false otherwise
+ */
+export function isValidUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validates if a date string is in a valid format
+ * @param dateString - The date string to validate
+ * @returns true if date format is valid, false otherwise
+ */
+export function isValidDate(dateString) {
+    const date = new Date(dateString);
+    return !isNaN(date.getTime());
+}
+/**
+ * Validates if a string is empty or contains only whitespace
+ * @param str - The string to validate
+ * @returns true if string is empty or whitespace only, false otherwise
+ */
+export function isEmptyOrWhitespace(str) {
+    return str.trim().length === 0;
+}
+/**
+ * Validates if a string meets a minimum length requirement
+ * @param str - The string to validate
+ * @param minLength - The minimum length required
+ * @returns true if string meets minimum length, false otherwise
+ */
+export function meetsMinLength(str, minLength) {
+    return str.length >= minLength;
+}
+/**
+ * Validates if a string meets a maximum length requirement
+ * @param str - The string to validate
+ * @param maxLength - The maximum length allowed
+ * @returns true if string meets maximum length, false otherwise
+ */
+export function meetsMaxLength(str, maxLength) {
+    return str.length <= maxLength;
+}
+/**
+ * Validates if a number is within a specified range
+ * @param value - The number to validate
+ * @param min - The minimum value (inclusive)
+ * @param max - The maximum value (inclusive)
+ * @returns true if number is within range, false otherwise
+ */
+export function isInRange(value, min, max) {
+    return value >= min && value <= max;
+}
+/**
+ * Validates if a value is a positive number
+ * @param value - The value to validate
+ * @returns true if value is a positive number, false otherwise
+ */
+export function isPositiveNumber(value) {
+    return typeof value === 'number' && value > 0 && isFinite(value);
+}
+/**
+ * Validates if a value is a non-negative number
+ * @param value - The value to validate
+ * @returns true if value is a non-negative number, false otherwise
+ */
+export function isNonNegativeNumber(value) {
+    return typeof value === 'number' && value >= 0 && isFinite(value);
+}

package/dist/withdrawal.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Withdrawal-related utility functions
+ *
+ * This module provides pure functions for formatting withdrawal amounts,
+ * calculating liquidation progress, and other withdrawal-related operations.
+ * Functions are designed to work with generic types to maintain flexibility.
+ */
+/**
+ * Formats a withdrawal amount as currency
+ *
+ * @param amount - Withdrawal amount as string or number
+ * @returns Formatted currency string with AUD symbol
+ *
+ * @example
+ * ```typescript
+ * formatWithdrawalAmount(5000) // 'A$5,000.00'
+ * formatWithdrawalAmount('5000.50') // 'A$5,000.50'
+ * ```
+ */
+export declare function formatWithdrawalAmount(amount: string | number): string;
+/**
+ * Formats a liquidation value as currency
+ *
+ * @param value - Liquidation value as string or number
+ * @returns Formatted currency string with AUD symbol
+ *
+ * @example
+ * ```typescript
+ * formatLiquidationValue(10000) // 'A$10,000.00'
+ * formatLiquidationValue('10000.50') // 'A$10,000.50'
+ * ```
+ */
+export declare function formatLiquidationValue(value: string | number): string;
+/**
+ * Formats share quantity without decimal places
+ *
+ * @param shares - Number of shares
+ * @returns Formatted number string with thousands separators
+ *
+ * @example
+ * ```typescript
+ * formatSharesQuantity(1234) // '1,234'
+ * formatSharesQuantity(1234567) // '1,234,567'
+ * ```
+ */
+export declare function formatSharesQuantity(shares: number): string;
+/**
+ * Progress calculation result for liquidations
+ */
+export interface LiquidationProgress {
+    total: number;
+    pending: number;
+    inProgress: number;
+    completed: number;
+    failed: number;
+    completionRate: number;
+}
+/**
+ * Calculates liquidation progress statistics
+ *
+ * @param liquidations - Array of liquidation objects with liquidationStatus property
+ * @returns Progress statistics including counts and completion rate
+ *
+ * @example
+ * ```typescript
+ * const liquidations = [
+ *   { liquidationStatus: 'PENDING' },
+ *   { liquidationStatus: 'SETTLED' },
+ *   { liquidationStatus: 'FAILED' }
+ * ];
+ * calculateLiquidationProgress(liquidations)
+ * // Returns: { total: 3, pending: 1, inProgress: 0, completed: 1, failed: 1, completionRate: 33.33 }
+ * ```
+ */
+export declare function calculateLiquidationProgress<T extends {
+    liquidationStatus: string;
+}>(liquidations: T[]): LiquidationProgress;
+/**
+ * Calculates total estimated value from liquidations
+ *
+ * @param liquidations - Array of liquidation objects with estimatedValue property
+ * @returns Total estimated value as number
+ *
+ * @example
+ * ```typescript
+ * const liquidations = [
+ *   { estimatedValue: '1000.50' },
+ *   { estimatedValue: '2000' },
+ *   { estimatedValue: null }
+ * ];
+ * getTotalEstimatedValue(liquidations) // 3000.50
+ * ```
+ */
+export declare function getTotalEstimatedValue<T extends {
+    estimatedValue?: string | null;
+}>(liquidations: T[]): number;
+//# sourceMappingURL=withdrawal.d.ts.map

package/dist/withdrawal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../src/withdrawal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAMrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,EAClF,YAAY,EAAE,CAAC,EAAE,GAChB,mBAAmB,CAkBrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,MAAM,CAI9G"}

package/dist/withdrawal.js

@@ -0,0 +1,119 @@
+/**
+ * Withdrawal-related utility functions
+ *
+ * This module provides pure functions for formatting withdrawal amounts,
+ * calculating liquidation progress, and other withdrawal-related operations.
+ * Functions are designed to work with generic types to maintain flexibility.
+ */
+import { LOCALE_AUSTRALIA, CURRENCY_AUD, LIQUIDATION_STATUS_PENDING, LIQUIDATION_STATUS_TRADES_CREATED, LIQUIDATION_STATUS_EXECUTED, LIQUIDATION_STATUS_SETTLED, LIQUIDATION_STATUS_FAILED, } from '@cranberry-money/shared-constants';
+import { NUMBER_FORMAT_OPTIONS_CURRENCY } from './currency';
+/**
+ * Formats a withdrawal amount as currency
+ *
+ * @param amount - Withdrawal amount as string or number
+ * @returns Formatted currency string with AUD symbol
+ *
+ * @example
+ * ```typescript
+ * formatWithdrawalAmount(5000) // 'A$5,000.00'
+ * formatWithdrawalAmount('5000.50') // 'A$5,000.50'
+ * ```
+ */
+export function formatWithdrawalAmount(amount) {
+    const numValue = typeof amount === 'string' ? parseFloat(amount) : amount;
+    return new Intl.NumberFormat(LOCALE_AUSTRALIA, {
+        ...NUMBER_FORMAT_OPTIONS_CURRENCY,
+        currency: CURRENCY_AUD,
+    }).format(numValue);
+}
+/**
+ * Formats a liquidation value as currency
+ *
+ * @param value - Liquidation value as string or number
+ * @returns Formatted currency string with AUD symbol
+ *
+ * @example
+ * ```typescript
+ * formatLiquidationValue(10000) // 'A$10,000.00'
+ * formatLiquidationValue('10000.50') // 'A$10,000.50'
+ * ```
+ */
+export function formatLiquidationValue(value) {
+    const numValue = typeof value === 'string' ? parseFloat(value) : value;
+    return new Intl.NumberFormat(LOCALE_AUSTRALIA, {
+        ...NUMBER_FORMAT_OPTIONS_CURRENCY,
+        currency: CURRENCY_AUD,
+    }).format(numValue);
+}
+/**
+ * Formats share quantity without decimal places
+ *
+ * @param shares - Number of shares
+ * @returns Formatted number string with thousands separators
+ *
+ * @example
+ * ```typescript
+ * formatSharesQuantity(1234) // '1,234'
+ * formatSharesQuantity(1234567) // '1,234,567'
+ * ```
+ */
+export function formatSharesQuantity(shares) {
+    return new Intl.NumberFormat(LOCALE_AUSTRALIA, {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 0,
+    }).format(shares);
+}
+/**
+ * Calculates liquidation progress statistics
+ *
+ * @param liquidations - Array of liquidation objects with liquidationStatus property
+ * @returns Progress statistics including counts and completion rate
+ *
+ * @example
+ * ```typescript
+ * const liquidations = [
+ *   { liquidationStatus: 'PENDING' },
+ *   { liquidationStatus: 'SETTLED' },
+ *   { liquidationStatus: 'FAILED' }
+ * ];
+ * calculateLiquidationProgress(liquidations)
+ * // Returns: { total: 3, pending: 1, inProgress: 0, completed: 1, failed: 1, completionRate: 33.33 }
+ * ```
+ */
+export function calculateLiquidationProgress(liquidations) {
+    const total = liquidations.length;
+    const pending = liquidations.filter(l => l.liquidationStatus === LIQUIDATION_STATUS_PENDING).length;
+    const inProgress = liquidations.filter(l => [LIQUIDATION_STATUS_TRADES_CREATED, LIQUIDATION_STATUS_EXECUTED].includes(l.liquidationStatus)).length;
+    const completed = liquidations.filter(l => l.liquidationStatus === LIQUIDATION_STATUS_SETTLED).length;
+    const failed = liquidations.filter(l => l.liquidationStatus === LIQUIDATION_STATUS_FAILED).length;
+    const completionRate = total > 0 ? (completed / total) * 100 : 0;
+    return {
+        total,
+        pending,
+        inProgress,
+        completed,
+        failed,
+        completionRate,
+    };
+}
+/**
+ * Calculates total estimated value from liquidations
+ *
+ * @param liquidations - Array of liquidation objects with estimatedValue property
+ * @returns Total estimated value as number
+ *
+ * @example
+ * ```typescript
+ * const liquidations = [
+ *   { estimatedValue: '1000.50' },
+ *   { estimatedValue: '2000' },
+ *   { estimatedValue: null }
+ * ];
+ * getTotalEstimatedValue(liquidations) // 3000.50
+ * ```
+ */
+export function getTotalEstimatedValue(liquidations) {
+    return liquidations.reduce((total, liquidation) => {
+        return total + parseFloat(liquidation.estimatedValue || '0');
+    }, 0);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cranberry-money/shared-utils",
-  "version": "4.6.0",
+  "version": "4.8.0",
   "description": "Shared utility functions for MyPortfolio platform",
   "type": "module",
   "main": "dist/index.js",