@cranberry-money/shared-utils 4.8.0 → 4.10.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,CAW5F;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,130 @@
+/**
+ * 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.keys(filters).forEach(key => {
+        const value = filters[key];
+        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

@@ -15,5 +15,6 @@ export { formatPortfolioValue, calculateTotalValue, getMarketAllocation, getCash
 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';
+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;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"}
+{"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,4 +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, isValidUrl, isValidDate, isEmptyOrWhitespace, meetsMinLength, meetsMaxLength, isInRange, isPositiveNumber, isNonNegativeNumber, } 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';
+// Filter utilities
+export { hasActiveFilters, countActiveFilters, clearAllFilters, updateFilters, isFilterEmpty, removeEmptyFilters, mergeFilters, areFiltersEqual, createFilterPredicate, } from './filters';

package/dist/validation.d.ts

@@ -101,6 +101,13 @@ export declare function validatePasswordExtended(password: string, minLength?: n
  * @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
@@ -153,4 +160,46 @@ export declare function isPositiveNumber(value: number): boolean;
  * @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

@@ -1 +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"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/dist/validation.js

@@ -85,7 +85,7 @@ export function hasLowercase(str) {
  * @returns true if contains special character, false otherwise
  */
 export function hasSpecialCharacter(str) {
-    return /[!@#$%^&*()_+\-=\[\]{};':"\\|,.<>\/?]/.test(str);
+    return /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(str);
 }
 /**
  * Validates if a string contains at least one digit
@@ -118,10 +118,21 @@ export function validatePasswordExtended(password, minLength = 8) {
  */
 export function isValidPhoneNumber(phoneNumber) {
     // Remove common formatting characters
-    const cleaned = phoneNumber.replace(/[\s\-\(\)\.]/g, '');
+    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
@@ -197,3 +208,68 @@ export function isPositiveNumber(value) {
 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/package.json

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