@goodie-ts/kysely 0.5.4 → 0.6.1

package/README.md

@@ -1,6 +1,6 @@
 # @goodie-ts/kysely
 
-[Kysely](https://kysely.dev/) integration for [goodie-ts](https://github.com/GOOD-Code-ApS/goodie) — declarative transactions, auto-wired migrations, and a CRUD repository base class.
+[Kysely](https://kysely.dev/) integration for [goodie-ts](https://github.com/GOOD-Code-ApS/goodie) — `KyselyDatabase` library bean, declarative transactions, and auto-wired migrations.
 
 ## Install
 
@@ -10,7 +10,7 @@ pnpm add @goodie-ts/kysely kysely
 
 ## Overview
 
-Provides `@Transactional` for declarative transaction management, `@Migration` for auto-discovered database migrations, and `CrudRepository<T>` for common CRUD operations. All backed by `TransactionManager` which uses `AsyncLocalStorage` for transaction propagation.
+Provides `KyselyDatabase` as a library-provided `@Singleton` that creates and manages a `Kysely<any>` instance from configuration. Use `@Module` with `@Provides` for typed `Kysely<DB>` access. Includes `@Transactional` for declarative transaction management, `@Migration` for auto-discovered database migrations, and `TransactionManager` with `AsyncLocalStorage` for transaction propagation.
 
 ## Decorators
 
@@ -22,13 +22,26 @@ Provides `@Transactional` for declarative transaction management, `@Migration` f
 ## Usage
 
 ```typescript
-import { Singleton } from '@goodie-ts/core';
-import { Transactional, CrudRepository, TransactionManager } from '@goodie-ts/kysely';
+import { Module, Provides, Singleton } from '@goodie-ts/core';
+import { KyselyDatabase, Transactional } from '@goodie-ts/kysely';
+import type { Kysely } from 'kysely';
+
+@Module()
+class DatabaseModule {
+  constructor(private db: KyselyDatabase) {}
+
+  @Provides()
+  typedKysely(): Kysely<Database> {
+    return this.db.kysely as Kysely<Database>;
+  }
+}
 
 @Singleton()
-class TodoRepository extends CrudRepository<Todo> {
-  constructor(transactionManager: TransactionManager) {
-    super('todos', transactionManager);
+class TodoRepository {
+  constructor(private readonly db: Kysely<Database>) {}
+
+  async findAll(): Promise<Todo[]> {
+    return this.db.selectFrom('todos').selectAll().execute();
   }
 }
 
@@ -39,7 +52,7 @@ class TodoService {
   @Transactional()
   async createMany(titles: string[]) {
     for (const title of titles) {
-      await this.repo.save({ title, completed: false });
+      await this.repo.create(title);
     }
     // All-or-nothing: rolls back on error
   }
@@ -80,7 +93,7 @@ export default defineConfig({
 });
 ```
 
-The `database` option specifies the class name of your Kysely wrapper (a `@Singleton` with a `.kysely` property).
+The kysely plugin is auto-discovered — no manual `plugins` configuration needed. `KyselyDatabase` is provided as a library bean.
 
 ## License
 

package/dist/beans.json

@@ -0,0 +1,184 @@
+{
+  "version": 1,
+  "package": "@goodie-ts/kysely",
+  "beans": [
+    {
+      "tokenRef": {
+        "kind": "class",
+        "className": "PoolConfig",
+        "importPath": "@goodie-ts/kysely"
+      },
+      "scope": "singleton",
+      "eager": false,
+      "name": null,
+      "constructorDeps": [],
+      "fieldDeps": [],
+      "factoryKind": "constructor",
+      "providesSource": null,
+      "baseTokenRefs": null,
+      "decorators": [
+        {
+          "name": "Singleton",
+          "importPath": "@goodie-ts/kysely"
+        },
+        {
+          "name": "ConfigurationProperties",
+          "importPath": "@goodie-ts/kysely"
+        }
+      ],
+      "methodDecorators": null,
+      "metadata": {
+        "valueFields": [
+          {
+            "fieldName": "min",
+            "key": "datasource.pool.min",
+            "default": "2"
+          },
+          {
+            "fieldName": "max",
+            "key": "datasource.pool.max",
+            "default": "10"
+          }
+        ]
+      },
+      "sourceLocation": {
+        "filePath": "@goodie-ts/kysely",
+        "line": 11,
+        "column": 1
+      }
+    },
+    {
+      "tokenRef": {
+        "kind": "class",
+        "className": "DatasourceConfig",
+        "importPath": "@goodie-ts/kysely"
+      },
+      "scope": "singleton",
+      "eager": false,
+      "name": null,
+      "constructorDeps": [
+        {
+          "tokenRef": {
+            "kind": "class",
+            "className": "PoolConfig",
+            "importPath": "@goodie-ts/kysely"
+          },
+          "optional": false,
+          "collection": false,
+          "sourceLocation": {
+            "filePath": "@goodie-ts/kysely",
+            "line": 40,
+            "column": 15
+          }
+        }
+      ],
+      "fieldDeps": [],
+      "factoryKind": "constructor",
+      "providesSource": null,
+      "baseTokenRefs": null,
+      "decorators": [
+        {
+          "name": "Singleton",
+          "importPath": "@goodie-ts/kysely"
+        },
+        {
+          "name": "ConfigurationProperties",
+          "importPath": "@goodie-ts/kysely"
+        }
+      ],
+      "methodDecorators": {
+        "validate": [
+          {
+            "name": "PostConstruct",
+            "importPath": "@goodie-ts/kysely"
+          }
+        ]
+      },
+      "metadata": {
+        "postConstructMethods": [
+          "validate"
+        ],
+        "valueFields": [
+          {
+            "fieldName": "url",
+            "key": "datasource.url",
+            "default": "''"
+          },
+          {
+            "fieldName": "dialect",
+            "key": "datasource.dialect",
+            "default": "''"
+          }
+        ]
+      },
+      "sourceLocation": {
+        "filePath": "@goodie-ts/kysely",
+        "line": 34,
+        "column": 1
+      }
+    },
+    {
+      "tokenRef": {
+        "kind": "class",
+        "className": "KyselyDatabase",
+        "importPath": "@goodie-ts/kysely"
+      },
+      "scope": "singleton",
+      "eager": false,
+      "name": null,
+      "constructorDeps": [
+        {
+          "tokenRef": {
+            "kind": "class",
+            "className": "DatasourceConfig",
+            "importPath": "@goodie-ts/kysely"
+          },
+          "optional": false,
+          "collection": false,
+          "sourceLocation": {
+            "filePath": "@goodie-ts/kysely",
+            "line": 35,
+            "column": 15
+          }
+        }
+      ],
+      "fieldDeps": [],
+      "factoryKind": "constructor",
+      "providesSource": null,
+      "baseTokenRefs": null,
+      "decorators": [
+        {
+          "name": "Singleton",
+          "importPath": "@goodie-ts/kysely"
+        }
+      ],
+      "methodDecorators": {
+        "init": [
+          {
+            "name": "PostConstruct",
+            "importPath": "@goodie-ts/kysely"
+          }
+        ],
+        "destroy": [
+          {
+            "name": "PreDestroy",
+            "importPath": "@goodie-ts/kysely"
+          }
+        ]
+      },
+      "metadata": {
+        "preDestroyMethods": [
+          "destroy"
+        ],
+        "postConstructMethods": [
+          "init"
+        ]
+      },
+      "sourceLocation": {
+        "filePath": "@goodie-ts/kysely",
+        "line": 31,
+        "column": 1
+      }
+    }
+  ]
+}

package/dist/datasource-config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Connection pool configuration, bound from `datasource.pool.*` keys.
+ */
+export declare class PoolConfig {
+    min: number;
+    max: number;
+}
+/**
+ * Configuration properties for the datasource, bound from `datasource.*` keys.
+ *
+ * Users configure via `config/default.json`:
+ * ```json
+ * {
+ *   "datasource": {
+ *     "url": "postgres://localhost:5432/mydb",
+ *     "dialect": "postgres",
+ *     "pool": { "min": 2, "max": 10 }
+ *   }
+ * }
+ * ```
+ *
+ * Or via environment variables: `DATASOURCE_URL`, `DATASOURCE_DIALECT`, etc.
+ */
+export declare class DatasourceConfig {
+    readonly pool: PoolConfig;
+    url: string;
+    dialect: string;
+    constructor(pool: PoolConfig);
+    validate(): void;
+}
+//# sourceMappingURL=datasource-config.d.ts.map

package/dist/datasource-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource-config.d.ts","sourceRoot":"","sources":["../src/datasource-config.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,qBAEa,UAAU;IACrB,GAAG,SAAK;IACR,GAAG,SAAM;CACV;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAEa,gBAAgB;IAIf,QAAQ,CAAC,IAAI,EAAE,UAAU;IAHrC,GAAG,SAAM;IACT,OAAO,SAAM;gBAEQ,IAAI,EAAE,UAAU;IAGrC,QAAQ;CAcT"}

package/dist/datasource-config.js

@@ -0,0 +1,113 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { ConfigurationProperties, PostConstruct, Singleton, } from '@goodie-ts/core';
+import { validateDialect } from './dialect.js';
+/**
+ * Connection pool configuration, bound from `datasource.pool.*` keys.
+ */
+let PoolConfig = (() => {
+    let _classDecorators = [Singleton(), ConfigurationProperties('datasource.pool')];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var PoolConfig = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            PoolConfig = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        min = 2;
+        max = 10;
+    };
+    return PoolConfig = _classThis;
+})();
+export { PoolConfig };
+/**
+ * Configuration properties for the datasource, bound from `datasource.*` keys.
+ *
+ * Users configure via `config/default.json`:
+ * ```json
+ * {
+ *   "datasource": {
+ *     "url": "postgres://localhost:5432/mydb",
+ *     "dialect": "postgres",
+ *     "pool": { "min": 2, "max": 10 }
+ *   }
+ * }
+ * ```
+ *
+ * Or via environment variables: `DATASOURCE_URL`, `DATASOURCE_DIALECT`, etc.
+ */
+let DatasourceConfig = (() => {
+    let _classDecorators = [Singleton(), ConfigurationProperties('datasource')];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _instanceExtraInitializers = [];
+    let _validate_decorators;
+    var DatasourceConfig = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _validate_decorators = [PostConstruct()];
+            __esDecorate(this, null, _validate_decorators, { kind: "method", name: "validate", static: false, private: false, access: { has: obj => "validate" in obj, get: obj => obj.validate }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            DatasourceConfig = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        pool = __runInitializers(this, _instanceExtraInitializers);
+        url = '';
+        dialect = '';
+        constructor(pool) {
+            this.pool = pool;
+        }
+        validate() {
+            if (!this.dialect) {
+                throw new Error("DatasourceConfig: 'datasource.dialect' is required. Supported dialects: postgres, mysql, sqlite");
+            }
+            validateDialect(this.dialect);
+            if (!this.url) {
+                throw new Error("DatasourceConfig: 'datasource.url' is required. Example: postgres://localhost:5432/mydb");
+            }
+        }
+    };
+    return DatasourceConfig = _classThis;
+})();
+export { DatasourceConfig };
+//# sourceMappingURL=datasource-config.js.map

package/dist/datasource-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource-config.js","sourceRoot":"","sources":["../src/datasource-config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;IAGU,UAAU;4BAFtB,SAAS,EAAE,EACX,uBAAuB,CAAC,iBAAiB,CAAC;;;;;;;;YAC3C,6KAGC;;;YAHY,uDAAU;;QACrB,GAAG,GAAG,CAAC,CAAC;QACR,GAAG,GAAG,EAAE,CAAC;;;;SAFE,UAAU;AAKvB;;;;;;;;;;;;;;;GAeG;IAGU,gBAAgB;4BAF5B,SAAS,EAAE,EACX,uBAAuB,CAAC,YAAY,CAAC;;;;;;;;;;oCAOnC,aAAa,EAAE;YAChB,2KAAA,QAAQ,6DAaP;YApBH,6KAqBC;;;YArBY,uDAAgB;;QAIN,IAAI,GAJd,mDAAgB;QAC3B,GAAG,GAAG,EAAE,CAAC;QACT,OAAO,GAAG,EAAE,CAAC;QAEb,YAAqB,IAAgB;YAAhB,SAAI,GAAJ,IAAI,CAAY;QAAG,CAAC;QAGzC,QAAQ;YACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;YACJ,CAAC;YACD,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE9B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;YACJ,CAAC;QACH,CAAC;;;;SApBU,gBAAgB"}

package/dist/dialect-factory.d.ts

@@ -0,0 +1,9 @@
+import type { DatasourceConfig } from './datasource-config.js';
+/**
+ * Create a Kysely dialect instance from DatasourceConfig.
+ *
+ * Dynamically imports the appropriate driver package based on `config.dialect`.
+ * The driver packages are optional peer dependencies — users install only what they need.
+ */
+export default function createDialect(config: DatasourceConfig): Promise<import("kysely").PostgresDialect | import("kysely").MysqlDialect | import("kysely").SqliteDialect>;
+//# sourceMappingURL=dialect-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialect-factory.d.ts","sourceRoot":"","sources":["../src/dialect-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;;;;GAKG;AACH,wBAA8B,aAAa,CAAC,MAAM,EAAE,gBAAgB,8GAcnE"}

package/dist/dialect-factory.js

@@ -0,0 +1,48 @@
+/**
+ * Create a Kysely dialect instance from DatasourceConfig.
+ *
+ * Dynamically imports the appropriate driver package based on `config.dialect`.
+ * The driver packages are optional peer dependencies — users install only what they need.
+ */
+export default async function createDialect(config) {
+    const dialect = config.dialect;
+    switch (dialect) {
+        case 'postgres':
+            return createPostgresDialect(config);
+        case 'mysql':
+            return createMysqlDialect(config);
+        case 'sqlite':
+            return createSqliteDialect(config);
+        default:
+            throw new Error(`Unsupported dialect: '${dialect}'. Supported dialects: 'postgres', 'mysql', 'sqlite'.`);
+    }
+}
+async function createPostgresDialect(config) {
+    const { Pool } = await import('pg');
+    const { PostgresDialect } = await import('kysely');
+    return new PostgresDialect({
+        pool: new Pool({
+            connectionString: config.url,
+            min: config.pool.min,
+            max: config.pool.max,
+        }),
+    });
+}
+async function createMysqlDialect(config) {
+    const mysql2 = await import('mysql2/promise');
+    const { MysqlDialect } = await import('kysely');
+    return new MysqlDialect({
+        pool: mysql2.createPool({
+            uri: config.url,
+            connectionLimit: config.pool.max,
+        }),
+    });
+}
+async function createSqliteDialect(config) {
+    const BetterSqlite3 = await import('better-sqlite3');
+    const { SqliteDialect } = await import('kysely');
+    return new SqliteDialect({
+        database: new BetterSqlite3.default(config.url),
+    });
+}
+//# sourceMappingURL=dialect-factory.js.map

package/dist/dialect-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect-factory.js","sourceRoot":"","sources":["../src/dialect-factory.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,aAAa,CAAC,MAAwB;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAkB,CAAC;IAC1C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,OAAO;YACV,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC;YACE,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,uDAAuD,CACxF,CAAC;IACN,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,MAAwB;IAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,IAAI,eAAe,CAAC;QACzB,IAAI,EAAE,IAAI,IAAI,CAAC;YACb,gBAAgB,EAAE,MAAM,CAAC,GAAG;YAC5B,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;YACpB,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;SACrB,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAwB;IACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;YACtB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;SACjC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,MAAwB;IACzD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,IAAI,aAAa,CAAC;QACvB,QAAQ,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/dialect.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Supported database dialects.
+ *
+ * Used by `DatasourceConfig` to configure the database connection
+ * and by `TransactionManager` to determine dialect capabilities
+ * like `RETURNING` clause support.
+ */
+export type Dialect = 'postgres' | 'mysql' | 'sqlite';
+/** All valid dialect values. Used for validation at config injection time. */
+export declare const DIALECTS: readonly Dialect[];
+/**
+ * Whether the given dialect supports `RETURNING` clauses natively.
+ *
+ * - **postgres**: `INSERT/UPDATE/DELETE ... RETURNING *`
+ * - **sqlite**: `INSERT/UPDATE/DELETE ... RETURNING *` (since 3.35)
+ * - **mysql**: No native support — falls back to INSERT + SELECT
+ */
+export declare function supportsReturning(dialect: Dialect): boolean;
+/**
+ * Validate that a string is a supported dialect.
+ * Throws at DI startup if the user provides an unsupported value.
+ */
+export declare function validateDialect(value: string): Dialect;
+//# sourceMappingURL=dialect.d.ts.map

package/dist/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAI7B,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOtD"}

package/dist/dialect.js

@@ -0,0 +1,33 @@
+/** All valid dialect values. Used for validation at config injection time. */
+export const DIALECTS = [
+    'postgres',
+    'mysql',
+    'sqlite',
+];
+/**
+ * Whether the given dialect supports `RETURNING` clauses natively.
+ *
+ * - **postgres**: `INSERT/UPDATE/DELETE ... RETURNING *`
+ * - **sqlite**: `INSERT/UPDATE/DELETE ... RETURNING *` (since 3.35)
+ * - **mysql**: No native support — falls back to INSERT + SELECT
+ */
+export function supportsReturning(dialect) {
+    switch (dialect) {
+        case 'postgres':
+        case 'sqlite':
+            return true;
+        case 'mysql':
+            return false;
+    }
+}
+/**
+ * Validate that a string is a supported dialect.
+ * Throws at DI startup if the user provides an unsupported value.
+ */
+export function validateDialect(value) {
+    if (DIALECTS.includes(value)) {
+        return value;
+    }
+    throw new Error(`Unsupported datasource dialect: '${value}'. Supported dialects: ${DIALECTS.join(', ')}`);
+}
+//# sourceMappingURL=dialect.js.map

package/dist/dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AASA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,UAAU;IACV,OAAO;IACP,QAAQ;CACA,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd,KAAK,OAAO;YACV,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAgB,CAAC,EAAE,CAAC;QACxC,OAAO,KAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,oCAAoC,KAAK,0BAA0B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 export { AbstractMigration } from './abstract-migration.js';
-export { CrudRepository } from './crud-repository.js';
+export { DatasourceConfig, PoolConfig } from './datasource-config.js';
 export { getMigrationName, Migration } from './decorators/migration.js';
 export { Transactional } from './decorators/transactional.js';
+export type { Dialect } from './dialect.js';
+export { DIALECTS, supportsReturning, validateDialect } from './dialect.js';
+export { KyselyDatabase } from './kysely-database.js';
 export type { KyselyPluginOptions } from './kysely-transformer-plugin.js';
 export { createKyselyPlugin } from './kysely-transformer-plugin.js';
 export { MigrationRunner } from './migration-runner.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,7 +1,9 @@
 export { AbstractMigration } from './abstract-migration.js';
-export { CrudRepository } from './crud-repository.js';
+export { DatasourceConfig, PoolConfig } from './datasource-config.js';
 export { getMigrationName, Migration } from './decorators/migration.js';
 export { Transactional } from './decorators/transactional.js';
+export { DIALECTS, supportsReturning, validateDialect } from './dialect.js';
+export { KyselyDatabase } from './kysely-database.js';
 export { createKyselyPlugin } from './kysely-transformer-plugin.js';
 export { MigrationRunner } from './migration-runner.js';
 export { TransactionManager } from './transaction-manager.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/kysely-database.d.ts

@@ -0,0 +1,37 @@
+import type { Kysely } from 'kysely';
+import type { DatasourceConfig } from './datasource-config.js';
+import type { Dialect } from './dialect.js';
+/**
+ * Library-provided Kysely database singleton.
+ *
+ * Creates and manages a `Kysely<DB>` instance based on `DatasourceConfig`.
+ * Automatically selects the correct dialect driver via dynamic import:
+ * - `postgres` → `pg` + `PostgresDialect`
+ * - `mysql` → `mysql2` + `MysqlDialect`
+ * - `sqlite` → `better-sqlite3` + `SqliteDialect`
+ *
+ * Non-generic (`Kysely<any>`) by design. Users bridge to their schema
+ * type via a `@Module` with `@Provides`:
+ * ```typescript
+ * @Module()
+ * class DatabaseModule {
+ *   constructor(private db: KyselyDatabase) {}
+ *
+ *   @Provides()
+ *   typedKysely(): Kysely<DB> {
+ *     return this.db.kysely as Kysely<DB>;
+ *   }
+ * }
+ * ```
+ *
+ * Repositories then inject `Kysely<DB>` for fully typed access.
+ */
+export declare class KyselyDatabase {
+    private readonly config;
+    kysely: Kysely<any>;
+    constructor(config: DatasourceConfig);
+    get dialect(): Dialect;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=kysely-database.d.ts.map

package/dist/kysely-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-database.d.ts","sourceRoot":"","sources":["../src/kysely-database.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,MAAM,EAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEQ,MAAM,EAAE,gBAAgB;IAErD,IAAI,OAAO,IAAI,OAAO,CAErB;IAGK,IAAI;IAQJ,OAAO;CAGd"}