velocious 1.0.577 → 1.0.579

package/build/src/configuration.d.ts

@@ -1,26 +1,20 @@
-export { CurrentConfigurationNotSetError };
-export default class VelociousConfiguration {
+export type WithConnectionsCallbackType<T> = (arg: Record<string, import("./database/drivers/base.js").default>) => Promise<T>;
+export type WithConnectionsOptionsType = {
     /**
-     * Runs current.
-     * @returns {VelociousConfiguration} - The current.
+     * - Database identifiers to include in the connection scope.
      */
-    static current(): VelociousConfiguration;
+    databaseIdentifiers?: string[];
     /**
-     * Runs constructor.
-     * @param {import("./configuration-types.js").ConfigurationArgsType} args - Configuration arguments.
+     * - Human-readable name for the checked-out database connections.
      */
-    constructor({ abilityResolver, abilityResources, attachments, autoload, backgroundJobs, backendProjects, beacon, cookieSecret, cors, database, debug, debugEndpoint, apiManifest, directory, enforceTenantDatabaseScopes, environment, environmentHandler, exposeInternalErrorsToClients, httpServer, initializeModels, initializers, locale, localeFallbacks, locales, logging, mailerBackend, packages, requestTimeoutMs, routeResolverHooks, scheduledBackgroundJobs, structureSql, sync, tenantDatabaseProviders, tenantDatabaseResolver, tenantResolver, testing, timeZone, timezoneOffsetMinutes, trustedProxies, websocketChannelResolver, websocketMessageHandlerResolver, ...restArgs }: import("./configuration-types.js").ConfigurationArgsType);
-    /**
-     * Close database connections promise.
-     * @type {Promise<void> | null} */
-    _closeDatabaseConnectionsPromise: Promise<void> | null;
-    /**
-     * Dedicated advisory-lock connections currently holding a lock. These are spawned
-     * outside the pools' tracked sets (so a hold-timeout lock survives pool checkouts),
-     * so `closeDatabaseConnections` would otherwise walk past them; tracking them here
-     * lets a shutdown close them and release the lock instead of orphaning it.
-     * @type {Set<import("./database/drivers/base.js").default>} */
-    _advisoryLockConnections: Set<import("./database/drivers/base.js").default>;
+    name?: string;
+};
+import DatabaseOperation from "./database/operation.js";
+import VelociousWebsocketChannelSubscribers from "./http-server/websocket-channel-subscribers.js";
+import { CurrentConfigurationNotSetError } from "./current-configuration.js";
+import VelociousPackage from "./packages/velocious-package.js";
+export { CurrentConfigurationNotSetError };
+export default class VelociousConfiguration {
     _abilityResolver: import("./configuration-types.js").AbilityResolverType | undefined;
     _abilityResources: typeof import("./authorization/base-resource.js").default[];
     _autoload: boolean;
@@ -80,13 +74,26 @@ export default class VelociousConfiguration {
     _enforceTenantDatabaseScopes: boolean;
     _exposeInternalErrorsToClients: boolean;
     _directory: string | undefined;
-    _initializeModels: (arg0: {
+    _initializeModels: (args: {
         configuration: import("./configuration.js").default;
         type: string;
     }) => void;
     /** @type {VelociousPackage[]} */
     _packages: VelociousPackage[];
     _isInitialized: boolean;
+    _modelsInitialized: boolean;
+    /**
+     * Invalidates model phases that started before database connections closed.
+     * @type {number}
+     */
+    _modelInitializationGeneration: number;
+    /**
+     * In-progress `initializeModels()` promise. Model initialization is an
+     * atomic bootstrap phase: concurrent callers share it, and a rejection
+     * leaves the phase eligible for a later complete attempt.
+     * @type {Promise<void> | undefined}
+     */
+    _initializeModelsPromise: Promise<void> | undefined;
     /**
      * In-progress `initialize()` promise, memoized so concurrent callers await
      * the same bootstrap. Reset to undefined if initialization fails.
@@ -94,6 +101,11 @@ export default class VelociousConfiguration {
      */
     _initializePromise: Promise<void> | undefined;
     httpServer: {
+        host?: string;
+        inProcess?: boolean;
+        maxWorkers?: number;
+        port?: number;
+        workers?: number;
         compression: import("./configuration-types.js").NormalizedHttpCompressionConfiguration;
         websocketInboundQueue: {
             maxPendingBytes: number;
@@ -103,32 +115,12 @@ export default class VelociousConfiguration {
             maxPendingBytes: number;
             maxPendingFrames: number;
         };
-        /**
-         * - Hostname to bind the HTTP server to.
-         */
-        host?: string | undefined;
-        /**
-         * - Run HTTP handlers in the main thread instead of worker threads.
-         */
-        inProcess?: boolean | undefined;
-        /**
-         * - Backward-compatible alias for workers.
-         */
-        maxWorkers?: number | undefined;
-        /**
-         * - Port to bind the HTTP server to.
-         */
-        port?: number | undefined;
-        /**
-         * - Worker handlers to start for the HTTP server.
-         */
-        workers?: number | undefined;
     };
     /**
      * Stores the http server instance value.
-     * @type {{getDebugSnapshot: () => Promise<Record<string, ?>>} | undefined} */
+     * @type {{getDebugSnapshot: () => Promise<Record<string, ReturnType<typeof JSON.parse>>>} | undefined} */
     _httpServerInstance: {
-        getDebugSnapshot: () => Promise<Record<string, unknown>>;
+        getDebugSnapshot: () => Promise<Record<string, ReturnType<typeof JSON.parse>>>;
     } | undefined;
     locale: string | (() => string);
     localeFallbacks: import("./configuration-types.js").LocaleFallbacksType;
@@ -200,8 +192,8 @@ export default class VelociousConfiguration {
     }) => Promise<void>) | null;
     /**
      * Stores the websocket session identity resolver value.
-     * @type {((session: import("./http-server/client/websocket-session.js").default) => ? | Promise<?>) | null} */
-    _websocketSessionIdentityResolver: ((session: import("./http-server/client/websocket-session.js").default) => unknown | Promise<unknown>) | null;
+     * @type {((session: import("./http-server/client/websocket-session.js").default) => ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>) | null} */
+    _websocketSessionIdentityResolver: ((session: import("./http-server/client/websocket-session.js").default) => ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>) | null;
     _logging: import("./configuration-types.js").LoggingConfiguration | undefined;
     _mailerBackend: import("./configuration-types.js").MailerBackend | undefined;
     _routeResolverHooks: import("./configuration-types.js").RouteResolverHookType[];
@@ -222,6 +214,30 @@ export default class VelociousConfiguration {
     modelClasses: {
         [key: string]: typeof import("./database/record/index.js").default;
     };
+    _routes: import("./routes/index.js").default | undefined;
+    _translator: ((arg1: string, arg2: Record<string, ReturnType<typeof JSON.parse>> | undefined) => string) | undefined;
+    _defaultTranslatorBound: ((msgID: string, args?: Record<string, ReturnType<typeof JSON.parse>>) => string) | undefined;
+    /**
+     * Close database connections promise.
+     * @type {Promise<void> | null} */
+    _closeDatabaseConnectionsPromise: Promise<void> | null;
+    /**
+     * Dedicated advisory-lock connections currently holding a lock. These are spawned
+     * outside the pools' tracked sets (so a hold-timeout lock survives pool checkouts),
+     * so `closeDatabaseConnections` would otherwise walk past them; tracking them here
+     * lets a shutdown close them and release the lock instead of orphaning it.
+     * @type {Set<import("./database/drivers/base.js").default>} */
+    _advisoryLockConnections: Set<import("./database/drivers/base.js").default>;
+    /**
+     * Runs current.
+     * @returns {VelociousConfiguration} - The current.
+     */
+    static current(): VelociousConfiguration;
+    /**
+     * Runs constructor.
+     * @param {import("./configuration-types.js").ConfigurationArgsType} args - Configuration arguments.
+     */
+    constructor({ abilityResolver, abilityResources, attachments, autoload, backgroundJobs, backendProjects, beacon, cookieSecret, cors, database, debug, debugEndpoint, apiManifest, directory, enforceTenantDatabaseScopes, environment, environmentHandler, exposeInternalErrorsToClients, httpServer, initializeModels, initializers, locale, localeFallbacks, locales, logging, mailerBackend, packages, requestTimeoutMs, routeResolverHooks, scheduledBackgroundJobs, structureSql, sync, tenantDatabaseProviders, tenantDatabaseResolver, tenantResolver, testing, timeZone, timezoneOffsetMinutes, trustedProxies, websocketChannelResolver, websocketMessageHandlerResolver, ...restArgs }: import("./configuration-types.js").ConfigurationArgsType);
     /**
      * Runs get autoload.
      * @returns {boolean} Whether auto-batch-preload of relationships on lazy access is enabled globally.
@@ -343,10 +359,10 @@ export default class VelociousConfiguration {
     /**
      * Runs resolve database configuration.
      * @param {string} identifier - Identifier.
-     * @param {?} [tenant] - Tenant override.
+     * @param {ReturnType<typeof JSON.parse>} [tenant] - Tenant override.
      * @returns {import("./configuration-types.js").DatabaseConfigurationType} - Resolved database configuration for the identifier.
      */
-    resolveDatabaseConfiguration(identifier: string, tenant?: unknown): import("./configuration-types.js").DatabaseConfigurationType;
+    resolveDatabaseConfiguration(identifier: string, tenant?: ReturnType<typeof JSON.parse>): import("./configuration-types.js").DatabaseConfigurationType;
     /**
      * Runs get disabled database identifiers.
      * @returns {Set<string>} - Disabled database identifiers from env flags.
@@ -355,10 +371,10 @@ export default class VelociousConfiguration {
     /**
      * Runs is database identifier active.
      * @param {string} identifier - Database identifier.
-     * @param {?} [tenant] - Tenant override.
+     * @param {ReturnType<typeof JSON.parse>} [tenant] - Tenant override.
      * @returns {boolean} - Whether this database identifier is active in the current tenant context.
      */
-    isDatabaseIdentifierActive(identifier: string, tenant?: unknown): boolean;
+    isDatabaseIdentifierActive(identifier: string, tenant?: ReturnType<typeof JSON.parse>): boolean;
     /**
      * Runs get database identifiers.
      * @returns {Array<string>} - The database identifiers.
@@ -366,44 +382,44 @@ export default class VelociousConfiguration {
     getDatabaseIdentifiers(): Array<string>;
     /**
      * Runs get debug snapshot.
-     * @returns {Promise<Record<string, ?>>} - Human-readable server diagnostics.
+     * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>>} - Human-readable server diagnostics.
      */
-    getDebugSnapshot(): Promise<Record<string, unknown>>;
+    getDebugSnapshot(): Promise<Record<string, ReturnType<typeof JSON.parse>>>;
     /**
      * Runs get local debug snapshot.
-     * @returns {Record<string, ?>} - Human-readable diagnostics for this process only.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Human-readable diagnostics for this process only.
      */
-    getLocalDebugSnapshot(): Record<string, unknown>;
+    getLocalDebugSnapshot(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs debug http server snapshot.
-     * @returns {Promise<Record<string, ?>>} - HTTP server worker diagnostics.
+     * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>>} - HTTP server worker diagnostics.
      */
-    _debugHttpServerSnapshot(): Promise<Record<string, unknown>>;
+    _debugHttpServerSnapshot(): Promise<Record<string, ReturnType<typeof JSON.parse>>>;
     /**
      * Runs debug server snapshot.
-     * @returns {Record<string, ?>} - Server runtime diagnostics.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Server runtime diagnostics.
      */
-    _debugServerSnapshot(): Record<string, unknown>;
+    _debugServerSnapshot(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs debug configuration snapshot.
-     * @returns {Record<string, ?>} - Configuration diagnostics.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Configuration diagnostics.
      */
-    _debugConfigurationSnapshot(): Record<string, unknown>;
+    _debugConfigurationSnapshot(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs debug background jobs snapshot.
-     * @returns {Record<string, ?>} - Background job diagnostics.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Background job diagnostics.
      */
-    _debugBackgroundJobsSnapshot(): Record<string, unknown>;
+    _debugBackgroundJobsSnapshot(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs debug database snapshot.
-     * @returns {Record<string, ?>} - Database diagnostics.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Database diagnostics.
      */
-    _debugDatabaseSnapshot(): Record<string, unknown>;
+    _debugDatabaseSnapshot(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs debug websocket snapshot.
-     * @returns {Record<string, ?>} - WebSocket diagnostics.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - WebSocket diagnostics.
      */
-    _debugWebsocketSnapshot(): Record<string, unknown>;
+    _debugWebsocketSnapshot(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs get database pool.
      * @param {string} identifier - Identifier.
@@ -431,7 +447,7 @@ export default class VelociousConfiguration {
      * @returns {typeof import("./database/pool/base.js").default} - The database pool type.
      */
     getDatabasePoolType(identifier?: string): typeof import("./database/pool/base.js").default;
-    getDatabaseType(identifier?: string): "sqlite" | "mysql" | "pgsql" | "mssql";
+    getDatabaseType(identifier?: string): "mssql" | "mysql" | "pgsql" | "sqlite";
     /**
      * Runs get directory.
      * @returns {string} - The directory.
@@ -580,7 +596,7 @@ export default class VelociousConfiguration {
      * @returns {Required<Pick<import("./configuration-types.js").LoggingConfiguration, "console" | "file" | "levels">> & Pick<import("./configuration-types.js").LoggingConfiguration, "directory" | "filePath"> & Partial<Pick<import("./configuration-types.js").LoggingConfiguration, "outputs" | "loggers">>} - The logging configuration.
      */
     getLoggingConfiguration({ defaultConsole }?: {
-        defaultConsole?: boolean | undefined;
+        defaultConsole?: boolean;
     }): Required<Pick<import("./configuration-types.js").LoggingConfiguration, "console" | "file" | "levels">> & Pick<import("./configuration-types.js").LoggingConfiguration, "directory" | "filePath"> & Partial<Pick<import("./configuration-types.js").LoggingConfiguration, "outputs" | "loggers">>;
     /**
      * Runs get query logging enabled.
@@ -657,7 +673,7 @@ export default class VelociousConfiguration {
      * @returns {Promise<import("./beacon/client.js").default | import("./beacon/in-process-client.js").default | undefined>} - Resolves with the registered client (TCP mode: connect may still be in flight), or undefined when Beacon is disabled.
      */
     connectBeacon({ peerType }?: {
-        peerType?: string | undefined;
+        peerType?: string;
     }): Promise<import("./beacon/client.js").default | import("./beacon/in-process-client.js").default | undefined>;
     /**
      * Builds a Beacon client matching the configured mode. Split out so
@@ -669,7 +685,7 @@ export default class VelociousConfiguration {
      */
     _createBeaconClient({ config, peerType }: {
         config: ReturnType<VelociousConfiguration["getBeaconConfig"]>;
-        peerType?: string | undefined;
+        peerType?: string;
     }): Promise<import("./beacon/client.js").default | import("./beacon/in-process-client.js").default>;
     /**
      * Records a Beacon connect/disconnect failure without reporting it immediately.
@@ -857,7 +873,6 @@ export default class VelociousConfiguration {
     initializeModels(args?: {
         type: string;
     }): Promise<void>;
-    _modelsInitialized: boolean | undefined;
     /**
      * Ensures each configured database pool has a global connection available.
      * Useful when `getCurrentConnection` might be called without an async context.
@@ -901,7 +916,6 @@ export default class VelociousConfiguration {
      * @returns {void} - No return value.
      */
     setRoutes(newRoutes: import("./routes/index.js").default): void;
-    _routes: import("./routes/index.js").default | undefined;
     /**
      * Applies any `route.mount(...)` registrations from the routes file by letting
      * each mountable register its routes (typically route-resolver hooks) against
@@ -919,24 +933,22 @@ export default class VelociousConfiguration {
     routes(callback: (routes: import("./routes/plugin-routes.js").default) => void): void;
     /**
      * Runs set translator.
-     * @param {function(string, Record<string, ?> | undefined) : string} callback - Translator callback.
+     * @param {(arg1: string, arg2: Record<string, ReturnType<typeof JSON.parse>> | undefined) => string} callback - Translator callback.
      * @returns {void} - No return value.
      */
-    setTranslator(callback: (arg0: string, arg1: Record<string, unknown> | undefined) => string): void;
-    _translator: ((arg0: string, arg1: Record<string, unknown> | undefined) => string) | undefined;
+    setTranslator(callback: (arg1: string, arg2: Record<string, ReturnType<typeof JSON.parse>> | undefined) => string): void;
     /**
      * Runs default translator.
      * @param {string} msgID - Msg id.
-     * @param {Record<string, ?>} [args] - Translator options and variables.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} [args] - Translator options and variables.
      * @returns {string} - The default translator.
      */
-    _defaultTranslator(msgID: string, args?: Record<string, unknown>): string;
+    _defaultTranslator(msgID: string, args?: Record<string, ReturnType<typeof JSON.parse>>): string;
     /**
      * Runs get translator.
-     * @returns {(msgID: string, args?: Record<string, ?>) => string} - The configured translator.
+     * @returns {(msgID: string, args?: Record<string, ReturnType<typeof JSON.parse>>) => string} - The configured translator.
      */
-    getTranslator(): (msgID: string, args?: Record<string, unknown>) => string;
-    _defaultTranslatorBound: ((msgID: string, args?: Record<string, unknown>) => string) | undefined;
+    getTranslator(): (msgID: string, args?: Record<string, ReturnType<typeof JSON.parse>>) => string;
     /**
      * Runs configure default translator.
      * @returns {void} - Configure gettext defaults for this configuration.
@@ -1027,8 +1039,8 @@ export default class VelociousConfiguration {
      * `canSubscribe()` continue to receive broadcasts until they
      * unsubscribe or the session ends.
      * @param {string} name
-     * @param {Record<string, ?>} broadcastParams
-     * @param {?} body
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} broadcastParams
+     * @param {ReturnType<typeof JSON.parse>} body
      * @returns {void}
      */
     /**
@@ -1106,15 +1118,15 @@ export default class VelociousConfiguration {
      *
      * Return `null`/`undefined` to mean "no identity" — resumes still
      * succeed if pause and resume both resolve to a nullish value.
-     * @param {((session: import("./http-server/client/websocket-session.js").default) => ? | Promise<?>) | null} resolver - Authenticated-caller identity resolver, or null to disable identity checks.
+     * @param {((session: import("./http-server/client/websocket-session.js").default) => ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>) | null} resolver - Authenticated-caller identity resolver, or null to disable identity checks.
      * @returns {void}
      */
-    setWebsocketSessionIdentityResolver(resolver: ((session: import("./http-server/client/websocket-session.js").default) => unknown | Promise<unknown>) | null): void;
+    setWebsocketSessionIdentityResolver(resolver: ((session: import("./http-server/client/websocket-session.js").default) => ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>) | null): void;
     /**
      * Runs get websocket session identity resolver.
-     * @returns {((session: import("./http-server/client/websocket-session.js").default) => ? | Promise<?>) | null} - The configured identity resolver.
+     * @returns {((session: import("./http-server/client/websocket-session.js").default) => ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>) | null} - The configured identity resolver.
      */
-    getWebsocketSessionIdentityResolver(): ((session: import("./http-server/client/websocket-session.js").default) => unknown | Promise<unknown>) | null;
+    getWebsocketSessionIdentityResolver(): ((session: import("./http-server/client/websocket-session.js").default) => ReturnType<typeof JSON.parse> | Promise<ReturnType<typeof JSON.parse>>) | null;
     /**
      * Runs set websocket session grace seconds.
      * @param {number} seconds - Grace period before a paused session expires.
@@ -1161,11 +1173,11 @@ export default class VelociousConfiguration {
     /**
      * Runs broadcast to channel.
      * @param {string} name - Channel type receiving the broadcast.
-     * @param {Record<string, ?>} broadcastParams - Values used to match eligible subscriptions.
-     * @param {?} body - Broadcast payload delivered to matching subscriptions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} broadcastParams - Values used to match eligible subscriptions.
+     * @param {ReturnType<typeof JSON.parse>} body - Broadcast payload delivered to matching subscriptions.
      * @returns {void}
      */
-    broadcastToChannel(name: string, broadcastParams: Record<string, unknown>, body: unknown): void;
+    broadcastToChannel(name: string, broadcastParams: Record<string, ReturnType<typeof JSON.parse>>, body: ReturnType<typeof JSON.parse>): void;
     /**
      * Awaits all pending broadcast operations (including event-log
      * persistence). Call this after `broadcastToChannel` when you need
@@ -1179,12 +1191,12 @@ export default class VelociousConfiguration {
      * directly (in-process mode) or by the worker thread after the
      * main-process fan-out.
      * @param {string} name - Channel name.
-     * @param {Record<string, ?>} broadcastParams - Params passed to each subscription's `matches()`.
-     * @param {?} body - Message body delivered via `sendMessage()`.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} broadcastParams - Params passed to each subscription's `matches()`.
+     * @param {ReturnType<typeof JSON.parse>} body - Message body delivered via `sendMessage()`.
      * @param {{eventId?: string}} [meta] - Optional event metadata for replay tracking.
      * @returns {void}
      */
-    _broadcastToChannelLocal(name: string, broadcastParams: Record<string, unknown>, body: unknown, meta?: {
+    _broadcastToChannelLocal(name: string, broadcastParams: Record<string, ReturnType<typeof JSON.parse>>, body: ReturnType<typeof JSON.parse>, meta?: {
         eventId?: string;
     }): void;
     /**
@@ -1217,37 +1229,37 @@ export default class VelociousConfiguration {
     /**
      * Runs resolve ability.
      * @param {object} args - Ability resolver args.
-     * @param {Record<string, ?>} args.params - Request params.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Request params.
      * @param {import("./http-server/client/request.js").default | import("./http-server/client/websocket-request.js").default} [args.request] - Request object. Absent for websocket channel subscriptions resolved from subscribe params.
      * @param {import("./http-server/client/response.js").default} [args.response] - Response object. Absent outside HTTP request handling.
      * @returns {Promise<import("./authorization/ability.js").default | undefined>} - Resolved ability.
      */
     resolveAbility({ params, request, response }: {
-        params: Record<string, unknown>;
-        request?: import("./http-server/client/websocket-request.js").default | import("./http-server/client/request.js").default | undefined;
-        response?: import("./http-server/client/response.js").default | undefined;
+        params: Record<string, ReturnType<typeof JSON.parse>>;
+        request?: import("./http-server/client/request.js").default | import("./http-server/client/websocket-request.js").default;
+        response?: import("./http-server/client/response.js").default;
     }): Promise<import("./authorization/ability.js").default | undefined>;
     /**
      * Runs run with ability.
      * @param {import("./authorization/ability.js").default | undefined} ability - Ability instance.
-     * @param {() => Promise<?>} callback - Callback.
-     * @returns {Promise<?>} - Callback result.
+     * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+     * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
      */
-    runWithAbility(ability: import("./authorization/ability.js").default | undefined, callback: () => Promise<unknown>): Promise<unknown>;
+    runWithAbility(ability: import("./authorization/ability.js").default | undefined, callback: () => Promise<ReturnType<typeof JSON.parse>>): Promise<ReturnType<typeof JSON.parse>>;
     /**
      * Runs run with request timing.
      * @param {import("./http-server/client/request-timing.js").default | undefined} requestTiming - Request timing collector.
-     * @param {() => Promise<?>} callback - Callback.
-     * @returns {Promise<?>} - Callback result.
+     * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+     * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
      */
-    runWithRequestTiming(requestTiming: import("./http-server/client/request-timing.js").default | undefined, callback: () => Promise<unknown>): Promise<unknown>;
+    runWithRequestTiming(requestTiming: import("./http-server/client/request-timing.js").default | undefined, callback: () => Promise<ReturnType<typeof JSON.parse>>): Promise<ReturnType<typeof JSON.parse>>;
     /**
      * Runs run with timezone.
      * @param {string} timeZone - IANA timezone identifier.
-     * @param {() => Promise<?>} callback - Callback.
-     * @returns {Promise<?>} - Callback result.
+     * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+     * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
      */
-    runWithTimezone(timeZone: string, callback: () => Promise<unknown>): Promise<unknown>;
+    runWithTimezone(timeZone: string, callback: () => Promise<ReturnType<typeof JSON.parse>>): Promise<ReturnType<typeof JSON.parse>>;
     /**
      * Runs get current ability.
      * @returns {import("./authorization/ability.js").default | undefined} - Current ability from context.
@@ -1260,34 +1272,34 @@ export default class VelociousConfiguration {
     getCurrentRequestTiming(): import("./http-server/client/request-timing.js").default | undefined;
     /**
      * Runs get current tenant.
-     * @returns {?} - Current tenant from context.
+     * @returns {ReturnType<typeof JSON.parse>} - Current tenant from context.
      */
-    getCurrentTenant(): unknown;
+    getCurrentTenant(): ReturnType<typeof JSON.parse>;
     /**
      * Runs run with tenant.
-     * @param {?} tenant - Tenant.
-     * @param {() => Promise<?>} callback - Callback.
-     * @returns {Promise<?>} - Callback result.
+     * @param {ReturnType<typeof JSON.parse>} tenant - Tenant.
+     * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+     * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
      */
-    runWithTenant(tenant: unknown, callback: () => Promise<unknown>): Promise<unknown>;
+    runWithTenant(tenant: ReturnType<typeof JSON.parse>, callback: () => Promise<ReturnType<typeof JSON.parse>>): Promise<ReturnType<typeof JSON.parse>>;
     /**
      * Runs resolve tenant.
      * @param {object} args - Tenant resolver args.
-     * @param {Record<string, ?>} args.params - Request params.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} args.params - Request params.
      * @param {import("./http-server/client/request.js").default | import("./http-server/client/websocket-request.js").default | undefined} args.request - Request object.
      * @param {import("./http-server/client/response.js").default | undefined} args.response - Response object.
-     * @param {{channel: string, params?: Record<string, ?>}} [args.subscription] - Subscription metadata.
-     * @returns {Promise<?>} - Resolved tenant.
+     * @param {{channel: string, params?: Record<string, ReturnType<typeof JSON.parse>>}} [args.subscription] - Subscription metadata.
+     * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolved tenant.
      */
     resolveTenant({ params, request, response, subscription }: {
-        params: Record<string, unknown>;
+        params: Record<string, ReturnType<typeof JSON.parse>>;
         request: import("./http-server/client/request.js").default | import("./http-server/client/websocket-request.js").default | undefined;
         response: import("./http-server/client/response.js").default | undefined;
         subscription?: {
             channel: string;
-            params?: Record<string, unknown>;
-        } | undefined;
-    }): Promise<unknown>;
+            params?: Record<string, ReturnType<typeof JSON.parse>>;
+        };
+    }): Promise<ReturnType<typeof JSON.parse>>;
     /**
      * Runs get error events.
      * @returns {import("eventemitter3").EventEmitter} - Framework error events emitter.
@@ -1328,6 +1340,21 @@ export default class VelociousConfiguration {
         databaseIdentifier: string;
         name?: string;
     }, callback: (operation: DatabaseOperation) => Promise<T>): Promise<T>;
+    /**
+     * Runs explicit model work on one connection selected from a captured physical
+     * database configuration. No ambient tenant value is read during checkout or
+     * execution.
+     * @template T
+     * @param {{databaseConfiguration: import("./configuration-types.js").DatabaseConfigurationType, databaseIdentifier: string, name?: string, tenant?: object}} options - Captured operation options.
+     * @param {(operation: DatabaseOperation) => Promise<T>} callback - Operation callback.
+     * @returns {Promise<T>} - Callback result.
+     */
+    withDatabaseOperation<T>({ databaseConfiguration, databaseIdentifier, name, tenant, ...restArgs }: {
+        databaseConfiguration: import("./configuration-types.js").DatabaseConfigurationType;
+        databaseIdentifier: string;
+        name?: string;
+        tenant?: object;
+    }, callback: (operation: DatabaseOperation) => Promise<T>): Promise<T>;
     /**
      * Runs callback with database connections for the requested identifiers.
      * @template T
@@ -1367,10 +1394,10 @@ export default class VelociousConfiguration {
     runWithTestSharedConnectionContexts<T>(callback: () => T): T;
     /**
      * Runs is missing current connection error.
-     * @param {?} error - Error thrown while looking up the current connection.
+     * @param {ReturnType<typeof JSON.parse>} error - Error thrown while looking up the current connection.
      * @returns {boolean} - Whether the error means no current connection is available.
      */
-    isMissingCurrentConnectionError(error: unknown): boolean;
+    isMissingCurrentConnectionError(error: ReturnType<typeof JSON.parse>): boolean;
     /**
      * Runs ensure connections.
      * @template T
@@ -1426,25 +1453,4 @@ export default class VelociousConfiguration {
      */
     _apiManifestEnabled(): boolean;
 }
-/**
- * WithConnectionsCallbackType type.
- */
-export type WithConnectionsCallbackType<T> = (arg0: Record<string, import("./database/drivers/base.js").default>) => Promise<T>;
-/**
- * WithConnectionsOptionsType type.
- */
-export type WithConnectionsOptionsType = {
-    /**
-     * - Database identifiers to include in the connection scope.
-     */
-    databaseIdentifiers?: string[] | undefined;
-    /**
-     * - Human-readable name for the checked-out database connections.
-     */
-    name?: string | undefined;
-};
-import { CurrentConfigurationNotSetError } from "./current-configuration.js";
-import VelociousPackage from "./packages/velocious-package.js";
-import VelociousWebsocketChannelSubscribers from "./http-server/websocket-channel-subscribers.js";
-import DatabaseOperation from "./database/operation.js";
 //# sourceMappingURL=configuration.d.ts.map