velocious 1.0.108 → 1.0.110

package/src/database/query/join-object.js

@@ -1,67 +0,0 @@
-// @ts-check
-
-import JoinBase from "./join-base.js"
-
-/**
- * @typedef {{[key: string]: boolean | JoinObject}} JoinObject
- */
-
-export default class VelociousDatabaseQueryJoinObject extends JoinBase {
-  /**
-   * @param {JoinObject} object
-   */
-  constructor(object) {
-    super()
-    this.object = object
-  }
-
-  toSql() {
-    const modelClass = this.getQuery().modelClass
-
-    return this.joinObject(this.object, modelClass, "", 0)
-  }
-
-  /**
-   * @param {JoinObject} join
-   * @param {typeof import("../record/index.js").default} modelClass
-   * @param {string} sql
-   * @param {number} joinsCount
-   * @returns {string}
-   */
-  joinObject(join, modelClass, sql, joinsCount) {
-    const pretty = this.pretty
-    const conn = this.getQuery().driver
-
-    for (const joinKey in join) {
-      const joinValue = join[joinKey]
-      const relationship = modelClass.getRelationshipByName(joinKey)
-      const targetModelClass = relationship.getTargetModelClass()
-
-      if (joinsCount > 0) {
-        if (pretty) {
-          sql += "\n\n"
-        } else {
-          sql += " "
-        }
-      }
-
-      sql += `LEFT JOIN ${conn.quoteTable(targetModelClass.tableName())} ON `
-
-      if (relationship.getType() == "belongsTo") {
-        sql += `${conn.quoteTable(targetModelClass.tableName())}.${conn.quoteColumn(relationship.getPrimaryKey())} = `
-        sql += `${conn.quoteTable(modelClass.tableName())}.${conn.quoteColumn(relationship.getForeignKey())}`
-      } else if (relationship.getType() == "hasMany" || relationship.getType() == "hasOne") {
-        sql += `${conn.quoteTable(targetModelClass.tableName())}.${conn.quoteColumn(relationship.getForeignKey())} = `
-        sql += `${conn.quoteTable(modelClass.tableName())}.${conn.quoteColumn(relationship.getPrimaryKey())}`
-      } else {
-        throw new Error(`Unknown relationship type: ${relationship.getType()}`)
-      }
-
-      if (typeof joinValue == "object") {
-        sql = this.joinObject(joinValue, targetModelClass, sql, joinsCount + 1)
-      }
-    }
-
-    return sql
-  }
-}

package/src/database/query/join-plain.js

@@ -1,17 +0,0 @@
-// @ts-check
-
-import JoinBase from "./join-base.js"
-
-export default class VelociousDatabaseQueryJoinPlain extends JoinBase {
-  /**
-   * @param {string} plain
-   */
-  constructor(plain) {
-    super()
-    this.plain = plain
-  }
-
-  toSql() {
-    return this.plain
-  }
-}

package/src/database/query/order-base.js

@@ -1,30 +0,0 @@
-// @ts-check
-
-export default class VelociousDatabaseQueryOrderBase {
-  /**
-   * @param {import("./index.js").default} query
-   */
-  constructor(query) {
-    this.query = query
-  }
-
-  /**
-   * @returns {import("../query-parser/options.js").default}
-   */
-  getOptions() {
-    return this.query.driver.options()
-  }
-
-  /**
-   * @abstract
-   * @param {boolean} _reverseOrder
-   * @returns {void}
-   */
-  setReverseOrder(_reverseOrder) { // eslint-disable-line no-unused-vars
-    throw new Error("setReverseOrder not implemented")
-  }
-
-  toSql() {
-    throw new Error("'toSql' wasn't implemented")
-  }
-}

package/src/database/query/order-plain.js

@@ -1,27 +0,0 @@
-// @ts-check
-
-import OrderBase from "./order-base.js"
-
-export default class VelociousDatabaseQueryOrderPlain extends OrderBase {
-  /**
-   * @param {import("./index.js").default} query
-   * @param {string} plain
-   */
-  constructor(query, plain) {
-    super(query)
-    this.plain = plain
-    this.reverseOrder = false
-  }
-
-  setReverseOrder() {
-    this.reverseOrder = true
-  }
-
-  toSql() {
-    if (this.reverseOrder) {
-      return `${this.plain} DESC`
-    }
-
-    return this.plain
-  }
-}

package/src/database/query/preloader/belongs-to.js

@@ -1,63 +0,0 @@
-// @ts-check
-
-import restArgsError from "../../../utils/rest-args-error.js"
-
-export default class VelociousDatabaseQueryPreloaderBelongsTo {
-  /**
-   * @param {object} args
-   * @param {import("../../record/index.js").default[]} args.models
-   * @param {import("../../record/relationships/belongs-to.js").default} args.relationship
-   */
-  constructor({models, relationship, ...restArgs}) {
-    restArgsError(restArgs)
-
-    this.models = models
-    this.relationship = relationship
-  }
-
-  async run() {
-    /** @type {Array<number | string>} */
-    const foreignKeyValues = []
-    const foreignKey = this.relationship.getForeignKey()
-
-    for (const model of this.models) {
-      const foreignKeyValue = model.readColumn(foreignKey)
-
-      if (!foreignKeyValues.includes(foreignKeyValue)) foreignKeyValues.push(foreignKeyValue)
-    }
-
-    /** @type {Record<string, any>} */
-    const whereArgs = {}
-    const primaryKey = this.relationship.getPrimaryKey()
-
-    whereArgs[primaryKey] = foreignKeyValues
-
-    const targetModelClass = this.relationship.getTargetModelClass()
-
-    if (!targetModelClass) throw new Error("No target model class could be gotten from relationship")
-
-    // Load target models to be preloaded on the given models
-    const targetModels = await targetModelClass.where(whereArgs).toArray()
-
-    /** @type {Record<string, import("../../record/index.js").default>} */
-    const targetModelsById = {}
-
-    for (const targetModel of targetModels) {
-      const primaryKeyValue = targetModel.readColumn(this.relationship.getPrimaryKey())
-
-      targetModelsById[primaryKeyValue] = targetModel
-    }
-
-    // Set the target preloaded models on the given models
-    for (const model of this.models) {
-      const foreignKeyValue = model.readColumn(foreignKey)
-      const targetModel = targetModelsById[foreignKeyValue]
-      const modelRelationship = model.getRelationshipByName(this.relationship.getRelationshipName())
-
-      modelRelationship.setPreloaded(true)
-      modelRelationship.setLoaded(targetModel)
-    }
-
-    return targetModels
-  }
-}

package/src/database/query/preloader/has-many.js

@@ -1,83 +0,0 @@
-// @ts-check
-
-import restArgsError from "../../../utils/rest-args-error.js"
-
-export default class VelociousDatabaseQueryPreloaderHasMany {
-  /**
-   * @param {object} args
-   * @param {import("../../record/index.js").default[]} args.models
-   * @param {import("../../record/relationships/has-many.js").default} args.relationship
-   */
-  constructor({models, relationship, ...restArgs}) {
-    restArgsError(restArgs)
-
-    this.models = models
-    this.relationship = relationship
-  }
-
-  async run() {
-    /** @type {Array<number | string>} */
-    const modelsPrimaryKeyValues = []
-
-    /** @type {Record<number | string, Array<import("../../record/index.js").default>>} */
-    const modelsByPrimaryKeyValue = {}
-
-    const foreignKey = this.relationship.getForeignKey()
-    const primaryKey = this.relationship.getPrimaryKey()
-
-    /** @type {Record<number | string, Array<import("../../record/index.js").default>>} */
-    const preloadCollections = {}
-
-    if (!primaryKey) {
-      throw new Error(`${this.relationship.getModelClass().name}#${this.relationship.getRelationshipName()} doesn't have a primary key`)
-    }
-
-    for (const model of this.models) {
-      const primaryKeyValue = model.readColumn(primaryKey)
-
-      preloadCollections[primaryKeyValue] = []
-
-      if (!modelsPrimaryKeyValues.includes(primaryKeyValue)) modelsPrimaryKeyValues.push(primaryKeyValue)
-      if (!(primaryKeyValue in modelsByPrimaryKeyValue)) modelsByPrimaryKeyValue[primaryKeyValue] = []
-
-      modelsByPrimaryKeyValue[primaryKeyValue].push(model)
-    }
-
-    /** @type {Record<string, any>} */
-    const whereArgs = {}
-
-    whereArgs[foreignKey] = modelsPrimaryKeyValues
-
-    const targetModelClass = this.relationship.getTargetModelClass()
-
-    if (!targetModelClass) throw new Error("No target model class could be gotten from relationship")
-
-    // Load target models to be preloaded on the given models
-    const targetModels = await targetModelClass.where(whereArgs).toArray()
-
-    for (const targetModel of targetModels) {
-      const foreignKeyValue = targetModel.readColumn(foreignKey)
-
-      preloadCollections[foreignKeyValue].push(targetModel)
-    }
-
-    // Set the target preloaded models on the given models
-    for (const modelValue in preloadCollections) {
-      const preloadedCollection = preloadCollections[modelValue]
-
-      for (const model of modelsByPrimaryKeyValue[modelValue]) {
-        const modelRelationship = model.getRelationshipByName(this.relationship.getRelationshipName())
-
-        if (preloadedCollection.length == 0) {
-          modelRelationship.setLoaded([])
-        } else {
-          modelRelationship.addToLoaded(preloadedCollection)
-        }
-
-        modelRelationship.setPreloaded(true)
-      }
-    }
-
-    return targetModels
-  }
-}

package/src/database/query/preloader/has-one.js

@@ -1,74 +0,0 @@
-// @ts-check
-
-import restArgsError from "../../../utils/rest-args-error.js"
-
-export default class VelociousDatabaseQueryPreloaderHasOne {
-  /**
-   * @param {object} args
-   * @param {Array<import("../../record/index.js").default>} args.models
-   * @param {import("../../record/relationships/has-one.js").default} args.relationship
-   */
-  constructor({models, relationship, ...restArgs}) {
-    restArgsError(restArgs)
-
-    this.models = models
-    this.relationship = relationship
-  }
-
-  async run() {
-    /** @type {Array<number | string>} */
-    const modelsPrimaryKeyValues = []
-
-    /** @type {Record<number | string, Array<import("../../record/index.js").default>>} */
-    const modelsByPrimaryKeyValue = {}
-
-    const foreignKey = this.relationship.getForeignKey()
-    const primaryKey = this.relationship.getPrimaryKey()
-
-    /** @type {Record<number | string, import("../../record/index.js").default | undefined>} */
-    const preloadCollections = {}
-
-    for (const model of this.models) {
-      const primaryKeyValue = model.readColumn(primaryKey)
-
-      preloadCollections[primaryKeyValue] = undefined
-
-      if (!modelsPrimaryKeyValues.includes(primaryKeyValue)) modelsPrimaryKeyValues.push(primaryKeyValue)
-      if (!(primaryKeyValue in modelsByPrimaryKeyValue)) modelsByPrimaryKeyValue[primaryKeyValue] = []
-
-      modelsByPrimaryKeyValue[primaryKeyValue].push(model)
-    }
-
-    /** @type {Record<string, any>} */
-    const whereArgs = {}
-
-    whereArgs[foreignKey] = modelsPrimaryKeyValues
-
-    const targetModelClass = this.relationship.getTargetModelClass()
-
-    if (!targetModelClass) throw new Error("No target model class could be gotten from relationship")
-
-    // Load target models to be preloaded on the given models
-    const targetModels = await targetModelClass.where(whereArgs).toArray()
-
-    for (const targetModel of targetModels) {
-      const foreignKeyValue = targetModel.readColumn(foreignKey)
-
-      preloadCollections[foreignKeyValue] = targetModel
-    }
-
-    // Set the target preloaded models on the given models
-    for (const modelValue in preloadCollections) {
-      const preloadedModel = preloadCollections[modelValue]
-
-      for (const model of modelsByPrimaryKeyValue[modelValue]) {
-        const modelRelationship = model.getRelationshipByName(this.relationship.getRelationshipName())
-
-        modelRelationship.setPreloaded(true)
-        modelRelationship.setLoaded(preloadedModel)
-      }
-    }
-
-    return targetModels
-  }
-}

package/src/database/query/preloader.js

@@ -1,61 +0,0 @@
-// @ts-check
-
-import BelongsToPreloader from "./preloader/belongs-to.js"
-import HasManyPreloader from "./preloader/has-many.js"
-import HasOnePreloader from "./preloader/has-one.js"
-import restArgsError from "../../utils/rest-args-error.js"
-
-export default class VelociousDatabaseQueryPreloader {
-  /**
-   * @param {object} args
-   * @param {typeof import("../record/index.js").default} args.modelClass
-   * @param {import("../record/index.js").default[]} args.models
-   * @param {Record<string, any>} args.preload
-   */
-  constructor({modelClass, models, preload, ...restArgs}) {
-    restArgsError(restArgs)
-
-    this.modelClass = modelClass
-    this.models = models
-    this.preload = preload
-  }
-
-  async run() {
-    for (const preloadRelationshipName in this.preload) {
-      const relationship = this.modelClass.getRelationshipByName(preloadRelationshipName)
-      let targetModels
-
-      if (relationship.getType() == "belongsTo") {
-        const belongsToRelationship = /** @type {import("../record/relationships/belongs-to.js").default} */ (relationship)
-        const hasManyPreloader = new BelongsToPreloader({models: this.models, relationship: belongsToRelationship})
-
-        targetModels = await hasManyPreloader.run()
-      } else if (relationship.getType() == "hasMany") {
-        const hasManyRelationship = /** @type {import("../record/relationships/has-many.js").default} */ (relationship)
-        const hasManyPreloader = new HasManyPreloader({models: this.models, relationship: hasManyRelationship})
-
-        targetModels = await hasManyPreloader.run()
-      } else if (relationship.getType() == "hasOne") {
-        const hasOneRelationship = /** @type {import("../record/relationships/has-one.js").default} */ (relationship)
-        const hasOnePreloader = new HasOnePreloader({models: this.models, relationship: hasOneRelationship})
-
-        targetModels = await hasOnePreloader.run()
-      } else {
-        throw new Error(`Unknown relationship type: ${relationship.getType()}`)
-      }
-
-      // Handle any further preloads in the tree
-      const newPreload = this.preload[preloadRelationshipName]
-
-      if (typeof newPreload == "object" && targetModels.length > 0) {
-        const targetModelClass = relationship.getTargetModelClass()
-
-        if (!targetModelClass) throw new Error("No target model class could be gotten from relationship")
-
-        const preloader = new VelociousDatabaseQueryPreloader({modelClass: targetModelClass, models: targetModels, preload: newPreload})
-
-        await preloader.run()
-      }
-    }
-  }
-}

package/src/database/query/select-base.js

@@ -1,27 +0,0 @@
-// @ts-check
-
-export default class VelociousDatabaseQuerySelectBase {
-  /**
-   * @returns {import("../query-parser/options.js").default}
-   */
-  getOptions() {
-    if (!this.query) throw new Error("'query' hasn't been set")
-
-    return this.query.driver.options()
-  }
-
-  /**
-   * @param {import("./index.js").default} query
-   */
-  setQuery(query) {
-    this.query = query
-  }
-
-  /**
-   * @abstract
-   * @returns {string}
-   */
-  toSql() {
-    throw new Error("'toSql' wasn't implemented")
-  }
-}

package/src/database/query/select-plain.js

@@ -1,17 +0,0 @@
-// @ts-check
-
-import SelectBase from "./select-base.js"
-
-export default class VelociousDatabaseQuerySelectPlain extends SelectBase {
-  /**
-   * @param {string} plain
-   */
-  constructor(plain) {
-    super()
-    this.plain = plain
-  }
-
-  toSql() {
-    return this.plain
-  }
-}

package/src/database/query/select-table-and-column.js

@@ -1,27 +0,0 @@
-// @ts-check
-
-import SelectBase from "./select-base.js"
-
-export default class VelociousDatabaseQuerySelectTableAndColumn extends SelectBase {
-  /**
-   * @param {string} tableName
-   * @param {string} columnName
-   */
-  constructor(tableName, columnName) {
-    super()
-    this.columnName = columnName
-    this.tableName = tableName
-  }
-
-  getColumnName() {
-    return this.columnName
-  }
-
-  getTableName() {
-    return this.tableName
-  }
-
-  toSql() {
-    return `${this.getOptions().quoteTableName(this.tableName)}.${this.getOptions().quoteColumnName(this.columnName)}`
-  }
-}

package/src/database/query/update-base.js

@@ -1,28 +0,0 @@
-// @ts-check
-
-export default class VelociousDatabaseQueryUpdateBase {
-  /**
-   * @param {object} args
-   * @param {Record<string, any>} args.conditions
-   * @param {Record<string, any>} args.data
-   * @param {import("../drivers/base.js").default} args.driver
-   * @param {string} args.tableName
-   */
-  constructor({conditions, data, driver, tableName}) {
-    this.conditions = conditions
-    this.data = data
-    this.driver = driver
-    this.tableName = tableName
-  }
-
-  /**
-   * @returns {import("../query-parser/options.js").default}
-   */
-  getOptions() {
-    return this.driver.options()
-  }
-
-  toSql() {
-    throw new Error("'toSql' wasn't implemented")
-  }
-}

package/src/database/query/where-base.js

@@ -1,34 +0,0 @@
-// @ts-check
-
-export default class VelociousDatabaseQueryWhereBase {
-  /**
-   * @returns {import("../query-parser/options.js").default}
-   */
-  getOptions() {
-    return this.getQuery().getOptions()
-  }
-
-  /**
-   * @returns {import("./index.js").default}
-   */
-  getQuery() {
-    if (!this.query) throw new Error("'query' hasn't been set")
-
-    return this.query
-  }
-
-  /**
-   * @param {import("./index.js").default} query
-   */
-  setQuery(query) {
-    this.query = query
-  }
-
-  /**
-   * @abstract
-   * @returns {string}
-   */
-  toSql() {
-    throw new Error("'toSql' wasn't implemented")
-  }
-}

package/src/database/query/where-hash.js

@@ -1,66 +0,0 @@
-// @ts-check
-
-import WhereBase from "./where-base.js"
-
-/**
- * @typedef {{[key: string]: any}} WhereHash
- */
-
-export default class VelociousDatabaseQueryWhereHash extends WhereBase {
-  /**
-   * @param {import("./index.js").default} query
-   * @param {WhereHash} hash
-   */
-  constructor(query, hash) {
-    super()
-    this.hash = hash
-    this.query = query
-  }
-
-  toSql() {
-    let sql = "("
-
-    sql += this._whereSQLFromHash(this.hash)
-    sql += ")"
-
-    return sql
-  }
-
-  /**
-   * @param {WhereHash} hash
-   * @param {string} [tableName]
-   * @param {number} index
-   */
-  _whereSQLFromHash(hash, tableName, index = 0) {
-    const options = this.getOptions()
-    let sql = ""
-
-    for (const whereKey in hash) {
-      const whereValue = hash[whereKey]
-
-      if (!Array.isArray(whereValue) && whereValue !== null && typeof whereValue == "object") {
-        sql += this._whereSQLFromHash(whereValue, whereKey, index)
-      } else {
-        if (index > 0) sql += " AND "
-
-        if (tableName) {
-          sql += `${options.quoteTableName(tableName)}.`
-        }
-
-        sql += `${options.quoteColumnName(whereKey)}`
-
-        if (Array.isArray(whereValue)) {
-          sql += ` IN (${whereValue.map((value) => options.quote(value)).join(", ")})`
-        } else if (whereValue === null) {
-          sql += " IS NULL"
-        } else {
-          sql += ` = ${options.quote(whereValue)}`
-        }
-      }
-
-      index++
-    }
-
-    return sql
-  }
-}

package/src/database/query/where-plain.js

@@ -1,19 +0,0 @@
-// @ts-check
-
-import WhereBase from "./where-base.js"
-
-export default class VelociousDatabaseQueryWhereHash extends WhereBase {
-  /**
-   * @param {import("./index.js").default} query
-   * @param {string} plain
-   */
-  constructor(query, plain) {
-    super()
-    this.plain = plain
-    this.query = query
-  }
-
-  toSql() {
-    return this.plain
-  }
-}

package/src/database/query-parser/base-query-parser.js

@@ -1,39 +0,0 @@
-// @ts-check
-
-import FromParser from "./from-parser.js"
-import GroupParser from "./group-parser.js"
-import JoinsParser from "./joins-parser.js"
-import LimitParser from "./limit-parser.js"
-import OrderParser from "./order-parser.js"
-import SelectParser from "./select-parser.js"
-import WhereParser from "./where-parser.js"
-
-export default class VelociousDatabaseBaseQueryParser {
-  /**
-   * @param {object} args
-   * @param {boolean} [args.pretty]
-   * @param {import("../query/index.js").default} args.query
-   */
-  constructor({pretty = false, query}) {
-    if (!query) throw new Error("No query given")
-
-    this.pretty = pretty
-    this.query = query
-  }
-
-  toSql() {
-    const {pretty, query} = this
-
-    let sql = ""
-
-    sql += new SelectParser({pretty, query}).toSql()
-    sql += new FromParser({pretty, query}).toSql()
-    sql += new JoinsParser({pretty, query}).toSql()
-    sql += new WhereParser({pretty, query}).toSql()
-    sql += new GroupParser({pretty, query}).toSql()
-    sql += new OrderParser({pretty, query}).toSql()
-    sql += new LimitParser({pretty, query}).toSql()
-
-    return sql
-  }
-}