AsyncPipe; table schemata; migrations; File logging

src/orm/builder/AbstractBuilder.ts

@@ -1,4 +1,4 @@
-import {Inject} from '../../di'
+import {Inject, Injectable} from '../../di'
 import {DatabaseService} from '../DatabaseService'
 import {
     Constraint, ConstraintConnectionOperator,
@@ -9,7 +9,7 @@ import {
     SpecifiedField,
 } from '../types'
 import {Connection} from '../connection/Connection'
-import {deepCopy, ErrorWithContext} from '../../util'
+import {deepCopy, ErrorWithContext, Maybe} from '../../util'
 import {EscapeValue, QuerySafeValue, raw} from '../dialect/SQLDialect'
 import {ResultCollection} from './result/ResultCollection'
 import {AbstractResultIterable} from './result/AbstractResultIterable'
@@ -24,6 +24,7 @@ export type ConstraintGroupClosure<T> = (group: AbstractBuilder<T>) => any
  * A base class that facilitates building database queries using a fluent interface.
  * This can be specialized by child-classes to yield query results of the given type `T`.
  */
+@Injectable()
 export abstract class AbstractBuilder<T> extends AppClass {
     @Inject()
     protected readonly databaseService!: DatabaseService
@@ -55,6 +56,9 @@ export abstract class AbstractBuilder<T> extends AppClass {
     /** The connection on which the query should be executed. */
     protected registeredConnection?: Connection
 
+    /** Raw SQL to use instead. Overrides builder methods. */
+    protected rawSql?: string
+
     /**
      * Create a new, empty, instance of the current builder.
      */
@@ -80,6 +84,7 @@ export abstract class AbstractBuilder<T> extends AppClass {
         bldr.registeredGroupings = deepCopy(this.registeredGroupings)
         bldr.registeredOrders = deepCopy(this.registeredOrders)
         bldr.registeredConnection = this.registeredConnection
+        bldr.rawSql = this.rawSql
 
         return bldr
     }
@@ -115,6 +120,11 @@ export abstract class AbstractBuilder<T> extends AppClass {
         return deepCopy(this.registeredOrders)
     }
 
+    /** Get the raw SQL overriding the builder methods, if it exists. */
+    public get appliedRawSql(): Maybe<string> {
+        return this.rawSql
+    }
+
     /** Get the source table for this query. */
     public get querySource(): QuerySource | undefined {
         if ( this.source ) {
@@ -555,6 +565,21 @@ export abstract class AbstractBuilder<T> extends AppClass {
         return Boolean(result.rows.first())
     }
 
+    /**
+     * Set the query manually. Overrides any builder methods.
+     * @example
+     * ```ts
+     * (new Builder())
+     *  .raw('SELECT NOW() AS example_column')
+     *  .get()
+     * ```
+     * @param sql
+     */
+    raw(sql: string): this {
+        this.rawSql = sql
+        return this
+    }
+
     /**
      * Adds a constraint to this query. This is used internally by the various `where`, `whereIn`, `orWhereNot`, &c.
      * @param preop

src/orm/builder/Builder.ts

@@ -1,5 +1,5 @@
 import {ErrorWithContext} from '../../util'
-import {Container} from '../../di'
+import {Container, Injectable} from '../../di'
 import {ResultIterable} from './result/ResultIterable'
 import {QueryRow} from '../types'
 import {AbstractBuilder} from './AbstractBuilder'
@@ -8,6 +8,7 @@ import {AbstractResultIterable} from './result/AbstractResultIterable'
 /**
  * Implementation of the abstract builder class that returns simple QueryRow objects.
  */
+@Injectable()
 export class Builder extends AbstractBuilder<QueryRow> {
     public getNewInstance(): AbstractBuilder<QueryRow> {
         return Container.getContainer().make<Builder>(Builder)