@ductape/sdk 0.0.4-v42 → 0.0.4-v43

package/dist/database/validators/query.validator.js

@@ -0,0 +1,305 @@
+"use strict";
+/**
+ * Query Validator
+ * Validates query options and data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateQueryOptions = validateQueryOptions;
+exports.validateInsertData = validateInsertData;
+exports.validateUpdateData = validateUpdateData;
+exports.assertValidQueryOptions = assertValidQueryOptions;
+exports.assertValidInsertData = assertValidInsertData;
+exports.assertValidUpdateData = assertValidUpdateData;
+const query_types_1 = require("../types/query.types");
+const schema_types_1 = require("../types/schema.types");
+/**
+ * Validate query options
+ */
+function validateQueryOptions(options) {
+    const errors = [];
+    if (!options) {
+        return { valid: true, errors: [] };
+    }
+    // Validate limit
+    if (options.limit !== undefined) {
+        if (typeof options.limit !== 'number') {
+            errors.push('limit must be a number');
+        }
+        else if (options.limit < 1) {
+            errors.push('limit must be a positive number');
+        }
+        else if (!Number.isInteger(options.limit)) {
+            errors.push('limit must be an integer');
+        }
+    }
+    // Validate offset
+    if (options.offset !== undefined) {
+        if (typeof options.offset !== 'number') {
+            errors.push('offset must be a number');
+        }
+        else if (options.offset < 0) {
+            errors.push('offset must be a non-negative number');
+        }
+        else if (!Number.isInteger(options.offset)) {
+            errors.push('offset must be an integer');
+        }
+    }
+    // Validate orderBy
+    if (options.orderBy) {
+        const orderByArray = Array.isArray(options.orderBy) ? options.orderBy : [options.orderBy];
+        orderByArray.forEach((orderBy, index) => {
+            if (!orderBy.column || typeof orderBy.column !== 'string') {
+                errors.push(`orderBy[${index}]: column is required and must be a string`);
+            }
+            if (orderBy.order !== query_types_1.SortOrder.ASC && orderBy.order !== query_types_1.SortOrder.DESC) {
+                errors.push(`orderBy[${index}]: order must be "${query_types_1.SortOrder.ASC}" or "${query_types_1.SortOrder.DESC}"`);
+            }
+        });
+    }
+    // Validate select
+    if (options.select) {
+        if (!Array.isArray(options.select)) {
+            errors.push('select must be an array');
+        }
+        else if (options.select.length === 0) {
+            errors.push('select array cannot be empty');
+        }
+        else {
+            options.select.forEach((field, index) => {
+                if (typeof field !== 'string' || field.length === 0) {
+                    errors.push(`select[${index}] must be a non-empty string`);
+                }
+            });
+        }
+    }
+    // Validate groupBy
+    if (options.groupBy) {
+        if (!Array.isArray(options.groupBy)) {
+            errors.push('groupBy must be an array');
+        }
+        else if (options.groupBy.length === 0) {
+            errors.push('groupBy array cannot be empty');
+        }
+        else {
+            options.groupBy.forEach((field, index) => {
+                if (typeof field !== 'string' || field.length === 0) {
+                    errors.push(`groupBy[${index}] must be a non-empty string`);
+                }
+            });
+        }
+    }
+    // Validate distinct
+    if (options.distinct !== undefined && typeof options.distinct !== 'boolean') {
+        errors.push('distinct must be a boolean');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate insert data against column definitions
+ */
+function validateInsertData(data, columns) {
+    const errors = [];
+    if (!data) {
+        errors.push('Insert data is required');
+        return { valid: false, errors };
+    }
+    const records = Array.isArray(data) ? data : [data];
+    if (records.length === 0) {
+        errors.push('Insert data cannot be empty');
+        return { valid: false, errors };
+    }
+    records.forEach((record, index) => {
+        validateSingleInsertRecord(record, columns, `Record ${index}`, errors);
+    });
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate a single insert record
+ */
+function validateSingleInsertRecord(record, columns, prefix, errors) {
+    if (!record || typeof record !== 'object') {
+        errors.push(`${prefix} must be an object`);
+        return;
+    }
+    const columnMap = new Map(columns.map((c) => [c.name, c]));
+    const providedFields = Object.keys(record);
+    // Check for required fields (non-nullable, no default, no auto-increment)
+    columns.forEach((column) => {
+        const isRequired = !column.nullable && column.defaultValue === undefined && !column.autoIncrement && !column.primaryKey;
+        if (isRequired && !providedFields.includes(column.name)) {
+            errors.push(`${prefix}: required field "${column.name}" is missing`);
+        }
+    });
+    // Validate each provided field
+    Object.entries(record).forEach(([field, value]) => {
+        const column = columnMap.get(field);
+        if (!column) {
+            errors.push(`${prefix}: field "${field}" does not exist in table schema`);
+            return;
+        }
+        // Validate value type
+        validateFieldValue(value, column, `${prefix}.${field}`, errors);
+    });
+}
+/**
+ * Validate update data against column definitions
+ */
+function validateUpdateData(data, columns) {
+    const errors = [];
+    if (!data || typeof data !== 'object') {
+        errors.push('Update data must be an object');
+        return { valid: false, errors };
+    }
+    if (Object.keys(data).length === 0) {
+        errors.push('Update data cannot be empty');
+        return { valid: false, errors };
+    }
+    const columnMap = new Map(columns.map((c) => [c.name, c]));
+    Object.entries(data).forEach(([field, value]) => {
+        const column = columnMap.get(field);
+        if (!column) {
+            errors.push(`Field "${field}" does not exist in table schema`);
+            return;
+        }
+        // Cannot update primary key
+        if (column.primaryKey) {
+            errors.push(`Cannot update primary key field "${field}"`);
+            return;
+        }
+        // Cannot update auto-increment fields
+        if (column.autoIncrement) {
+            errors.push(`Cannot update auto-increment field "${field}"`);
+            return;
+        }
+        // Validate value type
+        validateFieldValue(value, column, field, errors);
+    });
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate a field value against its column definition
+ */
+function validateFieldValue(value, column, prefix, errors) {
+    // Null values
+    if (value === null || value === undefined) {
+        if (!column.nullable) {
+            errors.push(`${prefix}: null value not allowed for non-nullable column`);
+        }
+        return;
+    }
+    // Type-specific validation
+    switch (column.type) {
+        case schema_types_1.ColumnType.STRING:
+        case schema_types_1.ColumnType.VARCHAR:
+        case schema_types_1.ColumnType.CHAR:
+        case schema_types_1.ColumnType.TEXT:
+            if (typeof value !== 'string') {
+                errors.push(`${prefix}: expected string, got ${typeof value}`);
+            }
+            else if (column.length && value.length > column.length) {
+                errors.push(`${prefix}: string length ${value.length} exceeds maximum ${column.length}`);
+            }
+            break;
+        case schema_types_1.ColumnType.INTEGER:
+        case schema_types_1.ColumnType.BIGINT:
+        case schema_types_1.ColumnType.SMALLINT:
+            if (typeof value !== 'number') {
+                errors.push(`${prefix}: expected number, got ${typeof value}`);
+            }
+            else if (!Number.isInteger(value)) {
+                errors.push(`${prefix}: expected integer, got decimal`);
+            }
+            break;
+        case schema_types_1.ColumnType.DECIMAL:
+        case schema_types_1.ColumnType.NUMERIC:
+        case schema_types_1.ColumnType.FLOAT:
+        case schema_types_1.ColumnType.DOUBLE:
+        case schema_types_1.ColumnType.REAL:
+            if (typeof value !== 'number') {
+                errors.push(`${prefix}: expected number, got ${typeof value}`);
+            }
+            break;
+        case schema_types_1.ColumnType.BOOLEAN:
+            if (typeof value !== 'boolean') {
+                errors.push(`${prefix}: expected boolean, got ${typeof value}`);
+            }
+            break;
+        case schema_types_1.ColumnType.DATE:
+        case schema_types_1.ColumnType.DATETIME:
+        case schema_types_1.ColumnType.TIMESTAMP:
+        case schema_types_1.ColumnType.TIME:
+            if (!(value instanceof Date) && typeof value !== 'string') {
+                errors.push(`${prefix}: expected Date or string, got ${typeof value}`);
+            }
+            break;
+        case schema_types_1.ColumnType.JSON:
+        case schema_types_1.ColumnType.JSONB:
+        case schema_types_1.ColumnType.OBJECT:
+            // Any value is valid for JSON (will be serialized)
+            break;
+        case schema_types_1.ColumnType.UUID:
+            if (typeof value !== 'string') {
+                errors.push(`${prefix}: expected string UUID, got ${typeof value}`);
+            }
+            else if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value)) {
+                errors.push(`${prefix}: invalid UUID format`);
+            }
+            break;
+        case schema_types_1.ColumnType.ENUM:
+            if (typeof value !== 'string') {
+                errors.push(`${prefix}: expected string for ENUM type, got ${typeof value}`);
+            }
+            else if (column.enumValues && !column.enumValues.includes(value)) {
+                errors.push(`${prefix}: value "${value}" not in allowed enum values: ${column.enumValues.join(', ')}`);
+            }
+            break;
+        case schema_types_1.ColumnType.BLOB:
+        case schema_types_1.ColumnType.BINARY:
+            if (!Buffer.isBuffer(value) && !(value instanceof Uint8Array)) {
+                errors.push(`${prefix}: expected Buffer or Uint8Array, got ${typeof value}`);
+            }
+            break;
+        case schema_types_1.ColumnType.ARRAY:
+            if (!Array.isArray(value)) {
+                errors.push(`${prefix}: expected array, got ${typeof value}`);
+            }
+            break;
+    }
+}
+/**
+ * Throw an error if query options validation fails
+ */
+function assertValidQueryOptions(options) {
+    const result = validateQueryOptions(options);
+    if (!result.valid) {
+        throw new Error(`Invalid query options:\n${result.errors.join('\n')}`);
+    }
+}
+/**
+ * Throw an error if insert data validation fails
+ */
+function assertValidInsertData(data, columns) {
+    const result = validateInsertData(data, columns);
+    if (!result.valid) {
+        throw new Error(`Invalid insert data:\n${result.errors.join('\n')}`);
+    }
+}
+/**
+ * Throw an error if update data validation fails
+ */
+function assertValidUpdateData(data, columns) {
+    const result = validateUpdateData(data, columns);
+    if (!result.valid) {
+        throw new Error(`Invalid update data:\n${result.errors.join('\n')}`);
+    }
+}
+//# sourceMappingURL=query.validator.js.map

package/dist/database/validators/query.validator.js.map

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

package/dist/database/validators/schema.validator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Schema Validator
+ * Validates table schemas, column definitions, indexes, and constraints
+ */
+import { ITableSchema, IColumnDefinition } from '../types/schema.types';
+import { IIndexDefinition } from '../types/index.types';
+import { IValidationResult } from './connection.validator';
+/**
+ * Validate a table schema
+ */
+export declare function validateTableSchema(schema: ITableSchema): IValidationResult;
+/**
+ * Validate column definition
+ */
+export declare function validateColumnDefinition(column: IColumnDefinition, prefix: string, errors: string[]): void;
+/**
+ * Validate index definition
+ */
+export declare function validateIndexDefinition(index: IIndexDefinition, columns: IColumnDefinition[], prefix: string, errors: string[]): void;
+/**
+ * Throw an error if schema validation fails
+ */
+export declare function assertValidTableSchema(schema: ITableSchema): void;
+/**
+ * Throw an error if column validation fails
+ */
+export declare function assertValidColumn(column: IColumnDefinition): void;
+/**
+ * Throw an error if index validation fails
+ */
+export declare function assertValidIndex(index: IIndexDefinition, columns: IColumnDefinition[]): void;

package/dist/database/validators/schema.validator.js

@@ -0,0 +1,334 @@
+"use strict";
+/**
+ * Schema Validator
+ * Validates table schemas, column definitions, indexes, and constraints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTableSchema = validateTableSchema;
+exports.validateColumnDefinition = validateColumnDefinition;
+exports.validateIndexDefinition = validateIndexDefinition;
+exports.assertValidTableSchema = assertValidTableSchema;
+exports.assertValidColumn = assertValidColumn;
+exports.assertValidIndex = assertValidIndex;
+const schema_types_1 = require("../types/schema.types");
+/**
+ * Validate a table schema
+ */
+function validateTableSchema(schema) {
+    const errors = [];
+    // Validate table name
+    if (!schema.name || typeof schema.name !== 'string') {
+        errors.push('Table name is required and must be a string');
+    }
+    else {
+        validateTableName(schema.name, errors);
+    }
+    // Validate columns
+    if (!schema.columns || !Array.isArray(schema.columns)) {
+        errors.push('Columns array is required');
+    }
+    else {
+        if (schema.columns.length === 0) {
+            errors.push('At least one column is required');
+        }
+        // Validate each column
+        schema.columns.forEach((column, index) => {
+            validateColumnDefinition(column, `Column ${index}`, errors);
+        });
+        // Check for duplicate column names
+        const columnNames = schema.columns.map((c) => c.name);
+        const duplicates = columnNames.filter((name, index) => columnNames.indexOf(name) !== index);
+        if (duplicates.length > 0) {
+            errors.push(`Duplicate column names found: ${duplicates.join(', ')}`);
+        }
+        // Ensure at least one primary key exists
+        const hasPrimaryKey = schema.columns.some((c) => c.primaryKey);
+        if (!hasPrimaryKey) {
+            errors.push('At least one column must be marked as primary key');
+        }
+    }
+    // Validate indexes if present
+    if (schema.indexes) {
+        if (!Array.isArray(schema.indexes)) {
+            errors.push('Indexes must be an array');
+        }
+        else {
+            schema.indexes.forEach((index, i) => {
+                validateIndexDefinition(index, schema.columns || [], `Index ${i}`, errors);
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate table name
+ */
+function validateTableName(name, errors) {
+    // Check length
+    if (name.length === 0) {
+        errors.push('Table name cannot be empty');
+        return;
+    }
+    if (name.length > 64) {
+        errors.push('Table name cannot exceed 64 characters');
+    }
+    // Check format (alphanumeric and underscores, must start with letter or underscore)
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+        errors.push('Table name must start with a letter or underscore and contain only letters, numbers, and underscores');
+    }
+    // Check for reserved keywords (common SQL reserved words)
+    const reservedKeywords = [
+        'select',
+        'insert',
+        'update',
+        'delete',
+        'drop',
+        'create',
+        'alter',
+        'table',
+        'index',
+        'view',
+        'user',
+        'database',
+        'schema',
+        'order',
+        'group',
+        'where',
+        'from',
+        'join',
+        'union',
+    ];
+    if (reservedKeywords.includes(name.toLowerCase())) {
+        errors.push(`Table name "${name}" is a reserved SQL keyword`);
+    }
+}
+/**
+ * Validate column name
+ */
+function validateColumnName(name, prefix, errors) {
+    // Check length
+    if (name.length === 0) {
+        errors.push(`${prefix}: column name cannot be empty`);
+        return;
+    }
+    if (name.length > 64) {
+        errors.push(`${prefix}: column name cannot exceed 64 characters`);
+    }
+    // Check format
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+        errors.push(`${prefix}: column name must start with a letter or underscore and contain only letters, numbers, and underscores`);
+    }
+    // Check for reserved keywords
+    const reservedKeywords = [
+        'select',
+        'insert',
+        'update',
+        'delete',
+        'from',
+        'where',
+        'order',
+        'group',
+        'by',
+        'having',
+        'limit',
+        'offset',
+        'union',
+        'join',
+        'on',
+        'as',
+        'and',
+        'or',
+        'not',
+        'null',
+        'true',
+        'false',
+    ];
+    if (reservedKeywords.includes(name.toLowerCase())) {
+        errors.push(`${prefix}: column name "${name}" is a reserved SQL keyword`);
+    }
+}
+/**
+ * Validate column definition
+ */
+function validateColumnDefinition(column, prefix, errors) {
+    // Validate column name
+    if (!column.name || typeof column.name !== 'string') {
+        errors.push(`${prefix}: name is required and must be a string`);
+    }
+    else {
+        validateColumnName(column.name, prefix, errors);
+    }
+    // Validate column type
+    if (!column.type) {
+        errors.push(`${prefix}: type is required`);
+    }
+    else if (!Object.values(schema_types_1.ColumnType).includes(column.type)) {
+        errors.push(`${prefix}: invalid column type "${column.type}"`);
+    }
+    // Validate type-specific constraints
+    validateColumnTypeConstraints(column, prefix, errors);
+    // Validate nullable
+    if (column.nullable !== undefined && typeof column.nullable !== 'boolean') {
+        errors.push(`${prefix}: nullable must be a boolean`);
+    }
+    // Validate primaryKey
+    if (column.primaryKey !== undefined && typeof column.primaryKey !== 'boolean') {
+        errors.push(`${prefix}: primaryKey must be a boolean`);
+    }
+    // Validate unique
+    if (column.unique !== undefined && typeof column.unique !== 'boolean') {
+        errors.push(`${prefix}: unique must be a boolean`);
+    }
+    // Validate autoIncrement
+    if (column.autoIncrement !== undefined) {
+        if (typeof column.autoIncrement !== 'boolean') {
+            errors.push(`${prefix}: autoIncrement must be a boolean`);
+        }
+        // Auto-increment only valid for integer types
+        if (column.autoIncrement && column.type !== schema_types_1.ColumnType.INTEGER && column.type !== schema_types_1.ColumnType.BIGINT) {
+            errors.push(`${prefix}: autoIncrement is only valid for INTEGER and BIGINT types`);
+        }
+    }
+    // Primary key constraints
+    if (column.primaryKey) {
+        if (column.nullable) {
+            errors.push(`${prefix}: primary key columns cannot be nullable`);
+        }
+    }
+    // Validate comment
+    if (column.comment !== undefined && typeof column.comment !== 'string') {
+        errors.push(`${prefix}: comment must be a string`);
+    }
+}
+/**
+ * Validate column type-specific constraints
+ */
+function validateColumnTypeConstraints(column, prefix, errors) {
+    switch (column.type) {
+        case schema_types_1.ColumnType.STRING:
+        case schema_types_1.ColumnType.VARCHAR:
+            if (column.length !== undefined) {
+                if (typeof column.length !== 'number' || column.length < 1) {
+                    errors.push(`${prefix}: length must be a positive number for STRING/VARCHAR types`);
+                }
+                if (column.length > 65535) {
+                    errors.push(`${prefix}: length cannot exceed 65535 for STRING/VARCHAR types`);
+                }
+            }
+            break;
+        case schema_types_1.ColumnType.DECIMAL:
+            if (column.precision !== undefined) {
+                if (typeof column.precision !== 'number' || column.precision < 1 || column.precision > 65) {
+                    errors.push(`${prefix}: precision must be a number between 1 and 65 for DECIMAL type`);
+                }
+            }
+            if (column.scale !== undefined) {
+                if (typeof column.scale !== 'number' || column.scale < 0 || column.scale > 30) {
+                    errors.push(`${prefix}: scale must be a number between 0 and 30 for DECIMAL type`);
+                }
+                if (column.precision !== undefined && column.scale > column.precision) {
+                    errors.push(`${prefix}: scale cannot be greater than precision for DECIMAL type`);
+                }
+            }
+            break;
+        case schema_types_1.ColumnType.ENUM:
+            if (!column.enumValues || !Array.isArray(column.enumValues) || column.enumValues.length === 0) {
+                errors.push(`${prefix}: enumValues array is required for ENUM type`);
+            }
+            else {
+                // Validate enum values
+                column.enumValues.forEach((value, i) => {
+                    if (typeof value !== 'string') {
+                        errors.push(`${prefix}: enumValues[${i}] must be a string`);
+                    }
+                });
+                // Check for duplicates
+                const duplicates = column.enumValues.filter((value, index) => column.enumValues.indexOf(value) !== index);
+                if (duplicates.length > 0) {
+                    errors.push(`${prefix}: duplicate enum values found: ${duplicates.join(', ')}`);
+                }
+            }
+            break;
+    }
+}
+/**
+ * Validate index definition
+ */
+function validateIndexDefinition(index, columns, prefix, errors) {
+    // Validate index name
+    if (!index.name || typeof index.name !== 'string') {
+        errors.push(`${prefix}: name is required and must be a string`);
+    }
+    else {
+        validateIndexName(index.name, prefix, errors);
+    }
+    // Validate columns
+    if (!index.columns || !Array.isArray(index.columns)) {
+        errors.push(`${prefix}: columns array is required`);
+    }
+    else {
+        if (index.columns.length === 0) {
+            errors.push(`${prefix}: at least one column is required`);
+        }
+        // Validate each column exists in table
+        const columnNames = columns.map((c) => c.name);
+        index.columns.forEach((indexCol) => {
+            const colName = typeof indexCol === 'string' ? indexCol : indexCol.name;
+            if (!columnNames.includes(colName)) {
+                errors.push(`${prefix}: column "${colName}" does not exist in table`);
+            }
+        });
+    }
+    // Validate unique flag
+    if (index.unique !== undefined && typeof index.unique !== 'boolean') {
+        errors.push(`${prefix}: unique must be a boolean`);
+    }
+}
+/**
+ * Validate index name
+ */
+function validateIndexName(name, prefix, errors) {
+    if (name.length === 0) {
+        errors.push(`${prefix}: index name cannot be empty`);
+        return;
+    }
+    if (name.length > 64) {
+        errors.push(`${prefix}: index name cannot exceed 64 characters`);
+    }
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {
+        errors.push(`${prefix}: index name must start with a letter or underscore and contain only letters, numbers, and underscores`);
+    }
+}
+/**
+ * Throw an error if schema validation fails
+ */
+function assertValidTableSchema(schema) {
+    const result = validateTableSchema(schema);
+    if (!result.valid) {
+        throw new Error(`Invalid table schema:\n${result.errors.join('\n')}`);
+    }
+}
+/**
+ * Throw an error if column validation fails
+ */
+function assertValidColumn(column) {
+    const errors = [];
+    validateColumnDefinition(column, 'Column', errors);
+    if (errors.length > 0) {
+        throw new Error(`Invalid column definition:\n${errors.join('\n')}`);
+    }
+}
+/**
+ * Throw an error if index validation fails
+ */
+function assertValidIndex(index, columns) {
+    const errors = [];
+    validateIndexDefinition(index, columns, 'Index', errors);
+    if (errors.length > 0) {
+        throw new Error(`Invalid index definition:\n${errors.join('\n')}`);
+    }
+}
+//# sourceMappingURL=schema.validator.js.map