@zmdb/singlestore 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,6 @@
+SPDX-License-Identifier: GPL-3.0-or-later
+
+This package is part of zmdb and is licensed under the GNU General Public
+License, version 3 or (at your option) any later version. The complete license
+text is distributed in the root LICENSE file of the source repository:
+https://github.com/ambasta/zmdb/blob/main/LICENSE

package/README.md

@@ -0,0 +1,115 @@
+# @zmdb/singlestore
+
+The SingleStore vertical owns the immutable `singlestore` dialect, its migration hooks and catalog introspector, and the `singlestoreDriver` adapter. The shared query compiler comes from `@zmdb/sql`;
+repository and driver contracts come from `@zmdb/orm`. `singlestoreVertical` pairs this dialect with its driver factory.
+
+## Install
+
+```bash
+yarn add @zmdb/singlestore@1.0.0-beta.1 @zmdb/sql@1.0.0-beta.1 @zmdb/migrations@1.0.0-beta.1 mysql2@^3.24.3
+```
+
+For the TypeScript snippets, install the declaration inputs used by the packed consumer:
+
+```bash
+yarn add --dev typescript@7.0.2 @types/node@26.4.1
+```
+
+Use Node.js 26+ and ESM. Keep the required `@zmdb/sql` and `@zmdb/orm` peers aligned with this package's version; npm resolves those peers. An application already using `zmdb` adds its selected
+database package and client rather than replacing the product facade.
+
+`mysql2` is an optional peer in package metadata; install it explicitly for this recipe. The package depends on its MySQL-family parent and accepts an application-owned client.
+
+## Configure
+
+The snippets below are successive steps in one module.
+
+```ts
+import { createPool } from 'mysql2/promise';
+import { singlestore, singlestoreDriver } from '@zmdb/singlestore';
+
+const address = process.env.DATABASE_URL;
+if (address === undefined) throw new Error('DATABASE_URL is required');
+const client = createPool(address);
+const driver = singlestoreDriver(client);
+```
+
+The application owns the client and closes it with `await client.end()` in a `finally` block after its work. Hosted services that accept this client's protocol are connection recipes, not additional
+official database packages or automatically qualified server variants.
+
+## Compile
+
+```ts
+import { createQueryCompiler } from '@zmdb/sql';
+
+const compiler = createQueryCompiler(singlestore);
+const query = compiler.selectFrom('users').where('id', '=', 7).compile();
+```
+
+Compilation is pure: the result carries SQL text and a separate parameter array. It does not create the `users` table or open a connection.
+
+## Migrate
+
+Use `singlestore.migrations.emitUp(operation)` to obtain this database's DDL and `singlestore.migrations.connection(driver)` to create its migration connection. Pass reviewed migration records to `up`
+and `down` from `@zmdb/migrations`; transactional behavior follows the capability table below. The [complete installed workflow](../../fixtures/consumer-database-publication/runtime.mjs) creates a
+fresh table, applies and rolls back its migration, and closes the supplied client.
+
+## Introspect
+
+```ts
+const snapshot = await singlestore.introspector.snapshot(driver);
+```
+
+The snapshot comes from the selected database's real catalog through the same driver. `singlestoreIntrospector` is also exported directly. Introspection and generated DDL use this vertical's
+semantics.
+
+## Execute
+
+```ts
+const rows = await driver.execute(query);
+```
+
+Run this after migrating or otherwise creating the table. Use `driver.transaction(async transaction => ...)` for a pinned transactional driver; the application decides whether to retry. Query values
+travel as parameters, not SQL string interpolation.
+
+## Capabilities
+
+These entries describe `singlestore.capabilities`; a true entry can still require the client support described below.
+
+| Capability                            | Advertised support |
+| ------------------------------------- | ------------------ |
+| INSERT/upsert/UPDATE/DELETE returning | no                 |
+| Transactional DDL                     | no                 |
+| Schemas                               | yes                |
+| Sequences                             | no                 |
+| Generated columns                     | yes                |
+| Partial indexes                       | no                 |
+| Foreign keys                          | no                 |
+| Row-level security                    | no                 |
+| Streaming                             | no                 |
+| Server-side cancellation              | no                 |
+
+## Refusals and ownership
+
+Generated tables must declare a shard key or rowstore storage. Foreign keys, incompatible unique keys, check constraints, unsupported explicit index methods, sort keys on rowstore tables, storage
+transitions and MySQL routine declarations are refused. `RETURNING`, transactional DDL, sequences, partial indexes, row-level security, streaming and server-side cancellation are not advertised.
+
+SingleStore is a one-way child of `@zmdb/mysql`. It reuses public MySQL-family factories and owns SingleStore storage, migration, type and catalog overrides. The parent never depends on its child; the
+shared mysql2 client does not make a MySQL server a SingleStore substitute.
+
+`serial` emits `BIGINT AUTO_INCREMENT`, timestamps use `DATETIME(6)`, and full-text matching uses `MATCH(column) AGAINST(?)`. Shard keys, sort keys and rowstore storage are part of this vertical's
+schema round trip.
+
+## Testing evidence
+
+The [database publication qualification](../../fixtures/consumer-database-publication) builds real npm archives and installs this selected package in an independent consumer. Its public workflow
+covers strict declarations, package/client ownership, parameterized CRUD, transaction rollback, migration application/rollback and catalog introspection. The
+[SingleStore consumer](../../fixtures/database-singlestore) adds the database-specific capability and refusal checks.
+
+Issue [#676](https://github.com/ambasta/zmdb/issues/676) records the completed installed workflows. Those observations are scoped to their recorded clients and servers; they do not certify every
+compatible hosted service. Qualification reports identify their source, archive and server inputs. See the [SingleStore guide](../../docs-site/content/dialect-singlestore.md) for the detailed
+contract.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { type MysqlConnection, type MysqlDriver, type MysqlExecutionResult, type MysqlOptions, type MysqlParameter, type MysqlPool, type MysqlQueryable, type MysqlQueryResult, type MysqlResultHeader } from '@zmdb/mysql';
+import { type DatabaseVertical } from '@zmdb/orm';
+import { type SqlDialect } from '@zmdb/sql';
+import { singlestoreIntrospector } from './introspect.js';
+import { singlestoreMigrations } from './migrations.js';
+export type { MysqlConnection, MysqlDriver, MysqlExecutionResult, MysqlOptions, MysqlParameter, MysqlPool, MysqlQueryable, MysqlQueryResult, MysqlResultHeader, };
+export { singlestoreIntrospector, singlestoreMigrations };
+export declare const singlestore: SqlDialect<'singlestore'>;
+export declare function singlestoreDriver(client: MysqlQueryable, options?: MysqlOptions): MysqlDriver<'singlestore'>;
+export declare const singlestoreVertical: DatabaseVertical<'singlestore', MysqlQueryable, MysqlOptions>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAA8B,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,YAAY,EACV,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,CAAC;AACF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAC;AAU1D,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC,aAAa,CAYhD,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,CAE5G;AAED,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,CAAC,aAAa,EAAE,cAAc,EAAE,YAAY,CAG5F,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+import { mysql, mysqlFamilyDriver, } from '@zmdb/mysql';
+import {} from '@zmdb/orm';
+import { extendSqlDialect } from '@zmdb/sql';
+import { singlestoreIntrospector } from './introspect.js';
+import { SINGLESTORE_TYPE_OVERRIDES, singlestoreMigrations } from './migrations.js';
+export { singlestoreIntrospector, singlestoreMigrations };
+const outbox = Object.freeze({
+    createTable: 'CREATE ROWSTORE TABLE',
+    pendingIndex: 'full',
+    epochLiteral: "'1970-01-01 00:00:00.000000'",
+    createdAtDefault: 'CURRENT_TIMESTAMP(6)',
+    boundedTextType: (length) => `VARCHAR(${String(length)})`,
+});
+export const singlestore = extendSqlDialect(mysql, {
+    name: 'singlestore',
+    traits: {
+        fts: 'matchPlain',
+        types: SINGLESTORE_TYPE_OVERRIDES,
+    },
+    capabilities: {
+        foreignKeys: false,
+    },
+    migrations: singlestoreMigrations,
+    introspector: singlestoreIntrospector,
+    outbox,
+});
+export function singlestoreDriver(client, options) {
+    return mysqlFamilyDriver(singlestore, client, options);
+}
+export const singlestoreVertical = Object.freeze({
+    dialect: singlestore,
+    driver: singlestoreDriver,
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,iBAAiB,GAUlB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAyB,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAapF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAC;AAE1D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,MAAe;IAC7B,YAAY,EAAE,8BAA8B;IAC5C,gBAAgB,EAAE,sBAAsB;IACxC,eAAe,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,GAAG;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAA8B,gBAAgB,CAAC,KAAK,EAAE;IAC5E,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE;QACN,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,0BAA0B;KAClC;IACD,YAAY,EAAE;QACZ,WAAW,EAAE,KAAK;KACnB;IACD,UAAU,EAAE,qBAAqB;IACjC,YAAY,EAAE,uBAAuB;IACrC,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,MAAsB,EAAE,OAAsB;IAC9E,OAAO,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAkE,MAAM,CAAC,MAAM,CAAC;IAC9G,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,iBAAiB;CAC1B,CAAC,CAAC"}

package/dist/introspect.d.ts

@@ -0,0 +1,5 @@
+import { type CatalogSchemaSnapshot } from '@zmdb/migrations/introspect/runtime';
+import { type IntrospectionDriver, type Introspector, type IntrospectOptions } from '@zmdb/sql';
+export declare function singlestoreSnapshot(driver: IntrospectionDriver, options: IntrospectOptions | undefined, parent: (driver: IntrospectionDriver, options?: IntrospectOptions) => Promise<CatalogSchemaSnapshot>): Promise<CatalogSchemaSnapshot>;
+export declare const singlestoreIntrospector: Introspector<'singlestore'>;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,qBAAqB,EAE3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAyGnB,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,iBAAiB,YAAK,EAC/B,MAAM,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,qBAAqB,CAAC,GACnG,OAAO,CAAC,qBAAqB,CAAC,CA0ChC;AAMD,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,aAAa,CAK9D,CAAC"}

package/dist/introspect.js

@@ -0,0 +1,120 @@
+import { query, sortByName, textField, } from '@zmdb/migrations/introspect/runtime';
+import { mysql, mysqlFamilyIntrospector } from '@zmdb/mysql';
+import { quoteIdentifier, } from '@zmdb/sql';
+function placeholders(count) {
+    return Array.from({ length: count }, () => '?').join(', ');
+}
+function schemaFilter(options) {
+    const schemas = options.schemas;
+    if (schemas === undefined || schemas.length === 0)
+        return { sql: 'TABLE_SCHEMA = DATABASE()', parameters: [] };
+    const distinct = [...new Set(schemas)].toSorted();
+    return {
+        sql: `TABLE_SCHEMA IN (${placeholders(distinct.length)})`,
+        parameters: distinct,
+    };
+}
+function mysqlCompatibleCatalog(driver) {
+    return {
+        execute(compiled) {
+            if (!compiled.text.includes('FROM information_schema.STATISTICS'))
+                return driver.execute(compiled);
+            const text = compiled.text.replace('COLUMN_NAME, EXPRESSION, INDEX_TYPE', 'COLUMN_NAME, NULL AS EXPRESSION, INDEX_TYPE');
+            return driver.execute({ ...compiled, text });
+        },
+    };
+}
+function identifierList(clause) {
+    const identifiers = [];
+    for (const match of clause.matchAll(/`((?:``|[^`])+)`/gu)) {
+        const identifier = match[1];
+        if (identifier !== undefined)
+            identifiers.push(identifier.replaceAll('``', '`'));
+    }
+    return identifiers;
+}
+function tableOptions(createTable, storage) {
+    const shard = /\bSHARD\s+KEY(?:\s+`(?:``|[^`])+`)?\s*\(([^)]*)\)/iu.exec(createTable);
+    const sort = /\bSORT\s+KEY(?:\s+`(?:``|[^`])+`)?\s*\(([^)]*)\)/iu.exec(createTable);
+    const rowstore = storage === 'INMEMORY_ROWSTORE' || storage === 'ROWSTORE';
+    if (!rowstore && storage !== 'COLUMNSTORE') {
+        throw new TypeError(`singlestore information_schema.TABLES returned unknown STORAGE_TYPE ${JSON.stringify(storage)}`);
+    }
+    return {
+        ...(shard?.[1] === undefined ? {} : { shardKey: identifierList(shard[1]) }),
+        ...(sort?.[1] === undefined ? {} : { sortKey: identifierList(sort[1]) }),
+        ...(rowstore ? { rowstore: true } : {}),
+    };
+}
+function showCreateText(row, index) {
+    const direct = Reflect.get(row, 'Create Table');
+    if (typeof direct === 'string')
+        return direct;
+    return textField(row, 'CREATE_TABLE', 'singlestore SHOW CREATE TABLE', index);
+}
+function physicalIndexes(table) {
+    return table.indexes.filter(index => index.method !== 'shard' && index.method !== 'clustered columnstore');
+}
+function computedColumns(table) {
+    return table.columns.map(column => column.generated === undefined
+        ? column
+        : {
+            ...column,
+            generated: {
+                ...column.generated,
+                stored: /\bPERSISTED\b/iu.test(column.catalogType),
+            },
+        });
+}
+function exactTimestampWarnings(base) {
+    const exact = new Set(base.tables.flatMap(table => table.columns
+        .filter(column => column.catalogType.toLowerCase() === 'datetime(6)')
+        .map(column => `${table.name}\0${column.name}`)));
+    return base.warnings.filter(warning => warning.column === undefined ||
+        !exact.has(`${warning.table}\0${warning.column}`) ||
+        !warning.reason.includes('forward DDL emits DATETIME(3)'));
+}
+export async function singlestoreSnapshot(driver, options = {}, parent) {
+    const base = await parent(mysqlCompatibleCatalog(driver), options);
+    const filter = schemaFilter(options);
+    const storageRows = await driver.execute(query(`SELECT TABLE_SCHEMA, TABLE_NAME, STORAGE_TYPE FROM information_schema.TABLES ` +
+        `WHERE ${filter.sql} AND TABLE_TYPE = 'BASE TABLE' ORDER BY TABLE_SCHEMA, TABLE_NAME`, filter.parameters));
+    const storage = storageRows.map((row, index) => ({
+        schema: textField(row, 'TABLE_SCHEMA', 'singlestore information_schema.TABLES', index),
+        table: textField(row, 'TABLE_NAME', 'singlestore information_schema.TABLES', index),
+        storage: textField(row, 'STORAGE_TYPE', 'singlestore information_schema.TABLES', index),
+    }));
+    const byTable = new Map(storage.map(row => [row.table, row]));
+    const tables = [];
+    for (const table of base.tables) {
+        const metadata = byTable.get(table.name);
+        if (metadata === undefined) {
+            throw new TypeError(`singlestore catalog has no storage metadata for table "${table.name}"`);
+        }
+        const rows = await driver.execute(query(`SHOW CREATE TABLE ${quoteIdentifier(mysql, metadata.schema)}.${quoteIdentifier(mysql, metadata.table)}`, []));
+        const row = rows[0];
+        if (row === undefined)
+            throw new TypeError(`singlestore SHOW CREATE TABLE returned no row for "${table.name}"`);
+        tables.push({
+            ...table,
+            columns: computedColumns(table),
+            indexes: physicalIndexes(table),
+            tableOptions: tableOptions(showCreateText(row, 0), metadata.storage),
+        });
+    }
+    return {
+        ...base,
+        tables: sortByName(tables),
+        warnings: exactTimestampWarnings(base),
+    };
+}
+const family = mysqlFamilyIntrospector('singlestore', {
+    snapshot: singlestoreSnapshot,
+});
+export const singlestoreIntrospector = Object.freeze({
+    ...family,
+    normalizeForDrift(snapshot, role) {
+        return family.normalizeForDrift(snapshot, role);
+    },
+});
+//# sourceMappingURL=introspect.js.map

package/dist/introspect.js.map

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

package/dist/migrations.d.ts

@@ -0,0 +1,7 @@
+import { type MigrationDialect } from '@zmdb/sql';
+export declare const SINGLESTORE_TYPE_OVERRIDES: Readonly<{
+    serial: "BIGINT AUTO_INCREMENT";
+    timestamp: "DATETIME(6)";
+}>;
+export declare const singlestoreMigrations: MigrationDialect<'singlestore'>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,gBAAgB,EAKtB,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,0BAA0B;;;EAGrC,CAAC;AA6MH,eAAO,MAAM,qBAAqB,EAAE,gBAAgB,CAAC,aAAa,CAmChE,CAAC"}

package/dist/migrations.js

@@ -0,0 +1,185 @@
+import { mysql, mysqlFamilyMigrations } from '@zmdb/mysql';
+import { UnsupportedFeatureError, quoteIdentifier, } from '@zmdb/sql';
+export const SINGLESTORE_TYPE_OVERRIDES = Object.freeze({
+    serial: 'BIGINT AUTO_INCREMENT',
+    timestamp: 'DATETIME(6)',
+});
+function unsupported(feature, message) {
+    throw new UnsupportedFeatureError(feature, 'singlestore', message);
+}
+function columnsExist(table, label, columns) {
+    if (columns === undefined)
+        return;
+    if (columns.length === 0)
+        throw new TypeError(`${label} on "${table.name}" must name at least one column`);
+    if (new Set(columns).size !== columns.length) {
+        throw new TypeError(`${label} on "${table.name}" must not repeat a column`);
+    }
+    const available = new Set(table.columns.map(column => column.name));
+    for (const column of columns) {
+        if (!available.has(column)) {
+            throw new TypeError(`${label} on "${table.name}" names unknown column "${column}"`);
+        }
+    }
+}
+function includesShardKey(key, shardKey) {
+    const columns = new Set(key);
+    return shardKey.every(column => columns.has(column));
+}
+function validateUniqueKeys(table, shardKey) {
+    if (shardKey !== undefined && table.primaryKey.length > 0 && !includesShardKey(table.primaryKey, shardKey)) {
+        unsupported(`primary key outside the shard key on "${table.name}"`, `singlestore cannot enforce the primary key on "${table.name}" unless it includes the whole shard key ` +
+            `(${shardKey.join(', ')}); change the key or storage declaration before execution`);
+    }
+    for (const column of table.columns) {
+        const inlinePrimary = table.primaryKey.length === 1 && table.primaryKey[0] === column.name;
+        const standaloneUnique = column.unique === true && column.type !== 'serial' && !inlinePrimary;
+        const unkeyedSerial = column.type === 'serial' && !column.primaryKey;
+        if (!standaloneUnique && !unkeyedSerial)
+            continue;
+        if (shardKey !== undefined && includesShardKey([column.name], shardKey))
+            continue;
+        unsupported(`unique column "${column.name}" outside the shard key`, `singlestore cannot enforce UNIQUE on "${table.name}"."${column.name}" unless that index includes the ` +
+            `whole shard key (${shardKey?.join(', ') ?? 'none declared'}); change the shard key or enforce uniqueness ` +
+            'in the application');
+    }
+}
+function validateTable(table) {
+    if (table.foreignKeys.length > 0) {
+        unsupported('foreign keys', `@zmdb/singlestore does not qualify foreign-key DDL; remove the ${table.foreignKeys.length === 1 ? 'constraint' : 'constraints'} from "${table.name}" before execution`);
+    }
+    const options = table.tableOptions;
+    const shardKey = options?.shardKey;
+    const sortKey = options?.sortKey;
+    if (shardKey === undefined && options?.rowstore !== true) {
+        unsupported('table options', `singlestore table "${table.name}" must declare ShardKey<…> or Rowstore; ` +
+            'leaving both absent makes storage and distribution an accidental default');
+    }
+    if (options?.rowstore === true && sortKey !== undefined) {
+        unsupported(`sort key on rowstore table "${table.name}"`, `singlestore cannot declare SORT KEY on explicit ROWSTORE table "${table.name}"; ` +
+            'use an ordinary rowstore index or remove Rowstore to create a columnstore table');
+    }
+    columnsExist(table, 'shard key', shardKey);
+    columnsExist(table, 'sort key', sortKey);
+    validateUniqueKeys(table, shardKey);
+}
+function tableShape(operation) {
+    return {
+        name: operation.table,
+        columns: operation.columns,
+        primaryKey: operation.primaryKey,
+        foreignKeys: operation.foreignKeys,
+        ...(operation.tableOptions === undefined ? {} : { tableOptions: operation.tableOptions }),
+    };
+}
+const parent = mysqlFamilyMigrations('singlestore', {
+    types: SINGLESTORE_TYPE_OVERRIDES,
+    ledger: {
+        createPrefix: 'CREATE ROWSTORE TABLE',
+        definitions: ['SHARD KEY (`version`)'],
+    },
+    table: {
+        createPrefix(operation) {
+            return operation.tableOptions?.rowstore === true ? 'CREATE ROWSTORE TABLE' : 'CREATE TABLE';
+        },
+        definitions(operation, helpers) {
+            const options = operation.tableOptions;
+            const definitions = [];
+            if (options?.shardKey !== undefined) {
+                definitions.push(`SHARD KEY (${helpers.keyColumns(options.shardKey)})`);
+            }
+            if (options?.sortKey !== undefined) {
+                definitions.push(`SORT KEY (${helpers.keyColumns(options.sortKey)})`);
+            }
+            return definitions;
+        },
+    },
+});
+function validateSnapshot(snapshot) {
+    for (const table of snapshot.tables)
+        validateTable(table);
+}
+function validateOperation(operation) {
+    switch (operation.kind) {
+        case 'create_table':
+            validateTable(tableShape(operation));
+            return;
+        case 'add_foreign_key':
+        case 'drop_foreign_key':
+            unsupported('foreign keys', `@zmdb/singlestore refuses foreign-key operation "${operation.kind}" on "${operation.table}" before execution`);
+        case 'add_column':
+            if (operation.column.unique === true || operation.column.type === 'serial') {
+                unsupported(`unique column "${operation.column.name}" without shard-key evidence`, `singlestore cannot add unique column "${operation.table}"."${operation.column.name}" because the ` +
+                    'operation does not carry the table shard key');
+            }
+            return;
+        case 'alter_primary_key':
+            unsupported(`altering the primary key of "${operation.table}"`, `singlestore cannot alter the primary key of "${operation.table}" without proving its shard-key compatibility`);
+        default:
+            return;
+    }
+}
+function validateSchemaObject(operation) {
+    switch (operation.kind) {
+        case 'create_routine':
+        case 'drop_routine':
+        case 'replace_routine':
+            unsupported('stored routine DDL', 'singlestore routine declarations do not share MySQL grammar; use a reviewed hand-written migration');
+        case 'create_index':
+            if (operation.definition.unique === true) {
+                unsupported(`unique index "${operation.definition.name}" without shard-key evidence`, `singlestore cannot emit unique index "${operation.definition.name}" because the operation does not carry ` +
+                    'the table shard key');
+            }
+            if (operation.definition.method !== undefined) {
+                unsupported(`index method ${operation.definition.method} without table-storage evidence`, `singlestore cannot emit explicit ${operation.definition.method.toUpperCase()} index ` +
+                    `"${operation.definition.name}" because method support depends on rowstore versus columnstore storage; ` +
+                    'omit the method or use a reviewed hand-written migration');
+            }
+            return;
+        case 'check_constraint':
+            unsupported(`check constraint "${operation.name}"`, `singlestore does not support CHECK constraint "${operation.name}" on "${operation.table}"`);
+        default:
+            return;
+    }
+}
+function generatedColumn(operation) {
+    const definition = operation.definition;
+    return (`${quoteIdentifier(mysql, definition.name)} AS (${definition.expression})` +
+        `${definition.stored === true ? ' PERSISTED' : ''} ${definition.type}`);
+}
+export const singlestoreMigrations = Object.freeze({
+    name: 'singlestore',
+    foreignKeyMode: 'deferred',
+    embedded: false,
+    validateSnapshot(snapshot) {
+        validateSnapshot(snapshot);
+        parent.validateSnapshot(snapshot);
+    },
+    validatePlan(plan) {
+        validateSnapshot(plan.before);
+        validateSnapshot(plan.after);
+        for (const operation of plan.operations)
+            validateOperation(operation);
+        parent.validatePlan(plan);
+    },
+    ddlType(column) {
+        return parent.ddlType(column);
+    },
+    emitUp(operation) {
+        validateOperation(operation);
+        return parent.emitUp(operation);
+    },
+    emitDown(operation) {
+        if (operation.kind === 'add_foreign_key' || operation.kind === 'drop_foreign_key')
+            validateOperation(operation);
+        return parent.emitDown(operation);
+    },
+    emitSchemaObject(operation) {
+        validateSchemaObject(operation);
+        return operation.kind === 'generated_column' ? [generatedColumn(operation)] : parent.emitSchemaObject(operation);
+    },
+    connection(driver, options) {
+        return parent.connection(driver, options);
+    },
+});
+//# sourceMappingURL=migrations.js.map

package/dist/migrations.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@zmdb/singlestore",
+  "version": "1.0.0-beta.1",
+  "description": "SingleStore vertical for zmdb: MySQL-family compilation, storage-aware migrations, catalog introspection, and mysql2 driver binding.",
+  "keywords": [
+    "database",
+    "migrations",
+    "mysql",
+    "orm",
+    "singlestore",
+    "typescript",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/singlestore"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zmdb/migrations": "1.0.0-beta.1",
+    "@zmdb/mysql": "1.0.0-beta.1"
+  },
+  "peerDependencies": {
+    "@zmdb/orm": "1.0.0-beta.1",
+    "@zmdb/sql": "1.0.0-beta.1",
+    "mysql2": "^3.24.3"
+  },
+  "peerDependenciesMeta": {
+    "mysql2": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/src/index.ts

@@ -0,0 +1,62 @@
+import {
+  mysql,
+  mysqlFamilyDriver,
+  type MysqlConnection,
+  type MysqlDriver,
+  type MysqlExecutionResult,
+  type MysqlOptions,
+  type MysqlParameter,
+  type MysqlPool,
+  type MysqlQueryable,
+  type MysqlQueryResult,
+  type MysqlResultHeader,
+} from '@zmdb/mysql';
+import { type DatabaseVertical } from '@zmdb/orm';
+import { extendSqlDialect, type SqlDialect } from '@zmdb/sql';
+
+import { singlestoreIntrospector } from './introspect.js';
+import { SINGLESTORE_TYPE_OVERRIDES, singlestoreMigrations } from './migrations.js';
+
+export type {
+  MysqlConnection,
+  MysqlDriver,
+  MysqlExecutionResult,
+  MysqlOptions,
+  MysqlParameter,
+  MysqlPool,
+  MysqlQueryable,
+  MysqlQueryResult,
+  MysqlResultHeader,
+};
+export { singlestoreIntrospector, singlestoreMigrations };
+
+const outbox = Object.freeze({
+  createTable: 'CREATE ROWSTORE TABLE',
+  pendingIndex: 'full' as const,
+  epochLiteral: "'1970-01-01 00:00:00.000000'",
+  createdAtDefault: 'CURRENT_TIMESTAMP(6)',
+  boundedTextType: (length: number) => `VARCHAR(${String(length)})`,
+});
+
+export const singlestore: SqlDialect<'singlestore'> = extendSqlDialect(mysql, {
+  name: 'singlestore',
+  traits: {
+    fts: 'matchPlain',
+    types: SINGLESTORE_TYPE_OVERRIDES,
+  },
+  capabilities: {
+    foreignKeys: false,
+  },
+  migrations: singlestoreMigrations,
+  introspector: singlestoreIntrospector,
+  outbox,
+});
+
+export function singlestoreDriver(client: MysqlQueryable, options?: MysqlOptions): MysqlDriver<'singlestore'> {
+  return mysqlFamilyDriver(singlestore, client, options);
+}
+
+export const singlestoreVertical: DatabaseVertical<'singlestore', MysqlQueryable, MysqlOptions> = Object.freeze({
+  dialect: singlestore,
+  driver: singlestoreDriver,
+});

package/src/introspect.ts

@@ -0,0 +1,178 @@
+import type { SchemaSnapshot } from '@zmdb/migrations';
+import {
+  query,
+  sortByName,
+  textField,
+  type CatalogSchemaSnapshot,
+  type CatalogTableSnapshot,
+} from '@zmdb/migrations/introspect/runtime';
+import { mysql, mysqlFamilyIntrospector } from '@zmdb/mysql';
+import {
+  quoteIdentifier,
+  type CompiledQuery,
+  type IntrospectionDriver,
+  type Introspector,
+  type IntrospectOptions,
+} from '@zmdb/sql';
+
+interface StorageRow {
+  readonly schema: string;
+  readonly table: string;
+  readonly storage: string;
+}
+
+function placeholders(count: number): string {
+  return Array.from({ length: count }, () => '?').join(', ');
+}
+
+function schemaFilter(options: IntrospectOptions): {
+  readonly sql: string;
+  readonly parameters: readonly unknown[];
+} {
+  const schemas = options.schemas;
+  if (schemas === undefined || schemas.length === 0) return { sql: 'TABLE_SCHEMA = DATABASE()', parameters: [] };
+  const distinct = [...new Set(schemas)].toSorted();
+  return {
+    sql: `TABLE_SCHEMA IN (${placeholders(distinct.length)})`,
+    parameters: distinct,
+  };
+}
+
+function mysqlCompatibleCatalog(driver: IntrospectionDriver): IntrospectionDriver {
+  return {
+    execute(compiled: CompiledQuery): Promise<readonly Record<string, unknown>[]> {
+      if (!compiled.text.includes('FROM information_schema.STATISTICS')) return driver.execute(compiled);
+      const text = compiled.text.replace(
+        'COLUMN_NAME, EXPRESSION, INDEX_TYPE',
+        'COLUMN_NAME, NULL AS EXPRESSION, INDEX_TYPE',
+      );
+      return driver.execute({ ...compiled, text });
+    },
+  };
+}
+
+function identifierList(clause: string): readonly string[] {
+  const identifiers: string[] = [];
+  for (const match of clause.matchAll(/`((?:``|[^`])+)`/gu)) {
+    const identifier = match[1];
+    if (identifier !== undefined) identifiers.push(identifier.replaceAll('``', '`'));
+  }
+  return identifiers;
+}
+
+function tableOptions(createTable: string, storage: string): TableSnapshotOptions {
+  const shard = /\bSHARD\s+KEY(?:\s+`(?:``|[^`])+`)?\s*\(([^)]*)\)/iu.exec(createTable);
+  const sort = /\bSORT\s+KEY(?:\s+`(?:``|[^`])+`)?\s*\(([^)]*)\)/iu.exec(createTable);
+  const rowstore = storage === 'INMEMORY_ROWSTORE' || storage === 'ROWSTORE';
+  if (!rowstore && storage !== 'COLUMNSTORE') {
+    throw new TypeError(
+      `singlestore information_schema.TABLES returned unknown STORAGE_TYPE ${JSON.stringify(storage)}`,
+    );
+  }
+  return {
+    ...(shard?.[1] === undefined ? {} : { shardKey: identifierList(shard[1]) }),
+    ...(sort?.[1] === undefined ? {} : { sortKey: identifierList(sort[1]) }),
+    ...(rowstore ? { rowstore: true as const } : {}),
+  };
+}
+
+type TableSnapshotOptions = NonNullable<CatalogTableSnapshot['tableOptions']>;
+
+function showCreateText(row: Readonly<Record<string, unknown>>, index: number): string {
+  const direct = Reflect.get(row, 'Create Table');
+  if (typeof direct === 'string') return direct;
+  return textField(row, 'CREATE_TABLE', 'singlestore SHOW CREATE TABLE', index);
+}
+
+function physicalIndexes(table: CatalogTableSnapshot): CatalogTableSnapshot['indexes'] {
+  return table.indexes.filter(index => index.method !== 'shard' && index.method !== 'clustered columnstore');
+}
+
+function computedColumns(table: CatalogTableSnapshot): CatalogTableSnapshot['columns'] {
+  return table.columns.map(column =>
+    column.generated === undefined
+      ? column
+      : {
+          ...column,
+          generated: {
+            ...column.generated,
+            stored: /\bPERSISTED\b/iu.test(column.catalogType),
+          },
+        },
+  );
+}
+
+function exactTimestampWarnings(base: CatalogSchemaSnapshot): CatalogSchemaSnapshot['warnings'] {
+  const exact = new Set(
+    base.tables.flatMap(table =>
+      table.columns
+        .filter(column => column.catalogType.toLowerCase() === 'datetime(6)')
+        .map(column => `${table.name}\0${column.name}`),
+    ),
+  );
+  return base.warnings.filter(
+    warning =>
+      warning.column === undefined ||
+      !exact.has(`${warning.table}\0${warning.column}`) ||
+      !warning.reason.includes('forward DDL emits DATETIME(3)'),
+  );
+}
+
+export async function singlestoreSnapshot(
+  driver: IntrospectionDriver,
+  options: IntrospectOptions = {},
+  parent: (driver: IntrospectionDriver, options?: IntrospectOptions) => Promise<CatalogSchemaSnapshot>,
+): Promise<CatalogSchemaSnapshot> {
+  const base = await parent(mysqlCompatibleCatalog(driver), options);
+  const filter = schemaFilter(options);
+  const storageRows = await driver.execute(
+    query(
+      `SELECT TABLE_SCHEMA, TABLE_NAME, STORAGE_TYPE FROM information_schema.TABLES ` +
+        `WHERE ${filter.sql} AND TABLE_TYPE = 'BASE TABLE' ORDER BY TABLE_SCHEMA, TABLE_NAME`,
+      filter.parameters,
+    ),
+  );
+  const storage = storageRows.map((row, index): StorageRow => ({
+    schema: textField(row, 'TABLE_SCHEMA', 'singlestore information_schema.TABLES', index),
+    table: textField(row, 'TABLE_NAME', 'singlestore information_schema.TABLES', index),
+    storage: textField(row, 'STORAGE_TYPE', 'singlestore information_schema.TABLES', index),
+  }));
+  const byTable = new Map(storage.map(row => [row.table, row]));
+  const tables: CatalogTableSnapshot[] = [];
+  for (const table of base.tables) {
+    const metadata = byTable.get(table.name);
+    if (metadata === undefined) {
+      throw new TypeError(`singlestore catalog has no storage metadata for table "${table.name}"`);
+    }
+    const rows = await driver.execute(
+      query(
+        `SHOW CREATE TABLE ${quoteIdentifier(mysql, metadata.schema)}.${quoteIdentifier(mysql, metadata.table)}`,
+        [],
+      ),
+    );
+    const row = rows[0];
+    if (row === undefined) throw new TypeError(`singlestore SHOW CREATE TABLE returned no row for "${table.name}"`);
+    tables.push({
+      ...table,
+      columns: computedColumns(table),
+      indexes: physicalIndexes(table),
+      tableOptions: tableOptions(showCreateText(row, 0), metadata.storage),
+    });
+  }
+  return {
+    ...base,
+    tables: sortByName(tables),
+    warnings: exactTimestampWarnings(base),
+  };
+}
+
+const family = mysqlFamilyIntrospector('singlestore', {
+  snapshot: singlestoreSnapshot,
+});
+
+export const singlestoreIntrospector: Introspector<'singlestore'> = Object.freeze({
+  ...family,
+  normalizeForDrift(snapshot: SchemaSnapshot, role: 'live' | 'declared'): SchemaSnapshot {
+    return family.normalizeForDrift(snapshot, role);
+  },
+});

package/src/migrations.ts

@@ -0,0 +1,257 @@
+import type { ChangeOp, ColumnSnapshot, SchemaSnapshot, TableOptions } from '@zmdb/migrations';
+import { mysql, mysqlFamilyMigrations, type MysqlTableDdlHelpers } from '@zmdb/mysql';
+import {
+  UnsupportedFeatureError,
+  quoteIdentifier,
+  type MigrationConnection,
+  type MigrationDialect,
+  type MigrationDriver,
+  type MigrationPlan,
+  type MigrationTableOptions,
+  type SchemaObjectOperation,
+} from '@zmdb/sql';
+
+export const SINGLESTORE_TYPE_OVERRIDES = Object.freeze({
+  serial: 'BIGINT AUTO_INCREMENT',
+  timestamp: 'DATETIME(6)',
+});
+
+type CreateTableOperation = Extract<ChangeOp, { readonly kind: 'create_table' }>;
+
+interface TableShape {
+  readonly name: string;
+  readonly columns: readonly ColumnSnapshot[];
+  readonly primaryKey: readonly string[];
+  readonly foreignKeys: readonly unknown[];
+  readonly tableOptions?: TableOptions;
+}
+
+function unsupported(feature: string, message: string): never {
+  throw new UnsupportedFeatureError(feature, 'singlestore', message);
+}
+
+function columnsExist(
+  table: TableShape,
+  label: 'shard key' | 'sort key',
+  columns: readonly string[] | undefined,
+): void {
+  if (columns === undefined) return;
+  if (columns.length === 0) throw new TypeError(`${label} on "${table.name}" must name at least one column`);
+  if (new Set(columns).size !== columns.length) {
+    throw new TypeError(`${label} on "${table.name}" must not repeat a column`);
+  }
+  const available = new Set(table.columns.map(column => column.name));
+  for (const column of columns) {
+    if (!available.has(column)) {
+      throw new TypeError(`${label} on "${table.name}" names unknown column "${column}"`);
+    }
+  }
+}
+
+function includesShardKey(key: readonly string[], shardKey: readonly string[]): boolean {
+  const columns = new Set(key);
+  return shardKey.every(column => columns.has(column));
+}
+
+function validateUniqueKeys(table: TableShape, shardKey: readonly string[] | undefined): void {
+  if (shardKey !== undefined && table.primaryKey.length > 0 && !includesShardKey(table.primaryKey, shardKey)) {
+    unsupported(
+      `primary key outside the shard key on "${table.name}"`,
+      `singlestore cannot enforce the primary key on "${table.name}" unless it includes the whole shard key ` +
+        `(${shardKey.join(', ')}); change the key or storage declaration before execution`,
+    );
+  }
+  for (const column of table.columns) {
+    const inlinePrimary = table.primaryKey.length === 1 && table.primaryKey[0] === column.name;
+    const standaloneUnique = column.unique === true && column.type !== 'serial' && !inlinePrimary;
+    const unkeyedSerial = column.type === 'serial' && !column.primaryKey;
+    if (!standaloneUnique && !unkeyedSerial) continue;
+    if (shardKey !== undefined && includesShardKey([column.name], shardKey)) continue;
+    unsupported(
+      `unique column "${column.name}" outside the shard key`,
+      `singlestore cannot enforce UNIQUE on "${table.name}"."${column.name}" unless that index includes the ` +
+        `whole shard key (${shardKey?.join(', ') ?? 'none declared'}); change the shard key or enforce uniqueness ` +
+        'in the application',
+    );
+  }
+}
+
+function validateTable(table: TableShape): void {
+  if (table.foreignKeys.length > 0) {
+    unsupported(
+      'foreign keys',
+      `@zmdb/singlestore does not qualify foreign-key DDL; remove the ${
+        table.foreignKeys.length === 1 ? 'constraint' : 'constraints'
+      } from "${table.name}" before execution`,
+    );
+  }
+  const options = table.tableOptions;
+  const shardKey = options?.shardKey;
+  const sortKey = options?.sortKey;
+  if (shardKey === undefined && options?.rowstore !== true) {
+    unsupported(
+      'table options',
+      `singlestore table "${table.name}" must declare ShardKey<…> or Rowstore; ` +
+        'leaving both absent makes storage and distribution an accidental default',
+    );
+  }
+  if (options?.rowstore === true && sortKey !== undefined) {
+    unsupported(
+      `sort key on rowstore table "${table.name}"`,
+      `singlestore cannot declare SORT KEY on explicit ROWSTORE table "${table.name}"; ` +
+        'use an ordinary rowstore index or remove Rowstore to create a columnstore table',
+    );
+  }
+  columnsExist(table, 'shard key', shardKey);
+  columnsExist(table, 'sort key', sortKey);
+  validateUniqueKeys(table, shardKey);
+}
+
+function tableShape(operation: CreateTableOperation): TableShape {
+  return {
+    name: operation.table,
+    columns: operation.columns,
+    primaryKey: operation.primaryKey,
+    foreignKeys: operation.foreignKeys,
+    ...(operation.tableOptions === undefined ? {} : { tableOptions: operation.tableOptions }),
+  };
+}
+
+const parent = mysqlFamilyMigrations('singlestore', {
+  types: SINGLESTORE_TYPE_OVERRIDES,
+  ledger: {
+    createPrefix: 'CREATE ROWSTORE TABLE',
+    definitions: ['SHARD KEY (`version`)'],
+  },
+  table: {
+    createPrefix(operation): string {
+      return operation.tableOptions?.rowstore === true ? 'CREATE ROWSTORE TABLE' : 'CREATE TABLE';
+    },
+    definitions(operation, helpers: MysqlTableDdlHelpers): readonly string[] {
+      const options = operation.tableOptions;
+      const definitions: string[] = [];
+      if (options?.shardKey !== undefined) {
+        definitions.push(`SHARD KEY (${helpers.keyColumns(options.shardKey)})`);
+      }
+      if (options?.sortKey !== undefined) {
+        definitions.push(`SORT KEY (${helpers.keyColumns(options.sortKey)})`);
+      }
+      return definitions;
+    },
+  },
+});
+
+function validateSnapshot(snapshot: SchemaSnapshot): void {
+  for (const table of snapshot.tables) validateTable(table);
+}
+
+function validateOperation(operation: ChangeOp): void {
+  switch (operation.kind) {
+    case 'create_table':
+      validateTable(tableShape(operation));
+      return;
+    case 'add_foreign_key':
+    case 'drop_foreign_key':
+      unsupported(
+        'foreign keys',
+        `@zmdb/singlestore refuses foreign-key operation "${operation.kind}" on "${operation.table}" before execution`,
+      );
+    case 'add_column':
+      if (operation.column.unique === true || operation.column.type === 'serial') {
+        unsupported(
+          `unique column "${operation.column.name}" without shard-key evidence`,
+          `singlestore cannot add unique column "${operation.table}"."${operation.column.name}" because the ` +
+            'operation does not carry the table shard key',
+        );
+      }
+      return;
+    case 'alter_primary_key':
+      unsupported(
+        `altering the primary key of "${operation.table}"`,
+        `singlestore cannot alter the primary key of "${operation.table}" without proving its shard-key compatibility`,
+      );
+    default:
+      return;
+  }
+}
+
+function validateSchemaObject(operation: SchemaObjectOperation): void {
+  switch (operation.kind) {
+    case 'create_routine':
+    case 'drop_routine':
+    case 'replace_routine':
+      unsupported(
+        'stored routine DDL',
+        'singlestore routine declarations do not share MySQL grammar; use a reviewed hand-written migration',
+      );
+    case 'create_index':
+      if (operation.definition.unique === true) {
+        unsupported(
+          `unique index "${operation.definition.name}" without shard-key evidence`,
+          `singlestore cannot emit unique index "${operation.definition.name}" because the operation does not carry ` +
+            'the table shard key',
+        );
+      }
+      if (operation.definition.method !== undefined) {
+        unsupported(
+          `index method ${operation.definition.method} without table-storage evidence`,
+          `singlestore cannot emit explicit ${operation.definition.method.toUpperCase()} index ` +
+            `"${operation.definition.name}" because method support depends on rowstore versus columnstore storage; ` +
+            'omit the method or use a reviewed hand-written migration',
+        );
+      }
+      return;
+    case 'check_constraint':
+      unsupported(
+        `check constraint "${operation.name}"`,
+        `singlestore does not support CHECK constraint "${operation.name}" on "${operation.table}"`,
+      );
+    default:
+      return;
+  }
+}
+
+function generatedColumn(operation: Extract<SchemaObjectOperation, { readonly kind: 'generated_column' }>): string {
+  const definition = operation.definition;
+  return (
+    `${quoteIdentifier(mysql, definition.name)} AS (${definition.expression})` +
+    `${definition.stored === true ? ' PERSISTED' : ''} ${definition.type}`
+  );
+}
+
+export const singlestoreMigrations: MigrationDialect<'singlestore'> = Object.freeze({
+  name: 'singlestore',
+  foreignKeyMode: 'deferred',
+  embedded: false,
+  validateSnapshot(snapshot: SchemaSnapshot): void {
+    validateSnapshot(snapshot);
+    parent.validateSnapshot(snapshot);
+  },
+  validatePlan(plan: MigrationPlan): void {
+    validateSnapshot(plan.before);
+    validateSnapshot(plan.after);
+    for (const operation of plan.operations) validateOperation(operation);
+    parent.validatePlan(plan);
+  },
+  ddlType(column: ColumnSnapshot): string {
+    return parent.ddlType(column);
+  },
+  emitUp(operation: ChangeOp): string {
+    validateOperation(operation);
+    return parent.emitUp(operation);
+  },
+  emitDown(operation: ChangeOp): string {
+    if (operation.kind === 'add_foreign_key' || operation.kind === 'drop_foreign_key') validateOperation(operation);
+    return parent.emitDown(operation);
+  },
+  emitSchemaObject(operation: SchemaObjectOperation): readonly string[] {
+    validateSchemaObject(operation);
+    return operation.kind === 'generated_column' ? [generatedColumn(operation)] : parent.emitSchemaObject(operation);
+  },
+  connection(
+    driver: MigrationDriver<'singlestore'>,
+    options?: MigrationTableOptions,
+  ): MigrationConnection<'singlestore'> {
+    return parent.connection(driver, options);
+  },
+});