velocious 1.0.430 → 1.0.432

package/build/database/query/upsert-base.js

@@ -0,0 +1,103 @@
+// @ts-check
+
+import restArgsError from "../../utils/rest-args-error.js"
+
+export default class VelociousDatabaseQueryUpsertBase {
+  /**
+   * Runs constructor.
+   * @param {object} args - Options object.
+   * @param {Array<string>} args.conflictColumns - Columns that identify duplicates.
+   * @param {Record<string, ?>} args.data - Data payload.
+   * @param {import("../drivers/base.js").default} args.driver - Database driver instance.
+   * @param {Array<string>} args.updateColumns - Columns to update on conflict.
+   * @param {string} args.tableName - Table name.
+   */
+  constructor({conflictColumns, data, driver, tableName, updateColumns, ...restArgs}) {
+    if (!driver) throw new Error("No driver given to upsert base")
+    if (!tableName) throw new Error(`Invalid table name given to upsert base: ${tableName}`)
+    if (!conflictColumns?.length) throw new Error("No conflictColumns given to upsert base")
+    if (!updateColumns?.length) throw new Error("No updateColumns given to upsert base")
+    if (!data || Object.keys(data).length <= 0) throw new Error("No data given to upsert base")
+
+    restArgsError(restArgs)
+
+    this.conflictColumns = conflictColumns
+    this.data = data
+    this.driver = driver
+    this.tableName = tableName
+    this.updateColumns = updateColumns
+  }
+
+  /**
+   * Runs data columns.
+   * @returns {Array<string>} - Column names from the data payload.
+   */
+  dataColumns() {
+    return Object.keys(this.data)
+  }
+
+  /**
+   * Runs format column value.
+   * @param {string} columnName - Column name.
+   * @returns {string | number} - SQL literal.
+   */
+  formatColumnValue(columnName) {
+    return this.formatValue(this.data[columnName])
+  }
+
+  /**
+   * Runs format value.
+   * @param {?} value - Value to format.
+   * @returns {string | number} - SQL literal.
+   */
+  formatValue(value) {
+    if (value === null) return "NULL"
+
+    return this.getOptions().quote(value)
+  }
+
+  /**
+   * Runs get options.
+   * @returns {import("../query-parser/options.js").default} - Driver options.
+   */
+  getOptions() {
+    return this.driver.options()
+  }
+
+  /**
+   * Runs quoted column.
+   * @param {string} columnName - Column name.
+   * @returns {string} - Quoted column name.
+   */
+  quotedColumn(columnName) {
+    return this.getOptions().quoteColumnName(columnName)
+  }
+
+  /**
+   * Runs quoted insert columns sql.
+   * @returns {string} - Comma-separated quoted insert columns.
+   */
+  quotedInsertColumnsSql() {
+    return this.dataColumns().map((columnName) => this.quotedColumn(columnName)).join(", ")
+  }
+
+  /**
+   * Runs quoted insert values sql.
+   * @returns {string} - Comma-separated formatted insert values.
+   */
+  quotedInsertValuesSql() {
+    return this.dataColumns().map((columnName) => this.formatColumnValue(columnName)).join(", ")
+  }
+
+  /**
+   * Runs quoted table name.
+   * @returns {string} - Quoted table name.
+   */
+  quotedTableName() {
+    return this.driver.quoteTable(this.tableName)
+  }
+
+  toSql() {
+    throw new Error("'toSql' wasn't implemented")
+  }
+}

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

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

package/build/database/query/where-combinator.js

@@ -0,0 +1,31 @@
+// @ts-check
+
+import WhereBase from "./where-base.js"
+
+export default class VelociousDatabaseQueryWhereCombinator extends WhereBase {
+  /**
+   * Runs constructor.
+   * @param {object} args - Options.
+   * @param {"and" | "or"} args.combinator - SQL boolean combinator.
+   * @param {import("./index.js").default} args.query - Query instance.
+   * @param {import("./where-base.js").default[]} args.wheres - Where clauses to combine.
+   */
+  constructor({combinator, query, wheres}) {
+    super()
+    this.combinator = combinator
+    this.query = query
+    this.wheres = wheres
+  }
+
+  /**
+   * Returns the toSql result.
+   * @returns {string} - SQL string.
+   */
+  toSql() {
+    if (this.wheres.length < 1) return "(1=1)"
+
+    const separator = ` ${this.combinator.toUpperCase()} `
+
+    return `(${this.wheres.map((where) => where.toSql()).join(separator)})`
+  }
+}

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

@@ -0,0 +1,77 @@
+// @ts-check
+
+import WhereBase from "./where-base.js"
+
+/**
+ * VelociousDatabaseQueryWhereHash class.
+ * @typedef {{[key: string]: string | number | boolean | null | Array<string | number | boolean | null> | WhereHash}} WhereHash
+ */
+
+export default class VelociousDatabaseQueryWhereHash extends WhereBase {
+  /**
+   * Runs constructor.
+   * @param {import("./index.js").default} query - Query instance.
+   * @param {WhereHash} hash - Hash.
+   */
+  constructor(query, hash) {
+    super()
+    this.hash = hash
+    this.query = query
+  }
+
+  /**
+   * Runs to sql.
+   * @returns {string} - SQL string.
+   */
+  toSql() {
+    let sql = "("
+
+    sql += this._whereSQLFromHash(this.hash)
+    sql += ")"
+
+    return sql
+  }
+
+  /**
+   * Runs where sqlfrom hash.
+   * @param {WhereHash} hash - Hash.
+   * @param {string} [tableName] - Table name.
+   * @param {number} index - Index value.
+   * @returns {string} - SQL string.
+   */
+  _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.length === 0) {
+        if (index > 0) sql += " AND "
+        sql += "1=0"
+      } else 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
+  }
+}