@digiform/wizard 0.1.7 → 0.2.2

package/features/validation-system/validation/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Unified Validation System
+ *
+ * This module provides a consolidated validation architecture that replaces
+ * the previous scattered validation logic with a single, performant ValidationEngine.
+ *
+ * Key Features:
+ * - Debounced validation (300ms default) for better performance
+ * - Schema caching with memoization to avoid re-creating schemas
+ * - Single API for field, step, and form-level validation
+ * - Support for both "withLabel" and "simple" validation message styles
+ * - TypeScript-first design with comprehensive type safety
+ */
+export { createTanStackSchema, validateWithTanStack, validateWithTanStackReturnArray, } from './tanstackSchemaAdapter';
+export { createValidationEngine, defaultValidationEngine, type FieldValidationResult, ValidationEngine, type ValidationOptions, type ValidationResult, } from './ValidationEngine';
+export { findComponentById, getAllComponents, getStepComponents, isFormValid, isStepValid, validateField, validateFieldReturnArray, validateForm, validateStep, } from './validationService';
+/**
+ * Migration Guide:
+ *
+ * Old approach:
+ * ```typescript
+ * import { createComponentSchema } from '../utils/createZodSchema';
+ * const schema = createComponentSchema(component, messageStyle);
+ * ```
+ *
+ * New approach:
+ * ```typescript
+ * import { ValidationEngine } from './validation';
+ * const engine = new ValidationEngine({ messageStyle });
+ * const schema = engine.getComponentSchema(component);
+ * ```
+ *
+ * Benefits of new approach:
+ * - Automatic schema caching
+ * - Debounced validation support
+ * - Better performance
+ * - Cleaner, more maintainable code
+ */

package/features/validation-system/validation/secureValidatorEngine.d.ts

@@ -0,0 +1,64 @@
+import { FlowData, FormFieldValue } from '../../../../../core/src/index.ts';
+/**
+ * Configuration for secure validator execution
+ */
+export interface SecureValidatorConfig {
+    /** Maximum execution time in milliseconds */
+    timeoutMs: number;
+    /** Whether to log security violations */
+    enableSecurityLogging: boolean;
+    /** Maximum recursion depth for object validation */
+    maxRecursionDepth: number;
+}
+/**
+ * Default configuration for secure validator
+ */
+export declare const DEFAULT_SECURE_VALIDATOR_CONFIG: SecureValidatorConfig;
+/**
+ * Result of secure validator execution
+ */
+export interface SecureValidatorResult {
+    isValid: boolean;
+    error?: string;
+    securityViolation?: string;
+    executionTimeMs?: number;
+}
+/**
+ * Type for secure custom validator function
+ * This replaces the unsafe string-based validators
+ */
+export type SecureCustomValidator = (value: FormFieldValue, formData?: FlowData) => boolean | Promise<boolean>;
+/**
+ * Secure Custom Validator Engine
+ *
+ * Provides secure execution of custom validation functions with:
+ * - Input sanitization
+ * - Execution timeout
+ * - Output validation
+ * - Error handling
+ * - Security logging
+ */
+export declare class SecureValidatorEngine {
+    private config;
+    constructor(config?: Partial<SecureValidatorConfig>);
+    /**
+     * Executes a custom validator function securely
+     */
+    executeValidator(validator: SecureCustomValidator, value: FormFieldValue, formData?: FlowData): Promise<SecureValidatorResult>;
+    /**
+     * Synchronous validator execution (with timeout protection)
+     */
+    executeValidatorSync(validator: SecureCustomValidator, value: FormFieldValue, formData?: FlowData): SecureValidatorResult;
+    /**
+     * Updates the security configuration
+     */
+    updateConfig(newConfig: Partial<SecureValidatorConfig>): void;
+    /**
+     * Gets the current security configuration
+     */
+    getConfig(): SecureValidatorConfig;
+}
+/**
+ * Default global secure validator engine instance
+ */
+export declare const defaultSecureValidatorEngine: SecureValidatorEngine;

package/features/validation-system/validation/tanstackSchemaAdapter.d.ts

@@ -0,0 +1,15 @@
+import { ComponentConfig } from '../../../../../core/src/index.ts';
+/**
+ * Adapts a component's validation rules to a TanStack-compatible schema
+ */
+export declare function createTanStackSchema(component: ComponentConfig, messageStyle?: "withLabel" | "simple"): unknown;
+/**
+ * Validates a field value using ValidationEngine
+ * Returns undefined if valid, or error message if invalid
+ */
+export declare function validateWithTanStack(component: ComponentConfig, value: unknown, messageStyle?: "withLabel" | "simple"): string | undefined;
+/**
+ * Validates a field value using ValidationEngine
+ * Returns array of error messages if invalid, empty array if valid
+ */
+export declare function validateWithTanStackReturnArray(component: ComponentConfig, value: unknown): string[];

package/features/validation-system/validation/validationService.d.ts

@@ -0,0 +1,43 @@
+import { ComponentConfig, FormData, FormWizardConfig } from '../../../../../core/src/index.ts';
+/**
+ * Validate a single field
+ * @returns undefined if valid, error message if invalid
+ */
+export declare function validateField(component: ComponentConfig, value: unknown): Promise<string | undefined>;
+/**
+ * Validate a single field and return array of errors
+ * @returns Array of error messages, empty if valid
+ */
+export declare function validateFieldReturnArray(component: ComponentConfig, value: unknown): Promise<string[]>;
+/**
+ * Find a component by ID in the form config
+ */
+export declare function findComponentById(config: FormWizardConfig, componentId: string): ComponentConfig | undefined;
+/**
+ * Get all components in a specific step
+ */
+export declare function getStepComponents(config: FormWizardConfig, stepId: string): ComponentConfig[];
+/**
+ * Get all components in the form
+ */
+export declare function getAllComponents(config: FormWizardConfig): ComponentConfig[];
+/**
+ * Validate all fields in a step
+ * @returns Record of field IDs to arrays of error messages
+ */
+export declare function validateStep(config: FormWizardConfig, stepId: string, data: FormData): Promise<Record<string, string[]>>;
+/**
+ * Check if a step is valid
+ * @returns true if all fields in the step are valid
+ */
+export declare function isStepValid(config: FormWizardConfig, stepId: string, data: FormData): Promise<boolean>;
+/**
+ * Validate the entire form
+ * @returns Record of field IDs to arrays of error messages
+ */
+export declare function validateForm(config: FormWizardConfig, data: FormData): Promise<Record<string, string[]>>;
+/**
+ * Check if the entire form is valid
+ * @returns true if all fields in the form are valid
+ */
+export declare function isFormValid(config: FormWizardConfig, data: FormData): Promise<boolean>;