@avleon/data 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Tareq Hossain
+
+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

@@ -1,3 +1,213 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @avleon/data
+
+TypeORM and Knex integration for [Avleon](https://avleonjs.github.io).
+
+`@avleon/data` is an Avleon [plugin](https://avleonjs.github.io/advanced/plugins).
+Once it is installed, the app gains `app.useTypeORM()` and `app.useKnex()`; nothing
+needs to be imported to enable them.
+
+```bash
+npm install @avleon/data typeorm pg   # TypeORM
+npm install @avleon/data knex pg      # Knex
+```
+
+Projects created with `avleon new` load the plugin's types through the generated
+`avleon-env.d.ts`. In other projects, add the file yourself and include it in
+`tsconfig.json`:
+
+```typescript
+// avleon-env.d.ts
+/// <reference types="@avleon/data" />
+```
+
+Both methods connect before they resolve, register the connection with the
+container, and close it when the app shuts down (`app.close()`, SIGTERM or SIGINT).
+For a bundled app, which has no `package.json` to discover plugins from, pass the
+plugin explicitly:
+
+```typescript
+import { Avleon } from "@avleon/core";
+import { dataPlugin } from "@avleon/data";
+
+const app = Avleon.createApplication({ plugins: [dataPlugin] });
+```
+
+## Knex
+
+`useKnex` connects eagerly and verifies the connection, so it returns a promise:
+
+```typescript
+await app.useKnex({
+  client: "mysql",
+  connection: {
+    host: "127.0.0.1",
+    port: 3306,
+    user: "root",
+    password: "password",
+    database: "myapp",
+  },
+});
+```
+
+Using a config class:
+
+```typescript
+import { AppConfig, AvleonConfig, Environment } from "@avleon/core";
+import type { Knex } from "knex";
+
+@AppConfig
+export class KnexConfig extends AvleonConfig<Knex.Config> {
+  config(env: Environment): Knex.Config {
+    return {
+      client: "mysql",
+      connection: {
+        host: env.get("DB_HOST") || "127.0.0.1",
+        port: Number(env.get("DB_PORT")) || 3306,
+        user: env.get("DB_USER") || "root",
+        password: env.get("DB_PASS") || "password",
+        database: env.get("DB_NAME") || "myapp",
+      },
+    };
+  }
+}
+
+await app.useKnex(KnexConfig);
+```
+
+Using in a service:
+
+```typescript
+import { AppService } from "@avleon/core";
+import { KnexDB } from "@avleon/data";
+
+@AppService
+export class UsersService {
+  constructor(private readonly db: KnexDB) {}
+
+  async findAll() {
+    return this.db.client.select("*").from("users");
+  }
+
+  async page(page: number) {
+    return this.db.paginate(this.db.client("users").orderBy("id"), {
+      page,
+      perPage: 20,
+    });
+  }
+}
+```
+
+---
+
+## TypeORM
+
+`useTypeORM` initializes the DataSource, so it returns a promise:
+
+```typescript
+await app.useTypeORM({
+  type: "postgres",
+  host: "localhost",
+  port: 5432,
+  username: "postgres",
+  password: "password",
+  database: "avleon",
+  entities: [User],
+  synchronize: true,
+});
+```
+
+Using a config class:
+
+```typescript
+import { AppConfig, AvleonConfig, Environment } from "@avleon/core";
+import type { DataSourceOptions } from "typeorm";
+
+@AppConfig
+export class DataSourceConfig extends AvleonConfig<DataSourceOptions> {
+  config(env: Environment): DataSourceOptions {
+    return {
+      type: "postgres",
+      host: env.get("DB_HOST") || "localhost",
+      port: Number(env.get("DB_PORT")) || 5432,
+      username: env.get("DB_USER") || "postgres",
+      password: env.get("DB_PASS") || "password",
+      database: env.get("DB_NAME") || "avleon",
+      entities: [User],
+      synchronize: true,
+    };
+  }
+}
+
+await app.useTypeORM(DataSourceConfig);
+```
+
+**Injecting a repository.** `@InjectRepository` gives you the TypeORM repository
+plus a `paginate()` method:
+
+```typescript
+import { AppService } from "@avleon/core";
+import { InjectRepository, PaginatedRepository } from "@avleon/data";
+import { User } from "./user.entity";
+
+@AppService
+export class UserService {
+  constructor(
+    @InjectRepository(User)
+    private readonly userRepo: PaginatedRepository<User>,
+  ) {}
+
+  findAll() {
+    return this.userRepo.find();
+  }
+
+  page(page: number) {
+    return this.userRepo.paginate({ page, perPage: 20 });
+  }
+}
+```
+
+**Custom repositories.** Extend `AvleonRepository` for pagination, transactions
+and your own query methods. Query operators (`Like`, `In`, `Not`, `Between`,
+`IsNull`, `Equal`, `ArrayContains`, …) are exported from `@avleon/data`.
+
+In 0.3.0, give the class an explicit constructor that calls `super()`, even if
+it has no dependencies (see [Known Issues](#known-issues-in-030)):
+
+```typescript
+import { AvleonRepository, Repository, Like } from "@avleon/data";
+
+@Repository(User)
+export class UserRepository extends AvleonRepository<User> {
+  constructor(private readonly audit: AuditService) {
+    super();
+  }
+
+  search(term: string, page = 1) {
+    return this.paginate(
+      { where: { name: Like(`%${term}%`) } },
+      { page, perPage: 20 },
+    );
+  }
+
+  async rename(id: number, name: string) {
+    return this.transaction(async (tx) => {
+      await tx.update({ id }, { name });
+      await this.audit.log("rename", id);
+    });
+  }
+}
+```
+
+`transaction()` joins an already active transaction instead of opening a nested
+one. `withManager(manager)` returns a copy of the repository bound to another
+`EntityManager`.
+
+## Pagination
+
+`repo.paginate()`, `AvleonRepository.paginate()`, `KnexDB.paginate()` and
+`paginateKnex()` return core's unified `{ data, meta }` shape; see
+[Pagination](https://github.com/avleonjs/avleon/tree/main/packages/core#pagination).
+
+## License
+
+MIT

package/dist/datasource.d.ts

@@ -0,0 +1,20 @@
+import type { DataSource } from "typeorm";
+/**
+ * String token under which the TypeORM `DataSource` is registered. Used by
+ * `paginatedRepository` and `@InjectRepository`.
+ */
+export declare const DATASOURCE_TOKEN = "idatasource";
+/**
+ * Register the application's TypeORM `DataSource` with the DI container.
+ *
+ * Sets both the `"idatasource"` string token and the `DataSource` class token
+ * (the class the instance was built from, and the consumer's `typeorm`
+ * `DataSource` export if that differs), so `@Repository`, `@InjectRepository`,
+ * `paginatedRepository` and `Container.get(DataSource)` all resolve it.
+ */
+export declare function registerDataSource(dataSource: DataSource): DataSource;
+/**
+ * Resolve the registered TypeORM `DataSource`, or throw a clear error if the
+ * application has not called `useTypeORM` (or `registerDataSource`) yet.
+ */
+export declare function getDataSource(): DataSource;

package/dist/datasource.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATASOURCE_TOKEN = void 0;
+exports.registerDataSource = registerDataSource;
+exports.getDataSource = getDataSource;
+/**
+ * @copyright 2024
+ * @author Tareq Hossain
+ * @email xtrinsic96@gmail.com
+ * @url https://github.com/xtareq
+ */
+const core_1 = require("@avleon/core");
+/**
+ * String token under which the TypeORM `DataSource` is registered. Used by
+ * `paginatedRepository` and `@InjectRepository`.
+ */
+exports.DATASOURCE_TOKEN = "idatasource";
+/**
+ * Register the application's TypeORM `DataSource` with the DI container.
+ *
+ * Sets both the `"idatasource"` string token and the `DataSource` class token
+ * (the class the instance was built from, and the consumer's `typeorm`
+ * `DataSource` export if that differs), so `@Repository`, `@InjectRepository`,
+ * `paginatedRepository` and `Container.get(DataSource)` all resolve it.
+ */
+function registerDataSource(dataSource) {
+    if (!dataSource) {
+        throw new Error("[Avleon] registerDataSource() requires a DataSource instance.");
+    }
+    core_1.AvleonContainer.set(exports.DATASOURCE_TOKEN, dataSource);
+    const ctor = dataSource.constructor;
+    if (typeof ctor === "function" && ctor !== Object) {
+        core_1.AvleonContainer.set(ctor, dataSource);
+    }
+    try {
+        const typeorm = (0, core_1.loadPackageFromClient)("typeorm");
+        if (typeorm?.DataSource && typeorm.DataSource !== ctor) {
+            core_1.AvleonContainer.set(typeorm.DataSource, dataSource);
+        }
+    }
+    catch {
+        // typeorm not resolvable from the app root; the constructor token is enough.
+    }
+    return dataSource;
+}
+/**
+ * Resolve the registered TypeORM `DataSource`, or throw a clear error if the
+ * application has not called `useTypeORM` (or `registerDataSource`) yet.
+ */
+function getDataSource() {
+    if (core_1.AvleonContainer.has(exports.DATASOURCE_TOKEN)) {
+        return core_1.AvleonContainer.get(exports.DATASOURCE_TOKEN);
+    }
+    try {
+        const typeorm = (0, core_1.loadPackageFromClient)("typeorm");
+        if (core_1.AvleonContainer.has(typeorm.DataSource)) {
+            return core_1.AvleonContainer.get(typeorm.DataSource);
+        }
+    }
+    catch {
+        // fall through to the error below
+    }
+    throw new Error("[Avleon] No TypeORM DataSource is registered. Call app.useTypeORM(...) " +
+        "(or registerDataSource(dataSource)) before resolving repositories.");
+}
+//# sourceMappingURL=datasource.js.map

package/dist/datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource.js","sourceRoot":"","sources":["../src/datasource.ts"],"names":[],"mappings":";;;AAuBA,gDAwBC;AAMD,sCAkBC;AAvED;;;;;GAKG;AACH,uCAAmF;AAGnF;;;GAGG;AACU,QAAA,gBAAgB,GAAG,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,UAAsB;IACvD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IAED,sBAAS,CAAC,GAAG,CAAC,wBAAgB,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAI,UAAkB,CAAC,WAAW,CAAC;IAC7C,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAClD,sBAAS,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,4BAAqB,EAA2B,SAAS,CAAC,CAAC;QAC3E,IAAI,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACvD,sBAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa;IAC3B,IAAI,sBAAS,CAAC,GAAG,CAAC,wBAAgB,CAAC,EAAE,CAAC;QACpC,OAAO,sBAAS,CAAC,GAAG,CAAa,wBAAgB,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,4BAAqB,EAA2B,SAAS,CAAC,CAAC;QAC3E,IAAI,sBAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,OAAO,sBAAS,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yEAAyE;QACvE,oEAAoE,CACvE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./datasource";
+export * from "./typeorm-provider";
+export * from "./knex-provider";
+export * from "./repository";
+export { dataPlugin } from "./plugin";

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataPlugin = void 0;
+__exportStar(require("./datasource"), exports);
+__exportStar(require("./typeorm-provider"), exports);
+__exportStar(require("./knex-provider"), exports);
+__exportStar(require("./repository"), exports);
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "dataPlugin", { enumerable: true, get: function () { return plugin_1.dataPlugin; } });
+//# 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,+CAA6B;AAC7B,qDAAmC;AACnC,kDAAgC;AAChC,+CAA6B;AAC7B,mCAAsC;AAA7B,oGAAA,UAAU,OAAA"}

package/dist/knex-provider.d.ts

@@ -0,0 +1,28 @@
+import { Token, type PageRequest, type Paginated } from "@avleon/core";
+import type { Knex } from "knex";
+/** DI token holding the initialized Knex instance. Set by `app.useKnex(...)`. */
+export declare const AVLEON_KNEX_DB: Token<Knex<any, any[]>>;
+/**
+ * Injectable accessor for the application's Knex connection.
+ *
+ * The connection itself is created by `app.useKnex(...)`, which registers it
+ * under {@link AVLEON_KNEX_DB}. Resolving this service before that call throws.
+ */
+export declare class KnexDB {
+    private readonly connection;
+    constructor();
+    get client(): Knex;
+    /**
+     * Run `query` for one page, returning the unified pagination shape.
+     *
+     * ```ts
+     * const { data, meta } = await db.paginate(db.client("users").where("active", true), { page: 2 });
+     * ```
+     *
+     * The total is counted on a clone of the query with its select, order and
+     * limit/offset cleared.
+     */
+    paginate<T = any>(query: Knex.QueryBuilder, options?: PageRequest): Promise<Paginated<T>>;
+}
+/** Paginate any Knex query builder into the unified `{ data, meta }` shape. */
+export declare function paginateKnex<T = any>(query: Knex.QueryBuilder, options?: PageRequest): Promise<Paginated<T>>;

package/dist/knex-provider.js

@@ -0,0 +1,71 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnexDB = exports.AVLEON_KNEX_DB = void 0;
+exports.paginateKnex = paginateKnex;
+const core_1 = require("@avleon/core");
+/** DI token holding the initialized Knex instance. Set by `app.useKnex(...)`. */
+exports.AVLEON_KNEX_DB = new core_1.Token("AVLEON_KNEX_DB");
+/**
+ * Injectable accessor for the application's Knex connection.
+ *
+ * The connection itself is created by `app.useKnex(...)`, which registers it
+ * under {@link AVLEON_KNEX_DB}. Resolving this service before that call throws.
+ */
+let KnexDB = class KnexDB {
+    connection;
+    constructor() {
+        const existing = core_1.AvleonContainer.has(exports.AVLEON_KNEX_DB)
+            ? core_1.AvleonContainer.get(exports.AVLEON_KNEX_DB)
+            : null;
+        if (!existing) {
+            throw new Error("Knex is not initialized. Call useKnex first.");
+        }
+        this.connection = existing;
+    }
+    get client() {
+        return this.connection;
+    }
+    /**
+     * Run `query` for one page, returning the unified pagination shape.
+     *
+     * ```ts
+     * const { data, meta } = await db.paginate(db.client("users").where("active", true), { page: 2 });
+     * ```
+     *
+     * The total is counted on a clone of the query with its select, order and
+     * limit/offset cleared.
+     */
+    async paginate(query, options) {
+        return paginateKnex(query, options);
+    }
+};
+exports.KnexDB = KnexDB;
+exports.KnexDB = KnexDB = __decorate([
+    (0, core_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], KnexDB);
+/** Paginate any Knex query builder into the unified `{ data, meta }` shape. */
+async function paginateKnex(query, options) {
+    const { page, perPage, offset } = (0, core_1.normalizePageRequest)(options);
+    const countRow = await query
+        .clone()
+        .clearSelect()
+        .clearOrder()
+        .clear("limit")
+        .clear("offset")
+        .count({ total: "*" })
+        .first();
+    const total = Number(countRow?.total ?? 0);
+    const data = (await query.clone().offset(offset).limit(perPage));
+    return (0, core_1.paginated)(data, total, page, perPage);
+}
+//# sourceMappingURL=knex-provider.js.map

package/dist/knex-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex-provider.js","sourceRoot":"","sources":["../src/knex-provider.ts"],"names":[],"mappings":";;;;;;;;;;;;AA2DA,oCAkBC;AA7ED,uCAQsB;AAGtB,iFAAiF;AACpE,QAAA,cAAc,GAAG,IAAI,YAAK,CAAO,gBAAgB,CAAC,CAAC;AAEhE;;;;;GAKG;AAEI,IAAM,MAAM,GAAZ,MAAM,MAAM;IACA,UAAU,CAAO;IAElC;QACE,MAAM,QAAQ,GAAG,sBAAS,CAAC,GAAG,CAAC,sBAAc,CAAC;YAC5C,CAAC,CAAC,sBAAS,CAAC,GAAG,CAAO,sBAAc,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC;QAET,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAQ,CACZ,KAAwB,EACxB,OAAqB;QAErB,OAAO,YAAY,CAAI,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF,CAAA;AAnCY,wBAAM;iBAAN,MAAM;IADlB,IAAA,iBAAU,GAAE;;GACA,MAAM,CAmClB;AAED,+EAA+E;AACxE,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,OAAqB;IAErB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAA,2BAAoB,EAAC,OAAO,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAQ,MAAM,KAAK;SAC9B,KAAK,EAAE;SACP,WAAW,EAAE;SACb,UAAU,EAAE;SACZ,KAAK,CAAC,OAAc,CAAC;SACrB,KAAK,CAAC,QAAe,CAAC;SACtB,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;SACrB,KAAK,EAAE,CAAC;IACX,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAQ,CAAC;IACxE,OAAO,IAAA,gBAAS,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,21 @@
+import { type AvleonConfigClass } from "@avleon/core";
+import type { Knex } from "knex";
+import type { DataSourceOptions } from "typeorm";
+declare module "@avleon/core" {
+    interface AvleonApplication {
+        /**
+         * Connect Knex from a config object or an `@AppConfig` class, and register
+         * it for `KnexDB`. Resolves once a test query succeeds. The connection is
+         * destroyed when the app shuts down.
+         */
+        useKnex(options: Knex.Config | AvleonConfigClass<Knex.Config>): Promise<this>;
+        /**
+         * Initialize a TypeORM DataSource from its options or an `@AppConfig`
+         * class, and register it for repositories. Resolves once connected. The
+         * DataSource is destroyed when the app shuts down.
+         */
+        useTypeORM(options: DataSourceOptions | AvleonConfigClass<DataSourceOptions>): Promise<this>;
+    }
+}
+export declare const dataPlugin: import("@avleon/core").AvleonPlugin;
+export default dataPlugin;

package/dist/plugin.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataPlugin = void 0;
+const core_1 = require("@avleon/core");
+const datasource_1 = require("./datasource");
+const knex_provider_1 = require("./knex-provider");
+/** Options given directly, or built by an `@AppConfig` class from the environment. */
+function resolveOptions(ctx, options) {
+    if (typeof options === "function" && options.prototype instanceof core_1.AvleonConfig) {
+        const config = ctx.container.get(options);
+        return config.config(ctx.container.get(core_1.Environment));
+    }
+    return options;
+}
+exports.dataPlugin = (0, core_1.definePlugin)({
+    name: "@avleon/data",
+    register(ctx) {
+        ctx.extend("useKnex", async (options) => {
+            const knex = (0, core_1.loadPackageFromClient)("knex");
+            const config = resolveOptions(ctx, options);
+            // Fail early with an install hint if the driver is missing.
+            if (typeof config?.client === "string")
+                (0, core_1.loadPackageFromClient)(config.client);
+            const db = knex(config);
+            ctx.container.set(knex_provider_1.AVLEON_KNEX_DB, db);
+            await db.raw("SELECT 1");
+            ctx.onClose(() => db.destroy());
+            return ctx.app;
+        });
+        ctx.extend("useTypeORM", async (options) => {
+            const typeorm = (0, core_1.loadPackageFromClient)("typeorm");
+            const dataSource = (0, datasource_1.registerDataSource)(new typeorm.DataSource(resolveOptions(ctx, options)));
+            try {
+                await dataSource.initialize();
+            }
+            catch (error) {
+                ctx.logger.error({ err: error }, "Database connection failed");
+                throw error;
+            }
+            ctx.logger.info("Database connected");
+            ctx.onClose(() => dataSource.destroy());
+            return ctx.app;
+        });
+    },
+});
+exports.default = exports.dataPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":";;;AAAA,uCAOsB;AAGtB,6CAAkD;AAClD,mDAAiD;AAqBjD,sFAAsF;AACtF,SAAS,cAAc,CAAI,GAAkB,EAAE,OAAiC;IAC9E,IAAI,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,CAAC,SAAS,YAAY,mBAAY,EAAE,CAAC;QAC/E,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAkB,OAA+B,CAAC,CAAC;QACnF,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAW,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAY,CAAC;AACtB,CAAC;AAEY,QAAA,UAAU,GAAG,IAAA,mBAAY,EAAC;IACrC,IAAI,EAAE,cAAc;IACpB,QAAQ,CAAC,GAAG;QACV,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAqD,EAAE,EAAE;YACpF,MAAM,IAAI,GAAG,IAAA,4BAAqB,EAAwB,MAAM,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,4DAA4D;YAC5D,IAAI,OAAO,MAAM,EAAE,MAAM,KAAK,QAAQ;gBAAE,IAAA,4BAAqB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE7E,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,8BAAc,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACzB,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAChC,OAAO,GAAG,CAAC,GAAG,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CACR,YAAY,EACZ,KAAK,EAAE,OAAiE,EAAE,EAAE;YAC1E,MAAM,OAAO,GAAG,IAAA,4BAAqB,EAA2B,SAAS,CAAC,CAAC;YAC3E,MAAM,UAAU,GAAG,IAAA,+BAAkB,EACnC,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CACrD,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,4BAA4B,CAAC,CAAC;gBAC/D,MAAM,KAAK,CAAC;YACd,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACtC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YACxC,OAAO,GAAG,CAAC,GAAG,CAAC;QACjB,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,kBAAe,kBAAU,CAAC"}

package/dist/repository.d.ts

@@ -0,0 +1,16 @@
+import { type PageRequest, type Paginated } from "@avleon/core";
+import type { EntityTarget, ObjectLiteral, Repository } from "typeorm";
+/** A TypeORM repository extended with the unified `paginate`. */
+export type PaginatedRepository<T extends ObjectLiteral> = Repository<T> & {
+    paginate(options?: PageRequest): Promise<Paginated<T>>;
+};
+/**
+ * The TypeORM repository for `entity`, from the registered DataSource, with
+ * the unified `paginate({ page, perPage })` added.
+ */
+export declare function paginatedRepository<T extends ObjectLiteral>(entity: EntityTarget<T>, dataSource?: import("typeorm").DataSource): PaginatedRepository<T>;
+/**
+ * Inject the TypeORM repository for `model`, extended with the unified
+ * `paginate({ page, perPage })`. Requires a registered DataSource.
+ */
+export declare function InjectRepository<T extends ObjectLiteral>(model: EntityTarget<T>): (object: any, propertyName: string | symbol | undefined, index?: number) => void;

package/dist/repository.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginatedRepository = paginatedRepository;
+exports.InjectRepository = InjectRepository;
+const core_1 = require("@avleon/core");
+const datasource_1 = require("./datasource");
+async function paginateRepository(repo, options) {
+    const { page, perPage, offset } = (0, core_1.normalizePageRequest)(options);
+    const [data, total] = await repo.findAndCount({
+        skip: offset,
+        take: perPage,
+    });
+    return (0, core_1.paginated)(data, total, page, perPage);
+}
+/**
+ * The TypeORM repository for `entity`, from the registered DataSource, with
+ * the unified `paginate({ page, perPage })` added.
+ */
+function paginatedRepository(entity, dataSource = (0, datasource_1.getDataSource)()) {
+    return dataSource.getRepository(entity).extend({
+        paginate(options) {
+            return paginateRepository(this, options);
+        },
+    });
+}
+/**
+ * Inject the TypeORM repository for `model`, extended with the unified
+ * `paginate({ page, perPage })`. Requires a registered DataSource.
+ */
+function InjectRepository(model) {
+    return (0, core_1.createInjectDecorator)(() => paginatedRepository(model));
+}
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":";;AA+BA,kDASC;AAMD,4CAIC;AAlDD,uCAMsB;AAEtB,6CAA6C;AAO7C,KAAK,UAAU,kBAAkB,CAC/B,IAAmB,EACnB,OAAqB;IAErB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAA,2BAAoB,EAAC,OAAO,CAAC,CAAC;IAChE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;QAC5C,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IACH,OAAO,IAAA,gBAAS,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,MAAuB,EACvB,UAAU,GAAG,IAAA,0BAAa,GAAE;IAE5B,OAAO,UAAU,CAAC,aAAa,CAAI,MAAM,CAAC,CAAC,MAAM,CAAC;QAChD,QAAQ,CAAsB,OAAqB;YACjD,OAAO,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;KACF,CAA2B,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAC9B,KAAsB;IAEtB,OAAO,IAAA,4BAAqB,EAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/typeorm-provider.d.ts

@@ -0,0 +1,120 @@
+import type { EntityManager, EntityTarget, FindManyOptions, FindOneOptions, FindOptionsWhere, DeepPartial, Repository as OrmRepository, ObjectLiteral, SelectQueryBuilder, QueryRunner, InsertResult, UpdateResult, DeleteResult, ObjectId, SaveOptions, RemoveOptions, EntityMetadata } from "typeorm";
+import { type Constructor, type PageRequest, type Paginated } from "@avleon/core";
+export declare const Like: typeof import("typeorm").Like;
+export declare const ILike: typeof import("typeorm").ILike;
+export declare const In: typeof import("typeorm").In;
+export declare const Not: typeof import("typeorm").Not;
+export declare const Between: typeof import("typeorm").Between;
+export declare const LessThan: typeof import("typeorm").LessThan;
+export declare const LessThanOrEqual: typeof import("typeorm").LessThanOrEqual;
+export declare const MoreThan: typeof import("typeorm").MoreThan;
+export declare const MoreThanOrEqual: typeof import("typeorm").MoreThanOrEqual;
+export declare const IsNull: typeof import("typeorm").IsNull;
+export declare const Any: typeof import("typeorm").Any;
+export declare const Raw: typeof import("typeorm").Raw;
+export declare const Equal: typeof import("typeorm").Equal;
+export declare const ArrayContains: typeof import("typeorm").ArrayContains;
+/** @deprecated Use {@link PageRequest} (`{ page, perPage }`). */
+export interface PaginationOptions {
+    page: number;
+    limit: number;
+}
+/** @deprecated Use {@link Paginated}. Kept as an alias of the unified shape. */
+export type PaginatedResult<T> = Paginated<T>;
+export interface SoftDeletable {
+    deletedAt?: Date | null;
+}
+export declare class AvleonRepository<TEntity extends ObjectLiteral> {
+    protected orm: OrmRepository<TEntity>;
+    protected entity: EntityTarget<TEntity>;
+    protected manager: EntityManager;
+    /**
+     * Both arguments are optional for `@Repository(Entity)` classes: the entity
+     * comes from the decorator and the manager from the registered DataSource,
+     * so a subclass constructor can take its own injected dependencies and
+     * call `super()` with no arguments.
+     */
+    constructor(entity?: EntityTarget<TEntity>, manager?: EntityManager);
+    get metadata(): EntityMetadata;
+    get target(): EntityTarget<TEntity>;
+    find(options?: FindManyOptions<TEntity>): Promise<TEntity[]>;
+    findOne(options: FindOneOptions<TEntity>): Promise<TEntity | null>;
+    findOneBy(where: FindOptionsWhere<TEntity> | FindOptionsWhere<TEntity>[]): Promise<TEntity | null>;
+    findBy(where: FindOptionsWhere<TEntity> | FindOptionsWhere<TEntity>[]): Promise<TEntity[]>;
+    findById(id: number | string | ObjectId): Promise<TEntity | null>;
+    findByIds(ids: (number | string | ObjectId)[]): Promise<TEntity[]>;
+    findAndCount(options?: FindManyOptions<TEntity>): Promise<[TEntity[], number]>;
+    findAndCountBy(where: FindOptionsWhere<TEntity> | FindOptionsWhere<TEntity>[]): Promise<[TEntity[], number]>;
+    count(options?: FindManyOptions<TEntity>): Promise<number>;
+    countBy(where: FindOptionsWhere<TEntity> | FindOptionsWhere<TEntity>[]): Promise<number>;
+    exists(options?: FindManyOptions<TEntity>): Promise<boolean>;
+    existsBy(where: FindOptionsWhere<TEntity> | FindOptionsWhere<TEntity>[]): Promise<boolean>;
+    /**
+     * Fetch one page of entities.
+     *
+     * ```ts
+     * const { data, meta } = await repo.paginate({ where: { active: true } }, { page: 2, perPage: 20 });
+     * ```
+     */
+    paginate(options?: FindManyOptions<TEntity>, pagination?: PageRequest): Promise<Paginated<TEntity>>;
+    create(data?: DeepPartial<TEntity>): TEntity[];
+    createMany(dataArray: DeepPartial<TEntity>[]): TEntity[][];
+    save(data: DeepPartial<TEntity>, options?: SaveOptions): Promise<TEntity>;
+    saveMany(dataArray: DeepPartial<TEntity>[], options?: SaveOptions): Promise<TEntity[]>;
+    insert(data: DeepPartial<TEntity> | DeepPartial<TEntity>[]): Promise<InsertResult>;
+    upsert(data: DeepPartial<TEntity> | DeepPartial<TEntity>[], conflictPaths: string[] | any): Promise<InsertResult>;
+    update(criteria: string | string[] | number | number[] | FindOptionsWhere<TEntity>, data: DeepPartial<TEntity>): Promise<UpdateResult>;
+    updateById(id: number | string, data: DeepPartial<TEntity>): Promise<UpdateResult>;
+    delete(criteria: string | string[] | number | number[] | FindOptionsWhere<TEntity>): Promise<DeleteResult>;
+    deleteById(id: number | string): Promise<DeleteResult>;
+    remove(entity: TEntity, options?: RemoveOptions): Promise<TEntity>;
+    removeMany(entities: TEntity[], options?: RemoveOptions): Promise<TEntity[]>;
+    softDelete(criteria: string | string[] | number | number[] | FindOptionsWhere<TEntity>): Promise<UpdateResult>;
+    softDeleteById(id: number | string): Promise<UpdateResult>;
+    restore(criteria: string | string[] | number | number[] | FindOptionsWhere<TEntity>): Promise<UpdateResult>;
+    softRemove(entity: TEntity, options?: SaveOptions): Promise<TEntity>;
+    sum(column: keyof TEntity, where?: FindOptionsWhere<TEntity>): Promise<number | null>;
+    avg(column: keyof TEntity, where?: FindOptionsWhere<TEntity>): Promise<number | null>;
+    min(column: keyof TEntity, where?: FindOptionsWhere<TEntity>): Promise<number | null>;
+    max(column: keyof TEntity, where?: FindOptionsWhere<TEntity>): Promise<number | null>;
+    /**
+     * Run a callback inside a transaction. If the callback throws,
+     * the transaction is rolled back automatically.
+     */
+    transaction<T>(work: (repo: this, queryRunner: QueryRunner) => Promise<T>): Promise<T>;
+    /**
+     * A copy of this repository bound to another `EntityManager` (for example a
+     * transaction's). The copy keeps every injected dependency of the original;
+     * no constructor runs.
+     */
+    withManager(manager: EntityManager): this;
+    /** Create a QueryBuilder with a default alias of the entity table name. */
+    qb(alias?: string): SelectQueryBuilder<TEntity>;
+    /**
+     * Efficient bulk insert using chunking to avoid hitting SQL parameter limits.
+     */
+    bulkInsert(rows: DeepPartial<TEntity>[], chunkSize?: number): Promise<void>;
+    /**
+     * Execute raw SQL. Use sparingly — prefer the query builder.
+     * @param sql  Parameterised SQL string
+     * @param params  Positional parameters
+     */
+    raw<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    protected getRepository(): OrmRepository<TEntity>;
+    protected getManager(): EntityManager;
+}
+/**
+ * Class decorator that registers a repository with the DI container and binds
+ * it to `entity`. The DataSource is resolved from the container when the
+ * repository is constructed.
+ *
+ * The class keeps its own constructor, so it can inject other services:
+ *
+ * ```ts
+ * @Repository(User)
+ * class UserRepository extends AvleonRepository<User> {
+ *   constructor(private readonly audit: AuditService) { super(); }
+ * }
+ * ```
+ */
+export declare function Repository<TEntity extends ObjectLiteral>(entity: EntityTarget<TEntity>): <TBase extends Constructor<AvleonRepository<TEntity>>>(Base: TBase) => TBase;

package/dist/typeorm-provider.js

@@ -0,0 +1,303 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AvleonRepository = exports.ArrayContains = exports.Equal = exports.Raw = exports.Any = exports.IsNull = exports.MoreThanOrEqual = exports.MoreThan = exports.LessThanOrEqual = exports.LessThan = exports.Between = exports.Not = exports.In = exports.ILike = exports.Like = void 0;
+exports.Repository = Repository;
+const core_1 = require("@avleon/core");
+const datasource_1 = require("./datasource");
+function typeormOperator(name) {
+    return ((...args) => {
+        const typeorm = (0, core_1.loadPackageFromClient)("typeorm");
+        return typeorm[name](...args);
+    });
+}
+exports.Like = typeormOperator("Like");
+exports.ILike = typeormOperator("ILike");
+exports.In = typeormOperator("In");
+exports.Not = typeormOperator("Not");
+exports.Between = typeormOperator("Between");
+exports.LessThan = typeormOperator("LessThan");
+exports.LessThanOrEqual = typeormOperator("LessThanOrEqual");
+exports.MoreThan = typeormOperator("MoreThan");
+exports.MoreThanOrEqual = typeormOperator("MoreThanOrEqual");
+exports.IsNull = typeormOperator("IsNull");
+exports.Any = typeormOperator("Any");
+exports.Raw = typeormOperator("Raw");
+exports.Equal = typeormOperator("Equal");
+exports.ArrayContains = typeormOperator("ArrayContains");
+// ─── Base Repository ─────────────────────────────────────────────────────────
+const REPOSITORY_ENTITY = Symbol.for("avleon:repository:entity");
+class AvleonRepository {
+    orm;
+    entity;
+    manager;
+    /**
+     * Both arguments are optional for `@Repository(Entity)` classes: the entity
+     * comes from the decorator and the manager from the registered DataSource,
+     * so a subclass constructor can take its own injected dependencies and
+     * call `super()` with no arguments.
+     */
+    constructor(entity, manager) {
+        const resolvedEntity = entity ??
+            this.constructor[REPOSITORY_ENTITY];
+        if (!resolvedEntity) {
+            throw new Error(`[Avleon] ${this.constructor.name} has no entity. Decorate it with @Repository(Entity) or pass the entity to super().`);
+        }
+        this.entity = resolvedEntity;
+        this.manager = manager ?? (0, datasource_1.getDataSource)().manager;
+        this.orm = this.manager.getRepository(this.entity);
+    }
+    // ─── Metadata ────────────────────────────────────────────────────────────
+    get metadata() {
+        return this.orm.metadata;
+    }
+    get target() {
+        return this.entity;
+    }
+    // ─── Basic CRUD ──────────────────────────────────────────────────────────
+    find(options) {
+        return this.orm.find(options);
+    }
+    findOne(options) {
+        return this.orm.findOne(options);
+    }
+    findOneBy(where) {
+        return this.orm.findOneBy(where);
+    }
+    findBy(where) {
+        return this.orm.findBy(where);
+    }
+    findById(id) {
+        return this.orm.findOne({ where: { id } });
+    }
+    findByIds(ids) {
+        return this.orm.findBy({ id: (0, exports.In)(ids) });
+    }
+    findAndCount(options) {
+        return this.orm.findAndCount(options);
+    }
+    findAndCountBy(where) {
+        return this.orm.findAndCountBy(where);
+    }
+    count(options) {
+        return this.orm.count(options);
+    }
+    countBy(where) {
+        return this.orm.countBy(where);
+    }
+    exists(options) {
+        return this.orm.exists(options);
+    }
+    existsBy(where) {
+        return this.orm.existsBy(where);
+    }
+    // ─── Pagination ──────────────────────────────────────────────────────────
+    /**
+     * Fetch one page of entities.
+     *
+     * ```ts
+     * const { data, meta } = await repo.paginate({ where: { active: true } }, { page: 2, perPage: 20 });
+     * ```
+     */
+    async paginate(options = {}, pagination = {}) {
+        const { page, perPage, offset } = (0, core_1.normalizePageRequest)(pagination);
+        const [data, total] = await this.orm.findAndCount({
+            ...options,
+            skip: offset,
+            take: perPage,
+        });
+        return (0, core_1.paginated)(data, total, page, perPage);
+    }
+    // ─── Create & Save ───────────────────────────────────────────────────────
+    create(data) {
+        return this.orm.create(data);
+    }
+    createMany(dataArray) {
+        return dataArray.map((d) => this.orm.create(d));
+    }
+    async save(data, options) {
+        return this.orm.save(data, options);
+    }
+    async saveMany(dataArray, options) {
+        return this.orm.save(dataArray, options);
+    }
+    // ─── Insert ──────────────────────────────────────────────────────────────
+    async insert(data) {
+        return this.orm.insert(data);
+    }
+    // ─── Upsert ──────────────────────────────────────────────────────────────
+    async upsert(data, conflictPaths) {
+        return this.orm.upsert(data, conflictPaths);
+    }
+    // ─── Update ──────────────────────────────────────────────────────────────
+    async update(criteria, data) {
+        return this.orm.update(criteria, data);
+    }
+    async updateById(id, data) {
+        return this.orm.update(id, data);
+    }
+    // ─── Delete & Remove ─────────────────────────────────────────────────────
+    async delete(criteria) {
+        return this.orm.delete(criteria);
+    }
+    async deleteById(id) {
+        return this.orm.delete(id);
+    }
+    async remove(entity, options) {
+        return this.orm.remove(entity, options);
+    }
+    async removeMany(entities, options) {
+        return this.orm.remove(entities, options);
+    }
+    // ─── Soft Delete (requires @DeleteDateColumn) ────────────────────────────
+    async softDelete(criteria) {
+        return this.orm.softDelete(criteria);
+    }
+    async softDeleteById(id) {
+        return this.orm.softDelete(id);
+    }
+    async restore(criteria) {
+        return this.orm.restore(criteria);
+    }
+    async softRemove(entity, options) {
+        return this.orm.softRemove(entity, options);
+    }
+    // ─── Aggregation via Query Builder ───────────────────────────────────────
+    async sum(column, where) {
+        const alias = "e";
+        const qb = this.orm
+            .createQueryBuilder(alias)
+            .select(`SUM(${alias}.${String(column)})`, "sum");
+        if (where)
+            qb.where(where);
+        const result = await qb.getRawOne();
+        return result?.sum != null ? Number(result.sum) : null;
+    }
+    async avg(column, where) {
+        const alias = "e";
+        const qb = this.orm
+            .createQueryBuilder(alias)
+            .select(`AVG(${alias}.${String(column)})`, "avg");
+        if (where)
+            qb.where(where);
+        const result = await qb.getRawOne();
+        return result?.avg != null ? Number(result.avg) : null;
+    }
+    async min(column, where) {
+        const alias = "e";
+        const qb = this.orm
+            .createQueryBuilder(alias)
+            .select(`MIN(${alias}.${String(column)})`, "min");
+        if (where)
+            qb.where(where);
+        const result = await qb.getRawOne();
+        return result?.min != null ? Number(result.min) : null;
+    }
+    async max(column, where) {
+        const alias = "e";
+        const qb = this.orm
+            .createQueryBuilder(alias)
+            .select(`MAX(${alias}.${String(column)})`, "max");
+        if (where)
+            qb.where(where);
+        const result = await qb.getRawOne();
+        return result?.max != null ? Number(result.max) : null;
+    }
+    // ─── Transactions ────────────────────────────────────────────────────────
+    /**
+     * Run a callback inside a transaction. If the callback throws,
+     * the transaction is rolled back automatically.
+     */
+    async transaction(work) {
+        // Already inside a transaction: join it rather than opening a new one.
+        const current = this.manager.queryRunner;
+        if (current?.isTransactionActive) {
+            return work(this, current);
+        }
+        const queryRunner = this.manager.connection.createQueryRunner();
+        await queryRunner.connect();
+        await queryRunner.startTransaction();
+        const txRepo = this.withManager(queryRunner.manager);
+        try {
+            const result = await work(txRepo, queryRunner);
+            await queryRunner.commitTransaction();
+            return result;
+        }
+        catch (err) {
+            await queryRunner.rollbackTransaction();
+            throw err;
+        }
+        finally {
+            await queryRunner.release();
+        }
+    }
+    /**
+     * A copy of this repository bound to another `EntityManager` (for example a
+     * transaction's). The copy keeps every injected dependency of the original;
+     * no constructor runs.
+     */
+    withManager(manager) {
+        const copy = Object.create(Object.getPrototypeOf(this));
+        Object.assign(copy, this);
+        copy.manager = manager;
+        copy.orm = manager.getRepository(this.entity);
+        return copy;
+    }
+    // ─── Query Builder Access ────────────────────────────────────────────────
+    /** Create a QueryBuilder with a default alias of the entity table name. */
+    qb(alias) {
+        return this.orm.createQueryBuilder(alias ?? this.orm.metadata.tableName);
+    }
+    // ─── Bulk / Raw ──────────────────────────────────────────────────────────
+    /**
+     * Efficient bulk insert using chunking to avoid hitting SQL parameter limits.
+     */
+    async bulkInsert(rows, chunkSize = 500) {
+        for (let i = 0; i < rows.length; i += chunkSize) {
+            await this.orm.insert(rows.slice(i, i + chunkSize));
+        }
+    }
+    /**
+     * Execute raw SQL. Use sparingly — prefer the query builder.
+     * @param sql  Parameterised SQL string
+     * @param params  Positional parameters
+     */
+    async raw(sql, params) {
+        return this.manager.query(sql, params);
+    }
+    // ─── Protected helpers ───────────────────────────────────────────────────
+    getRepository() {
+        return this.orm;
+    }
+    getManager() {
+        return this.manager;
+    }
+}
+exports.AvleonRepository = AvleonRepository;
+// ─── @Repository decorator ───────────────────────────────────────────────────
+/**
+ * Class decorator that registers a repository with the DI container and binds
+ * it to `entity`. The DataSource is resolved from the container when the
+ * repository is constructed.
+ *
+ * The class keeps its own constructor, so it can inject other services:
+ *
+ * ```ts
+ * @Repository(User)
+ * class UserRepository extends AvleonRepository<User> {
+ *   constructor(private readonly audit: AuditService) { super(); }
+ * }
+ * ```
+ */
+function Repository(entity) {
+    return function (Base) {
+        Object.defineProperty(Base, REPOSITORY_ENTITY, {
+            value: entity,
+            enumerable: false,
+            configurable: true,
+            writable: true,
+        });
+        (0, core_1.Injectable)()(Base);
+        return Base;
+    };
+}
+//# sourceMappingURL=typeorm-provider.js.map

package/dist/typeorm-provider.js.map

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

package/package.json

@@ -1,6 +1,100 @@
 {
   "name": "@avleon/data",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.0",
+  "description": "TypeORM and Knex integration for Avleon",
+  "author": "Tareq Hossain",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "require": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "avleon": {
+    "plugin": "./dist/plugin.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "avleon",
+    "typeorm",
+    "knex",
+    "database",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@avleon/core": "^0.4.0",
+    "better-sqlite3": ">=12.0.0",
+    "knex": ">=2.0.0",
+    "mssql": ">=11.0.0",
+    "mysql2": ">=3.0.0",
+    "pg": ">=8.0.0",
+    "sqlite3": ">=5.0.0",
+    "typeorm": ">=0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    },
+    "knex": {
+      "optional": true
+    },
+    "mssql": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "sqlite3": {
+      "optional": true
+    },
+    "typeorm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@avleon/core": "^0.4.0",
+    "@swc/core": "^1.16.20",
+    "@types/node": "^20.19.17",
+    "better-sqlite3": "^12.9.0",
+    "knex": "^3.1.0",
+    "reflect-metadata": "^0.2.2",
+    "typeorm": "^0.3.28",
+    "typescript": "^5.7.2",
+    "unplugin-swc": "^2.0.0",
+    "vitest": "^4.1.12"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avleonjs/avleon.git",
+    "directory": "packages/data"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}