@cranberry-money/shared-utils 4.7.0 → 4.9.0

package/dist/filters.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared utility functions for filter operations
+ * Generic, reusable filter functions for managing filter states
+ */
+/**
+ * Checks if any filters are active
+ * @param filters - The filter object to check
+ * @param excludeFields - Fields to exclude from the active check (default: ['searchQuery'])
+ * @returns true if any filters are active, false otherwise
+ */
+export declare function hasActiveFilters<T extends Record<string, unknown>>(filters: T, excludeFields?: (keyof T)[]): boolean;
+/**
+ * Counts the number of active filters
+ * @param filters - The filter object to count
+ * @param excludeFields - Fields to exclude from the count (default: ['searchQuery'])
+ * @returns The number of active filters
+ */
+export declare function countActiveFilters<T extends Record<string, unknown>>(filters: T, excludeFields?: (keyof T)[]): number;
+/**
+ * Clears all filters except specified fields
+ * @param filters - The filter object to clear
+ * @param preserveFields - Fields to preserve when clearing (default: [])
+ * @returns A new filter object with cleared values
+ */
+export declare function clearAllFilters<T extends Record<string, unknown>>(filters: T, preserveFields?: (keyof T)[]): Partial<T>;
+/**
+ * Type-safe filter update helper
+ * @param currentFilters - The current filter state
+ * @param updates - The updates to apply
+ * @returns A new filter object with updates applied
+ */
+export declare function updateFilters<T extends Record<string, unknown>>(currentFilters: T, updates: Partial<T>): T;
+/**
+ * Checks if a filter value is empty
+ * @param value - The value to check
+ * @returns true if the value is empty, false otherwise
+ */
+export declare function isFilterEmpty(value: unknown): boolean;
+/**
+ * Removes empty filter values from an object
+ * @param filters - The filter object to clean
+ * @returns A new filter object with empty values removed
+ */
+export declare function removeEmptyFilters<T extends Record<string, unknown>>(filters: T): Partial<T>;
+/**
+ * Merges two filter objects, with the second object taking precedence
+ * @param baseFilters - The base filter object
+ * @param overrideFilters - The override filter object
+ * @returns A new merged filter object
+ */
+export declare function mergeFilters<T extends Record<string, unknown>>(baseFilters: T, overrideFilters: Partial<T>): T;
+/**
+ * Compares two filter objects for equality
+ * @param filters1 - The first filter object
+ * @param filters2 - The second filter object
+ * @returns true if the filters are equal, false otherwise
+ */
+export declare function areFiltersEqual<T extends Record<string, unknown>>(filters1: T, filters2: T): boolean;
+/**
+ * Creates a filter predicate function from a filter object
+ * @param filters - The filter object to create a predicate from
+ * @returns A predicate function that tests if an item matches the filters
+ */
+export declare function createFilterPredicate<T extends Record<string, unknown>, U extends Record<string, unknown>>(filters: T): (item: U) => boolean;
+//# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,EAAE,CAAC,EACV,aAAa,GAAE,CAAC,MAAM,CAAC,CAAC,EAA+B,GACtD,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,OAAO,EAAE,CAAC,EACV,aAAa,GAAE,CAAC,MAAM,CAAC,CAAC,EAA+B,GACtD,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,CAAC,EACV,cAAc,GAAE,CAAC,MAAM,CAAC,CAAC,EAAO,GAC/B,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAE1G;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAU5F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAE9G;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAkBpG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxG,OAAO,EAAE,CAAC,GACT,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAuBtB"}

package/dist/filters.js

@@ -0,0 +1,129 @@
+/**
+ * Shared utility functions for filter operations
+ * Generic, reusable filter functions for managing filter states
+ */
+/**
+ * Checks if any filters are active
+ * @param filters - The filter object to check
+ * @param excludeFields - Fields to exclude from the active check (default: ['searchQuery'])
+ * @returns true if any filters are active, false otherwise
+ */
+export function hasActiveFilters(filters, excludeFields = ['searchQuery']) {
+    const relevantEntries = Object.entries(filters).filter(([key]) => !excludeFields.includes(key));
+    return relevantEntries.some(([, value]) => value !== undefined && value !== null && value !== '' && !(Array.isArray(value) && value.length === 0));
+}
+/**
+ * Counts the number of active filters
+ * @param filters - The filter object to count
+ * @param excludeFields - Fields to exclude from the count (default: ['searchQuery'])
+ * @returns The number of active filters
+ */
+export function countActiveFilters(filters, excludeFields = ['searchQuery']) {
+    const relevantEntries = Object.entries(filters).filter(([key]) => !excludeFields.includes(key));
+    return relevantEntries.filter(([, value]) => value !== undefined && value !== null && value !== '' && !(Array.isArray(value) && value.length === 0)).length;
+}
+/**
+ * Clears all filters except specified fields
+ * @param filters - The filter object to clear
+ * @param preserveFields - Fields to preserve when clearing (default: [])
+ * @returns A new filter object with cleared values
+ */
+export function clearAllFilters(filters, preserveFields = []) {
+    const clearedFilters = {};
+    // Preserve specified fields
+    preserveFields.forEach((field) => {
+        if (field in filters) {
+            clearedFilters[field] = filters[field];
+        }
+    });
+    return clearedFilters;
+}
+/**
+ * Type-safe filter update helper
+ * @param currentFilters - The current filter state
+ * @param updates - The updates to apply
+ * @returns A new filter object with updates applied
+ */
+export function updateFilters(currentFilters, updates) {
+    return { ...currentFilters, ...updates };
+}
+/**
+ * Checks if a filter value is empty
+ * @param value - The value to check
+ * @returns true if the value is empty, false otherwise
+ */
+export function isFilterEmpty(value) {
+    return (value === undefined ||
+        value === null ||
+        value === '' ||
+        (Array.isArray(value) && value.length === 0) ||
+        (typeof value === 'object' && value !== null && Object.keys(value).length === 0));
+}
+/**
+ * Removes empty filter values from an object
+ * @param filters - The filter object to clean
+ * @returns A new filter object with empty values removed
+ */
+export function removeEmptyFilters(filters) {
+    const cleanedFilters = {};
+    Object.entries(filters).forEach(([key, value]) => {
+        if (!isFilterEmpty(value)) {
+            cleanedFilters[key] = value;
+        }
+    });
+    return cleanedFilters;
+}
+/**
+ * Merges two filter objects, with the second object taking precedence
+ * @param baseFilters - The base filter object
+ * @param overrideFilters - The override filter object
+ * @returns A new merged filter object
+ */
+export function mergeFilters(baseFilters, overrideFilters) {
+    return { ...baseFilters, ...overrideFilters };
+}
+/**
+ * Compares two filter objects for equality
+ * @param filters1 - The first filter object
+ * @param filters2 - The second filter object
+ * @returns true if the filters are equal, false otherwise
+ */
+export function areFiltersEqual(filters1, filters2) {
+    const keys1 = Object.keys(filters1);
+    const keys2 = Object.keys(filters2);
+    if (keys1.length !== keys2.length) {
+        return false;
+    }
+    return keys1.every((key) => {
+        const value1 = filters1[key];
+        const value2 = filters2[key];
+        if (Array.isArray(value1) && Array.isArray(value2)) {
+            return value1.length === value2.length && value1.every((v, i) => v === value2[i]);
+        }
+        return value1 === value2;
+    });
+}
+/**
+ * Creates a filter predicate function from a filter object
+ * @param filters - The filter object to create a predicate from
+ * @returns A predicate function that tests if an item matches the filters
+ */
+export function createFilterPredicate(filters) {
+    const activeFilters = removeEmptyFilters(filters);
+    const filterEntries = Object.entries(activeFilters);
+    if (filterEntries.length === 0) {
+        return () => true;
+    }
+    return (item) => {
+        return filterEntries.every(([key, filterValue]) => {
+            const itemValue = item[key];
+            if (Array.isArray(filterValue)) {
+                return filterValue.includes(itemValue);
+            }
+            if (typeof filterValue === 'string' && typeof itemValue === 'string') {
+                return itemValue.toLowerCase().includes(filterValue.toLowerCase());
+            }
+            return itemValue === filterValue;
+        });
+    };
+}

package/dist/index.d.ts

@@ -14,4 +14,7 @@ export { getTradeStatusBadge, getWithdrawalStatusBadge, getLiquidationStatusBadg
 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, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, } from './validation';
+export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';
 //# 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,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"}
+{"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,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -15,3 +15,6 @@ export { getTradeStatusBadge, getWithdrawalStatusBadge, getLiquidationStatusBadg
 // Portfolio utilities
 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, isValidPhoneFormat, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, isValidFullName, isValidDateOfBirth, formatPhoneNumber, isValidInvestmentAmount, hasMinimumSelection, isSelected, } from './validation';
+// Filter utilities
+export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';

package/dist/validation.d.ts

@@ -0,0 +1,205 @@
+/**
+ * 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 phone number appears to be in a valid format (less strict)
+ * @param phoneNumber - The phone number to validate
+ * @param minLength - Minimum length for the phone number (default: 8)
+ * @returns true if phone number appears valid, false otherwise
+ */
+export declare function isValidPhoneFormat(phoneNumber: string, minLength?: number): 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;
+/**
+ * Validates if a full name contains at least first and last name
+ * @param fullName - The full name to validate
+ * @param minParts - Minimum number of name parts required (default: 2)
+ * @returns true if appears to contain required name parts, false otherwise
+ */
+export declare function isValidFullName(fullName: string, minParts?: number): boolean;
+/**
+ * Validates if a date is a valid date of birth (not in future, reasonable age range)
+ * @param dateOfBirth - The date string in YYYY-MM-DD format
+ * @param minAge - Minimum age requirement (default: 13)
+ * @param maxAge - Maximum reasonable age (default: 120)
+ * @returns true if valid date of birth, false otherwise
+ */
+export declare function isValidDateOfBirth(dateOfBirth: string, minAge?: number, maxAge?: number): boolean;
+/**
+ * Formats a phone number by removing extra spaces and standardizing format
+ * @param phoneNumber - The phone number to format
+ * @returns The formatted phone number
+ */
+export declare function formatPhoneNumber(phoneNumber: string): string;
+/**
+ * Validates if investment amount is within acceptable range
+ * @param amount - The investment amount to validate
+ * @param minAmount - Minimum investment amount (default: 100)
+ * @param maxAmount - Maximum investment amount (default: 10000000)
+ * @returns true if amount is within range, false otherwise
+ */
+export declare function isValidInvestmentAmount(amount: number, minAmount?: number, maxAmount?: number): boolean;
+/**
+ * Validates if at least minimum number of items are selected
+ * @param items - Array of selected items
+ * @param minItems - Minimum number of items required (default: 1)
+ * @returns true if minimum items are selected, false otherwise
+ */
+export declare function hasMinimumSelection<T>(items: T[], minItems?: number): boolean;
+/**
+ * Validates if a value is selected (not null, undefined, or empty string)
+ * @param value - The value to check
+ * @returns true if value is selected, false otherwise
+ */
+export declare function isSelected(value: unknown): 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":"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"}

package/dist/validation.js

@@ -0,0 +1,275 @@
+/**
+ * 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 phone number appears to be in a valid format (less strict)
+ * @param phoneNumber - The phone number to validate
+ * @param minLength - Minimum length for the phone number (default: 8)
+ * @returns true if phone number appears valid, false otherwise
+ */
+export function isValidPhoneFormat(phoneNumber, minLength = 8) {
+    const trimmedPhone = phoneNumber.trim();
+    // Basic validation: must contain digits and common phone number characters
+    return trimmedPhone.length >= minLength && /^[+\-\s\d()]+$/.test(trimmedPhone);
+}
+/**
+ * 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);
+}
+/**
+ * Validates if a full name contains at least first and last name
+ * @param fullName - The full name to validate
+ * @param minParts - Minimum number of name parts required (default: 2)
+ * @returns true if appears to contain required name parts, false otherwise
+ */
+export function isValidFullName(fullName, minParts = 2) {
+    const trimmedName = fullName.trim();
+    const nameParts = trimmedName.split(/\s+/);
+    return nameParts.length >= minParts && nameParts.every((part) => part.length > 0);
+}
+/**
+ * Validates if a date is a valid date of birth (not in future, reasonable age range)
+ * @param dateOfBirth - The date string in YYYY-MM-DD format
+ * @param minAge - Minimum age requirement (default: 13)
+ * @param maxAge - Maximum reasonable age (default: 120)
+ * @returns true if valid date of birth, false otherwise
+ */
+export function isValidDateOfBirth(dateOfBirth, minAge = 13, maxAge = 120) {
+    if (!dateOfBirth)
+        return false;
+    const birthDate = new Date(dateOfBirth);
+    const today = new Date();
+    const age = today.getFullYear() - birthDate.getFullYear();
+    const monthDiff = today.getMonth() - birthDate.getMonth();
+    const dayDiff = today.getDate() - birthDate.getDate();
+    // Adjust age if birthday hasn't occurred this year
+    const actualAge = monthDiff < 0 || (monthDiff === 0 && dayDiff < 0) ? age - 1 : age;
+    return actualAge >= minAge && actualAge <= maxAge && birthDate <= today;
+}
+/**
+ * Formats a phone number by removing extra spaces and standardizing format
+ * @param phoneNumber - The phone number to format
+ * @returns The formatted phone number
+ */
+export function formatPhoneNumber(phoneNumber) {
+    return phoneNumber.trim();
+}
+/**
+ * Validates if investment amount is within acceptable range
+ * @param amount - The investment amount to validate
+ * @param minAmount - Minimum investment amount (default: 100)
+ * @param maxAmount - Maximum investment amount (default: 10000000)
+ * @returns true if amount is within range, false otherwise
+ */
+export function isValidInvestmentAmount(amount, minAmount = 100, maxAmount = 10000000) {
+    return amount >= minAmount && amount <= maxAmount;
+}
+/**
+ * Validates if at least minimum number of items are selected
+ * @param items - Array of selected items
+ * @param minItems - Minimum number of items required (default: 1)
+ * @returns true if minimum items are selected, false otherwise
+ */
+export function hasMinimumSelection(items, minItems = 1) {
+    return items && items.length >= minItems;
+}
+/**
+ * Validates if a value is selected (not null, undefined, or empty string)
+ * @param value - The value to check
+ * @returns true if value is selected, false otherwise
+ */
+export function isSelected(value) {
+    return value !== null && value !== undefined && value !== '';
+}

package/dist/withdrawal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../src/withdrawal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;;;;;;;;;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,EACjF,YAAY,EAAE,CAAC,EAAE,GAChB,MAAM,CAIR"}
+{"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

@@ -5,7 +5,7 @@
  * 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 { 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
@@ -82,10 +82,10 @@ export function formatSharesQuantity(shares) {
  */
 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 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,

package/package.json

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