@codex-ts/core-lib 1.0.0

package/src/lib/services/utils.service.ts

@@ -0,0 +1,154 @@
+import { Injectable } from '@angular/core';
+import { MessageService } from 'primeng/api';
+
+/**
+ * A utility service that provides common reusable functionality
+ * such as UUID validation and error message display
+ */
+@Injectable({
+  providedIn: 'root'
+})
+export class UtilsService {
+  /**
+   * Validates if a string is a valid UUID
+   * @param uuid The string to validate
+   * @returns boolean indicating if the string is a valid UUID
+   */
+  isValidUUID(uuid: string): boolean {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+  }
+
+  /**
+   * Shows an error message using PrimeNG's MessageService
+   * @param message The error message to display
+   * @param messageService The MessageService instance to use
+   */
+  showError(message: string, messageService?: MessageService) {
+    if (messageService) {
+      messageService.add({
+        severity: 'error',
+        summary: 'Error',
+        detail: message,
+        life: 3000
+      });
+    }
+  }
+
+  /**
+   * Shows a success message using PrimeNG's MessageService
+   * @param message The success message to display
+   * @param messageService The MessageService instance to use
+   */
+  showSuccess(message: string, messageService?: MessageService) {
+    if (messageService) {
+      messageService.add({
+        severity: 'success',
+        summary: 'Success',
+        detail: message,
+        life: 3000
+      });
+    }
+  }
+
+  /**
+   * Gets the display value for an enum key or array of enum keys
+   * @param enumType The enum type
+   * @param key The enum key or array of enum keys
+   * @returns The display value for the enum key or comma-separated list of display values for array of keys
+   */
+  getEnumValue<T>(enumType: T, key: string | string[]): string {
+    if (!key) return '';
+    
+    if (Array.isArray(key)) {
+      // Handle array of keys - map each to its display value and join with comma
+      return key.map(k => (enumType as any)[k] || k).join(', ');
+    }
+    
+    // Handle single key
+    return (enumType as any)[key] || key;
+  }
+
+  /**
+   * Gets all values from an enum type for use in formly select fields
+   * @param enumType The enum type to get values from
+   * @returns Array of {label, value} pairs for formly select options
+   */
+  getEnumValues<T extends { [key: string]: string | number }>(enumType: T): Array<{label: string, value: string}> {
+    return Object.entries(enumType)
+      .filter(([key]) => isNaN(Number(key))) // Filter out reverse mappings
+      .map(([key, value]) => ({
+        value: key,  // enum key as the value
+        label: value as string  // enum value as the label
+      }));
+  }
+
+  /**
+   * Converts a camelCase string to Title Case with spaces
+   * @param camelCase The camelCase string to convert
+   * @returns The Title Case string
+   */
+  camelCaseToTitleCase(camelCase: string): string {
+    if (!camelCase) return '';
+    const spacedString = camelCase.replace(/([a-z])([A-Z])/g, '$1 $2');
+    return spacedString.charAt(0).toUpperCase() + spacedString.slice(1);
+  }
+
+  /**
+   * Converts a string to kebab-case
+   * @param input The string to convert
+   * @returns The kebab-case string
+   */
+  toKebabCase(input: string): string {
+    return input
+      .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+      .replace(/([A-Z])([A-Z])(?=[a-z])/g, '$1-$2')
+      .toLowerCase();
+  }
+
+  /**
+   * Converts a string to camelCase.
+   * Example: "loan-application" becomes "loanApplication"
+   * @param input The string to convert
+   * @returns The camelCase string
+   */
+  toCamelCase(input: string): string {
+    if (!input) return '';
+    
+    // Split by non-alphanumeric chars
+    const words = input.split(/[^a-zA-Z0-9]/);
+    const result = [words[0].toLowerCase()];
+    
+    // Capitalize first letter of remaining words
+    for (let i = 1; i < words.length; i++) {
+      const word = words[i];
+      if (word) {
+        result.push(word.charAt(0).toUpperCase() + word.substring(1).toLowerCase());
+      }
+    }
+    
+    return result.join('');
+  }
+
+  /**
+   * Removes double forward slashes from an endpoint string while preserving the protocol
+   * e.g. "http://localhost:8080//api//v1//users" -> "http://localhost:8080/api/v1/users"
+   * @param endpoint The endpoint string to clean
+   * @returns The cleaned endpoint string without double slashes
+   */
+  removeDoubleSlashes(endpoint: string): string {
+    if (!endpoint) return '';
+    
+    // Split the URL into protocol and the rest to preserve protocol slashes
+    const [protocol, ...rest] = endpoint.split('://');
+    
+    if (!rest.length) {
+      // If no protocol is present, just clean the entire string
+      return endpoint.replace(/\/+/g, '/');
+    }
+    
+    // Clean the path part (after protocol) and reconstruct the URL
+    const cleanPath = rest.join('://').replace(/\/+/g, '/');
+    return `${protocol}://${cleanPath}`;
+  }
+}