velocious 1.0.520 → 1.0.522

package/build/tenants/tenant-aggregator.js

@@ -0,0 +1,351 @@
+// @ts-check
+
+import Current from "../current.js"
+
+/**
+ * @typedef {"SUM" | "COUNT" | "MAX" | "MIN"} AggregateOperation
+ */
+
+/**
+ * @typedef {AggregateOperation | {op: AggregateOperation, column: string}} AggregateSpec
+ */
+
+/**
+ * @typedef {object} SubqueryContext
+ * @property {(tableName: string) => string} table - Quotes a table for this tenant. In a cross-database `UNION ALL` it returns a `database`.`table` qualified identifier; when each tenant runs on its own connection it returns the plain quoted table name. Use it for every table the subquery reads so the same subquery works on both execution paths.
+ * @property {((value: ?) => string) & {list: (values: Array<?>) => string}} quote - Quotes a value for the active connection. `quote.list(values)` quotes and comma-joins an array for `IN (...)` clauses.
+ * @property {object} tenant - The tenant descriptor this subquery is being built for.
+ * @property {import("../database/drivers/base.js").default} connection - The driver the query will run on.
+ */
+
+/**
+ * @typedef {object} TenantAggregateOptions
+ * @property {string} identifier - Database identifier whose tenants are aggregated (for example `"projectTenant"`).
+ * @property {object[]} [tenants] - Explicit tenant descriptors to aggregate. Defaults to every tenant the identifier's provider `listTenants` returns.
+ * @property {(tenant: ?) => boolean} [filter] - Optional filter applied to the resolved tenant list.
+ * @property {string[]} [keyColumns] - Columns the aggregate is grouped by (for example `["docker_server_id"]`). Empty means a single grand-total row.
+ * @property {Record<string, AggregateSpec>} aggregates - Output column name to aggregate. `"SUM"` is shorthand for `{op: "SUM", column: <output name>}`; use `{op: "COUNT", column: "*"}` for `COUNT(*)`.
+ * @property {(context: SubqueryContext) => string} subquery - Builds one tenant's inner `SELECT`, which must select every `keyColumns` entry plus every aggregate source column.
+ * @property {import("../configuration.js").default} [configuration] - Configuration to run against. Defaults to the current configuration.
+ */
+
+/**
+ * @typedef {{tenant: object, database: string | undefined, serverKey: string}} ResolvedTenant
+ */
+
+const AGGREGATE_OPERATIONS = new Set(["SUM", "COUNT", "MAX", "MIN"])
+const DERIVED_TABLE_ALIAS = "velocious_tenant_aggregate"
+
+/**
+ * Runs one aggregate query across many tenant databases and merges the result. Tenant databases may
+ * be co-located on the default server or spread across other servers, and they can appear or
+ * disappear at runtime; this resolves the live tenant list, groups tenants by the server they live
+ * on, and — per server — emits a single cross-database `UNION ALL` when the driver supports qualified
+ * cross-database references (MySQL/MSSQL) or falls back to one query per tenant otherwise
+ * (PostgreSQL/SQLite). Results from every server are merged with the aggregate's own operation, so
+ * callers get one combined result set regardless of how the tenants are distributed. Reached through
+ * `Tenant.aggregateAcross`.
+ */
+export default class TenantAggregator {
+  /**
+   * Prepares an aggregate run, normalizing the aggregate specs up front.
+   * @param {TenantAggregateOptions} options - Aggregate configuration.
+   */
+  constructor(options) {
+    this.options = options
+    this.configuration = options.configuration ?? Current.configuration()
+    this.keyColumns = options.keyColumns ?? []
+    this.aggregates = this._normalizeAggregates(options.aggregates)
+  }
+
+  /**
+   * Resolves the tenant list, runs the aggregate per server, and merges everything.
+   * @returns {Promise<Array<Record<string, ?>>>} - One merged row per distinct key-column combination.
+   */
+  async run() {
+    const resolvedTenants = await this._resolveTenants()
+
+    if (resolvedTenants.length === 0) return []
+
+    /** @type {Array<Record<string, ?>>} */
+    const rows = []
+
+    for (const group of this._groupByServer(resolvedTenants)) {
+      const groupRows = await this._runForServer(group)
+
+      rows.push(...groupRows)
+    }
+
+    return this._mergeRows(rows)
+  }
+
+  /**
+   * Resolves the tenant list (explicit or from the provider), then maps each to its server and
+   * database via the tenant database resolver.
+   * @returns {Promise<ResolvedTenant[]>} - Tenants to aggregate, each resolved to its server + database.
+   */
+  async _resolveTenants() {
+    const tenants = this.options.tenants ?? await this._listProviderTenants()
+    const filtered = this.options.filter ? tenants.filter(this.options.filter) : tenants
+
+    return filtered.map((tenant) => {
+      const databaseConfiguration = this.configuration.resolveDatabaseConfiguration(this.options.identifier, tenant)
+
+      // The server key groups tenants that share a connection endpoint so co-located tenants can be
+      // UNION-ed on one connection. It only needs to be exact for the cross-database `UNION ALL`
+      // path, which is MySQL-only, where host/port/username/type fully identify the server. Every
+      // other driver takes the fan-out path (one connection per tenant), so a coarse key there just
+      // groups tenants that are then queried individually anyway — it can never route a query to the
+      // wrong server.
+      return {
+        database: databaseConfiguration.database,
+        serverKey: JSON.stringify([
+          databaseConfiguration.type ?? null,
+          databaseConfiguration.host ?? null,
+          databaseConfiguration.port ?? null,
+          databaseConfiguration.username ?? null
+        ]),
+        tenant
+      }
+    })
+  }
+
+  /**
+   * Lists every tenant for the identifier through its provider's `listTenants` hook.
+   * @returns {Promise<object[]>} - Every tenant the provider lists for the identifier.
+   */
+  async _listProviderTenants() {
+    const provider = this.configuration.getTenantDatabaseProvider(this.options.identifier)
+    const listedTenants = await this.configuration.ensureConnections(
+      {name: `Tenant.aggregateAcross: ${this.options.identifier}`},
+      async () => await provider.listTenants({configuration: this.configuration, identifier: this.options.identifier})
+    )
+
+    if (!Array.isArray(listedTenants)) {
+      throw new Error(`Tenant database provider for ${this.options.identifier} must return an array from listTenants`)
+    }
+
+    return listedTenants
+  }
+
+  /**
+   * Groups tenants by the server they live on so co-located tenants can share one query.
+   * @param {ResolvedTenant[]} resolvedTenants - Tenants resolved to their server.
+   * @returns {ResolvedTenant[][]} - Tenants grouped by the server they live on.
+   */
+  _groupByServer(resolvedTenants) {
+    /** @type {Map<string, ResolvedTenant[]>} */
+    const groups = new Map()
+
+    for (const resolvedTenant of resolvedTenants) {
+      const group = groups.get(resolvedTenant.serverKey)
+
+      if (group) {
+        group.push(resolvedTenant)
+      } else {
+        groups.set(resolvedTenant.serverKey, [resolvedTenant])
+      }
+    }
+
+    return Array.from(groups.values())
+  }
+
+  /**
+   * Runs the aggregate for one server's tenants, using a single cross-database `UNION ALL` when the
+   * driver supports it or one query per tenant otherwise. The driver capability is probed in its own
+   * connection scope that is released before the fan-out runs, so a `max: 1` tenant pool is never
+   * asked for a second connection while the first is still held (which would deadlock).
+   * @param {ResolvedTenant[]} group - Tenants sharing one server.
+   * @returns {Promise<Array<Record<string, ?>>>} - Rows produced for this server.
+   */
+  async _runForServer(group) {
+    const [firstTenant] = group
+    const supportsCrossDatabaseReferences = await this._withTenant(
+      firstTenant.tenant,
+      async (connections) => connections[this.options.identifier].supportsCrossDatabaseReferences()
+    )
+
+    if (supportsCrossDatabaseReferences) {
+      return await this._withTenant(firstTenant.tenant, async (connections) => {
+        const connection = connections[this.options.identifier]
+
+        return await connection.query(this.buildAggregateSql({connection, entries: group, qualified: true}))
+      })
+    }
+
+    /** @type {Array<Record<string, ?>>} */
+    const rows = []
+
+    for (const resolvedTenant of group) {
+      const tenantRows = await this._withTenant(resolvedTenant.tenant, async (connections) => {
+        const connection = connections[this.options.identifier]
+
+        return await connection.query(this.buildAggregateSql({connection, entries: [resolvedTenant], qualified: false}))
+      })
+
+      rows.push(...tenantRows)
+    }
+
+    return rows
+  }
+
+  /**
+   * Runs `callback` inside a tenant's context with its connections established, mirroring
+   * `Tenant.with` without importing it (which would create an import cycle).
+   * @template T
+   * @param {object} tenant - Tenant descriptor to switch into.
+   * @param {(connections: Record<string, import("../database/drivers/base.js").default>) => Promise<T>} callback - Operation to run with the tenant's active connections.
+   * @returns {Promise<T>} - Callback result from within the tenant context.
+   */
+  async _withTenant(tenant, callback) {
+    return await this.configuration.runWithTenant(tenant, async () => await this.configuration.ensureConnections(callback))
+  }
+
+  /**
+   * Builds the aggregate SQL: an outer `GROUP BY` over a `UNION ALL` of each entry's subquery.
+   * @param {{connection: import("../database/drivers/base.js").default, entries: ResolvedTenant[], qualified: boolean}} args - Connection, tenants, and whether to qualify tables with their database name.
+   * @returns {string} - Executable aggregate SQL.
+   */
+  buildAggregateSql({connection, entries, qualified}) {
+    const options = connection.options()
+    const quote = this._buildQuote(connection)
+    const subqueries = entries.map((entry) => {
+      if (qualified && !entry.database) {
+        throw new Error(`Cannot build a cross-database query for a tenant without a resolved database name (identifier: ${this.options.identifier}).`)
+      }
+
+      const table = (/** @type {string} */ tableName) => qualified
+        ? `${options.quoteDatabaseName(/** @type {string} */ (entry.database))}.${options.quoteTableName(tableName)}`
+        : options.quoteTableName(tableName)
+
+      return this.options.subquery({connection, quote, table, tenant: entry.tenant})
+    })
+
+    const selectParts = this.keyColumns.map((keyColumn) => options.quoteColumnName(keyColumn))
+
+    for (const [name, spec] of Object.entries(this.aggregates)) {
+      const aggregateArgument = spec.column === "*" ? "*" : options.quoteColumnName(spec.column)
+
+      selectParts.push(`${spec.op}(${aggregateArgument}) AS ${options.quoteColumnName(name)}`)
+    }
+
+    const unionSql = subqueries.map((subquery) => `SELECT * FROM (${subquery}) ${options.quoteTableName(`${DERIVED_TABLE_ALIAS}_source`)}`).join("\nUNION ALL\n")
+    const groupBySql = this.keyColumns.length > 0
+      ? `\nGROUP BY ${this.keyColumns.map((keyColumn) => options.quoteColumnName(keyColumn)).join(", ")}`
+      : ""
+
+    return `SELECT ${selectParts.join(", ")}\nFROM (\n${unionSql}\n) ${options.quoteTableName(DERIVED_TABLE_ALIAS)}${groupBySql}`
+  }
+
+  /**
+   * Merges rows from every server by combining each aggregate with its own operation. A `NULL`
+   * aggregate value (an empty tenant's `SUM`/`MAX`/`MIN` returns `NULL` on the fan-out path) is
+   * treated as "no contribution" and skipped, not coerced to `0` — otherwise an empty tenant would
+   * drag a `MAX` of negatives or a `MIN` of positives to `0`. A key whose every tenant contributed
+   * `NULL` stays `NULL`, matching SQL aggregate semantics over no rows.
+   * @param {Array<Record<string, ?>>} rows - Rows collected from all servers/tenants.
+   * @returns {Array<Record<string, ?>>} - One merged row per distinct key-column combination.
+   */
+  _mergeRows(rows) {
+    /** @type {Map<string, Record<string, ?>>} */
+    const merged = new Map()
+
+    for (const row of rows) {
+      const mapKey = JSON.stringify(this.keyColumns.map((keyColumn) => row[keyColumn]))
+      let accumulator = merged.get(mapKey)
+
+      if (!accumulator) {
+        accumulator = {}
+
+        for (const keyColumn of this.keyColumns) {
+          accumulator[keyColumn] = row[keyColumn]
+        }
+
+        for (const name of Object.keys(this.aggregates)) {
+          accumulator[name] = null
+        }
+
+        merged.set(mapKey, accumulator)
+      }
+
+      for (const [name, spec] of Object.entries(this.aggregates)) {
+        const rawValue = row[name]
+
+        if (rawValue === null || rawValue === undefined) continue
+
+        const value = this._toExactNumber(rawValue)
+
+        accumulator[name] = accumulator[name] === null ? value : this._combine(spec.op, accumulator[name], value)
+      }
+    }
+
+    return Array.from(merged.values())
+  }
+
+  /**
+   * Combines two non-null per-server aggregate values with the aggregate's own operation.
+   * @param {AggregateOperation} op - Aggregate operation.
+   * @param {number} current - Accumulated value.
+   * @param {number} value - Incoming per-server value.
+   * @returns {number} - Combined value.
+   */
+  _combine(op, current, value) {
+    if (op === "MAX") return Math.max(current, value)
+    if (op === "MIN") return Math.min(current, value)
+
+    return current + value
+  }
+
+  /**
+   * Converts a driver-returned aggregate value to a number, failing loudly rather than silently
+   * losing precision. Drivers return exact integer aggregates (MySQL `SUM`/`COUNT`, PostgreSQL
+   * `bigint`) as strings; an integer beyond `Number.MAX_SAFE_INTEGER` cannot be represented exactly
+   * as a JS number, so cross-server merging would corrupt the result — throw instead. (Fractional
+   * `DECIMAL`/`NUMERIC` values are still subject to normal floating-point representation.)
+   * @param {?} rawValue - Value returned by the driver for an aggregate column.
+   * @returns {number} - The value as a number.
+   */
+  _toExactNumber(rawValue) {
+    const value = Number(rawValue)
+
+    if (typeof rawValue === "string" && /^-?\d+$/.test(rawValue.trim()) && !Number.isSafeInteger(value)) {
+      throw new Error(`Aggregate value ${rawValue} exceeds the safe-integer range and cannot be merged without losing precision.`)
+    }
+
+    return value
+  }
+
+  /**
+   * Builds the value quoter passed to subqueries, with a `.list` helper for `IN (...)` clauses.
+   * @param {import("../database/drivers/base.js").default} connection - Driver whose quoting is used.
+   * @returns {((value: ?) => string) & {list: (values: Array<?>) => string}} - Value quoter with a `.list` helper.
+   */
+  _buildQuote(connection) {
+    return Object.assign(
+      (/** @type {?} */ value) => String(connection.quote(value)),
+      {list: (/** @type {Array<?>} */ values) => values.map((value) => String(connection.quote(value))).join(", ")}
+    )
+  }
+
+  /**
+   * Normalizes the aggregate specs (string shorthand or object) and validates each operation.
+   * @param {Record<string, AggregateSpec>} aggregates - Raw aggregate specs.
+   * @returns {Record<string, {op: AggregateOperation, column: string}>} - Normalized aggregate specs.
+   */
+  _normalizeAggregates(aggregates) {
+    /** @type {Record<string, {op: AggregateOperation, column: string}>} */
+    const normalized = {}
+
+    for (const [name, spec] of Object.entries(aggregates)) {
+      const op = /** @type {AggregateOperation} */ ((typeof spec === "string" ? spec : spec.op).toUpperCase())
+
+      if (!AGGREGATE_OPERATIONS.has(op)) {
+        throw new Error(`Unsupported aggregate operation for ${name}: ${op}. Supported: ${Array.from(AGGREGATE_OPERATIONS).join(", ")}.`)
+      }
+
+      normalized[name] = {column: typeof spec === "string" ? name : spec.column, op}
+    }
+
+    return normalized
+  }
+}

package/build/tenants/tenant.js

@@ -2,6 +2,7 @@
 
 import Current from "../current.js"
 import {dropTenantDatabase} from "./default-tenant-database-provisioning.js"
+import TenantAggregator from "./tenant-aggregator.js"
 import TenantIterator from "./tenant-iterator.js"
 
 /**
@@ -74,6 +75,22 @@ export default class Tenant {
     })
   }
 
+  /**
+   * Runs one aggregate query across many tenant databases and returns the merged result. The
+   * tenants may be co-located on the default server or spread across other servers, and can be
+   * created or dropped at runtime; the live tenant list is resolved (from `tenants` or the
+   * provider's `listTenants`), grouped by server, aggregated with a single cross-database
+   * `UNION ALL` where the driver supports it (MySQL/MSSQL) or one query per tenant otherwise
+   * (PostgreSQL/SQLite), and merged with each aggregate's own operation. The caller writes only one
+   * per-tenant subquery and declares the key columns and aggregates; see
+   * {@link import("./tenant-aggregator.js").TenantAggregateOptions}.
+   * @param {import("./tenant-aggregator.js").TenantAggregateOptions} options - Aggregate configuration.
+   * @returns {Promise<Array<Record<string, ?>>>} - One merged row per distinct key-column combination.
+   */
+  static async aggregateAcross(options) {
+    return await new TenantAggregator(options).run()
+  }
+
   /**
    * Drops one tenant's database/schema through the provider's `dropDatabase` hook.
    * @param {{identifier: string, tenant: object, configuration?: import("../configuration.js").default}} args - Tenant descriptor and database identifier to drop.

package/build/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../index.js","../bin/velocious.js","../src/application.js","../src/configuration-resolver.js","../src/configuration-types.js","../src/configuration.js","../src/controller.js","../src/current-configuration.js","../src/current.js","../src/error-logger.js","../src/frontend-model-controller.js","../src/initializer.js","../src/logger.js","../src/mailer.js","../src/record-payload-values.js","../src/time-zone.js","../src/velocious-error.js","../src/authorization/ability.js","../src/authorization/base-resource.js","../src/background-jobs/client.js","../src/background-jobs/cron-expression.js","../src/background-jobs/forked-runner-child.js","../src/background-jobs/job-record.js","../src/background-jobs/job-registry.js","../src/background-jobs/job-runner.js","../src/background-jobs/job.js","../src/background-jobs/json-socket.js","../src/background-jobs/main.js","../src/background-jobs/normalize-error.js","../src/background-jobs/scheduler.js","../src/background-jobs/socket-request.js","../src/background-jobs/status-reporter.js","../src/background-jobs/store.js","../src/background-jobs/types.js","../src/background-jobs/worker.js","../src/background-jobs/web/authorization.js","../src/background-jobs/web/controller.js","../src/background-jobs/web/index.js","../src/background-jobs/web/path-matcher.js","../src/background-jobs/web/registry.js","../src/beacon/client.js","../src/beacon/in-process-broker.js","../src/beacon/in-process-client.js","../src/beacon/server.js","../src/beacon/types.js","../src/cli/base-command.js","../src/cli/browser-cli.js","../src/cli/index.js","../src/cli/tenant-database-command-helper.js","../src/cli/use-browser-cli.js","../src/cli/commands/background-jobs-main.js","../src/cli/commands/background-jobs-runner.js","../src/cli/commands/background-jobs-worker.js","../src/cli/commands/beacon.js","../src/cli/commands/console.js","../src/cli/commands/init.js","../src/cli/commands/routes.js","../src/cli/commands/run-script.js","../src/cli/commands/runner.js","../src/cli/commands/server.js","../src/cli/commands/test.js","../src/cli/commands/db/base-command.js","../src/cli/commands/db/create.js","../src/cli/commands/db/drop.js","../src/cli/commands/db/migrate.js","../src/cli/commands/db/reset.js","../src/cli/commands/db/rollback.js","../src/cli/commands/db/seed.js","../src/cli/commands/db/schema/dump.js","../src/cli/commands/db/schema/load.js","../src/cli/commands/db/tenants/check.js","../src/cli/commands/db/tenants/create.js","../src/cli/commands/db/tenants/drop.js","../src/cli/commands/db/tenants/migrate.js","../src/cli/commands/destroy/migration.js","../src/cli/commands/generate/base-models.js","../src/cli/commands/generate/frontend-models.js","../src/cli/commands/generate/migration.js","../src/cli/commands/generate/model.js","../src/cli/commands/lint/relationships.js","../src/database/advisory-lock-runner.js","../src/database/annotations-async-hooks.js","../src/database/annotations.js","../src/database/column-types.js","../src/database/datetime-storage.js","../src/database/handler.js","../src/database/initializer-from-require-context.js","../src/database/live-query.js","../src/database/migrations-ledger.js","../src/database/migrator.js","../src/database/record-changes.js","../src/database/use-database.js","../src/database/use-live-query.js","../src/database/drivers/base-column.js","../src/database/drivers/base-columns-index.js","../src/database/drivers/base-foreign-key.js","../src/database/drivers/base-table.js","../src/database/drivers/base.js","../src/database/drivers/mssql/column.js","../src/database/drivers/mssql/columns-index.js","../src/database/drivers/mssql/connect-connection.js","../src/database/drivers/mssql/foreign-key.js","../src/database/drivers/mssql/index.js","../src/database/drivers/mssql/options.js","../src/database/drivers/mssql/query-parser.js","../src/database/drivers/mssql/structure-sql.js","../src/database/drivers/mssql/table.js","../src/database/drivers/mssql/sql/alter-table.js","../src/database/drivers/mssql/sql/create-database.js","../src/database/drivers/mssql/sql/create-index.js","../src/database/drivers/mssql/sql/create-table.js","../src/database/drivers/mssql/sql/delete.js","../src/database/drivers/mssql/sql/drop-database.js","../src/database/drivers/mssql/sql/drop-table.js","../src/database/drivers/mssql/sql/insert.js","../src/database/drivers/mssql/sql/remove-index.js","../src/database/drivers/mssql/sql/update.js","../src/database/drivers/mssql/sql/upsert.js","../src/database/drivers/mysql/column.js","../src/database/drivers/mysql/columns-index.js","../src/database/drivers/mysql/foreign-key.js","../src/database/drivers/mysql/index.js","../src/database/drivers/mysql/options.js","../src/database/drivers/mysql/query-parser.js","../src/database/drivers/mysql/query.js","../src/database/drivers/mysql/structure-sql.js","../src/database/drivers/mysql/table.js","../src/database/drivers/mysql/sql/alter-table.js","../src/database/drivers/mysql/sql/create-database.js","../src/database/drivers/mysql/sql/create-index.js","../src/database/drivers/mysql/sql/create-table.js","../src/database/drivers/mysql/sql/delete.js","../src/database/drivers/mysql/sql/drop-database.js","../src/database/drivers/mysql/sql/drop-table.js","../src/database/drivers/mysql/sql/insert.js","../src/database/drivers/mysql/sql/remove-index.js","../src/database/drivers/mysql/sql/update.js","../src/database/drivers/mysql/sql/upsert.js","../src/database/drivers/pgsql/column.js","../src/database/drivers/pgsql/columns-index.js","../src/database/drivers/pgsql/foreign-key.js","../src/database/drivers/pgsql/index.js","../src/database/drivers/pgsql/options.js","../src/database/drivers/pgsql/query-parser.js","../src/database/drivers/pgsql/structure-sql.js","../src/database/drivers/pgsql/table.js","../src/database/drivers/pgsql/sql/alter-table.js","../src/database/drivers/pgsql/sql/create-database.js","../src/database/drivers/pgsql/sql/create-index.js","../src/database/drivers/pgsql/sql/create-table.js","../src/database/drivers/pgsql/sql/delete.js","../src/database/drivers/pgsql/sql/drop-database.js","../src/database/drivers/pgsql/sql/drop-table.js","../src/database/drivers/pgsql/sql/insert.js","../src/database/drivers/pgsql/sql/remove-index.js","../src/database/drivers/pgsql/sql/update.js","../src/database/drivers/pgsql/sql/upsert.js","../src/database/drivers/sqlite/base.js","../src/database/drivers/sqlite/column.js","../src/database/drivers/sqlite/columns-index.js","../src/database/drivers/sqlite/connection-sql-js.js","../src/database/drivers/sqlite/foreign-key.js","../src/database/drivers/sqlite/index.js","../src/database/drivers/sqlite/index.native.js","../src/database/drivers/sqlite/index.web.js","../src/database/drivers/sqlite/options.js","../src/database/drivers/sqlite/query-parser.js","../src/database/drivers/sqlite/query.js","../src/database/drivers/sqlite/query.native.js","../src/database/drivers/sqlite/query.web.js","../src/database/drivers/sqlite/structure-sql.js","../src/database/drivers/sqlite/table-rebuilder.js","../src/database/drivers/sqlite/table.js","../src/database/drivers/sqlite/web-persistence.js","../src/database/drivers/sqlite/sql/alter-table.js","../src/database/drivers/sqlite/sql/create-index.js","../src/database/drivers/sqlite/sql/create-table.js","../src/database/drivers/sqlite/sql/delete.js","../src/database/drivers/sqlite/sql/drop-table.js","../src/database/drivers/sqlite/sql/insert.js","../src/database/drivers/sqlite/sql/remove-index.js","../src/database/drivers/sqlite/sql/update.js","../src/database/drivers/sqlite/sql/upsert.js","../src/database/drivers/structure-sql/utils.js","../src/database/migration/index.js","../src/database/migrator/files-finder.js","../src/database/migrator/types.js","../src/database/pool/async-tracked-multi-connection.js","../src/database/pool/base-methods-forward.js","../src/database/pool/base.js","../src/database/pool/single-multi-use.js","../src/database/query/alter-table-base.js","../src/database/query/base.js","../src/database/query/create-database-base.js","../src/database/query/create-index-base.js","../src/database/query/create-table-base.js","../src/database/query/delete-base.js","../src/database/query/drop-database-base.js","../src/database/query/drop-table-base.js","../src/database/query/from-base.js","../src/database/query/from-plain.js","../src/database/query/from-table.js","../src/database/query/index.js","../src/database/query/insert-base.js","../src/database/query/join-base.js","../src/database/query/join-object.js","../src/database/query/join-plain.js","../src/database/query/join-tracker.js","../src/database/query/model-class-query.js","../src/database/query/order-base.js","../src/database/query/order-column.js","../src/database/query/order-plain.js","../src/database/query/preloader.js","../src/database/query/query-data.js","../src/database/query/remove-index-base.js","../src/database/query/select-base.js","../src/database/query/select-plain.js","../src/database/query/select-table-and-column.js","../src/database/query/update-base.js","../src/database/query/upsert-base.js","../src/database/query/where-base.js","../src/database/query/where-combinator.js","../src/database/query/where-hash.js","../src/database/query/where-model-class-hash.js","../src/database/query/where-not.js","../src/database/query/where-plain.js","../src/database/query/with-count.js","../src/database/query/preloader/belongs-to.js","../src/database/query/preloader/ensure-model-class-initialized.js","../src/database/query/preloader/has-many.js","../src/database/query/preloader/has-one.js","../src/database/query/preloader/selection.js","../src/database/query-parser/base-query-parser.js","../src/database/query-parser/from-parser.js","../src/database/query-parser/group-parser.js","../src/database/query-parser/joins-parser.js","../src/database/query-parser/limit-parser.js","../src/database/query-parser/options.js","../src/database/query-parser/order-parser.js","../src/database/query-parser/select-parser.js","../src/database/query-parser/where-parser.js","../src/database/record/acts-as-list.js","../src/database/record/auditing.js","../src/database/record/counter-cache-magnitude.js","../src/database/record/index.js","../src/database/record/record-not-found-error.js","../src/database/record/state-machine.js","../src/database/record/user-module.js","../src/database/record/validation-messages.js","../src/database/record/attachments/attachment-record.js","../src/database/record/attachments/download.js","../src/database/record/attachments/handle.js","../src/database/record/attachments/normalize-input.js","../src/database/record/attachments/store.js","../src/database/record/attachments/storage-drivers/filesystem.js","../src/database/record/attachments/storage-drivers/native.js","../src/database/record/attachments/storage-drivers/s3.js","../src/database/record/instance-relationships/base.js","../src/database/record/instance-relationships/belongs-to.js","../src/database/record/instance-relationships/has-many.js","../src/database/record/instance-relationships/has-one.js","../src/database/record/relationships/base.js","../src/database/record/relationships/belongs-to.js","../src/database/record/relationships/has-many.js","../src/database/record/relationships/has-one.js","../src/database/record/validators/base.js","../src/database/record/validators/format.js","../src/database/record/validators/length.js","../src/database/record/validators/presence.js","../src/database/record/validators/uniqueness.js","../src/database/table-data/index.js","../src/database/table-data/table-column.js","../src/database/table-data/table-foreign-key.js","../src/database/table-data/table-index.js","../src/database/table-data/table-reference.js","../src/database/tenants/data-copier.js","../src/database/tenants/schema-cloner.js","../src/database/tenants/tenant-table-plan.js","../src/environment-handlers/base.js","../src/environment-handlers/browser.js","../src/environment-handlers/node.js","../src/environment-handlers/node/cli/commands/background-jobs-main.js","../src/environment-handlers/node/cli/commands/background-jobs-runner.js","../src/environment-handlers/node/cli/commands/background-jobs-worker.js","../src/environment-handlers/node/cli/commands/beacon.js","../src/environment-handlers/node/cli/commands/cli-command-context.js","../src/environment-handlers/node/cli/commands/console.js","../src/environment-handlers/node/cli/commands/init.js","../src/environment-handlers/node/cli/commands/routes.js","../src/environment-handlers/node/cli/commands/run-script.js","../src/environment-handlers/node/cli/commands/runner.js","../src/environment-handlers/node/cli/commands/server.js","../src/environment-handlers/node/cli/commands/test.js","../src/environment-handlers/node/cli/commands/db/seed.js","../src/environment-handlers/node/cli/commands/db/schema/dump.js","../src/environment-handlers/node/cli/commands/db/schema/load.js","../src/environment-handlers/node/cli/commands/destroy/migration.js","../src/environment-handlers/node/cli/commands/generate/base-models.js","../src/environment-handlers/node/cli/commands/generate/frontend-models.js","../src/environment-handlers/node/cli/commands/generate/generated-file-banner.js","../src/environment-handlers/node/cli/commands/generate/migration.js","../src/environment-handlers/node/cli/commands/generate/model.js","../src/environment-handlers/node/cli/commands/lint/relationships.js","../src/error-reporting/request-details.js","../src/frontend-model-resource/base-resource.js","../src/frontend-model-resource/velocious-attachment-resource.js","../src/frontend-models/base.js","../src/frontend-models/built-in-resources.js","../src/frontend-models/clear-pending-debounced-callback.js","../src/frontend-models/event-hook-models.js","../src/frontend-models/model-registry.js","../src/frontend-models/outgoing-event-buffer.js","../src/frontend-models/preloader.js","../src/frontend-models/query.js","../src/frontend-models/resource-config-validation.js","../src/frontend-models/resource-definition.js","../src/frontend-models/transport-serialization.js","../src/frontend-models/use-created-event.js","../src/frontend-models/use-destroyed-event.js","../src/frontend-models/use-model-class-event.js","../src/frontend-models/use-updated-event.js","../src/frontend-models/websocket-channel.js","../src/frontend-models/websocket-publishers.js","../src/http-client/header.js","../src/http-client/index.js","../src/http-client/request.js","../src/http-client/response.js","../src/http-client/websocket-client.js","../src/http-server/cookie.js","../src/http-server/development-reloader.js","../src/http-server/index.js","../src/http-server/remote-address.js","../src/http-server/server-client.js","../src/http-server/server-lock.js","../src/http-server/websocket-channel-subscribers.js","../src/http-server/websocket-channel.js","../src/http-server/websocket-connection.js","../src/http-server/websocket-event-log-store.js","../src/http-server/websocket-events-host.js","../src/http-server/websocket-events.js","../src/http-server/client/index.js","../src/http-server/client/params-to-object.js","../src/http-server/client/request-parser.js","../src/http-server/client/request-runner.js","../src/http-server/client/request-timing.js","../src/http-server/client/request.js","../src/http-server/client/response.js","../src/http-server/client/websocket-request.js","../src/http-server/client/websocket-session.js","../src/http-server/client/request-buffer/form-data-part.js","../src/http-server/client/request-buffer/header.js","../src/http-server/client/request-buffer/index.js","../src/http-server/client/uploaded-file/memory-uploaded-file.js","../src/http-server/client/uploaded-file/temporary-uploaded-file.js","../src/http-server/client/uploaded-file/uploaded-file.js","../src/http-server/worker-handler/channel-subscriber-dispatch.js","../src/http-server/worker-handler/in-process.js","../src/http-server/worker-handler/index.js","../src/http-server/worker-handler/worker-script.js","../src/http-server/worker-handler/worker-thread.js","../src/jobs/mail-delivery.js","../src/jobs/prune-terminal-background-jobs.js","../src/logger/base-logger.js","../src/logger/console-logger.js","../src/logger/file-logger.js","../src/logger/outputs/array-output.js","../src/logger/outputs/console-output.js","../src/logger/outputs/file-output.js","../src/logger/outputs/stdout-output.js","../src/mailer/base.js","../src/mailer/delivery.js","../src/mailer/index.js","../src/mailer/backends/smtp.js","../src/packages/velocious-package.js","../src/plugins/sqljs-wasm-route-controller.js","../src/plugins/sqljs-wasm-route.js","../src/routes/app-routes.js","../src/routes/base-route.js","../src/routes/basic-route.js","../src/routes/get-route.js","../src/routes/index.js","../src/routes/namespace-route.js","../src/routes/plugin-routes.js","../src/routes/post-route.js","../src/routes/resolver.js","../src/routes/resource-route.js","../src/routes/root-route.js","../src/routes/built-in/api-manifest/controller.js","../src/routes/built-in/debug/controller.js","../src/routes/built-in/errors/controller.js","../src/routes/hooks/frontend-model-command-route-hook.js","../src/sync/conflict-strategy.js","../src/sync/device-identity.js","../src/sync/local-mutation-log.js","../src/sync/offline-grant.js","../src/sync/peer-mutation-bundle.js","../src/sync/query-scope.js","../src/sync/server-change-feed.js","../src/sync/server-sequence-allocator.js","../src/sync/stable-json.js","../src/sync/sync-api-client-types.js","../src/sync/sync-api-client.js","../src/sync/sync-api-controller.js","../src/sync/sync-change-fanout.js","../src/sync/sync-channel-name.js","../src/sync/sync-client-registry.js","../src/sync/sync-client-types.js","../src/sync/sync-client.js","../src/sync/sync-envelope-replay-service.js","../src/sync/sync-model-change-feed-service.js","../src/sync/sync-publish-suppression.js","../src/sync/sync-publisher-types.js","../src/sync/sync-publisher.js","../src/sync/sync-realtime-bridge.js","../src/sync/sync-replay-upsert-applier.js","../src/sync/sync-resource-base.js","../src/sync/sync-scope-attributes.js","../src/sync/sync-scope-store.js","../src/sync/sync-websocket-channel.js","../src/tenants/default-tenant-database-provisioning.js","../src/tenants/tenant-iterator.js","../src/tenants/tenant.js","../src/testing/base-expect.js","../src/testing/browser-frontend-model-event-hook-scenarios.js","../src/testing/browser-test-app.js","../src/testing/expect-to-change.js","../src/testing/expect-utils.js","../src/testing/expect.js","../src/testing/request-client.js","../src/testing/test-files-finder.js","../src/testing/test-filter-parser.js","../src/testing/test-runner.js","../src/testing/test-suite-splitter.js","../src/testing/test.js","../src/types/external-modules.d.ts","../src/utils/backtrace-cleaner-node.js","../src/utils/backtrace-cleaner.js","../src/utils/deburr-column-name.js","../src/utils/event-emitter.js","../src/utils/file-exists.js","../src/utils/format-value.js","../src/utils/is-date.js","../src/utils/model-scope.js","../src/utils/nest-callbacks.js","../src/utils/plain-object.js","../src/utils/ransack.js","../src/utils/rest-args-error.js","../src/utils/singularize-model-name.js","../src/utils/split-sql-statements.js","../src/utils/to-import-specifier.js","../src/utils/with-tracked-stack-async-hooks.js","../src/utils/with-tracked-stack.js"],"version":"6.0.3"}
+{"root":["../index.js","../bin/velocious.js","../src/application.js","../src/configuration-resolver.js","../src/configuration-types.js","../src/configuration.js","../src/controller.js","../src/current-configuration.js","../src/current.js","../src/error-logger.js","../src/frontend-model-controller.js","../src/initializer.js","../src/logger.js","../src/mailer.js","../src/record-payload-values.js","../src/time-zone.js","../src/velocious-error.js","../src/authorization/ability.js","../src/authorization/base-resource.js","../src/background-jobs/client.js","../src/background-jobs/cron-expression.js","../src/background-jobs/forked-runner-child.js","../src/background-jobs/job-record.js","../src/background-jobs/job-registry.js","../src/background-jobs/job-runner.js","../src/background-jobs/job.js","../src/background-jobs/json-socket.js","../src/background-jobs/main.js","../src/background-jobs/normalize-error.js","../src/background-jobs/scheduler.js","../src/background-jobs/socket-request.js","../src/background-jobs/status-reporter.js","../src/background-jobs/store.js","../src/background-jobs/types.js","../src/background-jobs/worker.js","../src/background-jobs/web/authorization.js","../src/background-jobs/web/controller.js","../src/background-jobs/web/index.js","../src/background-jobs/web/path-matcher.js","../src/background-jobs/web/registry.js","../src/beacon/client.js","../src/beacon/in-process-broker.js","../src/beacon/in-process-client.js","../src/beacon/server.js","../src/beacon/types.js","../src/cli/base-command.js","../src/cli/browser-cli.js","../src/cli/index.js","../src/cli/tenant-database-command-helper.js","../src/cli/use-browser-cli.js","../src/cli/commands/background-jobs-main.js","../src/cli/commands/background-jobs-runner.js","../src/cli/commands/background-jobs-worker.js","../src/cli/commands/beacon.js","../src/cli/commands/console.js","../src/cli/commands/init.js","../src/cli/commands/routes.js","../src/cli/commands/run-script.js","../src/cli/commands/runner.js","../src/cli/commands/server.js","../src/cli/commands/test.js","../src/cli/commands/db/base-command.js","../src/cli/commands/db/create.js","../src/cli/commands/db/drop.js","../src/cli/commands/db/migrate.js","../src/cli/commands/db/reset.js","../src/cli/commands/db/rollback.js","../src/cli/commands/db/seed.js","../src/cli/commands/db/schema/dump.js","../src/cli/commands/db/schema/load.js","../src/cli/commands/db/tenants/check.js","../src/cli/commands/db/tenants/create.js","../src/cli/commands/db/tenants/drop.js","../src/cli/commands/db/tenants/migrate.js","../src/cli/commands/destroy/migration.js","../src/cli/commands/generate/base-models.js","../src/cli/commands/generate/frontend-models.js","../src/cli/commands/generate/migration.js","../src/cli/commands/generate/model.js","../src/cli/commands/lint/relationships.js","../src/database/advisory-lock-runner.js","../src/database/annotations-async-hooks.js","../src/database/annotations.js","../src/database/column-types.js","../src/database/datetime-storage.js","../src/database/handler.js","../src/database/initializer-from-require-context.js","../src/database/live-query.js","../src/database/migrations-ledger.js","../src/database/migrator.js","../src/database/record-changes.js","../src/database/use-database.js","../src/database/use-live-query.js","../src/database/drivers/base-column.js","../src/database/drivers/base-columns-index.js","../src/database/drivers/base-foreign-key.js","../src/database/drivers/base-table.js","../src/database/drivers/base.js","../src/database/drivers/mssql/column.js","../src/database/drivers/mssql/columns-index.js","../src/database/drivers/mssql/connect-connection.js","../src/database/drivers/mssql/foreign-key.js","../src/database/drivers/mssql/index.js","../src/database/drivers/mssql/options.js","../src/database/drivers/mssql/query-parser.js","../src/database/drivers/mssql/structure-sql.js","../src/database/drivers/mssql/table.js","../src/database/drivers/mssql/sql/alter-table.js","../src/database/drivers/mssql/sql/create-database.js","../src/database/drivers/mssql/sql/create-index.js","../src/database/drivers/mssql/sql/create-table.js","../src/database/drivers/mssql/sql/delete.js","../src/database/drivers/mssql/sql/drop-database.js","../src/database/drivers/mssql/sql/drop-table.js","../src/database/drivers/mssql/sql/insert.js","../src/database/drivers/mssql/sql/remove-index.js","../src/database/drivers/mssql/sql/update.js","../src/database/drivers/mssql/sql/upsert.js","../src/database/drivers/mysql/column.js","../src/database/drivers/mysql/columns-index.js","../src/database/drivers/mysql/foreign-key.js","../src/database/drivers/mysql/index.js","../src/database/drivers/mysql/options.js","../src/database/drivers/mysql/query-parser.js","../src/database/drivers/mysql/query.js","../src/database/drivers/mysql/structure-sql.js","../src/database/drivers/mysql/table.js","../src/database/drivers/mysql/sql/alter-table.js","../src/database/drivers/mysql/sql/create-database.js","../src/database/drivers/mysql/sql/create-index.js","../src/database/drivers/mysql/sql/create-table.js","../src/database/drivers/mysql/sql/delete.js","../src/database/drivers/mysql/sql/drop-database.js","../src/database/drivers/mysql/sql/drop-table.js","../src/database/drivers/mysql/sql/insert.js","../src/database/drivers/mysql/sql/remove-index.js","../src/database/drivers/mysql/sql/update.js","../src/database/drivers/mysql/sql/upsert.js","../src/database/drivers/pgsql/column.js","../src/database/drivers/pgsql/columns-index.js","../src/database/drivers/pgsql/foreign-key.js","../src/database/drivers/pgsql/index.js","../src/database/drivers/pgsql/options.js","../src/database/drivers/pgsql/query-parser.js","../src/database/drivers/pgsql/structure-sql.js","../src/database/drivers/pgsql/table.js","../src/database/drivers/pgsql/sql/alter-table.js","../src/database/drivers/pgsql/sql/create-database.js","../src/database/drivers/pgsql/sql/create-index.js","../src/database/drivers/pgsql/sql/create-table.js","../src/database/drivers/pgsql/sql/delete.js","../src/database/drivers/pgsql/sql/drop-database.js","../src/database/drivers/pgsql/sql/drop-table.js","../src/database/drivers/pgsql/sql/insert.js","../src/database/drivers/pgsql/sql/remove-index.js","../src/database/drivers/pgsql/sql/update.js","../src/database/drivers/pgsql/sql/upsert.js","../src/database/drivers/sqlite/base.js","../src/database/drivers/sqlite/column.js","../src/database/drivers/sqlite/columns-index.js","../src/database/drivers/sqlite/connection-sql-js.js","../src/database/drivers/sqlite/foreign-key.js","../src/database/drivers/sqlite/index.js","../src/database/drivers/sqlite/index.native.js","../src/database/drivers/sqlite/index.web.js","../src/database/drivers/sqlite/options.js","../src/database/drivers/sqlite/query-parser.js","../src/database/drivers/sqlite/query.js","../src/database/drivers/sqlite/query.native.js","../src/database/drivers/sqlite/query.web.js","../src/database/drivers/sqlite/structure-sql.js","../src/database/drivers/sqlite/table-rebuilder.js","../src/database/drivers/sqlite/table.js","../src/database/drivers/sqlite/web-persistence.js","../src/database/drivers/sqlite/sql/alter-table.js","../src/database/drivers/sqlite/sql/create-index.js","../src/database/drivers/sqlite/sql/create-table.js","../src/database/drivers/sqlite/sql/delete.js","../src/database/drivers/sqlite/sql/drop-table.js","../src/database/drivers/sqlite/sql/insert.js","../src/database/drivers/sqlite/sql/remove-index.js","../src/database/drivers/sqlite/sql/update.js","../src/database/drivers/sqlite/sql/upsert.js","../src/database/drivers/structure-sql/utils.js","../src/database/migration/index.js","../src/database/migrator/files-finder.js","../src/database/migrator/types.js","../src/database/pool/async-tracked-multi-connection.js","../src/database/pool/base-methods-forward.js","../src/database/pool/base.js","../src/database/pool/single-multi-use.js","../src/database/query/alter-table-base.js","../src/database/query/base.js","../src/database/query/create-database-base.js","../src/database/query/create-index-base.js","../src/database/query/create-table-base.js","../src/database/query/delete-base.js","../src/database/query/drop-database-base.js","../src/database/query/drop-table-base.js","../src/database/query/from-base.js","../src/database/query/from-plain.js","../src/database/query/from-table.js","../src/database/query/index.js","../src/database/query/insert-base.js","../src/database/query/join-base.js","../src/database/query/join-object.js","../src/database/query/join-plain.js","../src/database/query/join-tracker.js","../src/database/query/model-class-query.js","../src/database/query/order-base.js","../src/database/query/order-column.js","../src/database/query/order-plain.js","../src/database/query/preloader.js","../src/database/query/query-data.js","../src/database/query/remove-index-base.js","../src/database/query/select-base.js","../src/database/query/select-plain.js","../src/database/query/select-table-and-column.js","../src/database/query/update-base.js","../src/database/query/upsert-base.js","../src/database/query/where-base.js","../src/database/query/where-combinator.js","../src/database/query/where-hash.js","../src/database/query/where-model-class-hash.js","../src/database/query/where-not.js","../src/database/query/where-plain.js","../src/database/query/with-count.js","../src/database/query/preloader/belongs-to.js","../src/database/query/preloader/ensure-model-class-initialized.js","../src/database/query/preloader/has-many.js","../src/database/query/preloader/has-one.js","../src/database/query/preloader/selection.js","../src/database/query-parser/base-query-parser.js","../src/database/query-parser/from-parser.js","../src/database/query-parser/group-parser.js","../src/database/query-parser/joins-parser.js","../src/database/query-parser/limit-parser.js","../src/database/query-parser/options.js","../src/database/query-parser/order-parser.js","../src/database/query-parser/select-parser.js","../src/database/query-parser/where-parser.js","../src/database/record/acts-as-list.js","../src/database/record/auditing.js","../src/database/record/counter-cache-magnitude.js","../src/database/record/index.js","../src/database/record/record-not-found-error.js","../src/database/record/state-machine.js","../src/database/record/user-module.js","../src/database/record/validation-messages.js","../src/database/record/attachments/attachment-record.js","../src/database/record/attachments/download.js","../src/database/record/attachments/handle.js","../src/database/record/attachments/normalize-input.js","../src/database/record/attachments/store.js","../src/database/record/attachments/storage-drivers/filesystem.js","../src/database/record/attachments/storage-drivers/native.js","../src/database/record/attachments/storage-drivers/s3.js","../src/database/record/instance-relationships/base.js","../src/database/record/instance-relationships/belongs-to.js","../src/database/record/instance-relationships/has-many.js","../src/database/record/instance-relationships/has-one.js","../src/database/record/relationships/base.js","../src/database/record/relationships/belongs-to.js","../src/database/record/relationships/has-many.js","../src/database/record/relationships/has-one.js","../src/database/record/validators/base.js","../src/database/record/validators/format.js","../src/database/record/validators/length.js","../src/database/record/validators/presence.js","../src/database/record/validators/uniqueness.js","../src/database/table-data/index.js","../src/database/table-data/table-column.js","../src/database/table-data/table-foreign-key.js","../src/database/table-data/table-index.js","../src/database/table-data/table-reference.js","../src/database/tenants/data-copier.js","../src/database/tenants/schema-cloner.js","../src/database/tenants/tenant-table-plan.js","../src/environment-handlers/base.js","../src/environment-handlers/browser.js","../src/environment-handlers/node.js","../src/environment-handlers/node/cli/commands/background-jobs-main.js","../src/environment-handlers/node/cli/commands/background-jobs-runner.js","../src/environment-handlers/node/cli/commands/background-jobs-worker.js","../src/environment-handlers/node/cli/commands/beacon.js","../src/environment-handlers/node/cli/commands/cli-command-context.js","../src/environment-handlers/node/cli/commands/console.js","../src/environment-handlers/node/cli/commands/init.js","../src/environment-handlers/node/cli/commands/routes.js","../src/environment-handlers/node/cli/commands/run-script.js","../src/environment-handlers/node/cli/commands/runner.js","../src/environment-handlers/node/cli/commands/server.js","../src/environment-handlers/node/cli/commands/test.js","../src/environment-handlers/node/cli/commands/db/seed.js","../src/environment-handlers/node/cli/commands/db/schema/dump.js","../src/environment-handlers/node/cli/commands/db/schema/load.js","../src/environment-handlers/node/cli/commands/destroy/migration.js","../src/environment-handlers/node/cli/commands/generate/base-models.js","../src/environment-handlers/node/cli/commands/generate/frontend-models.js","../src/environment-handlers/node/cli/commands/generate/generated-file-banner.js","../src/environment-handlers/node/cli/commands/generate/migration.js","../src/environment-handlers/node/cli/commands/generate/model.js","../src/environment-handlers/node/cli/commands/lint/relationships.js","../src/error-reporting/request-details.js","../src/frontend-model-resource/base-resource.js","../src/frontend-model-resource/velocious-attachment-resource.js","../src/frontend-models/base.js","../src/frontend-models/built-in-resources.js","../src/frontend-models/clear-pending-debounced-callback.js","../src/frontend-models/event-hook-models.js","../src/frontend-models/model-registry.js","../src/frontend-models/outgoing-event-buffer.js","../src/frontend-models/preloader.js","../src/frontend-models/query.js","../src/frontend-models/resource-config-validation.js","../src/frontend-models/resource-definition.js","../src/frontend-models/transport-serialization.js","../src/frontend-models/use-created-event.js","../src/frontend-models/use-destroyed-event.js","../src/frontend-models/use-model-class-event.js","../src/frontend-models/use-updated-event.js","../src/frontend-models/websocket-channel.js","../src/frontend-models/websocket-publishers.js","../src/http-client/header.js","../src/http-client/index.js","../src/http-client/request.js","../src/http-client/response.js","../src/http-client/websocket-client.js","../src/http-server/cookie.js","../src/http-server/development-reloader.js","../src/http-server/index.js","../src/http-server/remote-address.js","../src/http-server/server-client.js","../src/http-server/server-lock.js","../src/http-server/websocket-channel-subscribers.js","../src/http-server/websocket-channel.js","../src/http-server/websocket-connection.js","../src/http-server/websocket-event-log-store.js","../src/http-server/websocket-events-host.js","../src/http-server/websocket-events.js","../src/http-server/client/index.js","../src/http-server/client/params-to-object.js","../src/http-server/client/request-parser.js","../src/http-server/client/request-runner.js","../src/http-server/client/request-timing.js","../src/http-server/client/request.js","../src/http-server/client/response.js","../src/http-server/client/websocket-request.js","../src/http-server/client/websocket-session.js","../src/http-server/client/request-buffer/form-data-part.js","../src/http-server/client/request-buffer/header.js","../src/http-server/client/request-buffer/index.js","../src/http-server/client/uploaded-file/memory-uploaded-file.js","../src/http-server/client/uploaded-file/temporary-uploaded-file.js","../src/http-server/client/uploaded-file/uploaded-file.js","../src/http-server/worker-handler/channel-subscriber-dispatch.js","../src/http-server/worker-handler/in-process.js","../src/http-server/worker-handler/index.js","../src/http-server/worker-handler/worker-script.js","../src/http-server/worker-handler/worker-thread.js","../src/jobs/mail-delivery.js","../src/jobs/prune-terminal-background-jobs.js","../src/logger/base-logger.js","../src/logger/console-logger.js","../src/logger/file-logger.js","../src/logger/outputs/array-output.js","../src/logger/outputs/console-output.js","../src/logger/outputs/file-output.js","../src/logger/outputs/stdout-output.js","../src/mailer/base.js","../src/mailer/delivery.js","../src/mailer/index.js","../src/mailer/backends/smtp.js","../src/packages/velocious-package.js","../src/plugins/sqljs-wasm-route-controller.js","../src/plugins/sqljs-wasm-route.js","../src/routes/app-routes.js","../src/routes/base-route.js","../src/routes/basic-route.js","../src/routes/get-route.js","../src/routes/index.js","../src/routes/namespace-route.js","../src/routes/plugin-routes.js","../src/routes/post-route.js","../src/routes/resolver.js","../src/routes/resource-route.js","../src/routes/root-route.js","../src/routes/built-in/api-manifest/controller.js","../src/routes/built-in/debug/controller.js","../src/routes/built-in/errors/controller.js","../src/routes/hooks/frontend-model-command-route-hook.js","../src/sync/conflict-strategy.js","../src/sync/device-identity.js","../src/sync/local-mutation-log.js","../src/sync/offline-grant.js","../src/sync/peer-mutation-bundle.js","../src/sync/query-scope.js","../src/sync/server-change-feed.js","../src/sync/server-sequence-allocator.js","../src/sync/stable-json.js","../src/sync/sync-api-client-types.js","../src/sync/sync-api-client.js","../src/sync/sync-api-controller.js","../src/sync/sync-change-fanout.js","../src/sync/sync-channel-name.js","../src/sync/sync-client-registry.js","../src/sync/sync-client-types.js","../src/sync/sync-client.js","../src/sync/sync-envelope-replay-service.js","../src/sync/sync-model-change-feed-service.js","../src/sync/sync-publish-suppression.js","../src/sync/sync-publisher-types.js","../src/sync/sync-publisher.js","../src/sync/sync-realtime-bridge.js","../src/sync/sync-replay-upsert-applier.js","../src/sync/sync-resource-base.js","../src/sync/sync-scope-attributes.js","../src/sync/sync-scope-store.js","../src/sync/sync-websocket-channel.js","../src/tenants/default-tenant-database-provisioning.js","../src/tenants/tenant-aggregator.js","../src/tenants/tenant-iterator.js","../src/tenants/tenant.js","../src/testing/base-expect.js","../src/testing/browser-frontend-model-event-hook-scenarios.js","../src/testing/browser-test-app.js","../src/testing/expect-to-change.js","../src/testing/expect-utils.js","../src/testing/expect.js","../src/testing/request-client.js","../src/testing/test-files-finder.js","../src/testing/test-filter-parser.js","../src/testing/test-runner.js","../src/testing/test-suite-splitter.js","../src/testing/test.js","../src/types/external-modules.d.ts","../src/utils/backtrace-cleaner-node.js","../src/utils/backtrace-cleaner.js","../src/utils/deburr-column-name.js","../src/utils/event-emitter.js","../src/utils/file-exists.js","../src/utils/format-value.js","../src/utils/is-date.js","../src/utils/model-scope.js","../src/utils/nest-callbacks.js","../src/utils/plain-object.js","../src/utils/ransack.js","../src/utils/rest-args-error.js","../src/utils/singularize-model-name.js","../src/utils/split-sql-statements.js","../src/utils/to-import-specifier.js","../src/utils/with-tracked-stack-async-hooks.js","../src/utils/with-tracked-stack.js"],"version":"6.0.3"}

package/package.json

@@ -3,7 +3,7 @@
     "velocious": "build/bin/velocious.js"
   },
   "name": "velocious",
-  "version": "1.0.520",
+  "version": "1.0.522",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": [

package/src/background-jobs/store.js

@@ -225,6 +225,12 @@ export default class BackgroundJobsStore {
       query = query.where({execution_mode: executionModes})
     }
 
+    if (scheduledAtOperator === "<=") {
+      const priorityOrder = this._queuePriorityOrderSql(db)
+
+      if (priorityOrder) query = query.order(`${priorityOrder} DESC`)
+    }
+
     query = query
       .order("scheduled_at_ms ASC")
       .order("created_at_ms ASC")
@@ -238,6 +244,40 @@ export default class BackgroundJobsStore {
     return this._normalizeJobRow(row)
   }
 
+  /**
+   * Builds a raw SQL ORDER BY expression ranking queued jobs by their queue's
+   * configured priority (`backgroundJobs.queues[queue].priority`, default `0`),
+   * so the dispatcher picks higher-priority queues first regardless of enqueue
+   * order. Only applied to the dispatch path (`scheduledAtOperator === "<="`);
+   * the future-scheduled lookup must stay strictly time-ordered. Composes with
+   * the concurrency EXISTS filter: a higher-priority queue already at its cap is
+   * filtered out, so dispatch falls through to the next eligible lower-priority
+   * job. Returns null when no queue configures a non-zero priority so the plain
+   * FIFO ordering is left untouched (and no needless filesort is introduced).
+   * @param {import("../database/drivers/base.js").default} db - Database connection.
+   * @returns {string | null} - Raw SQL CASE expression, or null when no queue is prioritized.
+   */
+  _queuePriorityOrderSql(db) {
+    const queues = this.configuration.getBackgroundJobsConfig().queues || {}
+    /** @type {Array<[string, number]>} */
+    const prioritized = []
+
+    for (const [queue, queueConfig] of Object.entries(queues)) {
+      const priority = queueConfig?.priority
+
+      if (Number.isFinite(priority) && Number(priority) !== 0) prioritized.push([queue, Number(priority)])
+    }
+
+    if (prioritized.length === 0) return null
+
+    const queueColumn = db.quoteColumn("queue")
+    const whens = prioritized
+      .map(([queue, priority]) => `WHEN ${db.quote(queue)} THEN ${priority}`)
+      .join(" ")
+
+    return `CASE COALESCE(${queueColumn}, ${db.quote(DEFAULT_QUEUE)}) ${whens} ELSE 0 END`
+  }
+
   /**
    * Runs get job.
    * @param {string} jobId - Job id.

package/src/configuration-types.js

@@ -164,15 +164,29 @@
  *   allowed to keep in flight. Default: `4`. This is a per-worker safety cap;
  *   for workload-shaped limits use per-queue caps (`queues`) instead, which are
  *   enforced cluster-wide and are immune to duplicate worker processes.
- * @property {Record<string, {maxConcurrent?: number}>} [queues] - Per-queue
- *   concurrency caps, Sidekiq-style. A job declares its queue (static `queue` on
- *   the job class, or the `queue` enqueue option; defaults to `"default"`), and
+ * @property {Record<string, {maxConcurrent?: number, priority?: number}>} [queues] - Per-queue
+ *   concurrency caps and dispatch priorities, Sidekiq-style. A job declares its queue (static
+ *   `queue` on the job class, or the `queue` enqueue option; defaults to `"default"`), and
  *   `queues[name].maxConcurrent` bounds how many jobs from that queue may be
  *   in flight across the whole cluster (enforced via durable per-key
  *   concurrency, so it holds regardless of how many worker processes run).
  *   Size each queue to its workload: I/O-bound queues (e.g. build runners
  *   waiting on remote Docker servers) can run far above the core count, while
- *   CPU-bound queues should stay near it. Default: `{}` (no queue caps).
+ *   CPU-bound queues should stay near it. `queues[name].priority` (default `0`)
+ *   makes the main process dispatch higher-priority queues before lower-priority
+ *   ones regardless of enqueue order, so a small time-critical queue can never be
+ *   starved by a flood of low-priority work sharing a worker pool. Unlike
+ *   Sidekiq's strict queue ordering, priority composes with the per-queue caps:
+ *   a higher-priority queue that is already at its `maxConcurrent` is skipped and
+ *   dispatch falls through to the next eligible lower-priority job, so a busy
+ *   high-priority queue does not block everything else. This fallthrough is a
+ *   property of the queue-derived cap; a job that supplies its own explicit
+ *   `concurrencyKey`/`maxConcurrency` bypasses the queue cap entirely (an
+ *   explicit key always wins — see above) and is bounded only by that key, so it
+ *   is not held back by the queue's cap and priority simply orders it normally.
+ *   Priorities may be any number, including negative to sink a queue below the
+ *   default. Jobs within the same priority keep FIFO (`scheduled_at`, then
+ *   `created_at`) order. Default: `{}` (no queue caps, all queues priority `0`).
  * @property {BackgroundJobsDispatchStrategy} [dispatchStrategy] - How the main process
  *   detects new work. Defaults to `"beacon"` (event-driven). Set to `"polling"`
  *   to restore the legacy fixed-interval poll.