@groundbrick/service-base 0.0.1

package/dist/types/BusinessError.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Business logic error with structured information
+ */
+export declare class BusinessError extends Error {
+    readonly code: string;
+    readonly originalError?: Error;
+    readonly context?: Record<string, any>;
+    readonly timestamp: Date;
+    constructor(message: string, code: string, originalError?: Error, context?: Record<string, any>);
+    /**
+     * Convert to JSON for logging/API responses
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Create user-friendly error response
+     */
+    toUserResponse(): {
+        error: string;
+        code: string;
+        timestamp: string;
+    };
+    /**
+     * Check if error is of specific business type
+     */
+    static isBusinessError(error: any): error is BusinessError;
+    /**
+     * Check if error has specific code
+     */
+    hasCode(code: string): boolean;
+}
+//# sourceMappingURL=BusinessError.d.ts.map

package/dist/types/BusinessError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusinessError.d.ts","sourceRoot":"","sources":["../../src/types/BusinessError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,SAAgB,SAAS,EAAE,IAAI,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,KAAK,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAejC;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAW7B;;OAEG;IACH,cAAc,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQpE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa;IAI1D;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGjC"}

package/dist/types/BusinessError.js

@@ -0,0 +1,57 @@
+/**
+ * Business logic error with structured information
+ */
+export class BusinessError extends Error {
+    code;
+    originalError;
+    context;
+    timestamp;
+    constructor(message, code, originalError, context) {
+        super(message);
+        this.name = 'BusinessError';
+        this.code = code;
+        this.originalError = originalError;
+        this.context = context;
+        this.timestamp = new Date();
+        // Maintain stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, BusinessError);
+        }
+    }
+    /**
+     * Convert to JSON for logging/API responses
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            timestamp: this.timestamp.toISOString(),
+            context: this.context,
+            stack: this.stack
+        };
+    }
+    /**
+     * Create user-friendly error response
+     */
+    toUserResponse() {
+        return {
+            error: this.message,
+            code: this.code,
+            timestamp: this.timestamp.toISOString()
+        };
+    }
+    /**
+     * Check if error is of specific business type
+     */
+    static isBusinessError(error) {
+        return error instanceof BusinessError;
+    }
+    /**
+     * Check if error has specific code
+     */
+    hasCode(code) {
+        return this.code === code;
+    }
+}
+//# sourceMappingURL=BusinessError.js.map

package/dist/types/BusinessError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusinessError.js","sourceRoot":"","sources":["../../src/types/BusinessError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,CAAS;IACb,aAAa,CAAS;IACtB,OAAO,CAAuB;IAC9B,SAAS,CAAO;IAEhC,YACI,OAAe,EACf,IAAY,EACZ,aAAqB,EACrB,OAA6B;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,uBAAuB;QACvB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM;QACF,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,cAAc;QACV,OAAO;YACH,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;SAC1C,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAU;QAC7B,OAAO,KAAK,YAAY,aAAa,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;IAC9B,CAAC;CACJ"}

package/dist/types/ServiceOptions.d.ts

@@ -0,0 +1,14 @@
+import { DatabaseClient } from '@groundbrick/db-core';
+import { Validator } from '../validation/Validator.js';
+/**
+ * Configuration options for service instances
+ */
+export interface ServiceOptions {
+    /** Database client for transaction support */
+    database?: DatabaseClient;
+    /** Custom validator instance */
+    validator?: Validator;
+    /** Additional service-specific configuration */
+    config?: Record<string, any>;
+}
+//# sourceMappingURL=ServiceOptions.d.ts.map

package/dist/types/ServiceOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceOptions.d.ts","sourceRoot":"","sources":["../../src/types/ServiceOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B,gCAAgC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC"}

package/dist/types/ServiceOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ServiceOptions.js.map

package/dist/types/ServiceOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceOptions.js","sourceRoot":"","sources":["../../src/types/ServiceOptions.ts"],"names":[],"mappings":""}

package/dist/types/ServiceResult.d.ts

@@ -0,0 +1,31 @@
+import { BusinessError } from "./BusinessError.js";
+/**
+ * Standardized service operation result
+ */
+export interface ServiceResult<T = any> {
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Result data (if successful) */
+    data?: T;
+    /** Error information (if failed) */
+    error?: {
+        message: string;
+        code: string;
+        details?: Record<string, any>;
+    };
+    /** Operation metadata */
+    metadata?: {
+        duration?: number;
+        timestamp: string;
+        operation?: string;
+    };
+}
+/**
+ * Helper to create successful result
+ */
+export declare function createSuccessResult<T>(data: T, metadata?: any): ServiceResult<T>;
+/**
+ * Helper to create error result
+ */
+export declare function createErrorResult(error: BusinessError | Error | any): ServiceResult;
+//# sourceMappingURL=ServiceResult.d.ts.map

package/dist/types/ServiceResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceResult.d.ts","sourceRoot":"","sources":["../../src/types/ServiceResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IAClC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IAET,oCAAoC;IACpC,KAAK,CAAC,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC;IAEF,yBAAyB;IACzB,QAAQ,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAShF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,GAAG,GAAG,GAAG,aAAa,CAkBnF"}

package/dist/types/ServiceResult.js

@@ -0,0 +1,61 @@
+import { BusinessError } from "./BusinessError.js";
+/**
+ * Helper to create successful result
+ */
+export function createSuccessResult(data, metadata) {
+    return {
+        success: true,
+        data,
+        metadata: {
+            timestamp: new Date().toISOString(),
+            ...metadata
+        }
+    };
+}
+/**
+ * Helper to create error result
+ */
+export function createErrorResult(error) {
+    const isBusinessError = BusinessError.isBusinessError(error);
+    if (!isBusinessError) {
+        handleRepositoryError(error);
+    }
+    return {
+        success: false,
+        error: {
+            message: error.message,
+            code: isBusinessError ? error.code : 'UNKNOWN_ERROR',
+            details: isBusinessError ? error.context : undefined
+        },
+        metadata: {
+            timestamp: new Date().toISOString()
+        }
+    };
+}
+/**
+ * Transform repository errors into business errors
+ * @param error - Original error from repository layer
+ * @returns BusinessError with appropriate context
+ */
+function handleRepositoryError(error) {
+    // Handle query errors
+    if (error.code === 'QUERY_ERROR' || error.message.includes('query failed') || error.message.includes('syntax error')) {
+        return new BusinessError('Execução inválida na base de dados.', 'QUERY_ERROR', error);
+    }
+    // Handle common database constraint violations
+    if (error.message.includes('duplicate') || error.message.includes('unique')) {
+        return new BusinessError('Recurso já existe', 'DUPLICATE_RESOURCE', error);
+    }
+    if (error.message.includes('not found') || error.message.includes('does not exist')) {
+        return new BusinessError('Recurso não encontrado', 'RESOURCE_NOT_FOUND', error);
+    }
+    if (error.message.includes('foreign key') || error.message.includes('constraint')) {
+        return new BusinessError('Referência inválida ou violação de restrição', 'CONSTRAINT_VIOLATION', error);
+    }
+    if (error.message.includes('ETIMEDOUT') || error.message.includes('deadlock')) {
+        return new BusinessError('Operação no banco de dados expirou ou ficou bloqueada', 'DATABASE_TIMEOUT', error);
+    }
+    // Default: wrap as generic business error
+    return new BusinessError('Operação falhou', 'OPERATION_FAILED', error);
+}
+//# sourceMappingURL=ServiceResult.js.map

package/dist/types/ServiceResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceResult.js","sourceRoot":"","sources":["../../src/types/ServiceResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA2BnD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAI,IAAO,EAAE,QAAc;IAC1D,OAAO;QACH,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,QAAQ,EAAE;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,QAAQ;SACd;KACJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAkC;IAChE,MAAM,eAAe,GAAG,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAE7D,IAAI,CAAC,eAAe,EAAE,CAAC;QACnB,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,OAAO;QACH,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACH,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe;YACpD,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACvD;QACD,QAAQ,EAAE;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC;KACJ,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,KAAU;IAErC,sBAAsB;IACtB,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACnH,OAAO,IAAI,aAAa,CACpB,qCAAqC,EACrC,aAAa,EACb,KAAK,CACR,CAAC;IACN,CAAC;IAED,+CAA+C;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,aAAa,CACpB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,CACR,CAAC;IACN,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClF,OAAO,IAAI,aAAa,CACpB,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,CACR,CAAC;IACN,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAChF,OAAO,IAAI,aAAa,CACpB,8CAA8C,EAC9C,sBAAsB,EACtB,KAAK,CACR,CAAC;IACN,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,aAAa,CACpB,uDAAuD,EACvD,kBAAkB,EAClB,KAAK,CACR,CAAC;IACN,CAAC;IAED,0CAA0C;IAC1C,OAAO,IAAI,aAAa,CACpB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,CACR,CAAC;AACN,CAAC"}

package/dist/validation/ValidationError.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Individual validation error
+ */
+export interface ValidationError {
+    /** Field that failed validation */
+    field: string;
+    /** Error message */
+    message: string;
+    /** Validation rule that failed */
+    rule: string;
+    /** Current value that failed */
+    value?: any;
+}
+//# sourceMappingURL=ValidationError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.d.ts","sourceRoot":"","sources":["../../src/validation/ValidationError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,KAAK,CAAC,EAAE,GAAG,CAAC;CACf"}

package/dist/validation/ValidationError.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ValidationError.js.map

package/dist/validation/ValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../src/validation/ValidationError.ts"],"names":[],"mappings":""}

package/dist/validation/ValidationHelper.d.ts

@@ -0,0 +1,70 @@
+import { ValidationRule } from "./Validator.js";
+/**
+ * Common validation rules and helpers
+ */
+export declare class ValidationHelper {
+    /**
+     * Rule: Field is required (not null, undefined, or empty string)
+     */
+    static required(): ValidationRule;
+    /**
+     * Rule: String minimum length
+     */
+    static minLength(min: number): ValidationRule;
+    /**
+     * Rule: String maximum length
+     */
+    static maxLength(max: number): ValidationRule;
+    /**
+     * Rule: Valid email format
+     */
+    static email(): ValidationRule;
+    /**
+     * Rule: Numeric value within range
+     */
+    static numberRange(min?: number, max?: number): ValidationRule;
+    /**
+     * Rule: Value matches regex pattern
+     */
+    static pattern(regex: RegExp, message: string): ValidationRule;
+    /**
+     * Rule: Value is one of allowed options
+     */
+    static oneOf(options: any[], message?: string): ValidationRule;
+    /**
+     * Rule: Array has minimum length
+     */
+    static arrayMinLength(min: number): ValidationRule;
+    /**
+     * Rule: Custom validation with context
+     */
+    static custom(validator: (value: any, data?: any) => string | null): ValidationRule;
+    /**
+     * Rule: Conditional validation
+     */
+    static when(condition: (data: any) => boolean, rule: ValidationRule): ValidationRule;
+    /**
+     * Combine multiple validation rules
+     */
+    static combine(...rules: ValidationRule[]): ValidationRule[];
+    /**
+     * Create validation rules for common entity patterns
+     */
+    static entityId(): ValidationRule[];
+    /**
+     * Create validation rules for user creation
+     */
+    static userCreation(): {
+        name: ValidationRule[];
+        email: ValidationRule[];
+        password: ValidationRule[];
+    };
+    /**
+     * Create validation rules for pagination
+     */
+    static pagination(): {
+        limit: ValidationRule[];
+        offset: ValidationRule[];
+    };
+}
+//# sourceMappingURL=ValidationHelper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationHelper.d.ts","sourceRoot":"","sources":["../../src/validation/ValidationHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,qBAAa,gBAAgB;IACzB;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,cAAc;IASjC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc;IAU7C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc;IAU7C;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,cAAc;IAW9B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc;IAgB9D;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc;IAU9D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;IAS9D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc;IAUlD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,GAAG,cAAc;IAInF;;OAEG;IACH,MAAM,CAAC,IAAI,CACP,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EACjC,IAAI,EAAE,cAAc,GACrB,cAAc;IASjB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAI5D;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,cAAc,EAAE;IAanC;;OAEG;IACH,MAAM,CAAC,YAAY;;;;;IAQnB;;OAEG;IACH,MAAM,CAAC,UAAU;;;;CAMpB"}

package/dist/validation/ValidationHelper.js

@@ -0,0 +1,169 @@
+/**
+ * Common validation rules and helpers
+ */
+export class ValidationHelper {
+    /**
+     * Rule: Field is required (not null, undefined, or empty string)
+     */
+    static required() {
+        return (value) => {
+            if (value === null || value === undefined || value === '') {
+                return 'This field is required';
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: String minimum length
+     */
+    static minLength(min) {
+        return (value) => {
+            if (typeof value !== 'string')
+                return null;
+            if (value.length < min) {
+                return `Must be at least ${min} characters long`;
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: String maximum length
+     */
+    static maxLength(max) {
+        return (value) => {
+            if (typeof value !== 'string')
+                return null;
+            if (value.length > max) {
+                return `Must be no more than ${max} characters long`;
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: Valid email format
+     */
+    static email() {
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        return (value) => {
+            if (typeof value !== 'string')
+                return null;
+            if (!emailRegex.test(value)) {
+                return 'Must be a valid email address';
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: Numeric value within range
+     */
+    static numberRange(min, max) {
+        return (value) => {
+            const num = Number(value);
+            if (isNaN(num)) {
+                return 'Must be a valid number';
+            }
+            if (min !== undefined && num < min) {
+                return `Must be at least ${min}`;
+            }
+            if (max !== undefined && num > max) {
+                return `Must be no more than ${max}`;
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: Value matches regex pattern
+     */
+    static pattern(regex, message) {
+        return (value) => {
+            if (typeof value !== 'string')
+                return null;
+            if (!regex.test(value)) {
+                return message;
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: Value is one of allowed options
+     */
+    static oneOf(options, message) {
+        return (value) => {
+            if (!options.includes(value)) {
+                return message || `Must be one of: ${options.join(', ')}`;
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: Array has minimum length
+     */
+    static arrayMinLength(min) {
+        return (value) => {
+            if (!Array.isArray(value))
+                return null;
+            if (value.length < min) {
+                return `Must contain at least ${min} items`;
+            }
+            return null;
+        };
+    }
+    /**
+     * Rule: Custom validation with context
+     */
+    static custom(validator) {
+        return validator;
+    }
+    /**
+     * Rule: Conditional validation
+     */
+    static when(condition, rule) {
+        return (value, data) => {
+            if (condition(data || {})) {
+                return rule(value, data);
+            }
+            return null;
+        };
+    }
+    /**
+     * Combine multiple validation rules
+     */
+    static combine(...rules) {
+        return rules;
+    }
+    /**
+     * Create validation rules for common entity patterns
+     */
+    static entityId() {
+        return [
+            this.required(),
+            this.custom((value) => {
+                const id = Number(value);
+                if (isNaN(id) || id <= 0) {
+                    return 'Must be a valid positive ID';
+                }
+                return null;
+            })
+        ];
+    }
+    /**
+     * Create validation rules for user creation
+     */
+    static userCreation() {
+        return {
+            name: [this.required(), this.minLength(2), this.maxLength(100)],
+            email: [this.required(), this.email()],
+            password: [this.required(), this.minLength(8)]
+        };
+    }
+    /**
+     * Create validation rules for pagination
+     */
+    static pagination() {
+        return {
+            limit: [this.numberRange(1, 100)],
+            offset: [this.numberRange(0)]
+        };
+    }
+}
+//# sourceMappingURL=ValidationHelper.js.map

package/dist/validation/ValidationHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationHelper.js","sourceRoot":"","sources":["../../src/validation/ValidationHelper.ts"],"names":[],"mappings":"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"}

package/dist/validation/ValidationResult.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Result of input validation
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    isValid: boolean;
+    /** Validation errors by field name */
+    errors: Record<string, string[]>;
+    /** Total number of errors */
+    errorCount: number;
+}
+//# sourceMappingURL=ValidationResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationResult.d.ts","sourceRoot":"","sources":["../../src/validation/ValidationResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/validation/ValidationResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ValidationResult.js.map

package/dist/validation/ValidationResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationResult.js","sourceRoot":"","sources":["../../src/validation/ValidationResult.ts"],"names":[],"mappings":""}

package/dist/validation/Validator.d.ts

@@ -0,0 +1,35 @@
+import { ValidationResult } from './ValidationResult.js';
+/**
+ * Validation rule function
+ */
+export type ValidationRule = (value: any, data?: any) => string | null;
+/**
+ * Validation rules by field name
+ */
+export type ValidationRules = Record<string, ValidationRule[]>;
+/**
+ * Simple, extensible validation system
+ */
+export declare class Validator {
+    private customRules;
+    /**
+     * Register a custom validation rule
+     * @param name - Rule name
+     * @param rule - Validation function
+     */
+    registerRule(name: string, rule: ValidationRule): void;
+    /**
+     * Validate data against rules
+     * @param data - Data to validate
+     * @param rules - Validation rules
+     * @returns ValidationResult
+     */
+    validate<T>(data: T, rules: ValidationRules): Promise<ValidationResult>;
+    /**
+     * Get a registered custom rule
+     * @param name - Rule name
+     * @returns ValidationRule or undefined
+     */
+    getRule(name: string): ValidationRule | undefined;
+}
+//# sourceMappingURL=Validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../src/validation/Validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAE/D;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,WAAW,CAA0C;IAE7D;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAItD;;;;;OAKG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6B7E;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;CAGpD"}

package/dist/validation/Validator.js

@@ -0,0 +1,52 @@
+/**
+ * Simple, extensible validation system
+ */
+export class Validator {
+    customRules = new Map();
+    /**
+     * Register a custom validation rule
+     * @param name - Rule name
+     * @param rule - Validation function
+     */
+    registerRule(name, rule) {
+        this.customRules.set(name, rule);
+    }
+    /**
+     * Validate data against rules
+     * @param data - Data to validate
+     * @param rules - Validation rules
+     * @returns ValidationResult
+     */
+    async validate(data, rules) {
+        const errors = {};
+        const dataObj = data;
+        for (const [fieldName, fieldRules] of Object.entries(rules)) {
+            const fieldErrors = [];
+            const fieldValue = dataObj[fieldName];
+            for (const rule of fieldRules) {
+                const errorMessage = rule(fieldValue, dataObj);
+                if (errorMessage) {
+                    fieldErrors.push(errorMessage);
+                }
+            }
+            if (fieldErrors.length > 0) {
+                errors[fieldName] = fieldErrors;
+            }
+        }
+        const errorCount = Object.values(errors).reduce((sum, errs) => sum + errs.length, 0);
+        return {
+            isValid: errorCount === 0,
+            errors,
+            errorCount
+        };
+    }
+    /**
+     * Get a registered custom rule
+     * @param name - Rule name
+     * @returns ValidationRule or undefined
+     */
+    getRule(name) {
+        return this.customRules.get(name);
+    }
+}
+//# sourceMappingURL=Validator.js.map

package/dist/validation/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../src/validation/Validator.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAO,SAAS;IACV,WAAW,GAAgC,IAAI,GAAG,EAAE,CAAC;IAE7D;;;;OAIG;IACH,YAAY,CAAC,IAAY,EAAE,IAAoB;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAI,IAAO,EAAE,KAAsB;QAC7C,MAAM,MAAM,GAA6B,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAA2B,CAAC;QAE5C,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,WAAW,GAAa,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAEtC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC/C,IAAI,YAAY,EAAE,CAAC;oBACf,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACnC,CAAC;YACL,CAAC;YAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;YACpC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAErF,OAAO;YACH,OAAO,EAAE,UAAU,KAAK,CAAC;YACzB,MAAM;YACN,UAAU;SACb,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;CACJ"}