@cranberry-money/shared-utils 4.15.0 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/package.json +1 -1
  2. package/dist/auth.d.ts +0 -55
  3. package/dist/auth.d.ts.map +0 -1
  4. package/dist/auth.js +0 -135
  5. package/dist/badge-status.d.ts +0 -87
  6. package/dist/badge-status.d.ts.map +0 -1
  7. package/dist/badge-status.js +0 -170
  8. package/dist/badge.d.ts +0 -68
  9. package/dist/badge.d.ts.map +0 -1
  10. package/dist/badge.js +0 -71
  11. package/dist/collections.d.ts +0 -81
  12. package/dist/collections.d.ts.map +0 -1
  13. package/dist/collections.js +0 -127
  14. package/dist/currency.d.ts +0 -99
  15. package/dist/currency.d.ts.map +0 -1
  16. package/dist/currency.js +0 -128
  17. package/dist/date.d.ts +0 -64
  18. package/dist/date.d.ts.map +0 -1
  19. package/dist/date.js +0 -91
  20. package/dist/downloads.d.ts +0 -46
  21. package/dist/downloads.d.ts.map +0 -1
  22. package/dist/downloads.js +0 -91
  23. package/dist/filters.d.ts +0 -121
  24. package/dist/filters.d.ts.map +0 -1
  25. package/dist/filters.js +0 -206
  26. package/dist/formatting.d.ts +0 -59
  27. package/dist/formatting.d.ts.map +0 -1
  28. package/dist/formatting.js +0 -81
  29. package/dist/index.d.ts +0 -28
  30. package/dist/index.d.ts.map +0 -1
  31. package/dist/index.js +0 -34
  32. package/dist/instruments.d.ts +0 -118
  33. package/dist/instruments.d.ts.map +0 -1
  34. package/dist/instruments.js +0 -135
  35. package/dist/numbers.d.ts +0 -72
  36. package/dist/numbers.d.ts.map +0 -1
  37. package/dist/numbers.js +0 -101
  38. package/dist/portfolio.d.ts +0 -68
  39. package/dist/portfolio.d.ts.map +0 -1
  40. package/dist/portfolio.js +0 -87
  41. package/dist/text.d.ts +0 -22
  42. package/dist/text.d.ts.map +0 -1
  43. package/dist/text.js +0 -25
  44. package/dist/validation.d.ts +0 -249
  45. package/dist/validation.d.ts.map +0 -1
  46. package/dist/validation.js +0 -337
  47. package/dist/withdrawal.d.ts +0 -97
  48. package/dist/withdrawal.d.ts.map +0 -1
  49. package/dist/withdrawal.js +0 -119
@@ -1,249 +0,0 @@
1
- /**
2
- * Validation utility functions
3
- */
4
- /**
5
- * Checks if a string contains only numeric characters
6
- * @param str - The string to validate
7
- * @returns true if the string contains only digits, false otherwise
8
- */
9
- export declare function isNumericOnly(str: string): boolean;
10
- /**
11
- * Password validation result interface
12
- */
13
- export interface PasswordValidation {
14
- lengthValid: boolean;
15
- notNumeric: boolean;
16
- }
17
- /**
18
- * Validates password strength based on minimum requirements
19
- * @param password - The password to validate
20
- * @param minLength - Minimum password length (default: 8)
21
- * @returns An object containing validation results
22
- */
23
- export declare function validatePassword(password: string, minLength?: number): PasswordValidation;
24
- /**
25
- * Validates if a verification token is in the expected format
26
- * @param token - The verification token to validate
27
- * @param minLength - Minimum token length (default: 6)
28
- * @returns true if token appears to be valid format, false otherwise
29
- */
30
- export declare function isValidTokenFormat(token: string, minLength?: number): boolean;
31
- /**
32
- * Formats a verification token by removing whitespace and converting to uppercase
33
- * @param token - The token to format
34
- * @returns The formatted token
35
- */
36
- export declare function formatVerificationToken(token: string): string;
37
- /**
38
- * Email confirmation validation result interface
39
- */
40
- export interface EmailConfirmationValidation {
41
- isValid: boolean;
42
- isEmpty: boolean;
43
- isValidFormat: boolean;
44
- }
45
- /**
46
- * Validates email confirmation form data
47
- * @param token - The verification token
48
- * @param minLength - Minimum token length (default: 6)
49
- * @returns An object containing validation results
50
- */
51
- export declare function validateEmailConfirmation(token: string, minLength?: number): EmailConfirmationValidation;
52
- /**
53
- * Validates if an email address is in a valid format
54
- * @param email - The email address to validate
55
- * @returns true if email format is valid, false otherwise
56
- */
57
- export declare function isValidEmail(email: string): boolean;
58
- /**
59
- * Validates if a string contains at least one uppercase letter
60
- * @param str - The string to validate
61
- * @returns true if contains uppercase, false otherwise
62
- */
63
- export declare function hasUppercase(str: string): boolean;
64
- /**
65
- * Validates if a string contains at least one lowercase letter
66
- * @param str - The string to validate
67
- * @returns true if contains lowercase, false otherwise
68
- */
69
- export declare function hasLowercase(str: string): boolean;
70
- /**
71
- * Validates if a string contains at least one special character
72
- * @param str - The string to validate
73
- * @returns true if contains special character, false otherwise
74
- */
75
- export declare function hasSpecialCharacter(str: string): boolean;
76
- /**
77
- * Validates if a string contains at least one digit
78
- * @param str - The string to validate
79
- * @returns true if contains digit, false otherwise
80
- */
81
- export declare function hasDigit(str: string): boolean;
82
- /**
83
- * Extended password validation result interface
84
- */
85
- export interface ExtendedPasswordValidation extends PasswordValidation {
86
- hasUppercase: boolean;
87
- hasLowercase: boolean;
88
- hasSpecialCharacter: boolean;
89
- hasDigit: boolean;
90
- }
91
- /**
92
- * Performs extended password validation with additional strength checks
93
- * @param password - The password to validate
94
- * @param minLength - Minimum password length (default: 8)
95
- * @returns An object containing detailed validation results
96
- */
97
- export declare function validatePasswordExtended(password: string, minLength?: number): ExtendedPasswordValidation;
98
- /**
99
- * Validates if a phone number is in a valid format
100
- * @param phoneNumber - The phone number to validate
101
- * @returns true if phone number format is valid, false otherwise
102
- */
103
- export declare function isValidPhoneNumber(phoneNumber: string): boolean;
104
- /**
105
- * Validates if a phone number appears to be in a valid format (less strict)
106
- * @param phoneNumber - The phone number to validate
107
- * @param minLength - Minimum length for the phone number (default: 8)
108
- * @returns true if phone number appears valid, false otherwise
109
- */
110
- export declare function isValidPhoneFormat(phoneNumber: string, minLength?: number): boolean;
111
- /**
112
- * Validates if a URL is in a valid format
113
- * @param url - The URL to validate
114
- * @returns true if URL format is valid, false otherwise
115
- */
116
- export declare function isValidUrl(url: string): boolean;
117
- /**
118
- * Validates if a date string is in a valid format
119
- * @param dateString - The date string to validate
120
- * @returns true if date format is valid, false otherwise
121
- */
122
- export declare function isValidDate(dateString: string): boolean;
123
- /**
124
- * Validates if a string is empty or contains only whitespace
125
- * @param str - The string to validate
126
- * @returns true if string is empty or whitespace only, false otherwise
127
- */
128
- export declare function isEmptyOrWhitespace(str: string): boolean;
129
- /**
130
- * Validates if a string meets a minimum length requirement
131
- * @param str - The string to validate
132
- * @param minLength - The minimum length required
133
- * @returns true if string meets minimum length, false otherwise
134
- */
135
- export declare function meetsMinLength(str: string, minLength: number): boolean;
136
- /**
137
- * Validates if a string meets a maximum length requirement
138
- * @param str - The string to validate
139
- * @param maxLength - The maximum length allowed
140
- * @returns true if string meets maximum length, false otherwise
141
- */
142
- export declare function meetsMaxLength(str: string, maxLength: number): boolean;
143
- /**
144
- * Validates if a number is within a specified range
145
- * @param value - The number to validate
146
- * @param min - The minimum value (inclusive)
147
- * @param max - The maximum value (inclusive)
148
- * @returns true if number is within range, false otherwise
149
- */
150
- export declare function isInRange(value: number, min: number, max: number): boolean;
151
- /**
152
- * Validates if a value is a positive number
153
- * @param value - The value to validate
154
- * @returns true if value is a positive number, false otherwise
155
- */
156
- export declare function isPositiveNumber(value: number): boolean;
157
- /**
158
- * Validates if a value is a non-negative number
159
- * @param value - The value to validate
160
- * @returns true if value is a non-negative number, false otherwise
161
- */
162
- export declare function isNonNegativeNumber(value: number): boolean;
163
- /**
164
- * Validates if a full name contains at least first and last name
165
- * @param fullName - The full name to validate
166
- * @param minParts - Minimum number of name parts required (default: 2)
167
- * @returns true if appears to contain required name parts, false otherwise
168
- */
169
- export declare function isValidFullName(fullName: string, minParts?: number): boolean;
170
- /**
171
- * Validates if a date is a valid date of birth (not in future, reasonable age range)
172
- * @param dateOfBirth - The date string in YYYY-MM-DD format
173
- * @param minAge - Minimum age requirement (default: 13)
174
- * @param maxAge - Maximum reasonable age (default: 120)
175
- * @returns true if valid date of birth, false otherwise
176
- */
177
- export declare function isValidDateOfBirth(dateOfBirth: string, minAge?: number, maxAge?: number): boolean;
178
- /**
179
- * Formats a phone number by removing extra spaces and standardizing format
180
- * @param phoneNumber - The phone number to format
181
- * @returns The formatted phone number
182
- */
183
- export declare function formatPhoneNumber(phoneNumber: string): string;
184
- /**
185
- * Validates if investment amount is within acceptable range
186
- * @param amount - The investment amount to validate
187
- * @param minAmount - Minimum investment amount (default: 100)
188
- * @param maxAmount - Maximum investment amount (default: 10000000)
189
- * @returns true if amount is within range, false otherwise
190
- */
191
- export declare function isValidInvestmentAmount(amount: number, minAmount?: number, maxAmount?: number): boolean;
192
- /**
193
- * Validates if at least minimum number of items are selected
194
- * @param items - Array of selected items
195
- * @param minItems - Minimum number of items required (default: 1)
196
- * @returns true if minimum items are selected, false otherwise
197
- */
198
- export declare function hasMinimumSelection<T>(items: T[], minItems?: number): boolean;
199
- /**
200
- * Validates if a value is selected (not null, undefined, or empty string)
201
- * @param value - The value to check
202
- * @returns true if value is selected, false otherwise
203
- */
204
- export declare function isSelected(value: unknown): boolean;
205
- /**
206
- * Validates that percentage values sum to a target value (default 100)
207
- * @param values - Array of percentage values
208
- * @param target - Target sum value (default: 100)
209
- * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
210
- * @returns true if sum equals target within tolerance, false otherwise
211
- * @example
212
- * validatePercentageSum([25, 25, 50]) // true (sums to 100)
213
- * validatePercentageSum([33.33, 33.33, 33.34]) // true (within tolerance)
214
- * validatePercentageSum([50, 30, 15]) // false (sums to 95)
215
- */
216
- export declare function validatePercentageSum(values: number[], target?: number, tolerance?: number): boolean;
217
- /**
218
- * Validates that allocation objects with percentage properties sum to 100%
219
- * @param allocations - Array of objects with percentage property
220
- * @param percentageField - Name of the percentage field (default: 'percentage')
221
- * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
222
- * @returns true if sum equals 100 within tolerance, false otherwise
223
- * @example
224
- * validateAllocationSum([{percentage: 50}, {percentage: 50}]) // true
225
- * validateAllocationSum([{percentage: '33.33'}, {percentage: '66.67'}]) // true
226
- */
227
- export declare function validateAllocationSum<T extends Record<string, unknown>>(allocations: T[], percentageField?: keyof T, tolerance?: number): boolean;
228
- /**
229
- * Validates that a number is within a specified range (inclusive)
230
- * @param value - The number to validate
231
- * @param min - Minimum allowed value
232
- * @param max - Maximum allowed value
233
- * @returns true if number is within range, false otherwise
234
- * @example
235
- * isInNumberRange(50, 0, 100) // true
236
- * isInNumberRange(150, 0, 100) // false
237
- */
238
- export declare function isInNumberRange(value: number, min: number, max: number): boolean;
239
- /**
240
- * Validates that a percentage is between 0 and 100
241
- * @param percentage - The percentage to validate
242
- * @returns true if valid percentage, false otherwise
243
- * @example
244
- * isValidPercentage(50) // true
245
- * isValidPercentage(150) // false
246
- * isValidPercentage(-10) // false
247
- */
248
- export declare function isValidPercentage(percentage: number): boolean;
249
- //# sourceMappingURL=validation.d.ts.map
@@ -1 +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;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,OAAO,CAI9E;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;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,OAAO,CAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,SAAK,EAAE,MAAM,SAAM,GAAG,OAAO,CAc1F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAM,EAAE,SAAS,SAAW,GAAG,OAAO,CAEtG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,SAAI,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,MAAY,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAK/G;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,WAAW,EAAE,CAAC,EAAE,EAChB,eAAe,GAAE,MAAM,CAA2B,EAClD,SAAS,GAAE,MAAa,GACvB,OAAO,CAST;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7D"}
@@ -1,337 +0,0 @@
1
- /**
2
- * Validation utility functions
3
- */
4
- /**
5
- * Checks if a string contains only numeric characters
6
- * @param str - The string to validate
7
- * @returns true if the string contains only digits, false otherwise
8
- */
9
- export function isNumericOnly(str) {
10
- return /^\d+$/.test(str);
11
- }
12
- /**
13
- * Validates password strength based on minimum requirements
14
- * @param password - The password to validate
15
- * @param minLength - Minimum password length (default: 8)
16
- * @returns An object containing validation results
17
- */
18
- export function validatePassword(password, minLength = 8) {
19
- return {
20
- lengthValid: password.length >= minLength,
21
- notNumeric: !isNumericOnly(password),
22
- };
23
- }
24
- /**
25
- * Validates if a verification token is in the expected format
26
- * @param token - The verification token to validate
27
- * @param minLength - Minimum token length (default: 6)
28
- * @returns true if token appears to be valid format, false otherwise
29
- */
30
- export function isValidTokenFormat(token, minLength = 6) {
31
- const trimmedToken = token.trim();
32
- // Assuming tokens are alphanumeric and meet minimum length
33
- return trimmedToken.length >= minLength && /^[a-zA-Z0-9]+$/.test(trimmedToken);
34
- }
35
- /**
36
- * Formats a verification token by removing whitespace and converting to uppercase
37
- * @param token - The token to format
38
- * @returns The formatted token
39
- */
40
- export function formatVerificationToken(token) {
41
- return token.trim().toUpperCase();
42
- }
43
- /**
44
- * Validates email confirmation form data
45
- * @param token - The verification token
46
- * @param minLength - Minimum token length (default: 6)
47
- * @returns An object containing validation results
48
- */
49
- export function validateEmailConfirmation(token, minLength = 6) {
50
- const formattedToken = formatVerificationToken(token);
51
- return {
52
- isValid: formattedToken.length > 0 && isValidTokenFormat(formattedToken, minLength),
53
- isEmpty: formattedToken.length === 0,
54
- isValidFormat: isValidTokenFormat(formattedToken, minLength),
55
- };
56
- }
57
- /**
58
- * Validates if an email address is in a valid format
59
- * @param email - The email address to validate
60
- * @returns true if email format is valid, false otherwise
61
- */
62
- export function isValidEmail(email) {
63
- const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
64
- return emailRegex.test(email.trim());
65
- }
66
- /**
67
- * Validates if a string contains at least one uppercase letter
68
- * @param str - The string to validate
69
- * @returns true if contains uppercase, false otherwise
70
- */
71
- export function hasUppercase(str) {
72
- return /[A-Z]/.test(str);
73
- }
74
- /**
75
- * Validates if a string contains at least one lowercase letter
76
- * @param str - The string to validate
77
- * @returns true if contains lowercase, false otherwise
78
- */
79
- export function hasLowercase(str) {
80
- return /[a-z]/.test(str);
81
- }
82
- /**
83
- * Validates if a string contains at least one special character
84
- * @param str - The string to validate
85
- * @returns true if contains special character, false otherwise
86
- */
87
- export function hasSpecialCharacter(str) {
88
- return /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(str);
89
- }
90
- /**
91
- * Validates if a string contains at least one digit
92
- * @param str - The string to validate
93
- * @returns true if contains digit, false otherwise
94
- */
95
- export function hasDigit(str) {
96
- return /\d/.test(str);
97
- }
98
- /**
99
- * Performs extended password validation with additional strength checks
100
- * @param password - The password to validate
101
- * @param minLength - Minimum password length (default: 8)
102
- * @returns An object containing detailed validation results
103
- */
104
- export function validatePasswordExtended(password, minLength = 8) {
105
- const basicValidation = validatePassword(password, minLength);
106
- return {
107
- ...basicValidation,
108
- hasUppercase: hasUppercase(password),
109
- hasLowercase: hasLowercase(password),
110
- hasSpecialCharacter: hasSpecialCharacter(password),
111
- hasDigit: hasDigit(password),
112
- };
113
- }
114
- /**
115
- * Validates if a phone number is in a valid format
116
- * @param phoneNumber - The phone number to validate
117
- * @returns true if phone number format is valid, false otherwise
118
- */
119
- export function isValidPhoneNumber(phoneNumber) {
120
- // Remove common formatting characters
121
- const cleaned = phoneNumber.replace(/[\s\-().]/g, '');
122
- // Check if it's a valid phone number (digits only, 10-15 digits)
123
- return /^\+?\d{10,15}$/.test(cleaned);
124
- }
125
- /**
126
- * Validates if a phone number appears to be in a valid format (less strict)
127
- * @param phoneNumber - The phone number to validate
128
- * @param minLength - Minimum length for the phone number (default: 8)
129
- * @returns true if phone number appears valid, false otherwise
130
- */
131
- export function isValidPhoneFormat(phoneNumber, minLength = 8) {
132
- const trimmedPhone = phoneNumber.trim();
133
- // Basic validation: must contain digits and common phone number characters
134
- return trimmedPhone.length >= minLength && /^[+\-\s\d()]+$/.test(trimmedPhone);
135
- }
136
- /**
137
- * Validates if a URL is in a valid format
138
- * @param url - The URL to validate
139
- * @returns true if URL format is valid, false otherwise
140
- */
141
- export function isValidUrl(url) {
142
- try {
143
- new URL(url);
144
- return true;
145
- }
146
- catch {
147
- return false;
148
- }
149
- }
150
- /**
151
- * Validates if a date string is in a valid format
152
- * @param dateString - The date string to validate
153
- * @returns true if date format is valid, false otherwise
154
- */
155
- export function isValidDate(dateString) {
156
- const date = new Date(dateString);
157
- return !isNaN(date.getTime());
158
- }
159
- /**
160
- * Validates if a string is empty or contains only whitespace
161
- * @param str - The string to validate
162
- * @returns true if string is empty or whitespace only, false otherwise
163
- */
164
- export function isEmptyOrWhitespace(str) {
165
- return str.trim().length === 0;
166
- }
167
- /**
168
- * Validates if a string meets a minimum length requirement
169
- * @param str - The string to validate
170
- * @param minLength - The minimum length required
171
- * @returns true if string meets minimum length, false otherwise
172
- */
173
- export function meetsMinLength(str, minLength) {
174
- return str.length >= minLength;
175
- }
176
- /**
177
- * Validates if a string meets a maximum length requirement
178
- * @param str - The string to validate
179
- * @param maxLength - The maximum length allowed
180
- * @returns true if string meets maximum length, false otherwise
181
- */
182
- export function meetsMaxLength(str, maxLength) {
183
- return str.length <= maxLength;
184
- }
185
- /**
186
- * Validates if a number is within a specified range
187
- * @param value - The number to validate
188
- * @param min - The minimum value (inclusive)
189
- * @param max - The maximum value (inclusive)
190
- * @returns true if number is within range, false otherwise
191
- */
192
- export function isInRange(value, min, max) {
193
- return value >= min && value <= max;
194
- }
195
- /**
196
- * Validates if a value is a positive number
197
- * @param value - The value to validate
198
- * @returns true if value is a positive number, false otherwise
199
- */
200
- export function isPositiveNumber(value) {
201
- return typeof value === 'number' && value > 0 && isFinite(value);
202
- }
203
- /**
204
- * Validates if a value is a non-negative number
205
- * @param value - The value to validate
206
- * @returns true if value is a non-negative number, false otherwise
207
- */
208
- export function isNonNegativeNumber(value) {
209
- return typeof value === 'number' && value >= 0 && isFinite(value);
210
- }
211
- /**
212
- * Validates if a full name contains at least first and last name
213
- * @param fullName - The full name to validate
214
- * @param minParts - Minimum number of name parts required (default: 2)
215
- * @returns true if appears to contain required name parts, false otherwise
216
- */
217
- export function isValidFullName(fullName, minParts = 2) {
218
- const trimmedName = fullName.trim();
219
- const nameParts = trimmedName.split(/\s+/);
220
- return nameParts.length >= minParts && nameParts.every(part => part.length > 0);
221
- }
222
- /**
223
- * Validates if a date is a valid date of birth (not in future, reasonable age range)
224
- * @param dateOfBirth - The date string in YYYY-MM-DD format
225
- * @param minAge - Minimum age requirement (default: 13)
226
- * @param maxAge - Maximum reasonable age (default: 120)
227
- * @returns true if valid date of birth, false otherwise
228
- */
229
- export function isValidDateOfBirth(dateOfBirth, minAge = 13, maxAge = 120) {
230
- if (!dateOfBirth)
231
- return false;
232
- const birthDate = new Date(dateOfBirth);
233
- const today = new Date();
234
- const age = today.getFullYear() - birthDate.getFullYear();
235
- const monthDiff = today.getMonth() - birthDate.getMonth();
236
- const dayDiff = today.getDate() - birthDate.getDate();
237
- // Adjust age if birthday hasn't occurred this year
238
- const actualAge = monthDiff < 0 || (monthDiff === 0 && dayDiff < 0) ? age - 1 : age;
239
- return actualAge >= minAge && actualAge <= maxAge && birthDate <= today;
240
- }
241
- /**
242
- * Formats a phone number by removing extra spaces and standardizing format
243
- * @param phoneNumber - The phone number to format
244
- * @returns The formatted phone number
245
- */
246
- export function formatPhoneNumber(phoneNumber) {
247
- return phoneNumber.trim();
248
- }
249
- /**
250
- * Validates if investment amount is within acceptable range
251
- * @param amount - The investment amount to validate
252
- * @param minAmount - Minimum investment amount (default: 100)
253
- * @param maxAmount - Maximum investment amount (default: 10000000)
254
- * @returns true if amount is within range, false otherwise
255
- */
256
- export function isValidInvestmentAmount(amount, minAmount = 100, maxAmount = 10000000) {
257
- return amount >= minAmount && amount <= maxAmount;
258
- }
259
- /**
260
- * Validates if at least minimum number of items are selected
261
- * @param items - Array of selected items
262
- * @param minItems - Minimum number of items required (default: 1)
263
- * @returns true if minimum items are selected, false otherwise
264
- */
265
- export function hasMinimumSelection(items, minItems = 1) {
266
- return items && items.length >= minItems;
267
- }
268
- /**
269
- * Validates if a value is selected (not null, undefined, or empty string)
270
- * @param value - The value to check
271
- * @returns true if value is selected, false otherwise
272
- */
273
- export function isSelected(value) {
274
- return value !== null && value !== undefined && value !== '';
275
- }
276
- // ENHANCED VALIDATION UTILITIES (Phase 14)
277
- /**
278
- * Validates that percentage values sum to a target value (default 100)
279
- * @param values - Array of percentage values
280
- * @param target - Target sum value (default: 100)
281
- * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
282
- * @returns true if sum equals target within tolerance, false otherwise
283
- * @example
284
- * validatePercentageSum([25, 25, 50]) // true (sums to 100)
285
- * validatePercentageSum([33.33, 33.33, 33.34]) // true (within tolerance)
286
- * validatePercentageSum([50, 30, 15]) // false (sums to 95)
287
- */
288
- export function validatePercentageSum(values, target = 100, tolerance = 0.01) {
289
- if (!Array.isArray(values) || values.length === 0)
290
- return false;
291
- const sum = values.reduce((total, value) => total + (value || 0), 0);
292
- return Math.abs(sum - target) <= tolerance;
293
- }
294
- /**
295
- * Validates that allocation objects with percentage properties sum to 100%
296
- * @param allocations - Array of objects with percentage property
297
- * @param percentageField - Name of the percentage field (default: 'percentage')
298
- * @param tolerance - Allowed tolerance for floating point differences (default: 0.01)
299
- * @returns true if sum equals 100 within tolerance, false otherwise
300
- * @example
301
- * validateAllocationSum([{percentage: 50}, {percentage: 50}]) // true
302
- * validateAllocationSum([{percentage: '33.33'}, {percentage: '66.67'}]) // true
303
- */
304
- export function validateAllocationSum(allocations, percentageField = 'percentage', tolerance = 0.01) {
305
- if (!Array.isArray(allocations) || allocations.length === 0)
306
- return false;
307
- const values = allocations.map(allocation => {
308
- const value = allocation[percentageField];
309
- return typeof value === 'string' ? parseFloat(value) || 0 : Number(value) || 0;
310
- });
311
- return validatePercentageSum(values, 100, tolerance);
312
- }
313
- /**
314
- * Validates that a number is within a specified range (inclusive)
315
- * @param value - The number to validate
316
- * @param min - Minimum allowed value
317
- * @param max - Maximum allowed value
318
- * @returns true if number is within range, false otherwise
319
- * @example
320
- * isInNumberRange(50, 0, 100) // true
321
- * isInNumberRange(150, 0, 100) // false
322
- */
323
- export function isInNumberRange(value, min, max) {
324
- return typeof value === 'number' && !isNaN(value) && value >= min && value <= max;
325
- }
326
- /**
327
- * Validates that a percentage is between 0 and 100
328
- * @param percentage - The percentage to validate
329
- * @returns true if valid percentage, false otherwise
330
- * @example
331
- * isValidPercentage(50) // true
332
- * isValidPercentage(150) // false
333
- * isValidPercentage(-10) // false
334
- */
335
- export function isValidPercentage(percentage) {
336
- return isInNumberRange(percentage, 0, 100);
337
- }
@@ -1,97 +0,0 @@
1
- /**
2
- * Withdrawal-related utility functions
3
- *
4
- * This module provides pure functions for formatting withdrawal amounts,
5
- * calculating liquidation progress, and other withdrawal-related operations.
6
- * Functions are designed to work with generic types to maintain flexibility.
7
- */
8
- /**
9
- * Formats a withdrawal amount as currency
10
- *
11
- * @param amount - Withdrawal amount as string or number
12
- * @returns Formatted currency string with AUD symbol
13
- *
14
- * @example
15
- * ```typescript
16
- * formatWithdrawalAmount(5000) // 'A$5,000.00'
17
- * formatWithdrawalAmount('5000.50') // 'A$5,000.50'
18
- * ```
19
- */
20
- export declare function formatWithdrawalAmount(amount: string | number): string;
21
- /**
22
- * Formats a liquidation value as currency
23
- *
24
- * @param value - Liquidation value as string or number
25
- * @returns Formatted currency string with AUD symbol
26
- *
27
- * @example
28
- * ```typescript
29
- * formatLiquidationValue(10000) // 'A$10,000.00'
30
- * formatLiquidationValue('10000.50') // 'A$10,000.50'
31
- * ```
32
- */
33
- export declare function formatLiquidationValue(value: string | number): string;
34
- /**
35
- * Formats share quantity without decimal places
36
- *
37
- * @param shares - Number of shares
38
- * @returns Formatted number string with thousands separators
39
- *
40
- * @example
41
- * ```typescript
42
- * formatSharesQuantity(1234) // '1,234'
43
- * formatSharesQuantity(1234567) // '1,234,567'
44
- * ```
45
- */
46
- export declare function formatSharesQuantity(shares: number): string;
47
- /**
48
- * Progress calculation result for liquidations
49
- */
50
- export interface LiquidationProgress {
51
- total: number;
52
- pending: number;
53
- inProgress: number;
54
- completed: number;
55
- failed: number;
56
- completionRate: number;
57
- }
58
- /**
59
- * Calculates liquidation progress statistics
60
- *
61
- * @param liquidations - Array of liquidation objects with liquidationStatus property
62
- * @returns Progress statistics including counts and completion rate
63
- *
64
- * @example
65
- * ```typescript
66
- * const liquidations = [
67
- * { liquidationStatus: 'PENDING' },
68
- * { liquidationStatus: 'SETTLED' },
69
- * { liquidationStatus: 'FAILED' }
70
- * ];
71
- * calculateLiquidationProgress(liquidations)
72
- * // Returns: { total: 3, pending: 1, inProgress: 0, completed: 1, failed: 1, completionRate: 33.33 }
73
- * ```
74
- */
75
- export declare function calculateLiquidationProgress<T extends {
76
- liquidationStatus: string;
77
- }>(liquidations: T[]): LiquidationProgress;
78
- /**
79
- * Calculates total estimated value from liquidations
80
- *
81
- * @param liquidations - Array of liquidation objects with estimatedValue property
82
- * @returns Total estimated value as number
83
- *
84
- * @example
85
- * ```typescript
86
- * const liquidations = [
87
- * { estimatedValue: '1000.50' },
88
- * { estimatedValue: '2000' },
89
- * { estimatedValue: null }
90
- * ];
91
- * getTotalEstimatedValue(liquidations) // 3000.50
92
- * ```
93
- */
94
- export declare function getTotalEstimatedValue<T extends {
95
- estimatedValue?: string | null;
96
- }>(liquidations: T[]): number;
97
- //# sourceMappingURL=withdrawal.d.ts.map
@@ -1 +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"}