@zmdb/mssql 1.0.0-beta.1

package/README.md

@@ -0,0 +1,110 @@
+# @zmdb/mssql
+
+The SQL Server vertical owns the immutable `mssql` dialect, its migration hooks and catalog introspector, and the `mssqlDriver` adapter. The shared query compiler comes from `@zmdb/sql`; repository
+and driver contracts come from `@zmdb/orm`. `mssqlVertical` pairs this dialect with its driver factory.
+
+## Install
+
+```bash
+yarn add @zmdb/mssql@1.0.0-beta.1 @zmdb/sql@1.0.0-beta.1 @zmdb/migrations@1.0.0-beta.1 mssql@^12.7.0
+```
+
+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 @types/mssql@12.3.0
+```
+
+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.
+
+`mssql` is an optional peer in package metadata; install it explicitly for this recipe. Importing the vertical does not import the SDK or open a connection. Pass an already-connected pool to
+`mssqlDriver`.
+
+## Configure
+
+The snippets below are successive steps in one module.
+
+```ts
+import sql from 'mssql';
+import { mssql, mssqlDriver } from '@zmdb/mssql';
+
+const address = process.env.DATABASE_URL;
+if (address === undefined) throw new Error('DATABASE_URL is required');
+const client = await new sql.ConnectionPool(address).connect();
+const driver = mssqlDriver(client);
+```
+
+The application owns the client and closes it with `await client.close()` 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(mssql);
+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 `mssql.migrations.emitUp(operation)` to obtain this database's DDL and `mssql.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 mssql.introspector.snapshot(driver);
+```
+
+The snapshot comes from the selected database's real catalog through the same driver. `mssqlIntrospector` 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 `mssql.capabilities`; a true entry can still require the client support described below.
+
+| Capability                            | Advertised support    |
+| ------------------------------------- | --------------------- |
+| INSERT/upsert/UPDATE/DELETE returning | yes, via OUTPUT       |
+| Transactional DDL                     | yes                   |
+| Schemas                               | yes                   |
+| Sequences                             | yes                   |
+| Generated columns                     | yes                   |
+| Partial indexes                       | yes, filtered indexes |
+| Foreign keys                          | yes                   |
+| Row-level security                    | no                    |
+| Streaming                             | no                    |
+| Server-side cancellation              | no                    |
+
+## Refusals and ownership
+
+Pagination requires `ORDER BY`; unordered `OFFSET`/`FETCH` fails before dispatch. Row-level-security declarations, streaming and server-side cancellation are not advertised. SQL Server-specific
+identity, computed-column and filtered-index handling belongs to this vertical, rather than a generic SQL spelling.
+
+SQL Server owns its T-SQL compiler overrides, migration hooks, introspector and structural node-mssql adapter. It is an independent vertical, with no PostgreSQL or MySQL parent.
+
+## 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
+[SQL Server consumer](../../fixtures/database-mssql) 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 [SQL Server guide](../../docs-site/content/dialect-mssql.md) for the detailed contract.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/compiler.d.ts

@@ -0,0 +1,3 @@
+import { type DialectCompiler } from '@zmdb/sql';
+export declare const mssqlCompiler: DialectCompiler;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,eAAe,EAIrB,MAAM,WAAW,CAAC;AAgGnB,eAAO,MAAM,aAAa,EAAE,eAG1B,CAAC"}

package/dist/compiler.js

@@ -0,0 +1,82 @@
+import { quoteColumn, quoteIdentifier, quoteTable, UnsupportedFeatureError, } from '@zmdb/sql';
+function outputColumn(context, pseudoTable, column) {
+    if (typeof column === 'string') {
+        return column === '*' ? `${pseudoTable}.*` : `${pseudoTable}.${quoteColumn(context.dialect, column)}`;
+    }
+    return (`${pseudoTable}.${quoteColumn(context.dialect, column.column)} AS ` + quoteIdentifier(context.dialect, column.alias));
+}
+function returning(context) {
+    const pseudoTable = context.row === 'old' ? 'DELETED' : 'INSERTED';
+    // SQL Server rejects OUTPUT without INTO when the target has an enabled
+    // trigger for the statement's DML action. OUTPUT INTO would require a table
+    // variable plus a second statement, outside the one-statement compiler contract.
+    return Object.freeze({
+        inline: ` OUTPUT ${context.columns.map(column => outputColumn(context, pseudoTable, column)).join(', ')}`,
+        suffix: '',
+    });
+}
+function upsert(context) {
+    const target = context.conflict.target;
+    if (target === undefined || target.length === 0) {
+        throw new UnsupportedFeatureError('upsert without a conflict target', context.dialect.name, 'MERGE needs an explicit join predicate; pass the conflicting column(s) to onConflict(...).');
+    }
+    const keySet = new Set(context.columns);
+    for (const column of target) {
+        if (!keySet.has(column)) {
+            throw new TypeError(`MERGE conflict target ${JSON.stringify(column)} is not present in values()`);
+        }
+    }
+    const quoted = (column) => quoteIdentifier(context.dialect, column);
+    const source = (column) => `src.${quoted(column)}`;
+    const current = (column) => `tgt.${quoted(column)}`;
+    const sourceColumns = context.columns.map(quoted).join(', ');
+    const predicate = target.map(column => `${current(column)} = ${source(column)}`).join(' AND ');
+    let matched = '';
+    if (context.conflict.action === 'update') {
+        let setSql;
+        if (Array.isArray(context.conflict.updateFields)) {
+            for (const column of context.conflict.updateFields) {
+                if (!keySet.has(column)) {
+                    throw new TypeError(`MERGE update field ${JSON.stringify(column)} is not present in values()`);
+                }
+            }
+            setSql = context.conflict.updateFields.map(column => `${quoted(column)} = ${source(column)}`).join(', ');
+        }
+        else if (context.conflict.updateFields !== undefined) {
+            const entries = Object.entries(context.conflict.updateFields);
+            if (entries.length === 0)
+                throw new TypeError('MERGE doUpdate() requires at least one update field');
+            setSql = entries
+                .map(([column, value]) => {
+                if (context.isProposedValue(value) && !keySet.has(column)) {
+                    throw new TypeError(`MERGE proposed field ${JSON.stringify(column)} is not present in values()`);
+                }
+                return (`${quoted(column)} = ` +
+                    context.renderUpdateValue(column, value, {
+                        current: current(column),
+                        proposed: source(column),
+                    }));
+            })
+                .join(', ');
+        }
+        else {
+            const targetSet = new Set(target);
+            const nonTarget = context.columns.filter(column => !targetSet.has(column));
+            const updateColumns = nonTarget.length > 0 ? nonTarget : context.columns;
+            setSql = updateColumns.map(column => `${quoted(column)} = ${source(column)}`).join(', ');
+        }
+        matched = ` WHEN MATCHED THEN UPDATE SET ${setSql}`;
+    }
+    // HOLDLOCK supplies the serializable range lock that prevents concurrent
+    // upserts from both observing an absent key and racing into INSERT.
+    return (`MERGE ${quoteTable(context.dialect, context.table)} WITH (HOLDLOCK) AS tgt ` +
+        `USING (VALUES (${context.placeholders.join(', ')})) AS src (${sourceColumns}) ON ${predicate}` +
+        matched +
+        ` WHEN NOT MATCHED THEN INSERT (${sourceColumns}) VALUES (${context.columns.map(source).join(', ')})` +
+        `${context.returning.inline};`);
+}
+export const mssqlCompiler = Object.freeze({
+    returning,
+    upsert,
+});
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

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

package/dist/driver.d.ts

@@ -0,0 +1,28 @@
+import { type TransactionalDriver } from '@zmdb/orm';
+import { type CompiledQuery, type SqlDialect } from '@zmdb/sql';
+/** The node-mssql Request surface used by the adapter. */
+export interface MssqlRequest {
+    input(name: string, value: unknown): MssqlRequest;
+    query(text: string): Promise<{
+        readonly recordset?: readonly Record<string, unknown>[];
+    }>;
+}
+/** The node-mssql Transaction surface used by the adapter. */
+export interface MssqlTransaction {
+    begin(): Promise<unknown>;
+    commit(): Promise<unknown>;
+    rollback(): Promise<unknown>;
+    request(): MssqlRequest;
+}
+/** A connected node-mssql ConnectionPool, expressed structurally. */
+export interface MssqlPool {
+    request(): MssqlRequest;
+    transaction(): MssqlTransaction;
+}
+/** Per-request customization without importing the node-mssql runtime. */
+export interface MssqlOptions {
+    readonly queryTelemetry?: true;
+    readonly configureRequest?: (request: MssqlRequest, query: CompiledQuery) => void;
+}
+export declare function createMssqlDriver(dialect: SqlDialect<'mssql'>, pool: MssqlPool, options?: MssqlOptions): TransactionalDriver<'mssql'>;
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEhE,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC;IAClD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;CACJ;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,YAAY,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,YAAY,CAAC;IACxB,WAAW,IAAI,gBAAgB,CAAC;CACjC;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACnF;AA+BD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAC5B,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,YAAiB,GACzB,mBAAmB,CAAC,OAAO,CAAC,CAsB9B"}

package/dist/driver.js

@@ -0,0 +1,47 @@
+import {} from '@zmdb/orm';
+import {} from '@zmdb/sql';
+function bindValue(value) {
+    return value instanceof Date ? value.toISOString() : value;
+}
+function requestDriver(dialect, source, options) {
+    return {
+        dialect,
+        ...(options.queryTelemetry === true ? { queryTelemetry: true } : {}),
+        async execute(query, executeOptions) {
+            executeOptions?.signal?.throwIfAborted();
+            const request = source.request();
+            options.configureRequest?.(request, query);
+            query.parameters.forEach((value, index) => {
+                request.input(`p${String(index + 1)}`, bindValue(value));
+            });
+            const result = await request.query(query.text);
+            return result.recordset ?? [];
+        },
+    };
+}
+export function createMssqlDriver(dialect, pool, options = {}) {
+    const driver = requestDriver(dialect, pool, options);
+    return {
+        ...driver,
+        dialect,
+        async transaction(run) {
+            const transaction = pool.transaction();
+            await transaction.begin();
+            try {
+                const result = await run(requestDriver(dialect, transaction, options));
+                await transaction.commit();
+                return result;
+            }
+            catch (error) {
+                try {
+                    await transaction.rollback();
+                }
+                catch {
+                    // Preserve the query or callback error: rollback failure is secondary.
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAuC,MAAM,WAAW,CAAC;AAkChE,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC;AAED,SAAS,aAAa,CACpB,OAA4B,EAC5B,MAA0B,EAC1B,OAAqB;IAErB,OAAO;QACL,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc;YACjC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,OAAO,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACxC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAA4B,EAC5B,IAAe,EACf,OAAO,GAAiB,EAAE;IAE1B,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO;QACL,GAAG,MAAM;QACT,OAAO;QACP,KAAK,CAAC,WAAW,CAAS,GAAyD;YACjF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;gBACvE,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC3B,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,uEAAuE;gBACzE,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { type DatabaseVertical, type TransactionalDriver } from '@zmdb/orm';
+import { type SqlDialect } from '@zmdb/sql';
+import { type MssqlOptions, type MssqlPool, type MssqlRequest, type MssqlTransaction } from './driver.js';
+import { MSSQL_TYPES } from './types.js';
+export { mssqlIntrospector, type MssqlCatalogColumnSnapshot, type MssqlCatalogForeignKeySnapshot, type MssqlCatalogIndexSnapshot, type MssqlCatalogSchemaSnapshot, type MssqlCatalogSequenceSnapshot, type MssqlCatalogTableSnapshot, type MssqlComputedColumn, type MssqlIdentity, type MssqlIntrospector, } from './introspect.js';
+export type { MssqlOptions, MssqlPool, MssqlRequest, MssqlTransaction };
+export { MSSQL_TYPES };
+export declare const mssql: SqlDialect<'mssql'>;
+export declare function mssqlDriver(pool: MssqlPool, options?: MssqlOptions): TransactionalDriver<'mssql'>;
+export declare const mssqlVertical: DatabaseVertical<'mssql', MssqlPool, MssqlOptions>;
+//# 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,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EACL,iBAAiB,EACjB,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,CAAC;AA4EvB,eAAO,MAAM,KAAK,EAAE,UAAU,CAAC,OAAO,CAUpC,CAAC;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAEjG;AAED,eAAO,MAAM,aAAa,EAAE,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAG3E,CAAC"}

package/dist/index.js

@@ -0,0 +1,94 @@
+import {} from '@zmdb/orm';
+import { defineSqlDialect, UnsupportedFeatureError, } from '@zmdb/sql';
+import { mssqlCompiler } from './compiler.js';
+import { createMssqlDriver, } from './driver.js';
+import { mssqlIntrospector } from './introspect.js';
+import { mssqlMigrations } from './migrations.js';
+import { MSSQL_TYPES } from './types.js';
+export { mssqlIntrospector, } from './introspect.js';
+export { MSSQL_TYPES };
+function paginate({ limit, offset, ordered }) {
+    if (limit === undefined && offset === undefined)
+        return '';
+    if (!ordered) {
+        throw new UnsupportedFeatureError('pagination without ORDER BY', 'mssql', 'Dialect "mssql" spells LIMIT as OFFSET … FETCH NEXT, which SQL Server allows only after an ORDER BY. ' +
+            'Add .orderBy(...) — an unordered page is not reproducible on any dialect.');
+    }
+    let sql = ` OFFSET ${String(offset ?? 0)} ROWS`;
+    if (limit !== undefined)
+        sql += ` FETCH NEXT ${String(limit)} ROWS ONLY`;
+    return sql;
+}
+const OPERATOR_TOKEN = /^(?!.*--)[A-Za-z@<>=!~*&|?-]{1,4}$/;
+function acceptsOperator(operator) {
+    return OPERATOR_TOKEN.test(operator) && !operator.includes('@') && operator !== '#>' && operator !== '#>>';
+}
+const traits = Object.freeze({
+    placeholder: 'named',
+    quote: Object.freeze(['[', ']']),
+    paginate,
+    paginationRequiresOrder: true,
+    rowValueIn: false,
+    returning: Object.freeze({
+        insert: 'output',
+        upsert: 'output',
+        update: 'output',
+        delete: 'output',
+    }),
+    upsert: 'merge',
+    fts: 'none',
+    concat: 'function',
+    booleanNot: 'bitwise',
+    types: MSSQL_TYPES,
+    paramLimit: 2000,
+    retryableCodes: Object.freeze(['1205']),
+    acceptsOperator,
+    functions: false,
+    procedures: false,
+    tableFunctions: false,
+    vectorDistance: false,
+    spatialPredicates: false,
+});
+const capabilities = Object.freeze({
+    returning: Object.freeze({
+        insert: true,
+        upsert: true,
+        update: true,
+        delete: true,
+    }),
+    transactionalDdl: true,
+    schemas: true,
+    sequences: true,
+    generatedColumns: true,
+    partialIndexes: true,
+    foreignKeys: true,
+    rowLevelSecurity: false,
+    streaming: false,
+    cancellation: false,
+});
+const outbox = Object.freeze({
+    createTable: 'CREATE TABLE',
+    pendingIndex: 'filtered',
+    epochLiteral: "'1970-01-01T00:00:00.000+00:00'",
+    createdAtDefault: 'SYSDATETIMEOFFSET()',
+    boundedTextType: (length) => `NVARCHAR(${String(length)})`,
+});
+export const mssql = defineSqlDialect({
+    name: 'mssql',
+    family: 'mssql',
+    telemetrySystem: 'mssql',
+    traits,
+    capabilities,
+    migrations: mssqlMigrations,
+    introspector: mssqlIntrospector,
+    compiler: mssqlCompiler,
+    outbox,
+});
+export function mssqlDriver(pool, options) {
+    return createMssqlDriver(mssql, pool, options);
+}
+export const mssqlVertical = Object.freeze({
+    dialect: mssql,
+    driver: mssqlDriver,
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/introspect.d.ts

@@ -0,0 +1,45 @@
+import { type CatalogColumnSnapshot, type CatalogForeignKeySnapshot, type CatalogIndexSnapshot, type CatalogSchemaSnapshot, type CatalogTableSnapshot } from '@zmdb/migrations/introspect/runtime';
+import { type IntrospectionDriver, type Introspector, type IntrospectOptions } from '@zmdb/sql';
+export interface MssqlIdentity {
+    readonly seed: string;
+    readonly increment: string;
+}
+export interface MssqlComputedColumn {
+    readonly expression: string;
+    readonly persisted: boolean;
+}
+export interface MssqlCatalogColumnSnapshot extends CatalogColumnSnapshot {
+    readonly identity?: MssqlIdentity;
+    readonly computed?: MssqlComputedColumn;
+}
+export interface MssqlCatalogForeignKeySnapshot extends CatalogForeignKeySnapshot {
+    readonly disabled: boolean;
+    readonly trusted: boolean;
+}
+export interface MssqlCatalogIndexSnapshot extends CatalogIndexSnapshot {
+    readonly clustered: boolean;
+    readonly includedColumns: readonly string[];
+    readonly disabled: boolean;
+}
+export interface MssqlCatalogTableSnapshot extends Omit<CatalogTableSnapshot, 'columns' | 'foreignKeys' | 'indexes'> {
+    readonly columns: readonly MssqlCatalogColumnSnapshot[];
+    readonly foreignKeys: readonly MssqlCatalogForeignKeySnapshot[];
+    readonly indexes: readonly MssqlCatalogIndexSnapshot[];
+}
+export interface MssqlCatalogSequenceSnapshot {
+    readonly name: string;
+    readonly schema?: string;
+    readonly catalogType: string;
+    readonly start: string;
+    readonly increment: string;
+}
+export interface MssqlCatalogSchemaSnapshot extends Omit<CatalogSchemaSnapshot, 'tables'> {
+    readonly tables: readonly MssqlCatalogTableSnapshot[];
+    readonly sequences: readonly MssqlCatalogSequenceSnapshot[];
+}
+export interface MssqlIntrospector extends Introspector<'mssql'> {
+    readonly dialect: 'mssql';
+    snapshot(driver: IntrospectionDriver, options?: IntrospectOptions): Promise<MssqlCatalogSchemaSnapshot>;
+}
+export declare const mssqlIntrospector: MssqlIntrospector;
+//# 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,EAGL,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAE9B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAG1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAsB,KAAK,mBAAmB,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEpH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED,MAAM,WAAW,8BAA+B,SAAQ,yBAAyB;IAC/E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;IAClH,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC;IACvF,QAAQ,CAAC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY,CAAC,OAAO,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzG;AAitBD,eAAO,MAAM,iBAAiB,EAAE,iBAK9B,CAAC"}