@justscale/core 0.1.0

package/dist/models/define-model.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Model Definition
+ *
+ * Creates typed model classes with field schemas.
+ */
+import { type FieldBuilder, type FieldDef, type Decimal } from './field.js';
+import { Reference, References } from './reference/reference.js';
+import { MODEL_METHODS, MODEL_REPO_CONTRACT, PERSISTENT, MODEL_INJECT, MODEL_SERVICE } from './symbols.js';
+import type { Persistent } from './types.js';
+import type { ServiceToken, ResolvedDeps } from '../core/service.js';
+import type { GuardDef } from '../core/middleware.js';
+export { MODEL_METHODS, MODEL_INJECT, MODEL_SERVICE };
+import { StringFieldExpr, NumberFieldExpr, BigIntFieldExpr, DecimalFieldExpr, BooleanFieldExpr, TimestampFieldExpr, RefFieldExpr, RefsFieldExpr, ArrayFieldExpr, JsonFieldExpr, ObjectFieldExpr } from './query.js';
+/** Symbol.for() so separate module realms see the same symbol */
+export declare const MODEL_DEF: unique symbol;
+/**
+ * Stable identity key for a model class. Two classes produced by separate imports
+ * of the same source (e.g. after HMR cache-busting) share the same stable ID, so
+ * `ModelRepository.of(model)` resolves to the same token without special wiring.
+ */
+export declare const MODEL_STABLE_ID: unique symbol;
+export declare const MODEL_FIELDS: unique symbol;
+export declare const MODEL_NAME: unique symbol;
+export declare const MODEL_DATA: unique symbol;
+export declare const MODEL_DEFAULTS: unique symbol;
+/** Forces TypeScript to expand/simplify a type in .d.ts output */
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type FieldDefs = Record<string, FieldBuilder<unknown> | FieldDef>;
+/** Unwrap HasDefault<T> → T, pass-through for other types */
+type UnwrapDefault<T> = T extends {
+    readonly __hasDefault: infer U;
+} ? U : T;
+export type InferModelType<F extends FieldDefs> = Simplify<{
+    [K in keyof F]: F[K] extends FieldBuilder<infer T> ? UnwrapDefault<T> : F[K] extends FieldDef<infer T> ? UnwrapDefault<T> : never;
+}>;
+/** Extract keys of fields that have defaults */
+export type InferDefaultKeys<F extends FieldDefs> = {
+    [K in keyof F]: F[K] extends FieldBuilder<infer T> ? T extends {
+        readonly __hasDefault: unknown;
+    } ? K : never : F[K] extends FieldDef<infer T> ? T extends {
+        readonly __hasDefault: unknown;
+    } ? K : never : never;
+}[keyof F];
+/**
+ * Partial type for model constructor input.
+ * Ref fields accept both Reference<R> and Persistent<R> (the setter handles both).
+ */
+export type DeepPartial<T> = {
+    [K in keyof T]?: [NonNullable<T[K]>] extends [Decimal] ? string | (undefined extends T[K] ? undefined : never) : T[K] extends Reference<any> ? T[K] | (Persistent<any> & {
+        readonly [PERSISTENT]: true;
+    }) : T[K] extends References<any> ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+export type MethodDefs = Record<string, (this: any, ...args: any[]) => any>;
+export type InferMethods<T, M extends MethodDefs> = {
+    [K in keyof M]: M[K] extends (this: unknown, ...args: infer A) => infer R ? (this: T, ...args: A) => R : never;
+};
+/**
+ * Maps a field's TypeScript type to its corresponding field expression type.
+ * For nested objects, recursively creates field expressions for nested access.
+ */
+type ValueToFieldExpr<T> = [
+    NonNullable<T>
+] extends [Reference<infer R>] ? RefFieldExpr<R> : [NonNullable<T>] extends [References<infer R>] ? RefsFieldExpr<R> : [
+    NonNullable<T>
+] extends [Decimal] ? DecimalFieldExpr : [NonNullable<T>] extends [string] ? StringFieldExpr : [NonNullable<T>] extends [number] ? NumberFieldExpr : [NonNullable<T>] extends [bigint] ? BigIntFieldExpr : [NonNullable<T>] extends [boolean] ? BooleanFieldExpr : [NonNullable<T>] extends [Date] ? TimestampFieldExpr : [NonNullable<T>] extends [(infer E)[]] ? ArrayFieldExpr<E> : [NonNullable<T>] extends [Record<string, unknown>] ? ObjectFieldExpr<NonNullable<T>> & NestedFieldExprs<NonNullable<T>> : JsonFieldExpr;
+/**
+ * Creates field expressions for nested object properties.
+ * This enables type-safe access like `User.fields.settings.theme.eq('dark')`.
+ */
+type NestedFieldExprs<T> = T extends Record<string, unknown> ? {
+    readonly [K in keyof T]: ValueToFieldExpr<T[K]>;
+} : {};
+type FieldExprsFromData<T> = {
+    readonly [K in keyof T]: ValueToFieldExpr<T[K]>;
+};
+export type RepositoryContract<T = unknown> = Record<string, (...args: any[]) => Promise<any>>;
+/**
+ * Abstract base class that all models extend.
+ * The class itself represents the transient (unpersisted) form.
+ * Use Persistent<T> for the persisted form with id, createdAt, etc.
+ *
+ * Models are Disposable by default to support `using` declarations
+ * in durable processes (for rehydration marking).
+ */
+export declare abstract class BaseModel<T, N extends string = string, D extends string = never> implements Disposable {
+    readonly [MODEL_DATA]: T;
+    readonly [MODEL_NAME]: N;
+    readonly [MODEL_DEFAULTS]: D;
+    constructor(data: DeepPartial<T>);
+    /** No-op dispose - models use `using` for process rehydration marking, not cleanup */
+    [Symbol.dispose](): void;
+}
+/**
+ * A model class created by defineModel().
+ *
+ * TInject carries the resolved inject deps type - instances include these
+ * properties via prototype chain (the model service).
+ */
+export interface Model<T, N extends string = string, C extends RepositoryContract<T> = {}, D extends string = never, TInject extends Record<string, unknown> = {}> {
+    readonly [MODEL_DEF]: true;
+    readonly [MODEL_DATA]: T;
+    readonly [MODEL_NAME]: N;
+    readonly [MODEL_DEFAULTS]: D;
+    readonly [MODEL_FIELDS]: Record<string, FieldDef>;
+    readonly [MODEL_REPO_CONTRACT]?: C;
+    readonly [MODEL_INJECT]?: Record<string, ServiceToken>;
+    readonly fields: FieldExprsFromData<T>;
+    new (data: DeepPartial<T>): BaseModel<T, N, D> & T & Readonly<TInject>;
+    /**
+     * Reference accessor - polymorphic over `this` so subclass body additions
+     * flow through. `Cart.ref`${id}`` returns `Reference<Cart>` (including any
+     * getters/methods declared on the `Cart` class). For validation at HTTP/CLI
+     * boundaries, use `z.ref(Cart)` instead of the ref as a Zod schema.
+     */
+    ref<I>(this: new (data: DeepPartial<T>) => I, idOrEntity: string | object): Reference<I>;
+    ref<I>(this: new (data: DeepPartial<T>) => I, strings: TemplateStringsArray, ...values: unknown[]): Reference<I>;
+    refs<I>(this: new (data: DeepPartial<T>) => I, ...ids: string[]): References<I>;
+    /**
+     * Create a transient model instance with inject deps available via prototype.
+     * Prefer this over `new Model(data)` when the model has inject deps.
+     */
+    create(data: Omit<DeepPartial<T>, keyof TInject>): BaseModel<T, N, D> & T & Readonly<TInject>;
+    withRepository<Contract extends RepositoryContract<T>>(): Model<T, N, Contract, D, TInject>;
+    /**
+     * Override this model with additional fields.
+     * Returns a new model class with merged fields. Inherits the ref accessor (same cache).
+     * Use for extending framework models: `class AppUser extends User.override({ fields: {...} }) {}`
+     */
+    override<TNew extends FieldDefs>(config: {
+        name?: string;
+        fields: TNew;
+        inject?: Record<string, ServiceToken>;
+    }): Model<T & InferModelType<TNew>, string, {}, D | (InferDefaultKeys<TNew> & string)>;
+}
+export type ModelClass<T, N extends string = string, C extends RepositoryContract<T> = {}> = Model<T, N, C, string, any>;
+export type ModelConstructor<T, N extends string = string, C extends RepositoryContract<T> = {}> = Model<T, N, C, string, any>;
+/**
+ * Extract the data type from a Model class.
+ *
+ * Use this to get clean type references that TypeScript preserves in .d.ts output:
+ * - `ModelData<typeof User>` shows as `ModelData<typeof User>` in hovers
+ * - Instead of `{ readonly email: string; readonly name: string; ... }`
+ *
+ * @example
+ * ```typescript
+ * class User extends defineModel({
+ *   email: field.string(),
+ *   name: field.string(),
+ * }) {}
+ *
+ * type UserData = ModelData<typeof User>
+ * // { readonly email: string; readonly name: string }
+ * ```
+ */
+export type ModelData<M> = M extends {
+    readonly [MODEL_DATA]: infer T;
+} ? T : never;
+/**
+ * Extract the model name from a Model class.
+ *
+ * @example
+ * ```typescript
+ * class User extends defineModel({ ... }) {}
+ * type Name = ModelName<typeof User>  // "User"
+ * ```
+ */
+export type ModelName<M> = M extends {
+    readonly [MODEL_NAME]: infer N extends string;
+} ? N : never;
+/**
+ * Type guard for any Model class.
+ * Use this when you need to accept any model without caring about its specific type.
+ */
+export type AnyModel = Model<unknown, string, RepositoryContract<unknown>, string>;
+/** Register a model class for inject wiring (called by createInMemoryModel/createPgModel) */
+export declare function registerModelForInjection(model: AnyModel): void;
+/** Get all models that need inject wiring */
+export declare function getModelsWithInject(): ReadonlySet<AnyModel>;
+/** A map of action names to guard definitions */
+export type PermissionRecord = Record<string, GuardDef | readonly GuardDef[]>;
+/**
+ * Stamp each permission's `.name` with its key as a string literal.
+ *
+ * `permit(X).always()` returns a def whose `name` is typed as `string` (the
+ * actual name is set at runtime by defineModel from the permissions record
+ * key). This type-level pass narrows `name` to the key literal so permission-
+ * scoped `.returns()` can build a proper discriminated union.
+ */
+export type StampPermissionNames<P extends PermissionRecord> = {
+    readonly [K in keyof P & string]: P[K] extends readonly (infer E)[] ? readonly (E & {
+        readonly name: K;
+    })[] : P[K] & {
+        readonly name: K;
+    };
+};
+/** Factory function that receives field expressions and returns a permissions map */
+export type PermissionsFactory<F extends FieldDefs, P extends PermissionRecord> = (fields: FieldExprsFromData<InferModelType<F>>) => P;
+/**
+ * A single field's access rule.
+ * - GuardDef or GuardDef[]: short form, same for see + set
+ * - []: nobody (fully hidden, not editable)
+ * - { see?, set? }: split form for different read/write
+ */
+export type FieldAccessRule = GuardDef | readonly GuardDef[] | readonly [] | {
+    see?: GuardDef | readonly GuardDef[] | readonly [];
+    set?: GuardDef | readonly GuardDef[] | readonly [];
+};
+/** The resolved access rules stored on a model - field name to rule */
+export type AccessRulesRecord = Record<string, FieldAccessRule>;
+/** Factory function that receives permission defs and returns field access rules */
+export type AccessFactory<F extends FieldDefs, P extends PermissionRecord> = (permissions: P) => Partial<Record<keyof InferModelType<F>, FieldAccessRule>>;
+export declare function defineModel<const F extends FieldDefs, const D extends Record<string, ServiceToken>, const P extends PermissionRecord>(config: {
+    name?: string;
+    fields: F;
+    inject: D;
+    permissions: PermissionsFactory<F, P>;
+    access?: AccessFactory<F, P>;
+}): Model<InferModelType<F>, string, {}, InferDefaultKeys<F> & string, ResolvedDeps<D>> & {
+    readonly can: StampPermissionNames<P>;
+};
+export declare function defineModel<const F extends FieldDefs, const D extends Record<string, ServiceToken>>(config: {
+    name?: string;
+    fields: F;
+    inject: D;
+}): Model<InferModelType<F>, string, {}, InferDefaultKeys<F> & string, ResolvedDeps<D>>;
+export declare function defineModel<const F extends FieldDefs, const P extends PermissionRecord>(config: {
+    name?: string;
+    fields: F;
+    permissions: PermissionsFactory<F, P>;
+    access?: AccessFactory<F, P>;
+}): Model<InferModelType<F>, string, {}, InferDefaultKeys<F> & string> & {
+    readonly can: StampPermissionNames<P>;
+};
+export declare function defineModel<const F extends FieldDefs>(config: {
+    name?: string;
+    fields: F;
+}): Model<InferModelType<F>, string, {}, InferDefaultKeys<F> & string>;
+export declare function defineModel<const F extends FieldDefs>(fields: F): Model<InferModelType<F>, string, {}, InferDefaultKeys<F> & string>;
+export declare function isModelClass(value: unknown): value is Model<unknown>;
+export declare function getModelFields(model: {
+    [MODEL_FIELDS]: Record<string, FieldDef>;
+}): Record<string, FieldDef>;
+export declare function getModelName(model: {
+    [MODEL_NAME]: string;
+}): string;
+export type ModelInstance<M> = M extends Model<infer T> ? T : never;
+//# sourceMappingURL=define-model.d.ts.map

package/dist/models/define-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-model.d.ts","sourceRoot":"","sources":["../../src/models/define-model.ts"],"names":[],"mappings":"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"}

package/dist/models/define-model.js

@@ -0,0 +1,388 @@
+/**
+ * Model Definition
+ *
+ * Creates typed model classes with field schemas.
+ */
+import { FIELD_DEF } from './field.js';
+import { Reference, References, isReference, isReferences } from './reference/reference.js';
+import { FIELD_STORAGE, MODEL_METHODS, MODEL_REPO_CONTRACT, PERSISTENT, ADAPTER_KEY, HYDRATE, MODEL_INJECT, MODEL_SERVICE, ACCESS_RULES, PERMISSION_DEFS } from './symbols.js';
+import { isPersistent } from './types.js';
+export { MODEL_METHODS, MODEL_INJECT, MODEL_SERVICE };
+import { createFieldExpr, } from './query.js';
+// ============================================================================
+// Symbols
+// ============================================================================
+/** Symbol.for() so separate module realms see the same symbol */
+export const MODEL_DEF = Symbol.for('@justscale/core/models:modelDef');
+/**
+ * Stable identity key for a model class. Two classes produced by separate imports
+ * of the same source (e.g. after HMR cache-busting) share the same stable ID, so
+ * `ModelRepository.of(model)` resolves to the same token without special wiring.
+ */
+export const MODEL_STABLE_ID = Symbol.for('@justscale/core/models:modelStableId');
+export const MODEL_FIELDS = Symbol('models:modelFields');
+export const MODEL_NAME = Symbol('models:modelName');
+export const MODEL_DATA = Symbol('models:modelData');
+export const MODEL_DEFAULTS = Symbol('models:modelDefaults');
+// ============================================================================
+// Ref accessor factory
+// ============================================================================
+/**
+ * Create the `Model.ref` callable. References are memoized by ID using
+ * WeakRef so identical IDs round-trip to the same Reference instance (as long
+ * as it hasn't been garbage collected).
+ *
+ * @internal used by defineModel to populate `static ref`
+ */
+function createRefAccessor() {
+    const refCache = new Map();
+    const getOrCreateRef = (id) => {
+        const cached = refCache.get(id);
+        if (cached) {
+            const ref = cached.deref();
+            if (ref)
+                return ref;
+            refCache.delete(id);
+        }
+        const ref = new Reference(id, callable.__modelName);
+        refCache.set(id, new WeakRef(ref));
+        return ref;
+    };
+    const callable = function (idOrStringsOrEntity, ...values) {
+        if (typeof idOrStringsOrEntity === 'object' && 'raw' in idOrStringsOrEntity) {
+            const id = String.raw({ raw: idOrStringsOrEntity }, ...values);
+            return getOrCreateRef(id);
+        }
+        if (isReference(idOrStringsOrEntity)) {
+            const ref = getOrCreateRef(idOrStringsOrEntity.identifier);
+            if (idOrStringsOrEntity.isLoaded) {
+                ref[HYDRATE](idOrStringsOrEntity.value);
+            }
+            return ref;
+        }
+        if (typeof idOrStringsOrEntity === 'object' && idOrStringsOrEntity !== null) {
+            const key = idOrStringsOrEntity[ADAPTER_KEY];
+            if (key !== undefined) {
+                const ref = getOrCreateRef(key);
+                ref[HYDRATE](idOrStringsOrEntity);
+                return ref;
+            }
+            throw new Error('Cannot create Reference from object without adapter key. Is this a persistent entity?');
+        }
+        return getOrCreateRef(idOrStringsOrEntity);
+    };
+    return callable;
+}
+// ============================================================================
+// BaseModel - The base class all models extend
+// ============================================================================
+/**
+ * Abstract base class that all models extend.
+ * The class itself represents the transient (unpersisted) form.
+ * Use Persistent<T> for the persisted form with id, createdAt, etc.
+ *
+ * Models are Disposable by default to support `using` declarations
+ * in durable processes (for rehydration marking).
+ */
+export class BaseModel {
+    constructor(data) {
+        Object.defineProperty(this, FIELD_STORAGE, {
+            value: {},
+            enumerable: false,
+            writable: false,
+        });
+        for (const [key, value] of Object.entries(data)) {
+            this[key] = value;
+        }
+    }
+    /** No-op dispose - models use `using` for process rehydration marking, not cleanup */
+    [Symbol.dispose]() { }
+}
+// ============================================================================
+// Global model registry - models with inject, for Container.wireModelPrototypes
+// ============================================================================
+const modelsWithInject = new Set();
+/** Register a model class for inject wiring (called by createInMemoryModel/createPgModel) */
+export function registerModelForInjection(model) {
+    if (MODEL_INJECT in model) {
+        modelsWithInject.add(model);
+    }
+}
+/** Get all models that need inject wiring */
+export function getModelsWithInject() {
+    return modelsWithInject;
+}
+// ============================================================================
+// defineModel - Creates a model class
+// ============================================================================
+/**
+ * Define a model class.
+ *
+ * @example
+ * ```typescript
+ * // Fields-only form
+ * class User extends defineModel({
+ *   email: field.string().max(255),
+ *   name: field.string().optional(),
+ * }) {}
+ *
+ * // Config form with inject - model instances gain DI services via prototype
+ * class Order extends defineModel({
+ *   fields: {
+ *     amount: field.decimal(10, 2),
+ *     status: field.enum('Status', ['pending', 'paid']),
+ *   },
+ *   inject: {
+ *     payments: PaymentService,
+ *   },
+ * }) {}
+ * ```
+ */
+// ============================================================================
+// Shared helpers - used by defineModel and Model.override()
+// ============================================================================
+/** Build FieldDefs into resolved FieldDef records */
+function buildFieldDefs(fields) {
+    const builtFields = {};
+    for (const [key, fieldOrBuilder] of Object.entries(fields)) {
+        if (FIELD_DEF in fieldOrBuilder) {
+            builtFields[key] = fieldOrBuilder;
+        }
+        else if ('build' in fieldOrBuilder && typeof fieldOrBuilder.build === 'function') {
+            builtFields[key] = fieldOrBuilder.build();
+        }
+        else {
+            throw new Error(`Invalid field definition for "${key}" in model`);
+        }
+    }
+    return builtFields;
+}
+/** Create field expressions from built field definitions */
+function buildFieldExprs(builtFields) {
+    const fieldExprs = {};
+    for (const [key, fieldDef] of Object.entries(builtFields)) {
+        fieldExprs[key] = createFieldExpr(key, fieldDef);
+    }
+    return fieldExprs;
+}
+/** Add ref field getters/setters to a prototype (only for NEW fields, not inherited) */
+function defineRefGetters(proto, builtFields) {
+    for (const [fieldName, fieldDef] of Object.entries(builtFields)) {
+        if (fieldDef.type === 'ref') {
+            Object.defineProperty(proto, fieldName, {
+                get() {
+                    return this[FIELD_STORAGE][fieldName];
+                },
+                set(value) {
+                    if (isReference(value)) {
+                        this[FIELD_STORAGE][fieldName] = value;
+                    }
+                    else if (typeof value === 'string') {
+                        throw new Error(`Cannot assign string to ref field "${fieldName}". Use Model.ref\`id\` instead.`);
+                    }
+                    else if (isPersistent(value)) {
+                        this[FIELD_STORAGE][fieldName] = value;
+                    }
+                    else if (value === null || value === undefined) {
+                        this[FIELD_STORAGE][fieldName] = value;
+                    }
+                    else {
+                        throw new Error(`Invalid value for ref field "${fieldName}".`);
+                    }
+                },
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        else if (fieldDef.type === 'refs') {
+            Object.defineProperty(proto, fieldName, {
+                get() {
+                    return this[FIELD_STORAGE][fieldName];
+                },
+                set(value) {
+                    if (isReferences(value)) {
+                        this[FIELD_STORAGE][fieldName] = value;
+                    }
+                    else if (Array.isArray(value)) {
+                        if (value.length === 0) {
+                            this[FIELD_STORAGE][fieldName] = new References([]);
+                        }
+                        else if (typeof value[0] === 'string') {
+                            throw new Error(`Cannot assign string array to refs field "${fieldName}". Use Model.refs(...ids) instead.`);
+                        }
+                        else if (isPersistent(value[0])) {
+                            this[FIELD_STORAGE][fieldName] = value;
+                        }
+                    }
+                    else if (value === null || value === undefined) {
+                        this[FIELD_STORAGE][fieldName] = value;
+                    }
+                },
+                enumerable: true,
+                configurable: true,
+            });
+        }
+    }
+}
+// Implementation
+// biome-ignore lint/suspicious/noExplicitAny: implementation must accept all overload forms
+export function defineModel(fieldsOrConfig) {
+    // Detect config form: has a `fields` property whose value is NOT a FieldBuilder/FieldDef
+    // (a FieldBuilder has `build`, a FieldDef has FIELD_DEF - if `fields` is one of those,
+    // the user named a field "fields", which is the fields-only form)
+    const configCandidate = fieldsOrConfig;
+    const fieldsValue = configCandidate.fields;
+    const isConfig = fieldsValue !== undefined
+        && typeof fieldsValue === 'object'
+        && fieldsValue !== null
+        && !(FIELD_DEF in fieldsValue)
+        && !('build' in fieldsValue);
+    const fields = isConfig
+        ? fieldsValue
+        : fieldsOrConfig;
+    const inject = isConfig
+        ? configCandidate.inject
+        : undefined;
+    const permissionsFactory = isConfig ? configCandidate.permissions : undefined;
+    const accessFactory = isConfig ? configCandidate.access : undefined;
+    const explicitName = isConfig
+        ? configCandidate.name
+        : undefined;
+    const builtFields = buildFieldDefs(fields);
+    const fieldExprs = buildFieldExprs(builtFields);
+    // Create dual-purpose ref accessor (callable + Zod schema)
+    const refAccessor = createRefAccessor();
+    // The model class - extends BaseModel and adds static properties
+    class ModelImpl extends BaseModel {
+        static [MODEL_DEF] = true;
+        static [MODEL_FIELDS] = builtFields;
+        static fields = fieldExprs;
+        static ref = refAccessor;
+        static get [MODEL_NAME]() {
+            return explicitName ?? this.name;
+        }
+        static get [MODEL_STABLE_ID]() {
+            return `model:${explicitName ?? this.name}`;
+        }
+        static refs(...ids) {
+            return new References(ids);
+        }
+        static withRepository() {
+            return this;
+        }
+        static create(data) {
+            const service = this[MODEL_SERVICE];
+            const proto = service ?? this.prototype;
+            const instance = Object.create(proto);
+            Object.defineProperty(instance, FIELD_STORAGE, { value: {}, enumerable: false, writable: false });
+            for (const [key, value] of Object.entries(data)) {
+                instance[key] = value;
+            }
+            return instance;
+        }
+        /**
+         * Override this model with additional fields.
+         * Returns a new model class that inherits all parent fields + adds new ones.
+         * The ref accessor is inherited (same cache, same identity).
+         */
+        static override(overrideConfig) {
+            const newBuiltFields = buildFieldDefs(overrideConfig.fields);
+            const mergedFields = { ...this[MODEL_FIELDS], ...newBuiltFields };
+            const mergedFieldExprs = buildFieldExprs(mergedFields);
+            const overrideName = overrideConfig.name;
+            const ParentClass = this;
+            class OverrideModelImpl extends ParentClass {
+                static [MODEL_DEF] = true;
+                static [MODEL_FIELDS] = mergedFields;
+                static fields = mergedFieldExprs;
+                // ref is INHERITED from parent - same accessor, same cache
+                static get [MODEL_NAME]() {
+                    return overrideName ?? this.name;
+                }
+                static get [MODEL_STABLE_ID]() {
+                    return `model:${overrideName ?? this.name}`;
+                }
+            }
+            // Add getters/setters for NEW fields only (parent's are inherited via prototype chain)
+            defineRefGetters(OverrideModelImpl.prototype, newBuiltFields);
+            // Merge inject configs
+            if (overrideConfig.inject) {
+                const parentInject = ParentClass[MODEL_INJECT] ?? {};
+                Object.defineProperty(OverrideModelImpl, MODEL_INJECT, {
+                    value: { ...parentInject, ...overrideConfig.inject },
+                    enumerable: false,
+                    configurable: true,
+                    writable: false,
+                });
+            }
+            return OverrideModelImpl;
+        }
+    }
+    // Store inject config on the model class (if provided)
+    if (inject) {
+        Object.defineProperty(ModelImpl, MODEL_INJECT, {
+            value: inject,
+            enumerable: false,
+            configurable: true,
+            writable: false,
+        });
+    }
+    // Call permissions factory with field expressions and attach result as `can`
+    if (permissionsFactory) {
+        const permissionDefs = permissionsFactory(fieldExprs);
+        // Stamp each permission def with its action name (the key from the permissions record)
+        for (const [actionName, def] of Object.entries(permissionDefs)) {
+            if (Array.isArray(def)) {
+                for (const d of def) {
+                    if (d && typeof d === 'object')
+                        d.name = actionName;
+                }
+            }
+            else if (def && typeof def === 'object') {
+                def.name = actionName;
+            }
+        }
+        Object.defineProperty(ModelImpl, 'can', {
+            value: permissionDefs,
+            enumerable: true,
+            configurable: false,
+            writable: false,
+        });
+        // Store the raw permission defs for access rule evaluation
+        Object.defineProperty(ModelImpl, PERMISSION_DEFS, {
+            value: permissionDefs,
+            enumerable: false,
+            configurable: false,
+            writable: false,
+        });
+        // Call access factory with permission defs and store result
+        if (accessFactory) {
+            const accessRules = accessFactory(permissionDefs);
+            Object.defineProperty(ModelImpl, ACCESS_RULES, {
+                value: accessRules,
+                enumerable: false,
+                configurable: false,
+                writable: false,
+            });
+        }
+    }
+    // Add ref/refs field getters/setters
+    defineRefGetters(ModelImpl.prototype, builtFields);
+    return ModelImpl;
+}
+// ============================================================================
+// Type Guards & Helpers
+// ============================================================================
+export function isModelClass(value) {
+    return (value !== null &&
+        typeof value === 'function' &&
+        MODEL_DEF in value &&
+        value[MODEL_DEF] === true);
+}
+export function getModelFields(model) {
+    return model[MODEL_FIELDS];
+}
+export function getModelName(model) {
+    return model[MODEL_NAME];
+}
+//# sourceMappingURL=define-model.js.map