@tyravel/database 0.1.0 → 0.2.1

package/dist/eager-loader.d.ts

@@ -0,0 +1,6 @@
+import type { Model } from './model.js';
+import type { ModelStatic } from './model-types.js';
+export declare class EagerLoader {
+    static load(parents: Model[], relations: string[], ModelClass: ModelStatic): Promise<void>;
+}
+//# sourceMappingURL=eager-loader.d.ts.map

package/dist/eager-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager-loader.d.ts","sourceRoot":"","sources":["../src/eager-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,qBAAa,WAAW;WACT,IAAI,CACf,OAAO,EAAE,KAAK,EAAE,EAChB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,IAAI,CAAC;CA2BjB"}

package/dist/eager-loader.js

@@ -0,0 +1,23 @@
+export class EagerLoader {
+    static async load(parents, relations, ModelClass) {
+        if (parents.length === 0 || relations.length === 0) {
+            return;
+        }
+        const instance = new ModelClass();
+        for (const relationName of relations) {
+            const relationMethod = instance[relationName];
+            if (typeof relationMethod !== 'function') {
+                throw new Error(`Relation [${relationName}] not defined on model [${ModelClass.name}].`);
+            }
+            const relation = relationMethod.call(instance);
+            relation.initRelation(parents, relationName);
+            const keys = relation.eagerLoadKeys(parents);
+            if (keys.length === 0) {
+                continue;
+            }
+            const results = await relation.eagerLoad(keys);
+            relation.matchEager(parents, results, relationName);
+        }
+    }
+}
+//# sourceMappingURL=eager-loader.js.map

package/dist/eager-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager-loader.js","sourceRoot":"","sources":["../src/eager-loader.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,WAAW;IACtB,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,OAAgB,EAChB,SAAmB,EACnB,UAAuB;QAEvB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAK,UAA8B,EAAE,CAAC;QAEvD,KAAK,MAAM,YAAY,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,cAAc,GAAI,QAA+C,CAAC,YAAY,CAAC,CAAC;YACtF,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CACb,aAAa,YAAY,2BAA2B,UAAU,CAAC,IAAI,IAAI,CACxE,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAa,CAAC;YAC3D,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAE7C,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/C,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF"}

package/dist/eager-loading.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=eager-loading.test.d.ts.map

package/dist/eager-loading.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager-loading.test.d.ts","sourceRoot":"","sources":["../src/eager-loading.test.ts"],"names":[],"mappings":""}

package/dist/eager-loading.test.js

@@ -0,0 +1,150 @@
+import { beforeAll, describe, expect, it } from 'vitest';
+import { Model } from './model.js';
+import { SqliteConnection } from './sqlite-connection.js';
+class User extends Model {
+    static table = 'users';
+    posts() {
+        return this.hasMany(Post);
+    }
+    latestPost() {
+        return this.hasOne(Post);
+    }
+    roles() {
+        return this.belongsToMany(Role);
+    }
+}
+class Post extends Model {
+    static table = 'posts';
+    user() {
+        return this.belongsTo(User);
+    }
+}
+class Role extends Model {
+    static table = 'roles';
+}
+function trackQueries(connection) {
+    let queryCount = 0;
+    const originalQuery = connection.query.bind(connection);
+    connection.query = async (sql, bindings) => {
+        queryCount++;
+        return originalQuery(sql, bindings);
+    };
+    return {
+        count: () => queryCount,
+    };
+}
+describe('eager loading', () => {
+    const connection = new SqliteConnection(':memory:');
+    beforeAll(async () => {
+        User.useConnection(connection);
+        Post.useConnection(connection);
+        Role.useConnection(connection);
+        await connection.exec(`
+      CREATE TABLE "users" (
+        "id" INTEGER PRIMARY KEY AUTOINCREMENT,
+        "name" TEXT NOT NULL
+      );
+      CREATE TABLE "posts" (
+        "id" INTEGER PRIMARY KEY AUTOINCREMENT,
+        "user_id" INTEGER NOT NULL,
+        "title" TEXT NOT NULL
+      );
+      CREATE TABLE "roles" (
+        "id" INTEGER PRIMARY KEY AUTOINCREMENT,
+        "name" TEXT NOT NULL
+      );
+      CREATE TABLE "user_role" (
+        "user_id" INTEGER NOT NULL,
+        "role_id" INTEGER NOT NULL
+      );
+    `);
+    });
+    it('eager loads hasMany relations without N+1 queries', async () => {
+        const ada = await User.create({ name: 'Ada' });
+        const grace = await User.create({ name: 'Grace' });
+        await Post.create({ user_id: ada.getAttribute('id'), title: 'Ada 1' });
+        await Post.create({ user_id: ada.getAttribute('id'), title: 'Ada 2' });
+        await Post.create({ user_id: grace.getAttribute('id'), title: 'Grace 1' });
+        const tracker = trackQueries(connection);
+        const users = await User.query()
+            .whereIn('id', [ada.getAttribute('id'), grace.getAttribute('id')])
+            .with('posts')
+            .getModels();
+        expect(tracker.count()).toBe(2);
+        expect(users).toHaveLength(2);
+        expect(users.every((user) => user.relationLoaded('posts'))).toBe(true);
+        const adaPosts = users
+            .find((user) => user.getAttribute('name') === 'Ada')
+            ?.getRelation('posts');
+        const gracePosts = users
+            .find((user) => user.getAttribute('name') === 'Grace')
+            ?.getRelation('posts');
+        expect(adaPosts).toHaveLength(2);
+        expect(gracePosts).toHaveLength(1);
+        expect(adaPosts?.map((post) => post.getAttribute('title')).sort()).toEqual([
+            'Ada 1',
+            'Ada 2',
+        ]);
+    });
+    it('eager loads hasOne relations', async () => {
+        const user = await User.create({ name: 'Katherine' });
+        await Post.create({ user_id: user.getAttribute('id'), title: 'Only' });
+        const tracker = trackQueries(connection);
+        const loaded = await User.query()
+            .where('id', user.getAttribute('id'))
+            .with('latestPost')
+            .firstModel();
+        expect(tracker.count()).toBe(2);
+        expect(loaded?.relationLoaded('latestPost')).toBe(true);
+        expect(loaded?.getRelation('latestPost')?.getAttribute('title')).toBe('Only');
+    });
+    it('eager loads belongsTo relations', async () => {
+        const ada = await User.create({ name: 'Ada' });
+        const grace = await User.create({ name: 'Grace' });
+        const adaPost = await Post.create({
+            user_id: ada.getAttribute('id'),
+            title: 'Ada eager post',
+        });
+        const gracePost = await Post.create({
+            user_id: grace.getAttribute('id'),
+            title: 'Grace eager post',
+        });
+        const tracker = trackQueries(connection);
+        const posts = await Post.query()
+            .whereIn('id', [adaPost.getAttribute('id'), gracePost.getAttribute('id')])
+            .with('user')
+            .getModels();
+        expect(tracker.count()).toBe(2);
+        expect(posts).toHaveLength(2);
+        expect(posts.every((post) => post.relationLoaded('user'))).toBe(true);
+        expect(posts
+            .map((post) => post.getRelation('user')?.getAttribute('name'))
+            .sort()).toEqual(['Ada', 'Grace']);
+    });
+    it('eager loads belongsToMany relations', async () => {
+        const user = await User.create({ name: 'Alan' });
+        const admin = await Role.create({ name: 'admin' });
+        const editor = await Role.create({ name: 'editor' });
+        await connection.query('INSERT INTO "user_role" ("user_id", "role_id") VALUES (?, ?), (?, ?)', [
+            user.getAttribute('id'),
+            admin.getAttribute('id'),
+            user.getAttribute('id'),
+            editor.getAttribute('id'),
+        ]);
+        const tracker = trackQueries(connection);
+        const users = await User.query()
+            .where('id', user.getAttribute('id'))
+            .with('roles')
+            .getModels();
+        expect(tracker.count()).toBe(2);
+        expect(users[0]?.relationLoaded('roles')).toBe(true);
+        expect(users[0]?.getRelation('roles')?.map((role) => role.getAttribute('name')).sort()).toEqual([
+            'admin',
+            'editor',
+        ]);
+    });
+    it('throws when eager loading an undefined relation', async () => {
+        await expect(User.with('missing').getModels()).rejects.toThrow('Relation [missing] not defined on model [User].');
+    });
+});
+//# sourceMappingURL=eager-loading.test.js.map

package/dist/eager-loading.test.js.map

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

package/dist/factory-helpers.d.ts

@@ -0,0 +1,7 @@
+export declare function resetFactoryHelpers(): void;
+export declare function fakeSequence(): number;
+export declare function fakeEmail(prefix?: string): string;
+export declare function fakeName(): string;
+export declare function fakeSlug(prefix?: string): string;
+export declare function fakeText(wordCount?: number): string;
+//# sourceMappingURL=factory-helpers.d.ts.map

package/dist/factory-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-helpers.d.ts","sourceRoot":"","sources":["../src/factory-helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,wBAAgB,SAAS,CAAC,MAAM,SAAS,GAAG,MAAM,CAEjD;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAIjC;AAED,wBAAgB,QAAQ,CAAC,MAAM,SAAS,GAAG,MAAM,CAEhD;AAED,wBAAgB,QAAQ,CAAC,SAAS,SAAI,GAAG,MAAM,CAI9C"}

package/dist/factory-helpers.js

@@ -0,0 +1,23 @@
+let sequence = 0;
+export function resetFactoryHelpers() {
+    sequence = 0;
+}
+export function fakeSequence() {
+    sequence += 1;
+    return sequence;
+}
+export function fakeEmail(prefix = 'user') {
+    return `${prefix}.${fakeSequence()}.${Date.now()}@example.com`;
+}
+export function fakeName() {
+    const names = ['Ada', 'Grace', 'Alan', 'Katherine', 'Linus', 'Margaret'];
+    const index = (fakeSequence() - 1) % names.length;
+    return names[index] ?? `User ${fakeSequence()}`;
+}
+export function fakeSlug(prefix = 'item') {
+    return `${prefix}-${fakeSequence()}`;
+}
+export function fakeText(wordCount = 3) {
+    return Array.from({ length: wordCount }, (_, index) => `word${fakeSequence() + index}`).join(' ');
+}
+//# sourceMappingURL=factory-helpers.js.map

package/dist/factory-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-helpers.js","sourceRoot":"","sources":["../src/factory-helpers.ts"],"names":[],"mappings":"AAAA,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB,MAAM,UAAU,mBAAmB;IACjC,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,QAAQ,IAAI,CAAC,CAAC;IACd,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAM,GAAG,MAAM;IACvC,OAAO,GAAG,MAAM,IAAI,YAAY,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAClD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,QAAQ,YAAY,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAM,GAAG,MAAM;IACtC,OAAO,GAAG,MAAM,IAAI,YAAY,EAAE,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,SAAS,GAAG,CAAC;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,IAAI,CAC1F,GAAG,CACJ,CAAC;AACJ,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,12 @@
+import type { Model } from './model.js';
+import type { ModelAttributes } from './model-types.js';
+export declare abstract class Factory<TModel extends Model = Model, TAttributes extends ModelAttributes = ModelAttributes> {
+    protected abstract readonly ModelClass: new (attributes?: Partial<TAttributes>) => TModel;
+    abstract definition(): Partial<TAttributes>;
+    private pendingCount;
+    count(amount: number): this;
+    make(attributes?: Partial<TAttributes>): TModel;
+    makeMany(count: number, attributes?: Partial<TAttributes>): TModel[];
+    create(attributes?: Partial<TAttributes>): Promise<TModel | TModel[]>;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,8BAAsB,OAAO,CAC3B,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,WAAW,SAAS,eAAe,GAAG,eAAe;IAErD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,UAAU,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC;IAE1F,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAE3C,OAAO,CAAC,YAAY,CAAK;IAEzB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK3B,IAAI,CAAC,UAAU,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,MAAM;IAInD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,MAAM,EAAE;IAIlE,MAAM,CAAC,UAAU,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;CAahF"}

package/dist/factory.js

@@ -0,0 +1,25 @@
+export class Factory {
+    pendingCount = 1;
+    count(amount) {
+        this.pendingCount = amount;
+        return this;
+    }
+    make(attributes = {}) {
+        return new this.ModelClass({ ...this.definition(), ...attributes });
+    }
+    makeMany(count, attributes = {}) {
+        return Array.from({ length: count }, () => this.make(attributes));
+    }
+    async create(attributes = {}) {
+        const count = this.pendingCount;
+        this.pendingCount = 1;
+        const models = [];
+        for (let index = 0; index < count; index += 1) {
+            const model = this.make(attributes);
+            await model.save();
+            models.push(model);
+        }
+        return count === 1 ? models[0] : models;
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,OAAO;IAQnB,YAAY,GAAG,CAAC,CAAC;IAEzB,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,aAAmC,EAAE;QACxC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,aAAmC,EAAE;QAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,aAAmC,EAAE;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;CACF"}

package/dist/factory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=factory.test.d.ts.map

package/dist/factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.test.d.ts","sourceRoot":"","sources":["../src/factory.test.ts"],"names":[],"mappings":""}

package/dist/factory.test.js

@@ -0,0 +1,53 @@
+import { afterEach, beforeAll, describe, expect, it } from 'vitest';
+import { fakeEmail, fakeName, resetFactoryHelpers } from './factory-helpers.js';
+import { Factory } from './factory.js';
+import { Model } from './model.js';
+import { SqliteConnection } from './sqlite-connection.js';
+class User extends Model {
+    static table = 'users';
+}
+class UserFactory extends Factory {
+    ModelClass = User;
+    definition() {
+        return {
+            name: fakeName(),
+            email: fakeEmail(),
+        };
+    }
+}
+describe('Factory', () => {
+    const connection = new SqliteConnection(':memory:');
+    const userFactory = new UserFactory();
+    afterEach(() => {
+        resetFactoryHelpers();
+    });
+    beforeAll(async () => {
+        User.useConnection(connection);
+        await connection.exec(`
+      CREATE TABLE "users" (
+        "id" INTEGER PRIMARY KEY AUTOINCREMENT,
+        "name" TEXT NOT NULL,
+        "email" TEXT NOT NULL
+      );
+    `);
+    });
+    it('makes unsaved model instances', () => {
+        const user = userFactory.make({ name: 'Ada' });
+        expect(user.getAttribute('name')).toBe('Ada');
+        expect(user.getAttribute('id')).toBeUndefined();
+    });
+    it('creates persisted models', async () => {
+        const user = (await userFactory.create());
+        expect(user.getAttribute('id')).toBeDefined();
+        expect(user.getAttribute('email')).toContain('@example.com');
+        const found = await User.find(user.getAttribute('id'));
+        expect(found?.getAttribute('name')).toBe(user.getAttribute('name'));
+    });
+    it('creates multiple models with count()', async () => {
+        const users = (await userFactory.count(3).create());
+        expect(users).toHaveLength(3);
+        const emails = users.map((user) => user.getAttribute('email'));
+        expect(new Set(emails).size).toBe(3);
+    });
+});
+//# sourceMappingURL=factory.test.js.map

package/dist/factory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.test.js","sourceRoot":"","sources":["../src/factory.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS1D,MAAM,IAAK,SAAQ,KAAc;IAC/B,MAAM,CAAU,KAAK,GAAG,OAAO,CAAC;;AAGlC,MAAM,WAAY,SAAQ,OAAsB;IAC3B,UAAU,GAAG,IAAI,CAAC;IAErC,UAAU;QACR,OAAO;YACL,IAAI,EAAE,QAAQ,EAAE;YAChB,KAAK,EAAE,SAAS,EAAE;SACnB,CAAC;IACJ,CAAC;CACF;AAED,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,mBAAmB,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC/B,MAAM,UAAU,CAAC,IAAI,CAAC;;;;;;KAMrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,IAAI,GAAG,CAAC,MAAM,WAAW,CAAC,MAAM,EAAE,CAAS,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAE,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,KAAK,GAAG,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAW,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,13 @@
 export type { DatabaseConnection, QueryResult } from './connection.js';
 export { DatabaseManager } from './database-manager.js';
+export { Factory } from './factory.js';
+export { fakeEmail, fakeName, fakeSequence, fakeSlug, fakeText, resetFactoryHelpers, } from './factory-helpers.js';
 export { MysqlGrammar, PostgresGrammar, SqliteGrammar, } from './grammar.js';
 export type { DriverName, SqlGrammar } from './grammar.js';
 export { Migration } from './migration.js';
 export { Migrator } from './migrator.js';
+export { Seeder } from './seeder.js';
+export { SeederRunner } from './seeder-runner.js';
 export { Model } from './model.js';
 export { ModelQueryBuilder } from './model-query-builder.js';
 export { QueryBuilder } from './query-builder.js';
@@ -13,7 +17,7 @@ export { HasManyRelation } from './relations/has-many.js';
 export { HasOneRelation } from './relations/has-one.js';
 export { Relation } from './relations/relation.js';
 export { Blueprint } from './schema/blueprint.js';
-export { SchemaBuilder } from './schema/schema-builder.js';
+export { SchemaBuilder, migrationsTableSql } from './schema/schema-builder.js';
 export type { GlobalScope, LocalScope } from './scopes.js';
 export { MysqlConnection } from './mysql-connection.js';
 export { PostgresConnection } from './postgres-connection.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,GAAG,EACH,QAAQ,EACR,sBAAsB,EACtB,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,GAAG,EACH,QAAQ,EACR,sBAAsB,EACtB,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,7 +1,11 @@
 export { DatabaseManager } from './database-manager.js';
+export { Factory } from './factory.js';
+export { fakeEmail, fakeName, fakeSequence, fakeSlug, fakeText, resetFactoryHelpers, } from './factory-helpers.js';
 export { MysqlGrammar, PostgresGrammar, SqliteGrammar, } from './grammar.js';
 export { Migration } from './migration.js';
 export { Migrator } from './migrator.js';
+export { Seeder } from './seeder.js';
+export { SeederRunner } from './seeder-runner.js';
 export { Model } from './model.js';
 export { ModelQueryBuilder } from './model-query-builder.js';
 export { QueryBuilder } from './query-builder.js';
@@ -11,7 +15,7 @@ export { HasManyRelation } from './relations/has-many.js';
 export { HasOneRelation } from './relations/has-one.js';
 export { Relation } from './relations/relation.js';
 export { Blueprint } from './schema/blueprint.js';
-export { SchemaBuilder } from './schema/schema-builder.js';
+export { SchemaBuilder, migrationsTableSql } from './schema/schema-builder.js';
 export { MysqlConnection } from './mysql-connection.js';
 export { PostgresConnection } from './postgres-connection.js';
 export { SqliteConnection } from './sqlite-connection.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/migrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../src/migrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,UAAU,EAAE,kBAAkB,EAC9B,cAAc,EAAE,MAAM;IAGnC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM5B,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAsBhB,QAAQ;YAOR,WAAW;IAQzB,OAAO,CAAC,KAAK;YAUC,IAAI;YAcJ,MAAM;CAMrB"}
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../src/migrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,UAAU,EAAE,kBAAkB,EAC9B,cAAc,EAAE,MAAM;IAGnC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM5B,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAsBhB,QAAQ;YAQR,WAAW;IAUzB,OAAO,CAAC,KAAK;YAUC,IAAI;YAcJ,MAAM;CAMrB"}

package/dist/migrator.js

@@ -1,7 +1,7 @@
 import { readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { SchemaBuilder } from './schema/schema-builder.js';
+import { migrationsTableSql, SchemaBuilder } from './schema/schema-builder.js';
 export class Migrator {
     connection;
     migrationsPath;
@@ -10,14 +10,7 @@ export class Migrator {
         this.migrationsPath = migrationsPath;
     }
     async ensureMigrationsTable() {
-        await this.connection.exec(`
-      CREATE TABLE IF NOT EXISTS "migrations" (
-        "id" INTEGER PRIMARY KEY AUTOINCREMENT,
-        "migration" TEXT NOT NULL,
-        "batch" INTEGER NOT NULL,
-        "executed_at" TEXT NOT NULL
-      )
-    `);
+        await this.connection.exec(migrationsTableSql(this.connection.grammar));
     }
     async pending() {
         await this.ensureMigrationsTable();
@@ -43,11 +36,14 @@ export class Migrator {
         return ran;
     }
     async executed() {
-        const result = await this.connection.query(`SELECT "migration" FROM "migrations" ORDER BY "id" ASC`);
+        const grammar = this.connection.grammar;
+        const result = await this.connection.query(`SELECT ${grammar.wrapIdentifier('migration')} FROM ${grammar.wrapIdentifier('migrations')} ORDER BY ${grammar.wrapIdentifier('id')} ASC`);
         return result.rows.map((row) => String(row.migration));
     }
     async latestBatch() {
-        const result = await this.connection.query(`SELECT MAX("batch") as "batch" FROM "migrations"`);
+        const grammar = this.connection.grammar;
+        const batchColumn = grammar.wrapIdentifier('batch');
+        const result = await this.connection.query(`SELECT MAX(${batchColumn}) as ${batchColumn} FROM ${grammar.wrapIdentifier('migrations')}`);
         const batch = result.rows[0]?.batch;
         return typeof batch === 'number' ? batch : 0;
     }
@@ -71,7 +67,10 @@ export class Migrator {
         return MigrationClass;
     }
     async record(migration, batch) {
-        await this.connection.query(`INSERT INTO "migrations" ("migration", "batch", "executed_at") VALUES (?, ?, ?)`, [migration, batch, new Date().toISOString()]);
+        const grammar = this.connection.grammar;
+        const table = grammar.wrapIdentifier('migrations');
+        const sql = `INSERT INTO ${table} (${grammar.wrapIdentifier('migration')}, ${grammar.wrapIdentifier('batch')}, ${grammar.wrapIdentifier('executed_at')}) VALUES (${grammar.parameter(1)}, ${grammar.parameter(2)}, ${grammar.parameter(3)})`;
+        await this.connection.query(sql, [migration, batch, new Date().toISOString()]);
     }
 }
 //# sourceMappingURL=migrator.js.map

package/dist/migrator.js.map

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

package/dist/model-query-builder.d.ts

@@ -5,8 +5,11 @@ import type { ModelStatic } from './model-types.js';
 import { type GlobalScope } from './scopes.js';
 export declare class ModelQueryBuilder extends QueryBuilder {
     private readonly model;
+    protected eagerLoad: string[];
     constructor(connection: DatabaseConnection, tableName: string, model: ModelStatic);
+    with(...relations: string[]): this;
     clone(): ModelQueryBuilder;
+    protected copyTo(builder: QueryBuilder): void;
     applyScope(name: string, ...args: unknown[]): this;
     getModels<TModel extends Model>(): Promise<TModel[]>;
     firstModel<TModel extends Model>(): Promise<TModel | null>;

package/dist/model-query-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-query-builder.d.ts","sourceRoot":"","sources":["../src/model-query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAmB,KAAK,WAAW,EAAmB,MAAM,aAAa,CAAC;AAEjF,qBAAa,iBAAkB,SAAQ,YAAY;IAI/C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFtB,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,MAAM,EACA,KAAK,EAAE,WAAW;IAK5B,KAAK,IAAI,iBAAiB;IAUnC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAc5C,SAAS,CAAC,MAAM,SAAS,KAAK,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;IAQpD,UAAU,CAAC,MAAM,SAAS,KAAK,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAIjE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,WAAW,EAAE,GACpB,iBAAiB,CASnB"}
+{"version":3,"file":"model-query-builder.d.ts","sourceRoot":"","sources":["../src/model-query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAmB,KAAK,WAAW,EAAmB,MAAM,aAAa,CAAC;AAEjF,qBAAa,iBAAkB,SAAQ,YAAY;IAM/C,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAM;gBAGjC,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,MAAM,EACA,KAAK,EAAE,WAAW;IAKrC,IAAI,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzB,KAAK,IAAI,iBAAiB;cAUhB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAOtD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAc5C,SAAS,CAAC,MAAM,SAAS,KAAK,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;IAcpD,UAAU,CAAC,MAAM,SAAS,KAAK,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAIjE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,WAAW,EAAE,GACpB,iBAAiB,CASnB"}

package/dist/model-query-builder.js

@@ -1,16 +1,28 @@
+import { EagerLoader } from './eager-loader.js';
 import { QueryBuilder } from './query-builder.js';
 import { scopeMethodName } from './scopes.js';
 export class ModelQueryBuilder extends QueryBuilder {
     model;
+    eagerLoad = [];
     constructor(connection, tableName, model) {
         super(connection, tableName);
         this.model = model;
     }
+    with(...relations) {
+        this.eagerLoad.push(...relations);
+        return this;
+    }
     clone() {
         const builder = new ModelQueryBuilder(this.connection, this.getTableName(), this.model);
         this.copyTo(builder);
         return builder;
     }
+    copyTo(builder) {
+        super.copyTo(builder);
+        if (builder instanceof ModelQueryBuilder) {
+            builder.eagerLoad = [...this.eagerLoad];
+        }
+    }
     applyScope(name, ...args) {
         const scopeName = scopeMethodName(name);
         const scope = this.model[scopeName];
@@ -23,7 +35,11 @@ export class ModelQueryBuilder extends QueryBuilder {
     async getModels() {
         const rows = await this.get();
         const ModelClass = this.model;
-        return rows.map((row) => new ModelClass(row));
+        const models = rows.map((row) => new ModelClass(row));
+        if (this.eagerLoad.length > 0) {
+            await EagerLoader.load(models, this.eagerLoad, this.model);
+        }
+        return models;
     }
     async firstModel() {
         const rows = await this.clone().limit(1).getModels();

package/dist/model-query-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-query-builder.js","sourceRoot":"","sources":["../src/model-query-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAqC,MAAM,aAAa,CAAC;AAEjF,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAI9B;IAHnB,YACE,UAA8B,EAC9B,SAAiB,EACA,KAAkB;QAEnC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAFZ,UAAK,GAAL,KAAK,CAAa;IAGrC,CAAC;IAEQ,KAAK;QACZ,MAAM,OAAO,GAAG,IAAI,iBAAiB,CACnC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,YAAY,EAAE,EACnB,IAAI,CAAC,KAAK,CACX,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,GAAG,IAAe;QACzC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAI,IAAI,CAAC,KAA2D,CAC7E,SAAS,CACV,CAAC;QAEF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,2BAA2B,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QACrD,OAAQ,MAAe,IAAI,IAAI,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAEb,CAAC;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAU,CAAC;QAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAA0B,EAC1B,MAAqB;IAErB,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,GAAG,MAAM,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"model-query-builder.js","sourceRoot":"","sources":["../src/model-query-builder.ts"],"names":[],"mappings":"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"}

package/dist/model.d.ts

@@ -14,6 +14,7 @@ export declare class Model<T extends ModelAttributes = ModelAttributes> {
     private static resolver;
     private static globalScopes;
     protected attributes: Partial<T>;
+    private relations;
     constructor(attributes?: Partial<T>);
     static setConnectionResolver(resolver: () => DatabaseConnection): void;
     static useConnection(connection: DatabaseConnection): void;
@@ -24,11 +25,15 @@ export declare class Model<T extends ModelAttributes = ModelAttributes> {
     static find<TModel extends Model>(this: new (attributes?: Partial<ModelAttributes>) => TModel, id: RowValue): Promise<TModel | null>;
     static all<TModel extends Model>(this: new (attributes?: Partial<ModelAttributes>) => TModel): Promise<TModel[]>;
     static create<TModel extends Model>(this: new (attributes?: Partial<ModelAttributes>) => TModel, attributes: Partial<ModelAttributes>): Promise<TModel>;
+    static with(...relations: string[]): ModelQueryBuilder;
     static where(column: string, operatorOrValue?: RowValue | string, value?: RowValue): ModelQueryBuilder;
     hasMany<Related extends Model>(RelatedModel: ModelStatic, foreignKey?: string, localKey?: string): HasManyRelation<Related>;
     hasOne<Related extends Model>(RelatedModel: ModelStatic, foreignKey?: string, localKey?: string): HasOneRelation<Related>;
     belongsTo<Related extends Model>(RelatedModel: ModelStatic, foreignKey?: string, ownerKey?: string): BelongsToRelation<Related>;
     belongsToMany<Related extends Model>(RelatedModel: ModelStatic, pivotTable?: string, foreignPivotKey?: string, relatedPivotKey?: string, parentKey?: string, relatedKey?: string): BelongsToManyRelation<Related>;
+    setRelation(name: string, value: unknown): void;
+    getRelation<TRelation>(name: string): TRelation | undefined;
+    relationLoaded(name: string): boolean;
     getAttribute<K extends keyof T>(key: K): T[K] | undefined;
     setAttribute<K extends keyof T>(key: K, value: T[K]): void;
     toJSON(): Partial<T>;