@atscript/db-mysql 0.1.39 → 0.1.40

package/dist/index.mjs

@@ -1,14 +1,19 @@
+import { t as MysqlPlugin } from "./plugin-3jLlPI4f.mjs";
 import { AtscriptDbView, BaseDbAdapter, DbError, DbSpace } from "@atscript/db";
 import { buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildSelect, buildUpdate, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, refActionToSql, toSqlValue } from "@atscript/db-sql-tools";
-import { AnnotationSpec } from "@atscript/core";
-
-//#region packages/db-mysql/src/sql-builder.ts
+//#region src/sql-builder.ts
+/** Escapes a MySQL identifier by doubling backticks. */
 function esc(name) {
 	return name.replace(/`/g, "``");
 }
+/** Backtick-quotes a single identifier. */
 function qi(name) {
 	return `\`${esc(name)}\``;
 }
+/**
+* Backtick-quotes a table name, handling `schema.table` format.
+* Input is a raw name like `mydb.users` or just `users`.
+*/
 function quoteTableName(name) {
 	const dot = name.indexOf(".");
 	if (dot >= 0) return `${qi(name.slice(0, dot))}.${qi(name.slice(dot + 1))}`;
@@ -24,7 +29,7 @@ const mysqlDialect = {
 	unlimitedLimit: "18446744073709551615",
 	toValue: toSqlValue,
 	toParam(value) {
-		if (value === undefined) return null;
+		if (value === void 0) return null;
 		return typeof value === "boolean" ? value ? 1 : 0 : value;
 	},
 	regex(quotedCol, value) {
@@ -36,27 +41,51 @@ const mysqlDialect = {
 	},
 	createViewPrefix: "CREATE OR REPLACE VIEW"
 };
+/**
+* Builds an INSERT statement.
+*/
 function buildInsert$1(table, data) {
 	return buildInsert(mysqlDialect, table, data);
 }
+/**
+* Builds a SELECT statement with optional sort, limit, offset, projection.
+*/
 function buildSelect$1(table, where, controls) {
 	return buildSelect(mysqlDialect, table, where, controls);
 }
-function buildUpdate$1(table, data, where, limit) {
-	return buildUpdate(mysqlDialect, table, data, where, limit);
+/**
+* Builds an UPDATE ... SET ... WHERE statement with optional LIMIT.
+*/
+function buildUpdate$1(table, data, where, limit, ops) {
+	return buildUpdate(mysqlDialect, table, data, where, limit, ops);
 }
+/**
+* Builds a DELETE ... WHERE statement with optional LIMIT.
+*/
 function buildDelete$1(table, where, limit) {
 	return buildDelete(mysqlDialect, table, where, limit);
 }
+/**
+* Builds a CREATE OR REPLACE VIEW statement from a view plan and column mappings.
+*/
 function buildCreateView$1(viewName, plan, columns, resolveFieldRef) {
 	return buildCreateView(mysqlDialect, viewName, plan, columns, resolveFieldRef);
 }
+/**
+* Builds a SELECT ... GROUP BY statement with aggregate functions.
+*/
 function buildAggregateSelect$1(table, where, controls) {
 	return buildAggregateSelect(mysqlDialect, table, where, controls);
 }
+/**
+* Builds a COUNT query for the number of distinct groups.
+*/
 function buildAggregateCount$1(table, where, controls) {
 	return buildAggregateCount(mysqlDialect, table, where, controls);
 }
+/**
+* Maps portable collation values to MySQL collation names.
+*/
 function collationToMysql(collation) {
 	switch (collation) {
 		case "binary": return "utf8mb4_bin";
@@ -74,7 +103,8 @@ function collationToMysql(collation) {
 * For FK fields, delegates to the target PK's type via `field.fkTargetField`
 * so the FK column type always matches the referenced column.
 */
-/** Maps integer primitive tags to MySQL integer types. */ function intTypeFromTags(tags, unsigned) {
+/** Maps integer primitive tags to MySQL integer types. */
+function intTypeFromTags(tags, unsigned) {
 	if (tags?.has("int8")) return unsigned ? "TINYINT UNSIGNED" : "TINYINT";
 	if (tags?.has("uint8") || tags?.has("byte")) return "TINYINT UNSIGNED";
 	if (tags?.has("int16")) return unsigned ? "SMALLINT UNSIGNED" : "SMALLINT";
@@ -94,36 +124,36 @@ function mysqlTypeFromField(field) {
 	const unsigned = metadata?.has("db.mysql.unsigned") ?? false;
 	const precision = metadata?.get("db.column.precision");
 	switch (field.designType) {
-		case "number": {
+		case "number":
 			if (precision) return `DECIMAL(${precision.precision},${precision.scale})`;
 			if (field.defaultValue?.kind === "fn" && field.defaultValue.fn === "increment") return unsigned ? "BIGINT UNSIGNED" : "BIGINT";
 			if (field.defaultValue?.kind === "fn" && field.defaultValue.fn === "now") return "TIMESTAMP";
 			if (tags?.has("int")) return intTypeFromTags(tags, unsigned);
 			return "DOUBLE";
-		}
 		case "integer": return intTypeFromTags(tags, unsigned);
-		case "decimal": {
+		case "decimal":
 			if (precision) return `DECIMAL(${precision.precision},${precision.scale})`;
 			return "DECIMAL(10,2)";
-		}
 		case "boolean": return "TINYINT(1)";
 		case "string": {
 			if (tags?.has("char")) return "CHAR(1)";
-			const maxLen = metadata?.get("expect.maxLength")?.length;
-			if (maxLen !== undefined && maxLen <= 65535) return `VARCHAR(${maxLen})`;
-			if (maxLen !== undefined && maxLen > 65535) return "LONGTEXT";
+			const maxLen = (metadata?.get("expect.maxLength"))?.length;
+			if (maxLen !== void 0 && maxLen <= 65535) return `VARCHAR(${maxLen})`;
+			if (maxLen !== void 0 && maxLen > 65535) return "LONGTEXT";
 			if (field.isPrimaryKey || field.defaultValue) return "VARCHAR(255)";
 			return "TEXT";
 		}
 		case "json":
 		case "object":
 		case "array": return "JSON";
-		default: {
+		default:
 			if (field.isPrimaryKey || field.defaultValue) return "VARCHAR(255)";
 			return "TEXT";
-		}
 	}
 }
+/**
+* Builds a CREATE TABLE IF NOT EXISTS statement with MySQL options.
+*/
 function buildCreateTable(table, fields, foreignKeys, options) {
 	const colDefs = [];
 	const primaryKeys = fields.filter((f) => f.isPrimaryKey);
@@ -134,13 +164,13 @@ function buildCreateTable(table, fields, foreignKeys, options) {
 		if (options?.incrementFields?.has(field.physicalName)) def += " AUTO_INCREMENT";
 		if (!field.optional && !field.isPrimaryKey && !options?.incrementFields?.has(field.physicalName)) def += " NOT NULL";
 		if (field.defaultValue?.kind === "value") def += ` DEFAULT ${defaultValueToSqlLiteral(field.designType, field.defaultValue.value)}`;
-else if (field.defaultValue?.kind === "fn") {
+		else if (field.defaultValue?.kind === "fn") {
 			if (field.defaultValue.fn === "uuid") def += " DEFAULT (UUID())";
-else if (field.defaultValue.fn === "now") def += " DEFAULT CURRENT_TIMESTAMP";
+			else if (field.defaultValue.fn === "now") def += " DEFAULT CURRENT_TIMESTAMP";
 		}
 		const nativeCollate = field.type?.metadata?.get("db.mysql.collate");
 		if (nativeCollate) def += ` COLLATE ${nativeCollate}`;
-else if (field.collate) def += ` COLLATE ${collationToMysql(field.collate)}`;
+		else if (field.collate) def += ` COLLATE ${collationToMysql(field.collate)}`;
 		const onUpdate = options?.onUpdateFields?.get(field.physicalName);
 		if (onUpdate) def += ` ON UPDATE ${onUpdate}`;
 		colDefs.push(def);
@@ -168,28 +198,23 @@ else if (field.collate) def += ` COLLATE ${collationToMysql(field.collate)}`;
 	const charset = options?.charset ?? "utf8mb4";
 	const collation = options?.collation ?? "utf8mb4_unicode_ci";
 	sql += ` ENGINE=${engine} DEFAULT CHARSET=${charset} COLLATE=${collation}`;
-	if (options?.autoIncrementStart !== undefined) sql += ` AUTO_INCREMENT=${options.autoIncrementStart}`;
+	if (options?.autoIncrementStart !== void 0) sql += ` AUTO_INCREMENT=${options.autoIncrementStart}`;
 	return sql;
 }
-
 //#endregion
-//#region packages/db-mysql/src/filter-builder.ts
+//#region src/filter-builder.ts
+/**
+* Translates a uniqu filter expression into a parameterized MySQL WHERE clause.
+*
+* @returns `{ sql, params }` — the WHERE clause (without "WHERE") and bound params.
+*          Returns `{ sql: '1=1', params: [] }` for empty/null filters.
+*/
 function buildWhere(filter) {
 	return buildWhere$1(mysqlDialect, filter);
 }
-
 //#endregion
-//#region packages/db-mysql/src/mysql-adapter.ts
-function _define_property$1(obj, key, value) {
-	if (key in obj) Object.defineProperty(obj, key, {
-		value,
-		enumerable: true,
-		configurable: true,
-		writable: true
-	});
-else obj[key] = value;
-	return obj;
-}
+//#region src/mysql-adapter.ts
+/** Parses a MySQL UTC datetime string ('YYYY-MM-DD HH:MM:SS') to epoch ms. Returns the original value if parsing fails. */
 function utcDatetimeToEpochMs(value) {
 	if (typeof value === "number") return value;
 	if (value instanceof Date) return value.getTime();
@@ -199,14 +224,50 @@ function utcDatetimeToEpochMs(value) {
 	}
 	return value;
 }
-/** Formats epoch ms as 'YYYY-MM-DD HH:MM:SS' in UTC for MySQL TIMESTAMP columns. */ function epochMsToUtcDatetime(ms) {
+/** Formats epoch ms as 'YYYY-MM-DD HH:MM:SS' in UTC for MySQL TIMESTAMP columns. */
+function epochMsToUtcDatetime(ms) {
 	const d = new Date(ms);
 	return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, "0")}-${String(d.getUTCDate()).padStart(2, "0")} ${String(d.getUTCHours()).padStart(2, "0")}:${String(d.getUTCMinutes()).padStart(2, "0")}:${String(d.getUTCSeconds()).padStart(2, "0")}`;
 }
+/**
+* MySQL adapter for {@link AtscriptDbTable}.
+*
+* Accepts any {@link TMysqlDriver} implementation — the actual MySQL driver
+* is fully swappable (mysql2/promise pool, custom implementations, etc.).
+*
+* Usage:
+* ```typescript
+* import { Mysql2Driver, MysqlAdapter } from '@atscript/db-mysql'
+* import { DbSpace } from '@atscript/db'
+*
+* const driver = new Mysql2Driver('mysql://root@localhost:3306/mydb')
+* const space = new DbSpace(() => new MysqlAdapter(driver))
+* const users = space.getTable(UsersType)
+* ```
+*/
 var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
-	/** Schema name for INFORMATION_SCHEMA queries (null falls through to DATABASE()). */ get _schema() {
+	supportsColumnModify = true;
+	static NATIVE_DEFAULT_FNS = new Set(["now", "increment"]);
+	_engine = "InnoDB";
+	_charset = "utf8mb4";
+	_collation = "utf8mb4_unicode_ci";
+	_autoIncrementStart;
+	_incrementFields = /* @__PURE__ */ new Set();
+	_onUpdateFields = /* @__PURE__ */ new Map();
+	/** Whether the connected MySQL instance supports native VECTOR type (MySQL 9.0+). */
+	_supportsVector;
+	/** Vector fields: physical field name → { dimensions, similarity, indexName }. */
+	_vectorFields = /* @__PURE__ */ new Map();
+	/** Default similarity thresholds per vector field (from @db.search.vector.threshold). */
+	_vectorThresholds = /* @__PURE__ */ new Map();
+	/** Schema name for INFORMATION_SCHEMA queries (null falls through to DATABASE()). */
+	get _schema() {
 		return this._table.schema ?? null;
 	}
+	constructor(driver) {
+		super();
+		this.driver = driver;
+	}
 	async _beginTransaction() {
 		const conn = await this.driver.getConnection();
 		await conn.exec("START TRANSACTION");
@@ -234,11 +295,12 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	/**
 	* Returns the active executor: dedicated connection if inside a transaction,
 	* otherwise the pool-based driver.
-	*/ _exec() {
-		const txState = this._getTransactionState();
-		return txState ?? this.driver;
+	*/
+	_exec() {
+		return this._getTransactionState() ?? this.driver;
 	}
-	/** MySQL InnoDB enforces FK constraints natively. */ supportsNativeForeignKeys() {
+	/** MySQL InnoDB enforces FK constraints natively. */
+	supportsNativeForeignKeys() {
 		return true;
 	}
 	prepareId(id, _fieldType) {
@@ -250,8 +312,8 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	nativeDefaultFns() {
 		return MysqlAdapter.NATIVE_DEFAULT_FNS;
 	}
-	onBeforeFlatten(type) {
-		const meta = type.metadata;
+	onBeforeFlatten(_type) {
+		const meta = _type.metadata;
 		const engine = meta.get("db.mysql.engine");
 		if (engine) this._engine = engine;
 		const charset = meta.get("db.mysql.charset");
@@ -276,7 +338,7 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 				indexName
 			});
 			const threshold = metadata.get("db.search.vector.threshold");
-			if (threshold !== undefined) this._vectorThresholds.set(indexName, threshold);
+			if (threshold !== void 0) this._vectorThresholds.set(indexName, threshold);
 		}
 	}
 	getDesiredTableOptions() {
@@ -320,18 +382,15 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		const tableName = this.resolveTableName();
 		const clauses = [];
 		for (const change of changes) switch (change.key) {
-			case "engine": {
+			case "engine":
 				clauses.push(`ENGINE = ${change.newValue}`);
 				break;
-			}
-			case "charset": {
+			case "charset":
 				clauses.push(`CHARACTER SET = ${change.newValue}`);
 				break;
-			}
-			case "collation": {
+			case "collation":
 				clauses.push(`COLLATE = ${change.newValue}`);
 				break;
-			}
 		}
 		if (clauses.length > 0) {
 			const ddl = `ALTER TABLE ${quoteTableName(tableName)} ${clauses.join(", ")}`;
@@ -343,12 +402,12 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	* Returns a value formatter for TIMESTAMP-mapped fields.
 	* Number fields with @db.default.now map to MySQL TIMESTAMP — the formatter
 	* converts epoch ms to a UTC datetime string for the wire protocol.
-	*/ formatValue(field) {
+	*/
+	formatValue(field) {
 		if (field.designType === "number" && field.defaultValue?.kind === "fn" && field.defaultValue.fn === "now") return {
 			toStorage: (value) => typeof value === "number" ? epochMsToUtcDatetime(value) : value,
 			fromStorage: utcDatetimeToEpochMs
 		};
-		return undefined;
 	}
 	/**
 	* Wraps an async write operation to catch MySQL constraint errors
@@ -358,24 +417,18 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	* - 1062 = ER_DUP_ENTRY (unique constraint violation)
 	* - 1451 = ER_ROW_IS_REFERENCED_2 (FK violation on delete)
 	* - 1452 = ER_NO_REFERENCED_ROW_2 (FK violation on insert/update)
-	*/ async _wrapConstraintError(fn) {
+	*/
+	async _wrapConstraintError(fn) {
 		try {
 			return await fn();
 		} catch (error) {
 			if (error && typeof error === "object" && "errno" in error) {
 				const err = error;
-				if (err.errno === 1062) {
-					const match = err.message?.match(/for key '(?:\w+\.)?(\w+)'/);
-					const field = match?.[1] ?? "";
-					throw new DbError("CONFLICT", [{
-						path: field,
-						message: err.sqlMessage ?? err.message
-					}]);
-				}
-				if (err.errno === 1451 || err.errno === 1452) {
-					const errors = this._mapFkError(err.message);
-					throw new DbError("FK_VIOLATION", errors);
-				}
+				if (err.errno === 1062) throw new DbError("CONFLICT", [{
+					path: (err.message?.match(/for key '(?:\w+\.)?(\w+)'/))?.[1] ?? "",
+					message: err.sqlMessage ?? err.message
+				}]);
+				if (err.errno === 1451 || err.errno === 1452) throw new DbError("FK_VIOLATION", this._mapFkError(err.message));
 			}
 			throw error;
 		}
@@ -384,9 +437,8 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		const fkMatch = message.match(/FOREIGN KEY \(`(\w+)`\)/);
 		if (fkMatch) {
 			const physicalCol = fkMatch[1];
-			const field = this._table.fieldDescriptors.find((f) => f.physicalName === physicalCol);
 			return [{
-				path: field?.path ?? physicalCol,
+				path: this._table.fieldDescriptors.find((f) => f.physicalName === physicalCol)?.path ?? physicalCol,
 				message
 			}];
 		}
@@ -453,28 +505,25 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	}
 	async count(query) {
 		const where = buildWhere(query.filter);
-		const tableName = this.resolveTableName();
-		const sql = `SELECT COUNT(*) as cnt FROM ${quoteTableName(tableName)} WHERE ${where.sql}`;
+		const sql = `SELECT COUNT(*) as cnt FROM ${quoteTableName(this.resolveTableName())} WHERE ${where.sql}`;
 		this._log(sql, where.params);
-		const row = await this._exec().get(sql, where.params);
-		return row?.cnt ?? 0;
+		return (await this._exec().get(sql, where.params))?.cnt ?? 0;
 	}
 	async aggregate(query) {
 		const where = buildWhere(query.filter);
 		const tableName = this.resolveTableName();
 		if (query.controls.$count) {
-			const { sql: sql$1, params: params$1 } = buildAggregateCount$1(tableName, where, query.controls);
-			this._log(sql$1, params$1);
-			const row = await this._exec().get(sql$1, params$1);
-			return [{ count: row?.count ?? 0 }];
+			const { sql, params } = buildAggregateCount$1(tableName, where, query.controls);
+			this._log(sql, params);
+			return [{ count: (await this._exec().get(sql, params))?.count ?? 0 }];
 		}
 		const { sql, params } = buildAggregateSelect$1(tableName, where, query.controls);
 		this._log(sql, params);
 		return this._exec().all(sql, params);
 	}
-	async updateOne(filter, data) {
+	async updateOne(filter, data, ops) {
 		const where = buildWhere(filter);
-		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where, 1);
+		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where, 1, ops);
 		this._log(sql, params);
 		const result = await this._wrapConstraintError(() => this._exec().run(sql, params));
 		return {
@@ -482,9 +531,9 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 			modifiedCount: result.changedRows
 		};
 	}
-	async updateMany(filter, data) {
+	async updateMany(filter, data, ops) {
 		const where = buildWhere(filter);
-		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where);
+		const { sql, params } = buildUpdate$1(this.resolveTableName(), data, where, void 0, ops);
 		this._log(sql, params);
 		const result = await this._wrapConstraintError(() => this._exec().run(sql, params));
 		return {
@@ -516,18 +565,16 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		const where = buildWhere(filter);
 		const { sql, params } = buildDelete$1(this.resolveTableName(), where, 1);
 		this._log(sql, params);
-		const result = await this._wrapConstraintError(() => this._exec().run(sql, params));
-		return { deletedCount: result.affectedRows };
+		return { deletedCount: (await this._wrapConstraintError(() => this._exec().run(sql, params))).affectedRows };
 	}
 	async deleteMany(filter) {
 		const where = buildWhere(filter);
 		const { sql, params } = buildDelete$1(this.resolveTableName(), where);
 		this._log(sql, params);
-		const result = await this._wrapConstraintError(() => this._exec().run(sql, params));
-		return { deletedCount: result.affectedRows };
+		return { deletedCount: (await this._wrapConstraintError(() => this._exec().run(sql, params))).affectedRows };
 	}
 	async ensureTable() {
-		if (this._supportsVector === undefined && this._vectorFields.size > 0) await this._detectVectorSupport();
+		if (this._supportsVector === void 0 && this._vectorFields.size > 0) await this._detectVectorSupport();
 		if (this._table instanceof AtscriptDbView) return this._ensureView();
 		const sql = buildCreateTable(this.resolveTableName(), this._table.fieldDescriptors, this._table.foreignKeys, {
 			engine: this._engine,
@@ -551,11 +598,10 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	}
 	async getExistingColumnsForTable(tableName) {
 		const schema = this._schema;
-		const rows = await this._exec().all(`SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_KEY, COLUMN_DEFAULT
+		return (await this._exec().all(`SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_KEY, COLUMN_DEFAULT
        FROM INFORMATION_SCHEMA.COLUMNS
        WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
-       ORDER BY ORDINAL_POSITION`, [tableName, schema]);
-		return rows.map((r) => ({
+       ORDER BY ORDINAL_POSITION`, [tableName, schema])).map((r) => ({
 			name: r.COLUMN_NAME,
 			type: r.COLUMN_TYPE.toUpperCase(),
 			notnull: r.IS_NULLABLE === "NO",
@@ -578,7 +624,7 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 			let ddl = `ALTER TABLE ${quoteTableName(tableName)} ADD COLUMN ${qi(field.physicalName)} ${sqlType}`;
 			if (!field.optional && !field.isPrimaryKey) ddl += " NOT NULL";
 			if (field.defaultValue?.kind === "value") ddl += ` DEFAULT ${defaultValueToSqlLiteral(field.designType, field.defaultValue.value)}`;
-else if (!field.optional && !field.isPrimaryKey) ddl += ` DEFAULT ${defaultValueForType(field.designType)}`;
+			else if (!field.optional && !field.isPrimaryKey) ddl += ` DEFAULT ${defaultValueForType(field.designType)}`;
 			if (field.collate) {
 				const nativeCollate = field.type?.metadata?.get("db.mysql.collate");
 				ddl += ` COLLATE ${nativeCollate ?? collationToMysql(field.collate)}`;
@@ -606,8 +652,8 @@ else if (!field.optional && !field.isPrimaryKey) ddl += ` DEFAULT ${defaultValue
 			let ddl = `ALTER TABLE ${quoteTableName(tableName)} MODIFY COLUMN ${qi(field.physicalName)} ${sqlType}`;
 			if (!field.optional && !field.isPrimaryKey) ddl += " NOT NULL";
 			if (field.defaultValue?.kind === "value") ddl += ` DEFAULT ${defaultValueToSqlLiteral(field.designType, field.defaultValue.value)}`;
-else if (field.defaultValue?.kind === "fn") ddl += ` DEFAULT ${field.defaultValue.fn === "now" ? "CURRENT_TIMESTAMP" : field.defaultValue.fn === "uuid" ? "(UUID())" : `(${field.defaultValue.fn}())`}`;
-else ddl += " DEFAULT NULL";
+			else if (field.defaultValue?.kind === "fn") ddl += ` DEFAULT ${field.defaultValue.fn === "now" ? "CURRENT_TIMESTAMP" : field.defaultValue.fn === "uuid" ? "(UUID())" : `(${field.defaultValue.fn}())`}`;
+			else ddl += " DEFAULT NULL";
 			this._log(ddl);
 			await this._exec().exec(ddl);
 		}
@@ -717,10 +763,7 @@ else ddl += " DEFAULT NULL";
 				const fulltext = index.type === "fulltext" ? "FULLTEXT " : "";
 				const isFulltext = index.type === "fulltext";
 				const cols = index.fields.map((f) => {
-					const col = qi(f.name);
-					const prefix = !isFulltext && stringFields.has(f.name) ? "(255)" : "";
-					const order = isFulltext ? "" : ` ${f.sort === "desc" ? "DESC" : "ASC"}`;
-					return `${col}${prefix}${order}`;
+					return `${qi(f.name)}${!isFulltext && stringFields.has(f.name) ? "(255)" : ""}${isFulltext ? "" : ` ${f.sort === "desc" ? "DESC" : "ASC"}`}`;
 				}).join(", ");
 				const sql = `CREATE ${fulltext}${unique}INDEX ${qi(index.key)} ON ${quoteTableName(this.resolveTableName())} (${cols})`;
 				this._log(sql);
@@ -735,19 +778,19 @@ else ddl += " DEFAULT NULL";
 	}
 	async syncForeignKeys() {
 		const existingByName = await this._getExistingFkConstraints();
-		const desiredFkKeys = new Set();
-		for (const fk of this._table.foreignKeys.values()) desiredFkKeys.add([...fk.fields].sort().join(","));
+		const desiredFkKeys = /* @__PURE__ */ new Set();
+		for (const fk of this._table.foreignKeys.values()) desiredFkKeys.add([...fk.fields].toSorted().join(","));
 		for (const [constraintName, columns] of existingByName) {
-			const key = columns.sort().join(",");
+			const key = columns.toSorted().join(",");
 			if (!desiredFkKeys.has(key)) {
 				const ddl = `ALTER TABLE ${quoteTableName(this.resolveTableName())} DROP FOREIGN KEY ${qi(constraintName)}`;
 				this._log(ddl);
 				await this._exec().exec(ddl);
 			}
 		}
-		const existingKeys = new Set([...existingByName.values()].map((cols) => cols.sort().join(",")));
+		const existingKeys = new Set([...existingByName.values()].map((cols) => cols.toSorted().join(",")));
 		for (const fk of this._table.foreignKeys.values()) {
-			const key = [...fk.fields].sort().join(",");
+			const key = [...fk.fields].toSorted().join(",");
 			if (!existingKeys.has(key)) {
 				const localCols = fk.fields.map((f) => qi(f)).join(", ");
 				const targetCols = fk.targetFields.map((f) => qi(f)).join(", ");
@@ -764,7 +807,7 @@ else ddl += " DEFAULT NULL";
 		const keySet = new Set(fkFieldKeys);
 		const existingByName = await this._getExistingFkConstraints();
 		for (const [constraintName, cols] of existingByName) {
-			const key = cols.sort().join(",");
+			const key = cols.toSorted().join(",");
 			if (keySet.has(key)) {
 				const ddl = `ALTER TABLE ${quoteTableName(this.resolveTableName())} DROP FOREIGN KEY ${qi(constraintName)}`;
 				this._log(ddl);
@@ -772,12 +815,13 @@ else ddl += " DEFAULT NULL";
 			}
 		}
 	}
-	/** Queries INFORMATION_SCHEMA for existing FK constraints, grouped by constraint name → column names. */ async _getExistingFkConstraints() {
+	/** Queries INFORMATION_SCHEMA for existing FK constraints, grouped by constraint name → column names. */
+	async _getExistingFkConstraints() {
 		const rows = await this._exec().all(`SELECT kcu.CONSTRAINT_NAME, kcu.COLUMN_NAME
        FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE kcu
        WHERE kcu.TABLE_NAME = ? AND kcu.TABLE_SCHEMA = COALESCE(?, DATABASE())
          AND kcu.REFERENCED_TABLE_NAME IS NOT NULL`, [this._table.tableName, this._schema]);
-		const byName = new Map();
+		const byName = /* @__PURE__ */ new Map();
 		for (const row of rows) {
 			let cols = byName.get(row.CONSTRAINT_NAME);
 			if (!cols) {
@@ -819,8 +863,7 @@ else ddl += " DEFAULT NULL";
 		const countPromise = (async () => {
 			const sql = `SELECT COUNT(*) as cnt FROM ${quoteTableName(tableName)} WHERE ${combinedWhere.sql}`;
 			this._log(sql, combinedWhere.params);
-			const row = await this._exec().get(sql, combinedWhere.params);
-			return row?.cnt ?? 0;
+			return (await this._exec().get(sql, combinedWhere.params))?.cnt ?? 0;
 		})();
 		const [data, count] = await Promise.all([selectPromise, countPromise]);
 		return {
@@ -843,14 +886,14 @@ else ddl += " DEFAULT NULL";
 		for (const index of this._table.indexes.values()) if (index.type === "fulltext") {
 			if (!indexName || index.key === indexName) return index;
 		}
-		return undefined;
 	}
 	/**
 	* Detects native VECTOR type support by inspecting the server version.
 	* MySQL 9.0+ supports the VECTOR column type natively.
 	* Caches the result for the lifetime of this adapter instance.
-	*/ async _detectVectorSupport() {
-		if (this._supportsVector !== undefined) return this._supportsVector;
+	*/
+	async _detectVectorSupport() {
+		if (this._supportsVector !== void 0) return this._supportsVector;
 		try {
 			const row = await this.driver.get("SELECT VERSION() as v", []);
 			if (row?.v) {
@@ -885,7 +928,8 @@ else ddl += " DEFAULT NULL";
 			count: countRow?.cnt ?? 0
 		};
 	}
-	/** Resolves vector field and computes shared context for vector search SQL builders. */ _prepareVectorSearch(vector, query, indexName) {
+	/** Resolves vector field and computes shared context for vector search SQL builders. */
+	_prepareVectorSearch(vector, query, indexName) {
 		let field;
 		let vec;
 		if (indexName) {
@@ -923,13 +967,13 @@ else ddl += " DEFAULT NULL";
 		const inner = `SELECT *, ${ctx.distanceFn}(${qi(ctx.field)}, STRING_TO_VECTOR(?)) AS _distance FROM ${quoteTableName(ctx.tableName)} WHERE ${ctx.where.sql}`;
 		const params = [ctx.vectorStr, ...ctx.where.params];
 		let sql = `SELECT * FROM (${inner}) _v`;
-		if (ctx.threshold !== undefined) {
+		if (ctx.threshold !== void 0) {
 			sql += ` WHERE _distance <= ?`;
 			params.push(2 * (1 - ctx.threshold));
 		}
 		sql += ` ORDER BY _distance ASC`;
-		if (ctx.controls.$skip) sql += ` LIMIT ${ctx.controls.$limit || 1e3} OFFSET ${ctx.controls.$skip}`;
-else sql += ` LIMIT ${ctx.controls.$limit || 20}`;
+		if (ctx.controls.$skip) sql += ` LIMIT ${Number(ctx.controls.$limit) || 1e3} OFFSET ${Number(ctx.controls.$skip)}`;
+		else sql += ` LIMIT ${Number(ctx.controls.$limit) || 20}`;
 		return {
 			sql,
 			params
@@ -940,7 +984,7 @@ else sql += ` LIMIT ${ctx.controls.$limit || 20}`;
 		const inner = `SELECT ${ctx.distanceFn}(${qi(ctx.field)}, STRING_TO_VECTOR(?)) AS _distance FROM ${quoteTableName(ctx.tableName)} WHERE ${ctx.where.sql}`;
 		const params = [ctx.vectorStr, ...ctx.where.params];
 		let sql = `SELECT COUNT(*) AS cnt FROM (${inner}) _v`;
-		if (ctx.threshold !== undefined) {
+		if (ctx.threshold !== void 0) {
 			sql += ` WHERE _distance <= ?`;
 			params.push(2 * (1 - ctx.threshold));
 		}
@@ -949,16 +993,13 @@ else sql += ` LIMIT ${ctx.controls.$limit || 20}`;
 			params
 		};
 	}
-	/** Resolves threshold: query-time $threshold > schema-level @db.search.vector.threshold. */ _resolveVectorThreshold(controls, indexName) {
+	/** Resolves threshold: query-time $threshold > schema-level @db.search.vector.threshold. */
+	_resolveVectorThreshold(controls, indexName) {
 		const queryThreshold = controls.$threshold;
-		if (queryThreshold !== undefined) return queryThreshold;
+		if (queryThreshold !== void 0) return queryThreshold;
 		return this._vectorThresholds.get(indexName);
 	}
-	constructor(driver) {
-		super(), _define_property$1(this, "driver", void 0), _define_property$1(this, "supportsColumnModify", void 0), _define_property$1(this, "_engine", void 0), _define_property$1(this, "_charset", void 0), _define_property$1(this, "_collation", void 0), _define_property$1(this, "_autoIncrementStart", void 0), _define_property$1(this, "_incrementFields", void 0), _define_property$1(this, "_onUpdateFields", void 0), _define_property$1(this, "_supportsVector", void 0), _define_property$1(this, "_vectorFields", void 0), _define_property$1(this, "_vectorThresholds", void 0), this.driver = driver, this.supportsColumnModify = true, this._engine = "InnoDB", this._charset = "utf8mb4", this._collation = "utf8mb4_unicode_ci", this._incrementFields = new Set(), this._onUpdateFields = new Map(), this._vectorFields = new Map(), this._vectorThresholds = new Map();
-	}
 };
-_define_property$1(MysqlAdapter, "NATIVE_DEFAULT_FNS", new Set(["now", "increment"]));
 /**
 * Normalizes MySQL INFORMATION_SCHEMA.COLUMNS.COLUMN_DEFAULT values
 * to match the format produced by `serializeDefaultValue()`.
@@ -967,47 +1008,41 @@ _define_property$1(MysqlAdapter, "NATIVE_DEFAULT_FNS", new Set(["now", "incremen
 * `uuid()`), but the diff engine compares against serialized form (`fn:now`,
 * `fn:uuid`). Without normalization, every table with function defaults
 * produces phantom ALTER diffs on re-plan.
-*/ function normalizeMysqlDefault(value) {
-	if (value === null) return undefined;
+*/
+function normalizeMysqlDefault(value) {
+	if (value === null) return;
 	const lower = value.toLowerCase();
 	if (lower === "current_timestamp" || lower === "current_timestamp()") return "fn:now";
 	if (lower === "uuid()") return "fn:uuid";
 	if (value.startsWith("'") && value.endsWith("'")) return value.slice(1, -1).replace(/''/g, "'");
 	return value;
 }
-/** Maps generic similarity metric to MySQL 9+ distance function name. */ function similarityToMysqlFn(similarity) {
+/** Maps generic similarity metric to MySQL 9+ distance function name. */
+function similarityToMysqlFn(similarity) {
 	switch (similarity) {
 		case "euclidean": return "VEC_DISTANCE_EUCLIDEAN";
 		case "dotProduct": return "VEC_DISTANCE_DOT";
 		default: return "VEC_DISTANCE_COSINE";
 	}
 }
-/** Formats a number[] vector as MySQL's STRING_TO_VECTOR input: '[1.0, 2.0, ...]'. */ function vectorToString(vector) {
+/** Formats a number[] vector as MySQL's STRING_TO_VECTOR input: '[1.0, 2.0, ...]'. */
+function vectorToString(vector) {
 	return `[${vector.join(",")}]`;
 }
-
 //#endregion
-//#region packages/db-mysql/src/mysql2-driver.ts
-function _define_property(obj, key, value) {
-	if (key in obj) Object.defineProperty(obj, key, {
-		value,
-		enumerable: true,
-		configurable: true,
-		writable: true
-	});
-else obj[key] = value;
-	return obj;
-}
-/** mysql2 rejects `undefined` in bind arrays — coerce to `null`. */ function sanitizeParams(params) {
+//#region src/mysql2-driver.ts
+/** mysql2 rejects `undefined` in bind arrays — coerce to `null`. */
+function sanitizeParams(params) {
 	if (!params) return [];
-	return params.map((v) => v === undefined ? null : v);
+	return params.map((v) => v === void 0 ? null : v);
 }
 /**
 * Custom type-casting for mysql2 result columns to maintain cross-adapter consistency.
 *
 * - TIMESTAMP/DATETIME → epoch milliseconds (number) instead of Date objects
 * - DECIMAL/NEWDECIMAL → number instead of string
-*/ function atscriptTypeCast(field, next) {
+*/
+function atscriptTypeCast(field, next) {
 	if (field.type === "TIMESTAMP" || field.type === "DATETIME") {
 		const str = field.string();
 		if (str === null) return null;
@@ -1019,13 +1054,66 @@ else obj[key] = value;
 	}
 	return next();
 }
+/**
+* {@link TMysqlDriver} implementation backed by `mysql2/promise`.
+*
+* Accepts a connection URI string, a `PoolOptions` object, or a pre-created
+* `Pool` instance from `mysql2/promise`.
+*
+* ```typescript
+* import { Mysql2Driver } from '@atscript/db-mysql'
+*
+* // Connection URI
+* const driver = new Mysql2Driver('mysql://root:pass@localhost:3306/mydb')
+*
+* // Pool options
+* const driver = new Mysql2Driver({
+*   host: 'localhost',
+*   user: 'root',
+*   database: 'mydb',
+*   waitForConnections: true,
+*   connectionLimit: 10,
+* })
+*
+* // Pre-created pool
+* import mysql from 'mysql2/promise'
+* const pool = mysql.createPool({ host: 'localhost', database: 'mydb' })
+* const driver = new Mysql2Driver(pool)
+* ```
+*
+* Requires `mysql2` to be installed:
+* ```bash
+* pnpm add mysql2
+* ```
+*/
 var Mysql2Driver = class {
+	pool;
+	poolInit;
+	constructor(poolOrConfig) {
+		if (typeof poolOrConfig === "object" && "execute" in poolOrConfig) this.pool = poolOrConfig;
+		else this.poolInit = import("mysql2/promise").then((mysql) => {
+			if (typeof poolOrConfig === "string") this.pool = mysql.createPool({
+				uri: poolOrConfig,
+				timezone: "+00:00",
+				supportBigNumbers: true,
+				bigNumberStrings: false,
+				typeCast: atscriptTypeCast
+			});
+			else this.pool = mysql.createPool({
+				...poolOrConfig,
+				timezone: "+00:00",
+				supportBigNumbers: true,
+				bigNumberStrings: false,
+				typeCast: atscriptTypeCast
+			});
+			return this.pool;
+		});
+	}
 	getPool() {
 		return this.pool || this.poolInit;
 	}
 	async run(sql, params) {
-		const pool = await this.getPool();
-		const [result] = await pool.query(sql, sanitizeParams(params));
+		const [result] = await (await this.getPool()).query(sql, sanitizeParams(params));
 		const header = result;
 		return {
 			affectedRows: header.affectedRows ?? 0,
@@ -1034,22 +1122,18 @@ var Mysql2Driver = class {
 		};
 	}
 	async all(sql, params) {
-		const pool = await this.getPool();
-		const [rows] = await pool.query(sql, sanitizeParams(params));
+		const [rows] = await (await this.getPool()).query(sql, sanitizeParams(params));
 		return rows;
 	}
 	async get(sql, params) {
-		const pool = await this.getPool();
-		const [rows] = await pool.query(sql, sanitizeParams(params));
+		const [rows] = await (await this.getPool()).query(sql, sanitizeParams(params));
 		return rows[0] ?? null;
 	}
 	async exec(sql) {
-		const pool = await this.getPool();
-		await pool.query(sql);
+		await (await this.getPool()).query(sql);
 	}
 	async getConnection() {
-		const pool = await this.getPool();
-		const conn = await pool.getConnection();
+		const conn = await (await this.getPool()).getConnection();
 		return {
 			async run(sql, params) {
 				const [result] = await conn.query(sql, sanitizeParams(params));
@@ -1077,119 +1161,18 @@ var Mysql2Driver = class {
 		};
 	}
 	async close() {
-		const pool = await this.getPool();
-		await pool.end();
-	}
-	constructor(poolOrConfig) {
-		_define_property(this, "pool", void 0);
-		_define_property(this, "poolInit", void 0);
-		if (typeof poolOrConfig === "object" && "execute" in poolOrConfig) this.pool = poolOrConfig;
-else this.poolInit = import("mysql2/promise").then((mysql) => {
-			if (typeof poolOrConfig === "string") this.pool = mysql.createPool({
-				uri: poolOrConfig,
-				timezone: "+00:00",
-				supportBigNumbers: true,
-				bigNumberStrings: false,
-				typeCast: atscriptTypeCast
-			});
-else this.pool = mysql.createPool({
-				...poolOrConfig,
-				timezone: "+00:00",
-				supportBigNumbers: true,
-				bigNumberStrings: false,
-				typeCast: atscriptTypeCast
-			});
-			return this.pool;
-		});
+		await (await this.getPool()).end();
 	}
 };
-
 //#endregion
-//#region packages/db-mysql/src/plugin/annotations.ts
-const annotations = {
-	engine: new AnnotationSpec({
-		description: "Specifies the MySQL storage engine.\n\n**Default:** `\"InnoDB\"`\n\n```atscript\n@db.mysql.engine \"MyISAM\"\nexport interface Logs { ... }\n```",
-		nodeType: ["interface"],
-		multiple: false,
-		argument: {
-			name: "engine",
-			type: "string",
-			values: [
-				"InnoDB",
-				"MyISAM",
-				"MEMORY",
-				"CSV",
-				"ARCHIVE"
-			],
-			description: "MySQL storage engine name."
-		}
-	}),
-	charset: new AnnotationSpec({
-		description: "Specifies the character set for the table or column.\n\n**Default:** `\"utf8mb4\"`\n\n```atscript\n@db.mysql.charset \"latin1\"\nexport interface Legacy { ... }\n```",
-		nodeType: ["interface", "prop"],
-		multiple: false,
-		argument: {
-			name: "charset",
-			type: "string",
-			values: [
-				"utf8mb4",
-				"utf8",
-				"latin1",
-				"ascii",
-				"binary"
-			],
-			description: "MySQL character set name."
-		}
-	}),
-	collate: new AnnotationSpec({
-		description: "Specifies a native MySQL collation (overrides portable `@db.column.collate`).\n\n```atscript\n@db.mysql.collate \"utf8mb4_turkish_ci\"\nname: string\n```",
-		nodeType: ["interface", "prop"],
-		multiple: false,
-		argument: {
-			name: "collation",
-			type: "string",
-			description: "Native MySQL collation name (e.g., \"utf8mb4_turkish_ci\")."
-		}
-	}),
-	unsigned: new AnnotationSpec({
-		description: "Adds the UNSIGNED modifier to an integer column.\n\n```atscript\n@db.mysql.unsigned\nage: number.int\n```",
-		nodeType: ["prop"],
-		multiple: false
-	}),
-	type: new AnnotationSpec({
-		description: "Overrides the native MySQL column type.\n\n```atscript\n@db.mysql.type \"MEDIUMTEXT\"\nbio: string\n```",
-		nodeType: ["prop"],
-		multiple: false,
-		argument: {
-			name: "type",
-			type: "string",
-			description: "Native MySQL column type (e.g., \"MEDIUMTEXT\", \"TINYTEXT\")."
-		}
-	}),
-	onUpdate: new AnnotationSpec({
-		description: "Sets the MySQL ON UPDATE clause for a column.\n\n```atscript\n@db.mysql.onUpdate \"CURRENT_TIMESTAMP\"\nupdatedAt: number.timestamp\n```",
-		nodeType: ["prop"],
-		multiple: false,
-		argument: {
-			name: "expression",
-			type: "string",
-			values: ["CURRENT_TIMESTAMP"],
-			description: "Expression to evaluate on row update."
-		}
-	})
-};
-
-//#endregion
-//#region packages/db-mysql/src/plugin/index.ts
-const MysqlPlugin = () => ({
-	name: "mysql",
-	config() {
-		return { annotations: { db: { mysql: annotations } } };
-	}
-});
-
-//#endregion
-//#region packages/db-mysql/src/index.ts
+//#region src/index.ts
+/**
+* Creates a {@link DbSpace} backed by a MySQL connection pool.
+*
+* @param uri - MySQL connection URI (e.g., `mysql://root@localhost:3306/mydb`)
+* @param options - Additional pool options passed to mysql2.
+* @returns A `DbSpace` that creates `MysqlAdapter` instances per table.
+*/
 function createAdapter(uri, options) {
 	const driver = new Mysql2Driver({
 		uri,
@@ -1197,6 +1180,5 @@ function createAdapter(uri, options) {
 	});
 	return new DbSpace(() => new MysqlAdapter(driver));
 }
-
 //#endregion
-export { Mysql2Driver, MysqlAdapter, MysqlPlugin, buildWhere, createAdapter };
+export { Mysql2Driver, MysqlAdapter, MysqlPlugin, buildWhere, createAdapter };