velocious 1.0.449 → 1.0.450

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

@@ -47,7 +47,7 @@ export function normalizeWithCount(spec) {
   if (typeof spec === "object") {
     /**
      * Entries.
-      @type {WithCountEntry[]} */
+     * @type {WithCountEntry[]} */
     const entries = []
 
     for (const [key, value] of Object.entries(spec)) {
@@ -63,7 +63,7 @@ export function normalizeWithCount(spec) {
       if (typeof value === "object" && value !== null) {
         /**
          * Options.
-          @type {{relationship?: string, where?: Record<string, ?>}} */
+         * @type {{relationship?: string, where?: Record<string, ?>}} */
         const options = value
         entries.push({
           attributeName: key,
@@ -112,7 +112,7 @@ export async function runWithCount({models, modelClass, entries}) {
   const primaryKey = modelClass.primaryKey()
   const parentIds = models.map((model) => /**
                                            * Narrows the runtime value to the documented type.
-                                            @type {string | number} */ (model.readColumn(primaryKey)))
+                                           * @type {string | number} */ (model.readColumn(primaryKey)))
 
   for (const entry of entries) {
     const counts = await countForEntry({entries, entry, modelClass, parentIds})
@@ -120,14 +120,14 @@ export async function runWithCount({models, modelClass, entries}) {
     for (const model of models) {
       const modelPrimaryKeyValue = /**
                                     * Narrows the runtime value to the documented type.
-                                     @type {string | number} */ (model.readColumn(primaryKey))
+                                    * @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,
@@ -170,7 +170,7 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
   const foreignKey = relationship.getForeignKey()
   /**
    * Where conditions.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const whereConditions = {[foreignKey]: parentIds}
 
   if (relationship.getPolymorphic && relationship.getPolymorphic()) {
@@ -198,19 +198,19 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
 
   const rows = /**
                 * Narrows the runtime value to the documented type.
-                 @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
+                * @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
     await countQuery._executeQuery()
   )
 
   /**
    * Counts.
-    @type {Map<string | number, number>} */
+   * @type {Map<string | number, number>} */
   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)
+                      * @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

@@ -64,7 +64,7 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
 
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof import("./index.js").default} */ (record.constructor)
+                        * @type {typeof import("./index.js").default} */ (record.constructor)
     const posColumn = modelClass.getColumnNameForAttributeName(positionColumn)
     const scopeCol = modelClass.getColumnNameForAttributeName(scope)
     /** @type {Record<string, ?>} */
@@ -81,24 +81,24 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
 
     const oldPosition = posChanged ? /**
                                       * Narrows the runtime value to the documented type.
-                                       @type {number} */ (rawAttributes[posColumn]) : /**
+                                      * @type {number} */ (rawAttributes[posColumn]) : /**
                                                                                        * Narrows the runtime value to the documented type.
-                                                                                        @type {number} */ (record.readAttribute(positionColumn))
+                                                                                       * @type {number} */ (record.readAttribute(positionColumn))
     const newPosition = posChanged ? /**
                                       * Narrows the runtime value to the documented type.
-                                       @type {number} */ (changes[posColumn]) : /**
+                                      * @type {number} */ (changes[posColumn]) : /**
                                                                                  * Narrows the runtime value to the documented type.
-                                                                                  @type {number} */ (record.readAttribute(positionColumn))
+                                                                                 * @type {number} */ (record.readAttribute(positionColumn))
     const oldScopeValue = scopeChanged ? /**
                                           * Narrows the runtime value to the documented type.
-                                           @type {number} */ (rawAttributes[scopeCol]) : /**
+                                          * @type {number} */ (rawAttributes[scopeCol]) : /**
                                                                                           * Narrows the runtime value to the documented type.
-                                                                                           @type {number} */ (record.readAttribute(scope))
+                                                                                          * @type {number} */ (record.readAttribute(scope))
     const newScopeValue = scopeChanged ? /**
                                           * Narrows the runtime value to the documented type.
-                                           @type {number} */ (changes[scopeCol]) : /**
+                                          * @type {number} */ (changes[scopeCol]) : /**
                                                                                     * Narrows the runtime value to the documented type.
-                                                                                     @type {number} */ (record.readAttribute(scope))
+                                                                                    * @type {number} */ (record.readAttribute(scope))
 
     if (oldPosition == null || newPosition == null) return
     if (newPosition === oldPosition && newScopeValue === oldScopeValue) return
@@ -212,7 +212,7 @@ function clearBelongsToChangeForScope(record) {
 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)
+                      * @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)
@@ -279,7 +279,7 @@ async function shiftPositionsUp({record, positionColumn, scope, fromPosition, to
 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)
+                      * @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)
@@ -337,7 +337,7 @@ async function shiftPositionsDown({record, positionColumn, scope, fromPosition,
 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)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
   const positionColumnName = modelClass.getColumnNameForAttributeName(positionColumn)
@@ -370,11 +370,11 @@ async function highestPositionInScope({record, positionColumn, scope, scopeValue
 function resolveScopeValue(record, scope) {
   const attrValue = record.readAttribute(scope)
 
-  if (attrValue != null) return /** Narrows the runtime value to the documented type. @type {string | number} */ (attrValue)
+  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)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const relationships = modelClass.getRelationshipsMap()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
 
@@ -412,7 +412,7 @@ function resolveScopeValue(record, scope) {
 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)
+                      * @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/handle.js

@@ -39,7 +39,7 @@ function isArray(value) {
 export default class RecordAttachmentHandle {
   /**
    * Pending inputs.
-    @type {Array<?>} */
+   * @type {Array<?>} */
   pendingInputs = []
 
   /**
@@ -155,7 +155,7 @@ export default class RecordAttachmentHandle {
     const rows = await store.findMany({model: this.model, name: this.name})
     /**
      * Downloads.
-      @type {RecordAttachmentDownload[]} */
+     * @type {RecordAttachmentDownload[]} */
     const downloads = []
 
     for (const row of rows) {

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

@@ -57,7 +57,7 @@ function isArrayBuffer(value) {
 function isArrayBufferLike(value) {
   return Boolean(value && typeof value === "object" && typeof /**
                                                                * Narrows the runtime value to the documented type.
-                                                                @type {?} */ (value).arrayBuffer === "function")
+                                                               * @type {?} */ (value).arrayBuffer === "function")
 }
 
 /**
@@ -83,13 +83,13 @@ function toBuffer(value) {
 async function uploadedFileBuffer(uploadedFile, environmentHandler) {
   const memoryBuffer = /**
                         * Narrows the runtime value to the documented type.
-                         @type {{getBuffer?: () => Buffer}} */ (uploadedFile).getBuffer?.()
+                        * @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?.()
+                    * @type {{getPath?: () => string}} */ (uploadedFile).getPath?.()
 
   if (typeof tempPath === "string" && tempPath.length > 0) {
     if (!environmentHandler || typeof environmentHandler.readAttachmentInputFile !== "function") {
@@ -127,15 +127,15 @@ export default async function normalizeRecordAttachmentInput(input, args = {}) {
   const environmentHandler = args.environmentHandler
   /**
    * Defines buffer.
-    @type {Buffer} */
+   * @type {Buffer} */
   let buffer
   /**
    * Content type.
-    @type {string | null} */
+   * @type {string | null} */
   let contentType = null
   /**
    * Defines filename.
-    @type {string | undefined} */
+   * @type {string | undefined} */
   let filename
 
   if (input instanceof UploadedFile) {
@@ -176,21 +176,21 @@ export default async function normalizeRecordAttachmentInput(input, args = {}) {
     buffer = Buffer.from(arrayBuffer)
     filename = typeof /**
                        * Narrows the runtime value to the documented type.
-                        @type {?} */ (input).name === "string" && /**
+                       * @type {?} */ (input).name === "string" && /**
                                                                    * Narrows the runtime value to the documented type.
-                                                                    @type {?} */ (input).name.length > 0
+                                                                   * @type {?} */ (input).name.length > 0
       ? /**
          * Narrows the runtime value to the documented type.
-          @type {?} */ (input).name
+         * @type {?} */ (input).name
       : defaultFilename
     contentType = typeof /**
                           * Narrows the runtime value to the documented type.
-                           @type {?} */ (input).type === "string" && /**
+                          * @type {?} */ (input).type === "string" && /**
                                                                       * Narrows the runtime value to the documented type.
-                                                                       @type {?} */ (input).type.length > 0
+                                                                      * @type {?} */ (input).type.length > 0
       ? /**
          * Narrows the runtime value to the documented type.
-          @type {?} */ (input).type
+         * @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

@@ -17,7 +17,7 @@ function throwS3ConfigurationError(message) {
 function isReadableStream(value) {
   return Boolean(value && typeof value === "object" && typeof /**
                                                                * Narrows the runtime value to the documented type.
-                                                                @type {?} */ (value).pipe === "function")
+                                                               * @type {?} */ (value).pipe === "function")
 }
 
 /**
@@ -28,7 +28,7 @@ function isReadableStream(value) {
 async function dynamicImport(specifier) {
   const importer = /**
                     * Narrows the runtime value to the documented type.
-                     @type {(moduleSpecifier: string) => Promise<?>} */ (
+                    * @type {(moduleSpecifier: string) => Promise<?>} */ (
     new Function("moduleSpecifier", "return import(moduleSpecifier)")
   )
 
@@ -51,17 +51,17 @@ async function streamToBuffer(value) {
 
   /**
    * Chunks.
-    @type {Buffer[]} */
+   * @type {Buffer[]} */
   const chunks = []
 
   const readableStream = /**
                           * Narrows the runtime value to the documented type.
-                           @type {?} */ (value)
+                          * @type {?} */ (value)
 
   await new Promise((resolve, reject) => {
     readableStream.on("data", (/**
                                 * Narrows the runtime value to the documented type.
-                                 @type {Buffer | Uint8Array | ArrayBuffer | string} */ chunk) => {
+                                * @type {Buffer | Uint8Array | ArrayBuffer | string} */ chunk) => {
       if (Buffer.isBuffer(chunk)) {
         chunks.push(chunk)
       } else if (chunk instanceof ArrayBuffer) {
@@ -145,7 +145,7 @@ export default class S3AttachmentStorageDriver {
       const {S3Client} = await this.s3Runtime()
       /**
        * Client config.
-        @type {Record<string, ?>} */
+       * @type {Record<string, ?>} */
       const clientConfig = {
         region: this.options.region || process.env.VELOCIOUS_ATTACHMENTS_S3_REGION || "us-east-1"
       }

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

@@ -8,10 +8,10 @@ const ATTACHMENTS_TABLE = "velocious_attachments"
 
 /**
  * AttachmentDriverConstructor type.
-  @typedef {import("../../../configuration-types.js").AttachmentDriverConstructor} AttachmentDriverConstructor */
+ * @typedef {import("../../../configuration-types.js").AttachmentDriverConstructor} AttachmentDriverConstructor */
 /**
  * Stores by configuration.
-  @type {WeakMap<import("../../../configuration.js").default, Map<string, RecordAttachmentsStore>>} */
+ * @type {WeakMap<import("../../../configuration.js").default, Map<string, RecordAttachmentsStore>>} */
 const storesByConfiguration = new WeakMap()
 
 /**
@@ -78,11 +78,11 @@ export default class RecordAttachmentsStore {
     this._contentBase64Nullable = true
     /**
      * Narrows the runtime value to the documented type.
-      @type {Map<string, Record<string, ?>>} */
+     * @type {Map<string, Record<string, ?>>} */
     this._attachmentDriversByName = new Map()
     /**
      * Narrows the runtime value to the documented type.
-      @type {Map<AttachmentDriverConstructor | Record<string, ?>, Record<string, ?>>} */
+     * @type {Map<AttachmentDriverConstructor | Record<string, ?>, Record<string, ?>>} */
     this._attachmentDriversByReference = new Map()
   }
 
@@ -188,7 +188,7 @@ export default class RecordAttachmentsStore {
       const position = replace ? 0 : await this._nextPosition({db, name, recordId, recordType})
       /**
        * Insert data.
-        @type {Record<string, ?>} */
+       * @type {Record<string, ?>} */
       const insertData = {
         byte_size: normalizedInput.byteSize,
         content_base64: this._contentBase64Nullable ? null : normalizedInput.contentBase64,
@@ -396,14 +396,14 @@ export default class RecordAttachmentsStore {
    */
   async attachmentDriverByName(driverName) {
     if (this._attachmentDriversByName.has(driverName)) {
-      return /** Narrows the runtime value to the documented type. @type {Record<string, ?>} */ (this._attachmentDriversByName.get(driverName))
+      return /** @type {Record<string, ?>} */ (this._attachmentDriversByName.get(driverName))
     }
 
     const attachmentConfiguration = this.configuration.getAttachmentsConfiguration?.() || {}
     const configuredDriver = attachmentConfiguration.drivers?.[driverName]
     /**
      * Defines attachmentDriver.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     let attachmentDriver
 
     if (!configuredDriver) {
@@ -445,18 +445,18 @@ export default class RecordAttachmentsStore {
    */
   attachmentDriverByReference({attachmentName, driverReference, modelClass}) {
     if (this._attachmentDriversByReference.has(driverReference)) {
-      return /** Narrows the runtime value to the documented type. @type {Record<string, ?>} */ (this._attachmentDriversByReference.get(driverReference))
+      return /** @type {Record<string, ?>} */ (this._attachmentDriversByReference.get(driverReference))
     }
 
     /**
      * Defines attachmentDriver.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     let attachmentDriver
 
     if (typeof driverReference === "function") {
       const DriverClass = /**
                            * Narrows the runtime value to the documented type.
-                            @type {AttachmentDriverConstructor} */ (driverReference)
+                           * @type {AttachmentDriverConstructor} */ (driverReference)
 
       attachmentDriver = new DriverClass({
         attachmentName,
@@ -561,7 +561,7 @@ export default class RecordAttachmentsStore {
     const rows = await query.results()
     const currentRow = /**
                         * Narrows the runtime value to the documented type.
-                         @type {{position?: string | number | null} | undefined} */ (rows[0])
+                        * @type {{position?: string | number | null} | undefined} */ (rows[0])
     const current = Number(currentRow?.position)
 
     if (!Number.isFinite(current)) return 0
@@ -579,13 +579,13 @@ export default class RecordAttachmentsStore {
     const pool = this.configuration.getDatabasePool(this.databaseIdentifier)
     /**
      * Defines result.
-      @type {T | undefined} */
+     * @type {T | undefined} */
     let result
 
     await pool.withConnection({name: "Record attachment store"}, async (db) => {
       result = await callback(db)
     })
 
-    return /** Narrows the runtime value to the documented type. @type {T} */ (result)
+    return /** @type {T} */ (result)
   }
 }