@freshguard/freshguard-core 0.11.2

package/dist/types.d.ts

@@ -0,0 +1,244 @@
+export type DataSourceType = 'postgres' | 'duckdb' | 'bigquery' | 'snowflake';
+export type RuleType = 'freshness' | 'volume_anomaly' | 'schema_change' | 'custom_sql';
+export type CheckStatus = 'ok' | 'alert' | 'failed' | 'pending';
+export type AlertDestinationType = 'slack' | 'email' | 'pagerduty' | 'webhook';
+export type SeverityLevel = 'low' | 'medium' | 'high' | 'critical';
+export interface SourceCredentials {
+    host?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    connectionString?: string;
+    sslMode?: 'disable' | 'require' | 'verify-ca' | 'verify-full';
+    additionalOptions?: Record<string, unknown>;
+}
+export interface DataSource {
+    id: string;
+    name: string;
+    type: DataSourceType;
+    credentials: SourceCredentials;
+    isActive: boolean;
+    lastTestedAt?: Date;
+    lastTestSuccess?: boolean;
+    lastError?: string;
+    tableCount?: number;
+    estimatedSizeBytes?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface MonitoringRule {
+    id: string;
+    sourceId: string;
+    name: string;
+    description?: string;
+    tableName: string;
+    ruleType: RuleType;
+    expectedFrequency?: string;
+    toleranceMinutes?: number;
+    timestampColumn?: string;
+    baselineWindowDays?: number;
+    deviationThresholdPercent?: number;
+    minimumRowCount?: number;
+    baselineConfig?: {
+        windowDays?: number;
+        minimumDataPoints?: number;
+        timeoutSeconds?: number;
+        excludeWeekends?: boolean;
+        calculationMethod?: 'mean' | 'median' | 'trimmed_mean';
+        trimmedMeanPercentile?: number;
+        seasonalAdjustment?: boolean;
+    };
+    trackColumnChanges?: boolean;
+    trackTableChanges?: boolean;
+    schemaChangeConfig?: {
+        adaptationMode?: 'auto' | 'manual' | 'alert_only';
+        monitoringMode?: 'full' | 'partial';
+        trackedColumns?: {
+            columns?: string[];
+            alertLevel?: 'low' | 'medium' | 'high';
+            trackTypes?: boolean;
+            trackNullability?: boolean;
+        };
+        baselineRefreshDays?: number;
+    };
+    customSql?: string;
+    expectedResult?: unknown;
+    checkIntervalMinutes: number;
+    timezone?: string;
+    isActive: boolean;
+    lastCheckAt?: Date;
+    lastStatus?: CheckStatus;
+    consecutiveFailures?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface AlertDestination {
+    id: string;
+    ruleId: string;
+    destinationType: AlertDestinationType;
+    destinationAddress: string;
+    severityLevel?: SeverityLevel;
+    alertOnRecovery?: boolean;
+    cooldownMinutes?: number;
+    messageTemplate?: string;
+    includeQueryResults?: boolean;
+    isActive: boolean;
+    createdAt: Date;
+}
+export interface DebugInfo {
+    query?: string;
+    params?: unknown[];
+    rawError?: string;
+    suggestion?: string;
+    duration?: number;
+    debugId?: string;
+    context?: Record<string, unknown>;
+}
+export interface DebugConfig {
+    enabled?: boolean;
+    exposeQueries?: boolean;
+    exposeRawErrors?: boolean;
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+    correlationId?: string;
+}
+export interface CheckResult {
+    status: CheckStatus;
+    rowCount?: number;
+    lastUpdate?: Date;
+    lagMinutes?: number;
+    deviation?: number;
+    baselineAverage?: number;
+    schemaChanges?: SchemaChanges;
+    error?: string;
+    queryExecuted?: string;
+    executionDurationMs?: number;
+    executedAt: Date;
+    nextCheckAt?: Date;
+    debugId?: string;
+    debug?: DebugInfo;
+}
+export interface CheckExecution {
+    id: string;
+    ruleId: string;
+    sourceId: string;
+    status: CheckStatus;
+    errorMessage?: string;
+    queryExecuted?: string;
+    executionDurationMs?: number;
+    rowCount?: number;
+    lastUpdate?: Date;
+    lagMinutes?: number;
+    baselineAverage?: number;
+    currentDeviationPercent?: number;
+    schemaChanges?: unknown;
+    executedAt: Date;
+    nextCheckAt?: Date;
+}
+export interface ColumnChange {
+    columnName: string;
+    changeType: 'added' | 'removed' | 'type_changed' | 'nullability_changed';
+    oldValue?: string;
+    newValue?: string;
+    impact: 'safe' | 'warning' | 'breaking';
+}
+export interface SchemaChanges {
+    hasChanges: boolean;
+    addedColumns: ColumnChange[];
+    removedColumns: ColumnChange[];
+    modifiedColumns: ColumnChange[];
+    summary: string;
+    changeCount: number;
+    severity: 'low' | 'medium' | 'high';
+}
+export interface SchemaBaseline {
+    ruleId: string;
+    tableName: string;
+    schema: import('./types/connector.js').TableSchema;
+    capturedAt: Date;
+    schemaHash: string;
+}
+export interface AlertLogEntry {
+    id: string;
+    executionId: string;
+    ruleId: string;
+    alertType: string;
+    destinationType: AlertDestinationType;
+    destinationAddress: string;
+    subject?: string;
+    messageContent?: string;
+    alertSeverity: SeverityLevel;
+    status: 'pending' | 'sent' | 'failed';
+    deliveryAttempts: number;
+    lastAttemptAt?: Date;
+    errorMessage?: string;
+    externalId?: string;
+    sentAt?: Date;
+    createdAt: Date;
+}
+export interface CreateSourceRequest {
+    name: string;
+    type: DataSourceType;
+    credentials: SourceCredentials;
+}
+export interface TestConnectionResponse {
+    success: boolean;
+    tableCount?: number;
+    tables?: string[];
+    error?: string;
+}
+export interface CreateRuleRequest {
+    sourceId: string;
+    name: string;
+    description?: string;
+    tableName: string;
+    ruleType: RuleType;
+    toleranceMinutes?: number;
+    timestampColumn?: string;
+    baselineWindowDays?: number;
+    deviationThresholdPercent?: number;
+    minimumRowCount?: number;
+    checkIntervalMinutes: number;
+    alertDestinations?: Omit<AlertDestination, 'id' | 'ruleId' | 'createdAt'>[];
+}
+export interface UpdateRuleRequest {
+    name?: string;
+    description?: string;
+    isActive?: boolean;
+    toleranceMinutes?: number;
+    deviationThresholdPercent?: number;
+    checkIntervalMinutes?: number;
+}
+export interface TriggerCheckRequest {
+    ruleId: string;
+}
+export interface TriggerCheckResponse {
+    executionId: string;
+    result: CheckResult;
+}
+export interface FreshGuardConfig {
+    sources: Record<string, {
+        type: DataSourceType;
+        url?: string;
+        credentials?: SourceCredentials;
+    }>;
+    rules: {
+        id: string;
+        sourceId: string;
+        table: string;
+        type: RuleType;
+        frequency: number;
+        tolerance?: number;
+        alerts: {
+            type: AlertDestinationType;
+            address: string;
+        }[];
+    }[];
+    scheduler?: {
+        enabled: boolean;
+        timezone?: string;
+    };
+    timeoutMs?: number;
+    debug?: DebugConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,7 @@
+export * from './schemas.js';
+export * from './runtime-validator.js';
+export * from './sanitizers.js';
+export { validateTableName, validateColumnName, validateDatabaseIdentifier, validateConnectorConfig, sanitizeString, validateLimit, validateConnectionString } from './runtime-validator.js';
+export type { ValidationError, ValidationResult } from './runtime-validator.js';
+export type { SanitizationPolicy, SanitizationResult } from './sanitizers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAUA,cAAc,cAAc,CAAC;AAG7B,cAAc,wBAAwB,CAAC;AAGvC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,eAAe,EACf,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,5 @@
+export * from './schemas.js';
+export * from './runtime-validator.js';
+export * from './sanitizers.js';
+export { validateTableName, validateColumnName, validateDatabaseIdentifier, validateConnectorConfig, sanitizeString, validateLimit, validateConnectionString } from './runtime-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAUA,cAAc,cAAc,CAAC;AAG7B,cAAc,wBAAwB,CAAC;AAGvC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,wBAAwB,EACzB,MAAM,wBAAwB,CAAC"}

package/dist/validation/runtime-validator.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { schemas } from './schemas.js';
+export interface ValidationError {
+    field: string;
+    code: string;
+    message: string;
+    value?: unknown;
+}
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: ValidationError[];
+};
+export declare class ValidationException extends Error {
+    readonly errors: ValidationError[];
+    readonly timestamp: Date;
+    constructor(errors: ValidationError[], message?: string);
+    getFormattedErrors(): string;
+    toJSON(): {
+        name: string;
+        message: string;
+        errors: ValidationError[];
+        timestamp: Date;
+    };
+}
+export declare class RuntimeValidator {
+    private readonly schemaCache;
+    private validationStats;
+    constructor();
+    validate<T>(schema: z.ZodSchema<T>, data: unknown): ValidationResult<T>;
+    validateOrThrow<T>(schema: z.ZodSchema<T>, data: unknown, context?: string): T;
+    validateTableName(name: unknown): ValidationResult<string>;
+    validateColumnName(name: unknown): ValidationResult<string>;
+    validateDatabaseIdentifier(identifier: unknown, type?: 'table' | 'column'): ValidationResult<string>;
+    validateConnectorConfig(config: unknown, type?: 'postgres' | 'duckdb' | 'bigquery' | 'snowflake'): ValidationResult<any>;
+    validateSanitizedString(input: unknown): ValidationResult<string>;
+    validateLimit(limit: unknown): ValidationResult<number>;
+    validateConnectionString(connectionString: unknown): ValidationResult<string>;
+    validateFreshnessRule(rule: unknown): ValidationResult<z.infer<typeof schemas.FreshnessRuleSchema>>;
+    validateVolumeRule(rule: unknown): ValidationResult<z.infer<typeof schemas.VolumeRuleSchema>>;
+    validateBatch<T>(schema: z.ZodSchema<T>, items: unknown[]): {
+        valid: T[];
+        invalid: {
+            index: number;
+            errors: ValidationError[];
+        }[];
+    };
+    getStats(): {
+        successRate: string;
+        total: number;
+        successes: number;
+        failures: number;
+    };
+    resetStats(): void;
+    clearCache(): void;
+}
+declare const globalValidator: RuntimeValidator;
+export declare function validateTableName(name: unknown): string;
+export declare function validateColumnName(name: unknown): string;
+export declare function validateDatabaseIdentifier(identifier: unknown, type?: 'table' | 'column'): string;
+export declare function validateConnectorConfig(config: unknown, type?: 'postgres' | 'duckdb' | 'bigquery' | 'snowflake'): any;
+export declare function sanitizeString(input: unknown): string;
+export declare function validateLimit(limit: unknown): number;
+export declare function validateConnectionString(connectionString: unknown): string;
+export declare function createValidationMiddleware<T>(schema: z.ZodSchema<T>): (data: unknown) => T;
+export declare function createAsyncValidationMiddleware<T>(schema: z.ZodSchema<T>): (data: unknown) => Promise<T>;
+export { globalValidator as validator, schemas };
+//# sourceMappingURL=runtime-validator.d.ts.map

package/dist/validation/runtime-validator.d.ts.map

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

package/dist/validation/runtime-validator.js

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+import { schemas } from './schemas.js';
+export class ValidationException extends Error {
+    errors;
+    timestamp;
+    constructor(errors, message) {
+        const defaultMessage = `Validation failed with ${errors.length} error${errors.length === 1 ? '' : 's'}`;
+        super(message || defaultMessage);
+        this.name = 'ValidationException';
+        this.errors = errors;
+        this.timestamp = new Date();
+    }
+    getFormattedErrors() {
+        return this.errors
+            .map(error => `${error.field}: ${error.message}`)
+            .join(', ');
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            errors: this.errors,
+            timestamp: this.timestamp
+        };
+    }
+}
+function formatZodErrors(zodError) {
+    return zodError.issues.map((issue) => ({
+        field: issue.path.join('.') || 'root',
+        code: issue.code,
+        message: issue.message,
+        value: issue.path.length > 0 ? undefined : issue.received
+    }));
+}
+export class RuntimeValidator {
+    schemaCache = new Map();
+    validationStats = {
+        total: 0,
+        successes: 0,
+        failures: 0
+    };
+    constructor() {
+        this.schemaCache.set('TableName', schemas.TableNameSchema);
+        this.schemaCache.set('ColumnName', schemas.ColumnNameSchema);
+        this.schemaCache.set('BaseConnectorConfig', schemas.BaseConnectorConfigSchema);
+        this.schemaCache.set('PostgresConnectorConfig', schemas.PostgresConnectorConfigSchema);
+        this.schemaCache.set('DuckDBConnectorConfig', schemas.DuckDBConnectorConfigSchema);
+        this.schemaCache.set('BigQueryConnectorConfig', schemas.BigQueryConnectorConfigSchema);
+        this.schemaCache.set('SnowflakeConnectorConfig', schemas.SnowflakeConnectorConfigSchema);
+    }
+    validate(schema, data) {
+        this.validationStats.total++;
+        try {
+            const result = schema.parse(data);
+            this.validationStats.successes++;
+            return {
+                success: true,
+                data: result
+            };
+        }
+        catch (error) {
+            this.validationStats.failures++;
+            if (error instanceof z.ZodError) {
+                const validationErrors = formatZodErrors(error);
+                return {
+                    success: false,
+                    errors: validationErrors
+                };
+            }
+            return {
+                success: false,
+                errors: [{
+                        field: 'unknown',
+                        code: 'unknown_error',
+                        message: error instanceof Error ? error.message : 'Unknown validation error'
+                    }]
+            };
+        }
+    }
+    validateOrThrow(schema, data, context) {
+        const result = this.validate(schema, data);
+        if (!result.success) {
+            const message = context
+                ? `Validation failed for ${context}`
+                : 'Validation failed';
+            throw new ValidationException(result.errors, message);
+        }
+        return result.data;
+    }
+    validateTableName(name) {
+        return this.validate(schemas.TableNameSchema, name);
+    }
+    validateColumnName(name) {
+        return this.validate(schemas.ColumnNameSchema, name);
+    }
+    validateDatabaseIdentifier(identifier, type = 'table') {
+        const schema = type === 'table' ? schemas.TableNameSchema : schemas.ColumnNameSchema;
+        return this.validate(schema, identifier);
+    }
+    validateConnectorConfig(config, type) {
+        let schema;
+        switch (type) {
+            case 'postgres':
+                schema = schemas.PostgresConnectorConfigSchema;
+                break;
+            case 'duckdb':
+                schema = schemas.DuckDBConnectorConfigSchema;
+                break;
+            case 'bigquery':
+                schema = schemas.BigQueryConnectorConfigSchema;
+                break;
+            case 'snowflake':
+                schema = schemas.SnowflakeConnectorConfigSchema;
+                break;
+            default:
+                schema = schemas.BaseConnectorConfigSchema;
+        }
+        return this.validate(schema, config);
+    }
+    validateSanitizedString(input) {
+        return this.validate(schemas.SanitizedStringSchema, input);
+    }
+    validateLimit(limit) {
+        return this.validate(schemas.LimitSchema, limit);
+    }
+    validateConnectionString(connectionString) {
+        return this.validate(schemas.ConnectionStringSchema, connectionString);
+    }
+    validateFreshnessRule(rule) {
+        return this.validate(schemas.FreshnessRuleSchema, rule);
+    }
+    validateVolumeRule(rule) {
+        return this.validate(schemas.VolumeRuleSchema, rule);
+    }
+    validateBatch(schema, items) {
+        const valid = [];
+        const invalid = [];
+        items.forEach((item, index) => {
+            const result = this.validate(schema, item);
+            if (result.success) {
+                valid.push(result.data);
+            }
+            else {
+                invalid.push({ index, errors: result.errors });
+            }
+        });
+        return { valid, invalid };
+    }
+    getStats() {
+        return {
+            ...this.validationStats,
+            successRate: this.validationStats.total > 0
+                ? (this.validationStats.successes / this.validationStats.total * 100).toFixed(2) + '%'
+                : '0%'
+        };
+    }
+    resetStats() {
+        this.validationStats = {
+            total: 0,
+            successes: 0,
+            failures: 0
+        };
+    }
+    clearCache() {
+        this.schemaCache.clear();
+    }
+}
+const globalValidator = new RuntimeValidator();
+export function validateTableName(name) {
+    return globalValidator.validateOrThrow(schemas.TableNameSchema, name, 'table name');
+}
+export function validateColumnName(name) {
+    return globalValidator.validateOrThrow(schemas.ColumnNameSchema, name, 'column name');
+}
+export function validateDatabaseIdentifier(identifier, type = 'table') {
+    const schema = type === 'table' ? schemas.TableNameSchema : schemas.ColumnNameSchema;
+    return globalValidator.validateOrThrow(schema, identifier, `${type} identifier`);
+}
+export function validateConnectorConfig(config, type) {
+    const result = globalValidator.validateConnectorConfig(config, type);
+    if (!result.success) {
+        throw new ValidationException(result.errors, `Invalid ${type || 'base'} connector configuration`);
+    }
+    return result.data;
+}
+export function sanitizeString(input) {
+    return globalValidator.validateOrThrow(schemas.SanitizedStringSchema, input, 'string input');
+}
+export function validateLimit(limit) {
+    return globalValidator.validateOrThrow(schemas.LimitSchema, limit, 'LIMIT value');
+}
+export function validateConnectionString(connectionString) {
+    return globalValidator.validateOrThrow(schemas.ConnectionStringSchema, connectionString, 'connection string');
+}
+export function createValidationMiddleware(schema) {
+    return (data) => {
+        return globalValidator.validateOrThrow(schema, data);
+    };
+}
+export function createAsyncValidationMiddleware(schema) {
+    return async (data) => {
+        return globalValidator.validateOrThrow(schema, data);
+    };
+}
+export { globalValidator as validator, schemas };
+//# sourceMappingURL=runtime-validator.js.map

package/dist/validation/runtime-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-validator.js","sourceRoot":"","sources":["../../src/validation/runtime-validator.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA8BvC,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5B,MAAM,CAAoB;IAC1B,SAAS,CAAO;IAEhC,YAAY,MAAyB,EAAE,OAAgB;QACrD,MAAM,cAAc,GAAG,0BAA0B,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACxG,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC9B,CAAC;IAKD,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aAChD,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAKD,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AASD,SAAS,eAAe,CAAC,QAAoB;IAC3C,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM;QACrC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,KAAa,CAAC,QAAQ;KACnE,CAAC,CAAC,CAAC;AACN,CAAC;AAUD,MAAM,OAAO,gBAAgB;IACV,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,eAAe,GAAG;QACxB,KAAK,EAAE,CAAC;QACR,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;KACZ,CAAC;IAEF;QAEE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC/E,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,yBAAyB,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACvF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,uBAAuB,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACnF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,yBAAyB,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACvF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,0BAA0B,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC3F,CAAC;IAKD,QAAQ,CAAI,MAAsB,EAAE,IAAa;QAC/C,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;aACb,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAEhC,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBAChD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,gBAAgB;iBACzB,CAAC;YACJ,CAAC;YAGD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,CAAC;wBACP,KAAK,EAAE,SAAS;wBAChB,IAAI,EAAE,eAAe;wBACrB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;qBAC7E,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC;IAKD,eAAe,CAAI,MAAsB,EAAE,IAAa,EAAE,OAAgB;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,OAAO;gBACrB,CAAC,CAAC,yBAAyB,OAAO,EAAE;gBACpC,CAAC,CAAC,mBAAmB,CAAC;YACxB,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAKD,iBAAiB,CAAC,IAAa;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAKD,kBAAkB,CAAC,IAAa;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAKD,0BAA0B,CAAC,UAAmB,EAAE,OAA2B,OAAO;QAChF,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACrF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAKD,uBAAuB,CAAC,MAAe,EAAE,IAAuD;QAC9F,IAAI,MAAmB,CAAC;QAExB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU;gBACb,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;gBAC/C,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;gBAC7C,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;gBAC/C,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC;gBAChD,MAAM;YACR;gBACE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAKD,uBAAuB,CAAC,KAAc;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAKD,aAAa,CAAC,KAAc;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAKD,wBAAwB,CAAC,gBAAyB;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAKD,qBAAqB,CAAC,IAAa;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAKD,kBAAkB,CAAC,IAAa;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAKD,aAAa,CAAI,MAAsB,EAAE,KAAgB;QAIvD,MAAM,KAAK,GAAQ,EAAE,CAAC;QACtB,MAAM,OAAO,GAAmD,EAAE,CAAC;QAEnE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5B,CAAC;IAKD,QAAQ;QACN,OAAO;YACL,GAAG,IAAI,CAAC,eAAe;YACvB,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC;gBACzC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG;gBACtF,CAAC,CAAC,IAAI;SACT,CAAC;IACJ,CAAC;IAKD,UAAU;QACR,IAAI,CAAC,eAAe,GAAG;YACrB,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAKD,UAAU;QACR,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAOD,MAAM,eAAe,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAK/C,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;AACtF,CAAC;AAKD,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;AACxF,CAAC;AAKD,MAAM,UAAU,0BAA0B,CAAC,UAAmB,EAAE,OAA2B,OAAO;IAChG,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACrF,OAAO,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;AACnF,CAAC;AAKD,MAAM,UAAU,uBAAuB,CAAC,MAAe,EAAE,IAAuD;IAC9G,MAAM,MAAM,GAAG,eAAe,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAErE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,IAAI,IAAI,MAAM,0BAA0B,CAAC,CAAC;IACpG,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAKD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,qBAAqB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AAC/F,CAAC;AAKD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AACpF,CAAC;AAKD,MAAM,UAAU,wBAAwB,CAAC,gBAAyB;IAChE,OAAO,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,sBAAsB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;AAChH,CAAC;AASD,MAAM,UAAU,0BAA0B,CAAI,MAAsB;IAClE,OAAO,CAAC,IAAa,EAAK,EAAE;QAC1B,OAAO,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAKD,MAAM,UAAU,+BAA+B,CAAI,MAAsB;IACvE,OAAO,KAAK,EAAE,IAAa,EAAc,EAAE;QACzC,OAAO,eAAe,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAMD,OAAO,EACL,eAAe,IAAI,SAAS,EAC5B,OAAO,EACR,CAAC"}

package/dist/validation/sanitizers.d.ts

@@ -0,0 +1,56 @@
+export interface SanitizationPolicy {
+    removeControlCharacters: boolean;
+    removeSqlComments: boolean;
+    removeSqlOperators: boolean;
+    maxLength: number;
+    throwOnEmpty: boolean;
+    customPatterns?: RegExp[];
+    allowUnicode: boolean;
+}
+export interface SanitizationResult {
+    value: string;
+    wasModified: boolean;
+    modifications: string[];
+    originalLength: number;
+    finalLength: number;
+}
+export declare function sanitizeString(input: unknown, policy?: Partial<SanitizationPolicy>): SanitizationResult;
+export declare function sanitizeIdentifier(input: unknown): SanitizationResult;
+export declare function sanitizeUserInput(input: unknown, maxLength?: number): SanitizationResult;
+export declare function sanitizePath(input: unknown): SanitizationResult;
+export declare function sanitizeEmail(input: unknown): SanitizationResult;
+export declare function sanitizeUrl(input: unknown): SanitizationResult;
+export declare function sanitizeJson(input: unknown): SanitizationResult;
+export declare function sanitizeBatch(inputs: unknown[], policy?: Partial<SanitizationPolicy>): {
+    results: SanitizationResult[];
+    summary: {
+        total: number;
+        modified: number;
+        errors: number;
+    };
+};
+export declare function containsDangerousPatterns(input: string): {
+    isDangerous: boolean;
+    patterns: string[];
+};
+export declare function escapeForSql(input: string): string;
+export declare function createLogSafeString(input: string, maxLength?: number): string;
+export declare const sanitizers: {
+    readonly sanitizeString: typeof sanitizeString;
+    readonly sanitizeIdentifier: typeof sanitizeIdentifier;
+    readonly sanitizeUserInput: typeof sanitizeUserInput;
+    readonly sanitizePath: typeof sanitizePath;
+    readonly sanitizeEmail: typeof sanitizeEmail;
+    readonly sanitizeUrl: typeof sanitizeUrl;
+    readonly sanitizeJson: typeof sanitizeJson;
+    readonly sanitizeBatch: typeof sanitizeBatch;
+    readonly containsDangerousPatterns: typeof containsDangerousPatterns;
+    readonly escapeForSql: typeof escapeForSql;
+    readonly createLogSafeString: typeof createLogSafeString;
+};
+export declare const policies: {
+    readonly DEFAULT_POLICY: SanitizationPolicy;
+    readonly LENIENT_POLICY: SanitizationPolicy;
+    readonly STRICT_POLICY: SanitizationPolicy;
+};
+//# sourceMappingURL=sanitizers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizers.d.ts","sourceRoot":"","sources":["../../src/validation/sanitizers.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IAEjC,uBAAuB,EAAE,OAAO,CAAC;IAEjC,iBAAiB,EAAE,OAAO,CAAC;IAE3B,kBAAkB,EAAE,OAAO,CAAC;IAE5B,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,EAAE,OAAO,CAAC;IAEtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAiDD,MAAM,WAAW,kBAAkB;IAEjC,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,EAAE,OAAO,CAAC;IAErB,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,cAAc,EAAE,MAAM,CAAC;IAEvB,WAAW,EAAE,MAAM,CAAC;CACrB;AASD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC,kBAAkB,CAiFpB;AAKD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAErE;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAO,GAAG,kBAAkB,CAKtF;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAiB/D;AASD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAqBhE;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAuB9D;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAsB/D;AASD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,EAAE,EACjB,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC;IACD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF,CAiCA;AASD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAqBA;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAc1E;AAMD,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;CAIX,CAAC"}