ts-prorm-orm 1.1.0

package/dist/sql-constants.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * SQL Constants for database behavior control
+ * Provides dialect-specific SQL statements for controlling database behavior
+ * like foreign key checks, transaction isolation levels, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsolationLevelEnum = exports.SQL = exports.CLICKHOUSE = exports.SNOWFLAKE = exports.DB2 = exports.REDSHIFT = exports.COCKROACHDB = exports.SQLITE = exports.POSTGRES = exports.MARIADB = exports.MYSQL = void 0;
+exports.getConstantsForDialect = getConstantsForDialect;
+/**
+ * MySQL/MariaDB SQL constants
+ */
+exports.MYSQL = {
+    FOREIGN_KEY_CHECKS: {
+        disable: 'SET FOREIGN_KEY_CHECKS = 0',
+        enable: 'SET FOREIGN_KEY_CHECKS = 1',
+    },
+    UNIQUE_KEY_CHECKS: {
+        disable: 'SET UNIQUE_CHECKS = 0',
+        enable: 'SET UNIQUE_CHECKS = 1',
+    },
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'SET SESSION TRANSACTION ISOLATION LEVEL READ UNCOMMITTED',
+        READ_COMMITTED: 'SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED',
+        REPEATABLE_READ: 'SET SESSION TRANSACTION ISOLATION LEVEL REPEATABLE READ',
+        SERIALIZABLE: 'SET SESSION TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+    },
+    AUTOCOMMIT: {
+        on: 'SET AUTOCOMMIT = 1',
+        off: 'SET AUTOCOMMIT = 0',
+    },
+    CACHE: {
+        on: 'SET SESSION query_cache_type = ON',
+        off: 'SET SESSION query_cache_type = OFF',
+    },
+    SQL_MODE: {
+        STRICT_TRANS_TABLES: "SET @@sql_mode = 'STRICT_TRANS_TABLES'",
+        NO_ZERO_DATE: "SET @@sql_mode = 'NO_ZERO_DATE'",
+        NO_ZERO_IN_DATE: "SET @@sql_mode = 'NO_ZERO_IN_DATE'",
+        ERROR_FOR_DIVISION_BY_ZERO: "SET @@sql_mode = 'ERROR_FOR_DIVISION_BY_ZERO'",
+        NO_AUTO_CREATE_USER: "SET @@sql_mode = 'NO_AUTO_CREATE_USER'",
+        NO_ENGINE_SUBSTITUTION: "SET @@sql_mode = 'NO_ENGINE_SUBSTITUTION'",
+        ALL: "SET @@sql_mode = 'ALL'",
+        TRADITIONAL: "SET @@sql_mode = 'TRADITIONAL'",
+    },
+};
+/**
+ * MariaDB SQL constants (extends MySQL with additional options)
+ */
+exports.MARIADB = {
+    ...exports.MYSQL,
+    SQL_MODE: {
+        ...exports.MYSQL.SQL_MODE,
+        STRICT_TRANS_TABLES: "SET @@sql_mode = 'STRICT_TRANS_TABLES'",
+        NO_ZERO_DATE: "SET @@sql_mode = 'NO_ZERO_DATE'",
+        NO_ZERO_IN_DATE: "SET @@sql_mode = 'NO_ZERO_IN_DATE'",
+        ERROR_FOR_DIVISION_BY_ZERO: "SET @@sql_mode = 'ERROR_FOR_DIVISION_BY_ZERO'",
+        NO_AUTO_CREATE_USER: "SET @@sql_mode = 'NO_AUTO_CREATE_USER'",
+        NO_ENGINE_SUBSTITUTION: "SET @@sql_mode = 'NO_ENGINE_SUBSTITUTION'",
+        ALL: "SET @@sql_mode = 'ALL'",
+        TRADITIONAL: "SET @@sql_mode = 'TRADITIONAL'",
+    },
+};
+/**
+ * PostgreSQL SQL constants
+ */
+exports.POSTGRES = {
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED',
+        READ_COMMITTED: 'SET TRANSACTION ISOLATION LEVEL READ COMMITTED',
+        REPEATABLE_READ: 'SET TRANSACTION ISOLATION LEVEL REPEATABLE READ',
+        SERIALIZABLE: 'SET TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+    },
+    CONSTRAINT_DEFERral: {
+        DEFERRED: 'SET CONSTRAINTS ALL DEFERRED',
+        IMMEDIATE: 'SET CONSTRAINTS ALL IMMEDIATE',
+    },
+    SEARCH_PATH: {
+        set: (schema) => `SET search_path TO ${schema}`,
+        reset: 'SET search_path TO DEFAULT',
+    },
+    AUTOCOMMIT: {
+        on: 'SET SESSION autocommit = ON',
+        off: 'SET SESSION autocommit = OFF',
+    },
+    CACHE: {
+        on: 'SET SESSION statement_cache_mode = ON',
+        off: 'SET SESSION statement_cache_mode = OFF',
+    },
+};
+/**
+ * SQLite SQL constants
+ */
+exports.SQLITE = {
+    PRAGMA: {
+        foreign_keys: {
+            on: 'PRAGMA foreign_keys = ON',
+            off: 'PRAGMA foreign_keys = OFF',
+        },
+        trusted_schema: {
+            on: 'PRAGMA trusted_schema = ON',
+            off: 'PRAGMA trusted_schema = OFF',
+        },
+        journal_mode: {
+            WAL: 'PRAGMA journal_mode = WAL',
+            DELETE: 'PRAGMA journal_mode = DELETE',
+            TRUNCATE: 'PRAGMA journal_mode = TRUNCATE',
+            PERSIST: 'PRAGMA journal_mode = PERSIST',
+            MEMORY: 'PRAGMA journal_mode = MEMORY',
+        },
+        synchronous: {
+            OFF: 'PRAGMA synchronous = OFF',
+            NORMAL: 'PRAGMA synchronous = NORMAL',
+            FULL: 'PRAGMA synchronous = FULL',
+            EXTRA: 'PRAGMA synchronous = EXTRA',
+        },
+    },
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'PRAGMA read_uncommitted = 1',
+        READ_COMMITTED: 'PRAGMA read_uncommitted = 0',
+        REPEATABLE_READ: 'PRAGMA read_uncommitted = 0',
+        SERIALIZABLE: 'PRAGMA read_uncommitted = 0',
+    },
+};
+/**
+ * CockroachDB SQL constants
+ * CockroachDB is wire-compatible with PostgreSQL and shares most session-level
+ * SQL syntax, though it internally maps all isolation levels to SERIALIZABLE.
+ */
+exports.COCKROACHDB = {
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'SET TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+        READ_COMMITTED: 'SET TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+        REPEATABLE_READ: 'SET TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+        SERIALIZABLE: 'SET TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+    },
+    CONSTRAINT_DEFERral: {
+        DEFERRED: 'SET CONSTRAINTS ALL DEFERRED',
+        IMMEDIATE: 'SET CONSTRAINTS ALL IMMEDIATE',
+    },
+    SEARCH_PATH: {
+        set: (schema) => `SET search_path TO ${schema}`,
+        reset: 'SET search_path TO DEFAULT',
+    },
+    AUTOCOMMIT: {
+        on: 'SET SESSION autocommit = ON',
+        off: 'SET SESSION autocommit = OFF',
+    },
+    CACHE: {
+        on: 'SET SESSION statement_cache_mode = ON',
+        off: 'SET SESSION statement_cache_mode = OFF',
+    },
+};
+/**
+ * Amazon Redshift SQL constants
+ * Redshift is derived from PostgreSQL 8.0.2 and only supports the
+ * SERIALIZABLE (default) and READ COMMITTED isolation levels.
+ */
+exports.REDSHIFT = {
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL READ COMMITTED',
+        READ_COMMITTED: 'SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL READ COMMITTED',
+        REPEATABLE_READ: 'SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+        SERIALIZABLE: 'SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL SERIALIZABLE',
+    },
+    CONSTRAINT_DEFERral: {
+        DEFERRED: 'SET CONSTRAINTS ALL DEFERRED',
+        IMMEDIATE: 'SET CONSTRAINTS ALL IMMEDIATE',
+    },
+    SEARCH_PATH: {
+        set: (schema) => `SET search_path TO ${schema}`,
+        reset: 'SET search_path TO DEFAULT',
+    },
+    AUTOCOMMIT: {
+        on: 'SET SESSION autocommit = ON',
+        off: 'SET SESSION autocommit = OFF',
+    },
+    CACHE: {
+        on: 'SET SESSION statement_cache_mode = ON',
+        off: 'SET SESSION statement_cache_mode = OFF',
+    },
+};
+/**
+ * IBM Db2 SQL constants
+ * Db2 isolation levels use single-letter codes: UR (uncommitted read),
+ * CS (cursor stability), RS (read stability), RR (repeatable read).
+ */
+exports.DB2 = {
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'SET CURRENT ISOLATION = UR',
+        READ_COMMITTED: 'SET CURRENT ISOLATION = CS',
+        REPEATABLE_READ: 'SET CURRENT ISOLATION = RS',
+        SERIALIZABLE: 'SET CURRENT ISOLATION = RR',
+    },
+    AUTOCOMMIT: {
+        on: 'SET AUTOCOMMIT ON',
+        off: 'SET AUTOCOMMIT OFF',
+    },
+    FOREIGN_KEY_CHECKS: {
+        disable: 'SET INTEGRITY FOR <table_name> OFF',
+        enable: 'SET INTEGRITY FOR <table_name> IMMEDIATE CHECKED',
+    },
+};
+/**
+ * Snowflake SQL constants
+ * Snowflake session parameters are configured via ALTER SESSION SET.
+ * Snowflake enforces READ COMMITTED semantics for all statements, so the
+ * other isolation levels map to the same session behavior.
+ */
+exports.SNOWFLAKE = {
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: 'ALTER SESSION SET TRANSACTION_DEFAULT_ISOLATION_LEVEL = READ_COMMITTED',
+        READ_COMMITTED: 'ALTER SESSION SET TRANSACTION_DEFAULT_ISOLATION_LEVEL = READ_COMMITTED',
+        REPEATABLE_READ: 'ALTER SESSION SET TRANSACTION_DEFAULT_ISOLATION_LEVEL = READ_COMMITTED',
+        SERIALIZABLE: 'ALTER SESSION SET TRANSACTION_DEFAULT_ISOLATION_LEVEL = READ_COMMITTED',
+    },
+    AUTOCOMMIT: {
+        on: 'ALTER SESSION SET AUTOCOMMIT = TRUE',
+        off: 'ALTER SESSION SET AUTOCOMMIT = FALSE',
+    },
+    CACHE: {
+        on: 'ALTER SESSION SET USE_CACHED_RESULT = TRUE',
+        off: 'ALTER SESSION SET USE_CACHED_RESULT = FALSE',
+    },
+};
+/**
+ * ClickHouse SQL constants
+ * ClickHouse transactions are experimental and scoped via session settings;
+ * isolation level is effectively fixed and controlled through the
+ * `transaction_isolation` setting where supported.
+ */
+exports.CLICKHOUSE = {
+    ISOLATION_LEVEL: {
+        READ_UNCOMMITTED: "SET session_transaction_isolation = 'READ UNCOMMITTED'",
+        READ_COMMITTED: "SET session_transaction_isolation = 'READ COMMITTED'",
+        REPEATABLE_READ: "SET session_transaction_isolation = 'REPEATABLE READ'",
+        SERIALIZABLE: "SET session_transaction_isolation = 'SERIALIZABLE'",
+    },
+    AUTOCOMMIT: {
+        on: 'SET implicit_transaction = 1',
+        off: 'SET implicit_transaction = 0',
+    },
+    CACHE: {
+        on: 'SET use_query_cache = 1',
+        off: 'SET use_query_cache = 0',
+    },
+};
+/**
+ * All SQL constants
+ */
+exports.SQL = {
+    mysql: exports.MYSQL,
+    mariadb: exports.MARIADB,
+    postgres: exports.POSTGRES,
+    sqlite: exports.SQLITE,
+    cockroachdb: exports.COCKROACHDB,
+    redshift: exports.REDSHIFT,
+    db2: exports.DB2,
+    snowflake: exports.SNOWFLAKE,
+    clickhouse: exports.CLICKHOUSE,
+};
+/**
+ * Get SQL constants for a specific dialect
+ * @param dialect - The dialect name ('mysql', 'mariadb', 'postgres', 'sqlite',
+ * 'cockroachdb', 'redshift', 'db2', 'snowflake', 'clickhouse')
+ */
+function getConstantsForDialect(dialect) {
+    switch (dialect) {
+        case 'mysql':
+            return exports.MYSQL;
+        case 'mariadb':
+            return exports.MARIADB;
+        case 'postgres':
+            return exports.POSTGRES;
+        case 'sqlite':
+            return exports.SQLITE;
+        case 'cockroachdb':
+            return exports.COCKROACHDB;
+        case 'redshift':
+            return exports.REDSHIFT;
+        case 'db2':
+            return exports.DB2;
+        case 'snowflake':
+            return exports.SNOWFLAKE;
+        case 'clickhouse':
+            return exports.CLICKHOUSE;
+        default:
+            return exports.MYSQL;
+    }
+}
+/**
+ * Transaction isolation level enum
+ */
+var IsolationLevelEnum;
+(function (IsolationLevelEnum) {
+    IsolationLevelEnum["READ_UNCOMMITTED"] = "READ_UNCOMMITTED";
+    IsolationLevelEnum["READ_COMMITTED"] = "READ_COMMITTED";
+    IsolationLevelEnum["REPEATABLE_READ"] = "REPEATABLE_READ";
+    IsolationLevelEnum["SERIALIZABLE"] = "SERIALIZABLE";
+})(IsolationLevelEnum || (exports.IsolationLevelEnum = IsolationLevelEnum = {}));