@mondaydotcomorg/monday-authorization 3.5.1-fix-authorize-profile-picker-7481de0 → 3.5.3-feat-shaime-support-entity-attributes-in-authorization-sdk-e355942

package/src/utils/validation.ts

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import { ArgumentError } from '../errors/argument-error';
+
+/**
+ * Utility class for common validation operations using Zod
+ */
+export class ValidationUtils {
+  /**
+   * Validates that a value is an integer
+   * @param value The value to validate
+   * @param fieldName The name of the field for error messages
+   * @throws ArgumentError if value is not an integer
+   */
+  static validateInteger(value: any, fieldName: string): void {
+    const schema = z.number().int();
+    try {
+      schema.parse(value);
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw new ArgumentError(`${fieldName} must be an integer, got: ${value}`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Validates that a value is a non-empty string
+   * @param value The value to validate
+   * @param fieldName The name of the field for error messages
+   * @throws ArgumentError if value is not a string or is empty
+   */
+  static validateString(value: any, fieldName: string): void {
+    const schema = z.string().min(1);
+    try {
+      schema.parse(value);
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        if (typeof value !== 'string') {
+          throw new ArgumentError(`${fieldName} must be a string, got: ${typeof value}`);
+        }
+        throw new ArgumentError(`${fieldName} must be a non-empty string`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Validates that a value is an array and optionally checks minimum length
+   * @param value The value to validate
+   * @param fieldName The name of the field for error messages
+   * @param minLength Minimum required length (default: 0)
+   * @returns The validated array
+   * @throws ArgumentError if value is not an array or doesn't meet minimum length
+   */
+  static validateArray<T>(value: any, fieldName: string, minLength = 0): T[] {
+    const schema = z.array(z.any()).min(minLength);
+    try {
+      return schema.parse(value) as T[];
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        if (!Array.isArray(value)) {
+          throw new ArgumentError(`${fieldName} must be an array`);
+        }
+        throw new ArgumentError(`${fieldName} must have at least ${minLength} items`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Validates that a value is one of the allowed enum values
+   * @param value The value to validate
+   * @param validValues Array of valid values
+   * @param fieldName The name of the field for error messages
+   * @returns The validated value as the enum type
+   * @throws ArgumentError if value is not in validValues
+   */
+  static validateEnum<T extends string>(value: string, validValues: readonly T[], fieldName: string): T {
+    const schema = z.enum(validValues as [T, ...T[]]);
+    try {
+      return schema.parse(value) as T;
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        throw new ArgumentError(`${fieldName} must be one of [${validValues.join(', ')}], got: ${value}`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Validates that all items in an array are strings
+   * @param value Array to validate
+   * @param fieldName The name of the field for error messages
+   * @throws ArgumentError if any item is not a string
+   */
+  static validateStringArray(value: any[], fieldName: string): void {
+    const schema = z.array(z.string());
+    try {
+      schema.parse(value);
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        const zodError = error as z.ZodError;
+        const firstError = zodError.issues[0];
+        // Check if it's an array item validation error
+        if (firstError.path.length > 0 && typeof firstError.path[0] === 'number') {
+          const index = firstError.path[0];
+          throw new ArgumentError(`All ${fieldName} must be strings, but item at index ${index} is not`);
+        }
+        throw new ArgumentError(`${fieldName} must be an array`);
+      }
+      throw error;
+    }
+  }
+}