@cranberry-money/shared-utils 3.0.0 → 3.0.2

package/dist/index.d.ts

@@ -4,4 +4,5 @@
 export * from './formatters';
 export * from './helpers';
 export * from './portfolio';
+export * from './validation';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -4,3 +4,4 @@
 export * from './formatters';
 export * from './helpers';
 export * from './portfolio';
+export * from './validation';

package/dist/portfolio/index.d.ts

@@ -8,4 +8,9 @@ import type { PortfolioServices } from '@cranberry-money/shared-services';
  * Returns a map of instrument UUID to percentage
  */
 export declare const calculateHoldingAllocations: (holdings: PortfolioServices.AssetHolding[]) => Record<string, number>;
+/**
+ * Format quantity for display
+ * Handles fractional shares and whole numbers appropriately
+ */
+export declare const formatQuantity: (quantity?: number) => string;
 //# sourceMappingURL=index.d.ts.map

package/dist/portfolio/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/portfolio/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU,iBAAiB,CAAC,YAAY,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAwB7G,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/portfolio/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU,iBAAiB,CAAC,YAAY,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAwB7G,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,MAWlD,CAAC"}

package/dist/portfolio/index.js

@@ -27,3 +27,18 @@ export const calculateHoldingAllocations = (holdings) => {
     });
     return allocations;
 };
+/**
+ * Format quantity for display
+ * Handles fractional shares and whole numbers appropriately
+ */
+export const formatQuantity = (quantity) => {
+    if (quantity === undefined || quantity === null)
+        return '0';
+    // For whole numbers, show without decimals
+    if (Number.isInteger(quantity)) {
+        return quantity.toString();
+    }
+    // For fractional shares, show up to 6 decimal places
+    // Remove trailing zeros
+    return quantity.toFixed(6).replace(/\.?0+$/, '');
+};

package/dist/validation/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Validation utility functions
+ * Common validation logic for forms and data
+ */
+import type { PasswordValidation, TokenValidation } from '@cranberry-money/shared-types';
+/**
+ * Validation rule constants
+ */
+export declare const VALIDATION_RULES: {
+    readonly PASSWORD_MIN_LENGTH: 8;
+    readonly TOKEN_MIN_LENGTH: 6;
+    readonly TOKEN_MAX_LENGTH: 20;
+};
+/**
+ * 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 const isNumericOnly: (str: string) => boolean;
+/**
+ * Validates password strength based on application requirements
+ * @param password - The password to validate
+ * @returns An object containing validation results
+ */
+export declare const validatePassword: (password: string) => PasswordValidation;
+/**
+ * Validates if a verification token is in the expected format
+ * @param token - The verification token to validate
+ * @returns true if token appears to be valid format, false otherwise
+ */
+export declare const isValidTokenFormat: (token: string) => boolean;
+/**
+ * Formats a verification token by removing whitespace and converting to uppercase
+ * @param token - The token to format
+ * @returns The formatted token
+ */
+export declare const formatVerificationToken: (token: string) => string;
+/**
+ * Validates email confirmation form data
+ * @param token - The verification token
+ * @returns An object containing validation results
+ */
+export declare const validateEmailConfirmation: (token: string) => TokenValidation;
+/**
+ * Validates email format
+ * @param email - The email to validate
+ * @returns true if email format is valid
+ */
+export declare const isValidEmail: (email: string) => boolean;
+/**
+ * Validates phone number format (basic validation)
+ * @param phone - The phone number to validate
+ * @returns true if phone format is valid
+ */
+export declare const isValidPhone: (phone: string) => boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,OAE3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,kBAKnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,OAQlD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG,MAEvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,eAQzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAG5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAK5C,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,84 @@
+/**
+ * Validation utility functions
+ * Common validation logic for forms and data
+ */
+/**
+ * Validation rule constants
+ */
+export const VALIDATION_RULES = {
+    PASSWORD_MIN_LENGTH: 8,
+    TOKEN_MIN_LENGTH: 6,
+    TOKEN_MAX_LENGTH: 20,
+};
+/**
+ * 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 const isNumericOnly = (str) => {
+    return /^\d+$/.test(str);
+};
+/**
+ * Validates password strength based on application requirements
+ * @param password - The password to validate
+ * @returns An object containing validation results
+ */
+export const validatePassword = (password) => {
+    return {
+        lengthValid: password.length >= VALIDATION_RULES.PASSWORD_MIN_LENGTH,
+        notNumeric: !isNumericOnly(password),
+    };
+};
+/**
+ * Validates if a verification token is in the expected format
+ * @param token - The verification token to validate
+ * @returns true if token appears to be valid format, false otherwise
+ */
+export const isValidTokenFormat = (token) => {
+    const trimmedToken = token.trim();
+    // Tokens are alphanumeric and within length limits
+    return (trimmedToken.length >= VALIDATION_RULES.TOKEN_MIN_LENGTH &&
+        trimmedToken.length <= VALIDATION_RULES.TOKEN_MAX_LENGTH &&
+        /^[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 const formatVerificationToken = (token) => {
+    return token.trim().toUpperCase();
+};
+/**
+ * Validates email confirmation form data
+ * @param token - The verification token
+ * @returns An object containing validation results
+ */
+export const validateEmailConfirmation = (token) => {
+    const formattedToken = formatVerificationToken(token);
+    return {
+        isValid: formattedToken.length > 0 && isValidTokenFormat(formattedToken),
+        isEmpty: formattedToken.length === 0,
+        isValidFormat: isValidTokenFormat(formattedToken),
+    };
+};
+/**
+ * Validates email format
+ * @param email - The email to validate
+ * @returns true if email format is valid
+ */
+export const isValidEmail = (email) => {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+};
+/**
+ * Validates phone number format (basic validation)
+ * @param phone - The phone number to validate
+ * @returns true if phone format is valid
+ */
+export const isValidPhone = (phone) => {
+    // Remove common formatting characters
+    const cleaned = phone.replace(/[\s\-\(\)]/g, '');
+    // Check if it's numeric and reasonable length
+    return /^\+?\d{10,15}$/.test(cleaned);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cranberry-money/shared-utils",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Shared utility functions for MyPortfolio platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,7 +22,8 @@
   },
   "dependencies": {
     "@cranberry-money/shared-constants": "^3.0.0",
-    "@cranberry-money/shared-services": "^3.0.0"
+    "@cranberry-money/shared-services": "^3.0.0",
+    "@cranberry-money/shared-types": "^3.0.4"
   },
   "devDependencies": {
     "typescript": "^5.0.0"