@adminiumjs/adapter-mysql 0.1.0-rc.1

package/dist/query-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-engine.d.ts","sourceRoot":"","sources":["../src/query-engine.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAUlC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,GAAG,WAAW,CAmCpF"}

package/dist/query-engine.js

@@ -0,0 +1,59 @@
+/**
+ * `createQueryEngine()` — the Kysely dialect factory for the pooled data
+ * connection (05-introspection-engine.md §3 `QueryEngine`, 08-server-api.md
+ * §3.7 "query port").
+ *
+ * `@adminium/engine` does not depend on `kysely`, so `QueryEngine.dialect`
+ * is typed opaquely there; `@adminium/server` casts it to `kysely.Dialect`
+ * at the composition boundary. This package owns the concrete dependency.
+ */
+import { MysqlDialect } from 'kysely';
+import mysql from 'mysql2';
+import { AdapterError, } from '@adminium/engine/adapter';
+import { MYSQL_MAX_IDENTIFIER_LENGTH, mysqlSerializers, quoteIdentifier, } from './serialization.js';
+const DEFAULT_DATA_POOL_MAX = 10;
+/**
+ * Build the CRUD query port for a data-role connection. Accepts a DSN string
+ * or the role-branded config (which must carry a `dsn`). Kysely's
+ * `MysqlDialect` consumes the callback-flavored mysql2 pool; connections are
+ * only opened on first query, and `destroy()` tears the pool down
+ * idempotently.
+ */
+export function createQueryEngine(config) {
+    const dsn = typeof config === 'string' ? config : config.dsn;
+    if (dsn === undefined || dsn.length === 0) {
+        throw new AdapterError('UNKNOWN', 'mysql query engine requires a DSN', {
+            hint: 'pass a mysql:// connection string (TLS options honored from the ssl params)',
+        });
+    }
+    const poolMax = typeof config === 'string' ? undefined : config.poolMax;
+    const pool = mysql.createPool({
+        uri: dsn,
+        connectionLimit: poolMax ?? DEFAULT_DATA_POOL_MAX,
+    });
+    // Structural cast: kysely ships its own minimal `MysqlPool` interface to
+    // avoid a dependency on mysql2 — the runtime shape of a mysql2 callback
+    // pool matches it exactly (kysely's own docs pass one here), and the
+    // dialect crosses the `QueryEngine` boundary as `unknown` anyway.
+    const kyselyPool = pool;
+    let destroyed = false;
+    return {
+        dialect: new MysqlDialect({ pool: kyselyPool }),
+        identifiers: { quote: quoteIdentifier, maxLength: MYSQL_MAX_IDENTIFIER_LENGTH },
+        serializers: mysqlSerializers,
+        async destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            await new Promise((resolve, reject) => {
+                pool.end((error) => {
+                    if (error === undefined || error === null)
+                        resolve();
+                    else
+                        reject(error);
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=query-engine.js.map

package/dist/query-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-engine.js","sourceRoot":"","sources":["../src/query-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAA2B,MAAM,QAAQ,CAAC;AAC/D,OAAO,KAAK,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,YAAY,GAGb,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqC;IACrE,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAC7D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,mCAAmC,EAAE;YACrE,IAAI,EAAE,6EAA6E;SACpF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IACxE,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;QAC5B,GAAG,EAAE,GAAG;QACR,eAAe,EAAE,OAAO,IAAI,qBAAqB;KAClD,CAAC,CAAC;IAEH,yEAAyE;IACzE,wEAAwE;IACxE,qEAAqE;IACrE,kEAAkE;IAClE,MAAM,UAAU,GAAG,IAA6C,CAAC;IAEjE,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,OAAO;QACL,OAAO,EAAE,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,WAAW,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,2BAA2B,EAAE;QAC/E,WAAW,EAAE,gBAAgB;QAC7B,KAAK,CAAC,OAAO;YACX,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;oBACjB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;wBAAE,OAAO,EAAE,CAAC;;wBAChD,MAAM,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/serialization.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Identifier quoting + per-LogicalType value serialization for the MySQL
+ * data connection — 05-introspection-engine.md §3 (`QueryEngine`) and
+ * 08-server-api.md §3.7. Pure module (no `mysql2`/`kysely` import) so the
+ * policy is unit-testable offline. Mirrors the postgres reference adapter.
+ *
+ * Serialization policy (05 §3 `TypeSerializer` contract):
+ * - `bigint` and `decimal` travel as STRINGS end to end — unsigned bigint
+ *   exceeds Number.MAX_SAFE_INTEGER and JS numbers would silently lose
+ *   precision (05 §4.2 flags this in QueryResult column meta).
+ * - `timestamp` (datetime) and `timestamptz` (timestamp) serialize to
+ *   ISO-8601 UTC; `date` keeps its SQL text form (`YYYY-MM-DD`).
+ * - `boolean` maps tinyint(1)'s 0/1 wire form to real booleans.
+ * - `json` values pass through as parsed objects (mysql2 parses the JSON
+ *   type); `toDb` stringifies so a single parameter binds.
+ * - BINARY POLICY: `binary` columns are EXCLUDED from CRUD v1 — no
+ *   serializer is registered for `'binary'` (same as postgres bytea).
+ */
+import type { LogicalType, TypeSerializer } from '@adminium/engine/adapter';
+/** MySQL truncates identifiers at 64 characters. */
+export declare const MYSQL_MAX_IDENTIFIER_LENGTH = 64;
+/**
+ * Backtick-quote an identifier, escaping embedded backticks. Identifiers are
+ * snapshot-validated before they ever reach this point (no raw SQL escape
+ * hatch — 05 §3); quoting is defense in depth, not sanitization.
+ */
+export declare function quoteIdentifier(identifier: string): string;
+/** Per-LogicalType converters handed to the CRUD layer via `QueryEngine`. */
+export declare const mysqlSerializers: Partial<Record<LogicalType, TypeSerializer>>;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE5E,oDAAoD;AACpD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AA8BD,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAkBzE,CAAC"}

package/dist/serialization.js

@@ -0,0 +1,59 @@
+/** MySQL truncates identifiers at 64 characters. */
+export const MYSQL_MAX_IDENTIFIER_LENGTH = 64;
+/**
+ * Backtick-quote an identifier, escaping embedded backticks. Identifiers are
+ * snapshot-validated before they ever reach this point (no raw SQL escape
+ * hatch — 05 §3); quoting is defense in depth, not sanitization.
+ */
+export function quoteIdentifier(identifier) {
+    return `\`${identifier.replaceAll('`', '``')}\``;
+}
+function toIsoUtc(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    return value;
+}
+/** `YYYY-MM-DD` from a driver-parsed Date (local calendar date, not UTC). */
+function toIsoDate(value) {
+    if (value instanceof Date) {
+        const month = String(value.getMonth() + 1).padStart(2, '0');
+        const day = String(value.getDate()).padStart(2, '0');
+        return `${value.getFullYear()}-${month}-${day}`;
+    }
+    return value;
+}
+function numericToDb(value) {
+    if (typeof value === 'bigint' || typeof value === 'number')
+        return value.toString();
+    return value;
+}
+const lossless = {
+    toDb: numericToDb,
+    fromDb: (value) => {
+        if (typeof value === 'number' || typeof value === 'bigint')
+            return value.toString();
+        return value;
+    },
+};
+/** Per-LogicalType converters handed to the CRUD layer via `QueryEngine`. */
+export const mysqlSerializers = {
+    bigint: lossless,
+    decimal: lossless,
+    boolean: {
+        toDb: (value) => (typeof value === 'boolean' ? (value ? 1 : 0) : value),
+        fromDb: (value) => {
+            if (value === 1 || value === 0)
+                return value === 1;
+            return value;
+        },
+    },
+    timestamp: { toDb: (value) => value, fromDb: toIsoUtc },
+    timestamptz: { toDb: (value) => value, fromDb: toIsoUtc },
+    date: { toDb: (value) => value, fromDb: toIsoDate },
+    json: {
+        toDb: (value) => (typeof value === 'string' ? value : JSON.stringify(value)),
+        fromDb: (value) => value,
+    },
+    // NOTE: no 'binary' entry on purpose — blobs are excluded from CRUD v1.
+};
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAoBA,oDAAoD;AACpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,KAAK,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrD,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACpF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,QAAQ,GAAmB;IAC/B,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpF,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAiD;IAC5E,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACvE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,KAAK,KAAK,CAAC,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;KACF;IACD,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE;IACvD,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE;IACzD,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;IACnD,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;KACzB;IACD,wEAAwE;CACzE,CAAC"}

package/dist/stats.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MySQL table-statistics collector — 06-llm-assist.md §4.2.
+ *
+ * Cheap-first strategy (sample-free by default): row-count from
+ * `information_schema.TABLES.TABLE_ROWS` (the InnoDB estimate) with an exact
+ * `COUNT(*)` fallback for small/stale tables. MySQL exposes no cheap
+ * per-column statistics catalog, so null-fraction and distinct-count come from
+ * a single bounded full-scan of aggregates (`SUM(col IS NULL)`,
+ * `COUNT(DISTINCT col)`) — aggregates only, never a cell value — and tables
+ * above `maxScanRows` degrade to `null` rather than a wrong number. Concrete
+ * values appear ONLY under the sampling opt-in, and NEVER for PII-suspected or
+ * secret columns.
+ *
+ * Executor-agnostic (like introspect.ts): takes a `sql → rows` runner so the
+ * logic is unit-testable without the `mysql2` driver.
+ */
+import type { CollectStatsOptions, StatsResult, TableRef } from '@adminium/engine/adapter';
+/** Any `sql → rows` runner (the mysql2 data pool in production). */
+export type StatsExecutor = (sql: string) => Promise<Record<string, unknown>[]>;
+export declare function collectMysqlStats(exec: StatsExecutor, table: TableRef, opts?: CollectStatsOptions): Promise<StatsResult>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,mBAAmB,EAGnB,WAAW,EAEX,QAAQ,EACT,MAAM,0BAA0B,CAAC;AAUlC,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AAoDhF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,QAAQ,EACf,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAsGtB"}

package/dist/stats.js

@@ -0,0 +1,142 @@
+import { STATS_DEFAULT_SAMPLE_VALUES, STATS_EXACT_COUNT_THRESHOLD, STATS_MAX_SCAN_ROWS, STATS_SAMPLE_VALUE_MAX_CHARS, } from '@adminium/engine/adapter';
+import { quoteIdentifier } from './serialization.js';
+/** Ordered logical types eligible for min/max under sampling opt-in. */
+const ORDERED_TYPES = new Set([
+    'integer',
+    'bigint',
+    'decimal',
+    'float',
+    'date',
+    'time',
+    'timestamp',
+    'timestamptz',
+]);
+function num(value) {
+    if (value === null || value === undefined)
+        return null;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+function literal(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+function toScalar(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value instanceof Uint8Array)
+        return '[binary]';
+    return String(value);
+}
+function truncate(value) {
+    if (typeof value === 'string' && value.length > STATS_SAMPLE_VALUE_MAX_CHARS) {
+        return value.slice(0, STATS_SAMPLE_VALUE_MAX_CHARS);
+    }
+    return value;
+}
+/** One batched full-scan: `COUNT(*)` + per-column null count + distinct count. */
+function buildNullDistinctScan(qualified, columns) {
+    const parts = columns.map((name, k) => {
+        const q = quoteIdentifier(name);
+        return `sum(${q} IS NULL) AS nf_${k}, count(DISTINCT ${q}) AS dc_${k}`;
+    });
+    const cols = parts.length > 0 ? `, ${parts.join(', ')}` : '';
+    return `SELECT count(*) AS row_total${cols} FROM ${qualified}`;
+}
+export async function collectMysqlStats(exec, table, opts = {}) {
+    const name = table.name;
+    // MySQL has no schema layer — the pool is bound to one database. Qualify with
+    // the explicit schema when present, else the current database.
+    const qualified = table.schema !== null
+        ? `${quoteIdentifier(table.schema)}.${quoteIdentifier(name)}`
+        : quoteIdentifier(name);
+    const schemaExpr = table.schema !== null ? literal(table.schema) : 'DATABASE()';
+    const columns = opts.columns ?? [];
+    const sampling = opts.sampling ?? null;
+    const maxScanRows = opts.maxScanRows ?? STATS_MAX_SCAN_ROWS;
+    const warnings = [];
+    // 1. Row-count estimate from information_schema, exact COUNT for small tables.
+    const infoRows = await exec(`SELECT TABLE_ROWS AS table_rows
+     FROM information_schema.TABLES
+     WHERE TABLE_SCHEMA = ${schemaExpr} AND TABLE_NAME = ${literal(name)}
+     LIMIT 1`);
+    const tableRows = num(infoRows[0]?.['table_rows']);
+    let rowCountEstimate;
+    let rowCountExact;
+    if (tableRows !== null && tableRows >= STATS_EXACT_COUNT_THRESHOLD) {
+        rowCountEstimate = Math.round(tableRows);
+        rowCountExact = false;
+    }
+    else {
+        const countRows = await exec(`SELECT count(*) AS n FROM ${qualified}`);
+        rowCountEstimate = num(countRows[0]?.['n']);
+        rowCountExact = rowCountEstimate !== null;
+    }
+    // 2. Per-column null-fraction + distinct-count via one bounded full-scan.
+    const colStats = columns.map((c) => ({
+        column: c.name,
+        nullFraction: null,
+        distinctCount: null,
+    }));
+    if (columns.length > 0) {
+        const scannable = rowCountEstimate !== null && rowCountEstimate <= maxScanRows;
+        if (scannable) {
+            const scanRows = await exec(buildNullDistinctScan(qualified, columns.map((c) => c.name)));
+            const row = scanRows[0] ?? {};
+            const total = num(row['row_total']);
+            columns.forEach((_c, k) => {
+                const nulls = num(row[`nf_${k}`]);
+                colStats[k].nullFraction =
+                    total === null || total === 0 ? (total === 0 ? 0 : null) : nulls === null ? null : nulls / total;
+                colStats[k].distinctCount = num(row[`dc_${k}`]);
+            });
+        }
+        else {
+            warnings.push(`null-fraction/distinct-count skipped for ${columns.length} column(s): table exceeds maxScanRows`);
+        }
+    }
+    // 3. Sampling opt-in — most-common values + ordered min/max; never PII/secret.
+    let sampled = false;
+    if (sampling !== null) {
+        const maxValues = sampling.maxValuesPerColumn > 0
+            ? Math.floor(sampling.maxValuesPerColumn)
+            : STATS_DEFAULT_SAMPLE_VALUES;
+        for (let i = 0; i < columns.length; i += 1) {
+            const c = columns[i];
+            if (c.piiSuspected === true || c.secret === true)
+                continue; // NEVER sample PII/secret.
+            const q = quoteIdentifier(c.name);
+            if (ORDERED_TYPES.has(c.logicalType)) {
+                const mm = await exec(`SELECT min(${q}) AS lo, max(${q}) AS hi FROM ${qualified}`);
+                colStats[i].min = toScalar(mm[0]?.['lo']);
+                colStats[i].max = toScalar(mm[0]?.['hi']);
+                sampled = true;
+            }
+            const mcv = await exec(`SELECT ${q} AS v, count(*) AS c
+         FROM ${qualified}
+         WHERE ${q} IS NOT NULL
+         GROUP BY ${q}
+         ORDER BY count(*) DESC, ${q}
+         LIMIT ${maxValues}`);
+            colStats[i].sampleValues = mcv.map((r) => truncate(toScalar(r['v'])));
+            sampled = true;
+        }
+    }
+    const result = {
+        table: { schema: table.schema, name },
+        rowCountEstimate,
+        rowCountExact,
+        columns: colStats,
+        sampled,
+    };
+    if (warnings.length > 0)
+        result.warnings = warnings;
+    return result;
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

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

package/dist/type-map.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MySQL/MariaDB COLUMN_TYPE → portable LogicalType mapping —
+ * 05-introspection-engine.md §2.2 ("canonical table — extend, never fork"),
+ * MySQL/MariaDB column, plus the §4.2 type notes.
+ *
+ * Input is the verbatim `information_schema.COLUMNS.COLUMN_TYPE` string
+ * (e.g. `varchar(120)`, `int unsigned`, `tinyint(1)`, `enum('a','b')`) so the
+ * mapping is pure and unit-testable offline — no driver, no server.
+ *
+ * DOCUMENTED POLICY (05 §4.2): `tinyint(1)` maps to `boolean` (the mysql2 /
+ * classic connector convention — MySQL has no native boolean and `BOOLEAN`
+ * DDL compiles to `tinyint(1)`). Any other tinyint width is an integer.
+ * `set(...)` degrades to `text` (the assembler emits a warning). `year` maps
+ * to `integer` with a warning. `datetime` (no zone) → `timestamp`;
+ * `timestamp` (UTC-normalized by the server) → `timestamptz`.
+ */
+import type { ColumnDefault, LogicalType } from '@adminium/engine/adapter';
+export interface MappedMysqlType {
+    logicalType: LogicalType;
+    maxLength: number | null;
+    numericPrecision: number | null;
+    numericScale: number | null;
+    /** `unsigned` modifier present on a numeric type. */
+    unsigned: boolean;
+    /** Non-fatal mapping caveat the assembler turns into a ModelWarning. */
+    warning: 'unsigned-overflow' | 'year-as-integer' | 'set-as-text' | null;
+}
+/**
+ * Parse the quoted value list of `enum('a','b')` / `set('a','b')`. MySQL
+ * escapes embedded quotes by doubling (`''`) and the odd dump uses `\'` —
+ * both are unescaped. Returns null when `columnType` is not an enum/set.
+ */
+export declare function parseEnumValues(columnType: string): string[] | null;
+/**
+ * Map a verbatim MySQL/MariaDB COLUMN_TYPE to its portable shape.
+ * Unmappable types become `'unknown'` with the verbatim `dbType` preserved
+ * by the caller (rendered read-only as text — 05 §2.2).
+ */
+export declare function mapMysqlType(columnType: string): MappedMysqlType;
+/**
+ * Classify a column default — 05 §4.2: `EXTRA` carries `auto_increment`,
+ * generated-column markers, and MySQL 8 `DEFAULT_GENERATED` expression
+ * defaults; `COLUMN_DEFAULT` carries the value text (MariaDB quotes string
+ * literals, MySQL 8 does not — both spellings are accepted).
+ *
+ * @param defaultValue `information_schema.COLUMNS.COLUMN_DEFAULT` (nullable).
+ * @param extra `information_schema.COLUMNS.EXTRA` (may be '').
+ */
+export declare function classifyMysqlDefault(defaultValue: string | null, extra: string): ColumnDefault;
+//# sourceMappingURL=type-map.d.ts.map

package/dist/type-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-map.d.ts","sourceRoot":"","sources":["../src/type-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAAC;CACzE;AAmFD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAQnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAiEhE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAa9F"}

package/dist/type-map.js

@@ -0,0 +1,193 @@
+/** Base type name (modifiers and attributes stripped) → LogicalType. */
+const BASE_TYPE_MAP = {
+    // integers (tinyint(1) special-cased in mapMysqlType)
+    tinyint: 'integer',
+    smallint: 'integer',
+    mediumint: 'integer',
+    int: 'integer',
+    integer: 'integer',
+    bigint: 'bigint',
+    // exact + approximate numerics
+    decimal: 'decimal',
+    numeric: 'decimal',
+    dec: 'decimal',
+    fixed: 'decimal',
+    float: 'float',
+    double: 'float',
+    'double precision': 'float',
+    real: 'float',
+    // text family
+    char: 'varchar',
+    varchar: 'varchar',
+    tinytext: 'text',
+    text: 'text',
+    mediumtext: 'text',
+    longtext: 'text',
+    // binary family
+    binary: 'binary',
+    varbinary: 'binary',
+    tinyblob: 'binary',
+    blob: 'binary',
+    mediumblob: 'binary',
+    longblob: 'binary',
+    // date/time
+    date: 'date',
+    time: 'time',
+    datetime: 'timestamp',
+    timestamp: 'timestamptz',
+    year: 'integer',
+    // structured / misc
+    json: 'json',
+    // MariaDB ≥ 10.7 native types
+    uuid: 'uuid',
+    inet4: 'inet',
+    inet6: 'inet',
+    // spatial (flag; rendered read-only as text in v1 — 05 §2.2)
+    geometry: 'geometry',
+    point: 'geometry',
+    linestring: 'geometry',
+    polygon: 'geometry',
+    multipoint: 'geometry',
+    multilinestring: 'geometry',
+    multipolygon: 'geometry',
+    geometrycollection: 'geometry',
+    geomcollection: 'geometry',
+};
+/** Binary-float precision constants (same convention as the pg adapter). */
+const FLOAT_PRECISION = 24;
+const DOUBLE_PRECISION = 53;
+/** Strip `(…)` modifiers and trailing attributes (`unsigned`, `zerofill`). */
+function baseTypeName(columnType) {
+    return columnType
+        .trim()
+        .toLowerCase()
+        .replace(/\([^)]*\)/, '')
+        .replace(/\b(unsigned|zerofill|signed)\b/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Extract `(n)` / `(p,s)` modifier numbers, when present. */
+function modifiers(columnType) {
+    const match = /\(([\d\s,]+)\)/.exec(columnType);
+    if (match?.[1] === undefined)
+        return [];
+    return match[1]
+        .split(',')
+        .map((part) => Number.parseInt(part.trim(), 10))
+        .filter((n) => Number.isFinite(n));
+}
+/**
+ * Parse the quoted value list of `enum('a','b')` / `set('a','b')`. MySQL
+ * escapes embedded quotes by doubling (`''`) and the odd dump uses `\'` —
+ * both are unescaped. Returns null when `columnType` is not an enum/set.
+ */
+export function parseEnumValues(columnType) {
+    const match = /^\s*(enum|set)\s*\((.*)\)\s*$/is.exec(columnType);
+    if (match?.[2] === undefined)
+        return null;
+    const values = [];
+    for (const literal of match[2].matchAll(/'((?:[^'\\]|\\.|'')*)'/g)) {
+        values.push((literal[1] ?? '').replaceAll("''", "'").replaceAll("\\'", "'"));
+    }
+    return values;
+}
+/**
+ * Map a verbatim MySQL/MariaDB COLUMN_TYPE to its portable shape.
+ * Unmappable types become `'unknown'` with the verbatim `dbType` preserved
+ * by the caller (rendered read-only as text — 05 §2.2).
+ */
+export function mapMysqlType(columnType) {
+    const lowered = columnType.trim().toLowerCase();
+    const unsigned = /\bunsigned\b/.test(lowered);
+    // enum(...) / set(...) carry their value list inside the parens — handle
+    // before modifier stripping. set(...) degrades to text (05 §4.2).
+    if (lowered.startsWith('enum(') || lowered.startsWith('enum (')) {
+        return {
+            logicalType: 'enum',
+            maxLength: null,
+            numericPrecision: null,
+            numericScale: null,
+            unsigned: false,
+            warning: null,
+        };
+    }
+    if (lowered.startsWith('set(') || lowered.startsWith('set (')) {
+        return {
+            logicalType: 'text',
+            maxLength: null,
+            numericPrecision: null,
+            numericScale: null,
+            unsigned: false,
+            warning: 'set-as-text',
+        };
+    }
+    const base = baseTypeName(lowered);
+    const mods = modifiers(lowered);
+    // tinyint(1) → boolean (documented policy above); bit(1) reads as boolean too.
+    if ((base === 'tinyint' && mods[0] === 1) || (base === 'bit' && (mods[0] ?? 1) === 1)) {
+        return {
+            logicalType: 'boolean',
+            maxLength: null,
+            numericPrecision: null,
+            numericScale: null,
+            unsigned,
+            warning: null,
+        };
+    }
+    const logicalType = BASE_TYPE_MAP[base] ?? 'unknown';
+    let maxLength = null;
+    let numericPrecision = null;
+    let numericScale = null;
+    let warning = null;
+    if (logicalType === 'varchar' || logicalType === 'text' || logicalType === 'binary') {
+        maxLength = mods[0] ?? null;
+    }
+    else if (logicalType === 'decimal') {
+        numericPrecision = mods[0] ?? null;
+        numericScale = mods[1] ?? null;
+    }
+    else if (logicalType === 'float') {
+        numericPrecision = base === 'float' ? FLOAT_PRECISION : DOUBLE_PRECISION;
+    }
+    if (base === 'year')
+        warning = 'year-as-integer';
+    // `int unsigned` (and up) exceeds int4 range — flagged per 05 §4.2.
+    else if (unsigned && (base === 'int' || base === 'integer' || base === 'bigint')) {
+        warning = 'unsigned-overflow';
+    }
+    return { logicalType, maxLength, numericPrecision, numericScale, unsigned, warning };
+}
+const NOW_DEFAULT = /^(current_timestamp(\(\d*\))?|now\(\d*\))$/i;
+const UUID_DEFAULT = /^uuid\(\)$/i;
+const LITERAL_DEFAULT = /^('(?:[^']|'')*'|-?\d+(\.\d+)?|true|false|b'[01]+')$/i;
+/**
+ * Classify a column default — 05 §4.2: `EXTRA` carries `auto_increment`,
+ * generated-column markers, and MySQL 8 `DEFAULT_GENERATED` expression
+ * defaults; `COLUMN_DEFAULT` carries the value text (MariaDB quotes string
+ * literals, MySQL 8 does not — both spellings are accepted).
+ *
+ * @param defaultValue `information_schema.COLUMNS.COLUMN_DEFAULT` (nullable).
+ * @param extra `information_schema.COLUMNS.EXTRA` (may be '').
+ */
+export function classifyMysqlDefault(defaultValue, extra) {
+    const extraLowered = extra.toLowerCase();
+    if (extraLowered.includes('auto_increment'))
+        return { kind: 'autoincrement' };
+    if (defaultValue === null || /^null$/i.test(defaultValue))
+        return null;
+    const text = defaultValue.trim();
+    if (NOW_DEFAULT.test(text))
+        return { kind: 'now' };
+    if (UUID_DEFAULT.test(text))
+        return { kind: 'uuid' };
+    // MySQL 8 marks expression defaults with DEFAULT_GENERATED in EXTRA.
+    if (extraLowered.includes('default_generated'))
+        return { kind: 'expression', text };
+    if (LITERAL_DEFAULT.test(text))
+        return { kind: 'literal', text };
+    // MySQL 8 strips quotes from string literals — a bare word is a literal.
+    if (/^[^()]*$/.test(text))
+        return { kind: 'literal', text };
+    return { kind: 'expression', text };
+}
+//# sourceMappingURL=type-map.js.map

package/dist/type-map.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@adminiumjs/adapter-mysql",
+  "version": "0.1.0-rc.1",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MoSofi/Adminium.git",
+    "directory": "packages/adapter-mysql"
+  },
+  "homepage": "https://adminium.dev",
+  "bugs": "https://github.com/MoSofi/Adminium/issues",
+  "type": "module",
+  "description": "MySQL/MariaDB adapter",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@adminium/engine": "npm:@adminiumjs/engine@0.1.0-rc.1",
+    "kysely": "^0.28.2",
+    "mysql2": "^3.15.3"
+  },
+  "files": [
+    "dist"
+  ]
+}