chore: initial release

2025-08-10 01:20:45 +05:30
commit 758615813f
218 changed files with 67743 additions and 0 deletions
--- a/lib/core/validation/validation_result.dart
+++ b/lib/core/validation/validation_result.dart
@@ -0,0 +1,100 @@
+/// Result of API validation operations
+class ValidationResult {
+  const ValidationResult._({
+    required this.isValid,
+    required this.status,
+    required this.message,
+    this.errors = const [],
+    this.warnings = const [],
+    this.data,
+  });
+
+  const ValidationResult.success(
+    String message, {
+    dynamic data,
+    List<String> warnings = const [],
+  }) : this._(
+         isValid: true,
+         status: ValidationStatus.success,
+         message: message,
+         warnings: warnings,
+         data: data,
+       );
+
+  const ValidationResult.warning(
+    String message, {
+    List<String> warnings = const [],
+    dynamic data,
+  }) : this._(
+         isValid: true,
+         status: ValidationStatus.warning,
+         message: message,
+         warnings: warnings,
+         data: data,
+       );
+
+  const ValidationResult.error(
+    String message, {
+    List<String> errors = const [],
+    List<String> warnings = const [],
+  }) : this._(
+         isValid: false,
+         status: ValidationStatus.error,
+         message: message,
+         errors: errors,
+         warnings: warnings,
+       );
+
+  final bool isValid;
+  final ValidationStatus status;
+  final String message;
+  final List<String> errors;
+  final List<String> warnings;
+  final dynamic data;
+
+  bool get hasWarnings => warnings.isNotEmpty;
+  bool get hasErrors => errors.isNotEmpty;
+
+  @override
+  String toString() {
+    final buffer = StringBuffer();
+    buffer.write('ValidationResult(');
+    buffer.write('status: $status, ');
+    buffer.write('message: $message');
+
+    if (hasErrors) {
+      buffer.write(', errors: ${errors.length}');
+    }
+
+    if (hasWarnings) {
+      buffer.write(', warnings: ${warnings.length}');
+    }
+
+    buffer.write(')');
+    return buffer.toString();
+  }
+
+  /// Convert to a detailed map for logging/debugging
+  Map<String, dynamic> toMap() {
+    return {
+      'isValid': isValid,
+      'status': status.name,
+      'message': message,
+      'errors': errors,
+      'warnings': warnings,
+      'hasData': data != null,
+    };
+  }
+}
+
+enum ValidationStatus { success, warning, error }
+
+/// Exception thrown when validation fails critically
+class ValidationException implements Exception {
+  const ValidationException(this.result);
+
+  final ValidationResult result;
+
+  @override
+  String toString() => 'ValidationException: ${result.message}';
+}