velocious 1.0.577 → 1.0.579

package/build/src/frontend-models/query.d.ts

@@ -1,53 +1,163 @@
-/**
- * Runs the normalizePreload helper.
- * @param {import("../database/query/index.js").NestedPreloadRecord | string | Array<string | import("../database/query/index.js").NestedPreloadRecord> | boolean | undefined | null} preload - Preload shorthand.
- * @returns {import("../database/query/index.js").NestedPreloadRecord} - Normalized preload.
- */
-export function normalizePreload(preload: import("../database/query/index.js").NestedPreloadRecord | string | Array<string | import("../database/query/index.js").NestedPreloadRecord> | boolean | undefined | null): import("../database/query/index.js").NestedPreloadRecord;
-/**
- * Runs the normalizeSearchOperator helper.
- * @param {string} operator - Raw search operator.
- * @returns {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} - Normalized operator.
- */
-export function normalizeSearchOperator(operator: string): "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq";
-/**
- * Runs the normalizeJoins helper.
- * @param {?} joins - Join payload.
- * @returns {Record<string, ?>} - Normalized relationship descriptor joins.
- */
-export function normalizeJoins(joins: unknown): Record<string, unknown>;
-/**
- * Normalize any supported sort payload into flat sort descriptors.
- * @param {?} sort - Sort payload.
- * @returns {FrontendModelSort[]} - Normalized sort definitions.
- */
-export function normalizeSort(sort: unknown): FrontendModelSort[];
-/**
- * Normalize any supported group payload into flat group descriptors.
- * @param {?} group - Group payload.
- * @returns {FrontendModelGroup[]} - Normalized group definitions.
- */
-export function normalizeGroup(group: unknown): FrontendModelGroup[];
-/**
- * Normalize any supported pluck payload into flat pluck descriptors.
- * @param {?} pluck - Pluck payload.
- * @returns {FrontendModelPluck[]} - Normalized pluck definitions.
- */
-export function normalizePluck(pluck: unknown): FrontendModelPluck[];
-/**
- * Runs the frontendModelEventOptionsPayload helper.
- * @param {import("./base.js").FrontendModelClass} modelClass - Frontend model class.
- * @param {FrontendModelEventOptions} [options] - Event query or projection options.
- * @returns {FrontendModelEventOptionsPayload} - Normalized event subscription payload.
- */
-export function frontendModelEventOptionsPayload(modelClass: import("./base.js").FrontendModelClass, options?: FrontendModelEventOptions): FrontendModelEventOptionsPayload;
+export type FrontendModelSearch = {
+    /**
+     * - Attribute name to search.
+     */
+    column: string;
+    /**
+     * - Search operator.
+     */
+    operator: "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq";
+    /**
+     * - Relationship path from root model.
+     */
+    path: string[];
+    /**
+     * - Search value.
+     */
+    value: ReturnType<typeof JSON.parse>;
+};
+export type FrontendModelTransportValue = null | boolean | number | string | object;
+export type FrontendModelAttributeValue = import("./base.js").FrontendModelAttributeValue;
+export type FrontendModelWithCountPayloadEntry = {
+    attributeName: string;
+    relationshipName: string;
+    where?: Record<string, FrontendModelTransportValue>;
+};
+export type FrontendModelAbilitiesPayloadEntry = {
+    modelName: string;
+    actions: string[];
+};
+export type FrontendModelProjectionOptions = {
+    /**
+     * - Model-aware attribute select map or root-model shorthand.
+     */
+    select?: Record<string, string[] | string> | string | string[];
+    /**
+     * - Extra attributes to load in addition to the defaults, keyed by model name or root-model shorthand.
+     */
+    selectsExtra?: Record<string, string[] | string> | string | string[];
+    /**
+     * - Relationship preload tree.
+     */
+    preload?: import("../database/query/index.js").NestedPreloadRecord | string | Array<string | import("../database/query/index.js").NestedPreloadRecord>;
+    /**
+     * - Association count spec.
+     */
+    withCount?: string | string[] | Record<string, boolean | {
+        relationship?: string;
+        where?: Record<string, FrontendModelTransportValue>;
+    }>;
+    /**
+     * - Ability actions to compute per record.
+     */
+    abilities?: string[] | Record<string, string[]>;
+    /**
+     * - Backend query data names/spec.
+     */
+    queryData?: string | Array<string | Record<string, FrontendModelTransportValue>> | Record<string, FrontendModelTransportValue>;
+};
+export type FrontendModelEventOptionsObject = FrontendModelProjectionOptions & {
+    query?: FrontendModelQuery<import("./base.js").FrontendModelClass>;
+};
+export type FrontendModelEventOptions = FrontendModelEventOptionsObject | FrontendModelQuery<import("./base.js").FrontendModelClass>;
+export type FrontendModelProjectionPayload = {
+    /**
+     * - Normalized select map.
+     */
+    select?: Record<string, string[]>;
+    /**
+     * - Normalized extra select map.
+     */
+    selectsExtra?: Record<string, string[]>;
+    /**
+     * - Normalized preload tree.
+     */
+    preload?: import("../database/query/index.js").NestedPreloadRecord;
+    /**
+     * - Normalized count specs.
+     */
+    withCount?: FrontendModelWithCountPayloadEntry[];
+    /**
+     * - Normalized ability specs.
+     */
+    abilities?: FrontendModelAbilitiesPayloadEntry[];
+    /**
+     * - Normalized queryData spec.
+     */
+    queryData?: FrontendModelTransportValue;
+};
+export type FrontendModelEventFilterPayload = {
+    /**
+     * - Relationship joins needed for matching.
+     */
+    joins?: Record<string, FrontendModelTransportValue>;
+    /**
+     * - Search predicates needed for matching.
+     */
+    searches?: FrontendModelSearch[];
+    /**
+     * - Structured where predicates needed for matching.
+     */
+    where?: Record<string, FrontendModelTransportValue>;
+};
+export type FrontendModelEventFilterPayloadEntry = FrontendModelEventFilterPayload & {
+    key: string;
+};
+export type FrontendModelEventOptionsPayload = {
+    /**
+     * - Stable event filter key, or null when no filter is present.
+     */
+    eventFilterKey: string | null;
+    /**
+     * - Normalized event filter payload, or null when unfiltered.
+     */
+    eventFilterPayload: FrontendModelEventFilterPayload | null;
+    /**
+     * - Normalized event serialization projection payload.
+     */
+    projectionPayload: FrontendModelProjectionPayload;
+};
+export type FrontendModelSort = {
+    /**
+     * - Attribute name to sort by.
+     */
+    column: string;
+    /**
+     * - Sort direction.
+     */
+    direction: "asc" | "desc";
+    /**
+     * - Relationship path from root model.
+     */
+    path: string[];
+};
+export type FrontendModelGroup = {
+    /**
+     * - Attribute name to group by.
+     */
+    column: string;
+    /**
+     * - Relationship path from root model.
+     */
+    path: string[];
+};
+export type FrontendModelPluck = {
+    /**
+     * - Attribute name to pluck.
+     */
+    column: string;
+    /**
+     * - Relationship path from root model.
+     */
+    path: string[];
+};
 /**
  * FrontendModelSearch type.
  * @typedef {object} FrontendModelSearch
  * @property {string} column - Attribute name to search.
  * @property {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} operator - Search operator.
  * @property {string[]} path - Relationship path from root model.
- * @property {?} value - Search value.
+ * @property {ReturnType<typeof JSON.parse>} value - Search value.
  */
 /**
  * FrontendModelTransportValue type.
@@ -131,44 +241,54 @@ export function frontendModelEventOptionsPayload(modelClass: import("./base.js")
  * @property {string[]} path - Relationship path from root model.
  */
 /** Error raised when a frontend-model query descriptor is malformed. */
-export class FrontendModelQueryError extends Error {
+export declare class FrontendModelQueryError extends Error {
     /**
      * Creates a frontend-model query error.
      * @param {string} message - Error message.
      */
     constructor(message: string);
 }
+/**
+ * Runs the normalizePreload helper.
+ * @param {import("../database/query/index.js").NestedPreloadRecord | string | Array<string | import("../database/query/index.js").NestedPreloadRecord> | boolean | undefined | null} preload - Preload shorthand.
+ * @returns {import("../database/query/index.js").NestedPreloadRecord} - Normalized preload.
+ */
+export declare function normalizePreload(preload: import("../database/query/index.js").NestedPreloadRecord | string | Array<string | import("../database/query/index.js").NestedPreloadRecord> | boolean | undefined | null): import("../database/query/index.js").NestedPreloadRecord;
+/**
+ * Runs the normalizeSearchOperator helper.
+ * @param {string} operator - Raw search operator.
+ * @returns {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} - Normalized operator.
+ */
+export declare function normalizeSearchOperator(operator: string): "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq";
+/**
+ * Runs the normalizeJoins helper.
+ * @param {ReturnType<typeof JSON.parse>} joins - Join payload.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Normalized relationship descriptor joins.
+ */
+export declare function normalizeJoins(joins: ReturnType<typeof JSON.parse>): Record<string, ReturnType<typeof JSON.parse>>;
+/**
+ * Normalize any supported sort payload into flat sort descriptors.
+ * @param {ReturnType<typeof JSON.parse>} sort - Sort payload.
+ * @returns {FrontendModelSort[]} - Normalized sort definitions.
+ */
+export declare function normalizeSort(sort: ReturnType<typeof JSON.parse>): FrontendModelSort[];
+/**
+ * Normalize any supported group payload into flat group descriptors.
+ * @param {ReturnType<typeof JSON.parse>} group - Group payload.
+ * @returns {FrontendModelGroup[]} - Normalized group definitions.
+ */
+export declare function normalizeGroup(group: ReturnType<typeof JSON.parse>): FrontendModelGroup[];
+/**
+ * Normalize any supported pluck payload into flat pluck descriptors.
+ * @param {ReturnType<typeof JSON.parse>} pluck - Pluck payload.
+ * @returns {FrontendModelPluck[]} - Normalized pluck definitions.
+ */
+export declare function normalizePluck(pluck: ReturnType<typeof JSON.parse>): FrontendModelPluck[];
 /**
  * Query wrapper for frontend model commands.
  * @template {import("./base.js").FrontendModelClass} T
  */
 export default class FrontendModelQuery<T extends import("./base.js").FrontendModelClass> {
-    /**
-     * Runs constructor.
-     * @param {object} args - Constructor args.
-     * @param {T} args.modelClass - Frontend model class.
-     * @param {import("../database/query/index.js").NestedPreloadRecord} [args.preload] - Preload map.
-     */
-    constructor({ modelClass, preload }: {
-        modelClass: T;
-        preload?: import("../database/query/index.js").NestedPreloadRecord | undefined;
-    });
-    /**
-     * Ransack.
-     * @type {Record<string, ?>[]} */
-    _ransack: Record<string, unknown>[];
-    /**
-     * Searches.
-     * @type {FrontendModelSearch[]} */
-    _searches: FrontendModelSearch[];
-    /**
-     * Sort.
-     * @type {FrontendModelSort[]} */
-    _sort: FrontendModelSort[];
-    /**
-     * Group.
-     * @type {FrontendModelGroup[]} */
-    _group: FrontendModelGroup[];
     modelClass: T;
     _preload: import("../database/query/index.js").NestedPreloadRecord;
     _joins: {};
@@ -188,16 +308,16 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
     _perPage: number | null;
     /**
      * Narrows the runtime value to the documented type.
-     * @type {Array<{attributeName: string, relationshipName: string, where?: Record<string, ?>}>} */
+     * @type {Array<{attributeName: string, relationshipName: string, where?: Record<string, ReturnType<typeof JSON.parse>>}>} */
     _withCount: Array<{
         attributeName: string;
         relationshipName: string;
-        where?: Record<string, unknown>;
+        where?: Record<string, ReturnType<typeof JSON.parse>>;
     }>;
     /**
      * Narrows the runtime value to the documented type.
-     * @type {Array<string | Record<string, ?>>} */
-    _queryData: Array<string | Record<string, unknown>>;
+     * @type {Array<string | Record<string, ReturnType<typeof JSON.parse>>>} */
+    _queryData: Array<string | Record<string, ReturnType<typeof JSON.parse>>>;
     /**
      * Per-record ability spec. Normalized to a list of
      * `{modelName, actions}` entries — one entry per model that should
@@ -210,6 +330,32 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
         modelName: string;
         actions: string[];
     }>;
+    /**
+     * Ransack.
+     * @type {Record<string, ReturnType<typeof JSON.parse>>[]} */
+    _ransack: Record<string, ReturnType<typeof JSON.parse>>[];
+    /**
+     * Searches.
+     * @type {FrontendModelSearch[]} */
+    _searches: FrontendModelSearch[];
+    /**
+     * Sort.
+     * @type {FrontendModelSort[]} */
+    _sort: FrontendModelSort[];
+    /**
+     * Group.
+     * @type {FrontendModelGroup[]} */
+    _group: FrontendModelGroup[];
+    /**
+     * Runs constructor.
+     * @param {object} args - Constructor args.
+     * @param {T} args.modelClass - Frontend model class.
+     * @param {import("../database/query/index.js").NestedPreloadRecord} [args.preload] - Preload map.
+     */
+    constructor({ modelClass, preload }: {
+        modelClass: T;
+        preload?: import("../database/query/index.js").NestedPreloadRecord;
+    });
     /**
      * Tell the backend to evaluate one or more ability actions against
      * each returned record (and its preloaded relations, when keyed by
@@ -258,12 +404,12 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
      * counts to each returned record. Parses the same shapes as the
      * backend `ModelClassQuery#withCount`, then ships the normalized
      * entries as part of the `index` command payload.
-     * @param {string | string[] | Record<string, boolean | {relationship?: string, where?: Record<string, ?>}>} spec - Relationships whose counts should be serialized.
+     * @param {string | string[] | Record<string, boolean | {relationship?: string, where?: Record<string, ReturnType<typeof JSON.parse>>}>} spec - Relationships whose counts should be serialized.
      * @returns {this} - This query for chaining.
      */
     withCount(spec: string | string[] | Record<string, boolean | {
         relationship?: string;
-        where?: Record<string, unknown>;
+        where?: Record<string, ReturnType<typeof JSON.parse>>;
     }>): this;
     /**
      * Request one or more backend queryData entries for each returned
@@ -272,16 +418,16 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
      * frontend ships only these names; the SQL fragments stay server-
      * side. All resulting aliases are attached to the root record and
      * read back with `record.queryData(aliasName)`.
-     * @param {string | Array<string | Record<string, ?>> | Record<string, ?>} spec - Backend query-data names and arguments to serialize.
+     * @param {string | Array<string | Record<string, ReturnType<typeof JSON.parse>>> | Record<string, ReturnType<typeof JSON.parse>>} spec - Backend query-data names and arguments to serialize.
      * @returns {this} - This query for chaining.
      */
-    queryData(spec: string | Array<string | Record<string, unknown>> | Record<string, unknown>): this;
+    queryData(spec: string | Array<string | Record<string, ReturnType<typeof JSON.parse>>> | Record<string, ReturnType<typeof JSON.parse>>): this;
     /**
      * Runs where.
-     * @param {Record<string, ?>} conditions - Root-model where conditions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} conditions - Root-model where conditions.
      * @returns {this} - Query with merged where conditions.
      */
-    where(conditions: Record<string, unknown>): this;
+    where(conditions: Record<string, ReturnType<typeof JSON.parse>>): this;
     /**
      * Runs scope.
      * @param {import("../utils/model-scope.js").ModelScopeDescriptor} scopeDescriptor - Scope descriptor.
@@ -290,10 +436,10 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
     scope(scopeDescriptor: import("../utils/model-scope.js").ModelScopeDescriptor): this;
     /**
      * Runs ransack.
-     * @param {Record<string, ?>} params - Ransack-style params hash. Supports `s` key for sorting (e.g., `{s: "name asc"}`).
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} params - Ransack-style params hash. Supports `s` key for sorting (e.g., `{s: "name asc"}`).
      * @returns {this} - Query with Ransack filters and sort applied.
      */
-    ransack(params: Record<string, unknown>): this;
+    ransack(params: Record<string, ReturnType<typeof JSON.parse>>): this;
     /**
      * Runs select with required root attributes.
      * @param {string[]} [requiredAttributes] - Extra required attributes for the root model.
@@ -322,37 +468,37 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
     selectsExtra(select: Record<string, string[] | string> | string | string[]): this;
     /**
      * Runs joins.
-     * @param {Record<string, ?> | Array<Record<string, ?>>} joins - Relationship descriptor joins.
+     * @param {Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>} joins - Relationship descriptor joins.
      * @returns {this} - Query with merged joins.
      */
-    joins(joins: Record<string, unknown> | Array<Record<string, unknown>>): this;
+    joins(joins: Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>): this;
     /**
      * Returns the search result.
      * @param {string[]} path - Relationship path.
      * @param {string} column - Column or attribute name.
      * @param {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | ">" | ">=" | "<" | "<="} operator - Search operator.
-     * @param {?} value - Search value.
+     * @param {ReturnType<typeof JSON.parse>} value - Search value.
      * @returns {this} - Query with appended search.
      */
-    search(path: string[], column: string, operator: "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | ">" | ">=" | "<" | "<=", value: unknown): this;
+    search(path: string[], column: string, operator: "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | ">" | ">=" | "<" | "<=", value: ReturnType<typeof JSON.parse>): this;
     /**
      * Runs sort.
-     * @param {string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, ?> | Array<Record<string, ?>>} sort - Sort definition(s).
+     * @param {string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>} sort - Sort definition(s).
      * @returns {this} - Query with appended sort definitions.
      */
-    sort(sort: string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, unknown> | Array<Record<string, unknown>>): this;
+    sort(sort: string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>): this;
     /**
      * Runs order.
-     * @param {string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, ?> | Array<Record<string, ?>>} order - Order definition(s).
+     * @param {string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>} order - Order definition(s).
      * @returns {this} - Query with appended sort definitions.
      */
-    order(order: string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, unknown> | Array<Record<string, unknown>>): this;
+    order(order: string | string[] | string[][] | [string, string] | Array<[string, string]> | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>): this;
     /**
      * Runs group.
-     * @param {string | string[] | Record<string, ?> | Array<Record<string, ?>>} group - Group definition(s).
+     * @param {string | string[] | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>} group - Group definition(s).
      * @returns {this} - Query with appended group definitions.
      */
-    group(group: string | string[] | Record<string, unknown> | Array<Record<string, unknown>>): this;
+    group(group: string | string[] | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>): this;
     /**
      * Runs distinct.
      * @param {boolean} [value] - Whether to request distinct rows.
@@ -395,75 +541,75 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
     getModelClass(): T;
     /**
      * Runs preload payload.
-     * @returns {Record<string, ?>} - Payload preload hash when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload preload hash when present.
      */
-    preloadPayload(): Record<string, unknown>;
+    preloadPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs with count payload.
-     * @returns {Record<string, ?>} - Payload withCount array when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload withCount array when present.
      */
-    withCountPayload(): Record<string, unknown>;
+    withCountPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs abilities payload.
-     * @returns {Record<string, ?>} - Payload abilities array when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload abilities array when present.
      */
-    abilitiesPayload(): Record<string, unknown>;
+    abilitiesPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs query data payload.
-     * @returns {Record<string, ?>} - Payload queryData spec when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload queryData spec when present.
      */
-    queryDataPayload(): Record<string, unknown>;
+    queryDataPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs select payload.
      * @param {string[]} [requiredAttributes] - Extra required attributes for root model selection.
-     * @returns {Record<string, ?>} - Payload select hash when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload select hash when present.
      */
-    selectPayload(requiredAttributes?: string[]): Record<string, unknown>;
+    selectPayload(requiredAttributes?: string[]): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs selects extra payload.
-     * @returns {Record<string, ?>} - Payload selectsExtra hash when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload selectsExtra hash when present.
      */
-    selectsExtraPayload(): Record<string, unknown>;
+    selectsExtraPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs search payload.
-     * @returns {Record<string, ?>} - Payload searches array when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload searches array when present.
      */
-    searchPayload(): Record<string, unknown>;
+    searchPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs ransack payload.
-     * @returns {Record<string, ?>} - Payload ransack hash when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload ransack hash when present.
      */
-    ransackPayload(): Record<string, unknown>;
+    ransackPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs joins payload.
-     * @returns {Record<string, ?>} - Payload joins hash when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload joins hash when present.
      */
-    joinsPayload(): Record<string, unknown>;
+    joinsPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs sort payload.
-     * @returns {Record<string, ?>} - Payload sort array when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload sort array when present.
      */
-    sortPayload(): Record<string, unknown>;
+    sortPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs group payload.
-     * @returns {Record<string, ?>} - Payload group array when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload group array when present.
      */
-    groupPayload(): Record<string, unknown>;
+    groupPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs distinct payload.
-     * @returns {Record<string, ?>} - Payload distinct flag when enabled.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload distinct flag when enabled.
      */
-    distinctPayload(): Record<string, unknown>;
+    distinctPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs where payload.
-     * @returns {Record<string, ?>} - Payload where hash when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload where hash when present.
      */
-    wherePayload(): Record<string, unknown>;
+    wherePayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs pagination payload.
-     * @returns {Record<string, ?>} - Payload pagination params when present.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Payload pagination params when present.
      */
-    paginationPayload(): Record<string, unknown>;
+    paginationPayload(): Record<string, ReturnType<typeof JSON.parse>>;
     /**
      * Runs assert event query supported.
      * @returns {void}
@@ -512,10 +658,10 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
     last(): Promise<InstanceType<T> | null>;
     /**
      * Runs pluck.
-     * @param {...(string | string[] | Record<string, ?> | Array<Record<string, ?>>)} columns - Pluck definition(s).
-     * @returns {Promise<Array<?>>} - Plucked values.
+     * @param {...(string | string[] | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>)} columns - Pluck definition(s).
+     * @returns {Promise<Array<ReturnType<typeof JSON.parse>>>} - Plucked values.
      */
-    pluck(...columns: (string | string[] | Record<string, unknown> | Array<Record<string, unknown>>)[]): Promise<Array<unknown>>;
+    pluck(...columns: (string | string[] | Record<string, ReturnType<typeof JSON.parse>> | Array<Record<string, ReturnType<typeof JSON.parse>>>)[]): Promise<Array<ReturnType<typeof JSON.parse>>>;
     /**
      * Runs find.
      * @param {number | string} id - Record id.
@@ -524,232 +670,41 @@ export default class FrontendModelQuery<T extends import("./base.js").FrontendMo
     find(id: number | string): Promise<InstanceType<T>>;
     /**
      * Runs find by.
-     * @param {Record<string, ?>} conditions - Conditions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} conditions - Conditions.
      * @returns {Promise<InstanceType<T> | null>} - Found model or null.
      */
-    findBy(conditions: Record<string, unknown>): Promise<InstanceType<T> | null>;
+    findBy(conditions: Record<string, ReturnType<typeof JSON.parse>>): Promise<InstanceType<T> | null>;
     /**
      * Runs find by or fail.
-     * @param {Record<string, ?>} conditions - Conditions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} conditions - Conditions.
      * @returns {Promise<InstanceType<T>>} - Found model.
      */
-    findByOrFail(conditions: Record<string, unknown>): Promise<InstanceType<T>>;
+    findByOrFail(conditions: Record<string, ReturnType<typeof JSON.parse>>): Promise<InstanceType<T>>;
     /**
      * Runs find or initialize by.
-     * @param {Record<string, ?>} conditions - Conditions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} conditions - Conditions.
      * @returns {Promise<InstanceType<T>>} - Existing or initialized model.
      */
-    findOrInitializeBy(conditions: Record<string, unknown>): Promise<InstanceType<T>>;
+    findOrInitializeBy(conditions: Record<string, ReturnType<typeof JSON.parse>>): Promise<InstanceType<T>>;
     /**
      * Runs find or create by.
-     * @param {Record<string, ?>} conditions - Conditions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} conditions - Conditions.
      * @param {(model: InstanceType<T>) => Promise<void> | void} [callback] - Optional callback before save.
      * @returns {Promise<InstanceType<T>>} - Existing or newly created model.
      */
-    findOrCreateBy(conditions: Record<string, unknown>, callback?: (model: InstanceType<T>) => Promise<void> | void): Promise<InstanceType<T>>;
+    findOrCreateBy(conditions: Record<string, ReturnType<typeof JSON.parse>>, callback?: (model: InstanceType<T>) => Promise<void> | void): Promise<InstanceType<T>>;
     /**
      * Runs validated structured conditions.
-     * @param {Record<string, ?>} conditions - Candidate structured conditions.
-     * @returns {Record<string, ?>} - Validated conditions.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} conditions - Candidate structured conditions.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>>} - Validated conditions.
      */
-    validatedStructuredConditions(conditions: Record<string, unknown>): Record<string, unknown>;
+    validatedStructuredConditions(conditions: Record<string, ReturnType<typeof JSON.parse>>): Record<string, ReturnType<typeof JSON.parse>>;
 }
 /**
- * FrontendModelSearch type.
- */
-export type FrontendModelSearch = {
-    /**
-     * - Attribute name to search.
-     */
-    column: string;
-    /**
-     * - Search operator.
-     */
-    operator: "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq";
-    /**
-     * - Relationship path from root model.
-     */
-    path: string[];
-    /**
-     * - Search value.
-     */
-    value: unknown;
-};
-/**
- * FrontendModelTransportValue type.
- */
-export type FrontendModelTransportValue = null | boolean | number | string | object;
-/**
- * FrontendModelAttributeValue type.
- */
-export type FrontendModelAttributeValue = import("./base.js").FrontendModelAttributeValue;
-/**
- * Defines this typedef.
- */
-export type FrontendModelWithCountPayloadEntry = {
-    attributeName: string;
-    relationshipName: string;
-    where?: Record<string, FrontendModelTransportValue>;
-};
-/**
- * Defines this typedef.
- */
-export type FrontendModelAbilitiesPayloadEntry = {
-    modelName: string;
-    actions: string[];
-};
-/**
- * FrontendModelProjectionOptions type.
- */
-export type FrontendModelProjectionOptions = {
-    /**
-     * - Model-aware attribute select map or root-model shorthand.
-     */
-    select?: string | string[] | Record<string, string | string[]> | undefined;
-    /**
-     * - Extra attributes to load in addition to the defaults, keyed by model name or root-model shorthand.
-     */
-    selectsExtra?: string | string[] | Record<string, string | string[]> | undefined;
-    /**
-     * - Relationship preload tree.
-     */
-    preload?: string | import("../database/query/index.js").NestedPreloadRecord | (string | import("../database/query/index.js").NestedPreloadRecord)[] | undefined;
-    /**
-     * - Association count spec.
-     */
-    withCount?: string | string[] | Record<string, boolean | {
-        relationship?: string;
-        where?: Record<string, FrontendModelTransportValue>;
-    }> | undefined;
-    /**
-     * - Ability actions to compute per record.
-     */
-    abilities?: string[] | Record<string, string[]> | undefined;
-    /**
-     * - Backend query data names/spec.
-     */
-    queryData?: string | Record<string, FrontendModelTransportValue> | (string | Record<string, FrontendModelTransportValue>)[] | undefined;
-};
-/**
- * Defines this typedef.
- */
-export type FrontendModelEventOptionsObject = FrontendModelProjectionOptions & {
-    query?: FrontendModelQuery<import("./base.js").FrontendModelClass>;
-};
-/**
- * FrontendModelEventOptions type.
- */
-export type FrontendModelEventOptions = FrontendModelEventOptionsObject | FrontendModelQuery<import("./base.js").FrontendModelClass>;
-/**
- * FrontendModelProjectionPayload type.
- */
-export type FrontendModelProjectionPayload = {
-    /**
-     * - Normalized select map.
-     */
-    select?: Record<string, string[]> | undefined;
-    /**
-     * - Normalized extra select map.
-     */
-    selectsExtra?: Record<string, string[]> | undefined;
-    /**
-     * - Normalized preload tree.
-     */
-    preload?: import("../database/query/index.js").NestedPreloadRecord | undefined;
-    /**
-     * - Normalized count specs.
-     */
-    withCount?: FrontendModelWithCountPayloadEntry[] | undefined;
-    /**
-     * - Normalized ability specs.
-     */
-    abilities?: FrontendModelAbilitiesPayloadEntry[] | undefined;
-    /**
-     * - Normalized queryData spec.
-     */
-    queryData?: FrontendModelTransportValue | undefined;
-};
-/**
- * FrontendModelEventFilterPayload type.
- */
-export type FrontendModelEventFilterPayload = {
-    /**
-     * - Relationship joins needed for matching.
-     */
-    joins?: Record<string, FrontendModelTransportValue> | undefined;
-    /**
-     * - Search predicates needed for matching.
-     */
-    searches?: FrontendModelSearch[] | undefined;
-    /**
-     * - Structured where predicates needed for matching.
-     */
-    where?: Record<string, FrontendModelTransportValue> | undefined;
-};
-/**
- * Defines this typedef.
- */
-export type FrontendModelEventFilterPayloadEntry = FrontendModelEventFilterPayload & {
-    key: string;
-};
-/**
- * FrontendModelEventOptionsPayload type.
- */
-export type FrontendModelEventOptionsPayload = {
-    /**
-     * - Stable event filter key, or null when no filter is present.
-     */
-    eventFilterKey: string | null;
-    /**
-     * - Normalized event filter payload, or null when unfiltered.
-     */
-    eventFilterPayload: FrontendModelEventFilterPayload | null;
-    /**
-     * - Normalized event serialization projection payload.
-     */
-    projectionPayload: FrontendModelProjectionPayload;
-};
-/**
- * FrontendModelSort type.
- */
-export type FrontendModelSort = {
-    /**
-     * - Attribute name to sort by.
-     */
-    column: string;
-    /**
-     * - Sort direction.
-     */
-    direction: "asc" | "desc";
-    /**
-     * - Relationship path from root model.
-     */
-    path: string[];
-};
-/**
- * FrontendModelGroup type.
- */
-export type FrontendModelGroup = {
-    /**
-     * - Attribute name to group by.
-     */
-    column: string;
-    /**
-     * - Relationship path from root model.
-     */
-    path: string[];
-};
-/**
- * FrontendModelPluck type.
+ * Runs the frontendModelEventOptionsPayload helper.
+ * @param {import("./base.js").FrontendModelClass} modelClass - Frontend model class.
+ * @param {FrontendModelEventOptions} [options] - Event query or projection options.
+ * @returns {FrontendModelEventOptionsPayload} - Normalized event subscription payload.
  */
-export type FrontendModelPluck = {
-    /**
-     * - Attribute name to pluck.
-     */
-    column: string;
-    /**
-     * - Relationship path from root model.
-     */
-    path: string[];
-};
+export declare function frontendModelEventOptionsPayload(modelClass: import("./base.js").FrontendModelClass, options?: FrontendModelEventOptions): FrontendModelEventOptionsPayload;
 //# sourceMappingURL=query.d.ts.map