velocious 1.0.461 → 1.0.462

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

@@ -26,9 +26,7 @@ function normalizeRelationshipWhereOperator(operator) {
   }
 
   return /** @type {"eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like"} */ (
-    operatorAliases[/**
-                     * Narrows the runtime value to the documented type.
-                     * @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
+    operatorAliases[/** @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
   )
 }
 
@@ -66,9 +64,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
   toSql() {
     let sql = "("
 
-    const modelQuery = /**
-                        * Narrows the runtime value to the documented type.
-                        * @type {import("./model-class-query.js").default} */ (this.query)
+    const modelQuery = /** @type {import("./model-class-query.js").default} */ (this.query)
     const baseTableName = this.qualifyBaseTable
       ? modelQuery.getTableReferenceForJoin()
       : undefined
@@ -144,9 +140,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
      */
     const addCondition = (conditionValue) => {
       if (this._isRelationshipWhereOperatorTuple(conditionValue)) {
-        const tuple = /**
-                       * Narrows the runtime value to the documented type.
-                       * @type {[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like" | ">" | ">=" | "<" | "<=", unknown, ...Array<unknown>]} */ (conditionValue)
+        const tuple = /** @type {[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like" | ">" | ">=" | "<" | "<=", unknown, ...Array<unknown>]} */ (conditionValue)
         const normalizedOperator = normalizeRelationshipWhereOperator(tuple[1])
 
         normalized.push([
@@ -393,9 +387,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
    */
   _whereSQLFromHash(hash, modelClass, path, tableName, index = 0) {
     const options = this.getOptions()
-    const modelQuery = /**
-                        * Narrows the runtime value to the documented type.
-                        * @type {import("./model-class-query.js").default} */ (this.query)
+    const modelQuery = /** @type {import("./model-class-query.js").default} */ (this.query)
     let sql = ""
 
     for (const whereKey in hash) {
@@ -441,9 +433,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
 
         if (!targetModelClass) throw new Error(`Relationship "${whereKey}" for ${modelClass.name} has no target model class`)
 
-        const nestedHash = /**
-                            * Narrows the runtime value to the documented type.
-                            * @type {WhereHash} */ (whereValue)
+        const nestedHash = /** @type {WhereHash} */ (whereValue)
         const nestedPath = path.concat([whereKey])
         const nestedTableName = modelQuery.getTableReferenceForJoin(...nestedPath)
 

package/build/database/query/with-count.js

@@ -110,24 +110,18 @@ export async function runWithCount({models, modelClass, entries}) {
   if (models.length === 0 || entries.length === 0) return
 
   const primaryKey = modelClass.primaryKey()
-  const parentIds = models.map((model) => /**
-                                           * Narrows the runtime value to the documented type.
-                                           * @type {string | number} */ (model.readColumn(primaryKey)))
+  const parentIds = models.map((model) => /** @type {string | number} */ (model.readColumn(primaryKey)))
 
   for (const entry of entries) {
     const counts = await countForEntry({entries, entry, modelClass, parentIds})
 
     for (const model of models) {
-      const modelPrimaryKeyValue = /**
-                                    * Narrows the runtime value to the documented type.
-                                    * @type {string | number} */ (model.readColumn(primaryKey))
+      const modelPrimaryKeyValue = /** @type {string | number} */ (model.readColumn(primaryKey))
       // Tolerate driver differences in numeric return types: SQLite
       // returns integers as JS numbers, but MySQL's raw driver can
       // return count primary keys as strings. Try both.
       const resolvedCount = counts.has(modelPrimaryKeyValue)
-        ? /**
-           * Narrows the runtime value to the documented type.
-           * @type {number} */ (counts.get(modelPrimaryKeyValue))
+        ? /** @type {number} */ (counts.get(modelPrimaryKeyValue))
         : Number(counts.get(String(modelPrimaryKeyValue)) ?? 0)
 
       // Counts go on the record's dedicated association-count map,
@@ -196,9 +190,7 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
   countQuery.select(`${quotedTable}.${quotedFk} AS parent_id`)
   countQuery.select("COUNT(*) AS count_value")
 
-  const rows = /**
-                * Narrows the runtime value to the documented type.
-                * @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
+  const rows = /** @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
     await countQuery._executeQuery()
   )
 
@@ -208,9 +200,7 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
   const counts = new Map()
 
   for (const row of rows) {
-    const parentId = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {string | number} */ (row.parent_id)
+    const parentId = /** @type {string | number} */ (row.parent_id)
     const countValue = Number(row.count_value) || 0
     counts.set(parentId, countValue)
   }

package/build/database/record/acts-as-list.js

@@ -62,9 +62,7 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
     if (isShifting(record)) return
     if (!record.isPersisted()) return
 
-    const modelClass = /**
-                        * Narrows the runtime value to the documented type.
-                        * @type {typeof import("./index.js").default} */ (record.constructor)
+    const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
     const posColumn = modelClass.getColumnNameForAttributeName(positionColumn)
     const scopeCol = modelClass.getColumnNameForAttributeName(scope)
     /** @type {Record<string, ?>} */
@@ -79,26 +77,10 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
 
     if (!posChanged && !scopeChanged) return
 
-    const oldPosition = posChanged ? /**
-                                      * Narrows the runtime value to the documented type.
-                                      * @type {number} */ (rawAttributes[posColumn]) : /**
-                                                                                       * Narrows the runtime value to the documented type.
-                                                                                       * @type {number} */ (record.readAttribute(positionColumn))
-    const newPosition = posChanged ? /**
-                                      * Narrows the runtime value to the documented type.
-                                      * @type {number} */ (changes[posColumn]) : /**
-                                                                                 * Narrows the runtime value to the documented type.
-                                                                                 * @type {number} */ (record.readAttribute(positionColumn))
-    const oldScopeValue = scopeChanged ? /**
-                                          * Narrows the runtime value to the documented type.
-                                          * @type {number} */ (rawAttributes[scopeCol]) : /**
-                                                                                          * Narrows the runtime value to the documented type.
-                                                                                          * @type {number} */ (record.readAttribute(scope))
-    const newScopeValue = scopeChanged ? /**
-                                          * Narrows the runtime value to the documented type.
-                                          * @type {number} */ (changes[scopeCol]) : /**
-                                                                                    * Narrows the runtime value to the documented type.
-                                                                                    * @type {number} */ (record.readAttribute(scope))
+    const oldPosition = posChanged ? /** @type {number} */ (rawAttributes[posColumn]) : /** @type {number} */ (record.readAttribute(positionColumn))
+    const newPosition = posChanged ? /** @type {number} */ (changes[posColumn]) : /** @type {number} */ (record.readAttribute(positionColumn))
+    const oldScopeValue = scopeChanged ? /** @type {number} */ (rawAttributes[scopeCol]) : /** @type {number} */ (record.readAttribute(scope))
+    const newScopeValue = scopeChanged ? /** @type {number} */ (changes[scopeCol]) : /** @type {number} */ (record.readAttribute(scope))
 
     if (oldPosition == null || newPosition == null) return
     if (newPosition === oldPosition && newScopeValue === oldScopeValue) return
@@ -210,9 +192,7 @@ function clearBelongsToChangeForScope(record) {
  * @returns {Promise<void>}
  */
 async function shiftPositionsUp({record, positionColumn, scope, fromPosition, toPosition, scopeValue, excludeRecordId}) {
-  const modelClass = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {typeof import("./index.js").default} */ (record.constructor)
+  const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -277,9 +257,7 @@ async function shiftPositionsUp({record, positionColumn, scope, fromPosition, to
  * @returns {Promise<void>}
  */
 async function shiftPositionsDown({record, positionColumn, scope, fromPosition, toPosition, scopeValue}) {
-  const modelClass = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {typeof import("./index.js").default} */ (record.constructor)
+  const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -335,9 +313,7 @@ async function shiftPositionsDown({record, positionColumn, scope, fromPosition,
  * @returns {Promise<number>} - Highest position in scope, or 0 when scope is empty.
  */
 async function highestPositionInScope({record, positionColumn, scope, scopeValue}) {
-  const modelClass = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {typeof import("./index.js").default} */ (record.constructor)
+  const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
   const positionColumnName = modelClass.getColumnNameForAttributeName(positionColumn)
@@ -372,9 +348,7 @@ function resolveScopeValue(record, scope) {
 
   if (attrValue != null) return /** @type {string | number} */ (attrValue)
 
-  const modelClass = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {typeof import("./index.js").default} */ (record.constructor)
+  const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
   const relationships = modelClass.getRelationshipsMap()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
 
@@ -410,9 +384,7 @@ function resolveScopeValue(record, scope) {
  * @returns {Promise<void>}
  */
 async function moveOutOfWay({record, positionColumn, scope, scopeValue, targetScopeValue}) {
-  const modelClass = /**
-                      * Narrows the runtime value to the documented type.
-                      * @type {typeof import("./index.js").default} */ (record.constructor)
+  const modelClass = /** @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)

package/build/database/record/attachments/normalize-input.js

@@ -55,9 +55,7 @@ function isArrayBuffer(value) {
  * @returns {value is {arrayBuffer: () => Promise<ArrayBuffer>}} - Whether value supports arrayBuffer().
  */
 function isArrayBufferLike(value) {
-  return Boolean(value && typeof value === "object" && typeof /**
-                                                               * Narrows the runtime value to the documented type.
-                                                               * @type {?} */ (value).arrayBuffer === "function")
+  return Boolean(value && typeof value === "object" && typeof /** @type {?} */ (value).arrayBuffer === "function")
 }
 
 /**
@@ -81,15 +79,11 @@ function toBuffer(value) {
  * @returns {Promise<Buffer>} - File content buffer.
  */
 async function uploadedFileBuffer(uploadedFile, environmentHandler) {
-  const memoryBuffer = /**
-                        * Narrows the runtime value to the documented type.
-                        * @type {{getBuffer?: () => Buffer}} */ (uploadedFile).getBuffer?.()
+  const memoryBuffer = /** @type {{getBuffer?: () => Buffer}} */ (uploadedFile).getBuffer?.()
 
   if (Buffer.isBuffer(memoryBuffer)) return memoryBuffer
 
-  const tempPath = /**
-                    * Narrows the runtime value to the documented type.
-                    * @type {{getPath?: () => string}} */ (uploadedFile).getPath?.()
+  const tempPath = /** @type {{getPath?: () => string}} */ (uploadedFile).getPath?.()
 
   if (typeof tempPath === "string" && tempPath.length > 0) {
     if (!environmentHandler || typeof environmentHandler.readAttachmentInputFile !== "function") {
@@ -174,23 +168,11 @@ export default async function normalizeRecordAttachmentInput(input, args = {}) {
     const arrayBuffer = await input.arrayBuffer()
 
     buffer = Buffer.from(arrayBuffer)
-    filename = typeof /**
-                       * Narrows the runtime value to the documented type.
-                       * @type {?} */ (input).name === "string" && /**
-                                                                   * Narrows the runtime value to the documented type.
-                                                                   * @type {?} */ (input).name.length > 0
-      ? /**
-         * Narrows the runtime value to the documented type.
-         * @type {?} */ (input).name
+    filename = typeof /** @type {?} */ (input).name === "string" && /** @type {?} */ (input).name.length > 0
+      ? /** @type {?} */ (input).name
       : defaultFilename
-    contentType = typeof /**
-                          * Narrows the runtime value to the documented type.
-                          * @type {?} */ (input).type === "string" && /**
-                                                                      * Narrows the runtime value to the documented type.
-                                                                      * @type {?} */ (input).type.length > 0
-      ? /**
-         * Narrows the runtime value to the documented type.
-         * @type {?} */ (input).type
+    contentType = typeof /** @type {?} */ (input).type === "string" && /** @type {?} */ (input).type.length > 0
+      ? /** @type {?} */ (input).type
       : null
   } else if (typeof input === "string" || Buffer.isBuffer(input) || isArrayBuffer(input) || isUint8Array(input)) {
     buffer = toBuffer(input)

package/build/database/record/attachments/storage-drivers/s3.js

@@ -15,9 +15,7 @@ function throwS3ConfigurationError(message) {
  * @returns {boolean} - Whether value is a readable stream.
  */
 function isReadableStream(value) {
-  return Boolean(value && typeof value === "object" && typeof /**
-                                                               * Narrows the runtime value to the documented type.
-                                                               * @type {?} */ (value).pipe === "function")
+  return Boolean(value && typeof value === "object" && typeof /** @type {?} */ (value).pipe === "function")
 }
 
 /**
@@ -26,9 +24,7 @@ function isReadableStream(value) {
  * @returns {Promise<?>} - Imported module.
  */
 async function dynamicImport(specifier) {
-  const importer = /**
-                    * Narrows the runtime value to the documented type.
-                    * @type {(moduleSpecifier: string) => Promise<?>} */ (
+  const importer = /** @type {(moduleSpecifier: string) => Promise<?>} */ (
     new Function("moduleSpecifier", "return import(moduleSpecifier)")
   )
 
@@ -54,14 +50,10 @@ async function streamToBuffer(value) {
    * @type {Buffer[]} */
   const chunks = []
 
-  const readableStream = /**
-                          * Narrows the runtime value to the documented type.
-                          * @type {?} */ (value)
+  const readableStream = /** @type {?} */ (value)
 
   await new Promise((resolve, reject) => {
-    readableStream.on("data", (/**
-                                * Narrows the runtime value to the documented type.
-                                * @type {Buffer | Uint8Array | ArrayBuffer | string} */ chunk) => {
+    readableStream.on("data", (/** @type {Buffer | Uint8Array | ArrayBuffer | string} */ chunk) => {
       if (Buffer.isBuffer(chunk)) {
         chunks.push(chunk)
       } else if (chunk instanceof ArrayBuffer) {

package/build/database/record/attachments/store.js

@@ -456,9 +456,7 @@ export default class RecordAttachmentsStore {
     let attachmentDriver
 
     if (typeof driverReference === "function") {
-      const DriverClass = /**
-                           * Narrows the runtime value to the documented type.
-                           * @type {AttachmentDriverConstructor} */ (driverReference)
+      const DriverClass = /** @type {AttachmentDriverConstructor} */ (driverReference)
 
       attachmentDriver = new DriverClass({
         attachmentName,
@@ -561,9 +559,7 @@ export default class RecordAttachmentsStore {
       .order("position DESC")
       .limit(1)
     const rows = await query.results()
-    const currentRow = /**
-                        * Narrows the runtime value to the documented type.
-                        * @type {{position?: string | number | null} | undefined} */ (rows[0])
+    const currentRow = /** @type {{position?: string | number | null} | undefined} */ (rows[0])
     const current = Number(currentRow?.position)
 
     if (!Number.isFinite(current)) return 0