@zintrust/core 0.1.28 → 0.1.29

package/src/orm/Model.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Enhanced Model with Relationships
+ * Full ORM capabilities with eager/lazy loading
+ */
+import type { Paginator } from '../database/Paginator';
+import type { IQueryBuilder, InsertResult, PaginationOptions } from './QueryBuilder';
+import type { IRelationship } from './Relationships';
+export interface ModelConfig {
+    table: string;
+    fillable: string[];
+    hidden: string[];
+    timestamps: boolean;
+    casts: Record<string, string>;
+    softDeletes?: boolean;
+    deleteAtColumn?: string;
+    accessors?: Record<string, (value: unknown, attrs: Record<string, unknown>) => unknown>;
+    mutators?: Record<string, (value: unknown, attrs: Record<string, unknown>) => unknown>;
+    scopes?: Record<string, (builder: IQueryBuilder, ...args: unknown[]) => IQueryBuilder>;
+    observers?: Array<{
+        saving?: (model: IModel) => void | Promise<void>;
+        saved?: (model: IModel) => void | Promise<void>;
+        creating?: (model: IModel) => void | Promise<void>;
+        created?: (model: IModel) => void | Promise<void>;
+        updating?: (model: IModel) => void | Promise<void>;
+        updated?: (model: IModel) => void | Promise<void>;
+        deleting?: (model: IModel) => void | Promise<void>;
+        deleted?: (model: IModel) => void | Promise<void>;
+    }>;
+    connection?: string;
+}
+export interface ModelStatic {
+    query(): IQueryBuilder;
+    getTable?(): string;
+    name?: string;
+    hydrate?(attributes: Record<string, unknown>): IModel;
+}
+export interface IModel {
+    fill(attributes: Record<string, unknown>): IModel;
+    setAttribute(key: string, value: unknown): IModel;
+    getAttribute(key: string): unknown;
+    getAttributes(): Record<string, unknown>;
+    save(): Promise<boolean>;
+    delete(): Promise<boolean>;
+    restore(): Promise<boolean>;
+    forceDelete(): Promise<boolean>;
+    isDeleted(): boolean;
+    toJSON(): Record<string, unknown>;
+    isDirty(key?: string): boolean;
+    getTable(): string;
+    exists(): boolean;
+    setExists(exists: boolean): void;
+    setRelation(name: string, value: unknown): void;
+    getRelation<T>(name: string): T | undefined;
+    hasOne(relatedModel: ModelStatic, foreignKey?: string): IRelationship;
+    hasMany(relatedModel: ModelStatic, foreignKey?: string): IRelationship;
+    belongsTo(relatedModel: ModelStatic, foreignKey?: string): IRelationship;
+    belongsToMany(relatedModel: ModelStatic, throughTable?: string, foreignKey?: string, relatedKey?: string): IRelationship;
+    morphOne(relatedModel: ModelStatic, morphName: string, morphType?: string, morphId?: string, localKey?: string): IRelationship;
+    morphMany(relatedModel: ModelStatic, morphName: string, morphType?: string, morphId?: string, localKey?: string): IRelationship;
+    morphTo(morphName: string, morphMap: Record<string, ModelStatic>, morphType?: string, morphId?: string): IRelationship;
+    hasOneThrough(relatedModel: ModelStatic, through: ModelStatic, foreignKey?: string, throughForeignKey?: string, localKey?: string, secondLocalKey?: string): IRelationship;
+    hasManyThrough(relatedModel: ModelStatic, through: ModelStatic, foreignKey?: string, throughForeignKey?: string, localKey?: string, secondLocalKey?: string): IRelationship;
+}
+/**
+ * Create a new model instance
+ */
+export declare const createModel: (config: ModelConfig, attributes?: Record<string, unknown>) => IModel;
+/**
+ * Get a query builder for a table
+ */
+export declare const query: (table: string, connection?: string) => IQueryBuilder;
+/**
+ * Find a model by ID
+ */
+export declare const find: (config: ModelConfig, id: unknown) => Promise<IModel | null>;
+/**
+ * Get all records for a model
+ */
+export declare const all: (config: ModelConfig) => Promise<IModel[]>;
+type UnboundModelMethods = Record<string, (m: IModel, ...args: unknown[]) => unknown>;
+type BoundModelMethods = Record<string, (...args: never[]) => unknown>;
+type BoundFromUnbound<T extends UnboundModelMethods> = {
+    [K in keyof T]: T[K] extends (m: IModel, ...args: infer A) => infer R ? (...args: A) => R : never;
+};
+export type DefinedModel<T extends BoundModelMethods> = {
+    create: (attributes?: Record<string, unknown> | undefined) => IModel & T;
+    hydrate: (attributes: Record<string, unknown>) => IModel & T;
+    hydrateWithRelations(attributes: Record<string, unknown>, related: Record<string, unknown>): IModel & T;
+    find: (id: unknown) => Promise<(IModel & T) | null>;
+    all: () => Promise<Array<IModel & T>>;
+    raw: () => Promise<Array<Record<string, unknown>>>;
+    query: () => IQueryBuilder;
+    paginate: (page: number, perPage: number, options?: PaginationOptions) => Promise<Paginator<IModel & T>>;
+    where: (column: string, operator: string | number | boolean | null, value?: unknown) => IQueryBuilder;
+    andWhere: (column: string, operator: string, value?: unknown) => IQueryBuilder;
+    orWhere: (column: string, operator: string, value?: unknown) => IQueryBuilder;
+    whereIn: (column: string, values: unknown[]) => IQueryBuilder;
+    whereNotIn: (column: string, values: unknown[]) => IQueryBuilder;
+    select: (...columns: string[]) => IQueryBuilder;
+    selectAs: (column: string, alias: string) => IQueryBuilder;
+    max: (column: string, alias?: string) => IQueryBuilder;
+    join: (table: string, on: string) => IQueryBuilder;
+    leftJoin: (table: string, on: string) => IQueryBuilder;
+    orderBy: (column: string, direction?: 'ASC' | 'DESC') => IQueryBuilder;
+    limit: (count: number) => IQueryBuilder;
+    offset: (count: number) => IQueryBuilder;
+    withTrashed: () => IQueryBuilder;
+    onlyTrashed: () => IQueryBuilder;
+    withoutTrashed: () => IQueryBuilder;
+    scope: (name: string, ...args: unknown[]) => IQueryBuilder;
+    getTable: () => string;
+    db: (connection: string) => DefinedModel<T>;
+};
+/**
+ * Define a new model type
+ */
+export declare function define<const T extends UnboundModelMethods>(config: ModelConfig, methods?: T): DefinedModel<BoundFromUnbound<T>>;
+export declare function define<const T extends BoundModelMethods>(config: ModelConfig, plan: (model: IModel) => T): DefinedModel<T>;
+/**
+ * Model namespace - sealed namespace object grouping all model operations
+ * Frozen to prevent accidental mutation
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export declare const Model: Readonly<{
+    create: (config: ModelConfig, attributes?: Record<string, unknown>) => IModel;
+    query: (table: string, connection?: string) => IQueryBuilder;
+    find: (config: ModelConfig, id: unknown) => Promise<IModel | null>;
+    all: (config: ModelConfig) => Promise<IModel[]>;
+    insert: (config: ModelConfig, values: Record<string, unknown> | Array<Record<string, unknown>>) => Promise<InsertResult>;
+    bulkInsert: (config: ModelConfig, records: Array<Record<string, unknown>>) => Promise<InsertResult>;
+    define: typeof define;
+}>;
+export {};
+//# sourceMappingURL=Model.d.ts.map

package/src/orm/Model.d.ts.map

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

package/src/orm/Model.js

@@ -0,0 +1,533 @@
+/**
+ * Enhanced Model with Relationships
+ * Full ORM capabilities with eager/lazy loading
+ */
+import { DEFAULTS } from '../config/constants.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { useDatabase } from './Database.js';
+import { QueryBuilder } from './QueryBuilder.js';
+import { BelongsTo, BelongsToMany, HasMany, HasManyThrough, HasOne, HasOneThrough, MorphMany, MorphOne, MorphTo, } from './Relationships.js';
+const getRelatedTableName = (relatedModel) => {
+    if (typeof relatedModel.getTable === 'function') {
+        return relatedModel.getTable();
+    }
+    throw ErrorFactory.createConfigError('Related model does not provide a table name');
+};
+/**
+ * Cast attribute value based on config
+ */
+const castAttribute = (config, key, value) => {
+    const castType = config.casts[key];
+    if (castType === undefined)
+        return value;
+    switch (castType) {
+        case 'boolean':
+            return value === true || value === 1 || value === '1';
+        case 'integer':
+            return Number.parseInt(String(value), 10);
+        case 'bigint': {
+            // Native BigInt if supported, otherwise string
+            try {
+                return BigInt(value);
+            }
+            catch {
+                return String(value);
+            }
+        }
+        case 'uuid':
+            return String(value);
+        case 'float':
+            return Number.parseFloat(String(value));
+        case 'date':
+            return new Date(String(value)).toISOString().split('T')[0];
+        case 'datetime':
+            return new Date(String(value)).toISOString();
+        case 'json':
+            return typeof value === 'string' ? JSON.parse(value) : value;
+        default:
+            return value;
+    }
+};
+/**
+ * Fill attributes based on fillable config
+ */
+const fillAttributes = (config, attrs, newAttrs) => {
+    for (const [key, value] of Object.entries(newAttrs)) {
+        if (config.fillable.length === 0 || config.fillable.includes(key)) {
+            const mutator = config.mutators?.[key];
+            const nextValue = mutator ? mutator(value, attrs) : value;
+            attrs[key] = castAttribute(config, key, nextValue);
+        }
+    }
+};
+const applyAccessor = (config, key, attrs) => {
+    const raw = attrs[key];
+    const accessor = config.accessors?.[key];
+    return accessor ? accessor(raw, attrs) : raw;
+};
+const runObservers = async (config, hook, model) => {
+    const observers = config.observers;
+    if (observers === undefined || observers.length === 0)
+        return;
+    for (const observer of observers) {
+        const fn = observer[hook];
+        if (typeof fn === 'function') {
+            // Observers intentionally run sequentially.
+            // eslint-disable-next-line no-await-in-loop
+            await fn(model);
+        }
+    }
+};
+const createModelJSON = (config, attrs) => {
+    const json = {};
+    for (const [key, value] of Object.entries(attrs)) {
+        if (config.hidden.includes(key))
+            continue;
+        // Serialize BigInt as string to keep JSON stable
+        if (typeof value === 'bigint') {
+            json[key] = String(value);
+            continue;
+        }
+        // Convert Dates to ISO strings for JSON
+        if (value instanceof Date) {
+            json[key] = value.toISOString();
+            continue;
+        }
+        json[key] = value;
+    }
+    return json;
+};
+const createHasOneFactory = (config) => (relatedModel, foreignKey) => HasOne.create(relatedModel, foreignKey ?? `${config.table.slice(0, -1)}_id`, 'id');
+const createHasManyFactory = (config) => (relatedModel, foreignKey) => HasMany.create(relatedModel, foreignKey ?? `${config.table.slice(0, -1)}_id`, 'id');
+const createBelongsToFactory = () => (relatedModel, foreignKey) => {
+    const relatedTable = getRelatedTableName(relatedModel);
+    return BelongsTo.create(relatedModel, foreignKey ?? `${relatedTable.slice(0, -1)}_id`, 'id');
+};
+const createBelongsToManyFactory = (config) => (relatedModel, throughTable, foreignKey, relatedKey) => {
+    const relatedTable = getRelatedTableName(relatedModel);
+    const table = throughTable ?? [config.table, relatedTable].sort((a, b) => a.localeCompare(b)).join('_');
+    return BelongsToMany.create(relatedModel, table, foreignKey ?? `${config.table.slice(0, -1)}_id`, relatedKey ?? `${relatedTable.slice(0, -1)}_id`);
+};
+const createMorphOneFactory = () => (relatedModel, morphName, morphType, morphId, localKey) => MorphOne.create(relatedModel, morphName, morphType, morphId, localKey);
+const createMorphManyFactory = () => (relatedModel, morphName, morphType, morphId, localKey) => MorphMany.create(relatedModel, morphName, morphType, morphId, localKey);
+const createMorphToFactory = () => (morphName, morphMap, morphType, morphId) => MorphTo.create(morphName, morphMap, morphType, morphId);
+const createHasOneThroughFactory = () => (relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey) => HasOneThrough.create(relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey);
+const createHasManyThroughFactory = () => (relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey) => HasManyThrough.create(relatedModel, through, foreignKey, throughForeignKey, localKey, secondLocalKey);
+const createModelRelationships = (config) => {
+    return {
+        hasOne: createHasOneFactory(config),
+        hasMany: createHasManyFactory(config),
+        belongsTo: createBelongsToFactory(),
+        belongsToMany: createBelongsToManyFactory(config),
+        morphOne: createMorphOneFactory(),
+        morphMany: createMorphManyFactory(),
+        morphTo: createMorphToFactory(),
+        hasOneThrough: createHasOneThroughFactory(),
+        hasManyThrough: createHasManyThroughFactory(),
+    };
+};
+const performModelSave = async (model, config, attrs, getDb, context) => {
+    const db = getDb();
+    if (db === undefined)
+        throw ErrorFactory.createDatabaseError('Database not initialized');
+    const isCreate = context.isExists === false;
+    await runObservers(config, 'saving', model);
+    await runObservers(config, isCreate ? 'creating' : 'updating', model);
+    if (config.timestamps) {
+        attrs['created_at'] = attrs['created_at'] ?? new Date().toISOString();
+        attrs['updated_at'] = new Date().toISOString();
+    }
+    context.setExists(true);
+    context.updateOriginal({ ...attrs });
+    context.clearDirty();
+    await runObservers(config, isCreate ? 'created' : 'updated', model);
+    await runObservers(config, 'saved', model);
+    return true;
+};
+const performModelDelete = async (model, config, getDb, isExists) => {
+    const db = getDb();
+    if (!isExists || db === undefined)
+        return false;
+    await runObservers(config, 'deleting', model);
+    await runObservers(config, 'deleted', model);
+    return true;
+};
+/**
+ * Create a new model instance
+ */
+// eslint-disable-next-line max-lines-per-function
+export const createModel = (config, attributes = {}) => {
+    const connection = config.connection ?? DEFAULTS.CONNECTION;
+    const getDb = () => useDatabase(undefined, connection);
+    const attrs = {};
+    const relations = {}; // Store eager loaded relations
+    let original = {};
+    let isExists = false;
+    const dirtyFields = new Set();
+    fillAttributes(config, attrs, attributes);
+    original = { ...attrs };
+    const model = {
+        fill: (newAttrs) => {
+            fillAttributes(config, attrs, newAttrs);
+            // Mark all filled fields as dirty
+            for (const key of Object.keys(newAttrs)) {
+                if (attrs[key] !== original[key]) {
+                    dirtyFields.add(key);
+                }
+            }
+            return model;
+        },
+        setAttribute: (key, value) => {
+            const mutator = config.mutators?.[key];
+            const nextValue = mutator ? mutator(value, attrs) : value;
+            const castedValue = castAttribute(config, key, nextValue);
+            attrs[key] = castedValue;
+            // Track dirty field
+            if (original[key] === castedValue) {
+                dirtyFields.delete(key);
+            }
+            else {
+                dirtyFields.add(key);
+            }
+            return model;
+        },
+        getAttribute: (key) => {
+            // Check relations first if it's a relation name
+            if (relations[key] !== undefined)
+                return relations[key];
+            return applyAccessor(config, key, attrs);
+        },
+        getAttributes: () => ({ ...attrs }),
+        // Relationship helpers
+        setRelation: (name, value) => {
+            relations[name] = value;
+        },
+        getRelation: (name) => relations[name],
+        // remove in production - use saveChanges pattern
+        save: async () => performModelSave(model, config, attrs, getDb, {
+            isExists,
+            setExists: (v) => {
+                isExists = v;
+            },
+            updateOriginal: (v) => {
+                original = v;
+            },
+            clearDirty: () => dirtyFields.clear(),
+        }),
+        // remove in production - use delete pattern
+        delete: async () => performModelDelete(model, config, getDb, isExists),
+        // eslint-disable-next-line @typescript-eslint/require-await
+        restore: async () => {
+            if (config.softDeletes !== true || !isExists)
+                return false;
+            const deleteAtColumn = config.deleteAtColumn ?? 'deleted_at';
+            attrs[deleteAtColumn] = null;
+            dirtyFields.add(deleteAtColumn);
+            return true;
+        },
+        forceDelete: async () => {
+            if (!isExists)
+                return false;
+            await runObservers(config, 'deleting', model);
+            await runObservers(config, 'deleted', model);
+            return true;
+        },
+        isDeleted: () => {
+            if (config.softDeletes !== true)
+                return false;
+            const deleteAtColumn = config.deleteAtColumn ?? 'deleted_at';
+            const deletedValue = attrs[deleteAtColumn];
+            return deletedValue !== null && deletedValue !== undefined;
+        },
+        toJSON: () => createModelJSON(config, attrs),
+        isDirty: (key) => {
+            if (key !== undefined) {
+                return dirtyFields.has(key);
+            }
+            return dirtyFields.size > 0;
+        },
+        getTable: () => config.table,
+        exists: () => isExists,
+        setExists: (exists) => {
+            isExists = exists;
+        },
+    };
+    Object.assign(model, createModelRelationships(config));
+    return model;
+};
+/**
+ * Get a query builder for a table
+ */
+export const query = (table, connection) => {
+    const db = useDatabase(undefined, connection ?? DEFAULTS.CONNECTION);
+    return QueryBuilder.create(table, db);
+};
+const buildSoftDeleteOptions = (config) => {
+    if (config.softDeletes !== true)
+        return undefined;
+    return { softDeleteColumn: 'deleted_at', softDeleteMode: 'exclude' };
+};
+/**
+ * Find a model by ID
+ */
+export const find = async (config, id) => {
+    const db = useDatabase(undefined, config.connection ?? DEFAULTS.CONNECTION);
+    const builder = QueryBuilder.create(config.table, db, buildSoftDeleteOptions(config));
+    builder.where('id', '=', String(id)).limit(1);
+    const result = await builder.first();
+    if (result === null)
+        return null;
+    const model = createModel(config, result);
+    model.setExists(true);
+    return model;
+};
+/**
+ * Get all records for a model
+ */
+export const all = async (config) => {
+    const db = useDatabase(undefined, config.connection ?? DEFAULTS.CONNECTION);
+    const builder = QueryBuilder.create(config.table, db, buildSoftDeleteOptions(config));
+    const results = await builder.get();
+    return results.map((result) => {
+        const model = createModel(config, result);
+        model.setExists(true);
+        return model;
+    });
+};
+const bindUnboundMethods = (model, methods) => {
+    const bound = {};
+    for (const [name, method] of Object.entries(methods)) {
+        bound[name] = (...args) => method(model, ...args);
+    }
+    return bound;
+};
+const extendModel = (model, methods) => {
+    const extended = { ...model };
+    for (const [name, method] of Object.entries(methods)) {
+        extended[name] = method;
+    }
+    return extended;
+};
+const isRecord = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+const isRelationship = (value) => {
+    if (!isRecord(value))
+        return false;
+    return 'type' in value && 'get' in value;
+};
+const createModelBuilder = (cfg) => {
+    const db = useDatabase(undefined, cfg.connection ?? DEFAULTS.CONNECTION);
+    return QueryBuilder.create(cfg.table, db, buildSoftDeleteOptions(cfg));
+};
+const createHydrator = (cfg, attach) => {
+    return (attributes) => {
+        const model = createModel(cfg, attributes);
+        model.setExists(true);
+        return attach(model);
+    };
+};
+const createRelationMapping = (cfg, resolveMethods) => {
+    const dummyModel = createModel(cfg);
+    const methods = resolveMethods(dummyModel);
+    const relationMapping = {};
+    for (const [name, fn] of Object.entries(methods)) {
+        try {
+            const result = fn();
+            if (isRelationship(result)) {
+                relationMapping[name] = result;
+            }
+        }
+        catch {
+            // Not a relationship call or requires params
+        }
+    }
+    return relationMapping;
+};
+const hydrateRows = (raw, hydrateModel) => {
+    if (!Array.isArray(raw))
+        return null;
+    const rows = raw.filter((element) => isRecord(element));
+    return rows.map((element) => hydrateModel(element));
+};
+const loadEagerRelations = async (eagerBuilder, models) => {
+    const eagerLoads = typeof eagerBuilder.getEagerLoads === 'function' ? eagerBuilder.getEagerLoads() : undefined;
+    const eagerLoadConstraints = typeof eagerBuilder.getEagerLoadConstraints === 'function'
+        ? eagerBuilder.getEagerLoadConstraints()
+        : undefined;
+    if (!Array.isArray(eagerLoads) ||
+        eagerLoads.length === 0 ||
+        typeof eagerBuilder.load !== 'function' ||
+        models.length === 0) {
+        return;
+    }
+    await Promise.all(eagerLoads.map(async (relation) => {
+        const constraint = eagerLoadConstraints?.[relation];
+        await eagerBuilder.load?.(models, relation, constraint);
+    }));
+};
+const loadEagerCounts = async (eagerBuilder, models) => {
+    const eagerLoadCounts = typeof eagerBuilder.getEagerLoadCounts === 'function'
+        ? eagerBuilder.getEagerLoadCounts()
+        : undefined;
+    if (!Array.isArray(eagerLoadCounts) ||
+        eagerLoadCounts.length === 0 ||
+        typeof eagerBuilder.loadCount !== 'function' ||
+        models.length === 0) {
+        return;
+    }
+    await Promise.all(eagerLoadCounts.map(async (relation) => eagerBuilder.loadCount?.(models, relation)));
+};
+const hydrateAndLoadRelations = async (raw, eagerBuilder, hydrateModel) => {
+    const models = hydrateRows(raw, hydrateModel);
+    if (!models)
+        return raw;
+    await loadEagerRelations(eagerBuilder, models);
+    await loadEagerCounts(eagerBuilder, models);
+    return models;
+};
+const wrapBuilderGetForEagerLoading = (builder, hydrateModel) => {
+    const eagerBuilder = builder;
+    const originalGet = eagerBuilder.get.bind(builder);
+    eagerBuilder.get = async () => {
+        const raw = await originalGet();
+        return hydrateAndLoadRelations(raw, eagerBuilder, hydrateModel);
+    };
+    if (typeof eagerBuilder.paginate === 'function') {
+        const originalPaginate = eagerBuilder.paginate.bind(builder);
+        eagerBuilder.paginate = async (page, perPage, options) => {
+            const result = await originalPaginate(page, perPage, options);
+            if (!Array.isArray(result.items))
+                return result;
+            const models = await hydrateAndLoadRelations(result.items, eagerBuilder, hydrateModel);
+            if (!Array.isArray(models))
+                return result;
+            return {
+                ...result,
+                items: models,
+            };
+        };
+    }
+};
+const createQueryBuilderMethods = (cfg, hydrateModel) => {
+    const wrappedBuilder = () => {
+        const builder = createModelBuilder(cfg);
+        wrapBuilderGetForEagerLoading(builder, hydrateModel);
+        return builder;
+    };
+    return {
+        query: () => wrappedBuilder(),
+        paginate: async (page, perPage, options) => wrappedBuilder().paginate(page, perPage, options),
+        where: (column, operator, value) => wrappedBuilder().where(column, operator, value),
+        andWhere: (column, operator, value) => wrappedBuilder().andWhere(column, operator, value),
+        orWhere: (column, operator, value) => wrappedBuilder().orWhere(column, operator, value),
+        whereIn: (column, values) => wrappedBuilder().whereIn(column, values),
+        whereNotIn: (column, values) => wrappedBuilder().whereNotIn(column, values),
+        select: (...columns) => wrappedBuilder().select(...columns),
+        selectAs: (column, alias) => wrappedBuilder().selectAs(column, alias),
+        max: (column, alias) => wrappedBuilder().max(column, alias),
+        join: (table, on) => wrappedBuilder().join(table, on),
+        leftJoin: (table, on) => wrappedBuilder().leftJoin(table, on),
+        orderBy: (column, direction) => wrappedBuilder().orderBy(column, direction),
+        limit: (count) => wrappedBuilder().limit(count),
+        offset: (count) => wrappedBuilder().offset(count),
+        withTrashed: () => wrappedBuilder().withTrashed(),
+        onlyTrashed: () => wrappedBuilder().onlyTrashed(),
+        withoutTrashed: () => wrappedBuilder().withoutTrashed(),
+        scope: (name, ...args) => {
+            const fn = cfg.scopes?.[name];
+            if (typeof fn !== 'function') {
+                throw ErrorFactory.createConfigError(`Unknown query scope: ${name}`);
+            }
+            const builder = createModelBuilder(cfg);
+            return fn(builder, ...args);
+        },
+        getTable: () => cfg.table,
+    };
+};
+const createDefinedModelInternal = (cfg, methodsOrPlan, attach, resolveMethods) => {
+    const relationMapping = createRelationMapping(cfg, resolveMethods);
+    const hydrateModel = createHydrator(cfg, attach);
+    return {
+        create: (attributes = {}) => attach(createModel(cfg, attributes)),
+        hydrate: (attributes) => hydrateModel(attributes),
+        find: async (id) => {
+            const model = await find(cfg, id);
+            return model === null ? null : attach(model);
+        },
+        all: async () => {
+            const models = await all(cfg);
+            return models.map((m) => attach(m));
+        },
+        raw: async () => {
+            const builder = createModelBuilder(cfg);
+            return builder.get();
+        },
+        ...createQueryBuilderMethods(cfg, hydrateModel),
+        db: (connection) => createDefinedModelInternal({ ...cfg, connection }, methodsOrPlan, attach, resolveMethods),
+        hydrateWithRelations(attributes, related) {
+            const model = hydrateModel(attributes);
+            for (const [name, data] of Object.entries(related)) {
+                const rel = relationMapping[name];
+                if (rel === undefined)
+                    continue;
+                const relatedStatic = rel.related;
+                const hydrate = relatedStatic.hydrate;
+                if (typeof hydrate !== 'function')
+                    continue;
+                if (Array.isArray(data)) {
+                    const relatedModels = data.filter((element) => isRecord(element)).map((d) => hydrate(d));
+                    model.setRelation(name, relatedModels);
+                    continue;
+                }
+                if (data !== null && data !== undefined && isRecord(data)) {
+                    const relatedModel = hydrate(data);
+                    model.setRelation(name, relatedModel);
+                }
+            }
+            return model;
+        },
+    };
+};
+export function define(config, methodsOrPlan) {
+    const plan = typeof methodsOrPlan === 'function' ? methodsOrPlan : undefined;
+    const unboundMethods = typeof methodsOrPlan === 'function' ? undefined : methodsOrPlan;
+    const resolveMethods = (model) => {
+        return plan ? plan(model) : bindUnboundMethods(model, unboundMethods ?? {});
+    };
+    const attach = (model) => {
+        const methods = resolveMethods(model);
+        return extendModel(model, methods);
+    };
+    return createDefinedModelInternal(config, methodsOrPlan, attach, resolveMethods);
+}
+/**
+ * Insert a single or multiple records into the database
+ * Returns insert metadata including ID and affected rows
+ */
+const insert = async (config, values) => {
+    const db = useDatabase(undefined, config.connection ?? DEFAULTS.CONNECTION);
+    const builder = QueryBuilder.create(config.table, db, buildSoftDeleteOptions(config));
+    return builder.insert(values);
+};
+/**
+ * Batch insert multiple records (alias for insert with array)
+ */
+const bulkInsert = async (config, records) => {
+    return insert(config, records);
+};
+/**
+ * Model namespace - sealed namespace object grouping all model operations
+ * Frozen to prevent accidental mutation
+ *
+ * @see FRAMEWORK_REFACTOR_FUNCTION_PATTERN.md for Pattern 2 details
+ */
+export const Model = Object.freeze({
+    create: createModel,
+    query,
+    find,
+    all,
+    insert,
+    bulkInsert,
+    define,
+});