velocious 1.0.563 → 1.0.564

package/README.md

@@ -1873,6 +1873,8 @@ If you are developing on Velocious, you can run the tests with:
 
 Tests default to a 60-second timeout. Override per test with `{timeoutSeconds: 5}` or set a suite-wide default via `configureTests({defaultTimeoutSeconds: 30})`.
 
+Request tests share transaction-active, non-tenant database connections with their in-process HTTP handlers. Eligibility is evaluated when each request is dispatched, so a hook can start a transaction and issue a request in the same callback. This makes uncommitted setup visible to handlers while preserving rollback isolation. Without an active transaction, handlers use independent pooled connections, so concurrency and locking tests can opt out of transaction cleanup and exercise production-style connections. Shared connection state is scoped to the test lifecycle and cleared around each test. See [docs/testing-guidelines.md](docs/testing-guidelines.md#request-test-database-connections).
+
 # Writing a request test
 
 First create a test file under something like the following path 'src/routes/accounts/create-test.js' with something like the following content:

package/build/background-jobs/cron-expression.js

@@ -1,3 +1,15 @@
+/**
+ * ParsedCron type.
+ * @typedef {object} ParsedCron
+ * @property {Set<number>} minute - Allowed minute values (0-59).
+ * @property {Set<number>} hour - Allowed hour values (0-23).
+ * @property {Set<number>} dayOfMonth - Allowed day-of-month values (1-31).
+ * @property {Set<number>} month - Allowed month values (1-12).
+ * @property {Set<number>} dayOfWeek - Allowed day-of-week values (0-6, 0=Sun).
+ * @property {boolean} dayOfMonthRestricted - True when the dayOfMonth field is not `?`.
+ * @property {boolean} dayOfWeekRestricted - True when the dayOfWeek field is not `?`.
+ * @property {string} expression - Original expression for diagnostics.
+ */
 // @ts-check
 
 /**
@@ -36,19 +48,6 @@ const FIELDS = [
   {name: "dayOfWeek", min: 0, max: 7, names: DAY_NAMES}
 ]
 
-/**
- * ParsedCron type.
- * @typedef {object} ParsedCron
- * @property {Set<number>} minute - Allowed minute values (0-59).
- * @property {Set<number>} hour - Allowed hour values (0-23).
- * @property {Set<number>} dayOfMonth - Allowed day-of-month values (1-31).
- * @property {Set<number>} month - Allowed month values (1-12).
- * @property {Set<number>} dayOfWeek - Allowed day-of-week values (0-6, 0=Sun).
- * @property {boolean} dayOfMonthRestricted - True when the dayOfMonth field is not `?`.
- * @property {boolean} dayOfWeekRestricted - True when the dayOfWeek field is not `?`.
- * @property {string} expression - Original expression for diagnostics.
- */
-
 /**
  * Runs the parseCronExpression helper.
  * @param {string} expression - Cron expression or shortcut.

package/build/background-jobs/main.js

@@ -9,6 +9,12 @@ import PruneTerminalBackgroundJobsJob from "../jobs/prune-terminal-background-jo
 import VelociousError from "../velocious-error.js"
 import shutdownLifecycle from "../utils/shutdown-lifecycle.js"
 
+/**
+ * WorkerExecutionModeCapability type.
+ * @typedef {object} WorkerExecutionModeCapability
+ * @property {import("./types.js").BackgroundJobExecutionMode} executionMode - Execution mode.
+ * @property {(worker: JsonSocket) => boolean} accepts - Whether the worker accepts this mode.
+ */
 /**
  * Channel used by `background-jobs-main` to coordinate dispatch wake-ups
  * across processes via Beacon. Workers do NOT subscribe to this channel
@@ -28,12 +34,6 @@ const MAX_TIMER_MS = 2_147_483_647 // ~24.8 days
 const WORKER_STALE_TIMEOUT_MS = 60000
 /** How often the main scans workers for staleness. */
 const WORKER_LIVENESS_SWEEP_MS = 15000
-/**
- * WorkerExecutionModeCapability type.
- * @typedef {object} WorkerExecutionModeCapability
- * @property {import("./types.js").BackgroundJobExecutionMode} executionMode - Execution mode.
- * @property {(worker: JsonSocket) => boolean} accepts - Whether the worker accepts this mode.
- */
 /**
  * Worker execution mode capabilities.
  * @type {WorkerExecutionModeCapability[]} */

package/build/background-jobs/runner-graceful-shutdown.js

@@ -4,15 +4,14 @@ import timeout from "awaitery/build/timeout.js"
 
 import Configuration, {CurrentConfigurationNotSetError} from "../configuration.js"
 
-/** Bounded grace for closing framework connections on shutdown before forcing exit. */
-const SHUTDOWN_CLOSE_TIMEOUT_MS = 5000
-
 /**
  * The subset of a configuration a runner closes on shutdown. Typed structurally so
  * the shutdown path stays typechecked without a broad cast, and a future signature
  * drift surfaces at the call sites (and in tests) instead of hiding behind `any`.
  * @typedef {{disconnectBeacon: () => Promise<void>, closeDatabaseConnections: () => Promise<void>}} RunnerCloseableConfiguration
  */
+/** Bounded grace for closing framework connections on shutdown before forcing exit. */
+const SHUTDOWN_CLOSE_TIMEOUT_MS = 5000
 
 /**
  * Gracefully closes a background-job runner's framework connections (beacon +

package/build/background-jobs/scheduler.js

@@ -3,6 +3,9 @@
 import Logger from "../logger.js"
 import {nextCronFireDate, parseCronExpression} from "./cron-expression.js"
 
+/**
+ * DurationUnit type.
+ * @typedef {keyof typeof DURATION_MULTIPLIERS} DurationUnit */
 const DURATION_MULTIPLIERS = {
   d: 24 * 60 * 60 * 1000,
   day: 24 * 60 * 60 * 1000,
@@ -21,9 +24,6 @@ const DURATION_MULTIPLIERS = {
   week: 7 * 24 * 60 * 60 * 1000,
   weeks: 7 * 24 * 60 * 60 * 1000
 }
-/**
- * DurationUnit type.
- * @typedef {keyof typeof DURATION_MULTIPLIERS} DurationUnit */
 
 /**
  * Runs the parseScheduledDuration helper.

package/build/background-jobs/worker.js

@@ -10,6 +10,14 @@ import {randomUUID} from "crypto"
 import {fileURLToPath} from "node:url"
 import shutdownLifecycle from "../utils/shutdown-lifecycle.js"
 
+/**
+ * Per-forked-child timeout bookkeeping.
+ * @typedef {object} ForkedJobTimeoutState
+ * @property {boolean} timedOut - Whether the timeout fired and the child was terminated.
+ * @property {number | null} timeoutMs - The armed timeout in ms, or null when disabled.
+ * @property {ReturnType<typeof setTimeout> | null} timer - The pending timeout timer, cleared on exit.
+ * @property {ReturnType<typeof setTimeout> | null} sigkillTimer - The pending SIGKILL grace timer, cleared on exit.
+ */
 /** Grace period after SIGTERM before a lingering process runner is SIGKILLed. */
 const FORKED_CHILD_SIGKILL_GRACE_MS = 5000
 /**
@@ -48,15 +56,6 @@ function positiveNumber(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : undefined
 }
 
-/**
- * Per-forked-child timeout bookkeeping.
- * @typedef {object} ForkedJobTimeoutState
- * @property {boolean} timedOut - Whether the timeout fired and the child was terminated.
- * @property {number | null} timeoutMs - The armed timeout in ms, or null when disabled.
- * @property {ReturnType<typeof setTimeout> | null} timer - The pending timeout timer, cleared on exit.
- * @property {ReturnType<typeof setTimeout> | null} sigkillTimer - The pending SIGKILL grace timer, cleared on exit.
- */
-
 export default class BackgroundJobsWorker {
   /**
    * Runs constructor.

package/build/beacon/client.js

@@ -7,14 +7,13 @@ import timeout from "awaitery/build/timeout.js"
 import JsonSocket from "../background-jobs/json-socket.js"
 import EventEmitter from "../utils/event-emitter.js"
 
-const DEFAULT_RECONNECT_DELAY_MS = 1000
-const MAX_RECONNECT_DELAY_MS = 30_000
-const DEFAULT_CLOSE_TIMEOUT_MS = 1000
-
 /**
  * BeaconBroadcastHandler type.
  * @typedef {function(import("./types.js").BeaconBroadcastMessage): void} BeaconBroadcastHandler
  */
+const DEFAULT_RECONNECT_DELAY_MS = 1000
+const MAX_RECONNECT_DELAY_MS = 30_000
+const DEFAULT_CLOSE_TIMEOUT_MS = 1000
 
 /**
  * BeaconClient connects to a `velocious beacon` daemon and exchanges

package/build/database/drivers/sqlite/web-persistence.js

@@ -2,9 +2,6 @@
 
 import BetterLocalStorage from "better-localstorage"
 
-const SUPPORT_CHECK_FILE = ".velocious-opfs-support-check"
-const SUPPORT_CHECK_BYTES = new Uint8Array([118, 101, 108, 111, 99, 105, 111, 117, 115])
-
 /**
  * SQLite web persistence adapter.
  * @typedef {object} SqliteWebPersistence
@@ -13,13 +10,14 @@ const SUPPORT_CHECK_BYTES = new Uint8Array([118, 101, 108, 111, 99, 105, 111, 11
  * @property {() => Promise<Uint8Array | undefined>} load - Loads persisted database bytes.
  * @property {(content: Uint8Array) => Promise<void>} save - Saves persisted database bytes.
  */
-
 /**
  * Browser-like environment used for web persistence detection.
  * @typedef {object} SqliteWebPersistenceEnvironment
  * @property {unknown} [indexedDB] - IndexedDB global.
  * @property {unknown} [navigator] - Navigator global.
  */
+const SUPPORT_CHECK_FILE = ".velocious-opfs-support-check"
+const SUPPORT_CHECK_BYTES = new Uint8Array([118, 101, 108, 111, 99, 105, 111, 117, 115])
 
 /**
  * Creates the best SQLite web persistence adapter supported by the current browser.
@@ -297,7 +295,6 @@ class LocalStoragePersistence {
   }
 }
 
-
 /**
  * Selects the preferred available SQLite web persistence backend.
  * @param {object} args - Arguments.

package/build/database/pool/async-tracked-multi-connection.js

@@ -3,14 +3,6 @@
 import {AsyncLocalStorage} from "async_hooks"
 import BasePool, {POOL_CONFIGURATION_KEY} from "./base.js"
 
-export const CLOSED_CONNECTION = Symbol("velociousClosedConnection")
-const IDLE_CONNECTION_CHECKED_IN_AT = Symbol("velociousIdleConnectionCheckedInAt")
-const CONNECTION_CHECKED_OUT_AT = Symbol("velociousConnectionCheckedOutAt")
-const SUPPRESSED_CONNECTION_CONTEXT = Symbol("velociousSuppressedConnectionContext")
-const DEFAULT_MAX_CONNECTIONS = 10
-const DEFAULT_IDLE_TIMEOUT_MILLIS = 5000
-const DEFAULT_CHECKOUT_TIMEOUT_MILLIS = 10000
-
 /**
  * PendingCheckout type.
  * @typedef {object} PendingCheckout
@@ -24,6 +16,13 @@ const DEFAULT_CHECKOUT_TIMEOUT_MILLIS = 10000
  * @property {number | null} timeoutMillis - Milliseconds to wait before rejecting, or null when disabled.
  * @property {ReturnType<typeof setTimeout> | undefined} timeoutTimer - Timer that rejects the pending checkout.
  */
+export const CLOSED_CONNECTION = Symbol("velociousClosedConnection")
+const IDLE_CONNECTION_CHECKED_IN_AT = Symbol("velociousIdleConnectionCheckedInAt")
+const CONNECTION_CHECKED_OUT_AT = Symbol("velociousConnectionCheckedOutAt")
+const SUPPRESSED_CONNECTION_CONTEXT = Symbol("velociousSuppressedConnectionContext")
+const DEFAULT_MAX_CONNECTIONS = 10
+const DEFAULT_IDLE_TIMEOUT_MILLIS = 5000
+const DEFAULT_CHECKOUT_TIMEOUT_MILLIS = 10000
 
 export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends BasePool {
   /**
@@ -42,6 +41,18 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
    */
   _testSharedConnection = undefined
 
+  /**
+   * Dynamically resolves the connection eligible for in-process test request sharing.
+   * @type {(() => import("../drivers/base.js").default | undefined) | undefined}
+   */
+  _testSharedConnectionProvider = undefined
+
+  /**
+   * Identifies the lifecycle that installed the current shared connection or provider.
+   * @type {import("./base.js").TestSharedConnectionRegistration | undefined}
+   */
+  _testSharedConnectionRegistration = undefined
+
   /**
    * Connections.
    * @type {import("../drivers/base.js").default[]} */
@@ -797,17 +808,44 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
    * Set a shared connection for test mode so that HTTP handlers running
    * in the same process can reuse the test runner's database connection.
    * @param {import("../drivers/base.js").default} connection - Shared connection.
-   * @returns {void}
+   * @returns {import("./base.js").TestSharedConnectionRegistration} - Opaque registration handle.
    */
   setTestSharedConnection(connection) {
+    const registration = {owner: Symbol("test-shared-connection")}
+
     this._testSharedConnection = connection
+    this._testSharedConnectionProvider = undefined
+    this._testSharedConnectionRegistration = registration
+
+    return registration
   }
 
   /**
-   * Runs clear test shared connection.
+   * Sets a provider that is evaluated when an in-process test request is dispatched.
+   * @param {() => import("../drivers/base.js").default | undefined} provider - Shared connection provider.
+   * @returns {import("./base.js").TestSharedConnectionRegistration} - Opaque registration handle.
+   */
+  setTestSharedConnectionProvider(provider) {
+    const registration = {owner: Symbol("test-shared-connection-provider")}
+
+    this._testSharedConnection = undefined
+    this._testSharedConnectionProvider = provider
+    this._testSharedConnectionRegistration = registration
+
+    return registration
+  }
+
+  /**
+   * Clears the current shared connection registration. A supplied stale registration
+   * cannot clear a provider installed by a newer lifecycle.
+   * @param {import("./base.js").TestSharedConnectionRegistration} [registration] - Opaque registration handle to clear conditionally.
    * @returns {void} */
-  clearTestSharedConnection() {
+  clearTestSharedConnection(registration) {
+    if (registration && registration !== this._testSharedConnectionRegistration) return
+
     this._testSharedConnection = undefined
+    this._testSharedConnectionProvider = undefined
+    this._testSharedConnectionRegistration = undefined
   }
 
   /**
@@ -821,9 +859,21 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
    * @returns {T} - Callback result.
    */
   runWithTestSharedConnection(callback) {
-    if (!this._testSharedConnection) return callback()
+    const connection = this.testSharedConnection()
 
-    return this.asyncLocalStorage.run(this._testSharedConnection.getIdSeq(), callback)
+    if (!connection) return callback()
+
+    return this.asyncLocalStorage.run(connection.getIdSeq(), callback)
+  }
+
+  /**
+   * Resolves the connection currently eligible for in-process test request sharing.
+   * @returns {import("../drivers/base.js").default | undefined} - Shared connection.
+   */
+  testSharedConnection() {
+    return this._testSharedConnectionProvider
+      ? this._testSharedConnectionProvider()
+      : this._testSharedConnection
   }
 
   /**
@@ -835,7 +885,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
     const id = this.asyncLocalStorage.getStore()
 
     if (id === SUPPRESSED_CONNECTION_CONTEXT) return undefined
-    if (id === undefined) return this._testSharedConnection
+    if (id === undefined) return this.testSharedConnection()
 
     return this.getCurrentConnection()
   }
@@ -1285,7 +1335,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
     this.connections = []
     this.connectionsInUse = {}
-    this._testSharedConnection = undefined
+    this.clearTestSharedConnection()
     this.clearGlobalConnectionForIdentifier()
 
     for (const connection of connections) {

package/build/database/pool/base.js

@@ -4,14 +4,16 @@ import Configuration from "../../configuration.js"
 import Logger from "../../logger.js"
 import baseMethodsForward from "./base-methods-forward.js"
 
-export const POOL_CONFIGURATION_KEY = Symbol("velociousPoolConfigurationKey")
+/**
+ * Opaque ownership handle for an in-process test shared connection registration.
+ * @typedef {{owner: symbol}} TestSharedConnectionRegistration
+ */
 
 /**
  * ConnectionCheckoutOptions type.
  * @typedef {object} ConnectionCheckoutOptions
  * @property {string} [name] - Human-readable name for the checked-out connection.
  */
-
 /**
  * DatabasePoolPendingCheckoutDebugSnapshot type.
  * @typedef {object} DatabasePoolPendingCheckoutDebugSnapshot
@@ -24,7 +26,6 @@ export const POOL_CONFIGURATION_KEY = Symbol("velociousPoolConfigurationKey")
  * @property {number | null} timeoutMillis - Timeout configured for the checkout, or null when disabled.
  * @property {number} waitingForMs - Milliseconds already spent waiting.
  */
-
 /**
  * DatabasePoolDebugSnapshot type.
  * @typedef {object} DatabasePoolDebugSnapshot
@@ -38,6 +39,7 @@ export const POOL_CONFIGURATION_KEY = Symbol("velociousPoolConfigurationKey")
  * @property {number} pendingCheckoutCount - Number of queued checkout requests.
  * @property {string} poolClass - Pool class name.
  */
+export const POOL_CONFIGURATION_KEY = Symbol("velociousPoolConfigurationKey")
 
 /**
  * Shared.
@@ -149,15 +151,29 @@ class VelociousDatabasePoolBase {
    * pin (used by the test runner to share one connection with in-process HTTP handlers).
    * Base pools that do not track async context ignore it; async-context pools override.
    * @param {import("../drivers/base.js").default} _connection - Shared connection.
-   * @returns {void}
+   * @returns {TestSharedConnectionRegistration | undefined} - Opaque registration handle when supported.
    */
-  setTestSharedConnection(_connection) {}
+  setTestSharedConnection(_connection) {
+    return undefined
+  }
+
+  /**
+   * Sets a provider that resolves the connection eligible for in-process test request sharing.
+   * Base pools that do not track async context ignore it; async-context pools override.
+   * @param {() => import("../drivers/base.js").default | undefined} _provider - Shared connection provider.
+   * @returns {TestSharedConnectionRegistration | undefined} - Opaque registration handle when supported.
+   */
+  setTestSharedConnectionProvider(_provider) {
+    return undefined
+  }
 
   /**
-   * Clears the shared connection set by {@link setTestSharedConnection}. No-op by default.
+   * Clears the shared connection or provider set for in-process test requests. No-op by default.
+   * When a registration is provided, clears only if it is still the active registration.
+   * @param {TestSharedConnectionRegistration} [_registration] - Opaque handle returned when the shared value was set.
    * @returns {void}
    */
-  clearTestSharedConnection() {}
+  clearTestSharedConnection(_registration) {}
 
   /**
    * Runs a callback inside the test shared connection's context. Base pools that do not

package/build/database/query/index.js

@@ -14,6 +14,27 @@ import WhereHash from "./where-hash.js"
 import WhereNot from "./where-not.js"
 import WherePlain from "./where-plain.js"
 
+/**
+ * QueryArgsType type.
+ * @typedef {object} QueryArgsType
+ * @property {import("../drivers/base.js").default | (() => import("../drivers/base.js").default)} driver - Driver instance or factory for query execution.
+ * @property {Array<import("./from-base.js").default>} [froms] - FROM clauses for the query.
+ * @property {string[]} [groups] - GROUP BY columns.
+ * @property {Array<import("./join-base.js").default>} [joins] - JOIN clauses for the query.
+ * @property {import("../handler.js").default} handler - Handler used for executing and transforming results.
+ * @property {number | null} [limit] - LIMIT clause value.
+ * @property {number | null} [offset] - OFFSET clause value.
+ * @property {Array<import("./order-base.js").default>} [orders] - ORDER BY clauses.
+ * @property {number | null} [page] - Page number for pagination.
+ * @property {number} [perPage] - Records per page for pagination.
+ * @property {NestedPreloadRecord} [preload] - Preload graph for related records.
+ * @property {Record<string, string[]>} [preloadSelects] - Attribute names to load for preloaded relationships, keyed by target model name.
+ * @property {Record<string, string[]>} [preloadSelectsExtra] - Extra selects to load in addition to the defaults for preloaded relationships, keyed by target model name.
+ * @property {Array<import("./select-base.js").default>} [selects] - SELECT clauses for the query.
+ * @property {AbortSignal} [signal] - Signal passed to database query execution.
+ * @property {boolean} [distinct] - Whether the query should use DISTINCT.
+ * @property {Array<import("./where-base.js").default>} [wheres] - WHERE conditions for the query.
+ */
 /**
  * OrderArgumentType type.
  * @typedef {{[key: string]: boolean | string | string[] | NestedPreloadRecord }} NestedPreloadRecord
@@ -108,28 +129,6 @@ function mergeJoinValue(existing, incoming) {
   return incoming
 }
 
-/**
- * QueryArgsType type.
- * @typedef {object} QueryArgsType
- * @property {import("../drivers/base.js").default | (() => import("../drivers/base.js").default)} driver - Driver instance or factory for query execution.
- * @property {Array<import("./from-base.js").default>} [froms] - FROM clauses for the query.
- * @property {string[]} [groups] - GROUP BY columns.
- * @property {Array<import("./join-base.js").default>} [joins] - JOIN clauses for the query.
- * @property {import("../handler.js").default} handler - Handler used for executing and transforming results.
- * @property {number | null} [limit] - LIMIT clause value.
- * @property {number | null} [offset] - OFFSET clause value.
- * @property {Array<import("./order-base.js").default>} [orders] - ORDER BY clauses.
- * @property {number | null} [page] - Page number for pagination.
- * @property {number} [perPage] - Records per page for pagination.
- * @property {NestedPreloadRecord} [preload] - Preload graph for related records.
- * @property {Record<string, string[]>} [preloadSelects] - Attribute names to load for preloaded relationships, keyed by target model name.
- * @property {Record<string, string[]>} [preloadSelectsExtra] - Extra selects to load in addition to the defaults for preloaded relationships, keyed by target model name.
- * @property {Array<import("./select-base.js").default>} [selects] - SELECT clauses for the query.
- * @property {AbortSignal} [signal] - Signal passed to database query execution.
- * @property {boolean} [distinct] - Whether the query should use DISTINCT.
- * @property {Array<import("./where-base.js").default>} [wheres] - WHERE conditions for the query.
- */
-
 export default class VelociousDatabaseQuery {
   /**
    * Runs constructor.

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

@@ -21,6 +21,11 @@ import WhereNot from "./where-not.js"
 import JoinsParser from "../query-parser/joins-parser.js"
 import WhereParser from "../query-parser/where-parser.js"
 
+/**
+ * Defines this typedef.
+ * @template {typeof import("../record/index.js").default} [MC=typeof import("../record/index.js").default]
+ * @typedef {import("./index.js").QueryArgsType & {modelClass: MC, joinBasePath?: string[], joinTracker?: import("./join-tracker.js").default, forceQualifyBaseTable?: boolean, withCount?: import("./with-count.js").WithCountEntry[], queryData?: import("./query-data.js").QueryDataEntry[]}} ModelClassQueryArgsType
+ */
 /**
  * Runs unquote sql identifier.
  * @param {string} value - Potentially quoted SQL identifier.
@@ -166,11 +171,6 @@ function normalizePreloadRecord(preload) {
  * Defines this typedef.
  * @template {typeof import("../record/index.js").default} [MC=typeof import("../record/index.js").default]
  */
-/**
- * Defines this typedef.
- * @template {typeof import("../record/index.js").default} [MC=typeof import("../record/index.js").default]
- * @typedef {import("./index.js").QueryArgsType & {modelClass: MC, joinBasePath?: string[], joinTracker?: import("./join-tracker.js").default, forceQualifyBaseTable?: boolean, withCount?: import("./with-count.js").WithCountEntry[], queryData?: import("./query-data.js").QueryDataEntry[]}} ModelClassQueryArgsType
- */
 
 /**
  * A generic query over some model type.
@@ -330,7 +330,6 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     sql += " AS count"
 
-
     // Clone query and execute count
     const countQuery = this.clone()
 

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

@@ -2,6 +2,15 @@
 
 import UploadedFile from "../../../http-server/client/uploaded-file/uploaded-file.js"
 
+/**
+ * NormalizedAttachmentInput type.
+ * @typedef {object} NormalizedAttachmentInput
+ * @property {number} byteSize - File size in bytes.
+ * @property {Buffer} contentBuffer - Raw content bytes.
+ * @property {string} contentBase64 - Base64 encoded content.
+ * @property {string | null} contentType - Content type.
+ * @property {string} filename - Filename.
+ */
 /**
  * Runs base name.
  * @param {string} value - Path-like value.
@@ -96,16 +105,6 @@ async function uploadedFileBuffer(uploadedFile, environmentHandler) {
   throw new Error("Unsupported uploaded file type")
 }
 
-/**
- * NormalizedAttachmentInput type.
- * @typedef {object} NormalizedAttachmentInput
- * @property {number} byteSize - File size in bytes.
- * @property {Buffer} contentBuffer - Raw content bytes.
- * @property {string} contentBase64 - Base64 encoded content.
- * @property {string | null} contentType - Content type.
- * @property {string} filename - Filename.
- */
-
 /**
  * Runs normalize record attachment input.
  * @param {?} input - Attachment input.

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

@@ -4,11 +4,11 @@ import UUID from "pure-uuid"
 import TableData from "../../table-data/index.js"
 import normalizeRecordAttachmentInput from "./normalize-input.js"
 
-const ATTACHMENTS_TABLE = "velocious_attachments"
-
 /**
  * AttachmentDriverConstructor type.
  * @typedef {import("../../../configuration-types.js").AttachmentDriverConstructor} AttachmentDriverConstructor */
+const ATTACHMENTS_TABLE = "velocious_attachments"
+
 /**
  * Stores by configuration.
  * @type {WeakMap<import("../../../configuration.js").default, Map<string, RecordAttachmentsStore>>} */

package/build/database/record/auditing.js

@@ -2,6 +2,13 @@
 
 import UUID from "pure-uuid"
 
+/**
+ * Global audit event bus matching ActiveRecordAuditable::Events.
+ * @typedef {object} AuditEventsType
+ * @property {(type: string, action: string, args: AuditEventPayload) => void} call - Fire all callbacks for a model type + action.
+ * @property {(type: string, action: string, callback: (args: AuditEventPayload) => void) => () => void} connect - Register a callback for a model type + action. Returns an unsubscribe function.
+ * @property {() => void} reset - Clear all registered callbacks.
+ */
 /**
  * AuditChanges type.
  * @typedef {Record<string, ?>} AuditChanges
@@ -64,14 +71,6 @@ const generatedAuditRelationships = new WeakSet()
 /** @type {Record<string, Record<string, Array<(args: AuditEventPayload) => void>>>} */
 let globalEventConnections = {}
 
-/**
- * Global audit event bus matching ActiveRecordAuditable::Events.
- * @typedef {object} AuditEventsType
- * @property {(type: string, action: string, args: AuditEventPayload) => void} call - Fire all callbacks for a model type + action.
- * @property {(type: string, action: string, callback: (args: AuditEventPayload) => void) => () => void} connect - Register a callback for a model type + action. Returns an unsubscribe function.
- * @property {() => void} reset - Clear all registered callbacks.
- */
-
 /** @type {AuditEventsType} */
 const AuditEvents = {
   /**

package/build/database/record/index.js

@@ -57,6 +57,10 @@ import ValidatorsUniqueness from "./validators/uniqueness.js"
 import registerActsAsListCallbacks from "./acts-as-list.js"
 import UUID from "pure-uuid"
 
+/**
+ * Translation record shape used by translated attributes.
+ * @typedef {VelociousDatabaseRecord & {locale: function(): string}} TranslationBase
+ */
 /**
  * AttachmentDriverConstructor type.
  * @typedef {import("../../configuration-types.js").AttachmentDriverConstructor} AttachmentDriverConstructor
@@ -4452,11 +4456,6 @@ class VelociousDatabaseRecord {
   }
 }
 
-/**
- * Translation record shape used by translated attributes.
- * @typedef {VelociousDatabaseRecord & {locale: function(): string}} TranslationBase
- */
-
 VelociousDatabaseRecord.registerValidatorType("format", ValidatorsFormat)
 VelociousDatabaseRecord.registerValidatorType("length", ValidatorsLength)
 VelociousDatabaseRecord.registerValidatorType("presence", ValidatorsPresence)

package/build/environment-handlers/node/cli/commands/generate/frontend-models.js

@@ -6,8 +6,6 @@ import * as inflection from "inflection"
 import {frontendModelResourceIsBuiltIn, frontendModelResourcesWithBuiltInsForBackendProject} from "../../../../../frontend-models/built-in-resources.js"
 import {frontendModelResourceClassFromDefinition, frontendModelResourceConfigurationFromDefinition} from "../../../../../frontend-models/resource-definition.js"
 
-const FRONTEND_MODELS_REGENERATE_COMMAND = "velocious generate:frontend-models"
-
 /**
  * Attribute metadata used for generated frontend-model JSDoc.
  * @typedef {object} FrontendAttributeConfig
@@ -47,6 +45,7 @@ const FRONTEND_MODELS_REGENERATE_COMMAND = "velocious generate:frontend-models"
  * @property {string | null} sourceFile - Source file that declared the method.
  * @property {string} type - JSDoc parameter type.
  */
+const FRONTEND_MODELS_REGENERATE_COMMAND = "velocious generate:frontend-models"
 
 /** Node CLI command that generates frontend model classes from backend project resource config. */
 export default class DbGenerateFrontendModels extends BaseCommand {