@stingerloom/orm 0.1.2 → 0.2.0

package/README.md

@@ -10,6 +10,8 @@
 
 ---
 
+Stingerloom ORM is a decorator-driven TypeScript ORM designed for type-safe database access with first-class multi-tenancy support.
+
 ## Install
 
 ```bash
@@ -19,52 +21,159 @@ npm install @stingerloom/orm reflect-metadata
 Install only the driver you need:
 
 ```bash
-npm install mysql2        # MySQL
-npm install pg            # PostgreSQL
+npm install mysql2         # MySQL / MariaDB
+npm install pg             # PostgreSQL
 npm install better-sqlite3 # SQLite
 ```
 
-## Quick Start
+## Defining Entities
+
+Entities are defined with decorators. Column types are automatically inferred from TypeScript types — `string` maps to `VARCHAR`, `number` to `INT`, `boolean` to `TINYINT`/`BOOLEAN`.
 
 ```typescript
 @Entity()
-class User {
-  @PrimaryGeneratedColumn() id!: number;
-  @Column() name!: string;
-  @Column() email!: string;
+class Post {
+  @PrimaryGeneratedColumn()
+  id!: number;
+
+  @Column()
+  title!: string;
+
+  @Column({ type: "text" })
+  content!: string;
+
+  @DeletedAt()
+  deletedAt!: Date | null;
+
+  @ManyToOne(() => User, { joinColumn: "author_id", eager: true })
+  author!: User;
+
+  @BeforeInsert()
+  setDefaults() {
+    this.createdAt = new Date();
+  }
 }
+```
+
+## CRUD with EntityManager
 
+```typescript
 const em = new EntityManager();
-await em.register({ type: "postgres", entities: [User], synchronize: true });
+await em.register({ type: "mysql", entities: [Post, User], synchronize: true });
+
+// Create
+const post = await em.save(Post, { title: "Hello", content: "World" });
+
+// Read — eager relations are loaded automatically
+const found = await em.findOne(Post, { where: { id: 1 } });
+
+// Update
+found.title = "Updated";
+await em.save(Post, found);
+
+// Soft Delete — find queries automatically exclude soft-deleted rows
+await em.softDelete(Post, { id: 1 });
+```
+
+## Relationships
+
+Four relationship types with eager, lazy, and explicit loading strategies:
+
+```typescript
+@ManyToOne(() => User, { eager: true })       // N:1, auto-loads on find
+@OneToMany(() => Comment, c => c.post)         // 1:N, inverse side
+@OneToOne(() => Profile, { joinColumn: "profile_id" })
+@ManyToMany(() => Tag, { joinTable: "post_tags" })  // auto-generated join table DDL
+```
+
+## Query Builder
+
+For complex queries beyond the `find` API:
 
-await em.save(User, { name: "Alice", email: "alice@example.com" });
-await em.find(User, { where: { name: "Alice" } });
+```typescript
+const qb = RawQueryBuilderFactory.create()
+  .select(["p.id", "p.title", "COUNT(c.id) AS comment_count"])
+  .from("post", "p")
+  .leftJoin("comment", "c", sql`c.post_id = p.id`)
+  .where([sql`p.deleted_at IS NULL`])
+  .groupBy(["p.id"])
+  .having([sql`COUNT(c.id) > ${5}`])
+  .orderBy([{ column: "comment_count", direction: "DESC" }])
+  .limit(10)
+  .build();
+```
+
+## Multi-Tenancy
+
+Layered metadata system inspired by Docker OverlayFS. Each tenant gets an isolated metadata layer with Copy-on-Write semantics, powered by `AsyncLocalStorage` for safe concurrent access:
+
+```typescript
+// Requests are isolated per tenant — no cross-tenant data leakage
+app.use((req, res, next) => {
+  MetadataContext.run(req.headers["x-tenant-id"], () => next());
+});
+```
+
+PostgreSQL schema-based isolation with automatic provisioning:
+
+```typescript
+const runner = new PostgresTenantMigrationRunner(driver);
+await runner.ensureSchema("tenant_42"); // CREATE SCHEMA IF NOT EXISTS
+await runner.syncTenantSchemas(["t1", "t2"]); // batch provisioning
+```
+
+## Transactions
+
+Method-level with `@Transactional()` or manual with savepoint support:
+
+```typescript
+@Transactional("SERIALIZABLE")
+async transfer(from: number, to: number, amount: number) {
+  // automatic BEGIN, COMMIT on success, ROLLBACK on error
+}
 ```
 
-## Features
-
-- CRUD
-- Relations (ManyToOne, OneToMany, ManyToMany, OneToOne)
-- Eager & Lazy Loading
-- Transactions
-- Migrations
-- Query Builder
-- Multi-tenancy
-- Soft Delete
-- Upsert
-- Cursor Pagination
-- N+1 Detection
-- EntitySubscriber
-- NestJS Integration
+## Migrations
+
+Schema Diff compares entity metadata against the live database and auto-generates migration code:
+
+```typescript
+const diff = await SchemaDiff.compare(em, [User, Post]);
+const migration = new SchemaDiffMigrationGenerator().generate(diff, "mysql");
+```
+
+## Additional Features
+
+- **Cursor Pagination** — `findWithCursor()` for consistent performance on large datasets
+- **Upsert** — `INSERT ON CONFLICT` / `ON DUPLICATE KEY UPDATE` with native driver syntax
+- **N+1 Detection** — QueryTracker warns on repeated single-row queries and slow queries
+- **Aggregation** — `count`, `sum`, `avg`, `min`, `max` with optional WHERE
+- **Lifecycle Hooks** — `@BeforeInsert`, `@AfterInsert`, `@BeforeUpdate`, `@AfterUpdate`, `@BeforeDelete`, `@AfterDelete`
+- **EntitySubscriber** — event-driven observation pattern per entity class
+- **Validation** — `@NotNull`, `@MinLength`, `@MaxLength`, `@Min`, `@Max`
+- **Connection Pooling** — configurable pool size, acquire/idle timeouts
+- **Retry & Timeout** — exponential backoff on connection failure, per-query timeout
+- **EXPLAIN** — query execution plan analysis
+- **NestJS Integration** — `@InjectRepository`, `@InjectEntityManager`, module system
 
 ## Databases
 
-PostgreSQL · MySQL · SQLite
+|                  | MySQL | PostgreSQL | SQLite |
+| ---------------- | ----- | ---------- | ------ |
+| CRUD             | ✓     | ✓          | ✓      |
+| Transactions     | ✓     | ✓          | ✓      |
+| Schema Sync      | ✓     | ✓          | ✓      |
+| Migrations       | ✓     | ✓          | ✓      |
+| ENUM             | ✓     | ✓ (native) | —      |
+| Schema Isolation | —     | ✓          | —      |
+| Read Replica     | ✓     | ✓          | —      |
 
-## Docs
+## Test Status
 
-See **[docs/](./docs/README.md)** for full documentation.
+- **1,405** unit tests passed, 0 failures
+- **4** example projects type-checked (nestjs-cats, nestjs-blog, nestjs-multitenant, nestjs-todo)
+- **6** SQL injection vectors patched and audited across all drivers
 
-## License
+## Documentation
 
-[MIT](./LICENSE)
+Full documentation available at [docs/](https://github.com/biud436/stingerloom-orm/tree/main/docs).

package/dist/integration/nestjs/index.d.ts

@@ -0,0 +1,5 @@
+export { StinglerloomOrmModule, makeInjectRepositoryToken, STINGERLOOM_ORM_OPTION_TOKEN, INJECT_REPOSITORIES_TOKEN, } from "./stingerloom-orm.module";
+export { StingerloomOrmCoreModule } from "./stingerloom-orm-core.module";
+export { StinglerloomOrmService, STINGERLOOM_ORM_SERVICE_TOKEN, } from "./stingerloom-orm.service";
+export { InjectRepository } from "./inject-repository.decorator";
+//# sourceMappingURL=index.d.ts.map

package/dist/integration/nestjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integration/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/integration/nestjs/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectRepository = exports.STINGERLOOM_ORM_SERVICE_TOKEN = exports.StinglerloomOrmService = exports.StingerloomOrmCoreModule = exports.INJECT_REPOSITORIES_TOKEN = exports.STINGERLOOM_ORM_OPTION_TOKEN = exports.makeInjectRepositoryToken = exports.StinglerloomOrmModule = void 0;
+var stingerloom_orm_module_1 = require("./stingerloom-orm.module");
+Object.defineProperty(exports, "StinglerloomOrmModule", { enumerable: true, get: function () { return stingerloom_orm_module_1.StinglerloomOrmModule; } });
+Object.defineProperty(exports, "makeInjectRepositoryToken", { enumerable: true, get: function () { return stingerloom_orm_module_1.makeInjectRepositoryToken; } });
+Object.defineProperty(exports, "STINGERLOOM_ORM_OPTION_TOKEN", { enumerable: true, get: function () { return stingerloom_orm_module_1.STINGERLOOM_ORM_OPTION_TOKEN; } });
+Object.defineProperty(exports, "INJECT_REPOSITORIES_TOKEN", { enumerable: true, get: function () { return stingerloom_orm_module_1.INJECT_REPOSITORIES_TOKEN; } });
+var stingerloom_orm_core_module_1 = require("./stingerloom-orm-core.module");
+Object.defineProperty(exports, "StingerloomOrmCoreModule", { enumerable: true, get: function () { return stingerloom_orm_core_module_1.StingerloomOrmCoreModule; } });
+var stingerloom_orm_service_1 = require("./stingerloom-orm.service");
+Object.defineProperty(exports, "StinglerloomOrmService", { enumerable: true, get: function () { return stingerloom_orm_service_1.StinglerloomOrmService; } });
+Object.defineProperty(exports, "STINGERLOOM_ORM_SERVICE_TOKEN", { enumerable: true, get: function () { return stingerloom_orm_service_1.STINGERLOOM_ORM_SERVICE_TOKEN; } });
+var inject_repository_decorator_1 = require("./inject-repository.decorator");
+Object.defineProperty(exports, "InjectRepository", { enumerable: true, get: function () { return inject_repository_decorator_1.InjectRepository; } });
+//# sourceMappingURL=index.js.map

package/dist/integration/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integration/nestjs/index.ts"],"names":[],"mappings":";;;AAAA,mEAKkC;AAJhC,+HAAA,qBAAqB,OAAA;AACrB,mIAAA,yBAAyB,OAAA;AACzB,sIAAA,4BAA4B,OAAA;AAC5B,mIAAA,yBAAyB,OAAA;AAE3B,6EAAyE;AAAhE,uIAAA,wBAAwB,OAAA;AACjC,qEAGmC;AAFjC,iIAAA,sBAAsB,OAAA;AACtB,wIAAA,6BAA6B,OAAA;AAE/B,6EAAiE;AAAxD,+HAAA,gBAAgB,OAAA"}

package/dist/integration/nestjs/inject-repository.decorator.d.ts

@@ -0,0 +1,3 @@
+import type { ClazzType } from "../../utils/types";
+export declare const InjectRepository: (entity: ClazzType<unknown>) => ParameterDecorator;
+//# sourceMappingURL=inject-repository.decorator.d.ts.map

package/dist/integration/nestjs/inject-repository.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-repository.decorator.d.ts","sourceRoot":"","sources":["../../../src/integration/nestjs/inject-repository.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,CAAC,OAAO,CAAC,KACzB,kBAEF,CAAC"}

package/dist/integration/nestjs/inject-repository.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectRepository = void 0;
+const common_1 = require("@nestjs/common");
+const stingerloom_orm_module_1 = require("./stingerloom-orm.module");
+const InjectRepository = (entity) => {
+    return (0, common_1.Inject)((0, stingerloom_orm_module_1.makeInjectRepositoryToken)(entity));
+};
+exports.InjectRepository = InjectRepository;
+//# sourceMappingURL=inject-repository.decorator.js.map

package/dist/integration/nestjs/inject-repository.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-repository.decorator.js","sourceRoot":"","sources":["../../../src/integration/nestjs/inject-repository.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,qEAAqE;AAG9D,MAAM,gBAAgB,GAAG,CAC9B,MAA0B,EACN,EAAE;IACtB,OAAO,IAAA,eAAM,EAAC,IAAA,kDAAyB,EAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B"}

package/dist/integration/nestjs/stingerloom-orm-core.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from "@nestjs/common";
+import type { DatabaseClientOptions } from "../../core/DatabaseClientOptions";
+export declare class StingerloomOrmCoreModule {
+    static forRoot(options: DatabaseClientOptions): DynamicModule;
+}
+//# sourceMappingURL=stingerloom-orm-core.module.d.ts.map

package/dist/integration/nestjs/stingerloom-orm-core.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stingerloom-orm-core.module.d.ts","sourceRoot":"","sources":["../../../src/integration/nestjs/stingerloom-orm-core.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,qBACa,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa;CAgB9D"}

package/dist/integration/nestjs/stingerloom-orm-core.module.js

@@ -0,0 +1,35 @@
+"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 StingerloomOrmCoreModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StingerloomOrmCoreModule = void 0;
+const common_1 = require("@nestjs/common");
+const EntityManager_1 = require("../../core/EntityManager");
+let StingerloomOrmCoreModule = StingerloomOrmCoreModule_1 = class StingerloomOrmCoreModule {
+    static forRoot(options) {
+        return {
+            module: StingerloomOrmCoreModule_1,
+            providers: [
+                {
+                    provide: EntityManager_1.EntityManager,
+                    useFactory: async () => {
+                        const em = new EntityManager_1.EntityManager();
+                        await em.register(options);
+                        return em;
+                    },
+                },
+            ],
+            exports: [EntityManager_1.EntityManager],
+        };
+    }
+};
+exports.StingerloomOrmCoreModule = StingerloomOrmCoreModule;
+exports.StingerloomOrmCoreModule = StingerloomOrmCoreModule = StingerloomOrmCoreModule_1 = __decorate([
+    (0, common_1.Module)({})
+], StingerloomOrmCoreModule);
+//# sourceMappingURL=stingerloom-orm-core.module.js.map

package/dist/integration/nestjs/stingerloom-orm-core.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stingerloom-orm-core.module.js","sourceRoot":"","sources":["../../../src/integration/nestjs/stingerloom-orm-core.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,4DAAyD;AAIlD,IAAM,wBAAwB,gCAA9B,MAAM,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,OAA8B;QAC3C,OAAO;YACL,MAAM,EAAE,0BAAwB;YAChC,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,6BAAa;oBACtB,UAAU,EAAE,KAAK,IAAI,EAAE;wBACrB,MAAM,EAAE,GAAG,IAAI,6BAAa,EAAE,CAAC;wBAC/B,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;wBAC3B,OAAO,EAAE,CAAC;oBACZ,CAAC;iBACF;aACF;YACD,OAAO,EAAE,CAAC,6BAAa,CAAC;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AAjBY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,wBAAwB,CAiBpC"}

package/dist/integration/nestjs/stingerloom-orm.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from "@nestjs/common";
+import type { ClazzType } from "../../utils/types";
+import type { DatabaseClientOptions } from "../../core/DatabaseClientOptions";
+export declare const STINGERLOOM_ORM_OPTION_TOKEN: unique symbol;
+export declare const INJECT_REPOSITORIES_TOKEN = "INJECT_REPOSITORIES_TOKEN";
+export declare function makeInjectRepositoryToken(entity: ClazzType<unknown>): symbol;
+export declare class StinglerloomOrmModule {
+    static forFeature(entities: ClazzType<unknown>[]): DynamicModule;
+    static forRoot(options: DatabaseClientOptions): DynamicModule;
+}
+//# sourceMappingURL=stingerloom-orm.module.d.ts.map

package/dist/integration/nestjs/stingerloom-orm.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stingerloom-orm.module.d.ts","sourceRoot":"","sources":["../../../src/integration/nestjs/stingerloom-orm.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAMvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAG9E,eAAO,MAAM,4BAA4B,eAExC,CAAC;AACF,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAIrE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,MAAM,CAS5E;AAED,qBACa,qBAAqB;IAChC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,aAAa;IAgBhE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa;CAiB9D"}

package/dist/integration/nestjs/stingerloom-orm.module.js

@@ -0,0 +1,58 @@
+"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 StinglerloomOrmModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StinglerloomOrmModule = exports.INJECT_REPOSITORIES_TOKEN = exports.STINGERLOOM_ORM_OPTION_TOKEN = void 0;
+exports.makeInjectRepositoryToken = makeInjectRepositoryToken;
+const common_1 = require("@nestjs/common");
+const stingerloom_orm_service_1 = require("./stingerloom-orm.service");
+const EntityManager_1 = require("../../core/EntityManager");
+const stingerloom_orm_core_module_1 = require("./stingerloom-orm-core.module");
+exports.STINGERLOOM_ORM_OPTION_TOKEN = Symbol.for("STINGERLOOM_ORM_OPTION_TOKEN");
+exports.INJECT_REPOSITORIES_TOKEN = "INJECT_REPOSITORIES_TOKEN";
+const repositoryTokenCache = new WeakMap();
+function makeInjectRepositoryToken(entity) {
+    let token = repositoryTokenCache.get(entity);
+    if (!token) {
+        token = Symbol(`${exports.INJECT_REPOSITORIES_TOKEN}_${entity.name}`);
+        repositoryTokenCache.set(entity, token);
+    }
+    return token;
+}
+let StinglerloomOrmModule = StinglerloomOrmModule_1 = class StinglerloomOrmModule {
+    static forFeature(entities) {
+        const providers = entities.map((entity) => ({
+            provide: makeInjectRepositoryToken(entity),
+            useFactory: (entityManager) => {
+                return entityManager.getRepository(entity);
+            },
+            inject: [EntityManager_1.EntityManager],
+        }));
+        return {
+            module: StinglerloomOrmModule_1,
+            providers: [...providers],
+            exports: providers,
+        };
+    }
+    static forRoot(options) {
+        Reflect.defineMetadata(exports.STINGERLOOM_ORM_OPTION_TOKEN, options, StinglerloomOrmModule_1);
+        stingerloom_orm_service_1.StinglerloomOrmService.captured[stingerloom_orm_service_1.STINGERLOOM_ORM_SERVICE_TOKEN] = true;
+        return {
+            module: StinglerloomOrmModule_1,
+            imports: [stingerloom_orm_core_module_1.StingerloomOrmCoreModule.forRoot(options)],
+            providers: [stingerloom_orm_service_1.StinglerloomOrmService],
+            exports: [stingerloom_orm_service_1.StinglerloomOrmService, stingerloom_orm_core_module_1.StingerloomOrmCoreModule],
+            global: true,
+        };
+    }
+};
+exports.StinglerloomOrmModule = StinglerloomOrmModule;
+exports.StinglerloomOrmModule = StinglerloomOrmModule = StinglerloomOrmModule_1 = __decorate([
+    (0, common_1.Module)({})
+], StinglerloomOrmModule);
+//# sourceMappingURL=stingerloom-orm.module.js.map

package/dist/integration/nestjs/stingerloom-orm.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stingerloom-orm.module.js","sourceRoot":"","sources":["../../../src/integration/nestjs/stingerloom-orm.module.ts"],"names":[],"mappings":";;;;;;;;;;AAiBA,8DASC;AA1BD,2CAAuD;AACvD,uEAGmC;AACnC,4DAAyD;AAGzD,+EAAyE;AAE5D,QAAA,4BAA4B,GAAG,MAAM,CAAC,GAAG,CACpD,8BAA8B,CAC/B,CAAC;AACW,QAAA,yBAAyB,GAAG,2BAA2B,CAAC;AAErE,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAA8B,CAAC;AAEvE,SAAgB,yBAAyB,CAAC,MAA0B;IAClE,IAAI,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,MAAM,CAAC,GAAG,iCAAyB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAGM,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IAChC,MAAM,CAAC,UAAU,CAAC,QAA8B;QAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC;YAC1C,UAAU,EAAE,CAAC,aAA4B,EAAE,EAAE;gBAC3C,OAAO,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,EAAE,CAAC,6BAAa,CAAC;SACxB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,MAAM,EAAE,uBAAqB;YAC7B,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;YACzB,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAA8B;QAC3C,OAAO,CAAC,cAAc,CACpB,oCAA4B,EAC5B,OAAO,EACP,uBAAqB,CACtB,CAAC;QAEF,gDAAsB,CAAC,QAAQ,CAAC,uDAA6B,CAAC,GAAG,IAAI,CAAC;QAEtE,OAAO;YACL,MAAM,EAAE,uBAAqB;YAC7B,OAAO,EAAE,CAAC,sDAAwB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACpD,SAAS,EAAE,CAAC,gDAAsB,CAAC;YACnC,OAAO,EAAE,CAAC,gDAAsB,EAAE,sDAAwB,CAAC;YAC3D,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AAlCY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,qBAAqB,CAkCjC"}

package/dist/integration/nestjs/stingerloom-orm.service.d.ts

@@ -0,0 +1,18 @@
+import "reflect-metadata";
+import { OnModuleInit, OnApplicationShutdown } from "@nestjs/common";
+import { EntityManager } from "../../core/EntityManager";
+import type { ClazzType } from "../../utils/types";
+export declare const STINGERLOOM_ORM_SERVICE_TOKEN: unique symbol;
+export declare class StinglerloomOrmService implements OnModuleInit, OnApplicationShutdown {
+    private readonly entityManager;
+    private readonly logger;
+    static captured: Record<typeof STINGERLOOM_ORM_SERVICE_TOKEN, boolean>;
+    constructor(entityManager: EntityManager);
+    onModuleInit(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
+    private initEntityManager;
+    private propagateShutdown;
+    getRepository<T>(entity: ClazzType<T>): import("../..").BaseRepository<T>;
+    getEntityManager(): EntityManager;
+}
+//# sourceMappingURL=stingerloom-orm.service.d.ts.map

package/dist/integration/nestjs/stingerloom-orm.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stingerloom-orm.service.d.ts","sourceRoot":"","sources":["../../../src/integration/nestjs/stingerloom-orm.service.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAEL,YAAY,EACZ,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,eAAO,MAAM,6BAA6B,eAEzC,CAAC;AAEF,qBACa,sBACX,YAAW,YAAY,EAAE,qBAAqB;IASlC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAP1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAElE,OAAc,QAAQ,EAAS,MAAM,CACnC,OAAO,6BAA6B,EACpC,OAAO,CACR,CAAC;gBAE2B,aAAa,EAAE,aAAa;IAInD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;YAK9B,iBAAiB;YAMjB,iBAAiB;IAM/B,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IASrC,gBAAgB,IAAI,aAAa;CAQlC"}

package/dist/integration/nestjs/stingerloom-orm.service.js

@@ -0,0 +1,70 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var StinglerloomOrmService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StinglerloomOrmService = exports.STINGERLOOM_ORM_SERVICE_TOKEN = void 0;
+require("reflect-metadata");
+const common_1 = require("@nestjs/common");
+const EntityManager_1 = require("../../core/EntityManager");
+const Logger_1 = require("../../utils/Logger");
+const typedi_1 = __importDefault(require("typedi"));
+exports.STINGERLOOM_ORM_SERVICE_TOKEN = Symbol.for("STINGERLOOM_ORM_SERVICE_TOKEN");
+let StinglerloomOrmService = StinglerloomOrmService_1 = class StinglerloomOrmService {
+    constructor(entityManager) {
+        this.entityManager = entityManager;
+        this.logger = new Logger_1.Logger(StinglerloomOrmService_1.name);
+        this.logger.info("StinglerloomOrmService initialized");
+    }
+    async onModuleInit() {
+        this.logger.info("StinglerloomOrmService OnModuleInit");
+        if (!StinglerloomOrmService_1.captured[exports.STINGERLOOM_ORM_SERVICE_TOKEN]) {
+            this.logger.warn("StinglerloomOrmModule.forRoot() was not called");
+            return;
+        }
+        await this.initEntityManager();
+    }
+    async onApplicationShutdown() {
+        await this.propagateShutdown();
+        this.logger.info("Stingerloom ORM disconnected");
+    }
+    async initEntityManager() {
+        if (!typedi_1.default.has(EntityManager_1.EntityManager)) {
+            typedi_1.default.set(EntityManager_1.EntityManager, this.entityManager);
+        }
+    }
+    async propagateShutdown() {
+        if (this.entityManager) {
+            await this.entityManager.propagateShutdown();
+        }
+    }
+    getRepository(entity) {
+        if (!this.entityManager) {
+            throw new Error("EntityManager not initialized. Database connection may not be ready.");
+        }
+        return this.entityManager.getRepository(entity);
+    }
+    getEntityManager() {
+        if (!this.entityManager) {
+            throw new Error("EntityManager not initialized. Database connection may not be ready.");
+        }
+        return this.entityManager;
+    }
+};
+exports.StinglerloomOrmService = StinglerloomOrmService;
+StinglerloomOrmService.captured = {};
+exports.StinglerloomOrmService = StinglerloomOrmService = StinglerloomOrmService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [EntityManager_1.EntityManager])
+], StinglerloomOrmService);
+//# sourceMappingURL=stingerloom-orm.service.js.map

package/dist/integration/nestjs/stingerloom-orm.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stingerloom-orm.service.js","sourceRoot":"","sources":["../../../src/integration/nestjs/stingerloom-orm.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAA0B;AAC1B,2CAIwB;AACxB,4DAAyD;AACzD,+CAA4C;AAE5C,oDAA+B;AAElB,QAAA,6BAA6B,GAAG,MAAM,CAAC,GAAG,CACrD,+BAA+B,CAChC,CAAC;AAGK,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IAUjC,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QAPxC,WAAM,GAAG,IAAI,eAAM,CAAC,wBAAsB,CAAC,IAAI,CAAC,CAAC;QAQhE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAExD,IACE,CAAC,wBAAsB,CAAC,QAAQ,CAAC,qCAA6B,CAAC,EAC/D,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,CAAC,gBAAS,CAAC,GAAG,CAAC,6BAAa,CAAC,EAAE,CAAC;YAClC,gBAAS,CAAC,GAAG,CAAC,6BAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,aAAa,CAAI,MAAoB;QACnC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;;AA5DU,wDAAsB;AAKnB,+BAAQ,GAAG,EAGxB,AAHqB,CAGpB;iCARS,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAWiC,6BAAa;GAV9C,sBAAsB,CA6DlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stingerloom/orm",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "A standalone, framework-agnostic TypeScript ORM that can be used with any Node.js framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,6 +8,17 @@
     ".": {
       "types": "./dist/index.d.ts",
       "require": "./dist/index.js"
+    },
+    "./nestjs": {
+      "types": "./dist/integration/nestjs/index.d.ts",
+      "require": "./dist/integration/nestjs/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "nestjs": [
+        "dist/integration/nestjs/index.d.ts"
+      ]
     }
   },
   "files": [
@@ -32,21 +43,18 @@
     "multi-tenancy",
     "stingerloom"
   ],
-  "scripts": {
-    "build": "rimraf dist && tsc",
-    "prepublishOnly": "pnpm run build",
-    "test": "jest"
-  },
   "dependencies": {
     "class-transformer": "^0.5.1",
     "sql-template-tag": "^4.0.0",
     "typedi": "^0.10.0"
   },
   "peerDependencies": {
-    "reflect-metadata": ">=0.1.0",
+    "@nestjs/common": ">=8.0.0",
+    "@nestjs/core": ">=8.0.0",
+    "better-sqlite3": ">=9.0.0",
     "mysql2": "^3.0.0",
     "pg": "^8.0.0",
-    "better-sqlite3": ">=9.0.0"
+    "reflect-metadata": ">=0.1.0"
   },
   "peerDependenciesMeta": {
     "mysql2": {
@@ -57,9 +65,17 @@
     },
     "better-sqlite3": {
       "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@nestjs/common": "^10.4.22",
+    "@nestjs/core": "^10.4.22",
     "@types/better-sqlite3": "^7.6.13",
     "@types/jest": "^29.5.4",
     "@types/node": "^20.4.8",
@@ -70,6 +86,7 @@
     "pg": "^8.18.0",
     "reflect-metadata": "^0.2.2",
     "rimraf": "^6.1.2",
+    "rxjs": "^7.8.2",
     "ts-jest": "^29.1.1",
     "typescript": "^5.6.2"
   },
@@ -84,9 +101,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "better-sqlite3"
-    ]
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "test": "jest"
   }
-}
+}