@mikro-orm/mssql 7.1.6 → 7.1.7-dev.0

package/MsSqlExceptionConverter.d.ts

@@ -2,8 +2,8 @@ import { ExceptionConverter, type Dictionary, type DriverException } from '@mikr
 /** Converts MSSQL native errors into typed MikroORM driver exceptions. */
 export declare class MsSqlExceptionConverter extends ExceptionConverter {
     /**
-     * @see https://docs.microsoft.com/en-us/sql/relational-databases/errors-events/mssqlserver-511-database-engine-error?view=sql-server-ver15
-     * @see https://github.com/doctrine/dbal/blob/master/src/Driver/AbstractPostgreSQLDriver.php
+     * @see https://learn.microsoft.com/en-us/sql/relational-databases/errors-events/database-engine-events-and-errors
+     * @see https://github.com/doctrine/dbal/blob/4.4.x/src/Driver/API/SQLSrv/ExceptionConverter.php
      */
     convertException(exception: Error & Dictionary): DriverException;
 }

package/MsSqlExceptionConverter.js

@@ -1,11 +1,17 @@
-import { ExceptionConverter, InvalidFieldNameException, NonUniqueFieldNameException, NotNullConstraintViolationException, SyntaxErrorException, TableExistsException, TableNotFoundException, UniqueConstraintViolationException, } from '@mikro-orm/core';
+import { CheckConstraintViolationException, DeadlockException, ExceptionConverter, ForeignKeyConstraintViolationException, InvalidFieldNameException, LockWaitTimeoutException, NonUniqueFieldNameException, NotNullConstraintViolationException, SyntaxErrorException, TableExistsException, TableNotFoundException, UniqueConstraintViolationException, } from '@mikro-orm/core';
 /** Converts MSSQL native errors into typed MikroORM driver exceptions. */
 export class MsSqlExceptionConverter extends ExceptionConverter {
     /**
-     * @see https://docs.microsoft.com/en-us/sql/relational-databases/errors-events/mssqlserver-511-database-engine-error?view=sql-server-ver15
-     * @see https://github.com/doctrine/dbal/blob/master/src/Driver/AbstractPostgreSQLDriver.php
+     * @see https://learn.microsoft.com/en-us/sql/relational-databases/errors-events/database-engine-events-and-errors
+     * @see https://github.com/doctrine/dbal/blob/4.4.x/src/Driver/API/SQLSrv/ExceptionConverter.php
      */
     convertException(exception) {
+        // the kysely mssql driver rejects with a plain array when a request produces multiple errors
+        if (Array.isArray(exception) && exception.length > 0) {
+            const [first, ...rest] = exception;
+            first.message += rest.map(e => '\n' + e.message).join('');
+            exception = first;
+        }
         let errno = exception.number;
         /* v8 ignore next */
         if ('errors' in exception &&
@@ -27,7 +33,25 @@ export class MsSqlExceptionConverter extends ExceptionConverter {
                 return new TableNotFoundException(exception);
             case 209:
                 return new NonUniqueFieldNameException(exception);
+            case 547:
+                // 547 covers both referential (FOREIGN KEY/REFERENCE) and CHECK constraint
+                // violations; only the message distinguishes them. The surrounding text is
+                // localized (e.g. "CHECK-Einschränkung" on a German server), but the
+                // constraint-type keyword itself is an untranslated SQL keyword, so match on
+                // the bare `CHECK` token.
+                if (exception.message.includes('CHECK')) {
+                    return new CheckConstraintViolationException(exception);
+                }
+                return new ForeignKeyConstraintViolationException(exception);
+            case 4712:
+                // TRUNCATE blocked because the table is referenced by a FOREIGN KEY.
+                return new ForeignKeyConstraintViolationException(exception);
+            case 1205:
+                return new DeadlockException(exception);
+            case 1222:
+                return new LockWaitTimeoutException(exception);
             case 2601:
+            case 2627:
                 return new UniqueConstraintViolationException(exception);
             case 2714:
                 return new TableExistsException(exception);

package/MsSqlSchemaGenerator.d.ts

@@ -3,6 +3,9 @@ import type { MsSqlDriver } from './MsSqlDriver.js';
 /** Schema generator with MSSQL-specific behavior for clearing and dropping schemas. */
 export declare class MsSqlSchemaGenerator extends SchemaGenerator {
     static register(orm: MikroORM<MsSqlDriver>): void;
+    createDatabase(name?: string, options?: {
+        skipOnConnect?: boolean;
+    }): Promise<void>;
     clear(options?: ClearDatabaseOptions): Promise<void>;
     getDropSchemaSQL(options?: Omit<DropSchemaOptions, 'dropDb'>): Promise<string>;
 }

package/MsSqlSchemaGenerator.js

@@ -4,6 +4,21 @@ export class MsSqlSchemaGenerator extends SchemaGenerator {
     static register(orm) {
         orm.config.registerExtension('@mikro-orm/schema-generator', () => new MsSqlSchemaGenerator(orm.em));
     }
+    async createDatabase(name, options) {
+        // `create database` clones the `model` database under an exclusive lock, so concurrent
+        // calls (e.g. parallel test workers) can fail with error 1807 — retry a few times
+        for (let attempt = 1;; attempt++) {
+            try {
+                return await super.createDatabase(name, options);
+            }
+            catch (e) {
+                if (attempt >= 5 || e?.number !== 1807) {
+                    throw e;
+                }
+                await new Promise(resolve => setTimeout(resolve, attempt * 200));
+            }
+        }
+    }
     async clear(options) {
         // truncate by default, so no value is considered as true
         /* v8 ignore next */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikro-orm/mssql",
-  "version": "7.1.6",
+  "version": "7.1.7-dev.0",
   "description": "TypeScript ORM for Node.js based on Data Mapper, Unit of Work and Identity Map patterns. Supports MongoDB, MySQL, PostgreSQL and SQLite databases as well as usage with vanilla JavaScript.",
   "keywords": [
     "data-mapper",
@@ -47,7 +47,7 @@
     "copy": "node ../../scripts/copy.mjs"
   },
   "dependencies": {
-    "@mikro-orm/sql": "7.1.6",
+    "@mikro-orm/sql": "7.1.7-dev.0",
     "kysely": "0.29.3",
     "tarn": "3.1.2",
     "tedious": "20.0.0",
@@ -57,7 +57,7 @@
     "@mikro-orm/core": "^7.1.6"
   },
   "peerDependencies": {
-    "@mikro-orm/core": "7.1.6"
+    "@mikro-orm/core": "7.1.7-dev.0"
   },
   "engines": {
     "node": ">= 22.17.0"