@privateaim/server-db-kit 0.8.26 → 0.8.28

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.8.28](https://github.com/PrivateAIM/hub/compare/v0.8.27...v0.8.28) (2026-02-26)
+
+
+### Features
+
+* database migration capabilities ([#1437](https://github.com/PrivateAIM/hub/issues/1437)) ([ada0c8c](https://github.com/PrivateAIM/hub/commit/ada0c8c82c50d7ff999c60d7d6b8a6aea10064f0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @privateaim/kit bumped from ^0.8.27 to ^0.8.28
+    * @privateaim/server-kit bumped from ^0.8.27 to ^0.8.28
+
+## [0.8.27](https://github.com/PrivateAIM/hub/compare/v0.8.26...v0.8.27) (2026-02-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @privateaim/kit bumped from ^0.8.26 to ^0.8.27
+    * @privateaim/server-kit bumped from ^0.8.26 to ^0.8.27
+
 ## [0.8.26](https://github.com/PrivateAIM/hub/compare/v0.8.25...v0.8.26) (2026-02-11)
 
 

package/dist/data-source/index.d.ts

@@ -0,0 +1,2 @@
+export * from './options.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/data-source/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data-source/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC"}

package/dist/data-source/options.d.ts

@@ -0,0 +1,14 @@
+import type { DataSourceOptions } from 'typeorm';
+export type DataSourceOptionsEntities = DataSourceOptions['entities'];
+export type DataSourceOptionsSubscribers = DataSourceOptions['subscribers'];
+export declare class DataSourceOptionsBuilder {
+    protected entities: DataSourceOptionsEntities;
+    protected subscribers: DataSourceOptionsSubscribers;
+    constructor();
+    buildWithEnv(): DataSourceOptions;
+    buildWith(options: DataSourceOptions): DataSourceOptions;
+    setEntities(entities: DataSourceOptionsEntities): void;
+    setSubscribers(subscribers: DataSourceOptionsSubscribers): void;
+    protected normalize(options: DataSourceOptions): DataSourceOptions;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/data-source/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/data-source/options.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAQjD,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;AACtE,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAE5E,qBAAa,wBAAwB;IACjC,SAAS,CAAC,QAAQ,EAAG,yBAAyB,CAAC;IAE/C,SAAS,CAAC,WAAW,EAAG,4BAA4B,CAAC;;IAWrD,YAAY;IAUZ,SAAS,CAAC,OAAO,EAAE,iBAAiB;IAMpC,WAAW,CAAC,QAAQ,EAAE,yBAAyB;IAI/C,cAAc,CAAC,WAAW,EAAE,4BAA4B;IAMxD,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAI,iBAAiB;CA4CtE"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export * from './subscriber';
+export * from './data-source/index.ts';
+export * from './subscriber/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/index.mjs

@@ -1,5 +1,72 @@
+import { readDataSourceOptionsFromEnv, isCodeTransformation, CodeTransformation, transformFilePath } from 'typeorm-extension';
 import { DomainEventName } from '@privateaim/kit';
-import { useEntityEventPublisher } from '@privateaim/server-kit';
+import { isEntityEventPublisherUsable, useEntityEventPublisher } from '@privateaim/server-kit';
+
+class DataSourceOptionsBuilder {
+    entities;
+    subscribers;
+    // ------------------------------------------------------------------
+    constructor(){
+        this.entities = [];
+        this.subscribers = [];
+    }
+    // ------------------------------------------------------------------
+    buildWithEnv() {
+        const options = readDataSourceOptionsFromEnv();
+        if (!options) {
+            throw new Error('The database configuration could not be read from env variables.');
+        }
+        return this.normalize(options);
+    }
+    buildWith(options) {
+        return this.normalize(options);
+    }
+    // ------------------------------------------------------------------
+    setEntities(entities) {
+        this.entities = entities;
+    }
+    setSubscribers(subscribers) {
+        this.subscribers = subscribers;
+    }
+    // ------------------------------------------------------------------
+    normalize(options) {
+        if (options.type !== 'mysql' && options.type !== 'postgres' && options.type !== 'better-sqlite3') {
+            throw new Error(`The database type ${options.type} is not supported.`);
+        }
+        options = {
+            ...options,
+            logging: false,
+            entities: [
+                ...options.entities ? options.entities : [],
+                ...this.entities
+            ],
+            migrations: [],
+            migrationsTransactionMode: 'each',
+            subscribers: [
+                ...options.subscribers || [],
+                ...this.subscribers
+            ]
+        };
+        if (options.type === 'mysql' || options.type === 'postgres') {
+            let migrationPath = `src/database/migrations/${options.type}/*.{ts,js}`;
+            if (!isCodeTransformation(CodeTransformation.JUST_IN_TIME)) {
+                migrationPath = transformFilePath(migrationPath, './dist', './src');
+            }
+            Object.assign(options, {
+                migrations: [
+                    migrationPath
+                ],
+                migrationsTransactionMode: 'all'
+            });
+        }
+        if (options.type === 'mysql') {
+            Object.assign(options, {
+                connectorPackage: 'mysql2'
+            });
+        }
+        return options;
+    }
+}
 
 class BaseSubscriber {
     publisher;
@@ -7,7 +74,9 @@ class BaseSubscriber {
     refType;
     constructor(ctx){
         this.refType = ctx.refType;
-        this.publisher = useEntityEventPublisher();
+        if (isEntityEventPublisherUsable()) {
+            this.publisher = useEntityEventPublisher();
+        }
         this.destinations = ctx.destinations;
     }
     async afterInsert(event) {
@@ -35,6 +104,9 @@ class BaseSubscriber {
         }
     }
     async publish(payload) {
+        if (!this.publisher) {
+            return;
+        }
         await this.publisher.safePublish({
             data: payload.data,
             dataPrevious: payload.dataPrevious,
@@ -49,5 +121,5 @@ class BaseSubscriber {
     }
 }
 
-export { BaseSubscriber };
+export { BaseSubscriber, DataSourceOptionsBuilder };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/subscriber/base.ts"],"sourcesContent":["/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { ObjectLiteral } from '@privateaim/kit';\nimport { DomainEventName } from '@privateaim/kit';\nimport type {\n    EntityEventDestinations, EntityEventDestinationsFn,\n    EntityEventPublisher,\n} from '@privateaim/server-kit';\nimport { useEntityEventPublisher } from '@privateaim/server-kit';\nimport type {\n    EntitySubscriberInterface, InsertEvent, RemoveEvent, UpdateEvent,\n} from 'typeorm';\nimport type { BaseSubscriberContext, SubscriberPublishPayload } from './types';\n\nexport class BaseSubscriber<\n    RECORD extends ObjectLiteral,\n> implements EntitySubscriberInterface<RECORD> {\n    private readonly publisher: EntityEventPublisher;\n\n    private readonly destinations : EntityEventDestinations | EntityEventDestinationsFn<RECORD>;\n\n    private readonly refType: string;\n\n    constructor(ctx: BaseSubscriberContext<RECORD>) {\n        this.refType = ctx.refType;\n        this.publisher = useEntityEventPublisher();\n        this.destinations = ctx.destinations;\n    }\n\n    async afterInsert(event: InsertEvent<RECORD>): Promise<any> {\n        await this.publish({\n            data: event.entity,\n            type: DomainEventName.CREATED,\n            metadata: event.queryRunner.data,\n        });\n    }\n\n    async afterUpdate(event: UpdateEvent<RECORD>): Promise<any> {\n        await this.publish({\n            type: DomainEventName.UPDATED,\n            data: event.entity as RECORD,\n            dataPrevious: event.databaseEntity,\n            metadata: event.queryRunner.data,\n        });\n    }\n\n    async beforeRemove(event: RemoveEvent<RECORD>): Promise<any> {\n        if (event.entity) {\n            await this.publish({\n                type: DomainEventName.DELETED,\n                data: event.entity as RECORD,\n                metadata: event.queryRunner.data,\n            });\n        }\n    }\n\n    async publish(payload: SubscriberPublishPayload<RECORD>) {\n        await this.publisher.safePublish({\n            data: payload.data,\n            dataPrevious: payload.dataPrevious,\n            metadata: {\n                ref_type: this.refType,\n                ref_id: payload.data.id,\n\n                event: payload.type,\n                ...(payload.metadata ? payload.metadata : {}),\n            },\n            destinations: this.destinations,\n        });\n    }\n}\n"],"names":["BaseSubscriber","publisher","destinations","refType","ctx","useEntityEventPublisher","afterInsert","event","publish","data","entity","type","DomainEventName","CREATED","metadata","queryRunner","afterUpdate","UPDATED","dataPrevious","databaseEntity","beforeRemove","DELETED","payload","safePublish","ref_type","ref_id","id"],"mappings":";;;AAmBO,MAAMA,cAAAA,CAAAA;IAGQC,SAAAA;IAEAC,YAAAA;IAEAC,OAAAA;AAEjB,IAAA,WAAA,CAAYC,GAAkC,CAAE;AAC5C,QAAA,IAAI,CAACD,OAAO,GAAGC,GAAAA,CAAID,OAAO;QAC1B,IAAI,CAACF,SAAS,GAAGI,uBAAAA,EAAAA;AACjB,QAAA,IAAI,CAACH,YAAY,GAAGE,GAAAA,CAAIF,YAAY;AACxC,IAAA;IAEA,MAAMI,WAAAA,CAAYC,KAA0B,EAAgB;QACxD,MAAM,IAAI,CAACC,OAAO,CAAC;AACfC,YAAAA,IAAAA,EAAMF,MAAMG,MAAM;AAClBC,YAAAA,IAAAA,EAAMC,gBAAgBC,OAAO;YAC7BC,QAAAA,EAAUP,KAAAA,CAAMQ,WAAW,CAACN;AAChC,SAAA,CAAA;AACJ,IAAA;IAEA,MAAMO,WAAAA,CAAYT,KAA0B,EAAgB;QACxD,MAAM,IAAI,CAACC,OAAO,CAAC;AACfG,YAAAA,IAAAA,EAAMC,gBAAgBK,OAAO;AAC7BR,YAAAA,IAAAA,EAAMF,MAAMG,MAAM;AAClBQ,YAAAA,YAAAA,EAAcX,MAAMY,cAAc;YAClCL,QAAAA,EAAUP,KAAAA,CAAMQ,WAAW,CAACN;AAChC,SAAA,CAAA;AACJ,IAAA;IAEA,MAAMW,YAAAA,CAAab,KAA0B,EAAgB;QACzD,IAAIA,KAAAA,CAAMG,MAAM,EAAE;YACd,MAAM,IAAI,CAACF,OAAO,CAAC;AACfG,gBAAAA,IAAAA,EAAMC,gBAAgBS,OAAO;AAC7BZ,gBAAAA,IAAAA,EAAMF,MAAMG,MAAM;gBAClBI,QAAAA,EAAUP,KAAAA,CAAMQ,WAAW,CAACN;AAChC,aAAA,CAAA;AACJ,QAAA;AACJ,IAAA;IAEA,MAAMD,OAAAA,CAAQc,OAAyC,EAAE;AACrD,QAAA,MAAM,IAAI,CAACrB,SAAS,CAACsB,WAAW,CAAC;AAC7Bd,YAAAA,IAAAA,EAAMa,QAAQb,IAAI;AAClBS,YAAAA,YAAAA,EAAcI,QAAQJ,YAAY;YAClCJ,QAAAA,EAAU;gBACNU,QAAAA,EAAU,IAAI,CAACrB,OAAO;gBACtBsB,MAAAA,EAAQH,OAAAA,CAAQb,IAAI,CAACiB,EAAE;AAEvBnB,gBAAAA,KAAAA,EAAOe,QAAQX,IAAI;AACnB,gBAAA,GAAIW,QAAQR,QAAQ,GAAGQ,QAAQR,QAAQ,GAAG;AAC9C,aAAA;YACAZ,YAAAA,EAAc,IAAI,CAACA;AACvB,SAAA,CAAA;AACJ,IAAA;AACJ;;;;"}
+{"version":3,"file":"index.mjs","sources":["../src/data-source/options.ts","../src/subscriber/base.ts"],"sourcesContent":["/*\n * Copyright (c) 2026.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { DataSourceOptions } from 'typeorm';\nimport {\n    CodeTransformation,\n    isCodeTransformation,\n    readDataSourceOptionsFromEnv,\n    transformFilePath,\n} from 'typeorm-extension';\n\nexport type DataSourceOptionsEntities = DataSourceOptions['entities'];\nexport type DataSourceOptionsSubscribers = DataSourceOptions['subscribers'];\n\nexport class DataSourceOptionsBuilder {\n    protected entities : DataSourceOptionsEntities;\n\n    protected subscribers : DataSourceOptionsSubscribers;\n\n    // ------------------------------------------------------------------\n\n    constructor() {\n        this.entities = [];\n        this.subscribers = [];\n    }\n\n    // ------------------------------------------------------------------\n\n    buildWithEnv() {\n        const options = readDataSourceOptionsFromEnv();\n\n        if (!options) {\n            throw new Error('The database configuration could not be read from env variables.');\n        }\n\n        return this.normalize(options);\n    }\n\n    buildWith(options: DataSourceOptions) {\n        return this.normalize(options);\n    }\n\n    // ------------------------------------------------------------------\n\n    setEntities(entities: DataSourceOptionsEntities) {\n        this.entities = entities;\n    }\n\n    setSubscribers(subscribers: DataSourceOptionsSubscribers) {\n        this.subscribers = subscribers;\n    }\n\n    // ------------------------------------------------------------------\n\n    protected normalize(options: DataSourceOptions) : DataSourceOptions {\n        if (\n            options.type !== 'mysql' &&\n            options.type !== 'postgres' &&\n            options.type !== 'better-sqlite3'\n        ) {\n            throw new Error(`The database type ${options.type} is not supported.`);\n        }\n\n        options = {\n            ...options,\n            logging: false,\n            entities: [\n                ...(options.entities ? options.entities : []) as string[],\n                ...(this.entities) as string[],\n            ],\n            migrations: [],\n            migrationsTransactionMode: 'each',\n            subscribers: [\n                ...(options.subscribers || []) as string[],\n                ...this.subscribers as string[],\n            ],\n        };\n\n        if (options.type === 'mysql' || options.type === 'postgres') {\n            let migrationPath = `src/database/migrations/${options.type}/*.{ts,js}`;\n            if (!isCodeTransformation(CodeTransformation.JUST_IN_TIME)) {\n                migrationPath = transformFilePath(migrationPath, './dist', './src');\n            }\n\n            Object.assign(options, {\n                migrations: [migrationPath],\n                migrationsTransactionMode: 'all',\n            } as DataSourceOptions);\n        }\n\n        if (options.type === 'mysql') {\n            Object.assign(options, {\n                connectorPackage: 'mysql2',\n            } satisfies Partial<DataSourceOptions>);\n        }\n\n        return options;\n    }\n}\n","/*\n * Copyright (c) 2025.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport type { ObjectLiteral } from '@privateaim/kit';\nimport { DomainEventName } from '@privateaim/kit';\nimport type {\n    EntityEventDestinations, EntityEventDestinationsFn,\n    EntityEventPublisher,\n} from '@privateaim/server-kit';\nimport {\n    isEntityEventPublisherUsable,\n    useEntityEventPublisher,\n} from '@privateaim/server-kit';\nimport type {\n    EntitySubscriberInterface, InsertEvent, RemoveEvent, UpdateEvent,\n} from 'typeorm';\nimport type { BaseSubscriberContext, SubscriberPublishPayload } from './types';\n\nexport class BaseSubscriber<\n    RECORD extends ObjectLiteral,\n> implements EntitySubscriberInterface<RECORD> {\n    private readonly publisher: EntityEventPublisher | undefined;\n\n    private readonly destinations : EntityEventDestinations | EntityEventDestinationsFn<RECORD>;\n\n    private readonly refType: string;\n\n    constructor(ctx: BaseSubscriberContext<RECORD>) {\n        this.refType = ctx.refType;\n        if (isEntityEventPublisherUsable()) {\n            this.publisher = useEntityEventPublisher();\n        }\n\n        this.destinations = ctx.destinations;\n    }\n\n    async afterInsert(event: InsertEvent<RECORD>): Promise<any> {\n        await this.publish({\n            data: event.entity,\n            type: DomainEventName.CREATED,\n            metadata: event.queryRunner.data,\n        });\n    }\n\n    async afterUpdate(event: UpdateEvent<RECORD>): Promise<any> {\n        await this.publish({\n            type: DomainEventName.UPDATED,\n            data: event.entity as RECORD,\n            dataPrevious: event.databaseEntity,\n            metadata: event.queryRunner.data,\n        });\n    }\n\n    async beforeRemove(event: RemoveEvent<RECORD>): Promise<any> {\n        if (event.entity) {\n            await this.publish({\n                type: DomainEventName.DELETED,\n                data: event.entity as RECORD,\n                metadata: event.queryRunner.data,\n            });\n        }\n    }\n\n    async publish(payload: SubscriberPublishPayload<RECORD>) {\n        if (!this.publisher) {\n            return;\n        }\n\n        await this.publisher.safePublish({\n            data: payload.data,\n            dataPrevious: payload.dataPrevious,\n            metadata: {\n                ref_type: this.refType,\n                ref_id: payload.data.id,\n\n                event: payload.type,\n                ...(payload.metadata ? payload.metadata : {}),\n            },\n            destinations: this.destinations,\n        });\n    }\n}\n"],"names":["DataSourceOptionsBuilder","entities","subscribers","buildWithEnv","options","readDataSourceOptionsFromEnv","Error","normalize","buildWith","setEntities","setSubscribers","type","logging","migrations","migrationsTransactionMode","migrationPath","isCodeTransformation","CodeTransformation","JUST_IN_TIME","transformFilePath","Object","assign","connectorPackage","BaseSubscriber","publisher","destinations","refType","ctx","isEntityEventPublisherUsable","useEntityEventPublisher","afterInsert","event","publish","data","entity","DomainEventName","CREATED","metadata","queryRunner","afterUpdate","UPDATED","dataPrevious","databaseEntity","beforeRemove","DELETED","payload","safePublish","ref_type","ref_id","id"],"mappings":"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"}

package/dist/subscriber/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/subscriber/base.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOrD,OAAO,KAAK,EACR,yBAAyB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EACnE,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE/E,qBAAa,cAAc,CACvB,MAAM,SAAS,aAAa,CAC9B,YAAW,yBAAyB,CAAC,MAAM,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+D;IAE5F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,GAAG,EAAE,qBAAqB,CAAC,MAAM,CAAC;IAMxC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAQrD,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IASrD,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAUtD,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC;CAc1D"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/subscriber/base.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAUrD,OAAO,KAAK,EACR,yBAAyB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EACnE,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE/E,qBAAa,cAAc,CACvB,MAAM,SAAS,aAAa,CAC9B,YAAW,yBAAyB,CAAC,MAAM,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAE7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+D;IAE5F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,GAAG,EAAE,qBAAqB,CAAC,MAAM,CAAC;IASxC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAQrD,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IASrD,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAUtD,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC;CAkB1D"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@privateaim/server-db-kit",
     "type": "module",
-    "version": "0.8.26",
+    "version": "0.8.28",
     "module": "dist/index.mjs",
     "types": "dist/index.d.ts",
     "exports": {
@@ -19,16 +19,16 @@
     "license": "Apache-2.0",
     "description": "This package contains server side db helpers & utilities.",
     "dependencies": {
-        "@privateaim/kit": "^0.8.26",
-        "@privateaim/server-kit": "^0.8.26"
+        "@privateaim/kit": "^0.8.28",
+        "@privateaim/server-kit": "^0.8.28"
     },
     "devDependencies": {
         "typeorm": "^0.3.28",
-        "typeorm-extension": "^3.8.0"
+        "typeorm-extension": "^3.9.0"
     },
     "peerDependencies": {
         "typeorm": "^0.3.28",
-        "typeorm-extension": "^3.8.0"
+        "typeorm-extension": "^3.9.0"
     },
     "scripts": {
         "build:types": "tsc --emitDeclarationOnly -p tsconfig.build.json",

package/src/data-source/index.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2026.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+export * from './options.ts';

package/src/data-source/options.ts

@@ -0,0 +1,103 @@
+/*
+ * Copyright (c) 2026.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+
+import type { DataSourceOptions } from 'typeorm';
+import {
+    CodeTransformation,
+    isCodeTransformation,
+    readDataSourceOptionsFromEnv,
+    transformFilePath,
+} from 'typeorm-extension';
+
+export type DataSourceOptionsEntities = DataSourceOptions['entities'];
+export type DataSourceOptionsSubscribers = DataSourceOptions['subscribers'];
+
+export class DataSourceOptionsBuilder {
+    protected entities : DataSourceOptionsEntities;
+
+    protected subscribers : DataSourceOptionsSubscribers;
+
+    // ------------------------------------------------------------------
+
+    constructor() {
+        this.entities = [];
+        this.subscribers = [];
+    }
+
+    // ------------------------------------------------------------------
+
+    buildWithEnv() {
+        const options = readDataSourceOptionsFromEnv();
+
+        if (!options) {
+            throw new Error('The database configuration could not be read from env variables.');
+        }
+
+        return this.normalize(options);
+    }
+
+    buildWith(options: DataSourceOptions) {
+        return this.normalize(options);
+    }
+
+    // ------------------------------------------------------------------
+
+    setEntities(entities: DataSourceOptionsEntities) {
+        this.entities = entities;
+    }
+
+    setSubscribers(subscribers: DataSourceOptionsSubscribers) {
+        this.subscribers = subscribers;
+    }
+
+    // ------------------------------------------------------------------
+
+    protected normalize(options: DataSourceOptions) : DataSourceOptions {
+        if (
+            options.type !== 'mysql' &&
+            options.type !== 'postgres' &&
+            options.type !== 'better-sqlite3'
+        ) {
+            throw new Error(`The database type ${options.type} is not supported.`);
+        }
+
+        options = {
+            ...options,
+            logging: false,
+            entities: [
+                ...(options.entities ? options.entities : []) as string[],
+                ...(this.entities) as string[],
+            ],
+            migrations: [],
+            migrationsTransactionMode: 'each',
+            subscribers: [
+                ...(options.subscribers || []) as string[],
+                ...this.subscribers as string[],
+            ],
+        };
+
+        if (options.type === 'mysql' || options.type === 'postgres') {
+            let migrationPath = `src/database/migrations/${options.type}/*.{ts,js}`;
+            if (!isCodeTransformation(CodeTransformation.JUST_IN_TIME)) {
+                migrationPath = transformFilePath(migrationPath, './dist', './src');
+            }
+
+            Object.assign(options, {
+                migrations: [migrationPath],
+                migrationsTransactionMode: 'all',
+            } as DataSourceOptions);
+        }
+
+        if (options.type === 'mysql') {
+            Object.assign(options, {
+                connectorPackage: 'mysql2',
+            } satisfies Partial<DataSourceOptions>);
+        }
+
+        return options;
+    }
+}

package/src/index.ts

@@ -5,4 +5,5 @@
  * view the LICENSE file that was distributed with this source code.
  */
 
-export * from './subscriber';
+export * from './data-source/index.ts';
+export * from './subscriber/index.ts';

package/src/subscriber/base.ts

@@ -11,7 +11,10 @@ import type {
     EntityEventDestinations, EntityEventDestinationsFn,
     EntityEventPublisher,
 } from '@privateaim/server-kit';
-import { useEntityEventPublisher } from '@privateaim/server-kit';
+import {
+    isEntityEventPublisherUsable,
+    useEntityEventPublisher,
+} from '@privateaim/server-kit';
 import type {
     EntitySubscriberInterface, InsertEvent, RemoveEvent, UpdateEvent,
 } from 'typeorm';
@@ -20,7 +23,7 @@ import type { BaseSubscriberContext, SubscriberPublishPayload } from './types';
 export class BaseSubscriber<
     RECORD extends ObjectLiteral,
 > implements EntitySubscriberInterface<RECORD> {
-    private readonly publisher: EntityEventPublisher;
+    private readonly publisher: EntityEventPublisher | undefined;
 
     private readonly destinations : EntityEventDestinations | EntityEventDestinationsFn<RECORD>;
 
@@ -28,7 +31,10 @@ export class BaseSubscriber<
 
     constructor(ctx: BaseSubscriberContext<RECORD>) {
         this.refType = ctx.refType;
-        this.publisher = useEntityEventPublisher();
+        if (isEntityEventPublisherUsable()) {
+            this.publisher = useEntityEventPublisher();
+        }
+
         this.destinations = ctx.destinations;
     }
 
@@ -60,6 +66,10 @@ export class BaseSubscriber<
     }
 
     async publish(payload: SubscriberPublishPayload<RECORD>) {
+        if (!this.publisher) {
+            return;
+        }
+
         await this.publisher.safePublish({
             data: payload.data,
             dataPrevious: payload.dataPrevious,