velocious 1.0.428 → 1.0.429

package/build/src/frontend-model-controller.d.ts

@@ -1,35 +1,46 @@
 /** Controller with built-in frontend model resource actions. */
 export default class FrontendModelController extends Controller {
-    /** @type {Record<string, any> | undefined} */
-    _frontendModelParams: Record<string, any> | undefined;
-    /** @type {Record<string, any> | undefined} */
-    _frontendModelParamsOverride: Record<string, any> | undefined;
-    /** @type {import("./authorization/ability.js").default | undefined} */
+    /**
+     * Frontend model params.
+      @type {Record<string, ?> | undefined} */
+    _frontendModelParams: Record<string, unknown> | undefined;
+    /**
+     * Frontend model params override.
+      @type {Record<string, ?> | undefined} */
+    _frontendModelParamsOverride: Record<string, unknown> | undefined;
+    /**
+     * Frontend model ability override.
+      @type {import("./authorization/ability.js").default | undefined} */
     _frontendModelAbilityOverride: import("./authorization/ability.js").default | undefined;
     /**
-     * @returns {Record<string, any>} - Decoded request params.
+     * Runs frontend model params.
+     * @returns {Record<string, ?>} - Decoded request params.
      */
-    frontendModelParams(): Record<string, any>;
+    frontendModelParams(): Record<string, unknown>;
     /**
+     * Runs with frontend model params.
      * @template T
-     * @param {Record<string, any>} params - Temporary frontend model params.
+     * @param {Record<string, ?>} params - Temporary frontend model params.
      * @param {() => Promise<T>} callback - Callback executed with temporary params.
      * @returns {Promise<T>} - Callback return value.
      */
-    withFrontendModelParams<T>(params: Record<string, any>, callback: () => Promise<T>): Promise<T>;
+    withFrontendModelParams<T>(params: Record<string, unknown>, callback: () => Promise<T>): Promise<T>;
     /**
+     * Runs with frontend model request context.
      * @template T
-     * @param {Record<string, any>} params - Request-scoped params.
+     * @param {Record<string, ?>} params - Request-scoped params.
      * @param {import("./http-server/client/response.js").default} response - Response instance.
      * @param {() => Promise<T>} callback - Callback executed inside resolved tenant and ability context.
      * @returns {Promise<T>} - Callback return value.
      */
-    withFrontendModelRequestContext<T>(params: Record<string, any>, response: import("./http-server/client/response.js").default, callback: () => Promise<T>): Promise<T>;
+    withFrontendModelRequestContext<T>(params: Record<string, unknown>, response: import("./http-server/client/response.js").default, callback: () => Promise<T>): Promise<T>;
     /**
+     * Runs frontend model class.
      * @returns {typeof import("./database/record/index.js").default} - Frontend model class for controller resource actions.
      */
     frontendModelClass(): typeof import("./database/record/index.js").default;
     /**
+     * Runs frontend model resource configuration.
      * @returns {{backendProject: import("./configuration-types.js").BackendProjectConfiguration, modelName: string, resourceClass: import("./configuration-types.js").FrontendModelResourceClassType, resourceConfiguration: import("./configuration-types.js").NormalizedFrontendModelResourceConfiguration} | null} - Frontend model resource configuration for current controller.
      */
     frontendModelResourceConfiguration(): {
@@ -39,6 +50,7 @@ export default class FrontendModelController extends Controller {
         resourceConfiguration: import("./configuration-types.js").NormalizedFrontendModelResourceConfiguration;
     } | null;
     /**
+     * Runs frontend model resource configuration for backend project model name.
      * @param {object} args - Arguments.
      * @param {import("./configuration-types.js").BackendProjectConfiguration} args.backendProject - Backend project configuration.
      * @param {string} args.modelName - Model name.
@@ -54,6 +66,7 @@ export default class FrontendModelController extends Controller {
         resourceConfiguration: import("./configuration-types.js").NormalizedFrontendModelResourceConfiguration;
     } | null;
     /**
+     * Runs frontend model resource configuration for model class.
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class.
      * @returns {{backendProject: import("./configuration-types.js").BackendProjectConfiguration, modelName: string, resourceClass: import("./configuration-types.js").FrontendModelResourceClassType, resourceConfiguration: import("./configuration-types.js").NormalizedFrontendModelResourceConfiguration} | null} - Frontend model resource configuration for model class.
      */
@@ -64,6 +77,7 @@ export default class FrontendModelController extends Controller {
         resourceConfiguration: import("./configuration-types.js").NormalizedFrontendModelResourceConfiguration;
     } | null;
     /**
+     * Runs frontend model resource model class.
      * @param {{modelName: string, resourceClass: import("./configuration-types.js").FrontendModelResourceClassType}} frontendModelResource - Frontend model resource configuration.
      * @returns {typeof import("./database/record/index.js").default | null} - Backing record class, when available.
      */
@@ -72,6 +86,7 @@ export default class FrontendModelController extends Controller {
         resourceClass: import("./configuration-types.js").FrontendModelResourceClassType;
     }): typeof import("./database/record/index.js").default | null;
     /**
+     * Runs frontend model class from configuration.
      * @returns {typeof import("./database/record/index.js").default | null} - Frontend model class resolved from backend project configuration.
      */
     frontendModelClassFromConfiguration(): typeof import("./database/record/index.js").default | null;
@@ -82,11 +97,13 @@ export default class FrontendModelController extends Controller {
      */
     ensureFrontendModelClassInitialized(): Promise<void>;
     /**
+     * Runs ensure frontend model record class initialized.
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class to initialize.
      * @returns {Promise<void>} - Resolves when the model class is ready.
      */
     ensureFrontendModelRecordClassInitialized(modelClass: typeof import("./database/record/index.js").default): Promise<void>;
     /**
+     * Runs ensure frontend model preload classes initialized.
      * @param {object} args - Arguments.
      * @param {import("./configuration-types.js").BackendProjectConfiguration} args.backendProject - Backend project configuration.
      * @param {typeof import("./database/record/index.js").default} args.modelClass - Model class whose preload tree is being resolved.
@@ -99,6 +116,7 @@ export default class FrontendModelController extends Controller {
         preload: import("./database/query/index.js").NestedPreloadRecord | null;
     }): Promise<void>;
     /**
+     * Runs ensure frontend model relationship target class initialized.
      * @param {object} args - Arguments.
      * @param {import("./configuration-types.js").BackendProjectConfiguration} args.backendProject - Backend project configuration.
      * @param {import("./database/record/relationships/base.js").default} args.relationship - Relationship definition.
@@ -109,6 +127,7 @@ export default class FrontendModelController extends Controller {
         relationship: import("./database/record/relationships/base.js").default;
     }): Promise<typeof import("./database/record/index.js").default | null>;
     /**
+     * Runs frontend model relationship target model class.
      * @param {object} args - Arguments.
      * @param {import("./configuration-types.js").BackendProjectConfiguration} args.backendProject - Backend project configuration.
      * @param {import("./database/record/relationships/base.js").default} args.relationship - Relationship definition.
@@ -119,12 +138,14 @@ export default class FrontendModelController extends Controller {
         relationship: import("./database/record/relationships/base.js").default;
     }): typeof import("./database/record/index.js").default | null;
     /**
+     * Runs frontend model resource path.
      * @param {string} modelName - Model class name.
-     * @param {unknown} resourceDefinition - Resource definition.
+     * @param {?} resourceDefinition - Resource definition.
      * @returns {string} - Normalized resource path.
      */
     frontendModelResourcePath(modelName: string, resourceDefinition: unknown): string;
     /**
+     * Runs frontend model resource matches controller.
      * @param {object} args - Arguments.
      * @param {string} args.controllerName - Controller name from params.
      * @param {string} args.resourcePath - Resource path from configuration.
@@ -135,29 +156,35 @@ export default class FrontendModelController extends Controller {
         resourcePath: string;
     }): boolean;
     /**
+     * Runs frontend model resource instance.
      * @returns {FrontendModelBaseResource} - Backend resource instance for current frontend-model action.
      */
     frontendModelResourceInstance(): FrontendModelBaseResource;
     /**
+     * Runs frontend model primary key.
      * @returns {string} - Frontend model primary key.
      */
     frontendModelPrimaryKey(): string;
     /**
+     * Runs frontend model ability action.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"} action - Frontend action.
      * @returns {string} - Ability action configured for the frontend action.
      */
     frontendModelAbilityAction(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): string;
     /**
+     * Runs frontend model authorized query.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"} action - Frontend action.
-     * @returns {import("./database/query/model-class-query.js").default<any>} - Authorized query for the action.
+     * @returns {import("./database/query/model-class-query.js").default<?>} - Authorized query for the action.
      */
-    frontendModelAuthorizedQuery(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): import("./database/query/model-class-query.js").default<any>;
+    frontendModelAuthorizedQuery(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): import("./database/query/model-class-query.js").default<unknown>;
     /**
+     * Runs frontend model primary key value.
      * @param {import("./database/record/index.js").default} model - Model instance.
      * @returns {string} - Primary key value as string.
      */
     frontendModelPrimaryKeyValue(model: import("./database/record/index.js").default): string;
     /**
+     * Runs frontend model filter authorized models.
      * @param {object} args - Arguments.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"} args.action - Frontend action.
      * @param {import("./database/record/index.js").default[]} args.models - Candidate models.
@@ -168,64 +195,98 @@ export default class FrontendModelController extends Controller {
         models: import("./database/record/index.js").default[];
     }): Promise<import("./database/record/index.js").default[]>;
     /**
+     * Runs run frontend model before action.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"} action - Frontend action.
      * @returns {Promise<boolean>} - Whether action should continue.
      */
     runFrontendModelBeforeAction(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): Promise<boolean>;
     /**
+     * Runs frontend model find record.
      * @param {"find" | "update" | "destroy" | "attach" | "download" | "url"} action - Frontend action.
      * @param {string | number} id - Record id.
      * @returns {Promise<import("./database/record/index.js").default | null>} - Located model record.
      */
     frontendModelFindRecord(action: "find" | "update" | "destroy" | "attach" | "download" | "url", id: string | number): Promise<import("./database/record/index.js").default | null>;
     /**
-     * @param {Record<string, any>} attributes - Create attributes.
-     * @param {Record<string, any> | null} [nestedAttributes] - Optional nested-attribute payload for cascading writes.
+     * Runs frontend model create record.
+     * @param {Record<string, ?>} attributes - Create attributes.
+     * @param {Record<string, ?> | null} [nestedAttributes] - Optional nested-attribute payload for cascading writes.
      * @returns {Promise<import("./database/record/index.js").default | null>} - Created model when authorized.
      */
-    frontendModelCreateRecord(attributes: Record<string, any>, nestedAttributes?: Record<string, any> | null): Promise<import("./database/record/index.js").default | null>;
+    frontendModelCreateRecord(attributes: Record<string, unknown>, nestedAttributes?: Record<string, unknown> | null): Promise<import("./database/record/index.js").default | null>;
     /**
+     * Runs frontend model records.
      * @returns {Promise<import("./database/record/index.js").default[]>} - Frontend model records.
      */
     frontendModelRecords(): Promise<import("./database/record/index.js").default[]>;
     /**
+     * Runs frontend model preload.
      * @returns {import("./database/query/index.js").NestedPreloadRecord | null} - Frontend preload data.
      */
     frontendModelPreload(): import("./database/query/index.js").NestedPreloadRecord | null;
     /**
+     * Runs frontend model select.
      * @returns {Record<string, string[]> | null} - Frontend select data.
      */
     frontendModelSelect(): Record<string, string[]> | null;
     /**
+     * Runs frontend model selects extra.
      * @returns {Record<string, string[]> | null} - Frontend extra-select data (defaults plus these), keyed by model name.
      */
     frontendModelSelectsExtra(): Record<string, string[]> | null;
     /**
+     * Runs frontend model searches.
      * @returns {FrontendModelSearch[]} - Frontend search filters.
      */
     frontendModelSearches(): FrontendModelSearch[];
     /**
-     * @returns {Record<string, any> | null} - Frontend where filters.
+     * Runs frontend model where.
+     * @returns {Record<string, ?> | null} - Frontend where filters.
+     */
+    frontendModelWhere(): Record<string, unknown> | null;
+    /**
+     * Runs frontend model ransack.
+     * @returns {Record<string, ?> | null} - Frontend Ransack filters.
+     */
+    frontendModelRansack(): Record<string, unknown> | null;
+    /**
+     * Runs frontend model joins.
+     * @returns {Record<string, ?> | null} - Frontend joins descriptors.
+     */
+    frontendModelJoins(): Record<string, unknown> | null;
+    /**
+     * Runs frontend model sort.
+     * @returns {FrontendModelSort[]} - Frontend sort definitions.
      */
-    frontendModelWhere(): Record<string, any> | null;
-    /** @returns {Record<string, any> | null} - Frontend Ransack filters. */
-    frontendModelRansack(): Record<string, any> | null;
-    /** @returns {Record<string, any> | null} - Frontend joins descriptors. */
-    frontendModelJoins(): Record<string, any> | null;
-    /** @returns {FrontendModelSort[]} - Frontend sort definitions. */
     frontendModelSort(): FrontendModelSort[];
-    /** @returns {FrontendModelGroup[]} - Frontend group definitions. */
+    /**
+     * Runs frontend model group.
+     * @returns {FrontendModelGroup[]} - Frontend group definitions.
+     */
     frontendModelGroup(): FrontendModelGroup[];
-    /** @returns {FrontendModelPagination} - Frontend pagination params. */
+    /**
+     * Runs frontend model pagination.
+     * @returns {FrontendModelPagination} - Frontend pagination params.
+     */
     frontendModelPagination(): FrontendModelPagination;
-    /** @returns {boolean | null} - Frontend distinct flag when provided. */
+    /**
+     * Runs frontend model distinct.
+     * @returns {boolean | null} - Frontend distinct flag when provided.
+     */
     frontendModelDistinct(): boolean | null;
-    /** @returns {FrontendModelPluck[]} - Frontend pluck definitions. */
+    /**
+     * Runs frontend model pluck.
+     * @returns {FrontendModelPluck[]} - Frontend pluck definitions.
+     */
     frontendModelPluck(): FrontendModelPluck[];
-    /** @returns {boolean} - Whether the request asks for an aggregate count. */
+    /**
+     * Runs frontend model count requested.
+     * @returns {boolean} - Whether the request asks for an aggregate count.
+     */
     frontendModelCountRequested(): boolean;
     /**
-     * @returns {Array<{attributeName: string, relationshipName: string, where?: Record<string, unknown>}>}
+     * Runs frontend model with count.
+     * @returns {Array<{attributeName: string, relationshipName: string, where?: Record<string, ?>}>}
      *   Frontend withCount entries. Empty array when not requested.
      */
     frontendModelWithCount(): Array<{
@@ -240,7 +301,6 @@ export default class FrontendModelController extends Controller {
      * resource matches — the spec entry is then silently ignored so a
      * caller requesting abilities for a model they cannot resolve does
      * not crash the request.
-     *
      * @param {string} modelName
      * @returns {typeof import("./database/record/index.js").default | null}
      */
@@ -251,7 +311,6 @@ export default class FrontendModelController extends Controller {
      * preloaded relationships at any depth. Used to evaluate per-record
      * abilities against nested preloaded children with a single batched
      * query per (modelClass, action) pair.
-     *
      * @param {import("./database/record/index.js").default[]} rootModels
      * @param {string} modelName
      * @returns {import("./database/record/index.js").default[]}
@@ -264,7 +323,6 @@ export default class FrontendModelController extends Controller {
      * `_setComputedAbility`. Runs one batched `authorized query + pluck`
      * per (modelClass, action) pair, regardless of how many records
      * were loaded.
-     *
      * @param {import("./database/record/index.js").default[]} rootModels
      * @returns {Promise<void>}
      */
@@ -275,7 +333,6 @@ export default class FrontendModelController extends Controller {
      * Unknown entries are silently skipped — downstream code resolves
      * model names to classes when applying the check, so unresolved
      * names naturally become no-ops.
-     *
      * @returns {Array<{modelName: string, actions: string[]}>}
      */
     frontendModelAbilities(): Array<{
@@ -291,11 +348,11 @@ export default class FrontendModelController extends Controller {
      *
      * Returns the raw nested-record spec (shape validated by the
      * normalizer inside `Query.queryData`) or `null` when not requested.
-     *
      * @returns {import("./database/query/query-data.js").QueryDataSpec | null}
      */
     frontendModelQueryData(): import("./database/query/query-data.js").QueryDataSpec | null;
     /**
+     * Runs frontend model index query.
      * @returns {import("./database/query/model-class-query.js").default} - Frontend index query with normalized params applied.
      */
     frontendModelIndexQuery(): import("./database/query/model-class-query.js").default;
@@ -310,16 +367,18 @@ export default class FrontendModelController extends Controller {
         query: import("./database/query/model-class-query.js").default;
     }): import("./database/query/model-class-query.js").default;
     /**
+     * Runs frontend model pluck values.
      * @param {object} args - Pluck args.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
      * @param {FrontendModelPluck[]} args.pluck - Pluck descriptors.
-     * @returns {Promise<any[]>} - Plucked values.
+     * @returns {Promise<Array<?>>} - Plucked values.
      */
     frontendModelPluckValues({ query, pluck }: {
         query: import("./database/query/model-class-query.js").default;
         pluck: FrontendModelPluck[];
-    }): Promise<any[]>;
+    }): Promise<Array<unknown>>;
     /**
+     * Runs frontend model search target model class.
      * @param {object} args - Search args.
      * @param {typeof import("./database/record/index.js").default} args.modelClass - Root model class.
      * @param {string[]} args.path - Relationship path.
@@ -330,6 +389,7 @@ export default class FrontendModelController extends Controller {
         path: string[];
     }): typeof import("./database/record/index.js").default;
     /**
+     * Runs apply frontend model search.
      * @param {object} args - Search args.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
      * @param {FrontendModelSearch} args.search - Search filter.
@@ -340,6 +400,24 @@ export default class FrontendModelController extends Controller {
         search: FrontendModelSearch;
     }): void;
     /**
+     * Apply array-valued equality search filters.
+     * @param {object} args - Search arguments.
+     * @param {string} args.columnSql - SQL for the searched column.
+     * @param {string} args.emptySql - SQL predicate used when the array is empty.
+     * @param {"IN" | "NOT IN"} args.operatorSql - SQL array operator.
+     * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
+     * @param {FrontendModelSearch} args.search - Search descriptor.
+     * @returns {boolean} - Whether an array predicate was applied.
+     */
+    applyFrontendModelArraySearch({ columnSql, emptySql, operatorSql, query, search }: {
+        columnSql: string;
+        emptySql: string;
+        operatorSql: "IN" | "NOT IN";
+        query: import("./database/query/model-class-query.js").default;
+        search: FrontendModelSearch;
+    }): boolean;
+    /**
+     * Runs apply frontend model pagination.
      * @param {object} args - Pagination args.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
      * @param {FrontendModelPagination} args.pagination - Pagination values.
@@ -350,28 +428,31 @@ export default class FrontendModelController extends Controller {
         pagination: FrontendModelPagination;
     }): void;
     /**
+     * Runs apply frontend model where.
      * @param {object} args - Where args.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
-     * @param {Record<string, any>} args.where - Root-model where conditions.
+     * @param {Record<string, ?>} args.where - Root-model where conditions.
      * @returns {void}
      */
     applyFrontendModelWhere({ query, where }: {
         query: import("./database/query/model-class-query.js").default;
-        where: Record<string, any>;
+        where: Record<string, unknown>;
     }): void;
     /**
+     * Runs apply frontend model joins.
      * @param {object} args - Joins args.
-     * @param {Record<string, any>} args.joins - Relationship-object joins.
+     * @param {Record<string, ?>} args.joins - Relationship-object joins.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
      * @returns {void}
      */
     applyFrontendModelJoins({ joins, query }: {
-        joins: Record<string, any>;
+        joins: Record<string, unknown>;
         query: import("./database/query/model-class-query.js").default;
     }): void;
     /**
+     * Runs apply frontend model joins for path.
      * @param {object} args - Joins args.
-     * @param {Record<string, any>} args.joins - Joins for current path.
+     * @param {Record<string, ?>} args.joins - Joins for current path.
      * @param {Set<string>} args.joinPathKeys - Joined path keys.
      * @param {typeof import("./database/record/index.js").default} args.modelClass - Model class for current path.
      * @param {string[]} args.path - Relationship path.
@@ -379,7 +460,7 @@ export default class FrontendModelController extends Controller {
      * @returns {void}
      */
     applyFrontendModelJoinsForPath({ joins, joinPathKeys, modelClass, path, query }: {
-        joins: Record<string, any>;
+        joins: Record<string, unknown>;
         joinPathKeys: Set<string>;
         modelClass: typeof import("./database/record/index.js").default;
         path: string[];
@@ -389,32 +470,33 @@ export default class FrontendModelController extends Controller {
      * Resolves a key that may be either a camelCase attribute name or a raw DB
      * column name to its canonical column name.  Returns `undefined` when the
      * key matches neither map.
-     *
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class.
      * @param {string} key - Attribute name or column name to resolve.
      * @returns {string | undefined} - Resolved DB column name, or `undefined`.
      */
     resolveFrontendModelColumnName(modelClass: typeof import("./database/record/index.js").default, key: string): string | undefined;
     /**
+     * Runs apply frontend model where for path.
      * @param {object} args - Where args.
      * @param {typeof import("./database/record/index.js").default} args.modelClass - Model class for current where scope.
      * @param {string[]} args.path - Relationship path from root.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
-     * @param {Record<string, any>} args.where - Where conditions for current scope.
+     * @param {Record<string, ?>} args.where - Where conditions for current scope.
      * @returns {void}
      */
     applyFrontendModelWhereForPath({ modelClass, path, query, where }: {
         modelClass: typeof import("./database/record/index.js").default;
         path: string[];
         query: import("./database/query/model-class-query.js").default;
-        where: Record<string, any>;
+        where: Record<string, unknown>;
     }): void;
     /**
+     * Runs normalize frontend model where column value.
      * @param {object} args - Args.
      * @param {typeof import("./database/record/index.js").default} args.modelClass - Model class.
      * @param {string} args.columnName - Column name.
-     * @param {unknown} args.value - Where value.
-     * @returns {unknown | symbol} - SQL-safe where value.
+     * @param {?} args.value - Where value.
+     * @returns {? | symbol} - SQL-safe where value.
      */
     normalizeFrontendModelWhereColumnValue({ columnName, modelClass, value }: {
         modelClass: typeof import("./database/record/index.js").default;
@@ -422,6 +504,7 @@ export default class FrontendModelController extends Controller {
         value: unknown;
     }): unknown | symbol;
     /**
+     * Runs apply frontend model group.
      * @param {object} args - Group args.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
      * @param {FrontendModelGroup} args.group - Group definition.
@@ -452,14 +535,16 @@ export default class FrontendModelController extends Controller {
         query: import("./database/query/model-class-query.js").default;
     }): void;
     /**
+     * Runs apply frontend model translated attribute preloads.
      * @param {object} args - Args.
-     * @param {import("./database/query/model-class-query.js").default<any>} args.query - Query instance.
-     * @returns {import("./database/query/model-class-query.js").default<any>} - Query with translations preloaded if needed.
+     * @param {import("./database/query/model-class-query.js").default<?>} args.query - Query instance.
+     * @returns {import("./database/query/model-class-query.js").default<?>} - Query with translations preloaded if needed.
      */
     applyFrontendModelTranslatedAttributePreloads({ query }: {
-        query: import("./database/query/model-class-query.js").default<any>;
-    }): import("./database/query/model-class-query.js").default<any>;
+        query: import("./database/query/model-class-query.js").default<unknown>;
+    }): import("./database/query/model-class-query.js").default<unknown>;
     /**
+     * Runs apply frontend model sort.
      * @param {object} args - Sort args.
      * @param {import("./database/query/model-class-query.js").default} args.query - Query instance.
      * @param {FrontendModelSort} args.sort - Sort definition.
@@ -492,11 +577,13 @@ export default class FrontendModelController extends Controller {
         query: import("./database/query/model-class-query.js").default;
     }): void;
     /**
+     * Runs frontend model selected attributes for model class.
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class.
      * @returns {string[] | null} - Selected attributes for model class.
      */
     frontendModelSelectedAttributesForModelClass(modelClass: typeof import("./database/record/index.js").default): string[] | null;
     /**
+     * Runs frontend model selects extra for model class.
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class.
      * @returns {string[] | null} - Extra attributes (loaded in addition to the defaults) for the model class.
      */
@@ -511,26 +598,31 @@ export default class FrontendModelController extends Controller {
      */
     frontendModelEffectiveSelectedAttributesForModelClass(modelClass: typeof import("./database/record/index.js").default, fallbackAttributeNames: string[]): string[] | null;
     /**
+     * Runs frontend model default attributes for model class.
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class.
      * @returns {string[] | null} - Default frontend-model attributes declared on the resource.
      */
     frontendModelDefaultAttributesForModelClass(modelClass: typeof import("./database/record/index.js").default): string[] | null;
     /**
+     * Runs frontend model non default attributes for model class.
      * @param {typeof import("./database/record/index.js").default} modelClass - Model class.
      * @returns {string[]} - Attribute names explicitly marked selectedByDefault: false.
      */
     frontendModelNonDefaultAttributesForModelClass(modelClass: typeof import("./database/record/index.js").default): string[];
     /**
+     * Runs serialize frontend model attributes.
      * @param {import("./database/record/index.js").default} model - Model instance.
-     * @returns {Promise<Record<string, any>>} - Serialized attributes filtered by select map.
+     * @returns {Promise<Record<string, ?>>} - Serialized attributes filtered by select map.
      */
-    serializeFrontendModelAttributes(model: import("./database/record/index.js").default): Promise<Record<string, any>>;
+    serializeFrontendModelAttributes(model: import("./database/record/index.js").default): Promise<Record<string, unknown>>;
     /**
+     * Runs serialization resource instance for model.
      * @param {import("./database/record/index.js").default} model - Model instance.
      * @returns {import("./frontend-model-resource/base-resource.js").default | null} - Resource instance or null.
      */
     _serializationResourceInstanceForModel(model: import("./database/record/index.js").default): import("./frontend-model-resource/base-resource.js").default | null;
     /**
+     * Runs frontend model filter serializable related models.
      * @param {object} args - Arguments.
      * @param {import("./database/record/index.js").default[]} args.models - Frontend model records.
      * @param {boolean} args.relationshipIsCollection - Whether relation is has-many.
@@ -541,43 +633,51 @@ export default class FrontendModelController extends Controller {
         relationshipIsCollection: boolean;
     }): Promise<import("./database/record/index.js").default[]>;
     /**
-     * @param {unknown} value - Candidate preloaded value.
+     * Runs is serializable frontend model.
+     * @param {?} value - Candidate preloaded value.
      * @returns {value is import("./database/record/index.js").default} - Whether value behaves like a model.
      */
     isSerializableFrontendModel(value: unknown): value is import("./database/record/index.js").default;
     /**
+     * Runs serialize frontend models.
      * @param {import("./database/record/index.js").default[]} models - Models to serialize.
-     * @returns {Promise<Record<string, any>[]>} - Serialized model payloads.
+     * @returns {Promise<Record<string, ?>[]>} - Serialized model payloads.
      */
-    serializeFrontendModels(models: import("./database/record/index.js").default[]): Promise<Record<string, any>[]>;
+    serializeFrontendModels(models: import("./database/record/index.js").default[]): Promise<Record<string, unknown>[]>;
     /**
+     * Runs serialize frontend model.
      * @param {import("./database/record/index.js").default} model - Frontend model record.
-     * @returns {Promise<Record<string, any>>} - Serialized frontend model payload.
+     * @returns {Promise<Record<string, ?>>} - Serialized frontend model payload.
      */
-    serializeFrontendModel(model: import("./database/record/index.js").default): Promise<Record<string, any>>;
+    serializeFrontendModel(model: import("./database/record/index.js").default): Promise<Record<string, unknown>>;
     /**
+     * Runs frontend model render error.
      * @param {string} errorMessage - Error message.
      * @returns {Promise<void>} - Resolves when error has been rendered.
      */
     frontendModelRenderError(errorMessage: string): Promise<void>;
     /**
+     * Runs frontend model error payload.
      * @param {string} errorMessage - Error message.
-     * @returns {Record<string, any>} - Error payload.
+     * @returns {Record<string, ?>} - Error payload.
      */
-    frontendModelErrorPayload(errorMessage: string): Record<string, any>;
+    frontendModelErrorPayload(errorMessage: string): Record<string, unknown>;
     /**
-     * @returns {Record<string, any>} - Client-safe error payload.
+     * Runs frontend model client safe error payload.
+     * @returns {Record<string, ?>} - Client-safe error payload.
      */
-    frontendModelClientSafeErrorPayload(): Record<string, any>;
+    frontendModelClientSafeErrorPayload(): Record<string, unknown>;
     /**
-     * @param {unknown} error - Caught error.
-     * @returns {Record<string, any>} - Client payload for the current environment.
+     * Runs frontend model client error payload for error.
+     * @param {?} error - Caught error.
+     * @returns {Record<string, ?>} - Client payload for the current environment.
      */
-    frontendModelClientErrorPayloadForError(error: unknown): Record<string, any>;
+    frontendModelClientErrorPayloadForError(error: unknown): Record<string, unknown>;
     /**
+     * Runs frontend model log endpoint error.
      * @param {object} args - Error log args.
      * @param {string} args.action - Endpoint/action label.
-     * @param {unknown} args.error - Caught error.
+     * @param {?} args.error - Caught error.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url" | "custom-command"} [args.commandType] - Frontend-model command type.
      * @param {string | undefined} [args.model] - Request model name when available.
      * @param {string | undefined} [args.requestId] - Batch request id when available.
@@ -591,48 +691,83 @@ export default class FrontendModelController extends Controller {
         requestId?: string | undefined;
     }): Promise<void>;
     /**
+     * Runs frontend model render command response.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"} action - Frontend action.
      * @returns {Promise<void>} - Resolves when response has been rendered.
      */
     frontendModelRenderCommandResponse(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): Promise<void>;
     /**
+     * Runs frontend model command payload.
      * @param {"index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"} action - Frontend action.
-     * @returns {Promise<Record<string, any> | null>} - Response payload.
+     * @returns {Promise<Record<string, ?> | null>} - Response payload.
+     */
+    frontendModelCommandPayload(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): Promise<Record<string, unknown> | null>;
+    /**
+     * Runs frontend api.
+     * @returns {Promise<void>} - Shared frontend model API action with batch support.
      */
-    frontendModelCommandPayload(action: "index" | "find" | "create" | "update" | "destroy" | "attach" | "download" | "url"): Promise<Record<string, any> | null>;
-    /** @returns {Promise<void>} - Shared frontend model API action with batch support. */
     frontendApi(): Promise<void>;
     /**
      * Dispatches a custom frontend-model command through the shared frontend-model API endpoint.
      * @param {object} args - Arguments.
      * @param {string} args.customPath - Custom backend route path.
-     * @param {unknown} args.payload - Request payload.
-     * @returns {Promise<Record<string, any>>} - Parsed JSON response payload.
+     * @param {?} args.payload - Request payload.
+     * @returns {Promise<Record<string, ?>>} - Parsed JSON response payload.
      */
     frontendApiCustomCommandPayload({ customPath, payload }: {
         customPath: string;
         payload: unknown;
-    }): Promise<Record<string, any>>;
-    /** @returns {Promise<void>} - Collection action for frontend model resources. */
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Runs frontend index.
+     * @returns {Promise<void>} - Collection action for frontend model resources.
+     */
     frontendIndex(): Promise<void>;
-    /** @returns {Promise<void>} - Member find action for frontend model resources. */
+    /**
+     * Runs frontend find.
+     * @returns {Promise<void>} - Member find action for frontend model resources.
+     */
     frontendFind(): Promise<void>;
-    /** @returns {Promise<void>} - Member update action for frontend model resources. */
+    /**
+     * Runs frontend update.
+     * @returns {Promise<void>} - Member update action for frontend model resources.
+     */
     frontendUpdate(): Promise<void>;
-    /** @returns {Promise<void>} - Member attach action for frontend model resources. */
+    /**
+     * Runs frontend attach.
+     * @returns {Promise<void>} - Member attach action for frontend model resources.
+     */
     frontendAttach(): Promise<void>;
-    /** @returns {Promise<void>} - Member download action for frontend model resources. */
+    /**
+     * Runs frontend download.
+     * @returns {Promise<void>} - Member download action for frontend model resources.
+     */
     frontendDownload(): Promise<void>;
-    /** @returns {Promise<void>} - Member URL action for frontend model resources. */
+    /**
+     * Runs frontend url.
+     * @returns {Promise<void>} - Member URL action for frontend model resources.
+     */
     frontendUrl(): Promise<void>;
-    /** @returns {Promise<void>} - Member create action for frontend model resources. */
+    /**
+     * Runs frontend create.
+     * @returns {Promise<void>} - Member create action for frontend model resources.
+     */
     frontendCreate(): Promise<void>;
-    /** @returns {Promise<void>} - Member destroy action for frontend model resources. */
+    /**
+     * Runs frontend destroy.
+     * @returns {Promise<void>} - Member destroy action for frontend model resources.
+     */
     frontendDestroy(): Promise<void>;
-    /** @returns {Promise<void>} - Custom collection/member command action for frontend-model resources. */
+    /**
+     * Runs frontend custom command.
+     * @returns {Promise<void>} - Custom collection/member command action for frontend-model resources.
+     */
     frontendCustomCommand(): Promise<void>;
-    /** @returns {Promise<Record<string, any>>} - Response payload. */
-    frontendModelCustomCommandPayload(): Promise<Record<string, any>>;
+    /**
+     * Runs frontend model custom command payload.
+     * @returns {Promise<Record<string, ?>>} - Response payload.
+     */
+    frontendModelCustomCommandPayload(): Promise<Record<string, unknown>>;
     /**
      * Walks a custom-command response payload and replaces any backend `Record`
      * instance with the resource's per-action serialized form so handlers can
@@ -640,17 +775,19 @@ export default class FrontendModelController extends Controller {
      * `await this.serialize(record, action)`. Plain objects, arrays, and
      * primitive values pass through and are later encoded by
      * `serializeFrontendModelTransportValue`.
-     *
-     * @param {unknown} value - Payload value.
-     * @param {{serialize: (model: unknown, action: string) => Promise<Record<string, any>>}} resource - Resource instance providing `serialize`.
+     * @param {?} value - Payload value.
+     * @param {{serialize: (model: ?, action: string) => Promise<Record<string, ?>>}} resource - Resource instance providing `serialize`.
      * @param {string} action - Custom command method name passed to `resource.serialize` for per-action authorization filtering.
      * @param {WeakSet<object>} [seen] - Recursion stack of plain-object containers currently being walked. Membership is added on entry and removed on exit so a container shared between siblings (i.e. referenced twice but not cyclically) is walked on each reference instead of being short-circuited the second time, which would let backend `Record` instances inside it bypass `resource.serialize`.
-     * @returns {Promise<unknown>} - Payload with backend `Record` instances replaced by serialized markers.
+     * @returns {Promise<?>} - Payload with backend `Record` instances replaced by serialized markers.
      */
     autoSerializeFrontendModelsInPayload(value: unknown, resource: {
-        serialize: (model: unknown, action: string) => Promise<Record<string, any>>;
+        serialize: (model: unknown, action: string) => Promise<Record<string, unknown>>;
     }, action: string, seen?: WeakSet<object>): Promise<unknown>;
 }
+/**
+ * FrontendModelSearch type.
+ */
 export type FrontendModelSearch = {
     /**
      * - Relationship path.
@@ -667,8 +804,11 @@ export type FrontendModelSearch = {
     /**
      * - Search value.
      */
-    value: any;
+    value: unknown;
 };
+/**
+ * FrontendModelSort type.
+ */
 export type FrontendModelSort = {
     /**
      * - Attribute name to sort by.
@@ -683,6 +823,9 @@ export type FrontendModelSort = {
      */
     path: string[];
 };
+/**
+ * FrontendModelGroup type.
+ */
 export type FrontendModelGroup = {
     /**
      * - Attribute name to group by.
@@ -693,6 +836,9 @@ export type FrontendModelGroup = {
      */
     path: string[];
 };
+/**
+ * FrontendModelPluck type.
+ */
 export type FrontendModelPluck = {
     /**
      * - Attribute name to pluck.
@@ -703,6 +849,9 @@ export type FrontendModelPluck = {
      */
     path: string[];
 };
+/**
+ * FrontendModelPagination type.
+ */
 export type FrontendModelPagination = {
     /**
      * - Maximum number of records.