velocious 1.0.448 → 1.0.449

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

@@ -9,28 +9,30 @@ export class AttributeNotSelectedError extends Error {
 }
 /**
  * Lightweight singular relationship state holder for frontend model instances.
- * @template {FrontendModelClass} S
- * @template {FrontendModelClass} T
+ * @template {FrontendModelBase} S
+ * @template {FrontendModelBase} T
+ * @template {Record<string, FrontendModelAttributeValue>} [TargetCreateAttributes=Record<string, FrontendModelAttributeValue>]
  */
-export class FrontendModelSingularRelationship<S extends FrontendModelClass, T extends FrontendModelClass> {
+export class FrontendModelSingularRelationship<S extends FrontendModelBase, T extends FrontendModelBase, TargetCreateAttributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>> {
     /**
      * Runs constructor.
-     * @param {InstanceType<S>} model - Parent model.
+     * @param {S} model - Parent model.
      * @param {string} relationshipName - Relationship name.
-     * @param {T | null} targetModelClass - Target model class.
+     * @param {FrontendModelClass<T, Record<string, FrontendModelAttributeValue>, TargetCreateAttributes> | null} targetModelClass - Target model class.
      */
-    constructor(model: InstanceType<S>, relationshipName: string, targetModelClass: T | null);
-    model: InstanceType<S>;
+    constructor(model: S, relationshipName: string, targetModelClass: FrontendModelClass<T, Record<string, FrontendModelAttributeValue>, TargetCreateAttributes> | null);
+    model: S;
     relationshipName: string;
-    targetModelClass: T | null;
+    targetModelClass: FrontendModelClass<T, Record<string, FrontendModelTransportValue>, TargetCreateAttributes> | null;
     _preloaded: boolean;
-    _loadedValue: any;
+    /** @type {T | null} */
+    _loadedValue: T | null;
     /**
      * Runs set loaded.
-     * @param {?} loadedValue - Loaded relationship value.
+     * @param {T | null | undefined} loadedValue - Loaded relationship value.
      * @returns {void}
      */
-    setLoaded(loadedValue: unknown): void;
+    setLoaded(loadedValue: T | null | undefined): void;
     /**
      * Runs get preloaded.
      * @returns {boolean} - Whether relationship is preloaded.
@@ -38,43 +40,60 @@ export class FrontendModelSingularRelationship<S extends FrontendModelClass, T e
     getPreloaded(): boolean;
     /**
      * Runs loaded.
-     * @returns {?} - Loaded relationship value.
+     * @returns {T | null} - Loaded relationship value.
      */
-    loaded(): unknown;
+    loaded(): T | null;
+    /**
+     * Copies loaded value from another singular relationship helper.
+     * @param {FrontendModelRelationship} sourceRelationship - Source relationship helper.
+     * @returns {void}
+     */
+    copyLoadedFrom(sourceRelationship: FrontendModelRelationship): void;
     /**
      * Runs build.
-     * @param {Record<string, ?>} [attributes] - New model attributes.
-     * @returns {InstanceType<T>} - Built model.
+     * @param {TargetCreateAttributes} [attributes] - New model attributes.
+     * @returns {T} - Built model.
+     */
+    build(attributes?: TargetCreateAttributes): T;
+    /**
+     * Force-reload the relationship.
+     * @returns {Promise<T | null>} - Loaded relationship model.
+     */
+    load(): Promise<T | null>;
+    /**
+     * Returns the loaded relationship or loads it.
+     * @returns {Promise<T | null>} - Loaded relationship model.
      */
-    build(attributes?: Record<string, unknown>): InstanceType<T>;
+    orLoad(): Promise<T | null>;
 }
 /**
  * Lightweight has-many relationship state holder for frontend model instances.
- * @template {FrontendModelClass} S
- * @template {FrontendModelClass} T
+ * @template {FrontendModelBase} S
+ * @template {FrontendModelBase} T
+ * @template {Record<string, FrontendModelAttributeValue>} [TargetCreateAttributes=Record<string, FrontendModelAttributeValue>]
  */
-export class FrontendModelHasManyRelationship<S extends FrontendModelClass, T extends FrontendModelClass> {
+export class FrontendModelHasManyRelationship<S extends FrontendModelBase, T extends FrontendModelBase, TargetCreateAttributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>> {
     /**
      * Runs constructor.
-     * @param {InstanceType<S>} model - Parent model.
+     * @param {S} model - Parent model.
      * @param {string} relationshipName - Relationship name.
-     * @param {T | null} targetModelClass - Target model class.
+     * @param {FrontendModelClass<T, Record<string, FrontendModelAttributeValue>, TargetCreateAttributes> | null} targetModelClass - Target model class.
      */
-    constructor(model: InstanceType<S>, relationshipName: string, targetModelClass: T | null);
+    constructor(model: S, relationshipName: string, targetModelClass: FrontendModelClass<T, Record<string, FrontendModelAttributeValue>, TargetCreateAttributes> | null);
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<InstanceType<T>>} */
-    _loadedValue: Array<InstanceType<T>>;
-    model: InstanceType<S>;
+      @type {Array<T>} */
+    _loadedValue: Array<T>;
+    model: S;
     relationshipName: string;
-    targetModelClass: T | null;
+    targetModelClass: FrontendModelClass<T, Record<string, FrontendModelTransportValue>, TargetCreateAttributes> | null;
     _preloaded: boolean;
     /**
      * Runs set loaded.
-     * @param {Array<InstanceType<T>>} loadedValue - Loaded relationship value.
+     * @param {Array<T>} loadedValue - Loaded relationship value.
      * @returns {void}
      */
-    setLoaded(loadedValue: Array<InstanceType<T>>): void;
+    setLoaded(loadedValue: Array<T>): void;
     /**
      * Runs get preloaded.
      * @returns {boolean} - Whether relationship is preloaded.
@@ -82,35 +101,41 @@ export class FrontendModelHasManyRelationship<S extends FrontendModelClass, T ex
     getPreloaded(): boolean;
     /**
      * Runs loaded.
-     * @returns {Array<InstanceType<T>>} - Loaded relationship values.
+     * @returns {Array<T>} - Loaded relationship values.
      */
-    loaded(): Array<InstanceType<T>>;
+    loaded(): Array<T>;
+    /**
+     * Copies loaded value from another has-many relationship helper.
+     * @param {FrontendModelRelationship} sourceRelationship - Source relationship helper.
+     * @returns {void}
+     */
+    copyLoadedFrom(sourceRelationship: FrontendModelRelationship): void;
     /**
      * Runs add to loaded.
-     * @param {Array<InstanceType<T>>} models - Models to append.
+     * @param {Array<T>} models - Models to append.
      * @returns {void}
      */
-    addToLoaded(models: Array<InstanceType<T>>): void;
+    addToLoaded(models: Array<T>): void;
     /**
      * Runs build.
-     * @param {Record<string, ?>} [attributes] - New model attributes.
-     * @returns {InstanceType<T>} - Built model.
+     * @param {TargetCreateAttributes} [attributes] - New model attributes.
+     * @returns {T} - Built model.
      */
-    build(attributes?: Record<string, unknown>): InstanceType<T>;
+    build(attributes?: TargetCreateAttributes): T;
     /**
      * Force-reload the relationship. When the parent record was loaded as part
      * of a batch, siblings that have not preloaded this relationship get
      * batched into one request via the cohort preloader. The scoped query path
      * (`Model.where(...).preload([name]).toArray()` directly from user code)
      * bypasses cohort batching by design.
-     * @returns {Promise<Array<InstanceType<T>>>} - Loaded relationship models.
+     * @returns {Promise<Array<T>>} - Loaded relationship models.
      */
-    load(): Promise<Array<InstanceType<T>>>;
+    load(): Promise<Array<T>>;
     /**
      * Runs to array.
-     * @returns {Promise<Array<InstanceType<T>>>} - Loaded relationship models.
+     * @returns {Promise<Array<T>>} - Loaded relationship models.
      */
-    toArray(): Promise<Array<InstanceType<T>>>;
+    toArray(): Promise<Array<T>>;
 }
 /**
  * Downloaded frontend-model attachment payload wrapper.
@@ -190,7 +215,7 @@ export class FrontendModelAttachmentHandle {
      * @type {FrontendModelAttachmentInput[]}
      */
     pendingInputs: FrontendModelAttachmentInput[];
-    model: FrontendModelBase;
+    model: FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>;
     attachmentName: string;
     /**
      * Queue attachment input for the parent model's next save.
@@ -234,8 +259,13 @@ export class FrontendModelAttachmentHandle {
      */
     downloadUrl(): string;
 }
-/** Base class for generated frontend model classes. */
-export default class FrontendModelBase {
+/**
+ * Base frontend model.
+ * @template {Record<string, FrontendModelAttributeValue>} [Attributes=Record<string, FrontendModelAttributeValue>]
+ * @template {Record<string, FrontendModelAttributeValue>} [CreateAttributes=Record<string, FrontendModelAttributeValue>]
+ * @template {Record<string, FrontendModelAttributeValue>} [UpdateAttributes=Record<string, FrontendModelAttributeValue>]
+ */
+export default class FrontendModelBase<Attributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>, CreateAttributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>, UpdateAttributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>> {
     /**
      * Narrows the runtime value to the documented type.
       @type {string | undefined} */
@@ -261,7 +291,7 @@ export default class FrontendModelBase {
      * @this {FrontendModelClass}
      * @returns {void} - Ensures attachment helper methods exist on the prototype.
      */
-    static ensureGeneratedAttachmentMethods(this: FrontendModelClass): void;
+    static ensureGeneratedAttachmentMethods(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): void;
     /**
      * Runs resource config.
      * @returns {FrontendModelResourceConfig} - Resource configuration.
@@ -272,7 +302,7 @@ export default class FrontendModelBase {
      * @this {FrontendModelClass}
      * @returns {Record<string, FrontendModelClass | string>} - Relationship model classes (or class name strings) keyed by relationship name.
      */
-    static relationshipModelClasses(this: FrontendModelClass): Record<string, FrontendModelClass | string>;
+    static relationshipModelClasses(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): Record<string, FrontendModelClass | string>;
     /**
      * Register a frontend model class so it can be resolved by name in relationship lookups.
      * @param {FrontendModelClass} modelClass - Model class to register.
@@ -298,7 +328,7 @@ export default class FrontendModelBase {
      * @this {FrontendModelClass}
      * @returns {Record<string, {type: "belongsTo" | "hasOne" | "hasMany", autoload?: boolean}>} - Relationship definitions keyed by relationship name.
      */
-    static relationshipDefinitions(this: FrontendModelClass): Record<string, {
+    static relationshipDefinitions(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): Record<string, {
         type: "belongsTo" | "hasOne" | "hasMany";
         autoload?: boolean;
     }>;
@@ -307,21 +337,21 @@ export default class FrontendModelBase {
      * @this {FrontendModelClass}
      * @returns {Record<string, FrontendModelAttachmentDefinition>} - Attachment definitions keyed by attachment name.
      */
-    static attachmentDefinitions(this: FrontendModelClass): Record<string, FrontendModelAttachmentDefinition>;
+    static attachmentDefinitions(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): Record<string, FrontendModelAttachmentDefinition>;
     /**
      * Runs attachment definition.
      * @this {FrontendModelClass}
      * @param {string} attachmentName - Attachment name.
      * @returns {FrontendModelAttachmentDefinition | null} - Attachment definition.
      */
-    static attachmentDefinition(this: FrontendModelClass, attachmentName: string): FrontendModelAttachmentDefinition | null;
+    static attachmentDefinition(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, attachmentName: string): FrontendModelAttachmentDefinition | null;
     /**
      * Runs relationship definition.
      * @this {FrontendModelClass}
      * @param {string} relationshipName - Relationship name.
      * @returns {{type: "belongsTo" | "hasOne" | "hasMany", autoload?: boolean} | null} - Relationship definition.
      */
-    static relationshipDefinition(this: FrontendModelClass, relationshipName: string): {
+    static relationshipDefinition(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, relationshipName: string): {
         type: "belongsTo" | "hasOne" | "hasMany";
         autoload?: boolean;
     } | null;
@@ -331,40 +361,40 @@ export default class FrontendModelBase {
      * @param {string} attributeName - Candidate attribute name, such as `tasksAttributes`.
      * @returns {string | null} Relationship name when nested attributes are configured.
      */
-    static nestedAttributesRelationshipName(this: FrontendModelClass, attributeName: string): string | null;
+    static nestedAttributesRelationshipName(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, attributeName: string): string | null;
     /**
      * Runs relationship model class.
      * @this {FrontendModelClass}
      * @param {string} relationshipName - Relationship name.
      * @returns {FrontendModelClass | null} - Target relationship model class.
      */
-    static relationshipModelClass(this: FrontendModelClass, relationshipName: string): FrontendModelClass | null;
+    static relationshipModelClass(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, relationshipName: string): FrontendModelClass | null;
     /**
      * Runs primary key.
      * @this {FrontendModelClass}
      * @returns {string} - Primary key name.
      */
-    static primaryKey(this: FrontendModelClass): string;
+    static primaryKey(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): string;
     /**
      * Runs resource path.
      * @this {FrontendModelClass}
      * @returns {string} - Derived resource path.
      */
-    static resourcePath(this: FrontendModelClass): string;
+    static resourcePath(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): string;
     /**
      * Runs command name.
      * @this {FrontendModelClass}
      * @param {FrontendModelCommandType} commandType - Command type.
      * @returns {string} - Resolved command name.
      */
-    static commandName(this: FrontendModelClass, commandType: FrontendModelCommandType): string;
+    static commandName(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, commandType: FrontendModelCommandType): string;
     /**
      * Runs normalize custom command payload arguments.
      * @this {FrontendModelClass}
      * @param {Array<?>} args - Command arguments.
      * @returns {Record<string, ?>} - Command payload.
      */
-    static normalizeCustomCommandPayloadArguments(this: FrontendModelClass, args: Array<unknown>): Record<string, unknown>;
+    static normalizeCustomCommandPayloadArguments(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, args: Array<unknown>): Record<string, unknown>;
     /**
      * Returns the model name, preferring an explicit `static modelName` declaration
      * over the JavaScript class `.name` property. This allows minified builds to
@@ -372,7 +402,7 @@ export default class FrontendModelBase {
      * @this {FrontendModelClass}
      * @returns {string} - The model name.
      */
-    static getModelName(this: FrontendModelClass): string;
+    static getModelName(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): string;
     /**
      * Runs configure transport.
      * @param {FrontendModelTransportConfig} config - Frontend model transport configuration.
@@ -484,21 +514,21 @@ export default class FrontendModelBase {
      * Runs attributes from response.
      * @this {FrontendModelClass}
      * @param {object} response - Response payload.
-     * @returns {Record<string, ?>} - Attributes from payload.
+     * @returns {Record<string, FrontendModelAttributeValue>} - Attributes from payload.
      */
-    static attributesFromResponse(this: FrontendModelClass, response: object): Record<string, unknown>;
+    static attributesFromResponse(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, response: object): Record<string, FrontendModelAttributeValue>;
     /**
      * Runs model data from response.
      * @this {FrontendModelClass}
      * @param {object} response - Response payload.
-     * @returns {{abilities: Record<string, boolean>, attributes: Record<string, ?>, associationCounts: Record<string, number>, queryData: Record<string, ?>, preloadedRelationships: Record<string, ?>, selectedAttributes: Set<string>}} - Attributes, preloaded relationships, association counts, queryData, abilities, and the selected-attributes set.
+     * @returns {{abilities: Record<string, boolean>, attributes: Record<string, FrontendModelAttributeValue>, associationCounts: Record<string, number>, queryData: Record<string, FrontendModelAttributeValue>, preloadedRelationships: Record<string, FrontendModelAttributeValue>, selectedAttributes: Set<string>}} - Attributes, preloaded relationships, association counts, queryData, abilities, and the selected-attributes set.
      */
-    static modelDataFromResponse(this: FrontendModelClass, response: object): {
+    static modelDataFromResponse(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, response: object): {
         abilities: Record<string, boolean>;
-        attributes: Record<string, unknown>;
+        attributes: Record<string, FrontendModelAttributeValue>;
         associationCounts: Record<string, number>;
-        queryData: Record<string, unknown>;
-        preloadedRelationships: Record<string, unknown>;
+        queryData: Record<string, FrontendModelAttributeValue>;
+        preloadedRelationships: Record<string, FrontendModelAttributeValue>;
         selectedAttributes: Set<string>;
     };
     /**
@@ -508,7 +538,7 @@ export default class FrontendModelBase {
      * @param {Record<string, ?>} preloadedRelationships - Preloaded relationship payload.
      * @returns {void}
      */
-    static applyPreloadedRelationships(this: FrontendModelClass, model: FrontendModelBase, preloadedRelationships: Record<string, unknown>): void;
+    static applyPreloadedRelationships(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, model: FrontendModelBase, preloadedRelationships: Record<string, unknown>): void;
     /**
      * Runs instantiate relationship value.
      * @this {FrontendModelClass}
@@ -516,7 +546,7 @@ export default class FrontendModelBase {
      * @param {FrontendModelClass | null} targetModelClass - Target model class.
      * @returns {?} - Instantiated relationship value.
      */
-    static instantiateRelationshipValue(this: FrontendModelClass, relationshipPayload: unknown, targetModelClass: FrontendModelClass | null): unknown;
+    static instantiateRelationshipValue(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, relationshipPayload: unknown, targetModelClass: FrontendModelClass | null): unknown;
     /**
      * Runs instantiate from response.
      * @template {FrontendModelClass} T
@@ -636,7 +666,7 @@ export default class FrontendModelBase {
      * @param {import("./query.js").FrontendModelEventOptions} [options] - Event query or record projection options.
      * @returns {Promise<() => void>} - Unsubscribe callback.
      */
-    static onCreate(this: FrontendModelClass, callback: (payload: {
+    static onCreate(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, callback: (payload: {
         id: string;
         model: FrontendModelBase;
     }) => void, options?: import("./query.js").FrontendModelEventOptions): Promise<() => void>;
@@ -647,7 +677,7 @@ export default class FrontendModelBase {
      * @param {import("./query.js").FrontendModelEventOptions} [options] - Event query or record projection options.
      * @returns {Promise<() => void>} - Unsubscribe callback.
      */
-    static onUpdate(this: FrontendModelClass, callback: (payload: {
+    static onUpdate(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, callback: (payload: {
         id: string;
         model: FrontendModelBase;
     }) => void, options?: import("./query.js").FrontendModelEventOptions): Promise<() => void>;
@@ -658,7 +688,7 @@ export default class FrontendModelBase {
      * @param {import("./query.js").FrontendModelEventOptions} [options] - Accepted for API symmetry; destroy events carry ids only.
      * @returns {Promise<() => void>} - Unsubscribe callback.
      */
-    static onDestroy(this: FrontendModelClass, callback: (payload: {
+    static onDestroy(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, callback: (payload: {
         id: string;
     }) => void, options?: import("./query.js").FrontendModelEventOptions): Promise<() => void>;
     /**
@@ -784,19 +814,21 @@ export default class FrontendModelBase {
     static findOrCreateBy<T extends FrontendModelClass>(this: T, conditions: Record<string, unknown>, callback?: (model: InstanceType<T>) => Promise<void> | void): Promise<InstanceType<T>>;
     /**
      * Runs create.
-     * @template {FrontendModelClass} T
-     * @this {T}
-     * @param {Record<string, ?>} [attributes] - Initial attributes.
-     * @returns {Promise<InstanceType<T>>} - Persisted model.
+     * @template {FrontendModelBase} Model
+     * @template {Record<string, FrontendModelAttributeValue>} ModelAttributes
+     * @template {Record<string, FrontendModelAttributeValue>} ModelCreateAttributes
+     * @this {FrontendModelClass<Model, ModelAttributes, ModelCreateAttributes>}
+     * @param {ModelCreateAttributes} [attributes] - Initial attributes.
+     * @returns {Promise<Model>} - Persisted model.
      */
-    static create<T extends FrontendModelClass>(this: T, attributes?: Record<string, unknown>): Promise<InstanceType<T>>;
+    static create<Model extends FrontendModelBase, ModelAttributes extends Record<string, FrontendModelAttributeValue>, ModelCreateAttributes extends Record<string, FrontendModelAttributeValue>>(this: FrontendModelClass<Model, ModelAttributes, ModelCreateAttributes>, attributes?: ModelCreateAttributes): Promise<Model>;
     /**
      * Runs assert find by conditions.
      * @this {FrontendModelClass}
      * @param {Record<string, ?>} conditions - findBy conditions.
      * @returns {void}
      */
-    static assertFindByConditions(this: FrontendModelClass, conditions: Record<string, unknown>): void;
+    static assertFindByConditions(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, conditions: Record<string, unknown>): void;
     /**
      * Runs matches find by conditions.
      * @this {FrontendModelClass}
@@ -804,7 +836,7 @@ export default class FrontendModelBase {
      * @param {Record<string, ?>} conditions - Match conditions.
      * @returns {boolean} - Whether the model matches all conditions.
      */
-    static matchesFindByConditions(this: FrontendModelClass, model: FrontendModelBase, conditions: Record<string, unknown>): boolean;
+    static matchesFindByConditions(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, model: FrontendModelBase, conditions: Record<string, unknown>): boolean;
     /**
      * Runs find by condition value matches.
      * @this {FrontendModelClass}
@@ -812,7 +844,7 @@ export default class FrontendModelBase {
      * @param {?} expectedValue - Expected find condition value.
      * @returns {boolean} - Whether values match.
      */
-    static findByConditionValueMatches(this: FrontendModelClass, actualValue: unknown, expectedValue: unknown): boolean;
+    static findByConditionValueMatches(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, actualValue: unknown, expectedValue: unknown): boolean;
     /**
      * Runs find by primitive values match.
      * @this {FrontendModelClass}
@@ -820,7 +852,7 @@ export default class FrontendModelBase {
      * @param {?} expectedValue - Expected find condition value.
      * @returns {boolean} - Whether primitive values match after safe coercion.
      */
-    static findByPrimitiveValuesMatch(this: FrontendModelClass, actualValue: unknown, expectedValue: unknown): boolean;
+    static findByPrimitiveValuesMatch(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, actualValue: unknown, expectedValue: unknown): boolean;
     /**
      * Runs find by numeric string matches number.
      * @this {FrontendModelClass}
@@ -828,7 +860,7 @@ export default class FrontendModelBase {
      * @param {number} expectedNumber - Number value.
      * @returns {boolean} - Whether values represent the same number.
      */
-    static findByNumericStringMatchesNumber(this: FrontendModelClass, numericString: string, expectedNumber: number): boolean;
+    static findByNumericStringMatchesNumber(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, numericString: string, expectedNumber: number): boolean;
     /**
      * Runs execute command.
      * @this {FrontendModelClass}
@@ -836,7 +868,7 @@ export default class FrontendModelBase {
      * @param {Record<string, ?>} payload - Command payload.
      * @returns {Promise<Record<string, ?>>} - Parsed JSON response.
      */
-    static executeCommand(this: FrontendModelClass, commandType: FrontendModelCommandType, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    static executeCommand(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, commandType: FrontendModelCommandType, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
     /**
      * Runs execute custom command.
      * @this {FrontendModelClass}
@@ -848,7 +880,7 @@ export default class FrontendModelBase {
      * @param {string} args.resourcePath - Direct resource path.
      * @returns {Promise<Record<string, ?>>} - Decoded response payload.
      */
-    static executeCustomCommand(this: FrontendModelClass, { commandName, commandType, memberId, payload, resourcePath }: {
+    static executeCustomCommand(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, { commandName, commandType, memberId, payload, resourcePath }: {
         commandName: string;
         commandType: FrontendModelRequestCommandType;
         memberId?: string | number | null | undefined;
@@ -863,7 +895,7 @@ export default class FrontendModelBase {
      * @param {Record<string, ?>} args.response - Decoded response.
      * @returns {void}
      */
-    static throwOnErrorFrontendModelResponse(this: FrontendModelClass, { commandType, response }: {
+    static throwOnErrorFrontendModelResponse(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, { commandType, response }: {
         commandType: FrontendModelRequestCommandType;
         response: Record<string, unknown>;
     }): void;
@@ -872,20 +904,20 @@ export default class FrontendModelBase {
      * @this {FrontendModelClass}
      * @returns {Set<string>} - Configured frontend model attribute names.
      */
-    static configuredFrontendModelAttributeNames(this: FrontendModelClass): Set<string>;
+    static configuredFrontendModelAttributeNames(this: FrontendModelClass<FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>): Set<string>;
     /**
      * Runs constructor.
-     * @param {Record<string, ?>} [attributes] - Initial attributes.
+     * @param {Attributes | CreateAttributes} [attributes] - Initial attributes.
      */
-    constructor(attributes?: Record<string, unknown>);
+    constructor(attributes?: Attributes | CreateAttributes);
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, ?>} */
-    _attributes: Record<string, unknown>;
+      @type {Record<string, FrontendModelAttributeValue>} */
+    _attributes: Record<string, FrontendModelAttributeValue>;
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, FrontendModelHasManyRelationship<FrontendModelClass, FrontendModelClass> | FrontendModelSingularRelationship<FrontendModelClass, FrontendModelClass>>} */
-    _relationships: Record<string, FrontendModelHasManyRelationship<FrontendModelClass, FrontendModelClass> | FrontendModelSingularRelationship<FrontendModelClass, FrontendModelClass>>;
+      @type {Record<string, FrontendModelHasManyRelationship<FrontendModelBase, FrontendModelBase, Record<string, FrontendModelAttributeValue>> | FrontendModelSingularRelationship<FrontendModelBase, FrontendModelBase, Record<string, FrontendModelAttributeValue>>>} */
+    _relationships: Record<string, FrontendModelHasManyRelationship<FrontendModelBase, FrontendModelBase, Record<string, FrontendModelAttributeValue>> | FrontendModelSingularRelationship<FrontendModelBase, FrontendModelBase, Record<string, FrontendModelAttributeValue>>>;
     /**
      * Narrows the runtime value to the documented type.
       @type {Record<string, FrontendModelAttachmentHandle>} */
@@ -909,8 +941,8 @@ export default class FrontendModelBase {
     _markedForDestruction: boolean;
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, ?>} */
-    _persistedAttributes: Record<string, unknown>;
+      @type {Record<string, FrontendModelAttributeValue>} */
+    _persistedAttributes: Record<string, FrontendModelAttributeValue>;
     /**
      * Narrows the runtime value to the documented type.
      * @type {Array<FrontendModelBase> | undefined} - Shared reference to sibling records loaded in the same batch. Used by auto-batch-preload.
@@ -918,9 +950,9 @@ export default class FrontendModelBase {
     _loadCohort: Array<FrontendModelBase> | undefined;
     /**
      * Runs attributes.
-     * @returns {Record<string, ?>} - Attributes hash.
+     * @returns {Attributes} - Attributes hash.
      */
-    attributes(): Record<string, unknown>;
+    attributes(): Attributes;
     /**
      * Runs is new record.
      * @returns {boolean} - Whether this model has not yet been persisted.
@@ -962,9 +994,9 @@ export default class FrontendModelBase {
     /**
      * Runs get relationship by name.
      * @param {string} relationshipName - Relationship name.
-     * @returns {FrontendModelHasManyRelationship<FrontendModelClass, FrontendModelClass> | FrontendModelSingularRelationship<FrontendModelClass, FrontendModelClass>} - Relationship state object.
+     * @returns {FrontendModelRelationship} - Relationship state object.
      */
-    getRelationshipByName(relationshipName: string): FrontendModelHasManyRelationship<FrontendModelClass, FrontendModelClass> | FrontendModelSingularRelationship<FrontendModelClass, FrontendModelClass>;
+    getRelationshipByName(relationshipName: string): FrontendModelRelationship;
     /**
      * Runs get attachment by name.
      * @param {string} attachmentName - Attachment name.
@@ -974,9 +1006,9 @@ export default class FrontendModelBase {
     /**
      * Runs load relationship.
      * @param {string} relationshipName - Relationship name.
-     * @returns {Promise<?>} - Loaded relationship value.
+     * @returns {Promise<FrontendModelBase | Array<FrontendModelBase> | null>} - Loaded relationship value.
      */
-    loadRelationship(relationshipName: string): Promise<unknown>;
+    loadRelationship(relationshipName: string): Promise<FrontendModelBase | Array<FrontendModelBase> | null>;
     /**
      * Preloads relationship(s) onto this already-loaded record. Accepts either a
      * query built via `Model.preload(...).select(...)` or a raw preload spec
@@ -994,9 +1026,9 @@ export default class FrontendModelBase {
     /**
      * Runs relationship or load.
      * @param {string} relationshipName - Relationship name.
-     * @returns {Promise<?>} - Loaded relationship value.
+     * @returns {Promise<FrontendModelBase | Array<FrontendModelBase> | null>} - Loaded relationship value.
      */
-    relationshipOrLoad(relationshipName: string): Promise<unknown>;
+    relationshipOrLoad(relationshipName: string): Promise<FrontendModelBase | Array<FrontendModelBase> | null>;
     /**
      * Attempts to batch-load `relationshipName` across cohort siblings via a
      * single `preload([name]).where({pk: [ids]}).toArray()` request, then copies
@@ -1012,16 +1044,16 @@ export default class FrontendModelBase {
     /**
      * Runs set relationship.
      * @param {string} relationshipName - Relationship name.
-     * @param {?} relationshipValue - Relationship value.
-     * @returns {?} - Assigned relationship value.
+     * @param {FrontendModelBase | null | undefined} relationshipValue - Relationship value.
+     * @returns {FrontendModelBase | null | undefined} - Assigned relationship value.
      */
-    setRelationship(relationshipName: string, relationshipValue: unknown): unknown;
+    setRelationship(relationshipName: string, relationshipValue: FrontendModelBase | null | undefined): FrontendModelBase | null | undefined;
     /**
      * Runs assign attributes.
-     * @param {Record<string, ?>} attributes - Attributes to assign.
+     * @param {Attributes | CreateAttributes | UpdateAttributes | Record<string, FrontendModelAttributeValue>} attributes - Attributes to assign.
      * @returns {void} - No return value.
      */
-    assignAttributes(attributes: Record<string, unknown>): void;
+    assignAttributes(attributes: Attributes | CreateAttributes | UpdateAttributes | Record<string, FrontendModelAttributeValue>): void;
     /**
      * Runs clear relationship cache.
      * @returns {void} - Clears cached relationship state.
@@ -1148,10 +1180,10 @@ export default class FrontendModelBase {
     }) => void, options?: import("./query.js").FrontendModelEventOptions): Promise<() => void>;
     /**
      * Runs update.
-     * @param {Record<string, ?>} [newAttributes] - New values to assign before update.
+     * @param {UpdateAttributes} [newAttributes] - New values to assign before update.
      * @returns {Promise<this>} - Updated model.
      */
-    update(newAttributes?: Record<string, unknown>): Promise<this>;
+    update(newAttributes?: UpdateAttributes): Promise<this>;
     /**
      * Runs attach.
      * @param {?} attachmentInput - Attachment input or named attachment payload.
@@ -1169,9 +1201,9 @@ export default class FrontendModelBase {
      * fields the caller actually changed — avoiding strict permit rejections on
      * framework-managed fields like `id`, `createdAt`, `updatedAt`, or owner
      * foreign keys that the resource never lists in `permittedParams`.
-     * @returns {Record<string, ?>} - Changed attributes hash.
+     * @returns {Record<string, FrontendModelAttributeValue>} - Changed attributes hash.
      */
-    _changedAttributesForSave(): Record<string, unknown>;
+    _changedAttributesForSave(): Record<string, FrontendModelAttributeValue>;
     /**
      * Marks the current value for an attribute as already persisted so the next
      * save does not send it unless the caller changes it again.
@@ -1247,6 +1279,10 @@ export default class FrontendModelBase {
      */
     _reconcileNestedAttributesFromResponse(response: Record<string, unknown>): void;
 }
+/**
+ * Frontend model relationship helper type.
+ */
+export type FrontendModelRelationship = FrontendModelHasManyRelationship<FrontendModelBase, FrontendModelBase, Record<string, FrontendModelAttributeValue>> | FrontendModelSingularRelationship<FrontendModelBase, FrontendModelBase, Record<string, FrontendModelAttributeValue>>;
 /**
  * Defines this typedef.
  */
@@ -1275,6 +1311,30 @@ export type FrontendModelCommandType = "create" | "find" | "index" | "update" |
  * FrontendModelRequestCommandType type.
  */
 export type FrontendModelRequestCommandType = FrontendModelCommandType | string;
+/**
+ * Model-like instance value supported by frontend-model transport.
+ */
+export type FrontendModelTransportModelValue = {
+    attributes: () => Record<string, unknown>;
+};
+/**
+ * Special scalar values restored by frontend-model transport.
+ */
+export type FrontendModelTransportScalarValue = undefined | null | boolean | number | string | bigint | Date | FrontendModelTransportModelValue;
+/**
+ * Plain object supported by frontend-model transport values.
+ * Nested values are intentionally opaque because TypeScript rejects recursive
+ * JSDoc typedefs for this transport value contract.
+ */
+export type FrontendModelTransportObject = Record<string, unknown>;
+/**
+ * Value supported by frontend-model transport serialization and deserialization.
+ */
+export type FrontendModelTransportValue = FrontendModelTransportScalarValue | FrontendModelTransportObject | Array<unknown>;
+/**
+ * Frontend model attribute value used when generated metadata cannot infer a narrower type.
+ */
+export type FrontendModelAttributeValue = FrontendModelTransportValue;
 /**
  * Defines this typedef.
  */
@@ -1311,13 +1371,16 @@ export type FrontendModelResourceConfig = {
 /**
  * Frontend model constructor type.
  */
-export type FrontendModelConstructor = {
-    new (attributes?: Record<string, unknown>): FrontendModelBase;
+export type FrontendModelConstructor<T extends FrontendModelBase = FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>> = {
+    new (attributes?: Record<string, FrontendModelAttributeValue>): T;
 };
 /**
- * Frontend model static side without generated per-model create overloads.
+ * Frontend model static side.
  */
-export type FrontendModelClass = FrontendModelConstructor & Omit<typeof FrontendModelBase, "create">;
+export type FrontendModelClass<T extends FrontendModelBase = FrontendModelBase<Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>, Record<string, FrontendModelTransportValue>>, Attributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>, CreateAttributes extends Record<string, FrontendModelAttributeValue> = Record<string, FrontendModelTransportValue>> = {
+    new (attributes?: Attributes | CreateAttributes): T;
+    create(attributes?: CreateAttributes): Promise<T>;
+} & Omit<typeof FrontendModelBase, "create">;
 /**
  * FrontendModelTransportConfig type.
  */