velocious 1.0.562 → 1.0.564

package/README.md

@@ -1568,7 +1568,9 @@ database: {
 
 Velocious includes a lightweight websocket entry point for API-style calls and server-side events.
 
-Inbound frames remain ordered when TCP splits a frame across reads. Velocious limits a single final client data frame and a reassembled fragmented message to 16 MiB; larger payloads close the connection. See [WebSocket connections](docs/websocket-connections.md) for wire-protocol details.
+Inbound frames remain ordered when TCP splits a frame across reads. Velocious limits a single final client data frame and a reassembled fragmented message to 16 MiB; larger payloads close the connection.
+
+Server-to-client WebSocket delivery is bounded independently per client. The defaults retain at most 256 queued/in-flight completed frames or 16 MiB of serialized frame output; the HTTP 101 upgrade response and ordinary HTTP/file output remain outside that budget, while exact FIFO is preserved. A slow client that exceeds either limit is reported through the framework error events and deterministically closed without affecting other clients. V2 channel broadcast delivery and persistence remain isolated to the originating configuration when several applications share a process. Configure positive safe integers with `httpServer.websocketOutboundQueue.maxPendingFrames` and `maxPendingBytes`. See [WebSocket connections](docs/websocket-connections.md) for configuration and wire-protocol details.
 
 ## Connect and call a controller
 
@@ -1871,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/configuration-types.js

@@ -255,6 +255,7 @@
  * @property {boolean} [inProcess] - Run HTTP handlers in the main thread instead of worker threads.
  * @property {number} [maxWorkers] - Backward-compatible alias for workers.
  * @property {number} [port] - Port to bind the HTTP server to.
+ * @property {{maxPendingBytes?: number, maxPendingFrames?: number}} [websocketOutboundQueue] - Per-client retained outbound WebSocket frame limits.
  * @property {number} [workers] - Worker handlers to start for the HTTP server.
  */
 

package/build/configuration.js

@@ -114,6 +114,25 @@ function resolveBeaconUnreachableReportMs(value) {
   return 30_000
 }
 
+const DEFAULT_WEBSOCKET_OUTBOUND_MAX_PENDING_BYTES = 16 * 1024 * 1024
+const DEFAULT_WEBSOCKET_OUTBOUND_MAX_PENDING_FRAMES = 256
+
+/**
+ * Validates a positive safe integer configuration value.
+ * @param {?} value - Configured positive safe integer.
+ * @param {string} name - Configuration key.
+ * @param {number} defaultValue - Default value.
+ * @returns {number} - Validated configured or default value.
+ */
+function positiveSafeInteger(value, name, defaultValue) {
+  if (value === undefined) return defaultValue
+  if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+    throw new TypeError(`${name} must be a positive safe integer`)
+  }
+
+  return value
+}
+
 export default class VelociousConfiguration {
   /**
    * Close database connections promise.
@@ -209,7 +228,15 @@ export default class VelociousConfiguration {
      * @type {Promise<void> | undefined}
      */
     this._initializePromise = undefined
-    this.httpServer = httpServer || {}
+    const websocketOutboundQueue = httpServer?.websocketOutboundQueue
+
+    this.httpServer = {
+      ...(httpServer || {}),
+      websocketOutboundQueue: {
+        maxPendingBytes: positiveSafeInteger(websocketOutboundQueue?.maxPendingBytes, "httpServer.websocketOutboundQueue.maxPendingBytes", DEFAULT_WEBSOCKET_OUTBOUND_MAX_PENDING_BYTES),
+        maxPendingFrames: positiveSafeInteger(websocketOutboundQueue?.maxPendingFrames, "httpServer.websocketOutboundQueue.maxPendingFrames", DEFAULT_WEBSOCKET_OUTBOUND_MAX_PENDING_FRAMES)
+      }
+    }
     /**
      * Stores the http server instance value.
      * @type {{getDebugSnapshot: () => Promise<Record<string, ?>>} | undefined} */
@@ -1693,7 +1720,8 @@ export default class VelociousConfiguration {
       websocketEvents.broadcastV2({
         channel: message.channel,
         broadcastParams: message.broadcastParams,
-        body: message.body
+        body: message.body,
+        configuration: this
       })
       return
     }
@@ -2342,6 +2370,19 @@ export default class VelociousConfiguration {
    */
   getWebsocketSessionHeartbeatSeconds() { return this._websocketSessionHeartbeatSeconds }
 
+  /**
+   * Gets per-client WebSocket outbound queue limits.
+   * @returns {{maxBytes: number, maxFrames: number}} - Per-client outbound queue high-water marks.
+   */
+  getWebsocketOutboundQueueLimits() {
+    const queue = this.httpServer.websocketOutboundQueue
+
+    return {
+      maxBytes: queue.maxPendingBytes,
+      maxFrames: queue.maxPendingFrames
+    }
+  }
+
   /**
    * Registers a wrapper invoked around every WS-borne request /
    * connection message / channel dispatch. The wrapper receives the
@@ -2537,7 +2578,7 @@ export default class VelociousConfiguration {
     const websocketEvents = this._websocketEvents
 
     if (websocketEvents && typeof websocketEvents.broadcastV2 === "function") {
-      websocketEvents.broadcastV2({channel: name, broadcastParams, body})
+      websocketEvents.broadcastV2({channel: name, broadcastParams, body, configuration: this})
       return
     }
 

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>>} */