velocious 1.0.446 → 1.0.447

package/README.md

@@ -1453,7 +1453,7 @@ database: {
 }
 ```
 
-`pool.max` caps live async-tracked connections for that pool. When the cap is reached, new checkouts wait until a matching checked-in connection can be handed over or capacity is freed. The built-in debug endpoint reports each in-use connection's `checkedOutForMs`, each idle connection's `idleForMs`, and queued `pendingCheckouts[].waitingForMs` so production diagnostics can distinguish long-held checkouts from pool-capacity waits.
+`pool.max` caps live async-tracked connections for that pool and defaults to `10` when omitted. When the cap is reached, new checkouts wait until a matching checked-in connection can be handed over or capacity is freed. Set `pool.max` to `null` only when a process is deliberately allowed to open an unbounded number of database connections. The built-in debug endpoint reports each in-use connection's `checkedOutForMs`, each idle connection's `idleForMs`, and queued `pendingCheckouts[].waitingForMs` so production diagnostics can distinguish long-held checkouts from pool-capacity waits.
 
 # Websockets
 

package/build/configuration-types.js

@@ -44,7 +44,7 @@
  * @property {boolean} [options.trustServerCertificate] - Whether to trust the server certificate (MSSQL).
  * @property {string} [password] - Password for the SQL user.
  * @property {object} [pool] - Connection pool configuration.
- * @property {number} [pool.max] - Maximum number of connections.
+ * @property {number | null} [pool.max] - Maximum number of connections. Set null to disable the cap.
  * @property {number} [pool.min] - Minimum number of connections.
  * @property {number} [pool.idleTimeoutMillis] - Idle timeout before releasing a connection.
  * @property {string} [server] - SQL server hostname.
@@ -54,7 +54,7 @@
 /**
  * @typedef {object} DatabasePoolConfiguration
  * @property {number | null} [idleTimeoutMillis] - Idle timeout before closing a checked-in async-tracked connection. Set null to disable idle reaping. Default: 5000.
- * @property {number} [max] - Maximum live async-tracked connections for this pool. Extra checkouts wait until a matching connection is checked in or capacity is freed.
+ * @property {number | null} [max] - Maximum live async-tracked connections for this pool. Defaults to 10. Extra checkouts wait until a matching connection is checked in or capacity is freed. Set null to disable the cap.
  */
 
 /**

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

@@ -6,6 +6,7 @@ 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 DEFAULT_MAX_CONNECTIONS = 10
 const DEFAULT_IDLE_TIMEOUT_MILLIS = 5000
 
 /**
@@ -285,9 +286,10 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   maxConnections() {
     const value = this.getConfiguration().pool?.max
 
+    if (value === null) return
     if (this.validMaxConnections(value)) return value
 
-    return
+    return DEFAULT_MAX_CONNECTIONS
   }
 
   /**

package/build/database/record/index.js

@@ -13,7 +13,7 @@
 
 /**
  * Model class constructor type used for static `this` typing.
- * @template {VelociousDatabaseRecord} T
+ * @template T
  * @typedef {{new (changes?: Record<string, unknown>): T}} ModelConstructor
  */
 
@@ -508,7 +508,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs before validation.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -519,7 +519,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs before save.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -530,7 +530,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs before create.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -541,7 +541,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs before update.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -552,7 +552,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs before destroy.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -563,7 +563,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs after save.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -574,7 +574,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs after create.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -585,7 +585,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs after update.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */
@@ -596,7 +596,7 @@ class VelociousDatabaseRecord {
   /**
    * Runs after destroy.
    * @template R
-   * @this {new (...args: Array<?>) => R}
+   * @this {ModelConstructor<R>}
    * @param {LifecycleCallbackType<R>} callback - Callback function or instance method name.
    * @returns {void}
    */