velocious 1.0.577 → 1.0.579

package/build/src/frontend-model-resource/base-resource.d.ts

@@ -1,3 +1,234 @@
+import AuthorizationBaseResource from "../authorization/base-resource.js";
+export type FrontendModelResourceAction = "index" | "find" | "create" | "update" | "destroy" | "attach" | "attachmentList" | "download" | "url";
+export type FrontendModelResourceController = import("../controller.js").default & {
+    currentAbility: () => import("../authorization/ability.js").default | undefined;
+    applyFrontendModelPagination: (args: {
+        pagination: FrontendModelResourcePagination;
+        query: import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+    }) => void;
+    applyFrontendModelSearch: (args: {
+        query: import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+        search: FrontendModelResourceSearch;
+    }) => void;
+    applyFrontendModelSort: (args: {
+        query: import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+        sort: FrontendModelResourceSort;
+    }) => void;
+    frontendModelAbilityAction: (action: FrontendModelResourceAction) => string;
+    frontendModelAbilityAuthorizedQuery: (action: FrontendModelResourceAction) => import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+    frontendModelAuthorizedQuery: (action: FrontendModelResourceAction) => import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+    frontendModelIndexQuery: (options?: FrontendModelResourceIndexQueryOptions & {
+        resource?: FrontendModelBaseResource;
+    }) => import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+    frontendModelParams: () => import("../configuration-types.js").VelociousParams;
+    frontendModelPreload: () => import("../database/query/index.js").NestedPreloadRecord | null;
+    frontendModelResourceConfigurationForModelClass: (modelClass: typeof import("../database/record/index.js").default) => FrontendModelResolvedResourceConfiguration | null;
+    serializeFrontendModel: (model: import("../database/record/index.js").default) => Promise<Record<string, object | string | number | boolean | null>>;
+};
+export type FrontendModelResourceAnyQuery = import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
+export type FrontendModelResourceIndexQueryOptions = {
+    /**
+     * - Whether frontend-model pagination params should be applied.
+     */
+    includePagination?: boolean;
+    /**
+     * - Whether frontend-model sort params should be applied.
+     */
+    includeSort?: boolean;
+};
+export type FrontendModelResourcePagination = {
+    /**
+     * - Maximum number of records.
+     */
+    limit: number | null;
+    /**
+     * - Number of records to skip.
+     */
+    offset: number | null;
+    /**
+     * - 1-based page number.
+     */
+    page: number | null;
+    /**
+     * - Page size.
+     */
+    perPage: number | null;
+};
+export type FrontendModelResourceSearch = {
+    /**
+     * - Column or attribute name.
+     */
+    column: string;
+    /**
+     * - Search operator.
+     */
+    operator: "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq";
+    /**
+     * - Relationship path.
+     */
+    path: string[];
+    /**
+     * - Search value.
+     */
+    value: ReturnType<typeof JSON.parse>;
+};
+export type FrontendModelResourceSort = {
+    /**
+     * - Attribute name to sort by.
+     */
+    column: string;
+    /**
+     * - Sort direction.
+     */
+    direction: "asc" | "desc";
+    /**
+     * - Relationship path from root model.
+     */
+    path: string[];
+};
+export type FrontendModelResourceControllerArgs = {
+    /**
+     * - Frontend-model controller instance.
+     */
+    controller: FrontendModelResourceController;
+    /**
+     * - Backing model class.
+     */
+    modelClass: typeof import("../database/record/index.js").default;
+    /**
+     * - Model name.
+     */
+    modelName: string;
+    /**
+     * - Request params.
+     */
+    params: import("../configuration-types.js").VelociousParams;
+    /**
+     * - Normalized resource configuration (or raw input shape during early bootstrap).
+     */
+    resourceConfiguration: import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration | import("../configuration-types.js").FrontendModelResourceConfiguration;
+};
+export type FrontendModelResourceAbilityArgs = {
+    /**
+     * - Ability instance when the resource is used directly for authorization.
+     */
+    ability?: import("../authorization/ability.js").default;
+    /**
+     * - Ability context.
+     */
+    context?: import("../configuration-types.js").VelociousLooseObject;
+    /**
+     * - Ability locals.
+     */
+    locals?: import("../configuration-types.js").VelociousLooseObject;
+    /**
+     * - Optional backing model class override.
+     */
+    modelClass?: typeof import("../database/record/index.js").default;
+    /**
+     * - Optional model name override.
+     */
+    modelName?: string;
+    /**
+     * - Optional params override.
+     */
+    params?: import("../configuration-types.js").VelociousParams;
+    /**
+     * - Optional normalized resource configuration.
+     */
+    resourceConfiguration?: import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration | import("../configuration-types.js").FrontendModelResourceConfiguration;
+};
+export type FrontendModelSyncMutation = import("../sync/sync-envelope-replay-service.js").SyncReplayMutation;
+export type FrontendModelSyncAuthorization = {
+    /**
+     * - Whether the mutation may be applied.
+     */
+    allowed: boolean;
+    /**
+     * - Stable failure reason code when denied.
+     */
+    reason?: string;
+};
+export type FrontendModelApplySyncArgs = {
+    /**
+     * - Replay context.
+     */
+    context: Record<string, ReturnType<typeof JSON.parse>>;
+    /**
+     * - Existing sync row or null.
+     */
+    existingSync: import("../database/record/index.js").default | null;
+    /**
+     * - Normalized replay mutation.
+     */
+    mutation: FrontendModelSyncMutation;
+};
+export type FrontendModelSyncApplyResult = {
+    /**
+     * - Whether a record was created.
+     */
+    created: boolean;
+    /**
+     * - Whether a record was deleted.
+     */
+    deleted?: boolean;
+    /**
+     * - Applied record or null.
+     */
+    record: import("../database/record/index.js").default | null;
+};
+export type FrontendModelResolvedResourceConfiguration = {
+    /**
+     * - Backend project owning the resource.
+     */
+    backendProject: import("../configuration-types.js").BackendProjectConfiguration;
+    /**
+     * - Frontend model name.
+     */
+    modelName: string;
+    /**
+     * - Resource class.
+     */
+    resourceClass: import("../configuration-types.js").FrontendModelResourceClassType;
+    /**
+     * - Normalized resource configuration.
+     */
+    resourceConfiguration: import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration;
+};
+export type FrontendModelResourcePayloadValue = import("../frontend-models/base.js").FrontendModelTransportValue | import("../database/record/index.js").default | Record<string, unknown> | Array<unknown>;
+export type FrontendModelResourceAttributePayload = Record<string, FrontendModelResourcePayloadValue>;
+export type FrontendModelResourceVirtualSetter = (arg1: import("../database/record/index.js").default, arg2: FrontendModelResourcePayloadValue) => (void | Promise<void>);
+export type WritableAttributeReceiverClass = {
+    /**
+     * - Resolves aliases to canonical attribute names.
+     */
+    resolveAttributeName: (arg: string) => string | null;
+    /**
+     * - Locates a setter method on the receiver.
+     */
+    findMemberNameInsensitive: (arg1: Record<string, ReturnType<typeof JSON.parse>>, arg2: string) => string | null;
+};
+export type FrontendModelResourceSaveOptions = {
+    /**
+     * - Uploaded attachment attributes.
+     */
+    attachments?: FrontendModelResourceAttributePayload | null;
+    /**
+     * - Controller handling the mutation.
+     */
+    controller?: FrontendModelResourceController | null;
+    /**
+     * - Nested attributes payload.
+     */
+    nestedAttributes?: FrontendModelResourceAttributePayload | null;
+};
+export type FrontendModelResourceNestedEntry = FrontendModelResourceAttributePayload & {
+    id?: string | number;
+    _destroy?: boolean;
+    attributes?: FrontendModelResourceAttributePayload;
+    attachments?: FrontendModelResourceAttributePayload;
+    nestedAttributes?: FrontendModelResourceAttributePayload;
+};
 /**
  * Built-in frontend-model resource action.
  * @typedef {"index" | "find" | "create" | "update" | "destroy" | "attach" | "attachmentList" | "download" | "url"} FrontendModelResourceAction
@@ -43,7 +274,7 @@
  * @property {string} column - Column or attribute name.
  * @property {"eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq"} operator - Search operator.
  * @property {string[]} path - Relationship path.
- * @property {?} value - Search value.
+ * @property {ReturnType<typeof JSON.parse>} value - Search value.
  */
 /**
  * FrontendModelResourceSort type.
@@ -85,7 +316,7 @@
 /**
  * Arguments for the applySync full-escape-hatch hook.
  * @typedef {object} FrontendModelApplySyncArgs
- * @property {Record<string, ?>} context - Replay context.
+ * @property {Record<string, ReturnType<typeof JSON.parse>>} context - Replay context.
  * @property {import("../database/record/index.js").default | null} existingSync - Existing sync row or null.
  * @property {FrontendModelSyncMutation} mutation - Normalized replay mutation.
  */
@@ -116,13 +347,13 @@
  */
 /**
  * Virtual setter method on a frontend-model resource.
- * @typedef {function(import("../database/record/index.js").default, FrontendModelResourcePayloadValue): (void | Promise<void>)} FrontendModelResourceVirtualSetter
+ * @typedef {(arg1: import("../database/record/index.js").default, arg2: FrontendModelResourcePayloadValue) => (void | Promise<void>)} FrontendModelResourceVirtualSetter
  */
 /**
  * Static helpers used when checking whether a model-like receiver accepts an attribute.
  * @typedef {object} WritableAttributeReceiverClass
- * @property {function(string): string | null} resolveAttributeName - Resolves aliases to canonical attribute names.
- * @property {function(Record<string, ?>, string): string | null} findMemberNameInsensitive - Locates a setter method on the receiver.
+ * @property {(arg: string) => string | null} resolveAttributeName - Resolves aliases to canonical attribute names.
+ * @property {(arg1: Record<string, ReturnType<typeof JSON.parse>>, arg2: string) => string | null} findMemberNameInsensitive - Locates a setter method on the receiver.
  */
 /**
  * Options passed while saving frontend-model resource mutations.
@@ -140,12 +371,21 @@
  * @template {typeof import("../database/record/index.js").default} [TModelClass=typeof import("../database/record/index.js").default]
  */
 export default class FrontendModelBaseResource<TModelClass extends typeof import("../database/record/index.js").default = typeof import("../database/record/index.js").default> extends AuthorizationBaseResource {
-    /** @type {Record<string, ?> | string[] | undefined} */
-    static attributes: Record<string, unknown> | string[] | undefined;
+    controller: FrontendModelResourceController | undefined;
+    modelClassValue: typeof import("../database/record/index.js").default | undefined;
+    modelNameValue: string | undefined;
+    paramsValue: import("../configuration-types.js").VelociousParams | undefined;
+    resourceConfigurationValue: import("../configuration-types.js").FrontendModelResourceConfiguration | import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration | undefined;
+    /** @type {FrontendModelBaseResource | null | undefined} */
+    sharedResourceInstanceValue: FrontendModelBaseResource | null | undefined;
+    /** @type {typeof import("../database/record/index.js").default | undefined} */
+    static ModelClass: typeof import("../database/record/index.js").default | undefined;
+    /** @type {Record<string, ReturnType<typeof JSON.parse>> | string[] | undefined} */
+    static attributes: Record<string, ReturnType<typeof JSON.parse>> | string[] | undefined;
     /** @type {string[] | undefined} */
     static abilities: string[] | undefined;
-    /** @type {Record<string, ?> | undefined} */
-    static attachments: Record<string, unknown> | undefined;
+    /** @type {Record<string, ReturnType<typeof JSON.parse>> | undefined} */
+    static attachments: Record<string, ReturnType<typeof JSON.parse>> | undefined;
     /** @type {string[] | undefined} */
     static commands: string[] | undefined;
     /** @type {string[] | undefined} */
@@ -168,8 +408,8 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
     static sync: import("../configuration-types.js").FrontendModelResourceSyncConfiguration | boolean | undefined;
     /** @type {string[] | undefined} */
     static translatedAttributes: string[] | undefined;
-    /** @type {?} */
-    static SharedResource: unknown;
+    /** @type {ReturnType<typeof JSON.parse>} */
+    static SharedResource: ReturnType<typeof JSON.parse>;
     /**
      * Declarative writable-attribute permit list (camelCase attribute names)
      * used as the default {@link FrontendModelBaseResource#permittedParams} and
@@ -179,40 +419,28 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * (including `null`) wins.
      * @type {string[] | null | undefined} */
     static writableAttributes: string[] | null | undefined;
+    /**
+     * Runs constructor.
+     * @param {FrontendModelResourceAbilityArgs | FrontendModelResourceControllerArgs} args - Resource args.
+     */
+    constructor(args: FrontendModelResourceAbilityArgs | FrontendModelResourceControllerArgs);
     /**
      * Returns the configured shared resource class.
-     * @returns {?} - Shared resource class.
+     * @returns {ReturnType<typeof JSON.parse>} - Shared resource class.
      */
-    static sharedResourceClass(): unknown;
+    static sharedResourceClass(): ReturnType<typeof JSON.parse>;
     /**
      * Reads a static resource config value from the environment resource first,
      * then from the shared resource.
      * @param {"abilities" | "attachments" | "attributes" | "builtInCollectionCommands" | "builtInMemberCommands" | "collectionCommands" | "commands" | "memberCommands" | "modelName" | "primaryKey" | "relationships" | "server" | "sync" | "translatedAttributes" | "writableAttributes"} name - Static config property name.
-     * @returns {?} - Resolved config value.
+     * @returns {ReturnType<typeof JSON.parse>} - Resolved config value.
      */
-    static sharedResourceStaticValue(name: "abilities" | "attachments" | "attributes" | "builtInCollectionCommands" | "builtInMemberCommands" | "collectionCommands" | "commands" | "memberCommands" | "modelName" | "primaryKey" | "relationships" | "server" | "sync" | "translatedAttributes" | "writableAttributes"): unknown;
+    static sharedResourceStaticValue(name: "abilities" | "attachments" | "attributes" | "builtInCollectionCommands" | "builtInMemberCommands" | "collectionCommands" | "commands" | "memberCommands" | "modelName" | "primaryKey" | "relationships" | "server" | "sync" | "translatedAttributes" | "writableAttributes"): ReturnType<typeof JSON.parse>;
     /**
      * Resolves translated attributes from environment and shared resources.
      * @returns {string[] | undefined} - Translated attribute names.
      */
     static translatedAttributesConfig(): string[] | undefined;
-    /**
-     * Runs resource config.
-     * @returns {import("../configuration-types.js").FrontendModelResourceConfiguration} - Static resource config (raw user input shape; consumers normalize).
-     */
-    static resourceConfig(): import("../configuration-types.js").FrontendModelResourceConfiguration;
-    /**
-     * Runs constructor.
-     * @param {FrontendModelResourceAbilityArgs | FrontendModelResourceControllerArgs} args - Resource args.
-     */
-    constructor(args: FrontendModelResourceAbilityArgs | FrontendModelResourceControllerArgs);
-    controller: FrontendModelResourceController | undefined;
-    modelClassValue: typeof import("../database/record/index.js").default | undefined;
-    modelNameValue: string | undefined;
-    paramsValue: import("../configuration-types.js").VelociousParams | undefined;
-    resourceConfigurationValue: import("../configuration-types.js").FrontendModelResourceConfiguration | import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration | undefined;
-    /** @type {FrontendModelBaseResource | null | undefined} */
-    sharedResourceInstanceValue: FrontendModelBaseResource | null | undefined;
     /**
      * Builds a resource instance for shared-resource fallback calls.
      * @returns {FrontendModelBaseResource | null} - Shared resource instance when configured.
@@ -246,11 +474,26 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
         method: (...methodArgs: unknown[]) => unknown;
         resource: FrontendModelBaseResource;
     } | null;
+    /**
+     * Runs abilities.
+     * @returns {void} - No return value.
+     */
+    abilities(): void;
     /**
      * Runs typed controller instance.
      * @returns {FrontendModelResourceController} - Controller instance with frontend-model helpers.
      */
     typedControllerInstance(): FrontendModelResourceController;
+    /**
+     * Runs resource config.
+     * @returns {import("../configuration-types.js").FrontendModelResourceConfiguration} - Static resource config (raw user input shape; consumers normalize).
+     */
+    static resourceConfig(): import("../configuration-types.js").FrontendModelResourceConfiguration;
+    /**
+     * Runs static model class.
+     * @returns {typeof import("../database/record/index.js").default} - Backing model class.
+     */
+    static modelClass(): typeof import("../database/record/index.js").default;
     /**
      * Runs controller instance.
      * @returns {import("../controller.js").default} - Controller instance.
@@ -317,15 +560,15 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * {@link FrontendModelBaseResource.writableAttributes} permit list, or `[]`
      * — nothing permitted — without a declared list. Subclasses override to
      * customize; an explicit override always wins.
-     * @param {{action?: "create" | "update", params?: Record<string, ?>, ability?: import("../authorization/ability.js").default, locals?: Record<string, ?>}} [arg] - Request context.
-     * @returns {Array<string | Record<string, ?>>} - Permit spec.
+     * @param {{action?: "create" | "update", params?: Record<string, ReturnType<typeof JSON.parse>>, ability?: import("../authorization/ability.js").default, locals?: Record<string, ReturnType<typeof JSON.parse>>}} [arg] - Request context.
+     * @returns {Array<string | Record<string, ReturnType<typeof JSON.parse>>>} - Permit spec.
      */
     permittedParams(arg?: {
         action?: "create" | "update";
-        params?: Record<string, unknown>;
+        params?: Record<string, ReturnType<typeof JSON.parse>>;
         ability?: import("../authorization/ability.js").default;
-        locals?: Record<string, unknown>;
-    }): Array<string | Record<string, unknown>>;
+        locals?: Record<string, ReturnType<typeof JSON.parse>>;
+    }): Array<string | Record<string, ReturnType<typeof JSON.parse>>>;
     /**
      * Resolves the declared writable-attribute permit list from the environment
      * resource first, then the shared resource — mirroring how the other
@@ -350,12 +593,12 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * applies through {@link FrontendModelBaseResource#findSyncRecord} scoping
      * and the create membership check.
      * @param {object} args - Options.
-     * @param {Record<string, ?>} args.context - Replay context.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} args.context - Replay context.
      * @param {FrontendModelSyncMutation} args.mutation - Normalized replay mutation.
      * @returns {FrontendModelSyncAuthorization | Promise<FrontendModelSyncAuthorization>} Authorization result.
      */
     authorizeSyncMutation({ context, mutation }: {
-        context: Record<string, unknown>;
+        context: Record<string, ReturnType<typeof JSON.parse>>;
         mutation: FrontendModelSyncMutation;
     }): FrontendModelSyncAuthorization | Promise<FrontendModelSyncAuthorization>;
     /**
@@ -383,8 +626,8 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * @returns {Promise<import("../database/record/index.js").default | null>} Existing record or null.
      */
     findSyncRecord({ ability, forDelete, mutation }: {
-        ability?: import("../authorization/ability.js").default | undefined;
-        forDelete?: boolean | undefined;
+        ability?: import("../authorization/ability.js").default;
+        forDelete?: boolean;
         mutation: FrontendModelSyncMutation;
     }): Promise<import("../database/record/index.js").default | null>;
     /**
@@ -408,18 +651,18 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * merged into the apply result, reaching persistExtraAttributes and
      * broadcasts.
      * @param {object} args - Options.
-     * @param {Record<string, ?>} args.context - Replay context.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} args.context - Replay context.
      * @param {boolean} args.created - Whether the record was created.
      * @param {FrontendModelSyncMutation} args.mutation - Normalized replay mutation.
      * @param {import("../database/record/index.js").default | null} args.record - Applied record or null.
-     * @returns {Record<string, ?> | Promise<Record<string, ?>>} Extra apply-result entries.
+     * @returns {Record<string, ReturnType<typeof JSON.parse>> | Promise<Record<string, ReturnType<typeof JSON.parse>>>} Extra apply-result entries.
      */
     afterSyncApply({ context, created, mutation, record }: {
-        context: Record<string, unknown>;
+        context: Record<string, ReturnType<typeof JSON.parse>>;
         created: boolean;
         mutation: FrontendModelSyncMutation;
         record: import("../database/record/index.js").default | null;
-    }): Record<string, unknown> | Promise<Record<string, unknown>>;
+    }): Record<string, ReturnType<typeof JSON.parse>> | Promise<Record<string, ReturnType<typeof JSON.parse>>>;
     /**
      * Normalizes create attributes before permission filtering and saving.
      * @param {FrontendModelResourceAttributePayload} attributes - Incoming create attributes.
@@ -612,44 +855,44 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
     update(model: import("../database/record/index.js").default, attributes: FrontendModelResourceAttributePayload, options?: FrontendModelResourceSaveOptions): Promise<import("../database/record/index.js").default>;
     /**
      * Saves a model and applies nested attributes in one transaction.
-     * @param {{filtered: Record<string, ?>, model: import("../database/record/index.js").default, options: FrontendModelResourceSaveOptions, permit: {attributes: string[], nested: Record<string, ?>}}} args - Save arguments.
+     * @param {{filtered: Record<string, ReturnType<typeof JSON.parse>>, model: import("../database/record/index.js").default, options: FrontendModelResourceSaveOptions, permit: {attributes: string[], nested: Record<string, ReturnType<typeof JSON.parse>>}}} args - Save arguments.
      * @returns {Promise<import("../database/record/index.js").default>} - Saved model.
      */
     _saveWithNestedAttributes({ filtered, model, options, permit }: {
-        filtered: Record<string, unknown>;
+        filtered: Record<string, ReturnType<typeof JSON.parse>>;
         model: import("../database/record/index.js").default;
         options: FrontendModelResourceSaveOptions;
         permit: {
             attributes: string[];
-            nested: Record<string, unknown>;
+            nested: Record<string, ReturnType<typeof JSON.parse>>;
         };
     }): Promise<import("../database/record/index.js").default>;
     /**
      * Assigns attributes to a model, using virtual setters on the resource when available.
      * @param {import("../database/record/index.js").default} model - Model instance.
-     * @param {Record<string, ?>} attributes - Attributes to assign.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} attributes - Attributes to assign.
      * @returns {Promise<void>}
      */
-    _assignWithVirtualSetters(model: import("../database/record/index.js").default, attributes: Record<string, unknown>): Promise<void>;
+    _assignWithVirtualSetters(model: import("../database/record/index.js").default, attributes: Record<string, ReturnType<typeof JSON.parse>>): Promise<void>;
     /**
      * Splits attachment-named attributes into the attachment payload while preserving legacy callers
      * that submitted attachments as normal frontend-model attributes.
-     * @param {Record<string, ?>} attributes - Incoming mutation attributes.
-     * @param {Record<string, ?> | null} attachments - Explicit attachment payload.
-     * @returns {{attributes: Record<string, ?>, attachments: Record<string, ?> | null}} Attributes with attachment keys removed and merged attachment payload.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} attributes - Incoming mutation attributes.
+     * @param {Record<string, ReturnType<typeof JSON.parse>> | null} attachments - Explicit attachment payload.
+     * @returns {{attributes: Record<string, ReturnType<typeof JSON.parse>>, attachments: Record<string, ReturnType<typeof JSON.parse>> | null}} Attributes with attachment keys removed and merged attachment payload.
      */
-    _extractAttachmentAttributes(attributes: Record<string, unknown>, attachments: Record<string, unknown> | null): {
-        attributes: Record<string, unknown>;
-        attachments: Record<string, unknown> | null;
+    _extractAttachmentAttributes(attributes: Record<string, ReturnType<typeof JSON.parse>>, attachments: Record<string, ReturnType<typeof JSON.parse>> | null): {
+        attributes: Record<string, ReturnType<typeof JSON.parse>>;
+        attachments: Record<string, ReturnType<typeof JSON.parse>> | null;
     };
     /**
      * Queues attachment payloads on a model after validating permits and attachment definitions.
      * @param {import("../database/record/index.js").default} model - Model receiving attachments.
-     * @param {Record<string, ?> | null} attachments - Attachments keyed by attachment name.
+     * @param {Record<string, ReturnType<typeof JSON.parse>> | null} attachments - Attachments keyed by attachment name.
      * @param {string[]} permittedAttributeNames - Attribute/attachment names permitted by the resource.
      * @returns {void}
      */
-    _assignAttachments(model: import("../database/record/index.js").default, attachments: Record<string, unknown> | null, permittedAttributeNames: string[]): void;
+    _assignAttachments(model: import("../database/record/index.js").default, attachments: Record<string, ReturnType<typeof JSON.parse>> | null, permittedAttributeNames: string[]): void;
     /**
      * Sets a translated attribute on a model via the translations relationship.
      * @param {import("../database/record/index.js").default} model - Model instance.
@@ -668,16 +911,16 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * Runs serialize.
      * @param {import("../database/record/index.js").default} model - Model to serialize.
      * @param {"index" | "find" | "create" | "update"} [action] - Action.
-     * @returns {Promise<Record<string, ?>>} - Serialized model payload.
+     * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>>} - Serialized model payload.
      */
-    serialize(model: import("../database/record/index.js").default, action?: "index" | "find" | "create" | "update"): Promise<Record<string, unknown>>;
+    serialize(model: import("../database/record/index.js").default, action?: "index" | "find" | "create" | "update"): Promise<Record<string, ReturnType<typeof JSON.parse>>>;
     /**
      * Resolves common metadata for one nested-attributes relationship.
      * @param {object} args - Nested relationship inputs.
      * @param {import("../database/record/index.js").default} args.parent - Parent model instance.
      * @param {string} args.relationshipName - Relationship receiving nested attributes.
      * @param {FrontendModelResourcePayloadValue} args.rawEntries - Raw nested entries from the request payload.
-     * @param {{attributes: string[], nested: Record<string, ?>}} args.childPermit - Parsed child permit.
+     * @param {{attributes: string[], nested: Record<string, ReturnType<typeof JSON.parse>>}} args.childPermit - Parsed child permit.
      * @param {FrontendModelResourceController | null | undefined} args.controller - Controller instance for child resource lookup.
      * @returns {{ability: import("../authorization/ability.js").default | undefined, childResource: FrontendModelBaseResource, childResourceConfig: FrontendModelResolvedResourceConfiguration, childWritableAttributes: string[], destroyPermitted: boolean, entries: Array<FrontendModelResourceNestedEntry>, relationship: import("../database/record/relationships/base.js").default, targetModelClass: typeof import("../database/record/index.js").default}} Nested relationship context.
      */
@@ -687,7 +930,7 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
         rawEntries: FrontendModelResourcePayloadValue;
         childPermit: {
             attributes: string[];
-            nested: Record<string, unknown>;
+            nested: Record<string, ReturnType<typeof JSON.parse>>;
         };
         controller: FrontendModelResourceController | null | undefined;
     }): {
@@ -718,7 +961,7 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * (`{attributes, attachments, nestedAttributes}`) or direct Rails-style
      * fields (`{name, file, commentsAttributes}`).
      * @param {object} args - Normalization inputs.
-     * @param {{attributes: string[], nested: Record<string, ?>}} args.childPermit - Parsed child permit spec.
+     * @param {{attributes: string[], nested: Record<string, ReturnType<typeof JSON.parse>>}} args.childPermit - Parsed child permit spec.
      * @param {FrontendModelResourceNestedEntry} args.entry - Raw nested entry.
      * @param {string} args.relationshipName - Relationship name for error messages.
      * @param {typeof import("../database/record/index.js").default} args.targetModelClass - Child model class.
@@ -727,7 +970,7 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
     _normalizeNestedRelationshipEntry({ childPermit, entry, relationshipName, targetModelClass }: {
         childPermit: {
             attributes: string[];
-            nested: Record<string, unknown>;
+            nested: Record<string, ReturnType<typeof JSON.parse>>;
         };
         entry: FrontendModelResourceNestedEntry;
         relationshipName: string;
@@ -738,12 +981,12 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * @param {import("../database/record/index.js").default} parent - Parent model instance.
      * @param {FrontendModelResourceAttributePayload} nestedAttributes - Nested-attribute payload keyed by relationship name.
      * @param {FrontendModelResourceController | null | undefined} controller - Controller instance for resource resolution and authorization.
-     * @param {{attributes: string[], nested: Record<string, ?>} | null} [parentPermit] - Parsed parent permit spec.
+     * @param {{attributes: string[], nested: Record<string, ReturnType<typeof JSON.parse>>} | null} [parentPermit] - Parsed parent permit spec.
      * @returns {Promise<void>}
      */
     _applyBelongsToNestedAttributes(parent: import("../database/record/index.js").default, nestedAttributes: FrontendModelResourceAttributePayload, controller: FrontendModelResourceController | null | undefined, parentPermit?: {
         attributes: string[];
-        nested: Record<string, unknown>;
+        nested: Record<string, ReturnType<typeof JSON.parse>>;
     } | null): Promise<void>;
     /**
      * Applies a `nestedAttributes` payload to a freshly-saved parent model,
@@ -760,25 +1003,25 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * @param {import("../database/record/index.js").default} parent - Parent model instance.
      * @param {FrontendModelResourceAttributePayload} nestedAttributes - Nested-attribute payload keyed by relationship name.
      * @param {FrontendModelResourceController | null | undefined} controller - Controller instance for resource resolution and authorization.
-     * @param {{attributes: string[], nested: Record<string, ?>} | null} [parentPermit] - Parsed parent permit spec.
+     * @param {{attributes: string[], nested: Record<string, ReturnType<typeof JSON.parse>>} | null} [parentPermit] - Parsed parent permit spec.
      * @returns {Promise<void>}
      */
     _applyNestedAttributes(parent: import("../database/record/index.js").default, nestedAttributes: FrontendModelResourceAttributePayload, controller: FrontendModelResourceController | null | undefined, parentPermit?: {
         attributes: string[];
-        nested: Record<string, unknown>;
+        nested: Record<string, ReturnType<typeof JSON.parse>>;
     } | null): Promise<void>;
     /**
      * Assigns one nested entry's attributes and attachments to a child model.
      * @param {object} args - Assignment inputs.
      * @param {import("../database/record/index.js").default} args.child - Child model receiving data.
      * @param {string[]} args.childWritableAttributes - Permitted child attribute and attachment names.
-     * @param {Record<string, ?>} args.entry - Nested entry payload.
+     * @param {Record<string, ReturnType<typeof JSON.parse>>} args.entry - Nested entry payload.
      * @returns {Promise<void>}
      */
     _assignNestedEntryToChild({ child, childWritableAttributes, entry }: {
         child: import("../database/record/index.js").default;
         childWritableAttributes: string[];
-        entry: Record<string, unknown>;
+        entry: Record<string, ReturnType<typeof JSON.parse>>;
     }): Promise<void>;
     /**
      * Converts a relationship's foreign-key column/name to the target model's attribute name.
@@ -887,305 +1130,12 @@ export default class FrontendModelBaseResource<TModelClass extends typeof import
      * parent's permit so the post-save serialize step emits them and the
      * client can reconcile ids.
      * @param {import("../database/record/index.js").default} model - Saved parent model.
-     * @param {{attributes: string[], nested: Record<string, ?>}} permit - Parsed parent permit.
+     * @param {{attributes: string[], nested: Record<string, ReturnType<typeof JSON.parse>>}} permit - Parsed parent permit.
      * @returns {Promise<void>}
      */
     _preloadNestedWritableRelationships(model: import("../database/record/index.js").default, permit: {
         attributes: string[];
-        nested: Record<string, unknown>;
+        nested: Record<string, ReturnType<typeof JSON.parse>>;
     }): Promise<void>;
 }
-/**
- * Built-in frontend-model resource action.
- */
-export type FrontendModelResourceAction = "index" | "find" | "create" | "update" | "destroy" | "attach" | "attachmentList" | "download" | "url";
-/**
- * Frontend-model controller methods used by resources.
- */
-export type FrontendModelResourceController = import("../controller.js").default & {
-    currentAbility: () => import("../authorization/ability.js").default | undefined;
-    applyFrontendModelPagination: (args: {
-        pagination: FrontendModelResourcePagination;
-        query: import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-    }) => void;
-    applyFrontendModelSearch: (args: {
-        query: import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-        search: FrontendModelResourceSearch;
-    }) => void;
-    applyFrontendModelSort: (args: {
-        query: import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-        sort: FrontendModelResourceSort;
-    }) => void;
-    frontendModelAbilityAction: (action: FrontendModelResourceAction) => string;
-    frontendModelAbilityAuthorizedQuery: (action: FrontendModelResourceAction) => import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-    frontendModelAuthorizedQuery: (action: FrontendModelResourceAction) => import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-    frontendModelIndexQuery: (options?: FrontendModelResourceIndexQueryOptions & {
-        resource?: FrontendModelBaseResource;
-    }) => import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-    frontendModelParams: () => import("../configuration-types.js").VelociousParams;
-    frontendModelPreload: () => import("../database/query/index.js").NestedPreloadRecord | null;
-    frontendModelResourceConfigurationForModelClass: (modelClass: typeof import("../database/record/index.js").default) => FrontendModelResolvedResourceConfiguration | null;
-    serializeFrontendModel: (model: import("../database/record/index.js").default) => Promise<Record<string, object | string | number | boolean | null>>;
-};
-/**
- * Generic frontend-model index query passed to resource query hooks.
- */
-export type FrontendModelResourceAnyQuery = import("../database/query/model-class-query.js").default<typeof import("../database/record/index.js").default>;
-/**
- * Options for building a frontend-model resource index query.
- */
-export type FrontendModelResourceIndexQueryOptions = {
-    /**
-     * - Whether frontend-model pagination params should be applied.
-     */
-    includePagination?: boolean | undefined;
-    /**
-     * - Whether frontend-model sort params should be applied.
-     */
-    includeSort?: boolean | undefined;
-};
-/**
- * FrontendModelResourcePagination type.
- */
-export type FrontendModelResourcePagination = {
-    /**
-     * - Maximum number of records.
-     */
-    limit: number | null;
-    /**
-     * - Number of records to skip.
-     */
-    offset: number | null;
-    /**
-     * - 1-based page number.
-     */
-    page: number | null;
-    /**
-     * - Page size.
-     */
-    perPage: number | null;
-};
-/**
- * FrontendModelResourceSearch type.
- */
-export type FrontendModelResourceSearch = {
-    /**
-     * - Column or attribute name.
-     */
-    column: string;
-    /**
-     * - Search operator.
-     */
-    operator: "eq" | "like" | "notEq" | "gt" | "gteq" | "lt" | "lteq";
-    /**
-     * - Relationship path.
-     */
-    path: string[];
-    /**
-     * - Search value.
-     */
-    value: unknown;
-};
-/**
- * FrontendModelResourceSort type.
- */
-export type FrontendModelResourceSort = {
-    /**
-     * - Attribute name to sort by.
-     */
-    column: string;
-    /**
-     * - Sort direction.
-     */
-    direction: "asc" | "desc";
-    /**
-     * - Relationship path from root model.
-     */
-    path: string[];
-};
-/**
- * FrontendModelResourceControllerArgs type.
- */
-export type FrontendModelResourceControllerArgs = {
-    /**
-     * - Frontend-model controller instance.
-     */
-    controller: FrontendModelResourceController;
-    /**
-     * - Backing model class.
-     */
-    modelClass: typeof import("../database/record/index.js").default;
-    /**
-     * - Model name.
-     */
-    modelName: string;
-    /**
-     * - Request params.
-     */
-    params: import("../configuration-types.js").VelociousParams;
-    /**
-     * - Normalized resource configuration (or raw input shape during early bootstrap).
-     */
-    resourceConfiguration: import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration | import("../configuration-types.js").FrontendModelResourceConfiguration;
-};
-/**
- * FrontendModelResourceAbilityArgs type.
- */
-export type FrontendModelResourceAbilityArgs = {
-    /**
-     * - Ability instance when the resource is used directly for authorization.
-     */
-    ability?: import("../authorization/ability.js").default | undefined;
-    /**
-     * - Ability context.
-     */
-    context?: import("../configuration-types.js").VelociousLooseObject | undefined;
-    /**
-     * - Ability locals.
-     */
-    locals?: import("../configuration-types.js").VelociousLooseObject | undefined;
-    /**
-     * - Optional backing model class override.
-     */
-    modelClass?: typeof import("../database/record/index.js").default | undefined;
-    /**
-     * - Optional model name override.
-     */
-    modelName?: string | undefined;
-    /**
-     * - Optional params override.
-     */
-    params?: import("../configuration-types.js").VelociousParams | undefined;
-    /**
-     * - Optional normalized resource configuration.
-     */
-    resourceConfiguration?: import("../configuration-types.js").FrontendModelResourceConfiguration | import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration | undefined;
-};
-/**
- * Normalized sync replay mutation passed to the resource sync hooks.
- */
-export type FrontendModelSyncMutation = import("../sync/sync-envelope-replay-service.js").SyncReplayMutation;
-/**
- * Sync mutation authorization result.
- */
-export type FrontendModelSyncAuthorization = {
-    /**
-     * - Whether the mutation may be applied.
-     */
-    allowed: boolean;
-    /**
-     * - Stable failure reason code when denied.
-     */
-    reason?: string | undefined;
-};
-/**
- * Arguments for the applySync full-escape-hatch hook.
- */
-export type FrontendModelApplySyncArgs = {
-    /**
-     * - Replay context.
-     */
-    context: Record<string, unknown>;
-    /**
-     * - Existing sync row or null.
-     */
-    existingSync: import("../database/record/index.js").default | null;
-    /**
-     * - Normalized replay mutation.
-     */
-    mutation: FrontendModelSyncMutation;
-};
-/**
- * Apply result produced by routed sync mutation application.
- */
-export type FrontendModelSyncApplyResult = {
-    /**
-     * - Whether a record was created.
-     */
-    created: boolean;
-    /**
-     * - Whether a record was deleted.
-     */
-    deleted?: boolean | undefined;
-    /**
-     * - Applied record or null.
-     */
-    record: import("../database/record/index.js").default | null;
-};
-/**
- * Resolved frontend-model resource registration.
- */
-export type FrontendModelResolvedResourceConfiguration = {
-    /**
-     * - Backend project owning the resource.
-     */
-    backendProject: import("../configuration-types.js").BackendProjectConfiguration;
-    /**
-     * - Frontend model name.
-     */
-    modelName: string;
-    /**
-     * - Resource class.
-     */
-    resourceClass: import("../configuration-types.js").FrontendModelResourceClassType;
-    /**
-     * - Normalized resource configuration.
-     */
-    resourceConfiguration: import("../configuration-types.js").NormalizedFrontendModelResourceConfiguration;
-};
-/**
- * Transport-safe value accepted in frontend-model resource mutation payloads.
- * Nested object/array values are intentionally opaque because TypeScript rejects
- * recursive JSDoc typedefs for this transport payload contract.
- */
-export type FrontendModelResourcePayloadValue = import("../frontend-models/base.js").FrontendModelTransportValue | import("../database/record/index.js").default | Record<string, unknown> | Array<unknown>;
-/**
- * Attribute payload accepted by frontend-model resource mutations.
- */
-export type FrontendModelResourceAttributePayload = Record<string, FrontendModelResourcePayloadValue>;
-/**
- * Virtual setter method on a frontend-model resource.
- */
-export type FrontendModelResourceVirtualSetter = (arg0: import("../database/record/index.js").default, arg1: FrontendModelResourcePayloadValue) => (void | Promise<void>);
-/**
- * Static helpers used when checking whether a model-like receiver accepts an attribute.
- */
-export type WritableAttributeReceiverClass = {
-    /**
-     * - Resolves aliases to canonical attribute names.
-     */
-    resolveAttributeName: (arg0: string) => string | null;
-    /**
-     * - Locates a setter method on the receiver.
-     */
-    findMemberNameInsensitive: (arg0: Record<string, unknown>, arg1: string) => string | null;
-};
-/**
- * Options passed while saving frontend-model resource mutations.
- */
-export type FrontendModelResourceSaveOptions = {
-    /**
-     * - Uploaded attachment attributes.
-     */
-    attachments?: FrontendModelResourceAttributePayload | null | undefined;
-    /**
-     * - Controller handling the mutation.
-     */
-    controller?: FrontendModelResourceController | null | undefined;
-    /**
-     * - Nested attributes payload.
-     */
-    nestedAttributes?: FrontendModelResourceAttributePayload | null | undefined;
-};
-/**
- * Normalized nested attributes entry.
- */
-export type FrontendModelResourceNestedEntry = FrontendModelResourceAttributePayload & {
-    id?: string | number;
-    _destroy?: boolean;
-    attributes?: FrontendModelResourceAttributePayload;
-    attachments?: FrontendModelResourceAttributePayload;
-    nestedAttributes?: FrontendModelResourceAttributePayload;
-};
-import AuthorizationBaseResource from "../authorization/base-resource.js";
 //# sourceMappingURL=base-resource.d.ts.map