@relq/orm 0.1.3 → 0.1.5

package/dist/cjs/mysql/clients/shared/mysql-error-parser.cjs

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MYSQL_TRANSIENT_ERRNOS = exports.MYSQL_NETWORK_ERROR_CODES = exports.MYSQL_CONNECTION_ERROR_ERRNOS = exports.MYSQL_RECOVERABLE_ERRNOS = void 0;
+exports.isMysqlConnectionError = isMysqlConnectionError;
+exports.isMysqlTransientError = isMysqlTransientError;
+exports.isMysqlPoolRecoverableError = isMysqlPoolRecoverableError;
+exports.parseMysqlError = parseMysqlError;
+const relq_errors_1 = require("../../../shared/errors/relq-errors.cjs");
+exports.MYSQL_RECOVERABLE_ERRNOS = new Set([
+    2002,
+    2003,
+    2006,
+    2013,
+    2026,
+]);
+exports.MYSQL_CONNECTION_ERROR_ERRNOS = new Set([
+    2002,
+    2003,
+    2006,
+    2013,
+    2026,
+]);
+exports.MYSQL_NETWORK_ERROR_CODES = new Set([
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'ESERVFAIL',
+    'ETIMEDOUT',
+    'EPIPE',
+    'EAI_AGAIN',
+    'EHOSTUNREACH',
+    'ECONNABORTED',
+    'ENETUNREACH',
+    'ENETRESET',
+    'PROTOCOL_CONNECTION_LOST',
+]);
+exports.MYSQL_TRANSIENT_ERRNOS = new Set([
+    1205,
+    1213,
+]);
+function isMysqlConnectionError(error) {
+    if (typeof error.errno === 'number' && exports.MYSQL_CONNECTION_ERROR_ERRNOS.has(error.errno)) {
+        return true;
+    }
+    if (typeof error.code === 'string' && exports.MYSQL_NETWORK_ERROR_CODES.has(error.code)) {
+        return true;
+    }
+    if (typeof error.message === 'string') {
+        if (error.message.includes('Connection lost'))
+            return true;
+        if (error.message.includes('connect ECONNREFUSED'))
+            return true;
+        if (error.message.includes('Connection closed'))
+            return true;
+        if (error.message.includes('Cannot enqueue'))
+            return true;
+    }
+    return false;
+}
+function isMysqlTransientError(error) {
+    if (typeof error.errno === 'number' && exports.MYSQL_TRANSIENT_ERRNOS.has(error.errno)) {
+        return true;
+    }
+    return false;
+}
+function isMysqlPoolRecoverableError(error) {
+    if (typeof error.errno === 'number' && exports.MYSQL_RECOVERABLE_ERRNOS.has(error.errno)) {
+        return true;
+    }
+    if (typeof error.code === 'string' && exports.MYSQL_NETWORK_ERROR_CODES.has(error.code)) {
+        return true;
+    }
+    if (!error.errno && !error.code)
+        return true;
+    return false;
+}
+function parseMysqlError(error, sql, isBuilder = true) {
+    const message = error.sqlMessage || error.message || 'MySQL error';
+    const errno = error.errno;
+    const code = error.code;
+    if (isMysqlConnectionError(error)) {
+        return new relq_errors_1.RelqConnectionError(message, {
+            cause: error,
+            code: code || String(errno),
+            host: error.address,
+            port: error.port,
+        });
+    }
+    if (errno === 1040) {
+        return new relq_errors_1.RelqConnectionError('Too many database connections. The server has reached its connection limit.', { cause: error, code: code || '1040' });
+    }
+    if (errno === 1045) {
+        return new relq_errors_1.RelqConnectionError('Authentication failed. Check your database username and password.', { cause: error, code: code || '1045' });
+    }
+    if (errno === 1205) {
+        return new relq_errors_1.RelqLockError('Lock wait timeout exceeded. Another transaction holds the lock. Retry the operation.', 'lock_timeout', { cause: error, sql: sql || error.sql, code: code || '1205' });
+    }
+    if (message.includes('connect ETIMEDOUT') || message.includes('Connection timeout')) {
+        return new relq_errors_1.RelqTimeoutError('Connection timed out.', error.timeout || 0, 'connection', error);
+    }
+    if (!isBuilder) {
+        return new relq_errors_1.RelqQueryError(message, {
+            cause: error, sql: sql || error.sql, code: code || String(errno),
+            detail: error.sqlState ? `SQLSTATE ${error.sqlState}` : undefined,
+        });
+    }
+    if (errno === 1062 || errno === 1022 || errno === 1169) {
+        const dupMatch = message.match(/Duplicate entry '(.+?)' for key '(?:.*\.)?(.+?)'/);
+        const val = dupMatch?.[1];
+        const constraint = dupMatch?.[2];
+        return new relq_errors_1.RelqConstraintError(`Duplicate value: A record with this value already exists.${val ? ` Value: "${val}".` : ''}${constraint ? ` Constraint: "${constraint}".` : ''}`, 'unique', { cause: error, constraint, value: val, sql: sql || error.sql, code: code || String(errno), detail: message });
+    }
+    if (errno === 1451 || errno === 1217) {
+        const refMatch = message.match(/CONSTRAINT `(.+?)`.*REFERENCES `(.+?)`/);
+        return new relq_errors_1.RelqConstraintError(`Cannot delete: This record is still referenced by another table.${refMatch ? ` Constraint: "${refMatch[1]}", referenced table: "${refMatch[2]}".` : ''}`, 'foreign_key', { cause: error, constraint: refMatch?.[1], sql: sql || error.sql, code: code || String(errno), detail: message });
+    }
+    if (errno === 1452 || errno === 1216) {
+        const refMatch = message.match(/CONSTRAINT `(.+?)`.*REFERENCES `(.+?)`/);
+        return new relq_errors_1.RelqConstraintError(`Referenced record not found: The value references a record that doesn't exist.${refMatch ? ` Constraint: "${refMatch[1]}", referenced table: "${refMatch[2]}".` : ''}`, 'foreign_key', { cause: error, constraint: refMatch?.[1], sql: sql || error.sql, code: code || String(errno), detail: message });
+    }
+    if (errno === 1048) {
+        const colMatch = message.match(/Column '(.+?)'/);
+        return new relq_errors_1.RelqConstraintError(`Required field missing: Column "${colMatch?.[1] || 'unknown'}" cannot be NULL. Provide a value or set a default in your schema.`, 'not_null', { cause: error, column: colMatch?.[1], sql: sql || error.sql, code: code || '1048', detail: message });
+    }
+    if (errno === 1213) {
+        return new relq_errors_1.RelqLockError('Deadlock detected: Two transactions are waiting for each other. Retry the transaction.', 'deadlock', { cause: error, sql: sql || error.sql, code: code || '1213' });
+    }
+    if (errno === 1146) {
+        const tblMatch = message.match(/Table '(?:.*\.)?(.+?)'/);
+        return new relq_errors_1.RelqSchemaError(`Table "${tblMatch?.[1] || 'unknown'}" does not exist. Check your schema definition or run migrations.`, 'table', { cause: error, objectName: tblMatch?.[1], sql: sql || error.sql, code: code || '1146' });
+    }
+    if (errno === 1054) {
+        const colMatch = message.match(/Unknown column '(.+?)'/);
+        return new relq_errors_1.RelqSchemaError(`Column "${colMatch?.[1] || 'unknown'}" does not exist. Check column name spelling in your schema and query.`, 'column', { cause: error, objectName: colMatch?.[1], sql: sql || error.sql, code: code || '1054' });
+    }
+    if (errno === 1064 || errno === 1149) {
+        return new relq_errors_1.RelqSchemaError(`SQL syntax error: ${message}. This may indicate a bug in the query builder — please report it.`, 'column', { cause: error, sql: sql || error.sql, code: code || '1064', hint: 'If you are using db.raw(), check your SQL syntax.' });
+    }
+    if (errno === 1050) {
+        const tblMatch = message.match(/Table '(.+?)'/);
+        return new relq_errors_1.RelqSchemaError(`Table "${tblMatch?.[1] || 'unknown'}" already exists.`, 'table', { cause: error, objectName: tblMatch?.[1], sql: sql || error.sql, code: code || '1050' });
+    }
+    if (errno === 1049) {
+        return new relq_errors_1.RelqSchemaError(`Database does not exist. Check your database name in the connection config.`, 'schema', { cause: error, sql: sql || error.sql, code: code || '1049' });
+    }
+    if (errno === 1406) {
+        const colMatch = message.match(/column '(.+?)'/);
+        return new relq_errors_1.RelqDataError(`Value too long for column "${colMatch?.[1] || 'unknown'}". Shorten the value or increase the column length.`, 'too_long', { cause: error, column: colMatch?.[1], sql: sql || error.sql, code: code || '1406' });
+    }
+    if (errno === 1264) {
+        const colMatch = message.match(/column '(.+?)'/);
+        return new relq_errors_1.RelqDataError(`Numeric value out of range for column "${colMatch?.[1] || 'unknown'}".`, 'out_of_range', { cause: error, column: colMatch?.[1], sql: sql || error.sql, code: code || '1264' });
+    }
+    if (errno === 1292 || errno === 1366) {
+        return new relq_errors_1.RelqDataError(`Invalid value: ${message}. Check that the value matches the column type.`, 'invalid_type', { cause: error, sql: sql || error.sql, code: code || String(errno) });
+    }
+    if (errno === 1265) {
+        const colMatch = message.match(/column '(.+?)'/);
+        return new relq_errors_1.RelqDataError(`Data truncated for column "${colMatch?.[1] || 'unknown'}". The value doesn't fit the column type.`, 'too_long', { cause: error, column: colMatch?.[1], sql: sql || error.sql, code: code || '1265' });
+    }
+    if (errno === 1365) {
+        return new relq_errors_1.RelqDataError('Division by zero in query.', 'division_by_zero', { cause: error, sql: sql || error.sql, code: code || '1365' });
+    }
+    if (errno === 1364) {
+        const colMatch = message.match(/Field '(.+?)'/);
+        return new relq_errors_1.RelqConstraintError(`Required field missing: Column "${colMatch?.[1] || 'unknown'}" has no default value. Provide a value or set a default in your schema.`, 'not_null', { cause: error, column: colMatch?.[1], sql: sql || error.sql, code: code || '1364', detail: message });
+    }
+    if (errno === 1044 || errno === 1142 || errno === 1143 || errno === 1227) {
+        return new relq_errors_1.RelqSchemaError(`Permission denied: ${message}. Check that your database user has the required privileges.`, 'table', { cause: error, sql: sql || error.sql, code: code || String(errno) });
+    }
+    if (errno === 1052) {
+        const colMatch = message.match(/Column '(.+?)'/);
+        return new relq_errors_1.RelqSchemaError(`Ambiguous column "${colMatch?.[1] || 'unknown'}": The column exists in multiple tables. Qualify it with a table name or alias.`, 'column', { cause: error, objectName: colMatch?.[1], sql: sql || error.sql, code: code || '1052' });
+    }
+    if (errno === 1058 || errno === 1136) {
+        return new relq_errors_1.RelqDataError(`Column count mismatch: The number of columns doesn't match the number of values. ${message}`, 'invalid_type', { cause: error, sql: sql || error.sql, code: code || String(errno) });
+    }
+    if (errno === 1109) {
+        const tblMatch = message.match(/Unknown table '(.+?)'/);
+        return new relq_errors_1.RelqSchemaError(`Table "${tblMatch?.[1] || 'unknown'}" not found. Check table name spelling.`, 'table', { cause: error, objectName: tblMatch?.[1], sql: sql || error.sql, code: code || '1109' });
+    }
+    if (errno === 1046) {
+        return new relq_errors_1.RelqSchemaError('No database selected. Set the database name in your connection config.', 'schema', { cause: error, sql: sql || error.sql, code: code || '1046' });
+    }
+    if (errno === 1153) {
+        return new relq_errors_1.RelqQueryError('Packet too large: The query or data exceeds max_allowed_packet. Reduce batch size or increase the limit.', { cause: error, sql: sql || error.sql, code: code || '1153' });
+    }
+    if (errno === 1179) {
+        return new relq_errors_1.RelqQueryError('This command cannot be executed inside a transaction.', { cause: error, sql: sql || error.sql, code: code || '1179' });
+    }
+    return new relq_errors_1.RelqQueryError(message, {
+        cause: error, sql: sql || error.sql, code: code || String(errno),
+        detail: error.sqlState ? `SQLSTATE ${error.sqlState}` : undefined,
+    });
+}

package/dist/cjs/mysql/clients/shared/mysql-format.cjs

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mysqlIdent = ident;
+exports.mysqlLiteral = literal;
+const MYSQL_RESERVED = new Set([
+    'ADD', 'ALL', 'ALTER', 'ANALYZE', 'AND', 'AS', 'ASC', 'BEFORE', 'BETWEEN',
+    'BIGINT', 'BINARY', 'BLOB', 'BOTH', 'BY', 'CALL', 'CASCADE', 'CASE', 'CHANGE',
+    'CHAR', 'CHARACTER', 'CHECK', 'COLLATE', 'COLUMN', 'CONDITION', 'CONSTRAINT',
+    'CONTINUE', 'CONVERT', 'CREATE', 'CROSS', 'CURRENT_DATE', 'CURRENT_TIME',
+    'CURRENT_TIMESTAMP', 'CURRENT_USER', 'CURSOR', 'DATABASE', 'DATABASES', 'DAY_HOUR',
+    'DAY_MICROSECOND', 'DAY_MINUTE', 'DAY_SECOND', 'DEC', 'DECIMAL', 'DECLARE',
+    'DEFAULT', 'DELAYED', 'DELETE', 'DESC', 'DESCRIBE', 'DETERMINISTIC', 'DISTINCT',
+    'DISTINCTROW', 'DIV', 'DOUBLE', 'DROP', 'DUAL', 'EACH', 'ELSE', 'ELSEIF',
+    'ENCLOSED', 'ESCAPED', 'EXISTS', 'EXIT', 'EXPLAIN', 'FALSE', 'FETCH', 'FLOAT',
+    'FLOAT4', 'FLOAT8', 'FOR', 'FORCE', 'FOREIGN', 'FROM', 'FULLTEXT', 'GRANT',
+    'GROUP', 'HAVING', 'HIGH_PRIORITY', 'HOUR_MICROSECOND', 'HOUR_MINUTE', 'HOUR_SECOND',
+    'IF', 'IGNORE', 'IN', 'INDEX', 'INFILE', 'INNER', 'INOUT', 'INSENSITIVE', 'INSERT',
+    'INT', 'INT1', 'INT2', 'INT3', 'INT4', 'INT8', 'INTEGER', 'INTERVAL', 'INTO',
+    'IS', 'ITERATE', 'JOIN', 'KEY', 'KEYS', 'KILL', 'LEADING', 'LEAVE', 'LEFT',
+    'LIKE', 'LIMIT', 'LINEAR', 'LINES', 'LOAD', 'LOCALTIME', 'LOCALTIMESTAMP', 'LOCK',
+    'LONG', 'LONGBLOB', 'LONGTEXT', 'LOOP', 'LOW_PRIORITY', 'MATCH', 'MEDIUMBLOB',
+    'MEDIUMINT', 'MEDIUMTEXT', 'MIDDLEINT', 'MINUTE_MICROSECOND', 'MINUTE_SECOND', 'MOD',
+    'MODIFIES', 'NATURAL', 'NOT', 'NO_WRITE_TO_BINLOG', 'NULL', 'NUMERIC', 'ON',
+    'OPTIMIZE', 'OPTION', 'OPTIONALLY', 'OR', 'ORDER', 'OUT', 'OUTER', 'OUTFILE',
+    'PRECISION', 'PRIMARY', 'PROCEDURE', 'PURGE', 'RANGE', 'READ', 'READS', 'REAL',
+    'REFERENCES', 'REGEXP', 'RELEASE', 'RENAME', 'REPEAT', 'REPLACE', 'REQUIRE',
+    'RESTRICT', 'RETURN', 'REVOKE', 'RIGHT', 'RLIKE', 'SCHEMA', 'SCHEMAS',
+    'SECOND_MICROSECOND', 'SELECT', 'SENSITIVE', 'SEPARATOR', 'SET', 'SHOW', 'SMALLINT',
+    'SPATIAL', 'SPECIFIC', 'SQL', 'SQLEXCEPTION', 'SQLSTATE', 'SQLWARNING',
+    'SQL_BIG_RESULT', 'SQL_CALC_FOUND_ROWS', 'SQL_SMALL_RESULT', 'SSL', 'STARTING',
+    'STRAIGHT_JOIN', 'TABLE', 'TERMINATED', 'THEN', 'TINYBLOB', 'TINYINT', 'TINYTEXT',
+    'TO', 'TRAILING', 'TRIGGER', 'TRUE', 'UNDO', 'UNION', 'UNIQUE', 'UNLOCK',
+    'UNSIGNED', 'UPDATE', 'USAGE', 'USE', 'USING', 'UTC_DATE', 'UTC_TIME',
+    'UTC_TIMESTAMP', 'VALUES', 'VARBINARY', 'VARCHAR', 'VARYING', 'WHEN', 'WHERE',
+    'WHILE', 'WITH', 'WRITE', 'XOR', 'YEAR_MONTH', 'ZEROFILL',
+    'CUME_DIST', 'DENSE_RANK', 'EMPTY', 'EXCEPT', 'FIRST_VALUE', 'GROUPING', 'GROUPS',
+    'JSON_TABLE', 'LAG', 'LAST_VALUE', 'LATERAL', 'LEAD', 'NTH_VALUE', 'NTILE',
+    'OF', 'OVER', 'PERCENT_RANK', 'RANK', 'RECURSIVE', 'ROW', 'ROWS',
+    'ROW_NUMBER', 'SYSTEM', 'WINDOW',
+]);
+function ident(value) {
+    if (Array.isArray(value)) {
+        return value.map(v => quoteIdentifier(v)).join(', ');
+    }
+    return quoteIdentifier(value);
+}
+function quoteIdentifier(value) {
+    if (value === '*')
+        return '*';
+    if (value.includes('.')) {
+        return value.split('.').map(p => p === '*' ? '*' : `\`${escapeBackticks(p)}\``).join('.');
+    }
+    return `\`${escapeBackticks(value)}\``;
+}
+function escapeBackticks(value) {
+    return value.replace(/`/g, '``');
+}
+function literal(value) {
+    if (value === null || value === undefined)
+        return 'NULL';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'number')
+        return String(value);
+    if (value instanceof Date)
+        return `'${value.toISOString()}'`;
+    if (Array.isArray(value)) {
+        return `(${value.map(v => literal(v)).join(', ')})`;
+    }
+    const str = String(value);
+    return `'${str.replace(/'/g, "''").replace(/\\/g, '\\\\')}'`;
+}
+function mysqlFormat(fmt, ...args) {
+    let argIdx = 0;
+    return fmt.replace(/%([ILs%])/g, (match, type) => {
+        if (type === '%')
+            return '%';
+        if (argIdx >= args.length) {
+            throw new Error(`mysqlFormat: missing argument for ${match}`);
+        }
+        const val = args[argIdx++];
+        switch (type) {
+            case 'I': return ident(val);
+            case 'L': return literal(val);
+            case 's': return String(val);
+            default: return match;
+        }
+    });
+}
+mysqlFormat.isReserved = (word) => {
+    return MYSQL_RESERVED.has(word.toUpperCase());
+};
+mysqlFormat.ident = ident;
+mysqlFormat.literal = literal;
+exports.default = mysqlFormat;

package/dist/cjs/mysql/clients/shared/mysql-type-coercion.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mysqlExtractSchemaColumns = exports.mysqlSerializeRow = exports.mysqlDeserializeRows = exports.mysqlDeserializeRow = exports.mysqlSerializeValue = exports.mysqlDeserializeValue = exports.mysqlTypeCoercion = void 0;
+const type_coercion_1 = require("../../utils/type-coercion.cjs");
+Object.defineProperty(exports, "mysqlDeserializeValue", { enumerable: true, get: function () { return type_coercion_1.deserializeMysqlValue; } });
+Object.defineProperty(exports, "mysqlSerializeValue", { enumerable: true, get: function () { return type_coercion_1.serializeMysqlValue; } });
+Object.defineProperty(exports, "mysqlDeserializeRow", { enumerable: true, get: function () { return type_coercion_1.deserializeMysqlRow; } });
+Object.defineProperty(exports, "mysqlDeserializeRows", { enumerable: true, get: function () { return type_coercion_1.deserializeMysqlRows; } });
+Object.defineProperty(exports, "mysqlSerializeRow", { enumerable: true, get: function () { return type_coercion_1.serializeMysqlRow; } });
+Object.defineProperty(exports, "mysqlExtractSchemaColumns", { enumerable: true, get: function () { return type_coercion_1.extractMysqlSchemaColumns; } });
+exports.mysqlTypeCoercion = {
+    deserializeValue: type_coercion_1.deserializeMysqlValue,
+    serializeValue: type_coercion_1.serializeMysqlValue,
+};