@spinajs/orm-sql 2.0.491 → 2.0.495

package/README.md

@@ -1,69 +1,69 @@
-# `@spinajs/orm-sql`
-
-The generic SQL layer for [`@spinajs/orm`](../orm): concrete, dialect-neutral statements and
-compilers, plus `SqlDriver` — the base class every dialect driver extends.
-
-You rarely install it directly. It arrives as a dependency of
-[`@spinajs/orm-sqlite`](../orm-sqlite), [`@spinajs/orm-mysql`](../orm-mysql) or
-[`@spinajs/orm-mssql`](../orm-mssql).
-
-## What it provides
-
-- **`SqlDriver`** — implements `OrmDriver.execute()` in terms of one abstract method,
-  `executeOnDb(stmt, params, context)`. A dialect driver only has to know how to send a string
-  with bindings to its server.
-- **Statements** — `SqlWhereStatement`, `SqlJoinStatement`, `SqlColumnStatement`,
-  `SqlInStatement`, `SqlExistsQueryStatement` and the rest.
-- **Compilers** — one per query shape, from `SqlSelectQueryCompiler` to
-  `SqlTableHistoryQueryCompiler`.
-- **Converters** — `SqlDatetimeValueConverter`, `SqlBooleanValueConverter`,
-  `SqlTimeValueConverter`, `SqlSetConverter`.
-
-`SqlDriver.resolve()` registers all of it into the driver's own child DI container, so a dialect
-overrides only what genuinely differs.
-
-## Usage
-
-```ts
-import { SqlDriver } from '@spinajs/orm-sql';
-import { QueryContext, ServerResponseMapper } from '@spinajs/orm';
-import { Injectable } from '@spinajs/di';
-
-@Injectable('orm-driver-mydb')
-export class MyDbOrmDriver extends SqlDriver {
-  public async executeOnDb(stmt: string, params: unknown[], _context: QueryContext) {
-    return this.withReconnect(() => myClient.query(stmt, params));
-  }
-
-  public resolve() {
-    super.resolve();
-    // Mandatory: no generic implementation exists for either of these.
-    this.Container.register(MyServerResponseMapper).as(ServerResponseMapper);
-    this.Container.register(MyTableExistsCompiler).as(TableExistsCompiler);
-  }
-
-  // ... connect / disconnect / ping / supportedFeatures / tableInfo
-  // ... plus the six transaction primitives
-}
-```
-
-## Documentation
-
-Full documentation lives in **[docs/](docs/)**.
-
-| | Page |
-| --- | --- |
-| 01 | [Overview](docs/01-overview.md) |
-| 02 | [Compilers](docs/02-compilers.md) |
-| 03 | [Statements](docs/03-statements.md) |
-| 04 | [Writing a driver](docs/04-writing-a-driver.md) |
-
-See also [the core's architecture page](../orm/docs/12-architecture.md) for how a query becomes
-SQL, end to end.
-
-## Development
-
-```bash
-npm test        # compiles builders and asserts on the SQL — no database required
-npm run build
-```
+# `@spinajs/orm-sql`
+
+The generic SQL layer for [`@spinajs/orm`](../orm): concrete, dialect-neutral statements and
+compilers, plus `SqlDriver` — the base class every dialect driver extends.
+
+You rarely install it directly. It arrives as a dependency of
+[`@spinajs/orm-sqlite`](../orm-sqlite), [`@spinajs/orm-mysql`](../orm-mysql) or
+[`@spinajs/orm-mssql`](../orm-mssql).
+
+## What it provides
+
+- **`SqlDriver`** — implements `OrmDriver.execute()` in terms of one abstract method,
+  `executeOnDb(stmt, params, context)`. A dialect driver only has to know how to send a string
+  with bindings to its server.
+- **Statements** — `SqlWhereStatement`, `SqlJoinStatement`, `SqlColumnStatement`,
+  `SqlInStatement`, `SqlExistsQueryStatement` and the rest.
+- **Compilers** — one per query shape, from `SqlSelectQueryCompiler` to
+  `SqlTableHistoryQueryCompiler`.
+- **Converters** — `SqlDatetimeValueConverter`, `SqlBooleanValueConverter`,
+  `SqlTimeValueConverter`, `SqlSetConverter`.
+
+`SqlDriver.resolve()` registers all of it into the driver's own child DI container, so a dialect
+overrides only what genuinely differs.
+
+## Usage
+
+```ts
+import { SqlDriver } from '@spinajs/orm-sql';
+import { QueryContext, ServerResponseMapper } from '@spinajs/orm';
+import { Injectable } from '@spinajs/di';
+
+@Injectable('orm-driver-mydb')
+export class MyDbOrmDriver extends SqlDriver {
+  public async executeOnDb(stmt: string, params: unknown[], _context: QueryContext) {
+    return this.withReconnect(() => myClient.query(stmt, params));
+  }
+
+  public resolve() {
+    super.resolve();
+    // Mandatory: no generic implementation exists for either of these.
+    this.Container.register(MyServerResponseMapper).as(ServerResponseMapper);
+    this.Container.register(MyTableExistsCompiler).as(TableExistsCompiler);
+  }
+
+  // ... connect / disconnect / ping / supportedFeatures / tableInfo
+  // ... plus the six transaction primitives
+}
+```
+
+## Documentation
+
+Full documentation lives in **[docs/](docs/)**.
+
+| | Page |
+| --- | --- |
+| 01 | [Overview](docs/01-overview.md) |
+| 02 | [Compilers](docs/02-compilers.md) |
+| 03 | [Statements](docs/03-statements.md) |
+| 04 | [Writing a driver](docs/04-writing-a-driver.md) |
+
+See also [the core's architecture page](../orm/docs/12-architecture.md) for how a query becomes
+SQL, end to end.
+
+## Development
+
+```bash
+npm test        # compiles builders and asserts on the SQL — no database required
+npm run build
+```

package/lib/cjs/compilers.js

@@ -946,8 +946,8 @@ let SqlTableHistoryQueryCompiler = class SqlTableHistoryQueryCompiler extends or
             ...dropUnique,
             {
                 bindings: [],
-                expression: `ALTER TABLE ${hTtblName} 
-                      CHANGE COLUMN ${pKey.Name} ${pKey.Name} INT NOT NULL ,
+                expression: `ALTER TABLE ${hTtblName} 
+                      CHANGE COLUMN ${pKey.Name} ${pKey.Name} INT NOT NULL ,
                      DROP PRIMARY KEY;`,
             },
             // remove primary key & add history columns
@@ -961,12 +961,12 @@ let SqlTableHistoryQueryCompiler = class SqlTableHistoryQueryCompiler extends or
             },
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-        CREATE TRIGGER ${hTriggerName}__insert_trigger BEFORE INSERT ON ${hTtblName} FOR EACH ROW 
-        BEGIN 
-          DECLARE rev INT;
-          SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-          SET NEW.__revision__ = rev + 1; 
+                expression: `DELIMITER $$ 
+        CREATE TRIGGER ${hTriggerName}__insert_trigger BEFORE INSERT ON ${hTtblName} FOR EACH ROW 
+        BEGIN 
+          DECLARE rev INT;
+          SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+          SET NEW.__revision__ = rev + 1; 
         END;`,
             },
             // create tracking triggers
@@ -985,32 +985,32 @@ let SqlTableHistoryQueryCompiler = class SqlTableHistoryQueryCompiler extends or
             // insert into history table & update __end__ date for all operations
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-                     CREATE TRIGGER ${tblTriggerName}__insert_trigger AFTER INSERT ON ${tblName} FOR EACH ROW BEGIN 
-                        DECLARE rev INT;
-                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
-                        INSERT INTO ${hTtblName} SELECT 'insert', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
+                expression: `DELIMITER $$ 
+                     CREATE TRIGGER ${tblTriggerName}__insert_trigger AFTER INSERT ON ${tblName} FOR EACH ROW BEGIN 
+                        DECLARE rev INT;
+                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
+                        INSERT INTO ${hTtblName} SELECT 'insert', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
                     END;`,
             },
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-                     CREATE TRIGGER ${tblTriggerName}__update_trigger AFTER UPDATE ON ${tblName} FOR EACH ROW BEGIN 
-                        DECLARE rev INT;
-                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
-                        INSERT INTO ${hTtblName} SELECT 'update', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
+                expression: `DELIMITER $$ 
+                     CREATE TRIGGER ${tblTriggerName}__update_trigger AFTER UPDATE ON ${tblName} FOR EACH ROW BEGIN 
+                        DECLARE rev INT;
+                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
+                        INSERT INTO ${hTtblName} SELECT 'update', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
                       END;`,
             },
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-                     CREATE TRIGGER ${tblTriggerName}__delete_trigger BEFORE DELETE ON ${tblName} FOR EACH ROW BEGIN 
-                        DECLARE rev INT;
-                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
-                        INSERT INTO ${hTtblName} SELECT 'delete', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
+                expression: `DELIMITER $$ 
+                     CREATE TRIGGER ${tblTriggerName}__delete_trigger BEFORE DELETE ON ${tblName} FOR EACH ROW BEGIN 
+                        DECLARE rev INT;
+                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
+                        INSERT INTO ${hTtblName} SELECT 'delete', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
                      END;`,
             },
         ];

package/lib/mjs/compilers.js

@@ -936,8 +936,8 @@ let SqlTableHistoryQueryCompiler = class SqlTableHistoryQueryCompiler extends Ta
             ...dropUnique,
             {
                 bindings: [],
-                expression: `ALTER TABLE ${hTtblName} 
-                      CHANGE COLUMN ${pKey.Name} ${pKey.Name} INT NOT NULL ,
+                expression: `ALTER TABLE ${hTtblName} 
+                      CHANGE COLUMN ${pKey.Name} ${pKey.Name} INT NOT NULL ,
                      DROP PRIMARY KEY;`,
             },
             // remove primary key & add history columns
@@ -951,12 +951,12 @@ let SqlTableHistoryQueryCompiler = class SqlTableHistoryQueryCompiler extends Ta
             },
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-        CREATE TRIGGER ${hTriggerName}__insert_trigger BEFORE INSERT ON ${hTtblName} FOR EACH ROW 
-        BEGIN 
-          DECLARE rev INT;
-          SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-          SET NEW.__revision__ = rev + 1; 
+                expression: `DELIMITER $$ 
+        CREATE TRIGGER ${hTriggerName}__insert_trigger BEFORE INSERT ON ${hTtblName} FOR EACH ROW 
+        BEGIN 
+          DECLARE rev INT;
+          SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+          SET NEW.__revision__ = rev + 1; 
         END;`,
             },
             // create tracking triggers
@@ -975,32 +975,32 @@ let SqlTableHistoryQueryCompiler = class SqlTableHistoryQueryCompiler extends Ta
             // insert into history table & update __end__ date for all operations
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-                     CREATE TRIGGER ${tblTriggerName}__insert_trigger AFTER INSERT ON ${tblName} FOR EACH ROW BEGIN 
-                        DECLARE rev INT;
-                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
-                        INSERT INTO ${hTtblName} SELECT 'insert', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
+                expression: `DELIMITER $$ 
+                     CREATE TRIGGER ${tblTriggerName}__insert_trigger AFTER INSERT ON ${tblName} FOR EACH ROW BEGIN 
+                        DECLARE rev INT;
+                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
+                        INSERT INTO ${hTtblName} SELECT 'insert', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
                     END;`,
             },
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-                     CREATE TRIGGER ${tblTriggerName}__update_trigger AFTER UPDATE ON ${tblName} FOR EACH ROW BEGIN 
-                        DECLARE rev INT;
-                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
-                        INSERT INTO ${hTtblName} SELECT 'update', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
+                expression: `DELIMITER $$ 
+                     CREATE TRIGGER ${tblTriggerName}__update_trigger AFTER UPDATE ON ${tblName} FOR EACH ROW BEGIN 
+                        DECLARE rev INT;
+                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
+                        INSERT INTO ${hTtblName} SELECT 'update', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
                       END;`,
             },
             {
                 bindings: [],
-                expression: `DELIMITER $$ 
-                     CREATE TRIGGER ${tblTriggerName}__delete_trigger BEFORE DELETE ON ${tblName} FOR EACH ROW BEGIN 
-                        DECLARE rev INT;
-                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
-                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
-                        INSERT INTO ${hTtblName} SELECT 'delete', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
+                expression: `DELIMITER $$ 
+                     CREATE TRIGGER ${tblTriggerName}__delete_trigger BEFORE DELETE ON ${tblName} FOR EACH ROW BEGIN 
+                        DECLARE rev INT;
+                        SET rev = (SELECT IFNULL(MAX(__revision__), 0) FROM ${hTtblName} WHERE Id = NEW.Id);
+                        UPDATE ${hTtblName} SET __end__ = NOW() WHERE Id = NEW.Id AND __revision__ = rev;
+                        INSERT INTO ${hTtblName} SELECT 'delete', 0, NOW(), NULL, d.* FROM ${tblName} AS d WHERE d.${pKey.Name} = NEW.${pKey.Name}; 
                      END;`,
             },
         ];