@goodie-ts/kysely 0.4.0

package/README.md

@@ -0,0 +1,87 @@
+# @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.
+
+## Install
+
+```bash
+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.
+
+## Decorators
+
+| Decorator | Target | Description |
+|-----------|--------|-------------|
+| `@Transactional({ propagation? })` | method | Wraps method in a database transaction |
+| `@Migration('name')` | class | Marks a class as a migration (sorted by name) |
+
+## Usage
+
+```typescript
+import { Singleton } from '@goodie-ts/decorators';
+import { Transactional, CrudRepository, TransactionManager } from '@goodie-ts/kysely';
+
+@Singleton()
+class TodoRepository extends CrudRepository<Todo> {
+  constructor(transactionManager: TransactionManager) {
+    super('todos', transactionManager);
+  }
+}
+
+@Singleton()
+class TodoService {
+  constructor(private repo: TodoRepository) {}
+
+  @Transactional()
+  async createMany(titles: string[]) {
+    for (const title of titles) {
+      await this.repo.save({ title, completed: false });
+    }
+    // All-or-nothing: rolls back on error
+  }
+}
+```
+
+## Migrations
+
+```typescript
+import { Migration, AbstractMigration } from '@goodie-ts/kysely';
+import type { Kysely } from 'kysely';
+
+@Migration('001_create_todos')
+class CreateTodosTable extends AbstractMigration {
+  async up(db: Kysely<any>) {
+    await db.schema.createTable('todos')
+      .addColumn('id', 'uuid', c => c.primaryKey().defaultTo(sql`gen_random_uuid()`))
+      .addColumn('title', 'text', c => c.notNull())
+      .execute();
+  }
+}
+```
+
+Migrations run automatically at startup via `MigrationRunner` (`@PostConstruct`), sorted by name.
+
+## Vite Plugin Setup
+
+```typescript
+import { diPlugin } from '@goodie-ts/vite-plugin';
+import { createKyselyPlugin } from '@goodie-ts/kysely';
+
+export default defineConfig({
+  plugins: [
+    diPlugin({
+      plugins: [createKyselyPlugin({ database: 'Database' })],
+    }),
+  ],
+});
+```
+
+The `database` option specifies the class name of your Kysely wrapper (a `@Singleton` with a `.kysely` property).
+
+## License
+
+[MIT](https://github.com/GOOD-Code-ApS/goodie/blob/main/LICENSE)

package/dist/abstract-migration.d.ts

@@ -0,0 +1,29 @@
+import type { Kysely } from 'kysely';
+/**
+ * Abstract base class for Kysely migrations.
+ *
+ * Extend this class and decorate with `@Migration('name')` to define a
+ * migration that is auto-discovered and executed by the MigrationRunner
+ * at application startup.
+ *
+ * @example
+ * ```typescript
+ * @Migration('001_create_users')
+ * export class CreateUsersTable extends AbstractMigration {
+ *   async up(db: Kysely<any>) {
+ *     await db.schema.createTable('users')
+ *       .addColumn('id', 'uuid', c => c.primaryKey())
+ *       .execute();
+ *   }
+ *
+ *   async down(db: Kysely<any>) {
+ *     await db.schema.dropTable('users').execute();
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class AbstractMigration {
+    abstract up(db: Kysely<any>): Promise<void>;
+    down?(db: Kysely<any>): Promise<void>;
+}
+//# sourceMappingURL=abstract-migration.d.ts.map

package/dist/abstract-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-migration.d.ts","sourceRoot":"","sources":["../src/abstract-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,iBAAiB;IACrC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3C,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CACtC"}

package/dist/abstract-migration.js

@@ -0,0 +1,26 @@
+/**
+ * Abstract base class for Kysely migrations.
+ *
+ * Extend this class and decorate with `@Migration('name')` to define a
+ * migration that is auto-discovered and executed by the MigrationRunner
+ * at application startup.
+ *
+ * @example
+ * ```typescript
+ * @Migration('001_create_users')
+ * export class CreateUsersTable extends AbstractMigration {
+ *   async up(db: Kysely<any>) {
+ *     await db.schema.createTable('users')
+ *       .addColumn('id', 'uuid', c => c.primaryKey())
+ *       .execute();
+ *   }
+ *
+ *   async down(db: Kysely<any>) {
+ *     await db.schema.dropTable('users').execute();
+ *   }
+ * }
+ * ```
+ */
+export class AbstractMigration {
+}
+//# sourceMappingURL=abstract-migration.js.map

package/dist/abstract-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-migration.js","sourceRoot":"","sources":["../src/abstract-migration.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,iBAAiB;CAGtC"}

package/dist/crud-repository.d.ts

@@ -0,0 +1,40 @@
+import type { Kysely } from 'kysely';
+import type { TransactionManager } from './transaction-manager.js';
+/**
+ * Abstract base class for CRUD repositories backed by Kysely.
+ *
+ * **PostgreSQL-only:** Uses `RETURNING` clauses in `save()` and `deleteById()`.
+ * MySQL and SQLite do not support `RETURNING`. For other dialects, override
+ * these methods in your subclass.
+ *
+ * Provides standard `findAll`, `findById`, `save`, and `deleteById` operations.
+ * All queries use `TransactionManager.getConnection()` to be transaction-aware.
+ *
+ * The `db` getter returns `Kysely<any>` — typed table access is intentionally
+ * erased because the transformer cannot generate clean tokens for `Kysely<DB>`
+ * generic types. Subclasses can cast as needed for custom queries.
+ *
+ * @typeParam T - The entity/row type returned by queries.
+ *
+ * @example
+ * ```typescript
+ * class TodoRepository extends CrudRepository<Todo> {
+ *   constructor(transactionManager: TransactionManager) {
+ *     super('todos', transactionManager);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class CrudRepository<T extends Record<string, unknown>> {
+    protected readonly tableName: string;
+    protected readonly transactionManager: TransactionManager;
+    protected readonly idColumn: string;
+    constructor(tableName: string, transactionManager: TransactionManager, idColumn?: string);
+    /** Get the current transaction-aware Kysely connection. */
+    protected get db(): Kysely<any>;
+    findAll(): Promise<T[]>;
+    findById(id: unknown): Promise<T | undefined>;
+    save(entity: Record<string, unknown>): Promise<T>;
+    deleteById(id: unknown): Promise<T | undefined>;
+}
+//# sourceMappingURL=crud-repository.d.ts.map

package/dist/crud-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-repository.d.ts","sourceRoot":"","sources":["../src/crud-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAElE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;IACpC,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB;IACzD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAFhB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,kBAAkB,EACtC,QAAQ,GAAE,MAAa;IAG5C,2DAA2D;IAC3D,SAAS,KAAK,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,CAE9B;IAEK,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAMvB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAQ7C,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQjD,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAOtD"}

package/dist/crud-repository.js

@@ -0,0 +1,64 @@
+/**
+ * Abstract base class for CRUD repositories backed by Kysely.
+ *
+ * **PostgreSQL-only:** Uses `RETURNING` clauses in `save()` and `deleteById()`.
+ * MySQL and SQLite do not support `RETURNING`. For other dialects, override
+ * these methods in your subclass.
+ *
+ * Provides standard `findAll`, `findById`, `save`, and `deleteById` operations.
+ * All queries use `TransactionManager.getConnection()` to be transaction-aware.
+ *
+ * The `db` getter returns `Kysely<any>` — typed table access is intentionally
+ * erased because the transformer cannot generate clean tokens for `Kysely<DB>`
+ * generic types. Subclasses can cast as needed for custom queries.
+ *
+ * @typeParam T - The entity/row type returned by queries.
+ *
+ * @example
+ * ```typescript
+ * class TodoRepository extends CrudRepository<Todo> {
+ *   constructor(transactionManager: TransactionManager) {
+ *     super('todos', transactionManager);
+ *   }
+ * }
+ * ```
+ */
+export class CrudRepository {
+    tableName;
+    transactionManager;
+    idColumn;
+    constructor(tableName, transactionManager, idColumn = 'id') {
+        this.tableName = tableName;
+        this.transactionManager = transactionManager;
+        this.idColumn = idColumn;
+    }
+    /** Get the current transaction-aware Kysely connection. */
+    get db() {
+        return this.transactionManager.getConnection();
+    }
+    async findAll() {
+        return this.db.selectFrom(this.tableName).selectAll().execute();
+    }
+    async findById(id) {
+        return this.db
+            .selectFrom(this.tableName)
+            .selectAll()
+            .where(this.idColumn, '=', id)
+            .executeTakeFirst();
+    }
+    async save(entity) {
+        return this.db
+            .insertInto(this.tableName)
+            .values(entity)
+            .returningAll()
+            .executeTakeFirstOrThrow();
+    }
+    async deleteById(id) {
+        return this.db
+            .deleteFrom(this.tableName)
+            .where(this.idColumn, '=', id)
+            .returningAll()
+            .executeTakeFirst();
+    }
+}
+//# sourceMappingURL=crud-repository.js.map

package/dist/crud-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-repository.js","sourceRoot":"","sources":["../src/crud-repository.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAgB,cAAc;IAEb;IACA;IACA;IAHrB,YACqB,SAAiB,EACjB,kBAAsC,EACtC,WAAmB,IAAI;QAFvB,cAAS,GAAT,SAAS,CAAQ;QACjB,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,aAAQ,GAAR,QAAQ,CAAe;IACzC,CAAC;IAEJ,2DAA2D;IAC3D,IAAc,EAAE;QACd,OAAO,IAAI,CAAC,kBAAkB,CAAC,aAAa,EAAiB,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC,OAAO,EAE5D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAW;QACxB,OAAO,IAAI,CAAC,EAAE;aACX,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;aAC1B,SAAS,EAAE;aACX,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;aAC7B,gBAAgB,EAA4B,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,OAAO,IAAI,CAAC,EAAE;aACX,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;aAC1B,MAAM,CAAC,MAAM,CAAC;aACd,YAAY,EAAE;aACd,uBAAuB,EAAgB,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAW;QAC1B,OAAO,IAAI,CAAC,EAAE;aACX,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;aAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;aAC7B,YAAY,EAAE;aACd,gBAAgB,EAA4B,CAAC;IAClD,CAAC;CACF"}

package/dist/decorators/migration.d.ts

@@ -0,0 +1,18 @@
+type ClassDecorator_Stage3 = (target: new (...args: never) => unknown, context: ClassDecoratorContext) => void;
+/**
+ * Mark a class as a Kysely migration with a unique name.
+ *
+ * At compile time, the Kysely transformer plugin discovers @Migration classes
+ * and wires them into an auto-managed MigrationRunner.
+ *
+ * Classes should extend {@link AbstractMigration} which enforces the required
+ * `up()` method and optional `down()` method at compile time.
+ *
+ * @param name - Unique migration key, e.g. '001_create_todos'. Migrations
+ *   are executed in lexicographic order by name.
+ */
+export declare function Migration(name: string): ClassDecorator_Stage3;
+/** Read the migration name from a migration instance's Symbol.metadata. */
+export declare function getMigrationName(instance: object): string | undefined;
+export {};
+//# sourceMappingURL=migration.d.ts.map

package/dist/decorators/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/decorators/migration.ts"],"names":[],"mappings":"AAEA,KAAK,qBAAqB,GAAG,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACvC,OAAO,EAAE,qBAAqB,KAC3B,IAAI,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAI7D;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE"}

package/dist/decorators/migration.js

@@ -0,0 +1,24 @@
+const MIGRATION_NAME = Symbol('goodie:migration-name');
+/**
+ * Mark a class as a Kysely migration with a unique name.
+ *
+ * At compile time, the Kysely transformer plugin discovers @Migration classes
+ * and wires them into an auto-managed MigrationRunner.
+ *
+ * Classes should extend {@link AbstractMigration} which enforces the required
+ * `up()` method and optional `down()` method at compile time.
+ *
+ * @param name - Unique migration key, e.g. '001_create_todos'. Migrations
+ *   are executed in lexicographic order by name.
+ */
+export function Migration(name) {
+    return (_target, context) => {
+        context.metadata[MIGRATION_NAME] = name;
+    };
+}
+/** Read the migration name from a migration instance's Symbol.metadata. */
+export function getMigrationName(instance) {
+    const meta = instance.constructor[Symbol.metadata];
+    return meta?.[MIGRATION_NAME];
+}
+//# sourceMappingURL=migration.js.map

package/dist/decorators/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/decorators/migration.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAOvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC1B,OAAO,CAAC,QAAS,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAI,QAAQ,CAAC,WAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO,IAAI,EAAE,CAAC,cAAc,CAAC,CAAC;AAChC,CAAC"}

package/dist/decorators/transactional.d.ts

@@ -0,0 +1,16 @@
+export interface TransactionalOptions {
+    /** Transaction propagation strategy (default: 'REQUIRED'). */
+    propagation?: 'REQUIRED' | 'REQUIRES_NEW';
+}
+type MethodDecorator_Stage3 = (target: (...args: never) => unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * Mark a method to run inside a database transaction.
+ *
+ * At compile time, the kysely transformer plugin reads this decorator
+ * and wires the `TransactionalInterceptor` via AOP.
+ *
+ * @param opts - Optional configuration (e.g. propagation strategy).
+ */
+export declare function Transactional(_opts?: TransactionalOptions): MethodDecorator_Stage3;
+export {};
+//# sourceMappingURL=transactional.d.ts.map

package/dist/decorators/transactional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.d.ts","sourceRoot":"","sources":["../../src/decorators/transactional.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;CAC3C;AAED,KAAK,sBAAsB,GAAG,CAC5B,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACnC,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,CAAC,EAAE,oBAAoB,GAC3B,sBAAsB,CAIxB"}

package/dist/decorators/transactional.js

@@ -0,0 +1,14 @@
+/**
+ * Mark a method to run inside a database transaction.
+ *
+ * At compile time, the kysely transformer plugin reads this decorator
+ * and wires the `TransactionalInterceptor` via AOP.
+ *
+ * @param opts - Optional configuration (e.g. propagation strategy).
+ */
+export function Transactional(_opts) {
+    return (_target, _context) => {
+        // No-op: read at compile time by the kysely transformer plugin
+    };
+}
+//# sourceMappingURL=transactional.js.map

package/dist/decorators/transactional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional.js","sourceRoot":"","sources":["../../src/decorators/transactional.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA4B;IAE5B,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC3B,+DAA+D;IACjE,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { AbstractMigration } from './abstract-migration.js';
+export { CrudRepository } from './crud-repository.js';
+export { getMigrationName, Migration } from './decorators/migration.js';
+export { Transactional } from './decorators/transactional.js';
+export type { KyselyPluginOptions } from './kysely-transformer-plugin.js';
+export { createKyselyPlugin } from './kysely-transformer-plugin.js';
+export { MigrationRunner } from './migration-runner.js';
+export type { KyselyProvider } from './transaction-manager.js';
+export { TransactionManager } from './transaction-manager.js';
+export { TransactionalInterceptor } from './transactional-interceptor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { AbstractMigration } from './abstract-migration.js';
+export { CrudRepository } from './crud-repository.js';
+export { getMigrationName, Migration } from './decorators/migration.js';
+export { Transactional } from './decorators/transactional.js';
+export { createKyselyPlugin } from './kysely-transformer-plugin.js';
+export { MigrationRunner } from './migration-runner.js';
+export { TransactionManager } from './transaction-manager.js';
+export { TransactionalInterceptor } from './transactional-interceptor.js';
+//# 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,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"}

package/dist/kysely-transformer-plugin.d.ts

@@ -0,0 +1,32 @@
+import type { TransformerPlugin } from '@goodie-ts/transformer';
+/** Options for the Kysely transformer plugin. */
+export interface KyselyPluginOptions {
+    /**
+     * Explicit class name of the bean that provides a `Kysely<...>` property.
+     * Overrides auto-detection. Use this to disambiguate when multiple classes
+     * expose a `Kysely` property.
+     */
+    database?: string;
+}
+/**
+ * Create the Kysely transformer plugin.
+ *
+ * Scans @Transactional decorators on methods and wires
+ * TransactionalInterceptor as an AOP interceptor dependency at compile time.
+ *
+ * Scans @Migration decorated classes and wires a MigrationRunner that
+ * executes all migrations at startup via @PostConstruct.
+ *
+ * **Auto-detection:** The plugin scans decorated classes for properties typed
+ * as `Kysely<...>` and auto-wires the owning class as a TransactionManager
+ * and/or MigrationRunner constructor dependency. Use `options.database` to
+ * override when multiple classes expose a `Kysely` property.
+ *
+ * **Limitation:** Propagation is detected via AST text matching
+ * (`text.includes('REQUIRES_NEW')`). Only string literal values in the
+ * decorator argument are supported — const references or computed values
+ * will fall back to `'REQUIRED'` silently.
+ */
+export declare function createKyselyPlugin(options?: KyselyPluginOptions): TransformerPlugin;
+export default createKyselyPlugin;
+//# sourceMappingURL=kysely-transformer-plugin.d.ts.map

package/dist/kysely-transformer-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transformer-plugin.d.ts","sourceRoot":"","sources":["../src/kysely-transformer-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,iBAAiB,CAqSnB;AAmED,eAAe,kBAAkB,CAAC"}

package/dist/kysely-transformer-plugin.js

@@ -0,0 +1,315 @@
+/**
+ * Create the Kysely transformer plugin.
+ *
+ * Scans @Transactional decorators on methods and wires
+ * TransactionalInterceptor as an AOP interceptor dependency at compile time.
+ *
+ * Scans @Migration decorated classes and wires a MigrationRunner that
+ * executes all migrations at startup via @PostConstruct.
+ *
+ * **Auto-detection:** The plugin scans decorated classes for properties typed
+ * as `Kysely<...>` and auto-wires the owning class as a TransactionManager
+ * and/or MigrationRunner constructor dependency. Use `options.database` to
+ * override when multiple classes expose a `Kysely` property.
+ *
+ * **Limitation:** Propagation is detected via AST text matching
+ * (`text.includes('REQUIRES_NEW')`). Only string literal values in the
+ * decorator argument are supported — const references or computed values
+ * will fall back to `'REQUIRED'` silently.
+ */
+export function createKyselyPlugin(options) {
+    const classTransactionalInfo = new Map();
+    /** Classes discovered with a `Kysely<...>` property. Keyed by filePath:className. */
+    const kyselyProviders = [];
+    /** @Migration decorated classes discovered during visitClass. */
+    const migrationClasses = [];
+    return {
+        name: 'kysely',
+        visitClass(ctx) {
+            // Detect Kysely<...> properties for auto-wiring
+            for (const prop of ctx.classDeclaration.getProperties()) {
+                // Check the type annotation text (AST-level), not the resolved type.
+                // This avoids requiring the 'kysely' package to be resolvable at transform time.
+                const typeAnnotation = prop.getTypeNode()?.getText();
+                if (typeAnnotation?.startsWith('Kysely<')) {
+                    kyselyProviders.push({
+                        className: ctx.className,
+                        filePath: ctx.filePath,
+                    });
+                    break; // one match per class is enough
+                }
+            }
+            // Detect @Migration('name') class decorator
+            for (const decorator of ctx.classDeclaration.getDecorators()) {
+                if (decorator.getName() !== 'Migration')
+                    continue;
+                const args = decorator.getArguments();
+                const name = args[0]?.getText().replace(/['"]/g, '') ?? ctx.className;
+                migrationClasses.push({
+                    className: ctx.className,
+                    filePath: ctx.filePath,
+                    migrationName: name,
+                });
+            }
+        },
+        visitMethod(ctx) {
+            const decorators = ctx.methodDeclaration.getDecorators();
+            for (const decorator of decorators) {
+                if (decorator.getName() !== 'Transactional')
+                    continue;
+                // Parse propagation from decorator arguments
+                let propagation = 'REQUIRED';
+                const args = decorator.getArguments();
+                if (args.length > 0) {
+                    const text = args[0].getText();
+                    if (text.includes('REQUIRES_NEW')) {
+                        propagation = 'REQUIRES_NEW';
+                    }
+                }
+                const key = `${ctx.filePath}:${ctx.className}`;
+                const existing = classTransactionalInfo.get(key) ?? [];
+                existing.push({ methodName: ctx.methodName, propagation });
+                classTransactionalInfo.set(key, existing);
+            }
+        },
+        afterResolve(beans) {
+            const syntheticBeans = [];
+            // --- @Transactional interception ---
+            let needsInterceptor = false;
+            for (const bean of beans) {
+                const className = bean.tokenRef.kind === 'class' ? bean.tokenRef.className : undefined;
+                if (!className)
+                    continue;
+                const key = `${bean.tokenRef.importPath}:${className}`;
+                const infos = classTransactionalInfo.get(key);
+                if (!infos || infos.length === 0)
+                    continue;
+                needsInterceptor = true;
+                const existing = (bean.metadata.interceptedMethods ?? []);
+                for (const info of infos) {
+                    const methodEntry = existing.find((m) => m.methodName === info.methodName);
+                    const interceptorRef = {
+                        className: 'TransactionalInterceptor',
+                        importPath: '@goodie-ts/kysely',
+                        adviceType: 'around',
+                        order: -40, // Runs after logging (-100), before cache (-50), before resilience
+                        metadata: { propagation: info.propagation },
+                    };
+                    if (methodEntry) {
+                        methodEntry.interceptors.push(interceptorRef);
+                    }
+                    else {
+                        existing.push({
+                            methodName: info.methodName,
+                            interceptors: [interceptorRef],
+                        });
+                    }
+                }
+                bean.metadata.interceptedMethods = existing;
+            }
+            const hasMigrations = migrationClasses.length > 0;
+            if (!needsInterceptor && !hasMigrations)
+                return beans;
+            // Resolve the database bean for auto-wiring.
+            // Priority: explicit `database` option > auto-detected Kysely provider.
+            const kyselyProviderDep = resolveKyselyProvider(beans, options?.database, kyselyProviders);
+            // --- Transactional synthetic beans ---
+            if (needsInterceptor) {
+                syntheticBeans.push({
+                    tokenRef: {
+                        kind: 'class',
+                        className: 'TransactionManager',
+                        importPath: '@goodie-ts/kysely',
+                    },
+                    scope: 'singleton',
+                    eager: false,
+                    name: undefined,
+                    constructorDeps: kyselyProviderDep,
+                    fieldDeps: [],
+                    factoryKind: 'constructor',
+                    providesSource: undefined,
+                    metadata: {},
+                    sourceLocation: {
+                        filePath: '@goodie-ts/kysely',
+                        line: 0,
+                        column: 0,
+                    },
+                });
+                syntheticBeans.push({
+                    tokenRef: {
+                        kind: 'class',
+                        className: 'TransactionalInterceptor',
+                        importPath: '@goodie-ts/kysely',
+                    },
+                    scope: 'singleton',
+                    eager: false,
+                    name: undefined,
+                    constructorDeps: [
+                        {
+                            tokenRef: {
+                                kind: 'class',
+                                className: 'TransactionManager',
+                                importPath: '@goodie-ts/kysely',
+                            },
+                            optional: false,
+                            collection: false,
+                            sourceLocation: {
+                                filePath: '@goodie-ts/kysely',
+                                line: 0,
+                                column: 0,
+                            },
+                        },
+                    ],
+                    fieldDeps: [],
+                    factoryKind: 'constructor',
+                    providesSource: undefined,
+                    metadata: {},
+                    sourceLocation: {
+                        filePath: '@goodie-ts/kysely',
+                        line: 0,
+                        column: 0,
+                    },
+                });
+            }
+            // --- @Migration synthetic beans ---
+            if (hasMigrations) {
+                if (kyselyProviderDep.length === 0) {
+                    console.warn('[@goodie-ts/kysely] @Migration classes found but no Kysely provider detected. ' +
+                        'MigrationRunner will not be created.');
+                }
+                else {
+                    // Sort migrations by name for deterministic execution order
+                    migrationClasses.sort((a, b) => a.migrationName.localeCompare(b.migrationName));
+                    // Synthetic bean per @Migration class (no baseTokenRefs — wired as individual deps)
+                    const migrationDeps = [];
+                    for (const m of migrationClasses) {
+                        syntheticBeans.push({
+                            tokenRef: {
+                                kind: 'class',
+                                className: m.className,
+                                importPath: m.filePath,
+                            },
+                            scope: 'singleton',
+                            eager: false,
+                            name: undefined,
+                            constructorDeps: [],
+                            fieldDeps: [],
+                            factoryKind: 'constructor',
+                            providesSource: undefined,
+                            metadata: {},
+                            sourceLocation: {
+                                filePath: m.filePath,
+                                line: 0,
+                                column: 0,
+                            },
+                        });
+                        migrationDeps.push({
+                            tokenRef: {
+                                kind: 'class',
+                                className: m.className,
+                                importPath: m.filePath,
+                            },
+                            optional: false,
+                            collection: false,
+                            sourceLocation: {
+                                filePath: '@goodie-ts/kysely',
+                                line: 0,
+                                column: 0,
+                            },
+                        });
+                    }
+                    // MigrationRunner: eager singleton, depends on KyselyProvider + individual migration deps
+                    syntheticBeans.push({
+                        tokenRef: {
+                            kind: 'class',
+                            className: 'MigrationRunner',
+                            importPath: '@goodie-ts/kysely',
+                        },
+                        scope: 'singleton',
+                        eager: true,
+                        name: undefined,
+                        constructorDeps: [kyselyProviderDep[0], ...migrationDeps],
+                        fieldDeps: [],
+                        factoryKind: 'constructor',
+                        providesSource: undefined,
+                        metadata: { postConstructMethods: ['migrate'] },
+                        sourceLocation: {
+                            filePath: '@goodie-ts/kysely',
+                            line: 0,
+                            column: 0,
+                        },
+                    });
+                }
+            }
+            return [...beans, ...syntheticBeans];
+        },
+        codegen(beans) {
+            const hasTransactional = beans.some((b) => {
+                const methods = b.metadata.interceptedMethods;
+                return methods?.some((m) => m.interceptors.some((i) => i.className === 'TransactionalInterceptor'));
+            });
+            if (!hasTransactional)
+                return {};
+            // TransactionManager and TransactionalInterceptor imports are already
+            // generated by collectClassImports (they are synthetic bean tokens).
+            // Only need to contribute the buildInterceptorChain import.
+            return {
+                imports: ["import { buildInterceptorChain } from '@goodie-ts/aop'"],
+            };
+        },
+    };
+}
+/**
+ * Resolve which bean provides the Kysely instance for TransactionManager auto-wiring.
+ *
+ * Priority:
+ * 1. Explicit `database` option (string class name)
+ * 2. Auto-detected class with a `Kysely<...>` property (single match)
+ * 3. No wiring (zero matches, or multiple matches without explicit option)
+ */
+function resolveKyselyProvider(beans, explicitDatabase, autoDetected) {
+    // Determine target class name
+    let targetClassName;
+    if (explicitDatabase) {
+        targetClassName = explicitDatabase;
+    }
+    else if (autoDetected.length === 1) {
+        targetClassName = autoDetected[0].className;
+    }
+    else if (autoDetected.length > 1) {
+        const names = autoDetected.map((p) => p.className).join(', ');
+        console.warn(`[@goodie-ts/kysely] Multiple Kysely providers detected: ${names}. ` +
+            "Use createKyselyPlugin({ database: 'ClassName' }) to disambiguate. " +
+            'TransactionManager will require manual configure().');
+        return [];
+    }
+    else {
+        // Zero providers — no auto-wiring
+        return [];
+    }
+    // Find the bean matching the target class name
+    const databaseBean = beans.find((b) => b.tokenRef.kind === 'class' && b.tokenRef.className === targetClassName);
+    if (databaseBean && databaseBean.tokenRef.kind === 'class') {
+        return [
+            {
+                tokenRef: {
+                    kind: 'class',
+                    className: databaseBean.tokenRef.className,
+                    importPath: databaseBean.tokenRef.importPath,
+                },
+                optional: false,
+                collection: false,
+                sourceLocation: {
+                    filePath: '@goodie-ts/kysely',
+                    line: 0,
+                    column: 0,
+                },
+            },
+        ];
+    }
+    console.warn(`[@goodie-ts/kysely] Database class '${targetClassName}' not found in beans. ` +
+        'TransactionManager will require manual configure().');
+    return [];
+}
+export default createKyselyPlugin;
+//# sourceMappingURL=kysely-transformer-plugin.js.map

package/dist/kysely-transformer-plugin.js.map

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

package/dist/migration-runner.d.ts

@@ -0,0 +1,16 @@
+import type { AbstractMigration } from './abstract-migration.js';
+import type { KyselyProvider } from './transaction-manager.js';
+/**
+ * Runs Kysely migrations at application startup.
+ *
+ * Auto-wired by the Kysely transformer plugin as an eager singleton
+ * with `@PostConstruct` on `migrate()`. Constructor receives the
+ * KyselyProvider and all discovered @Migration instances.
+ */
+export declare class MigrationRunner {
+    private readonly kyselyProvider;
+    private readonly migrations;
+    constructor(kyselyProvider: KyselyProvider, ...migrations: AbstractMigration[]);
+    migrate(): Promise<void>;
+}
+//# sourceMappingURL=migration-runner.d.ts.map

package/dist/migration-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.d.ts","sourceRoot":"","sources":["../src/migration-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAG/C,cAAc,EAAE,cAAc,EAC9B,GAAG,UAAU,EAAE,iBAAiB,EAAE;IAM9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgC/B"}

package/dist/migration-runner.js

@@ -0,0 +1,45 @@
+import { Migrator } from 'kysely';
+import { getMigrationName } from './decorators/migration.js';
+/**
+ * Runs Kysely migrations at application startup.
+ *
+ * Auto-wired by the Kysely transformer plugin as an eager singleton
+ * with `@PostConstruct` on `migrate()`. Constructor receives the
+ * KyselyProvider and all discovered @Migration instances.
+ */
+export class MigrationRunner {
+    kyselyProvider;
+    migrations;
+    constructor(kyselyProvider, ...migrations) {
+        this.kyselyProvider = kyselyProvider;
+        this.migrations = migrations;
+    }
+    async migrate() {
+        const migrationMap = {};
+        for (const m of this.migrations) {
+            const name = getMigrationName(m);
+            if (!name) {
+                throw new Error(`MigrationRunner received an object without @Migration metadata: ${m.constructor.name}`);
+            }
+            // Kysely's Migrator spreads migration objects (...migration), which
+            // drops prototype methods from class instances. Bind explicitly.
+            migrationMap[name] = {
+                up: m.up.bind(m),
+                down: m.down?.bind(m),
+            };
+        }
+        const migrator = new Migrator({
+            db: this.kyselyProvider.kysely,
+            provider: { getMigrations: async () => migrationMap },
+        });
+        const { error, results } = await migrator.migrateToLatest();
+        for (const r of results ?? []) {
+            if (r.status === 'Error') {
+                console.error(`Migration "${r.migrationName}" failed`);
+            }
+        }
+        if (error)
+            throw error;
+    }
+}
+//# sourceMappingURL=migration-runner.js.map

package/dist/migration-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.js","sourceRoot":"","sources":["../src/migration-runner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACT,cAAc,CAAiB;IAC/B,UAAU,CAAsB;IAEjD,YACE,cAA8B,EAC9B,GAAG,UAA+B;QAElC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,YAAY,GAAoC,EAAE,CAAC;QACzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,mEAAmE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CACxF,CAAC;YACJ,CAAC;YACD,oEAAoE;YACpE,iEAAiE;YACjE,YAAY,CAAC,IAAI,CAAC,GAAG;gBACnB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;aACtB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM;YAC9B,QAAQ,EAAE,EAAE,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,EAAE;SACtD,CAAC,CAAC;QAEH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,CAAC;QAE5D,KAAK,MAAM,CAAC,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,aAAa,UAAU,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,IAAI,KAAK;YAAE,MAAM,KAAK,CAAC;IACzB,CAAC;CACF"}

package/dist/transaction-manager.d.ts

@@ -0,0 +1,59 @@
+import type { Kysely, Transaction } from 'kysely';
+/**
+ * An object that exposes a `.kysely` property — e.g. a Database wrapper class.
+ * Used for duck-type detection in the TransactionManager constructor.
+ */
+export interface KyselyProvider {
+    kysely: Kysely<any>;
+}
+/**
+ * Manages database transactions using AsyncLocalStorage.
+ *
+ * Provides transaction propagation across async call chains without
+ * explicitly threading a transaction object through every method.
+ *
+ * When auto-wired via `createKyselyPlugin({ database: 'Database' })`,
+ * the constructor receives the Database bean and reads its `.kysely` property.
+ * Manual `configure()` is still supported for backward compatibility.
+ */
+export declare class TransactionManager {
+    private readonly storage;
+    private kyselyRef?;
+    private testTransactionActive;
+    constructor(kyselyOrProvider?: Kysely<any> | KyselyProvider);
+    /**
+     * Configure the Kysely instance used for transactions.
+     * Unnecessary when auto-wired via `createKyselyPlugin({ database: '...' })`.
+     */
+    configure(kysely: Kysely<any>): void;
+    private get kysely();
+    /**
+     * Run a function inside a transaction.
+     *
+     * - If already in a transaction (REQUIRED propagation), reuses it.
+     * - If `requiresNew` is true, always starts a fresh transaction.
+     */
+    runInTransaction<T>(fn: () => Promise<T>, requiresNew?: boolean): Promise<T>;
+    /** Get the current transaction, or undefined if not in one. */
+    currentTransaction(): Transaction<any> | undefined;
+    /**
+     * Get the current database connection — transaction-aware.
+     * Returns the active transaction if inside one, otherwise the raw Kysely instance.
+     */
+    getConnection(): Kysely<any>;
+    /**
+     * Start a test-scoped transaction that ALL queries will use.
+     *
+     * Replaces the internal Kysely reference with the transaction object,
+     * so any code calling `getConnection()` or `database.kysely` (via the
+     * provider proxy) will automatically use this transaction.
+     *
+     * Designed for test frameworks (e.g. vitest fixtures) where
+     * AsyncLocalStorage context may not propagate through `use()`.
+     *
+     * @returns A rollback function — call it to roll back the transaction
+     *          and restore the original Kysely instance.
+     */
+    startTestTransaction(): Promise<() => Promise<void>>;
+}
+//# sourceMappingURL=transaction-manager.d.ts.map

package/dist/transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../src/transaction-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,SAAS,CAAC,CAAc;IAChC,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,gBAAgB,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc;IAoB3D;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI;IAIpC,OAAO,KAAK,MAAM,GAOjB;IAED;;;;;OAKG;IACG,gBAAgB,CAAC,CAAC,EACtB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,UAAQ,GAClB,OAAO,CAAC,CAAC,CAAC;IAiBb,+DAA+D;IAC/D,kBAAkB,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS;IAIlD;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC,GAAG,CAAC;IAI5B;;;;;;;;;;;;OAYG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAmC3D"}

package/dist/transaction-manager.js

@@ -0,0 +1,132 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+/**
+ * Manages database transactions using AsyncLocalStorage.
+ *
+ * Provides transaction propagation across async call chains without
+ * explicitly threading a transaction object through every method.
+ *
+ * When auto-wired via `createKyselyPlugin({ database: 'Database' })`,
+ * the constructor receives the Database bean and reads its `.kysely` property.
+ * Manual `configure()` is still supported for backward compatibility.
+ */
+export class TransactionManager {
+    storage = new AsyncLocalStorage();
+    kyselyRef;
+    testTransactionActive = false;
+    constructor(kyselyOrProvider) {
+        if (kyselyOrProvider) {
+            if ('kysely' in kyselyOrProvider) {
+                this.kyselyRef = kyselyOrProvider.kysely;
+                // Make the provider's .kysely property transaction-aware.
+                // Any code accessing provider.kysely (e.g. database.kysely) will
+                // automatically use the active transaction when inside one.
+                const tm = this;
+                Object.defineProperty(kyselyOrProvider, 'kysely', {
+                    get() {
+                        return tm.getConnection();
+                    },
+                    configurable: true,
+                });
+            }
+            else {
+                this.kyselyRef = kyselyOrProvider;
+            }
+        }
+    }
+    /**
+     * Configure the Kysely instance used for transactions.
+     * Unnecessary when auto-wired via `createKyselyPlugin({ database: '...' })`.
+     */
+    configure(kysely) {
+        this.kyselyRef = kysely;
+    }
+    get kysely() {
+        if (!this.kyselyRef) {
+            throw new Error('TransactionManager not configured. Call transactionManager.configure(kysely) or use createKyselyPlugin({ database: "YourDatabase" }).');
+        }
+        return this.kyselyRef;
+    }
+    /**
+     * Run a function inside a transaction.
+     *
+     * - If already in a transaction (REQUIRED propagation), reuses it.
+     * - If `requiresNew` is true, always starts a fresh transaction.
+     */
+    async runInTransaction(fn, requiresNew = false) {
+        // Inside a test transaction, all queries already use the test transaction.
+        // Skip creating new transactions to avoid Kysely's nested transaction error.
+        if (this.testTransactionActive) {
+            return fn();
+        }
+        const existing = this.storage.getStore();
+        if (existing && !requiresNew) {
+            return fn();
+        }
+        return this.kysely.transaction().execute(async (trx) => {
+            return this.storage.run(trx, fn);
+        });
+    }
+    /** Get the current transaction, or undefined if not in one. */
+    currentTransaction() {
+        return this.storage.getStore();
+    }
+    /**
+     * Get the current database connection — transaction-aware.
+     * Returns the active transaction if inside one, otherwise the raw Kysely instance.
+     */
+    getConnection() {
+        return this.currentTransaction() ?? this.kysely;
+    }
+    /**
+     * Start a test-scoped transaction that ALL queries will use.
+     *
+     * Replaces the internal Kysely reference with the transaction object,
+     * so any code calling `getConnection()` or `database.kysely` (via the
+     * provider proxy) will automatically use this transaction.
+     *
+     * Designed for test frameworks (e.g. vitest fixtures) where
+     * AsyncLocalStorage context may not propagate through `use()`.
+     *
+     * @returns A rollback function — call it to roll back the transaction
+     *          and restore the original Kysely instance.
+     */
+    async startTestTransaction() {
+        const original = this.kyselyRef;
+        let triggerRollback;
+        let transactionReady;
+        const readyPromise = new Promise((resolve) => {
+            transactionReady = resolve;
+        });
+        const rollbackPromise = this.kysely
+            .transaction()
+            .execute(async (trx) => {
+            this.kyselyRef = trx;
+            this.testTransactionActive = true;
+            transactionReady();
+            await new Promise((_resolve, reject) => {
+                triggerRollback = () => reject(new TestRollbackSignal());
+            });
+        })
+            .catch((e) => {
+            if (!(e instanceof TestRollbackSignal))
+                throw e;
+        })
+            .finally(() => {
+            this.testTransactionActive = false;
+            this.kyselyRef = original;
+        });
+        await readyPromise;
+        return async () => {
+            triggerRollback();
+            await rollbackPromise;
+        };
+    }
+}
+/** @internal Sentinel error for test transaction rollback. */
+class TestRollbackSignal extends Error {
+    constructor() {
+        super('TestRollbackSignal');
+        this.name = 'TestRollbackSignal';
+    }
+}
+//# sourceMappingURL=transaction-manager.js.map

package/dist/transaction-manager.js.map

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

package/dist/transactional-interceptor.d.ts

@@ -0,0 +1,14 @@
+import type { InvocationContext, MethodInterceptor } from '@goodie-ts/aop';
+import type { TransactionManager } from './transaction-manager.js';
+/**
+ * AOP interceptor that wraps method execution in a database transaction.
+ *
+ * Reads propagation strategy from `ctx.metadata` (set by the kysely
+ * transformer plugin).
+ */
+export declare class TransactionalInterceptor implements MethodInterceptor {
+    private readonly transactionManager;
+    constructor(transactionManager: TransactionManager);
+    intercept(ctx: InvocationContext): unknown;
+}
+//# sourceMappingURL=transactional-interceptor.d.ts.map

package/dist/transactional-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-interceptor.d.ts","sourceRoot":"","sources":["../src/transactional-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,kBAAkB;IAEnE,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO;CAY3C"}

package/dist/transactional-interceptor.js

@@ -0,0 +1,24 @@
+/**
+ * AOP interceptor that wraps method execution in a database transaction.
+ *
+ * Reads propagation strategy from `ctx.metadata` (set by the kysely
+ * transformer plugin).
+ */
+export class TransactionalInterceptor {
+    transactionManager;
+    constructor(transactionManager) {
+        this.transactionManager = transactionManager;
+    }
+    intercept(ctx) {
+        const meta = ctx.metadata;
+        if (!meta)
+            return ctx.proceed();
+        const requiresNew = meta.propagation === 'REQUIRES_NEW';
+        return this.transactionManager.runInTransaction(async () => {
+            // Must await so rejected promises propagate within the transaction scope,
+            // ensuring Kysely rolls back on failure.
+            return await ctx.proceed();
+        }, requiresNew);
+    }
+}
+//# sourceMappingURL=transactional-interceptor.js.map

package/dist/transactional-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-interceptor.js","sourceRoot":"","sources":["../src/transactional-interceptor.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,kBAAsC;QAAtC,uBAAkB,GAAlB,kBAAkB,CAAoB;IAAG,CAAC;IAEvE,SAAS,CAAC,GAAsB;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,QAA6C,CAAC;QAC/D,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC;QAEhC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,KAAK,cAAc,CAAC;QAExD,OAAO,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;YACzD,0EAA0E;YAC1E,yCAAyC;YACzC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC,EAAE,WAAW,CAAC,CAAC;IAClB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@goodie-ts/kysely",
+  "version": "0.4.0",
+  "description": "Kysely integration for goodie-ts — @Transactional decorator, TransactionManager, CrudRepository",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GOOD-Code-ApS/goodie.git",
+    "directory": "packages/kysely"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "goodie": {
+    "plugin": "./dist/kysely-transformer-plugin.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@goodie-ts/aop": "workspace:*"
+  },
+  "peerDependencies": {
+    "@goodie-ts/transformer": "workspace:*",
+    "kysely": ">=0.27.0"
+  },
+  "peerDependenciesMeta": {
+    "@goodie-ts/transformer": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@goodie-ts/transformer": "workspace:*",
+    "@types/node": "^22.0.0",
+    "kysely": "^0.27.0",
+    "ts-morph": "^24.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}