@nestbolt/factory 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Nestbolt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,412 @@
+<p align="center">
+    <h1 align="center">@nestbolt/factory</h1>
+    <p align="center">Model factories and database seeders for NestJS with TypeORM.</p>
+</p>
+
+<p align="center">
+    <a href="https://www.npmjs.com/package/@nestbolt/factory"><img src="https://img.shields.io/npm/v/@nestbolt/factory.svg?style=flat-square" alt="npm version"></a>
+    <a href="https://www.npmjs.com/package/@nestbolt/factory"><img src="https://img.shields.io/npm/dt/@nestbolt/factory.svg?style=flat-square" alt="npm downloads"></a>
+    <a href="https://github.com/nestbolt/factory/actions"><img src="https://img.shields.io/github/actions/workflow/status/nestbolt/factory/tests.yml?branch=main&style=flat-square&label=tests" alt="tests"></a>
+    <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square" alt="license"></a>
+</p>
+
+<hr>
+
+This package provides **model factories and database seeders** for [NestJS](https://nestjs.com) that let you generate fake data for any TypeORM entity with a fluent, chainable API.
+
+Once installed, using it is as simple as:
+
+```typescript
+class UserFactory extends BaseFactory<User> {
+  get entity() { return User; }
+  definition(faker: Faker) {
+    return { name: faker.person.fullName(), email: faker.internet.email() };
+  }
+}
+
+await factoryService.use(UserFactory).count(5).state("admin").create();
+```
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Module Configuration](#module-configuration)
+  - [Static Configuration (forRoot)](#static-configuration-forroot)
+  - [Async Configuration (forRootAsync)](#async-configuration-forrootasync)
+- [Defining Factories](#defining-factories)
+- [Using the Factory Builder](#using-the-factory-builder)
+- [States](#states)
+- [Sequences](#sequences)
+- [Seeders](#seeders)
+- [Events](#events)
+- [Using the Service Directly](#using-the-service-directly)
+- [Configuration Options](#configuration-options)
+- [Testing](#testing)
+- [Changelog](#changelog)
+- [Contributing](#contributing)
+- [Security](#security)
+- [Credits](#credits)
+- [License](#license)
+
+## Installation
+
+Install the package via npm:
+
+```bash
+npm install @nestbolt/factory
+```
+
+Or via yarn:
+
+```bash
+yarn add @nestbolt/factory
+```
+
+Or via pnpm:
+
+```bash
+pnpm add @nestbolt/factory
+```
+
+### Peer Dependencies
+
+This package requires the following peer dependencies, which you likely already have in a NestJS project:
+
+```
+@nestjs/common      ^10.0.0 || ^11.0.0
+@nestjs/core        ^10.0.0 || ^11.0.0
+@nestjs/typeorm     ^10.0.0 || ^11.0.0
+typeorm             ^0.3.0
+reflect-metadata    ^0.1.13 || ^0.2.0
+```
+
+### Included
+
+```
+@faker-js/faker     ^9.0.0   # Bundled — no need to install separately
+```
+
+### Optional
+
+```bash
+npm install @nestjs/event-emitter   # For seeder lifecycle events
+```
+
+## Quick Start
+
+### 1. Define a factory
+
+```typescript
+import { BaseFactory } from "@nestbolt/factory";
+import { Faker } from "@faker-js/faker";
+
+export class UserFactory extends BaseFactory<User> {
+  get entity() { return User; }
+
+  definition(faker: Faker): Partial<User> {
+    return {
+      name: faker.person.fullName(),
+      email: faker.internet.email(),
+      role: "user",
+    };
+  }
+
+  admin(): Partial<User> {
+    return { role: "admin" };
+  }
+}
+```
+
+### 2. Register the module
+
+```typescript
+import { FactoryModule } from "@nestbolt/factory";
+
+@Module({
+  imports: [
+    TypeOrmModule.forRoot({ /* ... */ }),
+    FactoryModule.forRoot({
+      factories: [UserFactory, PostFactory],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 3. Use in your code
+
+```typescript
+import { FactoryService } from "@nestbolt/factory";
+
+@Injectable()
+export class SeedService {
+  constructor(private readonly factory: FactoryService) {}
+
+  async seed() {
+    await this.factory.use(UserFactory).count(10).create();
+    await this.factory.use(UserFactory).state("admin").create();
+  }
+}
+```
+
+## Module Configuration
+
+The module is registered globally — you only need to import it once.
+
+### Static Configuration (forRoot)
+
+```typescript
+FactoryModule.forRoot({
+  factories: [UserFactory, PostFactory],
+  seeders: [DatabaseSeeder],
+  seed: 12345,  // optional: reproducible faker data
+});
+```
+
+### Async Configuration (forRootAsync)
+
+```typescript
+FactoryModule.forRootAsync({
+  imports: [ConfigModule],
+  inject: [ConfigService],
+  useFactory: (config: ConfigService) => ({
+    factories: [UserFactory, PostFactory],
+    seed: config.get("FAKER_SEED"),
+  }),
+});
+```
+
+## Defining Factories
+
+Extend `BaseFactory<T>` and implement the `entity` getter and `definition()` method:
+
+```typescript
+export class PostFactory extends BaseFactory<Post> {
+  get entity() { return Post; }
+
+  definition(faker: Faker): Partial<Post> {
+    return {
+      title: faker.lorem.sentence(),
+      body: faker.lorem.paragraphs(2),
+      status: "draft",
+    };
+  }
+
+  // Optional lifecycle hooks
+  async afterMake(entity: Post, faker: Faker) {
+    // Called after make() — entity is NOT persisted yet
+  }
+
+  async afterCreate(entity: Post, faker: Faker) {
+    // Called after create() — entity IS persisted
+  }
+}
+```
+
+## Using the Factory Builder
+
+The `FactoryBuilder` provides a fluent API for generating entities:
+
+```typescript
+// Make without persisting
+const user = await factoryService.use(UserFactory).make();
+
+// Create and persist to database
+const user = await factoryService.use(UserFactory).create();
+
+// Multiple entities
+const users = await factoryService.use(UserFactory).count(10).create();
+
+// Always get an array (even for count=1)
+const users = await factoryService.use(UserFactory).createMany();
+const users = await factoryService.use(UserFactory).makeMany();
+```
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `count(n)` | `this` | Set number of entities to generate |
+| `state(name \| object \| fn)` | `this` | Apply a state (see States) |
+| `override(attrs)` | `this` | Override specific fields (highest priority) |
+| `sequence(field, seq)` | `this` | Apply a sequence to a field |
+| `afterCreating(fn)` | `this` | Callback after persist |
+| `afterMaking(fn)` | `this` | Callback after instantiation |
+| `create()` | `T \| T[]` | Persist and return |
+| `make()` | `T \| T[]` | Instantiate without persisting |
+| `createMany()` | `T[]` | Persist and always return array |
+| `makeMany()` | `T[]` | Instantiate and always return array |
+
+**Override priority:** `definition()` → `state()` → `sequence()` → `override()` (highest)
+
+## States
+
+States let you define named variations of a factory:
+
+```typescript
+export class UserFactory extends BaseFactory<User> {
+  // ... definition
+
+  admin(): Partial<User> {
+    return { role: "admin" };
+  }
+
+  inactive(): Partial<User> {
+    return { active: false };
+  }
+}
+
+// Usage
+await factoryService.use(UserFactory).state("admin").create();
+await factoryService.use(UserFactory).state("admin").state("inactive").create();
+
+// Object and function states also work
+await factoryService.use(UserFactory).state({ role: "moderator" }).create();
+await factoryService.use(UserFactory).state((faker) => ({ age: faker.number.int({ min: 18, max: 30 }) })).create();
+```
+
+## Sequences
+
+Use `Sequence` for auto-incrementing or cycling values:
+
+```typescript
+import { Sequence } from "@nestbolt/factory";
+
+// Auto-increment
+await factoryService.use(UserFactory)
+  .count(3)
+  .sequence("email", Sequence.from(i => `user${i}@test.com`))
+  .create();
+// → user0@test.com, user1@test.com, user2@test.com
+
+// Increment numbers
+Sequence.increment()       // 1, 2, 3, ...
+Sequence.increment(100)    // 100, 101, 102, ...
+
+// Cycle through values
+Sequence.cycle(["draft", "published", "archived"])
+// → draft, published, archived, draft, ...
+```
+
+## Seeders
+
+Seeders are classes that populate your database with test data:
+
+```typescript
+import { Seeder, FactoryService } from "@nestbolt/factory";
+
+export class DatabaseSeeder implements Seeder {
+  order = 0;  // lower runs first
+
+  async run(factory: FactoryService): Promise<void> {
+    await factory.use(UserFactory).count(10).create();
+    await factory.use(UserFactory).state("admin").count(2).create();
+    await factory.use(PostFactory).count(20).create();
+  }
+}
+```
+
+Register and run seeders:
+
+```typescript
+// Register in module
+FactoryModule.forRoot({
+  factories: [UserFactory, PostFactory],
+  seeders: [DatabaseSeeder],
+});
+
+// Run all seeders (sorted by order)
+await factoryService.seed();
+
+// Run a single seeder
+await factoryService.runSeeder(DatabaseSeeder);
+```
+
+## Events
+
+When `@nestjs/event-emitter` is installed, the package emits:
+
+| Event | Payload | When |
+|-------|---------|------|
+| `factory.seeder.started` | `{ seederClass }` | Before a seeder runs |
+| `factory.seeder.completed` | `{ seederClass }` | After a seeder completes |
+| `factory.seed.all.started` | `{ seederCount }` | Before `seed()` runs all seeders |
+| `factory.seed.all.completed` | `{ seederCount }` | After `seed()` completes all seeders |
+
+```typescript
+import { FACTORY_EVENTS, SeederCompletedEvent } from "@nestbolt/factory";
+import { OnEvent } from "@nestjs/event-emitter";
+
+@OnEvent(FACTORY_EVENTS.SEEDER_COMPLETED)
+handleSeederCompleted(event: SeederCompletedEvent) {
+  console.log(`Seeder ${event.seederClass} completed`);
+}
+```
+
+## Using the Service Directly
+
+Inject `FactoryService` for factory and seeder management:
+
+```typescript
+import { FactoryService } from "@nestbolt/factory";
+
+@Injectable()
+export class SeedService {
+  constructor(private readonly factory: FactoryService) {}
+
+  async seedDatabase() {
+    const users = await this.factory.use(UserFactory).count(10).createMany();
+    const faker = this.factory.getFaker();
+    await this.factory.seed();
+  }
+}
+```
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `use(FactoryClass)` | `FactoryBuilder<T>` | Get builder for a registered factory |
+| `getFaker()` | `Faker` | Get the configured Faker instance |
+| `seed()` | `Promise<void>` | Run all registered seeders (sorted by order) |
+| `runSeeder(SeederClass)` | `Promise<void>` | Run a single seeder |
+| `getOptions()` | `FactoryModuleOptions` | Get module configuration |
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `factories` | `FactoryClass[]` | `[]` | Factory classes to register |
+| `seeders` | `SeederClass[]` | `[]` | Seeder classes to register |
+| `seed` | `number` | `undefined` | Faker seed for reproducible data |
+
+## Testing
+
+```bash
+npm test
+```
+
+Run tests in watch mode:
+
+```bash
+npm run test:watch
+```
+
+Generate coverage report:
+
+```bash
+npm run test:cov
+```
+
+## Changelog
+
+Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
+
+## Contributing
+
+Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
+
+## Security
+
+If you discover any security-related issues, please report them via [GitHub Issues](https://github.com/nestbolt/factory/issues) with the **security** label instead of using the public issue tracker.
+
+## License
+
+The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

package/dist/base-factory.d.ts

@@ -0,0 +1,7 @@
+import type { Faker } from "@faker-js/faker";
+export declare abstract class BaseFactory<T> {
+    abstract get entity(): new () => T;
+    abstract definition(faker: Faker): Partial<T>;
+    afterCreate?(entity: T, faker: Faker): Promise<void>;
+    afterMake?(entity: T, faker: Faker): Promise<void>;
+}

package/dist/base-factory.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseFactory = void 0;
+class BaseFactory {
+}
+exports.BaseFactory = BaseFactory;
+//# sourceMappingURL=base-factory.js.map

package/dist/base-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-factory.js","sourceRoot":"","sources":["../src/base-factory.ts"],"names":[],"mappings":";;;AAEA,MAAsB,WAAW;CAMhC;AAND,kCAMC"}

package/dist/events/factory.events.d.ts

@@ -0,0 +1,18 @@
+export declare const FACTORY_EVENTS: {
+    readonly SEEDER_STARTED: "factory.seeder.started";
+    readonly SEEDER_COMPLETED: "factory.seeder.completed";
+    readonly SEED_ALL_STARTED: "factory.seed.all.started";
+    readonly SEED_ALL_COMPLETED: "factory.seed.all.completed";
+};
+export interface SeederStartedEvent {
+    seederClass: string;
+}
+export interface SeederCompletedEvent {
+    seederClass: string;
+}
+export interface SeedAllStartedEvent {
+    seederCount: number;
+}
+export interface SeedAllCompletedEvent {
+    seederCount: number;
+}

package/dist/events/factory.events.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FACTORY_EVENTS = void 0;
+exports.FACTORY_EVENTS = {
+    SEEDER_STARTED: "factory.seeder.started",
+    SEEDER_COMPLETED: "factory.seeder.completed",
+    SEED_ALL_STARTED: "factory.seed.all.started",
+    SEED_ALL_COMPLETED: "factory.seed.all.completed",
+};
+//# sourceMappingURL=factory.events.js.map

package/dist/events/factory.events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.events.js","sourceRoot":"","sources":["../../src/events/factory.events.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG;IAC5B,cAAc,EAAE,wBAAwB;IACxC,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;IAC5C,kBAAkB,EAAE,4BAA4B;CACxC,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1 @@
+export { FACTORY_EVENTS, type SeederStartedEvent, type SeederCompletedEvent, type SeedAllStartedEvent, type SeedAllCompletedEvent, } from "./factory.events";

package/dist/events/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FACTORY_EVENTS = void 0;
+var factory_events_1 = require("./factory.events");
+Object.defineProperty(exports, "FACTORY_EVENTS", { enumerable: true, get: function () { return factory_events_1.FACTORY_EVENTS; } });
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;AAAA,mDAM0B;AALxB,gHAAA,cAAc,OAAA"}

package/dist/exceptions/factory-not-initialized.exception.d.ts

@@ -0,0 +1,3 @@
+export declare class FactoryNotInitializedException extends Error {
+    constructor();
+}

package/dist/exceptions/factory-not-initialized.exception.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryNotInitializedException = void 0;
+class FactoryNotInitializedException extends Error {
+    constructor() {
+        super("FactoryService has not been initialized. Make sure FactoryModule is imported in your application.");
+        this.name = "FactoryNotInitializedException";
+    }
+}
+exports.FactoryNotInitializedException = FactoryNotInitializedException;
+//# sourceMappingURL=factory-not-initialized.exception.js.map

package/dist/exceptions/factory-not-initialized.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-not-initialized.exception.js","sourceRoot":"","sources":["../../src/exceptions/factory-not-initialized.exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,8BAA+B,SAAQ,KAAK;IACvD;QACE,KAAK,CACH,mGAAmG,CACpG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAPD,wEAOC"}

package/dist/exceptions/factory-not-registered.exception.d.ts

@@ -0,0 +1,3 @@
+export declare class FactoryNotRegisteredException extends Error {
+    constructor(factoryName: string);
+}

package/dist/exceptions/factory-not-registered.exception.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryNotRegisteredException = void 0;
+class FactoryNotRegisteredException extends Error {
+    constructor(factoryName) {
+        super(`Factory "${factoryName}" is not registered. Make sure it is included in the factories array of FactoryModule.forRoot().`);
+        this.name = "FactoryNotRegisteredException";
+    }
+}
+exports.FactoryNotRegisteredException = FactoryNotRegisteredException;
+//# sourceMappingURL=factory-not-registered.exception.js.map

package/dist/exceptions/factory-not-registered.exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-not-registered.exception.js","sourceRoot":"","sources":["../../src/exceptions/factory-not-registered.exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,6BAA8B,SAAQ,KAAK;IACtD,YAAY,WAAmB;QAC7B,KAAK,CACH,YAAY,WAAW,kGAAkG,CAC1H,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAPD,sEAOC"}

package/dist/exceptions/index.d.ts

@@ -0,0 +1,2 @@
+export { FactoryNotInitializedException } from "./factory-not-initialized.exception";
+export { FactoryNotRegisteredException } from "./factory-not-registered.exception";

package/dist/exceptions/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryNotRegisteredException = exports.FactoryNotInitializedException = void 0;
+var factory_not_initialized_exception_1 = require("./factory-not-initialized.exception");
+Object.defineProperty(exports, "FactoryNotInitializedException", { enumerable: true, get: function () { return factory_not_initialized_exception_1.FactoryNotInitializedException; } });
+var factory_not_registered_exception_1 = require("./factory-not-registered.exception");
+Object.defineProperty(exports, "FactoryNotRegisteredException", { enumerable: true, get: function () { return factory_not_registered_exception_1.FactoryNotRegisteredException; } });
+//# sourceMappingURL=index.js.map

package/dist/exceptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":";;;AAAA,yFAAqF;AAA5E,mJAAA,8BAA8B,OAAA;AACvC,uFAAmF;AAA1E,iJAAA,6BAA6B,OAAA"}

package/dist/factory-builder.d.ts

@@ -0,0 +1,28 @@
+import type { Faker } from "@faker-js/faker";
+import type { DataSource } from "typeorm";
+import type { BaseFactory } from "./base-factory";
+import type { Sequence } from "./sequence";
+export declare class FactoryBuilder<T> {
+    private readonly factory;
+    private readonly faker;
+    private readonly dataSource;
+    private _count;
+    private _states;
+    private _overrides;
+    private _sequences;
+    private _afterCreating;
+    private _afterMaking;
+    constructor(factory: BaseFactory<T>, faker: Faker, dataSource: DataSource | null);
+    count(n: number): this;
+    state(stateOrOverrides: string | Partial<T> | ((faker: Faker) => Partial<T>)): this;
+    override(overrides: Partial<T>): this;
+    sequence<K extends keyof T>(field: K, seq: Sequence<T[K]>): this;
+    afterCreating(callback: (entity: T, faker: Faker) => Promise<void>): this;
+    afterMaking(callback: (entity: T, faker: Faker) => Promise<void>): this;
+    make(): Promise<T | T[]>;
+    makeMany(): Promise<T[]>;
+    create(): Promise<T | T[]>;
+    createMany(): Promise<T[]>;
+    private buildMany;
+    private buildOne;
+}

package/dist/factory-builder.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryBuilder = void 0;
+class FactoryBuilder {
+    constructor(factory, faker, dataSource) {
+        this.factory = factory;
+        this.faker = faker;
+        this.dataSource = dataSource;
+        this._count = 1;
+        this._states = [];
+        this._overrides = {};
+        this._sequences = new Map();
+        this._afterCreating = [];
+        this._afterMaking = [];
+    }
+    count(n) {
+        this._count = n;
+        return this;
+    }
+    state(stateOrOverrides) {
+        this._states.push(stateOrOverrides);
+        return this;
+    }
+    override(overrides) {
+        this._overrides = { ...this._overrides, ...overrides };
+        return this;
+    }
+    sequence(field, seq) {
+        this._sequences.set(field, seq);
+        return this;
+    }
+    afterCreating(callback) {
+        this._afterCreating.push(callback);
+        return this;
+    }
+    afterMaking(callback) {
+        this._afterMaking.push(callback);
+        return this;
+    }
+    async make() {
+        const results = await this.buildMany(false);
+        return this._count === 1 ? results[0] : results;
+    }
+    async makeMany() {
+        return this.buildMany(false);
+    }
+    async create() {
+        const results = await this.buildMany(true);
+        return this._count === 1 ? results[0] : results;
+    }
+    async createMany() {
+        return this.buildMany(true);
+    }
+    async buildMany(persist) {
+        const results = [];
+        for (let i = 0; i < this._count; i++) {
+            const entity = await this.buildOne(persist);
+            results.push(entity);
+        }
+        return results;
+    }
+    async buildOne(persist) {
+        let attrs = { ...this.factory.definition(this.faker) };
+        for (const s of this._states) {
+            if (typeof s === "string") {
+                const method = this.factory[s];
+                if (typeof method === "function") {
+                    attrs = { ...attrs, ...method.call(this.factory) };
+                }
+            }
+            else if (typeof s === "function") {
+                attrs = { ...attrs, ...s(this.faker) };
+            }
+            else {
+                attrs = { ...attrs, ...s };
+            }
+        }
+        for (const [field, seq] of this._sequences) {
+            attrs[field] = seq.next();
+        }
+        attrs = { ...attrs, ...this._overrides };
+        const EntityClass = this.factory.entity;
+        const entity = Object.assign(new EntityClass(), attrs);
+        if (this.factory.afterMake) {
+            await this.factory.afterMake(entity, this.faker);
+        }
+        for (const cb of this._afterMaking) {
+            await cb(entity, this.faker);
+        }
+        if (persist) {
+            if (!this.dataSource) {
+                throw new Error("DataSource is not available. Cannot persist entities without a database connection.");
+            }
+            const repo = this.dataSource.getRepository(EntityClass);
+            const saved = await repo.save(entity);
+            Object.assign(entity, saved);
+            if (this.factory.afterCreate) {
+                await this.factory.afterCreate(entity, this.faker);
+            }
+            for (const cb of this._afterCreating) {
+                await cb(entity, this.faker);
+            }
+        }
+        return entity;
+    }
+}
+exports.FactoryBuilder = FactoryBuilder;
+//# sourceMappingURL=factory-builder.js.map

package/dist/factory-builder.js.map

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

package/dist/factory.constants.d.ts

@@ -0,0 +1 @@
+export declare const FACTORY_OPTIONS = "FACTORY_OPTIONS";

package/dist/factory.constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FACTORY_OPTIONS = void 0;
+exports.FACTORY_OPTIONS = "FACTORY_OPTIONS";
+//# sourceMappingURL=factory.constants.js.map

package/dist/factory.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.constants.js","sourceRoot":"","sources":["../src/factory.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/factory.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from "@nestjs/common";
+import type { FactoryModuleOptions, FactoryAsyncOptions } from "./interfaces";
+export declare class FactoryModule {
+    static forRoot(options?: FactoryModuleOptions): DynamicModule;
+    static forRootAsync(asyncOptions: FactoryAsyncOptions): DynamicModule;
+}

package/dist/factory.module.js

@@ -0,0 +1,49 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var FactoryModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryModule = void 0;
+const common_1 = require("@nestjs/common");
+const factory_constants_1 = require("./factory.constants");
+const factory_service_1 = require("./factory.service");
+let FactoryModule = FactoryModule_1 = class FactoryModule {
+    static forRoot(options = {}) {
+        const providers = [
+            { provide: factory_constants_1.FACTORY_OPTIONS, useValue: options },
+            factory_service_1.FactoryService,
+        ];
+        return {
+            module: FactoryModule_1,
+            global: true,
+            providers,
+            exports: [factory_service_1.FactoryService, factory_constants_1.FACTORY_OPTIONS],
+        };
+    }
+    static forRootAsync(asyncOptions) {
+        const providers = [
+            {
+                provide: factory_constants_1.FACTORY_OPTIONS,
+                useFactory: asyncOptions.useFactory,
+                inject: asyncOptions.inject ?? [],
+            },
+            factory_service_1.FactoryService,
+        ];
+        return {
+            module: FactoryModule_1,
+            global: true,
+            imports: [...(asyncOptions.imports ?? [])],
+            providers,
+            exports: [factory_service_1.FactoryService, factory_constants_1.FACTORY_OPTIONS],
+        };
+    }
+};
+exports.FactoryModule = FactoryModule;
+exports.FactoryModule = FactoryModule = FactoryModule_1 = __decorate([
+    (0, common_1.Module)({})
+], FactoryModule);
+//# sourceMappingURL=factory.module.js.map

package/dist/factory.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.module.js","sourceRoot":"","sources":["../src/factory.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAsE;AACtE,2DAAsD;AACtD,uDAAmD;AAI5C,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB,MAAM,CAAC,OAAO,CAAC,UAAgC,EAAE;QAC/C,MAAM,SAAS,GAAe;YAC5B,EAAE,OAAO,EAAE,mCAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;YAC/C,gCAAc;SACf,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,MAAM,EAAE,IAAI;YACZ,SAAS;YACT,OAAO,EAAE,CAAC,gCAAc,EAAE,mCAAe,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,YAAiC;QACnD,MAAM,SAAS,GAAe;YAC5B;gBACE,OAAO,EAAE,mCAAe;gBACxB,UAAU,EAAE,YAAY,CAAC,UAAW;gBACpC,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,EAAE;aAClC;YACD,gCAAc;SACf,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC1C,SAAS;YACT,OAAO,EAAE,CAAC,gCAAc,EAAE,mCAAe,CAAC;SAC3C,CAAC;IACJ,CAAC;CACF,CAAA;AAjCY,sCAAa;wBAAb,aAAa;IADzB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,aAAa,CAiCzB"}

package/dist/factory.service.d.ts

@@ -0,0 +1,28 @@
+import { OnModuleDestroy, OnModuleInit } from "@nestjs/common";
+import { DataSource } from "typeorm";
+import { Faker } from "@faker-js/faker";
+import { FactoryBuilder } from "./factory-builder";
+import type { FactoryModuleOptions, FactoryClass, SeederClass } from "./interfaces";
+interface EventEmitterLike {
+    emit(event: string, ...args: any[]): boolean;
+}
+export declare class FactoryService implements OnModuleInit, OnModuleDestroy {
+    private readonly options;
+    private readonly dataSource?;
+    private readonly eventEmitter?;
+    private static instance;
+    private readonly logger;
+    private readonly factoryInstances;
+    private _faker;
+    constructor(options: FactoryModuleOptions, dataSource?: DataSource | undefined, eventEmitter?: EventEmitterLike | undefined);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    static getInstance(): FactoryService | null;
+    getOptions(): FactoryModuleOptions;
+    getFaker(): Faker;
+    use<T>(factoryClass: FactoryClass<T>): FactoryBuilder<T>;
+    seed(): Promise<void>;
+    runSeeder(seederClass: SeederClass): Promise<void>;
+    private emit;
+}
+export {};

package/dist/factory.service.js

@@ -0,0 +1,105 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var FactoryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+const faker_1 = require("@faker-js/faker");
+const factory_constants_1 = require("./factory.constants");
+const factory_events_1 = require("./events/factory.events");
+const factory_builder_1 = require("./factory-builder");
+const factory_not_registered_exception_1 = require("./exceptions/factory-not-registered.exception");
+let FactoryService = FactoryService_1 = class FactoryService {
+    constructor(options, dataSource, eventEmitter) {
+        this.options = options;
+        this.dataSource = dataSource;
+        this.eventEmitter = eventEmitter;
+        this.logger = new common_1.Logger(FactoryService_1.name);
+        this.factoryInstances = new Map();
+        this._faker = faker_1.faker;
+        if (options.seed != null) {
+            faker_1.faker.seed(options.seed);
+        }
+        if (options.factories) {
+            for (const FactoryClass of options.factories) {
+                const instance = new FactoryClass();
+                this.factoryInstances.set(FactoryClass.name, instance);
+            }
+        }
+    }
+    onModuleInit() {
+        FactoryService_1.instance = this;
+        this.logger.log("FactoryService initialized");
+    }
+    onModuleDestroy() {
+        if (FactoryService_1.instance === this) {
+            FactoryService_1.instance = null;
+        }
+    }
+    static getInstance() {
+        return FactoryService_1.instance;
+    }
+    getOptions() {
+        return this.options;
+    }
+    getFaker() {
+        return this._faker;
+    }
+    use(factoryClass) {
+        const instance = this.factoryInstances.get(factoryClass.name);
+        if (!instance) {
+            throw new factory_not_registered_exception_1.FactoryNotRegisteredException(factoryClass.name);
+        }
+        return new factory_builder_1.FactoryBuilder(instance, this._faker, this.dataSource ?? null);
+    }
+    async seed() {
+        const seeders = this.options.seeders ?? [];
+        this.emit(factory_events_1.FACTORY_EVENTS.SEED_ALL_STARTED, { seederCount: seeders.length });
+        const sorted = [...seeders].sort((a, b) => {
+            const orderA = new a().order ?? 0;
+            const orderB = new b().order ?? 0;
+            return orderA - orderB;
+        });
+        for (const SeederClass of sorted) {
+            await this.runSeeder(SeederClass);
+        }
+        this.emit(factory_events_1.FACTORY_EVENTS.SEED_ALL_COMPLETED, { seederCount: seeders.length });
+    }
+    async runSeeder(seederClass) {
+        const seeder = new seederClass();
+        const name = seederClass.name;
+        this.logger.log(`Running seeder: ${name}`);
+        this.emit(factory_events_1.FACTORY_EVENTS.SEEDER_STARTED, { seederClass: name });
+        await seeder.run(this);
+        this.logger.log(`Completed seeder: ${name}`);
+        this.emit(factory_events_1.FACTORY_EVENTS.SEEDER_COMPLETED, { seederClass: name });
+    }
+    emit(event, payload) {
+        if (this.eventEmitter) {
+            this.eventEmitter.emit(event, payload);
+        }
+    }
+};
+exports.FactoryService = FactoryService;
+FactoryService.instance = null;
+exports.FactoryService = FactoryService = FactoryService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(factory_constants_1.FACTORY_OPTIONS)),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)("EventEmitter2")),
+    __metadata("design:paramtypes", [Object, typeorm_1.DataSource, Object])
+], FactoryService);
+//# sourceMappingURL=factory.service.js.map

package/dist/factory.service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { FactoryModule } from "./factory.module";
+export { FactoryService } from "./factory.service";
+export { BaseFactory } from "./base-factory";
+export { FactoryBuilder } from "./factory-builder";
+export { Sequence } from "./sequence";
+export { FACTORY_OPTIONS } from "./factory.constants";
+export { FACTORY_EVENTS, type SeederStartedEvent, type SeederCompletedEvent, type SeedAllStartedEvent, type SeedAllCompletedEvent, } from "./events";
+export type { FactoryModuleOptions, FactoryAsyncOptions, FactoryClass, SeederClass, Seeder, } from "./interfaces";
+export { FactoryNotInitializedException } from "./exceptions";
+export { FactoryNotRegisteredException } from "./exceptions";

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryNotRegisteredException = exports.FactoryNotInitializedException = exports.FACTORY_EVENTS = exports.FACTORY_OPTIONS = exports.Sequence = exports.FactoryBuilder = exports.BaseFactory = exports.FactoryService = exports.FactoryModule = void 0;
+var factory_module_1 = require("./factory.module");
+Object.defineProperty(exports, "FactoryModule", { enumerable: true, get: function () { return factory_module_1.FactoryModule; } });
+var factory_service_1 = require("./factory.service");
+Object.defineProperty(exports, "FactoryService", { enumerable: true, get: function () { return factory_service_1.FactoryService; } });
+var base_factory_1 = require("./base-factory");
+Object.defineProperty(exports, "BaseFactory", { enumerable: true, get: function () { return base_factory_1.BaseFactory; } });
+var factory_builder_1 = require("./factory-builder");
+Object.defineProperty(exports, "FactoryBuilder", { enumerable: true, get: function () { return factory_builder_1.FactoryBuilder; } });
+var sequence_1 = require("./sequence");
+Object.defineProperty(exports, "Sequence", { enumerable: true, get: function () { return sequence_1.Sequence; } });
+var factory_constants_1 = require("./factory.constants");
+Object.defineProperty(exports, "FACTORY_OPTIONS", { enumerable: true, get: function () { return factory_constants_1.FACTORY_OPTIONS; } });
+var events_1 = require("./events");
+Object.defineProperty(exports, "FACTORY_EVENTS", { enumerable: true, get: function () { return events_1.FACTORY_EVENTS; } });
+var exceptions_1 = require("./exceptions");
+Object.defineProperty(exports, "FactoryNotInitializedException", { enumerable: true, get: function () { return exceptions_1.FactoryNotInitializedException; } });
+var exceptions_2 = require("./exceptions");
+Object.defineProperty(exports, "FactoryNotRegisteredException", { enumerable: true, get: function () { return exceptions_2.FactoryNotRegisteredException; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,mCAMkB;AALhB,wGAAA,cAAc,OAAA;AAahB,2CAA8D;AAArD,4HAAA,8BAA8B,OAAA;AACvC,2CAA6D;AAApD,2HAAA,6BAA6B,OAAA"}

package/dist/interfaces/factory-options.interface.d.ts

@@ -0,0 +1,14 @@
+import type { BaseFactory } from "../base-factory";
+import type { Seeder } from "./seeder.interface";
+export type FactoryClass<T = any> = new () => BaseFactory<T>;
+export type SeederClass = new () => Seeder;
+export interface FactoryModuleOptions {
+    factories?: FactoryClass[];
+    seeders?: SeederClass[];
+    seed?: number;
+}
+export interface FactoryAsyncOptions {
+    imports?: any[];
+    inject?: any[];
+    useFactory?: (...args: any[]) => Promise<FactoryModuleOptions> | FactoryModuleOptions;
+}

package/dist/interfaces/factory-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=factory-options.interface.js.map

package/dist/interfaces/factory-options.interface.js.map

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export type { FactoryModuleOptions, FactoryAsyncOptions, FactoryClass, SeederClass, } from "./factory-options.interface";
+export type { Seeder } from "./seeder.interface";

package/dist/interfaces/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":""}

package/dist/interfaces/seeder.interface.d.ts

@@ -0,0 +1,5 @@
+import type { FactoryService } from "../factory.service";
+export interface Seeder {
+    order?: number;
+    run(factory: FactoryService): Promise<void>;
+}

package/dist/interfaces/seeder.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=seeder.interface.js.map

package/dist/interfaces/seeder.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeder.interface.js","sourceRoot":"","sources":["../../src/interfaces/seeder.interface.ts"],"names":[],"mappings":""}

package/dist/sequence.d.ts

@@ -0,0 +1,10 @@
+export declare class Sequence<T = any> {
+    private readonly callback;
+    private index;
+    constructor(callback: (index: number) => T);
+    static increment(start?: number): Sequence<number>;
+    static cycle<V>(values: V[]): Sequence<V>;
+    static from<V>(callback: (index: number) => V): Sequence<V>;
+    next(): T;
+    reset(): void;
+}

package/dist/sequence.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sequence = void 0;
+class Sequence {
+    constructor(callback) {
+        this.callback = callback;
+        this.index = 0;
+    }
+    static increment(start = 1) {
+        return new Sequence((i) => start + i);
+    }
+    static cycle(values) {
+        return new Sequence((i) => values[i % values.length]);
+    }
+    static from(callback) {
+        return new Sequence(callback);
+    }
+    next() {
+        return this.callback(this.index++);
+    }
+    reset() {
+        this.index = 0;
+    }
+}
+exports.Sequence = Sequence;
+//# sourceMappingURL=sequence.js.map

package/dist/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAQ;IAGnB,YAA6B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;QAFnD,UAAK,GAAG,CAAC,CAAC;IAE4C,CAAC;IAE/D,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC;QACxB,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,KAAK,CAAI,MAAW;QACzB,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,IAAI,CAAI,QAA8B;QAC3C,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF;AAxBD,4BAwBC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@nestbolt/factory",
+  "version": "0.1.0",
+  "description": "Model factories and database seeders for NestJS with TypeORM.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "nestjs",
+    "factory",
+    "factories",
+    "seeder",
+    "database-seeder",
+    "faker",
+    "test-data",
+    "typeorm",
+    "model-factory"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nestbolt/factory"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@faker-js/faker": "^9.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0",
+    "@nestjs/event-emitter": "^2.0.0 || ^3.0.0",
+    "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
+    "reflect-metadata": "^0.1.13 || ^0.2.0",
+    "typeorm": "^0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/event-emitter": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "better-sqlite3": "^12.8.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "prettier": "^3.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.0",
+    "typeorm": "^0.3.0",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage",
+    "test:results": "npx vitest run --coverage 2>&1 | grep -E \"All files|%\" | head -10",
+    "lint": "eslint 'src/**/*.ts' 'test/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' 'test/**/*.ts' --fix",
+    "format": "prettier --write 'src/**/*.ts' 'test/**/*.ts'"
+  }
+}