@event-driven-io/dumbo 0.13.0-beta.42 → 0.13.0-beta.44

package/dist/pg.js

@@ -1,8 +1,2032 @@
-import { On as mapSQLQueryResult, an as createAmbientConnectionPool, d as tracer, dt as JSONSerializer, kn as sqlExecutor, nn as canHandleDriverWithConnectionString, pn as createConnection, rn as dumboDatabaseDriverRegistry, sn as createConnectionPool, xn as BatchCommandNoChangesError } from "./core-IV7or0Mj.js";
-import { a as tableExists, c as defaultPostgreSQLConnectionString, i as functionExistsSQL, l as parseDatabaseName, n as defaultPostgreSqlDatabase, o as tableExistsSQL, r as functionExists, s as PostgreSQLConnectionString, t as postgreSQLMetadata } from "./postgreSQLMetadata-bCBDGz1f.js";
-import { a as PostgreSQLArrayProcessor, c as AdvisoryLock, d as releaseAdvisoryLock, f as tryAcquireAdvisoryLock, i as postgreSQLColumnProcessors, l as acquireAdvisoryLock, n as PostgreSQLJSON, o as PostgreSQLExpandSQLInProcessor, p as mapPostgresError, r as pgFormatter, s as DefaultPostgreSQLMigratorOptions, t as PostgreSQLDatabaseName, u as advisoryLock } from "./core-C3xoqqDs.js";
+import "uuid";
+import ansis from "ansis";
 import pg from "pg";
 
+//#region src/storage/postgresql/core/connections/connectionString.ts
+const defaultPostgreSQLConnectionString = "postgresql://postgres@localhost:5432/postgres";
+const PostgreSQLConnectionString = (connectionString) => {
+	if (!connectionString.startsWith("postgresql://") && !connectionString.startsWith("postgres://")) throw new Error(`Invalid PostgreSQL connection string: ${connectionString}. It should start with "postgresql://".`);
+	return connectionString;
+};
+/**
+* Parse database name from a PostgreSQL connection string
+*/
+function parseDatabaseName(str) {
+	if (str.charAt(0) === "/") return str.split(" ")[1] || null;
+	if (/ |%[^a-f0-9]|%[a-f0-9][^a-f0-9]/i.test(str)) str = encodeURI(str).replace(/%25(\d\d)/g, "%$1");
+	let result;
+	try {
+		result = new URL(str, "postgres://base");
+	} catch {
+		try {
+			result = new URL(str.replace("@/", "@___DUMMY___/"), "postgres://base");
+		} catch {
+			return null;
+		}
+	}
+	if (result.protocol === "socket:") return result.searchParams.get("db");
+	const pathname = result.pathname.slice(1) || null;
+	return pathname ? decodeURI(pathname) : null;
+}
+
+//#endregion
+//#region src/core/errors/index.ts
+const isNumber = (val) => typeof val === "number" && val === val;
+const isString = (val) => typeof val === "string";
+var DumboError = class DumboError extends Error {
+	static ErrorCode = 500;
+	static ErrorType = "DumboError";
+	errorCode;
+	errorType;
+	innerError;
+	constructor(options) {
+		const errorCode = options && typeof options === "object" && "errorCode" in options ? options.errorCode : isNumber(options) ? options : DumboError.ErrorCode;
+		const errorType = options && typeof options === "object" && "errorType" in options ? options.errorType ?? DumboError.ErrorType : DumboError.ErrorType;
+		const message = options && typeof options === "object" && "message" in options ? options.message : isString(options) ? options : `Error with status code '${errorCode}' ocurred during DumboError processing`;
+		const innerError = options && typeof options === "object" && "innerError" in options ? options.innerError : void 0;
+		super(message, { cause: innerError });
+		this.errorCode = errorCode;
+		this.errorType = errorType;
+		this.innerError = innerError;
+		Object.setPrototypeOf(this, DumboError.prototype);
+	}
+	static isInstanceOf(error, options) {
+		if (typeof error !== "object" || error === null || !("errorCode" in error) || !isNumber(error.errorCode) || !("errorType" in error) || !isString(error.errorType)) return false;
+		if (!options) return true;
+		if (options.errorCode !== void 0 && error.errorCode !== options.errorCode) return false;
+		if (options.errorType !== void 0 && error.errorType !== options.errorType) return false;
+		return true;
+	}
+};
+var TransientDatabaseError = class TransientDatabaseError extends DumboError {
+	static ErrorCode = 503;
+	static ErrorType = "TransientDatabaseError";
+	constructor(message, innerError) {
+		super({
+			errorCode: TransientDatabaseError.ErrorCode,
+			errorType: TransientDatabaseError.ErrorType,
+			message: message ?? `A transient error occurred during database operation. Retrying the operation might succeed.`,
+			innerError
+		});
+		Object.setPrototypeOf(this, TransientDatabaseError.prototype);
+	}
+};
+var ConnectionError = class ConnectionError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "ConnectionError";
+	constructor(message, innerError) {
+		super(message ?? `A connection error occurred during database operation.`, innerError);
+		this.errorType = ConnectionError.ErrorType;
+		Object.setPrototypeOf(this, ConnectionError.prototype);
+	}
+};
+var SerializationError = class SerializationError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "SerializationError";
+	constructor(message, innerError) {
+		super(message ?? `A serialization failure occurred. The transaction can be retried.`, innerError);
+		this.errorType = SerializationError.ErrorType;
+		Object.setPrototypeOf(this, SerializationError.prototype);
+	}
+};
+var DeadlockError = class DeadlockError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "DeadlockError";
+	constructor(message, innerError) {
+		super(message ?? `A deadlock was detected. The transaction can be retried.`, innerError);
+		this.errorType = DeadlockError.ErrorType;
+		Object.setPrototypeOf(this, DeadlockError.prototype);
+	}
+};
+var LockNotAvailableError = class LockNotAvailableError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "LockNotAvailableError";
+	constructor(message, innerError) {
+		super(message ?? `The requested lock is not available.`, innerError);
+		this.errorType = LockNotAvailableError.ErrorType;
+		Object.setPrototypeOf(this, LockNotAvailableError.prototype);
+	}
+};
+var InsufficientResourcesError = class InsufficientResourcesError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "InsufficientResourcesError";
+	constructor(message, innerError) {
+		super(message ?? `Insufficient resources to complete the database operation (e.g. disk full, out of memory, too many connections).`, innerError);
+		this.errorType = InsufficientResourcesError.ErrorType;
+		Object.setPrototypeOf(this, InsufficientResourcesError.prototype);
+	}
+};
+var SystemError = class SystemError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "SystemError";
+	constructor(message, innerError) {
+		super(message ?? `A system-level error occurred (e.g. I/O error).`, innerError);
+		this.errorType = SystemError.ErrorType;
+		Object.setPrototypeOf(this, SystemError.prototype);
+	}
+};
+var AdminShutdownError = class AdminShutdownError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "AdminShutdownError";
+	constructor(message, innerError) {
+		super(message ?? `The database server is shutting down or restarting.`, innerError);
+		this.errorType = AdminShutdownError.ErrorType;
+		Object.setPrototypeOf(this, AdminShutdownError.prototype);
+	}
+};
+var QueryCanceledError = class QueryCanceledError extends TransientDatabaseError {
+	static ErrorCode = 503;
+	static ErrorType = "QueryCanceledError";
+	constructor(message, innerError) {
+		super(message ?? `The query was canceled, e.g. due to statement timeout or user request.`, innerError);
+		this.errorType = QueryCanceledError.ErrorType;
+		Object.setPrototypeOf(this, QueryCanceledError.prototype);
+	}
+};
+var IntegrityConstraintViolationError = class IntegrityConstraintViolationError extends DumboError {
+	static ErrorCode = 409;
+	static ErrorType = "IntegrityConstraintViolationError";
+	constructor(message, innerError) {
+		super({
+			errorCode: IntegrityConstraintViolationError.ErrorCode,
+			errorType: IntegrityConstraintViolationError.ErrorType,
+			message: message ?? `An integrity constraint violation occurred!`,
+			innerError
+		});
+		Object.setPrototypeOf(this, IntegrityConstraintViolationError.prototype);
+	}
+};
+var UniqueConstraintError = class UniqueConstraintError extends IntegrityConstraintViolationError {
+	static ErrorCode = 409;
+	static ErrorType = "UniqueConstraintError";
+	constructor(message, innerError) {
+		super(message ?? `Unique constraint violation occurred!`, innerError);
+		this.errorType = UniqueConstraintError.ErrorType;
+		Object.setPrototypeOf(this, UniqueConstraintError.prototype);
+	}
+};
+var ForeignKeyViolationError = class ForeignKeyViolationError extends IntegrityConstraintViolationError {
+	static ErrorCode = 409;
+	static ErrorType = "ForeignKeyViolationError";
+	constructor(message, innerError) {
+		super(message ?? `Foreign key constraint violation occurred!`, innerError);
+		this.errorType = ForeignKeyViolationError.ErrorType;
+		Object.setPrototypeOf(this, ForeignKeyViolationError.prototype);
+	}
+};
+var NotNullViolationError = class NotNullViolationError extends IntegrityConstraintViolationError {
+	static ErrorCode = 409;
+	static ErrorType = "NotNullViolationError";
+	constructor(message, innerError) {
+		super(message ?? `NOT NULL constraint violation occurred!`, innerError);
+		this.errorType = NotNullViolationError.ErrorType;
+		Object.setPrototypeOf(this, NotNullViolationError.prototype);
+	}
+};
+var CheckViolationError = class CheckViolationError extends IntegrityConstraintViolationError {
+	static ErrorCode = 409;
+	static ErrorType = "CheckViolationError";
+	constructor(message, innerError) {
+		super(message ?? `CHECK constraint violation occurred!`, innerError);
+		this.errorType = CheckViolationError.ErrorType;
+		Object.setPrototypeOf(this, CheckViolationError.prototype);
+	}
+};
+var ExclusionViolationError = class ExclusionViolationError extends IntegrityConstraintViolationError {
+	static ErrorCode = 409;
+	static ErrorType = "ExclusionViolationError";
+	constructor(message, innerError) {
+		super(message ?? `Exclusion constraint violation occurred!`, innerError);
+		this.errorType = ExclusionViolationError.ErrorType;
+		Object.setPrototypeOf(this, ExclusionViolationError.prototype);
+	}
+};
+var DataError = class DataError extends DumboError {
+	static ErrorCode = 400;
+	static ErrorType = "DataError";
+	constructor(message, innerError) {
+		super({
+			errorCode: DataError.ErrorCode,
+			errorType: DataError.ErrorType,
+			message: message ?? `A data error occurred (e.g. invalid value, type mismatch).`,
+			innerError
+		});
+		Object.setPrototypeOf(this, DataError.prototype);
+	}
+};
+var InvalidOperationError = class InvalidOperationError extends DumboError {
+	static ErrorCode = 400;
+	static ErrorType = "InvalidOperationError";
+	constructor(message, innerError) {
+		super({
+			errorCode: InvalidOperationError.ErrorCode,
+			errorType: InvalidOperationError.ErrorType,
+			message: message ?? `Invalid operation (e.g. syntax error, insufficient privileges, undefined table).`,
+			innerError
+		});
+		Object.setPrototypeOf(this, InvalidOperationError.prototype);
+	}
+};
+
+//#endregion
+//#region src/storage/postgresql/core/errors/errorMapper.ts
+/**
+* Checks whether the given error looks like a PostgreSQL DatabaseError
+* from the `pg` driver (has a string `code` property with a SQLSTATE value).
+*/
+const getPostgresErrorCode = (error) => {
+	if (error instanceof Error && "code" in error && typeof error.code === "string") return error.code;
+};
+const getErrorMessage = (error) => error instanceof Error ? error.message : void 0;
+const asError = (error) => error instanceof Error ? error : void 0;
+/**
+* Maps a PostgreSQL error (from the `pg` driver) to a typed DumboError
+* based on the SQLSTATE code.
+*
+* SQLSTATE reference: https://www.postgresql.org/docs/current/errcodes-appendix.html
+* Transient classification based on Npgsql's PostgresException.IsTransient.
+*
+* Falls back to a generic DumboError (500) if the error is not a recognized PostgreSQL error.
+*/
+const mapPostgresError = (error) => {
+	if (DumboError.isInstanceOf(error)) return error;
+	const code = getPostgresErrorCode(error);
+	if (!code) return new DumboError({
+		errorCode: 500,
+		message: getErrorMessage(error),
+		innerError: asError(error)
+	});
+	const message = getErrorMessage(error);
+	const innerError = asError(error);
+	switch (code) {
+		case "23505": return new UniqueConstraintError(message, innerError);
+		case "23503": return new ForeignKeyViolationError(message, innerError);
+		case "23502": return new NotNullViolationError(message, innerError);
+		case "23514": return new CheckViolationError(message, innerError);
+		case "23P01": return new ExclusionViolationError(message, innerError);
+		case "40001": return new SerializationError(message, innerError);
+		case "40P01": return new DeadlockError(message, innerError);
+		case "55P03":
+		case "55006": return new LockNotAvailableError(message, innerError);
+		case "57014": return new QueryCanceledError(message, innerError);
+		case "57P01":
+		case "57P02": return new AdminShutdownError(message, innerError);
+		case "57P03":
+		case "57P05": return new ConnectionError(message, innerError);
+	}
+	switch (code.slice(0, 2)) {
+		case "08": return new ConnectionError(message, innerError);
+		case "22": return new DataError(message, innerError);
+		case "23": return new IntegrityConstraintViolationError(message, innerError);
+		case "42": return new InvalidOperationError(message, innerError);
+		case "53": return new InsufficientResourcesError(message, innerError);
+		case "57": return new ConnectionError(message, innerError);
+		case "58": return new SystemError(message, innerError);
+	}
+	return new DumboError({
+		errorCode: 500,
+		message,
+		innerError
+	});
+};
+
+//#endregion
+//#region src/core/execute/execute.ts
+const mapSQLQueryResult = (result, mapping) => {
+	if (typeof result !== "object" || result === null) return result;
+	const mappedResult = { ...result };
+	for (const column of Object.keys(mapping)) if (column in mappedResult) mappedResult[column] = mapping[column](mappedResult[column]);
+	return mappedResult;
+};
+var BatchCommandNoChangesError = class BatchCommandNoChangesError extends DumboError {
+	static ErrorCode = 409;
+	static ErrorType = "BatchCommandNoChangesError";
+	statementIndex;
+	constructor(statementIndex) {
+		super({
+			errorCode: BatchCommandNoChangesError.ErrorCode,
+			errorType: BatchCommandNoChangesError.ErrorType,
+			message: `Batch command at index ${statementIndex} affected no rows`
+		});
+		this.name = "BatchCommandNoChangesError";
+		this.statementIndex = statementIndex;
+		Object.setPrototypeOf(this, BatchCommandNoChangesError.prototype);
+	}
+};
+const sqlExecutor = (sqlExecutor, options) => ({
+	query: (sql, queryOptions) => executeInNewDbClient((client) => sqlExecutor.query(client, sql, queryOptions), options),
+	batchQuery: (sqls, queryOptions) => executeInNewDbClient((client) => sqlExecutor.batchQuery(client, sqls, queryOptions), options),
+	command: (sql, commandOptions) => executeInNewDbClient((client) => sqlExecutor.command(client, sql, commandOptions), options),
+	batchCommand: (sqls, commandOptions) => executeInNewDbClient((client) => sqlExecutor.batchCommand(client, sqls, commandOptions), options)
+});
+const sqlExecutorInNewConnection = (options) => ({
+	query: (sql, queryOptions) => executeInNewConnection((connection) => connection.execute.query(sql, queryOptions), options),
+	batchQuery: (sqls, queryOptions) => executeInNewConnection((connection) => connection.execute.batchQuery(sqls, queryOptions), options),
+	command: (sql, commandOptions) => executeInNewConnection((connection) => connection.execute.command(sql, commandOptions), options),
+	batchCommand: (sqls, commandOptions) => executeInNewConnection((connection) => connection.execute.batchCommand(sqls, commandOptions), options)
+});
+const executeInNewDbClient = async (handle, options) => {
+	const { connect, close } = options;
+	const client = await connect();
+	try {
+		return await handle(client);
+	} catch (error) {
+		if (close) await close(client, error);
+		throw error;
+	}
+};
+const executeInNewConnection = async (handle, options) => {
+	const connection = await options.connection();
+	try {
+		return await handle(connection);
+	} finally {
+		await connection.close();
+	}
+};
+
+//#endregion
+//#region src/core/connections/transaction.ts
+const transactionNestingCounter = () => {
+	let transactionLevel = 0;
+	return {
+		reset: () => {
+			transactionLevel = 0;
+		},
+		increment: () => {
+			transactionLevel++;
+		},
+		decrement: () => {
+			transactionLevel--;
+			if (transactionLevel < 0) throw new Error("Transaction level is out of bounds");
+		},
+		get level() {
+			return transactionLevel;
+		}
+	};
+};
+const databaseTransaction = (backend, options) => {
+	const allowNestedTransactions = options?.allowNestedTransactions ?? false;
+	const useSavepoints = options?.useSavepoints ?? false;
+	const counter = transactionNestingCounter();
+	let hasBegun = false;
+	return {
+		begin: async () => {
+			if (!allowNestedTransactions && hasBegun) throw new InvalidOperationError("Cannot start a nested transaction: allowNestedTransactions is false. Set transactionOptions: { allowNestedTransactions: true } on your pool or connection.");
+			if (allowNestedTransactions) {
+				if (counter.level >= 1) {
+					counter.increment();
+					if (useSavepoints && backend.savepoint) await backend.savepoint(counter.level);
+					return;
+				}
+				counter.increment();
+			}
+			hasBegun = true;
+			await backend.begin();
+		},
+		commit: async () => {
+			if (allowNestedTransactions && counter.level > 1) {
+				if (useSavepoints && backend.releaseSavepoint) await backend.releaseSavepoint(counter.level);
+				counter.decrement();
+				return;
+			}
+			if (allowNestedTransactions) counter.reset();
+			hasBegun = false;
+			await backend.commit();
+		},
+		rollback: async (error) => {
+			if (allowNestedTransactions && counter.level > 1) {
+				if (useSavepoints && backend.rollbackToSavepoint) await backend.rollbackToSavepoint(counter.level);
+				counter.decrement();
+				return;
+			}
+			if (allowNestedTransactions) counter.reset();
+			hasBegun = false;
+			await backend.rollback(error);
+		}
+	};
+};
+const toTransactionResult = (transactionResult) => transactionResult !== void 0 && transactionResult !== null && typeof transactionResult === "object" && "success" in transactionResult ? transactionResult : {
+	success: true,
+	result: transactionResult
+};
+const executeInTransaction = async (transaction, handle) => {
+	await transaction.begin();
+	try {
+		const { success, result } = toTransactionResult(await handle(transaction));
+		if (success) await transaction.commit();
+		else await transaction.rollback();
+		return result;
+	} catch (e) {
+		await transaction.rollback();
+		throw e;
+	}
+};
+const transactionFactoryWithDbClient = (connect, initTransaction) => {
+	let currentTransaction = void 0;
+	const getOrInitCurrentTransaction = (options) => currentTransaction ?? (currentTransaction = initTransaction(connect(), {
+		close: () => {
+			currentTransaction = void 0;
+			return Promise.resolve();
+		},
+		...options ?? {}
+	}));
+	return {
+		transaction: getOrInitCurrentTransaction,
+		withTransaction: (handle, options) => executeInTransaction(getOrInitCurrentTransaction(options), handle)
+	};
+};
+const wrapInConnectionClosure = async (connection, handle) => {
+	try {
+		return await handle();
+	} finally {
+		await connection.close();
+	}
+};
+const transactionFactoryWithNewConnection = (connect) => ({
+	transaction: (options) => {
+		const connection = connect();
+		const transaction = connection.transaction(options);
+		return {
+			...transaction,
+			commit: () => wrapInConnectionClosure(connection, () => transaction.commit()),
+			rollback: () => wrapInConnectionClosure(connection, () => transaction.rollback())
+		};
+	},
+	withTransaction: (handle, options) => {
+		const connection = connect();
+		const withTx = connection.withTransaction;
+		return wrapInConnectionClosure(connection, () => withTx(handle, options));
+	}
+});
+
+//#endregion
+//#region src/core/connections/connection.ts
+const createConnection = (options) => {
+	const { driverType, connect, close, initTransaction, executor, serializer } = options;
+	let client = null;
+	let connectPromise = null;
+	const getClient = async () => {
+		if (client) return client;
+		if (!connectPromise) connectPromise = connect().then((c) => {
+			client = c;
+			return c;
+		});
+		return connectPromise;
+	};
+	const typedConnection = {
+		driverType,
+		open: getClient,
+		close: () => client ? close(client) : Promise.resolve(),
+		...transactionFactoryWithDbClient(getClient, initTransaction(() => typedConnection)),
+		execute: sqlExecutor(executor({ serializer }), { connect: getClient }),
+		_transactionType: void 0
+	};
+	return typedConnection;
+};
+
+//#endregion
+//#region src/core/connections/pool.ts
+const createAmbientConnectionPool = (options) => {
+	const { driverType, connection } = options;
+	return createConnectionPool({
+		driverType,
+		getConnection: () => connection,
+		execute: connection.execute,
+		transaction: (options) => connection.transaction(options),
+		withConnection: (handle, _options) => handle(connection),
+		withTransaction: (handle, options) => {
+			const withTx = connection.withTransaction;
+			return withTx(handle, options);
+		}
+	});
+};
+const createConnectionPool = (pool) => {
+	const { driverType, getConnection } = pool;
+	const connection = "connection" in pool ? pool.connection : () => Promise.resolve(getConnection());
+	return {
+		driverType,
+		connection,
+		withConnection: "withConnection" in pool ? pool.withConnection : (handle, _options) => executeInNewConnection(handle, { connection }),
+		close: "close" in pool ? pool.close : () => Promise.resolve(),
+		execute: "execute" in pool ? pool.execute : sqlExecutorInNewConnection({
+			driverType,
+			connection
+		}),
+		..."transaction" in pool && "withTransaction" in pool ? {
+			transaction: pool.transaction,
+			withTransaction: pool.withTransaction
+		} : transactionFactoryWithNewConnection(getConnection)
+	};
+};
+
+//#endregion
+//#region src/core/drivers/databaseDriver.ts
+const canHandleDriverWithConnectionString = (driver, tryParseConnectionString) => (options) => {
+	if ("driverType" in options) return options.driverType === driver;
+	if ("connectionString" in options && typeof options.connectionString === "string") return tryParseConnectionString(options.connectionString) !== null;
+	return false;
+};
+const DumboDatabaseDriverRegistry = () => {
+	const drivers = /* @__PURE__ */ new Map();
+	const register = (driverType, plugin) => {
+		const entry = drivers.get(driverType);
+		if (entry && (typeof entry !== "function" || typeof plugin === "function")) return;
+		drivers.set(driverType, plugin);
+	};
+	const getDriver = (options) => options.driverType ? drivers.get(options.driverType) : [...drivers.values()].find((d) => typeof d !== "function" && d.canHandle(options));
+	const tryResolve = async (options) => {
+		const driver = getDriver(options);
+		if (!driver) return null;
+		if (typeof driver !== "function") return driver;
+		const plugin = await driver();
+		register(plugin.driverType, plugin);
+		return plugin;
+	};
+	const tryGet = (options) => {
+		const driver = getDriver(options);
+		return driver && typeof driver !== "function" ? driver : null;
+	};
+	const has = (driverType) => drivers.has(driverType);
+	return {
+		register,
+		tryResolve,
+		tryGet,
+		has,
+		get databaseDriverTypes() {
+			return Array.from(drivers.keys());
+		}
+	};
+};
+const dumboDatabaseDriverRegistry = globalThis.dumboDatabaseDriverRegistry = globalThis.dumboDatabaseDriverRegistry ?? DumboDatabaseDriverRegistry();
+
+//#endregion
+//#region src/core/locks/databaseLock.ts
+const defaultDatabaseLockOptions = { timeoutMs: 1e4 };
+
+//#endregion
+//#region src/core/query/selectors.ts
+const single = async (getResult) => {
+	const result = await getResult;
+	if (result.rows.length === 0) throw new Error("Query didn't return any result");
+	if (result.rows.length > 1) throw new Error("Query had more than one result");
+	return result.rows[0];
+};
+const exists = async (getResult) => {
+	const result = await single(getResult);
+	return result.exists === true || result.exists === 1;
+};
+
+//#endregion
+//#region src/core/schema/schemaComponent.ts
+const schemaComponent = (key, options) => {
+	const componentsMap = new Map(options.components?.map((comp) => [comp.schemaComponentKey, comp]));
+	const migrations = [...options.migrations ?? []];
+	return {
+		schemaComponentKey: key,
+		components: componentsMap,
+		get migrations() {
+			return [...migrations, ...Array.from(componentsMap.values()).flatMap((c) => c.migrations)];
+		},
+		addComponent: (component) => {
+			componentsMap.set(component.schemaComponentKey, component);
+			migrations.push(...component.migrations);
+			return component;
+		},
+		addMigration: (migration) => {
+			migrations.push(migration);
+		}
+	};
+};
+const isSchemaComponentOfType = (component, prefix) => component.schemaComponentKey.startsWith(prefix);
+const mapSchemaComponentsOfType = (components, prefix, keyMapper) => new Map(Array.from(components.entries()).filter(([urn]) => urn.startsWith(prefix)).map(([urn, component]) => [keyMapper ? keyMapper(component) : urn, component]));
+
+//#endregion
+//#region src/core/schema/components/columnSchemaComponent.ts
+const ColumnURNType = "sc:dumbo:column";
+const ColumnURN = ({ name }) => `${ColumnURNType}:${name}`;
+const columnSchemaComponent = (params) => {
+	const { columnName, type, notNull, unique, primaryKey, default: defaultValue, ...schemaOptions } = params;
+	return {
+		...schemaComponent(ColumnURN({ name: columnName }), schemaOptions),
+		columnName,
+		notNull,
+		unique,
+		primaryKey,
+		defaultValue,
+		sqlTokenType: "SQL_COLUMN",
+		name: columnName,
+		type
+	};
+};
+
+//#endregion
+//#region src/core/schema/components/indexSchemaComponent.ts
+const IndexURNType = "sc:dumbo:index";
+
+//#endregion
+//#region src/core/schema/components/tableSchemaComponent.ts
+const TableURNType = "sc:dumbo:table";
+const TableURN = ({ name }) => `${TableURNType}:${name}`;
+const tableSchemaComponent = ({ tableName, columns, primaryKey, relationships, ...migrationsOrComponents }) => {
+	columns ??= {};
+	relationships ??= {};
+	const base = schemaComponent(TableURN({ name: tableName }), {
+		migrations: migrationsOrComponents.migrations ?? [],
+		components: [...migrationsOrComponents.components ?? [], ...Object.values(columns)]
+	});
+	return {
+		...base,
+		tableName,
+		primaryKey: primaryKey ?? [],
+		relationships,
+		get columns() {
+			const columnsMap = mapSchemaComponentsOfType(base.components, ColumnURNType, (c) => c.columnName);
+			return Object.assign(columnsMap, columns);
+		},
+		get indexes() {
+			return mapSchemaComponentsOfType(base.components, IndexURNType, (c) => c.indexName);
+		},
+		addColumn: (column) => base.addComponent(column),
+		addIndex: (index) => base.addComponent(index)
+	};
+};
+
+//#endregion
+//#region src/core/schema/components/databaseSchemaSchemaComponent.ts
+const DatabaseSchemaURNType = "sc:dumbo:database_schema";
+const DatabaseSchemaURN = ({ name }) => `${DatabaseSchemaURNType}:${name}`;
+const databaseSchemaSchemaComponent = ({ schemaName, tables, ...migrationsOrComponents }) => {
+	const base = schemaComponent(DatabaseSchemaURN({ name: schemaName }), {
+		migrations: migrationsOrComponents.migrations ?? [],
+		components: [...migrationsOrComponents.components ?? [], ...Object.values(tables ?? {})]
+	});
+	return {
+		...base,
+		schemaName,
+		get tables() {
+			const tablesMap = mapSchemaComponentsOfType(base.components, TableURNType, (c) => c.tableName);
+			return Object.assign(tablesMap, tables);
+		},
+		addTable: (table) => base.addComponent(typeof table === "string" ? tableSchemaComponent({ tableName: table }) : table)
+	};
+};
+
+//#endregion
+//#region src/core/schema/components/databaseSchemaComponent.ts
+const DatabaseURNType = "sc:dumbo:database";
+const DatabaseURN = ({ name }) => `${DatabaseURNType}:${name}`;
+const databaseSchemaComponent = ({ databaseName, schemas, ...migrationsOrComponents }) => {
+	schemas ??= {};
+	const base = schemaComponent(DatabaseURN({ name: databaseName }), {
+		migrations: migrationsOrComponents.migrations ?? [],
+		components: [...migrationsOrComponents.components ?? [], ...Object.values(schemas)]
+	});
+	return {
+		...base,
+		databaseName,
+		get schemas() {
+			const schemasMap = mapSchemaComponentsOfType(base.components, DatabaseSchemaURNType, (c) => c.schemaName);
+			return Object.assign(schemasMap, schemas);
+		},
+		addSchema: (schema) => base.addComponent(typeof schema === "string" ? databaseSchemaSchemaComponent({ schemaName: schema }) : schema)
+	};
+};
+
+//#endregion
+//#region src/core/schema/databaseMetadata/databaseMetadata.ts
+const DumboDatabaseMetadataRegistry = () => {
+	const infos = /* @__PURE__ */ new Map();
+	const register = (databaseType, info) => {
+		const entry = infos.get(databaseType);
+		if (entry && (typeof entry !== "function" || typeof info === "function")) return;
+		infos.set(databaseType, info);
+	};
+	const tryResolve = async (databaseType) => {
+		const entry = infos.get(databaseType);
+		if (!entry) return null;
+		if (typeof entry !== "function") return entry;
+		const resolved = await entry();
+		register(databaseType, resolved);
+		return resolved;
+	};
+	const tryGet = (databaseType) => {
+		const entry = infos.get(databaseType);
+		return entry && typeof entry !== "function" ? entry : null;
+	};
+	const has = (databaseType) => infos.has(databaseType);
+	return {
+		register,
+		tryResolve,
+		tryGet,
+		has,
+		get databaseTypes() {
+			return Array.from(infos.keys());
+		}
+	};
+};
+const dumboDatabaseMetadataRegistry$1 = globalThis.dumboDatabaseMetadataRegistry = globalThis.dumboDatabaseMetadataRegistry ?? DumboDatabaseMetadataRegistry();
+
+//#endregion
+//#region src/core/schema/dumboSchema/dumboSchema.ts
+const DEFAULT_DATABASE_NAME = "__default_database__";
+const DEFAULT_DATABASE_SCHEMA_NAME = "__default_database_schema__";
+const dumboTable = (name, definition) => {
+	const { columns, indexes, primaryKey, relationships, ...options } = definition;
+	const components = [...indexes ? Object.values(indexes) : []];
+	return tableSchemaComponent({
+		tableName: name,
+		columns: columns ?? {},
+		primaryKey: primaryKey ?? [],
+		...relationships !== void 0 ? { relationships } : {},
+		components,
+		...options
+	});
+};
+function dumboDatabaseSchema(nameOrTables, tables, options) {
+	return databaseSchemaSchemaComponent({
+		schemaName: typeof nameOrTables === "string" ? nameOrTables : DEFAULT_DATABASE_SCHEMA_NAME,
+		tables: (typeof nameOrTables === "string" ? tables : nameOrTables) ?? {},
+		...options
+	});
+}
+dumboDatabaseSchema.from = (schemaName, tableNames) => {
+	const tables = tableNames.reduce((acc, tableName) => {
+		acc[tableName] = dumboTable(tableName, {});
+		return acc;
+	}, {});
+	return schemaName ? dumboDatabaseSchema(schemaName, tables) : dumboDatabaseSchema(tables);
+};
+function dumboDatabase(nameOrSchemas, schemasOrOptions, options) {
+	const databaseName = typeof nameOrSchemas === "string" ? nameOrSchemas : DEFAULT_DATABASE_NAME;
+	const schemasOrSchema = typeof nameOrSchemas === "string" ? schemasOrOptions ?? {} : nameOrSchemas;
+	return databaseSchemaComponent({
+		databaseName,
+		schemas: "schemaComponentKey" in schemasOrSchema && isSchemaComponentOfType(schemasOrSchema, "sc:dumbo:database_schema") ? { [DEFAULT_DATABASE_SCHEMA_NAME]: schemasOrSchema } : schemasOrSchema,
+		...typeof nameOrSchemas === "string" ? options : schemasOrOptions
+	});
+}
+dumboDatabase.from = (databaseName, schemaNames) => {
+	const schemas = schemaNames.reduce((acc, schemaName) => {
+		acc[schemaName] = dumboDatabaseSchema(schemaName, {});
+		return acc;
+	}, {});
+	return databaseName ? dumboDatabase(databaseName, schemas) : dumboDatabase(schemas);
+};
+dumboDatabase.defaultName = DEFAULT_DATABASE_NAME;
+dumboDatabaseSchema.defaultName = DEFAULT_DATABASE_SCHEMA_NAME;
+
+//#endregion
+//#region src/core/serializer/json/index.ts
+const bigIntReplacer = (_key, value) => {
+	return typeof value === "bigint" ? value.toString() : value;
+};
+const dateReplacer = (_key, value) => {
+	return value instanceof Date ? value.toISOString() : value;
+};
+const isFirstLetterNumeric = (str) => {
+	const c = str.charCodeAt(0);
+	return c >= 48 && c <= 57;
+};
+const isFirstLetterNumericOrMinus = (str) => {
+	const c = str.charCodeAt(0);
+	return c >= 48 && c <= 57 || c === 45;
+};
+const bigIntReviver = (_key, value, context) => {
+	if (typeof value === "number" && Number.isInteger(value) && !Number.isSafeInteger(value)) try {
+		return BigInt(context?.source ?? value.toString());
+	} catch {
+		return value;
+	}
+	if (typeof value === "string" && value.length > 15) {
+		if (isFirstLetterNumericOrMinus(value)) {
+			const num = Number(value);
+			if (Number.isFinite(num) && !Number.isSafeInteger(num)) try {
+				return BigInt(value);
+			} catch {}
+		}
+	}
+	return value;
+};
+const dateReviver = (_key, value) => {
+	if (typeof value === "string" && value.length === 24 && isFirstLetterNumeric(value) && value[10] === "T" && value[23] === "Z") {
+		const date = new Date(value);
+		if (!isNaN(date.getTime())) return date;
+	}
+	return value;
+};
+const composeJSONReplacers = (...replacers) => {
+	const filteredReplacers = replacers.filter((r) => r !== void 0);
+	if (filteredReplacers.length === 0) return void 0;
+	return (key, value) => filteredReplacers.reduce((accValue, replacer) => replacer(key, accValue), value);
+};
+const composeJSONRevivers = (...revivers) => {
+	const filteredRevivers = revivers.filter((r) => r !== void 0);
+	if (filteredRevivers.length === 0) return void 0;
+	return (key, value, context) => filteredRevivers.reduce((accValue, reviver) => reviver(key, accValue, context), value);
+};
+const JSONReplacer = (opts) => composeJSONReplacers(opts?.replacer, opts?.failOnBigIntSerialization !== true ? JSONReplacers.bigInt : void 0, opts?.useDefaultDateSerialization !== true ? JSONReplacers.date : void 0);
+const JSONReviver = (opts) => composeJSONRevivers(opts?.reviver, opts?.parseBigInts === true ? JSONRevivers.bigInt : void 0, opts?.parseDates === true ? JSONRevivers.date : void 0);
+const JSONReplacers = {
+	bigInt: bigIntReplacer,
+	date: dateReplacer
+};
+const JSONRevivers = {
+	bigInt: bigIntReviver,
+	date: dateReviver
+};
+const jsonSerializer = (options) => {
+	const defaultReplacer = JSONReplacer(options);
+	const defaultReviver = JSONReviver(options);
+	return {
+		serialize: (object, serializerOptions) => JSON.stringify(object, serializerOptions ? JSONReplacer(serializerOptions) : defaultReplacer),
+		deserialize: (payload, deserializerOptions) => JSON.parse(payload, deserializerOptions ? JSONReviver(deserializerOptions) : defaultReviver)
+	};
+};
+const JSONSerializer = Object.assign(jsonSerializer(), { from: (options) => options?.serialization?.serializer ?? (options?.serialization?.options ? jsonSerializer(options?.serialization?.options) : JSONSerializer) });
+
+//#endregion
+//#region src/core/sql/parametrizedSQL/parametrizedSQL.ts
+const ParametrizedSQLBuilder = ({ mapParamPlaceholder }) => {
+	const sql = [];
+	const params = [];
+	return {
+		addSQL(str) {
+			sql.push(str);
+			return this;
+		},
+		addParam(value) {
+			sql.push(mapParamPlaceholder(params.length, value));
+			params.push(value);
+			return this;
+		},
+		addParams(values) {
+			const placeholders = values.map((value, i) => mapParamPlaceholder(params.length + i, value));
+			this.addSQL(`${placeholders.join(", ")}`);
+			params.push(...values);
+			return this;
+		},
+		build() {
+			return {
+				query: sql.join(""),
+				params
+			};
+		}
+	};
+};
+
+//#endregion
+//#region src/core/sql/tokens/sqlToken.ts
+const SQLToken = (sqlTokenType, map) => {
+	const factory = (input) => {
+		let props;
+		if (map !== void 0) props = map(input);
+		else if (input === void 0 || input === null) props = {};
+		else if (typeof input === "object" && !Array.isArray(input)) props = input;
+		else throw new Error(`Cannot create SQLToken of type ${sqlTokenType} with input: ${input}`);
+		return {
+			sqlTokenType,
+			[sqlTokenType]: true,
+			...props
+		};
+	};
+	const check = (token) => SQLToken.check(token) && token.sqlTokenType === sqlTokenType;
+	return {
+		from: factory,
+		check,
+		type: sqlTokenType
+	};
+};
+SQLToken.check = (token) => token !== null && typeof token === "object" && "sqlTokenType" in token;
+const SQLIdentifier = SQLToken("SQL_IDENTIFIER", (value) => ({ value }));
+const SQLPlain = SQLToken("SQL_RAW", (value) => ({ value }));
+const SQLLiteral = SQLToken("SQL_LITERAL", (value) => ({ value }));
+const SQLArray = SQLToken("SQL_ARRAY", (input) => {
+	if (Array.isArray(input)) return { value: input };
+	return input.mode !== void 0 ? {
+		value: input.value,
+		mode: input.mode
+	} : { value: input.value };
+});
+const SQLIn = SQLToken("SQL_IN", ({ column, values, mode }) => mode !== void 0 ? {
+	column: SQLIdentifier.from(column),
+	values: SQLArray.from(values),
+	mode
+} : {
+	column: SQLIdentifier.from(column),
+	values: SQLArray.from(values)
+});
+
+//#endregion
+//#region src/core/sql/tokens/columnTokens.ts
+const ColumnTypeToken = (sqlTokenType, jsTypeName, map) => {
+	const factory = (input) => {
+		let props;
+		if (map !== void 0) props = map(input);
+		else if (input === void 0 || input === null) props = {};
+		else if (typeof input === "object" && !Array.isArray(input)) props = input;
+		else throw new Error(`Cannot create SQLToken of type ${sqlTokenType} with input: ${input}`);
+		return {
+			sqlTokenType,
+			[sqlTokenType]: true,
+			jsTypeName,
+			...props
+		};
+	};
+	const check = (token) => SQLToken.check(token) && token.sqlTokenType === sqlTokenType;
+	return {
+		from: factory,
+		check,
+		type: sqlTokenType
+	};
+};
+const SerialToken = ColumnTypeToken("SQL_COLUMN_SERIAL", "value_type:js:number");
+const BigSerialToken = ColumnTypeToken("SQL_COLUMN_BIGSERIAL", "value_type:js:bigint");
+const IntegerToken = ColumnTypeToken("SQL_COLUMN_INTEGER", "value_type:js:number");
+const BigIntegerToken = ColumnTypeToken("SQL_COLUMN_BIGINT", "value_type:js:bigint");
+const JSONBToken = {
+	type: "SQL_COLUMN_JSONB",
+	from: () => {
+		return {
+			sqlTokenType: "SQL_COLUMN_JSONB",
+			["SQL_COLUMN_JSONB"]: true
+		};
+	},
+	check: (token) => SQLToken.check(token) && token.sqlTokenType === "SQL_COLUMN_JSONB"
+};
+const TimestampToken = ColumnTypeToken("SQL_COLUMN_TIMESTAMP", "value_type:js:date");
+const TimestamptzToken = ColumnTypeToken("SQL_COLUMN_TIMESTAMPTZ", "value_type:js:date");
+const VarcharToken = ColumnTypeToken("SQL_COLUMN_VARCHAR", "value_type:js:string", (length) => ({
+	length: length ?? "max",
+	jsTypeName: "value_type:js:string"
+}));
+const AutoIncrementSQLColumnToken = ColumnTypeToken("SQL_COLUMN_AUTO_INCREMENT", "value_type:js:bigint");
+const SQLColumnTypeTokensFactory = {
+	AutoIncrement: AutoIncrementSQLColumnToken.from,
+	BigInteger: BigIntegerToken.from(),
+	BigSerial: BigSerialToken.from(),
+	Integer: IntegerToken.from(),
+	JSONB: JSONBToken.from,
+	Serial: SerialToken.from(),
+	Timestamp: TimestampToken.from(),
+	Timestamptz: TimestamptzToken.from(),
+	Varchar: VarcharToken.from
+};
+const SQLColumnToken = SQLToken("SQL_COLUMN");
+
+//#endregion
+//#region src/core/sql/processors/sqlProcessor.ts
+const SQLProcessor = (options) => options;
+
+//#endregion
+//#region src/core/sql/processors/defaultProcessors.ts
+const ExpandArrayProcessor = SQLProcessor({
+	canHandle: "SQL_ARRAY",
+	handle: (token, { builder, serializer, mapper }) => {
+		if (token.value.length === 0) throw new Error("Empty arrays are not supported. If you're using it with SELECT IN statement Use SQL.in(column, array) helper instead.");
+		builder.addParams(mapper.mapValue(token.value, serializer));
+	}
+});
+const ExpandSQLInProcessor = SQLProcessor({
+	canHandle: "SQL_IN",
+	handle: (token, context) => {
+		const { builder, mapper, processorsRegistry, serializer } = context;
+		const { values: inValues, column } = token;
+		if (inValues.value.length === 0) {
+			builder.addParam(mapper.mapValue(false, serializer));
+			return;
+		}
+		builder.addSQL(mapper.mapValue(column.value, serializer));
+		builder.addSQL(` IN (`);
+		const arrayProcessor = processorsRegistry.get(SQLArray.type);
+		if (!arrayProcessor) throw new Error("No sql processor registered for an array. Cannot expand IN statement");
+		arrayProcessor.handle(inValues, {
+			builder,
+			mapper,
+			processorsRegistry,
+			serializer
+		});
+		builder.addSQL(`)`);
+	}
+});
+const FormatIdentifierProcessor = SQLProcessor({
+	canHandle: "SQL_IDENTIFIER",
+	handle: (token, { builder, mapper, serializer }) => {
+		builder.addSQL(mapper.mapValue(token, serializer));
+	}
+});
+const MapLiteralProcessor = SQLProcessor({
+	canHandle: "SQL_LITERAL",
+	handle: (token, { builder, mapper, serializer }) => builder.addParam(mapper.mapValue(token.value, serializer))
+});
+
+//#endregion
+//#region src/core/sql/processors/sqlProcessorRegistry.ts
+const SQLProcessorsRegistry = (options) => {
+	const processors = options ? new Map(options.from.all()) : /* @__PURE__ */ new Map();
+	function register(...args) {
+		if (args.length === 1 && typeof args[0] === "object" && !Array.isArray(args[0])) Object.entries(args[0]).forEach(([_, processor]) => {
+			processors.set(processor.canHandle, processor);
+		});
+		else args.forEach((p) => processors.set(p.canHandle, p));
+		return registry;
+	}
+	const registry = {
+		register,
+		get: (tokenType) => {
+			return processors.get(tokenType) ?? null;
+		},
+		all: () => processors
+	};
+	return registry;
+};
+
+//#endregion
+//#region src/core/sql/processors/columnProcessors.ts
+const mapDefaultSQLColumnProcessors = (mapColumnType) => ({
+	AutoIncrement: SQLProcessor({
+		canHandle: "SQL_COLUMN_AUTO_INCREMENT",
+		handle: (token, context) => {
+			mapColumnType(token, context);
+		}
+	}),
+	BigInteger: SQLProcessor({
+		canHandle: "SQL_COLUMN_BIGINT",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	BigSerial: SQLProcessor({
+		canHandle: "SQL_COLUMN_BIGSERIAL",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	Serial: SQLProcessor({
+		canHandle: "SQL_COLUMN_SERIAL",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	Integer: SQLProcessor({
+		canHandle: "SQL_COLUMN_INTEGER",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	JSONB: SQLProcessor({
+		canHandle: "SQL_COLUMN_JSONB",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	Timestamp: SQLProcessor({
+		canHandle: "SQL_COLUMN_TIMESTAMP",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	Timestamptz: SQLProcessor({
+		canHandle: "SQL_COLUMN_TIMESTAMPTZ",
+		handle: (token, context) => mapColumnType(token, context)
+	}),
+	Varchar: SQLProcessor({
+		canHandle: "SQL_COLUMN_VARCHAR",
+		handle: (token, context) => mapColumnType(token, context)
+	})
+});
+
+//#endregion
+//#region src/core/sql/processors/index.ts
+const defaultProcessorsRegistry = globalThis.defaultProcessorsRegistry = globalThis.defaultProcessorsRegistry ?? SQLProcessorsRegistry().register(FormatIdentifierProcessor, MapLiteralProcessor, ExpandArrayProcessor, ExpandSQLInProcessor);
+
+//#endregion
+//#region src/core/sql/tokenizedSQL/tokenizedSQL.ts
+const TokenizedSQLBuilder = () => {
+	const sqlChunks = [];
+	const sqlTokens = [];
+	return {
+		addSQL(str) {
+			sqlChunks.push(str);
+		},
+		addSQLs(str) {
+			sqlChunks.push(...str);
+		},
+		addToken(value) {
+			sqlTokens.push(value);
+		},
+		addTokens(vals) {
+			sqlTokens.push(...vals);
+		},
+		build() {
+			return sqlChunks.length > 0 ? {
+				__brand: "tokenized-sql",
+				sqlChunks,
+				sqlTokens
+			} : TokenizedSQL.empty;
+		}
+	};
+};
+const TokenizedSQL = (strings, values) => {
+	const builder = TokenizedSQLBuilder();
+	for (let i = 0; i < strings.length; i++) {
+		if (strings[i] !== "") builder.addSQL(strings[i]);
+		if (i >= values.length) break;
+		const value = values[i];
+		if (isTokenizedSQL(value)) {
+			builder.addSQLs(value.sqlChunks);
+			builder.addTokens(value.sqlTokens);
+		} else if (SQLPlain.check(value)) builder.addSQL(value.value);
+		else {
+			builder.addSQL(TokenizedSQL.paramPlaceholder);
+			builder.addToken(SQLToken.check(value) ? value : Array.isArray(value) ? SQLArray.from(value) : SQLLiteral.from(value));
+		}
+	}
+	return builder.build();
+};
+const isTokenizedSQL = (value) => {
+	return value !== null && typeof value === "object" && "__brand" in value && value.__brand === "tokenized-sql";
+};
+TokenizedSQL.paramPlaceholder = `__P__`;
+TokenizedSQL.empty = {
+	__brand: "tokenized-sql",
+	sqlChunks: [""],
+	sqlTokens: []
+};
+
+//#endregion
+//#region src/core/sql/sql.ts
+const createSQL = (strings, ...values) => {
+	return TokenizedSQL(strings, values);
+};
+/** Returns true when the value is a tokenized SQL statement. */
+const isSQL = (value) => {
+	if (value === void 0 || value === null) return false;
+	return isTokenizedSQL(value);
+};
+const emptySQL = {
+	__brand: "tokenized-sql",
+	sqlChunks: [""],
+	sqlTokens: []
+};
+const mergeSQL = (sqls, separator = " ") => {
+	const parametrized = sqls.filter((sql) => !isEmpty(sql)).map((sql) => sql);
+	const params = parametrized.flatMap((p) => p.sqlTokens);
+	const sqlChunks = parametrized.flatMap((p, i) => i == parametrized.length - 1 || separator === "" ? p.sqlChunks : [...p.sqlChunks, separator]);
+	return sqlChunks.length > 0 ? {
+		__brand: "tokenized-sql",
+		sqlChunks,
+		sqlTokens: params
+	} : TokenizedSQL.empty;
+};
+const concatSQL = (...sqls) => mergeSQL(sqls, "");
+const literal = (value) => SQLPlain.from(`'${value.replace(/'/g, "''")}'`);
+const isEmpty = (sql) => {
+	if (isTokenizedSQL(sql)) {
+		const parametrized = sql;
+		return parametrized.sqlChunks.every((chunk) => chunk.trim() === "") && parametrized.sqlTokens.length === 0;
+	}
+	return false;
+};
+const columnFactory = SQLColumnToken.from;
+columnFactory.type = SQLColumnTypeTokensFactory;
+const schemaColumnFactory = ((name, type, options) => columnSchemaComponent({
+	columnName: name,
+	type,
+	...options
+}));
+const SQL = Object.assign(createSQL, {
+	EMPTY: emptySQL,
+	concat: concatSQL,
+	merge: mergeSQL,
+	format: (sql, formatter, options) => formatSQL(sql, formatter, options?.serializer ?? JSONSerializer, options),
+	describe: (sql, formatter, options) => describeSQL(sql, formatter, options?.serializer ?? JSONSerializer, options),
+	in: (column, values, options) => options?.mode ? SQLIn.from({
+		column,
+		values,
+		mode: options.mode
+	}) : SQLIn.from({
+		column,
+		values
+	}),
+	array: (values, options) => SQLArray.from(options?.mode ? {
+		value: values,
+		mode: options.mode
+	} : values),
+	identifier: SQLIdentifier.from,
+	plain: SQLPlain.from,
+	literal,
+	check: {
+		isSQL,
+		isTokenizedSQL: (value) => isTokenizedSQL(value),
+		isEmpty,
+		isIdentifier: SQLIdentifier.check,
+		isPlain: SQLPlain.check,
+		isSQLIn: SQLIn.check
+	},
+	column: columnFactory,
+	columnN: Object.assign(schemaColumnFactory, { type: SQLColumnTypeTokensFactory })
+});
+
+//#endregion
+//#region src/core/sql/valueMappers/reservedSqlWords.ts
+const ansiSqlReservedMap = {
+	ALL: true,
+	AND: true,
+	ANY: true,
+	ARRAY: true,
+	AS: true,
+	ASC: true,
+	AUTHORIZATION: true,
+	BETWEEN: true,
+	BINARY: true,
+	BOTH: true,
+	CASE: true,
+	CAST: true,
+	CHECK: true,
+	COLLATE: true,
+	COLUMN: true,
+	CONSTRAINT: true,
+	CREATE: true,
+	CROSS: true,
+	CURRENT_DATE: true,
+	CURRENT_TIME: true,
+	CURRENT_TIMESTAMP: true,
+	CURRENT_USER: true,
+	DEFAULT: true,
+	DEFERRABLE: true,
+	DESC: true,
+	DISTINCT: true,
+	DO: true,
+	ELSE: true,
+	END: true,
+	EXCEPT: true,
+	FALSE: true,
+	FOR: true,
+	FOREIGN: true,
+	FROM: true,
+	FULL: true,
+	GRANT: true,
+	GROUP: true,
+	HAVING: true,
+	IN: true,
+	INITIALLY: true,
+	INNER: true,
+	INTERSECT: true,
+	INTO: true,
+	IS: true,
+	JOIN: true,
+	LEADING: true,
+	LEFT: true,
+	LIKE: true,
+	LOCALTIME: true,
+	LOCALTIMESTAMP: true,
+	NATURAL: true,
+	NEW: true,
+	NOT: true,
+	NULL: true,
+	NULLS: true,
+	OLD: true,
+	ON: true,
+	ONLY: true,
+	OPEN: true,
+	OR: true,
+	ORDER: true,
+	OUTER: true,
+	OVERLAPS: true,
+	PARTITION: true,
+	PLACING: true,
+	PRIMARY: true,
+	REFERENCES: true,
+	RIGHT: true,
+	SELECT: true,
+	SESSION_USER: true,
+	SIMILAR: true,
+	SOME: true,
+	TABLE: true,
+	THEN: true,
+	TO: true,
+	TRAILING: true,
+	TRUE: true,
+	UNION: true,
+	UNIQUE: true,
+	USER: true,
+	USING: true,
+	WHEN: true,
+	WHERE: true,
+	WITH: true,
+	WITHOUT: true,
+	ADD: true,
+	ALTER: true,
+	ARE: true,
+	AT: true,
+	BEGIN: true,
+	BY: true,
+	CASCADE: true,
+	CLOSE: true,
+	COMMIT: true,
+	CONNECT: true,
+	CONTINUE: true,
+	CORRESPONDING: true,
+	CURSOR: true,
+	DEALLOCATE: true,
+	DECLARE: true,
+	DELETE: true,
+	DESCRIBE: true,
+	DISCONNECT: true,
+	DROP: true,
+	ESCAPE: true,
+	EXECUTE: true,
+	EXISTS: true,
+	FETCH: true,
+	FIRST: true,
+	FLOAT: true,
+	GET: true,
+	GLOBAL: true,
+	GO: true,
+	GOTO: true,
+	HOUR: true,
+	IMMEDIATE: true,
+	INDICATOR: true,
+	INPUT: true,
+	INSERT: true,
+	INT: true,
+	INTEGER: true,
+	INTERVAL: true,
+	LANGUAGE: true,
+	LAST: true,
+	LOCAL: true,
+	MATCH: true,
+	MINUTE: true,
+	MODULE: true,
+	MONTH: true,
+	NATIONAL: true,
+	NEXT: true,
+	NO: true,
+	OF: true,
+	OUTPUT: true,
+	PARTIAL: true,
+	PREPARE: true,
+	PRESERVE: true,
+	PRIOR: true,
+	PRIVILEGES: true,
+	PROCEDURE: true,
+	PUBLIC: true,
+	READ: true,
+	REAL: true,
+	RESTRICT: true,
+	REVOKE: true,
+	ROLLBACK: true,
+	ROWS: true,
+	SCHEMA: true,
+	SCROLL: true,
+	SECOND: true,
+	SECTION: true,
+	SET: true,
+	SIZE: true,
+	SMALLINT: true,
+	SQL: true,
+	SQLCODE: true,
+	SQLERROR: true,
+	SQLSTATE: true,
+	TEMPORARY: true,
+	TIMEZONE_HOUR: true,
+	TIMEZONE_MINUTE: true,
+	TRANSACTION: true,
+	TRANSLATE: true,
+	TRANSLATION: true,
+	UNKNOWN: true,
+	UPDATE: true,
+	VALUE: true,
+	VALUES: true,
+	VARCHAR: true,
+	VARYING: true,
+	VIEW: true,
+	WHENEVER: true,
+	WORK: true,
+	WRITE: true,
+	YEAR: true,
+	ZONE: true
+};
+
+//#endregion
+//#region src/core/sql/valueMappers/sqlValueMapper.ts
+const ANSISQLParamPlaceholder = "?";
+const ANSISQLIdentifierQuote = "\"";
+const mapANSISQLParamPlaceholder = () => "?";
+const isReserved = (value, reserved) => !!reserved[value.toUpperCase()];
+const mapSQLIdentifier = (value, options) => {
+	if (value === void 0 || value === null) throw new Error("SQL identifier cannot be null or undefined");
+	const ident = value.toString().slice(0);
+	const quoteSign = options?.quote ?? "\"";
+	if (/^[a-z_][a-z0-9_$]*$/.test(ident) && !isReserved(ident, options?.reservedWords ?? ansiSqlReservedMap)) return ident;
+	let quoted = quoteSign;
+	for (let i = 0; i < ident.length; i++) {
+		const c = ident[i];
+		quoted += c === quoteSign ? c + c : c;
+	}
+	quoted += quoteSign;
+	return quoted;
+};
+const DefaultMapSQLParamValueOptions = {
+	mapPlaceholder: mapANSISQLParamPlaceholder,
+	mapIdentifier: mapSQLIdentifier
+};
+const SQLValueMapper = (options) => {
+	const mapSQLParamValueOptions = {
+		...DefaultMapSQLParamValueOptions,
+		...options ?? {}
+	};
+	return {
+		mapValue: (value, serializer, mapOptions) => mapSQLParamValue(value, serializer, {
+			...mapSQLParamValueOptions,
+			...mapOptions
+		}),
+		mapPlaceholder: mapSQLParamValueOptions.mapPlaceholder,
+		mapIdentifier: mapSQLParamValueOptions.mapIdentifier
+	};
+};
+function mapSQLParamValue(value, serializer, options) {
+	if (value === null || value === void 0) return null;
+	else if (typeof value === "number") return value;
+	else if (typeof value === "string") return value;
+	else if (Array.isArray(value)) {
+		const mapValue = options?.mapValue ?? mapSQLParamValue;
+		return options?.mapArray ? options.mapArray(value, mapValue) : value.map((item) => mapValue(item, serializer, options));
+	} else if (typeof value === "boolean") return options?.mapBoolean ? options.mapBoolean(value) : value;
+	else if (typeof value === "bigint") return options?.mapBigInt ? options.mapBigInt(value) : value.toString();
+	else if (value instanceof Date) return options?.mapDate ? options.mapDate(value) : value.toISOString();
+	else if (SQL.check.isIdentifier(value)) return (options?.mapIdentifier ?? mapSQLIdentifier)(value.value);
+	else if (typeof value === "object") return options?.mapObject ? options.mapObject(value) : serializer.serialize(value);
+	else return serializer.serialize(value);
+}
+
+//#endregion
+//#region src/core/sql/formatters/sqlFormatter.ts
+const SQLFormatter = ({ format, describe, valueMapper: valueMapperOptions, processorsRegistry }) => {
+	const valueMapper = SQLValueMapper(valueMapperOptions);
+	const options = {
+		builder: ParametrizedSQLBuilder({ mapParamPlaceholder: valueMapper.mapPlaceholder }),
+		mapper: valueMapper,
+		processorsRegistry: processorsRegistry ?? defaultProcessorsRegistry
+	};
+	const resultFormatter = {
+		format: format ?? ((sql, methodOptions) => formatSQL(sql, resultFormatter, methodOptions?.serializer ?? JSONSerializer, {
+			...options,
+			...methodOptions ?? {}
+		})),
+		describe: describe ?? ((sql, methodOptions) => describeSQL(sql, resultFormatter, methodOptions?.serializer ?? JSONSerializer, {
+			...options,
+			...methodOptions ?? {}
+		})),
+		valueMapper
+	};
+	return resultFormatter;
+};
+const dumboSQLFormatters = globalThis.dumboSQLFormatters = globalThis.dumboSQLFormatters ?? {};
+const registerFormatter = (dialect, formatter) => {
+	dumboSQLFormatters[dialect] = formatter;
+};
+function formatSQL(sql, formatter, serializer, context) {
+	const mapper = context?.mapper == void 0 ? formatter.valueMapper : {
+		...formatter.valueMapper,
+		...context.mapper
+	};
+	const processorsRegistry = context?.processorsRegistry ?? defaultProcessorsRegistry;
+	const merged = Array.isArray(sql) ? SQL.merge(sql, "\n") : sql;
+	if (!isTokenizedSQL(merged)) throw new Error("Expected TokenizedSQL, got string-based SQL");
+	const builder = ParametrizedSQLBuilder({ mapParamPlaceholder: mapper.mapPlaceholder });
+	let paramIndex = 0;
+	for (let i = 0; i < merged.sqlChunks.length; i++) {
+		const sqlChunk = merged.sqlChunks[i];
+		if (sqlChunk !== TokenizedSQL.paramPlaceholder) {
+			builder.addSQL(sqlChunk);
+			continue;
+		}
+		const token = merged.sqlTokens[paramIndex++];
+		const processor = processorsRegistry.get(token.sqlTokenType);
+		if (!processor) throw new Error(`No SQL processor registered for token type: ${token.sqlTokenType}`);
+		processor.handle(token, {
+			builder,
+			processorsRegistry,
+			serializer,
+			mapper
+		});
+	}
+	return builder.build();
+}
+const describeSQL = (sql, formatter, serializer, options) => formatSQL(sql, formatter, serializer, {
+	...options ?? {},
+	mapper: { mapPlaceholder: (_, value) => serializer.serialize(value) }
+}).query;
+
+//#endregion
+//#region src/core/tracing/printing/color.ts
+let enableColors = true;
+const color = {
+	set level(value) {
+		enableColors = value === 1;
+	},
+	hex: (value) => (text) => enableColors ? ansis.hex(value)(text) : text,
+	red: (value) => enableColors ? ansis.red(value) : value,
+	green: (value) => enableColors ? ansis.green(value) : value,
+	blue: (value) => enableColors ? ansis.blue(value) : value,
+	cyan: (value) => enableColors ? ansis.cyan(value) : value,
+	yellow: (value) => enableColors ? ansis.yellow(value) : value
+};
+
+//#endregion
+//#region src/core/tracing/printing/pretty.ts
+const TWO_SPACES = "  ";
+const COLOR_STRING = color.hex("#98c379");
+const COLOR_KEY = color.hex("#61afef");
+const COLOR_NUMBER_OR_DATE = color.hex("#d19a66");
+const COLOR_BOOLEAN = color.hex("#c678dd");
+const COLOR_NULL_OR_UNDEFINED = color.hex("#c678dd");
+const COLOR_BRACKETS = color.hex("#abb2bf");
+const processString = (str, indent, handleMultiline) => {
+	if (handleMultiline && str.includes("\n")) {
+		const indentedLines = str.split("\n").map((line) => indent + TWO_SPACES + COLOR_STRING(line));
+		return COLOR_STRING("\"") + "\n" + indentedLines.join("\n") + "\n" + indent + COLOR_STRING("\"");
+	}
+	return COLOR_STRING(`"${str}"`);
+};
+const shouldPrint = (obj) => typeof obj !== "function" && typeof obj !== "symbol";
+const formatJson = (obj, indentLevel = 0, handleMultiline = false) => {
+	const indent = TWO_SPACES.repeat(indentLevel);
+	if (obj === null) return COLOR_NULL_OR_UNDEFINED("null");
+	if (obj === void 0) return COLOR_NULL_OR_UNDEFINED("undefined");
+	if (typeof obj === "string") return processString(obj, indent, handleMultiline);
+	if (typeof obj === "number" || typeof obj === "bigint" || obj instanceof Date) return COLOR_NUMBER_OR_DATE(String(obj));
+	if (typeof obj === "boolean") return COLOR_BOOLEAN(String(obj));
+	if (obj instanceof Error) {
+		const errorObj = {};
+		Object.getOwnPropertyNames(obj).forEach((key) => {
+			errorObj[key] = obj[key];
+		});
+		return formatJson(errorObj, indentLevel, handleMultiline);
+	}
+	if (obj instanceof Promise) return COLOR_STRING("Promise {pending}");
+	if (Array.isArray(obj)) {
+		const arrayItems = obj.map((item) => formatJson(item, indentLevel + 1, handleMultiline));
+		return `${COLOR_BRACKETS("[")}\n${indent}  ${arrayItems.join(`,\n${indent}  `)}\n${indent}${COLOR_BRACKETS("]")}`;
+	}
+	const entries = Object.entries(obj).filter(([_, value]) => shouldPrint(value)).map(([key, value]) => `${COLOR_KEY(`"${key}"`)}: ${formatJson(value, indentLevel + 1, handleMultiline)}`);
+	return `${COLOR_BRACKETS("{")}\n${indent}  ${entries.join(`,\n${indent}  `)}\n${indent}${COLOR_BRACKETS("}")}`;
+};
+const prettyJson = (obj, options) => formatJson(obj, 0, options?.handleMultiline);
+
+//#endregion
+//#region src/core/tracing/index.ts
+const tracer = () => {};
+const LogLevel = {
+	DISABLED: "DISABLED",
+	INFO: "INFO",
+	LOG: "LOG",
+	WARN: "WARN",
+	ERROR: "ERROR"
+};
+const getEnvVariable = (name) => {
+	try {
+		if (typeof process !== "undefined" && process.env) return process.env[name];
+		return;
+	} catch {
+		return;
+	}
+};
+const shouldLog = (logLevel) => {
+	const definedLogLevel = getEnvVariable("DUMBO_LOG_LEVEL") ?? LogLevel.ERROR;
+	if (definedLogLevel === LogLevel.ERROR && logLevel === LogLevel.ERROR) return true;
+	if (definedLogLevel === LogLevel.WARN && [LogLevel.ERROR, LogLevel.WARN].includes(logLevel)) return true;
+	if (definedLogLevel === LogLevel.LOG && [
+		LogLevel.ERROR,
+		LogLevel.WARN,
+		LogLevel.LOG
+	].includes(logLevel)) return true;
+	if (definedLogLevel === LogLevel.INFO && [
+		LogLevel.ERROR,
+		LogLevel.WARN,
+		LogLevel.LOG,
+		LogLevel.INFO
+	].includes(logLevel)) return true;
+	return false;
+};
+const nulloTraceEventRecorder = () => {};
+const getTraceEventFormatter = (logStyle, serializer = JSONSerializer) => (event) => {
+	switch (logStyle) {
+		case "RAW": return serializer.serialize(event);
+		case "PRETTY": return prettyJson(event, { handleMultiline: true });
+	}
+};
+const getTraceEventRecorder = (logLevel, logStyle) => {
+	const format = getTraceEventFormatter(logStyle);
+	switch (logLevel) {
+		case "DISABLED": return nulloTraceEventRecorder;
+		case "INFO": return (event) => console.info(format(event));
+		case "LOG": return (event) => console.log(format(event));
+		case "WARN": return (event) => console.warn(format(event));
+		case "ERROR": return (event) => console.error(format(event));
+	}
+};
+const recordTraceEvent = (logLevel, eventName, attributes) => {
+	if (!shouldLog(LogLevel.LOG)) return;
+	const event = {
+		name: eventName,
+		timestamp: (/* @__PURE__ */ new Date()).getTime(),
+		...attributes
+	};
+	getTraceEventRecorder(logLevel, getEnvVariable("DUMBO_LOG_STYLE") ?? "RAW")(event);
+};
+tracer.info = (eventName, attributes) => recordTraceEvent(LogLevel.INFO, eventName, attributes);
+tracer.warn = (eventName, attributes) => recordTraceEvent(LogLevel.WARN, eventName, attributes);
+tracer.log = (eventName, attributes) => recordTraceEvent(LogLevel.LOG, eventName, attributes);
+tracer.error = (eventName, attributes) => recordTraceEvent(LogLevel.ERROR, eventName, attributes);
+
+//#endregion
+//#region src/core/schema/sqlMigration.ts
+const sqlMigration = (name, sqls) => ({
+	name,
+	sqls
+});
+
+//#endregion
+//#region src/core/schema/migrators/schemaComponentMigrator.ts
+const { AutoIncrement, Varchar, Timestamp } = SQL.column.type;
+const migrationTableSQL = SQL`
+  CREATE TABLE IF NOT EXISTS dmb_migrations (
+    id ${AutoIncrement({ primaryKey: true })},
+    name ${Varchar(255)} NOT NULL UNIQUE,
+    application ${Varchar(255)} NOT NULL DEFAULT 'default',
+    sql_hash ${Varchar(64)} NOT NULL,
+    timestamp ${Timestamp} NOT NULL DEFAULT CURRENT_TIMESTAMP
+  );
+`;
+const migrationTableSchemaComponent = schemaComponent("dumbo:schema-component:migrations-table", { migrations: [sqlMigration("dumbo:migrationTable:001", [migrationTableSQL])] });
+
+//#endregion
+//#region src/core/schema/migrators/migrator.ts
+const defaultMigratorOptions = globalThis.defaultMigratorOptions = globalThis.defaultMigratorOptions ?? {};
+const registerDefaultMigratorOptions = (databaseType, options) => {
+	defaultMigratorOptions[databaseType] = options;
+};
+
+//#endregion
+//#region src/storage/postgresql/core/locks/advisoryLocks.ts
+const tryAcquireAdvisoryLock = async (execute, options) => {
+	const timeoutMs = options.timeoutMs ?? defaultDatabaseLockOptions.timeoutMs;
+	const advisoryLock = options.mode === "Permanent" ? "pg_advisory_lock" : "pg_advisory_xact_lock";
+	try {
+		await single(execute.query(SQL`SELECT ${SQL.plain(advisoryLock)}(${options.lockId}) AS locked`, { timeoutMs }));
+		return true;
+	} catch (error) {
+		if (error instanceof QueryCanceledError || DumboError.isInstanceOf(error, { errorType: QueryCanceledError.ErrorType })) return false;
+		throw error;
+	}
+};
+const releaseAdvisoryLock = async (execute, options) => {
+	const timeoutMs = options.timeoutMs ?? defaultDatabaseLockOptions.timeoutMs;
+	try {
+		await single(execute.query(SQL`SELECT pg_advisory_unlock(${options.lockId}) AS locked`, { timeoutMs }));
+		return true;
+	} catch (error) {
+		if (error instanceof QueryCanceledError || DumboError.isInstanceOf(error, { errorType: QueryCanceledError.ErrorType })) return false;
+		throw error;
+	}
+};
+const acquireAdvisoryLock = async (execute, options) => {
+	if (!await tryAcquireAdvisoryLock(execute, options)) throw new Error("Failed to acquire advisory lock within the specified timeout. Migration aborted.");
+};
+const AdvisoryLock = {
+	acquire: acquireAdvisoryLock,
+	tryAcquire: tryAcquireAdvisoryLock,
+	release: releaseAdvisoryLock,
+	withAcquire: async (execute, handle, options) => {
+		await acquireAdvisoryLock(execute, options);
+		try {
+			return await handle();
+		} finally {
+			if (options.mode === "Permanent") await releaseAdvisoryLock(execute, options);
+		}
+	}
+};
+const advisoryLock = (execute, options) => ({
+	acquire: (acquireOptions) => acquireAdvisoryLock(execute, {
+		...options,
+		...acquireOptions ?? {}
+	}),
+	tryAcquire: (acquireOptions) => tryAcquireAdvisoryLock(execute, {
+		...options,
+		...acquireOptions ?? {}
+	}),
+	release: () => releaseAdvisoryLock(execute, options),
+	withAcquire: async (handle, acquireOptions) => {
+		await acquireAdvisoryLock(execute, {
+			...options,
+			...acquireOptions ?? {}
+		});
+		try {
+			return await handle();
+		} finally {
+			await releaseAdvisoryLock(execute, options);
+		}
+	}
+});
+
+//#endregion
+//#region src/storage/postgresql/core/schema/migrations.ts
+const DefaultPostgreSQLMigratorOptions = { lock: { databaseLock: AdvisoryLock } };
+registerDefaultMigratorOptions("PostgreSQL", DefaultPostgreSQLMigratorOptions);
+
+//#endregion
+//#region src/storage/postgresql/core/schema/schema.ts
+const defaultPostgreSqlDatabase = "postgres";
+const tableExistsSQL = (tableName) => SQL`
+  SELECT EXISTS (
+    SELECT FROM pg_tables
+    WHERE tablename = ${tableName}
+  ) AS exists;`;
+const tableExists = async (execute, tableName) => exists(execute.query(tableExistsSQL(tableName)));
+const functionExistsSQL = (functionName) => SQL`
+      SELECT EXISTS (
+        SELECT FROM pg_proc
+        WHERE
+        proname = ${functionName}
+      ) AS exists;`;
+const functionExists = async (execute, functionName) => exists(execute.query(functionExistsSQL(functionName)));
+
+//#endregion
+//#region src/storage/postgresql/core/schema/postgreSQLMetadata.ts
+const postgreSQLMetadata = {
+	databaseType: "PostgreSQL",
+	defaultDatabaseName: defaultPostgreSqlDatabase,
+	capabilities: {
+		supportsSchemas: true,
+		supportsFunctions: true,
+		supportsMultipleDatabases: true
+	},
+	tableExists,
+	functionExists,
+	parseDatabaseName: (connectionString) => (connectionString ? parseDatabaseName(connectionString) : null) ?? "postgres"
+};
+dumboDatabaseMetadataRegistry.register("PostgreSQL", postgreSQLMetadata);
+
+//#endregion
+//#region src/storage/postgresql/core/sql/processors/arrayProcessors.ts
+const PostgreSQLArrayProcessor = SQLProcessor({
+	canHandle: "SQL_ARRAY",
+	handle: (token, { builder, mapper, serializer }) => {
+		if (token.value.length === 0) throw new Error("Empty arrays are not supported. If you're using it with SELECT IN statement Use SQL.in(column, array) helper instead.");
+		const mappedValue = mapper.mapValue(token.value, serializer);
+		if (token.mode === "params") builder.addParams(mappedValue);
+		else builder.addParam(mappedValue);
+	}
+});
+const PostgreSQLExpandSQLInProcessor = SQLProcessor({
+	canHandle: "SQL_IN",
+	handle: (token, context) => {
+		const { builder, mapper, processorsRegistry } = context;
+		const { values: inValues, column, mode } = token;
+		if (inValues.value.length === 0) {
+			builder.addParam(mapper.mapValue(false, context.serializer));
+			return;
+		}
+		builder.addSQL(mapper.mapValue(column.value, context.serializer));
+		const arrayProcessor = processorsRegistry.get(SQLArray.type);
+		if (!arrayProcessor) throw new Error("No sql processor registered for an array. Cannot expand IN statement");
+		if (mode === "params") {
+			builder.addSQL(` IN (`);
+			const expandedArray = {
+				...inValues,
+				mode: "params"
+			};
+			arrayProcessor.handle(expandedArray, context);
+			builder.addSQL(`)`);
+		} else {
+			builder.addSQL(` = ANY (`);
+			arrayProcessor.handle(inValues, context);
+			builder.addSQL(`)`);
+		}
+	}
+});
+
+//#endregion
+//#region src/storage/postgresql/core/sql/processors/columProcessors.ts
+const mapColumnType = (token, { builder }) => {
+	let columnSQL;
+	const { sqlTokenType } = token;
+	switch (sqlTokenType) {
+		case "SQL_COLUMN_AUTO_INCREMENT":
+			columnSQL = `${token.bigint ? "BIGSERIAL" : "SERIAL"} ${token.primaryKey ? "PRIMARY KEY" : ""}`;
+			break;
+		case "SQL_COLUMN_BIGINT":
+			columnSQL = "BIGINT";
+			break;
+		case "SQL_COLUMN_SERIAL":
+			columnSQL = "SERIAL";
+			break;
+		case "SQL_COLUMN_INTEGER":
+			columnSQL = "INTEGER";
+			break;
+		case "SQL_COLUMN_JSONB":
+			columnSQL = "JSONB";
+			break;
+		case "SQL_COLUMN_BIGSERIAL":
+			columnSQL = "BIGSERIAL";
+			break;
+		case "SQL_COLUMN_TIMESTAMP":
+			columnSQL = "TIMESTAMP";
+			break;
+		case "SQL_COLUMN_TIMESTAMPTZ":
+			columnSQL = "TIMESTAMPTZ";
+			break;
+		case "SQL_COLUMN_VARCHAR":
+			columnSQL = `VARCHAR ${Number.isNaN(token.length) ? "" : `(${token.length})`}`;
+			break;
+		default: throw new Error(`Unknown column type: ${sqlTokenType}`);
+	}
+	builder.addSQL(columnSQL);
+};
+const postgreSQLColumnProcessors = mapDefaultSQLColumnProcessors(mapColumnType);
+
+//#endregion
+//#region src/storage/postgresql/core/sql/formatter/reserved.ts
+const reservedMap = {
+	AES128: true,
+	AES256: true,
+	ALL: true,
+	ALLOWOVERWRITE: true,
+	ANALYSE: true,
+	ANALYZE: true,
+	AND: true,
+	ANY: true,
+	ARRAY: true,
+	AS: true,
+	ASC: true,
+	AUTHORIZATION: true,
+	BACKUP: true,
+	BETWEEN: true,
+	BINARY: true,
+	BLANKSASNULL: true,
+	BOTH: true,
+	BYTEDICT: true,
+	CASE: true,
+	CAST: true,
+	CHECK: true,
+	COLLATE: true,
+	COLUMN: true,
+	CONSTRAINT: true,
+	CREATE: true,
+	CREDENTIALS: true,
+	CROSS: true,
+	CURRENT_DATE: true,
+	CURRENT_TIME: true,
+	CURRENT_TIMESTAMP: true,
+	CURRENT_USER: true,
+	CURRENT_USER_ID: true,
+	DEFAULT: true,
+	DEFERRABLE: true,
+	DEFLATE: true,
+	DEFRAG: true,
+	DELTA: true,
+	DELTA32K: true,
+	DESC: true,
+	DISABLE: true,
+	DISTINCT: true,
+	DO: true,
+	ELSE: true,
+	EMPTYASNULL: true,
+	ENABLE: true,
+	ENCODE: true,
+	ENCRYPT: true,
+	ENCRYPTION: true,
+	END: true,
+	EXCEPT: true,
+	EXPLICIT: true,
+	FALSE: true,
+	FOR: true,
+	FOREIGN: true,
+	FREEZE: true,
+	FROM: true,
+	FULL: true,
+	GLOBALDICT256: true,
+	GLOBALDICT64K: true,
+	GRANT: true,
+	GROUP: true,
+	GZIP: true,
+	HAVING: true,
+	IDENTITY: true,
+	IGNORE: true,
+	ILIKE: true,
+	IN: true,
+	INITIALLY: true,
+	INNER: true,
+	INTERSECT: true,
+	INTO: true,
+	IS: true,
+	ISNULL: true,
+	JOIN: true,
+	LEADING: true,
+	LEFT: true,
+	LIKE: true,
+	LIMIT: true,
+	LOCALTIME: true,
+	LOCALTIMESTAMP: true,
+	LUN: true,
+	LUNS: true,
+	LZO: true,
+	LZOP: true,
+	MINUS: true,
+	MOSTLY13: true,
+	MOSTLY32: true,
+	MOSTLY8: true,
+	NATURAL: true,
+	NEW: true,
+	NOT: true,
+	NOTNULL: true,
+	NULL: true,
+	NULLS: true,
+	OFF: true,
+	OFFLINE: true,
+	OFFSET: true,
+	OLD: true,
+	ON: true,
+	ONLY: true,
+	OPEN: true,
+	OR: true,
+	ORDER: true,
+	OUTER: true,
+	OVERLAPS: true,
+	PARALLEL: true,
+	PARTITION: true,
+	PERCENT: true,
+	PLACING: true,
+	PRIMARY: true,
+	RAW: true,
+	READRATIO: true,
+	RECOVER: true,
+	REFERENCES: true,
+	REJECTLOG: true,
+	RESORT: true,
+	RESTORE: true,
+	RIGHT: true,
+	SELECT: true,
+	SESSION_USER: true,
+	SIMILAR: true,
+	SOME: true,
+	SYSDATE: true,
+	SYSTEM: true,
+	TABLE: true,
+	TAG: true,
+	TDES: true,
+	TEXT255: true,
+	TEXT32K: true,
+	THEN: true,
+	TO: true,
+	TOP: true,
+	TRAILING: true,
+	TRUE: true,
+	TRUNCATECOLUMNS: true,
+	UNION: true,
+	UNIQUE: true,
+	USER: true,
+	USING: true,
+	VERBOSE: true,
+	WALLET: true,
+	WHEN: true,
+	WHERE: true,
+	WITH: true,
+	WITHOUT: true
+};
+
+//#endregion
+//#region src/storage/postgresql/core/sql/formatter/index.ts
+const pgFormatter = SQLFormatter({
+	processorsRegistry: SQLProcessorsRegistry({ from: defaultProcessorsRegistry }).register(postgreSQLColumnProcessors).register(PostgreSQLArrayProcessor, PostgreSQLExpandSQLInProcessor),
+	valueMapper: {
+		mapDate: (value) => value.toISOString().replace("T", " ").replace("Z", "+00"),
+		mapPlaceholder: (index) => `$${index + 1}`,
+		mapIdentifier: (value) => mapSQLIdentifier(value, { reservedWords: reservedMap }),
+		mapArray: (values) => values
+	}
+});
+registerFormatter("PostgreSQL", pgFormatter);
+
+//#endregion
+//#region src/storage/postgresql/core/sql/json.ts
+const pathParts = (path) => path.split(".");
+const canUseUnquotedArrayElement = (value) => /^[A-Za-z0-9_$]+$/.test(value);
+const arrayElement = (value) => canUseUnquotedArrayElement(value) ? value : `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
+const pathArrayLiteral = (values) => {
+	const arrayValue = `{${values.map(arrayElement).join(",")}}`;
+	return SQL.literal(arrayValue).value;
+};
+const path = (path) => SQL.plain(pathArrayLiteral(pathParts(path)));
+const field = (source, path) => {
+	const parts = pathParts(path);
+	return parts.length === 1 ? SQL`${source} -> ${SQL.literal(parts[0])}` : SQL`${source} #> ${PostgreSQLJSON.path(path)}`;
+};
+const textField = (source, path) => {
+	const parts = pathParts(path);
+	return parts.length === 1 ? SQL`${source} ->> ${SQL.literal(parts[0])}` : SQL`${source} #>> ${PostgreSQLJSON.path(path)}`;
+};
+const PostgreSQLJSON = {
+	field,
+	path,
+	textField
+};
+
+//#endregion
+//#region src/storage/postgresql/core/index.ts
+const PostgreSQLDatabaseName = "PostgreSQL";
+
+//#endregion
 //#region src/storage/postgresql/pg/execute/execute.ts
 const isPgNativePool = (poolOrClient) => {
 	return poolOrClient instanceof pg.Pool;
@@ -87,57 +2111,92 @@ async function batchCommand(client, sqls, serializer, options) {
 
 //#endregion
 //#region src/storage/postgresql/pg/connections/transaction.ts
-const pgTransaction = (connection, serializer) => (getClient, options) => ({
-	connection: connection(),
-	driverType: PgDriverType,
-	begin: async () => {
-		const client = await getClient;
-		const parts = ["BEGIN"];
-		if (options?.isolationLevel) parts.push(`ISOLATION LEVEL ${options.isolationLevel}`);
-		if (options?.readonly) parts.push("READ ONLY");
-		await client.query(parts.join(" "));
-	},
-	commit: async () => {
-		const client = await getClient;
-		try {
-			await client.query("COMMIT");
-		} finally {
-			if (options?.close) await options?.close(client);
+const pgTransaction = (connection, serializer) => (getClient, options) => {
+	const allowNestedTransactions = options?.allowNestedTransactions ?? false;
+	const tx = databaseTransaction({
+		begin: async () => {
+			const client = await getClient;
+			const parts = ["BEGIN"];
+			if (options?.isolationLevel) parts.push(`ISOLATION LEVEL ${options.isolationLevel}`);
+			if (options?.readonly) parts.push("READ ONLY");
+			await client.query(parts.join(" "));
+		},
+		commit: async () => {
+			const client = await getClient;
+			try {
+				await client.query("COMMIT");
+			} finally {
+				if (options?.close) await options.close(client);
+			}
+		},
+		rollback: async (error) => {
+			const client = await getClient;
+			try {
+				await client.query("ROLLBACK");
+			} finally {
+				if (options?.close) await options.close(client, error);
+			}
+		},
+		savepoint: async (level) => {
+			await (await getClient).query(`SAVEPOINT pg_savepoint_${level}`);
+		},
+		releaseSavepoint: async (level) => {
+			await (await getClient).query(`RELEASE SAVEPOINT pg_savepoint_${level}`);
+		},
+		rollbackToSavepoint: async (level) => {
+			await (await getClient).query(`ROLLBACK TO SAVEPOINT pg_savepoint_${level}`);
 		}
-	},
-	rollback: async (error) => {
-		const client = await getClient;
-		try {
-			await client.query("ROLLBACK");
-		} finally {
-			if (options?.close) await options?.close(client, error);
+	}, {
+		allowNestedTransactions,
+		useSavepoints: options?.useSavepoints ?? false
+	});
+	return {
+		connection: connection(),
+		driverType: PgDriverType,
+		begin: tx.begin,
+		commit: tx.commit,
+		rollback: tx.rollback,
+		execute: sqlExecutor(pgSQLExecutor({ serializer }), { connect: () => getClient }),
+		_transactionOptions: {
+			...options ?? {},
+			allowNestedTransactions
 		}
-	},
-	execute: sqlExecutor(pgSQLExecutor({ serializer }), { connect: () => getClient }),
-	_transactionOptions: options ?? {}
-});
+	};
+};
 
 //#endregion
 //#region src/storage/postgresql/pg/connections/connection.ts
 const PgDriverType = "PostgreSQL:pg";
 const pgClientConnection = (options) => {
-	const { connect, close } = options;
+	const { connect, close, transactionOptions } = options;
 	return createConnection({
 		driverType: PgDriverType,
 		connect,
 		close,
-		initTransaction: (connection) => pgTransaction(connection, options.serializer),
+		initTransaction: (connection) => {
+			const txFactory = pgTransaction(connection, options.serializer);
+			return (client, perCallOptions) => txFactory(client, {
+				...transactionOptions ?? {},
+				...perCallOptions ?? {}
+			});
+		},
 		executor: pgSQLExecutor,
 		serializer: options.serializer
 	});
 };
 const pgPoolClientConnection = (options) => {
-	const { connect, close } = options;
+	const { connect, close, transactionOptions } = options;
 	return createConnection({
 		driverType: PgDriverType,
 		connect,
 		close,
-		initTransaction: (connection) => pgTransaction(connection, options.serializer),
+		initTransaction: (connection) => {
+			const txFactory = pgTransaction(connection, options.serializer);
+			return (client, perCallOptions) => txFactory(client, {
+				...transactionOptions ?? {},
+				...perCallOptions ?? {}
+			});
+		},
 		executor: pgSQLExecutor,
 		serializer: options.serializer
 	});
@@ -176,7 +2235,7 @@ const setPgTypeParser = (client, options) => {
 //#endregion
 //#region src/storage/postgresql/pg/connections/pool.ts
 const pgNativePool = (options) => {
-	const { connectionString, database } = options;
+	const { connectionString, database, transactionOptions } = options;
 	const pool = getPgPool({
 		connectionString,
 		database
@@ -192,7 +2251,8 @@ const pgNativePool = (options) => {
 			return client;
 		},
 		close: (client) => Promise.resolve(client.release()),
-		serializer: options.serializer
+		serializer: options.serializer,
+		...transactionOptions ? { transactionOptions } : {}
 	});
 	const open = () => Promise.resolve(getConnection());
 	const close = () => endPgPool({
@@ -207,14 +2267,15 @@ const pgNativePool = (options) => {
 	});
 };
 const pgAmbientNativePool = (options) => {
-	const { pool } = options;
+	const { pool, transactionOptions } = options;
 	return createConnectionPool({
 		driverType: PgDriverType,
 		getConnection: () => pgConnection({
 			type: "PoolClient",
 			connect: () => pool.connect(),
 			close: (client) => Promise.resolve(client.release()),
-			serializer: options.serializer
+			serializer: options.serializer,
+			...transactionOptions ? { transactionOptions } : {}
 		})
 	});
 };
@@ -226,7 +2287,7 @@ const pgAmbientConnectionPool = (options) => {
 	});
 };
 const pgClientPool = (options) => {
-	const { connectionString, database } = options;
+	const { connectionString, database, transactionOptions } = options;
 	return createConnectionPool({
 		driverType: PgDriverType,
 		getConnection: () => {
@@ -246,20 +2307,22 @@ const pgClientPool = (options) => {
 				type: "Client",
 				connect,
 				close: (client) => client.end(),
-				serializer: options.serializer
+				serializer: options.serializer,
+				...transactionOptions ? { transactionOptions } : {}
 			});
 		}
 	});
 };
 const pgAmbientClientPool = (options) => {
-	const { client } = options;
+	const { client, transactionOptions } = options;
 	const getConnection = () => {
 		const connect = () => Promise.resolve(client);
 		return pgConnection({
 			type: "Client",
 			connect,
 			close: () => Promise.resolve(),
-			serializer: options.serializer
+			serializer: options.serializer,
+			...transactionOptions ? { transactionOptions } : {}
 		});
 	};
 	const open = () => Promise.resolve(getConnection());
@@ -272,26 +2335,31 @@ const pgAmbientClientPool = (options) => {
 	});
 };
 function pgPool(options) {
-	const { connectionString, database } = options;
+	const { connectionString, database, transactionOptions } = options;
 	const serializer = options.serialization?.serializer ?? JSONSerializer;
+	const txOpts = transactionOptions ? { transactionOptions } : {};
 	if ("client" in options && options.client) return pgAmbientClientPool({
 		client: options.client,
-		serializer
+		serializer,
+		...txOpts
 	});
 	if ("connection" in options && options.connection) return pgAmbientConnectionPool({ connection: options.connection });
 	if ("pooled" in options && options.pooled === false) return pgClientPool({
 		connectionString,
 		database,
-		serializer
+		serializer,
+		...txOpts
 	});
 	if ("pool" in options && options.pool) return pgAmbientNativePool({
 		pool: options.pool,
-		serializer
+		serializer,
+		...txOpts
 	});
 	return pgNativePool({
 		connectionString,
 		database,
-		serializer
+		serializer,
+		...txOpts
 	});
 }
 const pools = /* @__PURE__ */ new Map();