@eggjs/tegg-dal-plugin 4.0.0-beta.4 → 4.0.0-beta.5

package/README.md

@@ -1,5 +1,17 @@
 # @eggjs/tegg-dal-plugin
 
+[![NPM version][npm-image]][npm-url]
+[![Known Vulnerabilities][snyk-image]][snyk-url]
+[![npm download][download-image]][download-url]
+[![Node.js Version](https://img.shields.io/node/v/@eggjs/tegg-dal-plugin.svg?style=flat)](https://nodejs.org/en/download/)
+
+[npm-image]: https://img.shields.io/npm/v/@eggjs/tegg-dal-plugin.svg?style=flat-square
+[npm-url]: https://npmjs.org/package/@eggjs/tegg-dal-plugin
+[snyk-image]: https://snyk.io/test/npm/@eggjs/tegg-dal-plugin/badge.svg?style=flat-square
+[snyk-url]: https://snyk.io/test/npm/@eggjs/tegg-dal-plugin
+[download-image]: https://img.shields.io/npm/dm/@eggjs/tegg-dal-plugin.svg?style=flat-square
+[download-url]: https://npmjs.org/package/@eggjs/tegg-dal-plugin
+
 @eggjs/tegg-dal-plugin 支持使用注解的方式来开发 egg 中的 dal。
 
 ## egg 模式
@@ -567,7 +579,7 @@ export class FooRepository {
 
 ```ts
 // dal/extension/FooExtension.ts
-import { SqlMap, SqlType } from '@eggjs/tegg/dal';
+import { type SqlMap, SqlType } from '@eggjs/tegg/dal';
 
 export default {
   findByName: {

package/dist/_virtual/_@oxc-project_runtime@0.93.0/helpers/decorate.js

@@ -0,0 +1,10 @@
+//#region \0@oxc-project+runtime@0.93.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+export { __decorate };

package/dist/_virtual/_@oxc-project_runtime@0.93.0/helpers/decorateMetadata.js

@@ -0,0 +1,7 @@
+//#region \0@oxc-project+runtime@0.93.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+export { __decorateMetadata };

package/dist/_virtual/_@oxc-project_runtime@0.93.0/helpers/decorateParam.js

@@ -0,0 +1,9 @@
+//#region \0@oxc-project+runtime@0.93.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+export { __decorateParam };

package/dist/app.d.ts

@@ -0,0 +1,14 @@
+import { Application, ILifecycleBoot } from "egg";
+
+//#region src/app.d.ts
+declare class DalAppBootHook implements ILifecycleBoot {
+  private readonly app;
+  private dalTableEggPrototypeHook;
+  private dalModuleLoadUnitHook;
+  private transactionPrototypeHook;
+  constructor(app: Application);
+  configWillLoad(): void;
+  beforeClose(): Promise<void>;
+}
+//#endregion
+export { DalAppBootHook as default };

package/dist/app.js

@@ -0,0 +1,36 @@
+import { TableModelManager } from "./lib/TableModelManager.js";
+import { SqlMapManager } from "./lib/SqlMapManager.js";
+import { DalTableEggPrototypeHook } from "./lib/DalTableEggPrototypeHook.js";
+import { MysqlDataSourceManager } from "./lib/MysqlDataSourceManager.js";
+import { DalModuleLoadUnitHook } from "./lib/DalModuleLoadUnitHook.js";
+import { TransactionPrototypeHook } from "./lib/TransactionPrototypeHook.js";
+
+//#region src/app.ts
+var DalAppBootHook = class {
+	app;
+	dalTableEggPrototypeHook;
+	dalModuleLoadUnitHook;
+	transactionPrototypeHook;
+	constructor(app) {
+		this.app = app;
+	}
+	configWillLoad() {
+		this.dalModuleLoadUnitHook = new DalModuleLoadUnitHook(this.app.config.env, this.app.moduleConfigs);
+		this.dalTableEggPrototypeHook = new DalTableEggPrototypeHook(this.app.logger);
+		this.transactionPrototypeHook = new TransactionPrototypeHook(this.app.moduleConfigs, this.app.logger);
+		this.app.eggPrototypeLifecycleUtil.registerLifecycle(this.dalTableEggPrototypeHook);
+		this.app.eggPrototypeLifecycleUtil.registerLifecycle(this.transactionPrototypeHook);
+		this.app.loadUnitLifecycleUtil.registerLifecycle(this.dalModuleLoadUnitHook);
+	}
+	async beforeClose() {
+		if (this.dalTableEggPrototypeHook) this.app.eggPrototypeLifecycleUtil.deleteLifecycle(this.dalTableEggPrototypeHook);
+		if (this.dalModuleLoadUnitHook) this.app.loadUnitLifecycleUtil.deleteLifecycle(this.dalModuleLoadUnitHook);
+		if (this.transactionPrototypeHook) this.app.eggPrototypeLifecycleUtil.deleteLifecycle(this.transactionPrototypeHook);
+		MysqlDataSourceManager.instance.clear();
+		SqlMapManager.instance.clear();
+		TableModelManager.instance.clear();
+	}
+};
+
+//#endregion
+export { DalAppBootHook as default };

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { DalModuleLoadUnitHook } from "./lib/DalModuleLoadUnitHook.js";
+import { DalTableEggPrototypeHook } from "./lib/DalTableEggPrototypeHook.js";
+import { TransactionalAOP, TransactionalParams } from "./lib/TransactionalAOP.js";
+import { DataSourceDelegate } from "./lib/DataSource.js";
+import { MysqlDataSourceManager } from "./lib/MysqlDataSourceManager.js";
+import { SqlMapManager } from "./lib/SqlMapManager.js";
+import { TableModelManager } from "./lib/TableModelManager.js";
+import { TransactionPrototypeHook } from "./lib/TransactionPrototypeHook.js";
+export { DalModuleLoadUnitHook, DalTableEggPrototypeHook, DataSourceDelegate, MysqlDataSourceManager, SqlMapManager, TableModelManager, TransactionPrototypeHook, TransactionalAOP, TransactionalParams };

package/dist/index.js

@@ -0,0 +1,11 @@
+import { TableModelManager } from "./lib/TableModelManager.js";
+import { SqlMapManager } from "./lib/SqlMapManager.js";
+import { DalTableEggPrototypeHook } from "./lib/DalTableEggPrototypeHook.js";
+import { MysqlDataSourceManager } from "./lib/MysqlDataSourceManager.js";
+import { DalModuleLoadUnitHook } from "./lib/DalModuleLoadUnitHook.js";
+import { TransactionalAOP } from "./lib/TransactionalAOP.js";
+import { TransactionPrototypeHook } from "./lib/TransactionPrototypeHook.js";
+import "./types.js";
+import { DataSourceDelegate } from "./lib/DataSource.js";
+
+export { DalModuleLoadUnitHook, DalTableEggPrototypeHook, DataSourceDelegate, MysqlDataSourceManager, SqlMapManager, TableModelManager, TransactionPrototypeHook, TransactionalAOP };

package/dist/lib/DalModuleLoadUnitHook.d.ts

@@ -0,0 +1,13 @@
+import { LifecycleHook, Logger, ModuleConfigHolder } from "@eggjs/tegg";
+import { LoadUnit, LoadUnitLifecycleContext } from "@eggjs/tegg/helper";
+
+//#region src/lib/DalModuleLoadUnitHook.d.ts
+declare class DalModuleLoadUnitHook implements LifecycleHook<LoadUnitLifecycleContext, LoadUnit> {
+  private readonly moduleConfigs;
+  private readonly env;
+  private readonly logger?;
+  constructor(env: string, moduleConfigs: Record<string, ModuleConfigHolder>, logger?: Logger);
+  preCreate(_: LoadUnitLifecycleContext, loadUnit: LoadUnit): Promise<void>;
+}
+//#endregion
+export { DalModuleLoadUnitHook };

package/dist/lib/DalModuleLoadUnitHook.js

@@ -0,0 +1,40 @@
+import { MysqlDataSourceManager } from "./MysqlDataSourceManager.js";
+import "@eggjs/tegg";
+import "@eggjs/tegg/helper";
+import { DatabaseForker } from "@eggjs/dal-runtime";
+
+//#region src/lib/DalModuleLoadUnitHook.ts
+var DalModuleLoadUnitHook = class {
+	moduleConfigs;
+	env;
+	logger;
+	constructor(env, moduleConfigs, logger) {
+		this.env = env;
+		this.moduleConfigs = moduleConfigs;
+		this.logger = logger;
+	}
+	async preCreate(_, loadUnit) {
+		const moduleConfigHolder = this.moduleConfigs[loadUnit.name];
+		if (!moduleConfigHolder) return;
+		const dataSourceConfig = moduleConfigHolder.config.dataSource;
+		if (!dataSourceConfig) return;
+		await Promise.all(Object.entries(dataSourceConfig).map(async ([name, config]) => {
+			const dataSourceOptions = {
+				...config,
+				name,
+				logger: this.logger
+			};
+			const forker = new DatabaseForker(this.env, dataSourceOptions);
+			if (forker.shouldFork()) await forker.forkDb(loadUnit.unitPath);
+			try {
+				await MysqlDataSourceManager.instance.createDataSource(loadUnit.name, name, dataSourceOptions);
+			} catch (e) {
+				if (e instanceof Error) e.message = `create module ${loadUnit.name} datasource ${name} failed: ${e.message}`;
+				throw e;
+			}
+		}));
+	}
+};
+
+//#endregion
+export { DalModuleLoadUnitHook };

package/dist/lib/DalTableEggPrototypeHook.d.ts

@@ -0,0 +1,11 @@
+import { LifecycleHook, Logger } from "@eggjs/tegg";
+import { EggPrototype, EggPrototypeLifecycleContext } from "@eggjs/tegg/helper";
+
+//#region src/lib/DalTableEggPrototypeHook.d.ts
+declare class DalTableEggPrototypeHook implements LifecycleHook<EggPrototypeLifecycleContext, EggPrototype> {
+  private readonly logger;
+  constructor(logger: Logger);
+  preCreate(ctx: EggPrototypeLifecycleContext): Promise<void>;
+}
+//#endregion
+export { DalTableEggPrototypeHook };

package/dist/lib/DalTableEggPrototypeHook.js

@@ -0,0 +1,25 @@
+import { TableModelManager } from "./TableModelManager.js";
+import { SqlMapManager } from "./SqlMapManager.js";
+import "@eggjs/tegg";
+import "@eggjs/tegg/helper";
+import { DaoInfoUtil, TableModel } from "@eggjs/dal-decorator";
+import { SqlMapLoader } from "@eggjs/dal-runtime";
+
+//#region src/lib/DalTableEggPrototypeHook.ts
+var DalTableEggPrototypeHook = class {
+	logger;
+	constructor(logger) {
+		this.logger = logger;
+	}
+	async preCreate(ctx) {
+		if (!DaoInfoUtil.getIsDao(ctx.clazz)) return;
+		const tableClazz = ctx.clazz.clazzModel;
+		const tableModel = TableModel.build(tableClazz);
+		TableModelManager.instance.set(ctx.loadUnit.name, tableModel);
+		const sqlMap = new SqlMapLoader(tableModel, ctx.clazz, this.logger).load();
+		SqlMapManager.instance.set(ctx.loadUnit.name, sqlMap);
+	}
+};
+
+//#endregion
+export { DalTableEggPrototypeHook };

package/dist/lib/DataSource.d.ts

@@ -0,0 +1,12 @@
+import { TransactionalAOP } from "./TransactionalAOP.js";
+import { ObjectInfo } from "@eggjs/tegg";
+import { DataSource } from "@eggjs/dal-runtime";
+
+//#region src/lib/DataSource.d.ts
+declare class DataSourceDelegate<T> extends DataSource<T> {
+  private transactionalAOP;
+  objInfo: ObjectInfo;
+  constructor(transactionalAOP: TransactionalAOP, objInfo: ObjectInfo);
+}
+//#endregion
+export { DataSourceDelegate };

package/dist/lib/DataSource.js

@@ -0,0 +1,68 @@
+import { TableModelManager } from "./TableModelManager.js";
+import { SqlMapManager } from "./SqlMapManager.js";
+import { MysqlDataSourceManager } from "./MysqlDataSourceManager.js";
+import { __decorate } from "../_virtual/_@oxc-project_runtime@0.93.0/helpers/decorate.js";
+import { TransactionalAOP } from "./TransactionalAOP.js";
+import { __decorateMetadata } from "../_virtual/_@oxc-project_runtime@0.93.0/helpers/decorateMetadata.js";
+import { __decorateParam } from "../_virtual/_@oxc-project_runtime@0.93.0/helpers/decorateParam.js";
+import { AccessLevel, Inject, LoadUnitNameQualifierAttribute, MultiInstanceInfo, MultiInstanceProto, ObjectInitType } from "@eggjs/tegg";
+import { EggLoadUnitType, LoaderFactory, ModuleConfigUtil } from "@eggjs/tegg/helper";
+import { DataSource } from "@eggjs/dal-runtime";
+import assert from "node:assert";
+import { DataSourceInjectName, DataSourceQualifierAttribute, TableInfoUtil } from "@eggjs/tegg/dal";
+
+//#region src/lib/DataSource.ts
+var _ref;
+let DataSourceDelegate = class DataSourceDelegate$1 extends DataSource {
+	transactionalAOP;
+	objInfo;
+	constructor(transactionalAOP, objInfo) {
+		const dataSourceQualifierValue = objInfo.qualifiers.find((t) => t.attribute === DataSourceQualifierAttribute)?.value;
+		assert(dataSourceQualifierValue);
+		const [moduleName, dataSource, clazzName] = dataSourceQualifierValue.split(".");
+		const tableModel = TableModelManager.instance.get(moduleName, clazzName);
+		assert(tableModel, `not found table ${dataSourceQualifierValue}`);
+		const mysqlDataSource = MysqlDataSourceManager.instance.get(moduleName, dataSource);
+		assert(mysqlDataSource, `not found dataSource ${dataSource} in module ${moduleName}`);
+		const sqlMap = SqlMapManager.instance.get(moduleName, clazzName);
+		assert(sqlMap, `not found SqlMap ${clazzName} in module ${moduleName}`);
+		super(tableModel, mysqlDataSource, sqlMap);
+		this.transactionalAOP = transactionalAOP;
+		this.objInfo = objInfo;
+	}
+};
+DataSourceDelegate = __decorate([
+	MultiInstanceProto({
+		accessLevel: AccessLevel.PUBLIC,
+		initType: ObjectInitType.SINGLETON,
+		async getObjects(ctx) {
+			const config = ModuleConfigUtil.loadModuleConfigSync(ctx.unitPath);
+			const dataSources = Object.keys(config?.dataSource || {});
+			const result = [];
+			const tableClazzList = (await LoaderFactory.createLoader(ctx.unitPath, EggLoadUnitType.MODULE).load()).filter((t) => {
+				return TableInfoUtil.getIsTable(t);
+			});
+			const dataSourceLength = dataSources.length;
+			for (const dataSource of dataSources) {
+				const moduleClazzList = tableClazzList.filter((clazz) => {
+					const dataSourceName = TableInfoUtil.getTableParams(clazz)?.dataSourceName ?? "default";
+					return dataSourceLength === 1 || dataSourceName === dataSource;
+				});
+				for (const clazz of moduleClazzList) result.push({
+					name: DataSourceInjectName,
+					qualifiers: [{
+						attribute: DataSourceQualifierAttribute,
+						value: `${ctx.moduleName}.${dataSource}.${clazz.name}`
+					}]
+				});
+			}
+			return result;
+		}
+	}),
+	__decorateParam(0, Inject({ name: "transactionalAOP" })),
+	__decorateParam(1, MultiInstanceInfo([DataSourceQualifierAttribute, LoadUnitNameQualifierAttribute])),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof TransactionalAOP !== "undefined" && TransactionalAOP) === "function" ? _ref : Object, Object])
+], DataSourceDelegate);
+
+//#endregion
+export { DataSourceDelegate };

package/dist/lib/MysqlDataSourceManager.d.ts

@@ -0,0 +1,15 @@
+import { DataSourceOptions, MysqlDataSource } from "@eggjs/dal-runtime";
+
+//#region src/lib/MysqlDataSourceManager.d.ts
+declare class MysqlDataSourceManager {
+  static instance: MysqlDataSourceManager;
+  private readonly dataSourceIndices;
+  private readonly dataSources;
+  constructor();
+  get(moduleName: string, dataSourceName: string): MysqlDataSource | undefined;
+  createDataSource(moduleName: string, dataSourceName: string, config: DataSourceOptions): Promise<void>;
+  clear(): void;
+  static createDataSourceKey(dataSourceOptions: DataSourceOptions): string;
+}
+//#endregion
+export { MysqlDataSourceManager };

package/dist/lib/MysqlDataSourceManager.js

@@ -0,0 +1,58 @@
+import { MysqlDataSource } from "@eggjs/dal-runtime";
+import crypto from "node:crypto";
+
+//#region src/lib/MysqlDataSourceManager.ts
+var MysqlDataSourceManager = class MysqlDataSourceManager {
+	static instance = new MysqlDataSourceManager();
+	dataSourceIndices;
+	dataSources;
+	constructor() {
+		this.dataSourceIndices = /* @__PURE__ */ new Map();
+		this.dataSources = /* @__PURE__ */ new Map();
+	}
+	get(moduleName, dataSourceName) {
+		const dataSourceIndex = this.dataSourceIndices.get(moduleName)?.get(dataSourceName);
+		if (dataSourceIndex) return this.dataSources.get(dataSourceIndex);
+	}
+	async createDataSource(moduleName, dataSourceName, config) {
+		const { logger,...dsConfig } = config || {};
+		const dataSourceConfig = {
+			...dsConfig,
+			name: dataSourceName
+		};
+		const index = MysqlDataSourceManager.createDataSourceKey(dataSourceConfig);
+		let dataSource = this.dataSources.get(index);
+		if (!dataSource) {
+			dataSource = new MysqlDataSource({
+				...dataSourceConfig,
+				logger
+			});
+			this.dataSources.set(index, dataSource);
+		}
+		let moduleDataSourceIndices = this.dataSourceIndices.get(moduleName);
+		if (!moduleDataSourceIndices) {
+			moduleDataSourceIndices = /* @__PURE__ */ new Map();
+			this.dataSourceIndices.set(moduleName, moduleDataSourceIndices);
+		}
+		moduleDataSourceIndices.set(dataSourceName, index);
+		await dataSource.ready();
+	}
+	clear() {
+		this.dataSourceIndices.clear();
+	}
+	static createDataSourceKey(dataSourceOptions) {
+		const hash = crypto.createHash("md5");
+		const keys = Object.keys(dataSourceOptions).sort();
+		for (const key of keys) {
+			const value = dataSourceOptions[key];
+			if (value) {
+				hash.update(key);
+				hash.update(String(value));
+			}
+		}
+		return hash.digest("hex");
+	}
+};
+
+//#endregion
+export { MysqlDataSourceManager };

package/dist/lib/SqlMapManager.d.ts

@@ -0,0 +1,13 @@
+import { TableSqlMap } from "@eggjs/dal-runtime";
+
+//#region src/lib/SqlMapManager.d.ts
+declare class SqlMapManager {
+  static instance: SqlMapManager;
+  private sqlMaps;
+  constructor();
+  get(moduleName: string, clazzName: string): TableSqlMap | undefined;
+  set(moduleName: string, sqlMap: TableSqlMap): void;
+  clear(): void;
+}
+//#endregion
+export { SqlMapManager };

package/dist/lib/SqlMapManager.js

@@ -0,0 +1,27 @@
+import { TableSqlMap } from "@eggjs/dal-runtime";
+
+//#region src/lib/SqlMapManager.ts
+var SqlMapManager = class SqlMapManager {
+	static instance = new SqlMapManager();
+	sqlMaps;
+	constructor() {
+		this.sqlMaps = /* @__PURE__ */ new Map();
+	}
+	get(moduleName, clazzName) {
+		return this.sqlMaps.get(moduleName)?.get(clazzName);
+	}
+	set(moduleName, sqlMap) {
+		let tables = this.sqlMaps.get(moduleName);
+		if (!tables) {
+			tables = /* @__PURE__ */ new Map();
+			this.sqlMaps.set(moduleName, tables);
+		}
+		tables.set(sqlMap.name, sqlMap);
+	}
+	clear() {
+		this.sqlMaps.clear();
+	}
+};
+
+//#endregion
+export { SqlMapManager };

package/dist/lib/TableModelManager.d.ts

@@ -0,0 +1,13 @@
+import { TableModel } from "@eggjs/dal-decorator";
+
+//#region src/lib/TableModelManager.d.ts
+declare class TableModelManager {
+  static instance: TableModelManager;
+  private tableModels;
+  constructor();
+  get(moduleName: string, clazzName: string): TableModel | undefined;
+  set(moduleName: string, tableModel: TableModel): void;
+  clear(): void;
+}
+//#endregion
+export { TableModelManager };

package/dist/lib/TableModelManager.js

@@ -0,0 +1,27 @@
+import { TableModel } from "@eggjs/dal-decorator";
+
+//#region src/lib/TableModelManager.ts
+var TableModelManager = class TableModelManager {
+	static instance = new TableModelManager();
+	tableModels;
+	constructor() {
+		this.tableModels = /* @__PURE__ */ new Map();
+	}
+	get(moduleName, clazzName) {
+		return this.tableModels.get(moduleName)?.get(clazzName);
+	}
+	set(moduleName, tableModel) {
+		let tables = this.tableModels.get(moduleName);
+		if (!tables) {
+			tables = /* @__PURE__ */ new Map();
+			this.tableModels.set(moduleName, tables);
+		}
+		tables.set(tableModel.clazz.name, tableModel);
+	}
+	clear() {
+		this.tableModels.clear();
+	}
+};
+
+//#endregion
+export { TableModelManager };

package/dist/lib/TransactionPrototypeHook.d.ts

@@ -0,0 +1,12 @@
+import { LifecycleHook, Logger, ModuleConfigHolder } from "@eggjs/tegg";
+import { EggPrototype, EggPrototypeLifecycleContext } from "@eggjs/tegg-metadata";
+
+//#region src/lib/TransactionPrototypeHook.d.ts
+declare class TransactionPrototypeHook implements LifecycleHook<EggPrototypeLifecycleContext, EggPrototype> {
+  private readonly moduleConfigs;
+  private readonly logger;
+  constructor(moduleConfigs: Record<string, ModuleConfigHolder>, logger: Logger);
+  preCreate(ctx: EggPrototypeLifecycleContext): Promise<void>;
+}
+//#endregion
+export { TransactionPrototypeHook };

package/dist/lib/TransactionPrototypeHook.js

@@ -0,0 +1,50 @@
+import { MysqlDataSourceManager } from "./MysqlDataSourceManager.js";
+import { TransactionalAOP } from "./TransactionalAOP.js";
+import "@eggjs/tegg";
+import assert from "node:assert";
+import "@eggjs/tegg-metadata";
+import { PropagationType, TransactionMetaBuilder } from "@eggjs/tegg/transaction";
+import { Pointcut } from "@eggjs/tegg/aop";
+
+//#region src/lib/TransactionPrototypeHook.ts
+var TransactionPrototypeHook = class {
+	moduleConfigs;
+	logger;
+	constructor(moduleConfigs, logger) {
+		this.moduleConfigs = moduleConfigs;
+		this.logger = logger;
+	}
+	async preCreate(ctx) {
+		const transactionMetadataList = new TransactionMetaBuilder(ctx.clazz).build();
+		if (transactionMetadataList.length < 1) return;
+		const moduleName = ctx.loadUnit.name;
+		for (const transactionMetadata of transactionMetadataList) {
+			const clazzName = `${moduleName}.${ctx.clazz.name}.${String(transactionMetadata.method)}`;
+			const datasourceConfigs = (this.moduleConfigs[moduleName]?.config)?.dataSource || {};
+			let datasourceName;
+			if (transactionMetadata.datasourceName) {
+				assert(datasourceConfigs[transactionMetadata.datasourceName], `method ${clazzName} specified datasource ${transactionMetadata.datasourceName} not exists`);
+				datasourceName = transactionMetadata.datasourceName;
+				this.logger.info(`use datasource [${transactionMetadata.datasourceName}] for class ${clazzName}`);
+			} else {
+				const dataSources = Object.keys(datasourceConfigs);
+				if (dataSources.length === 1) datasourceName = dataSources[0];
+				else throw new Error(`method ${clazzName} not specified datasource, module ${moduleName} has multi datasource, should specify datasource name`);
+				this.logger.info(`use default datasource ${dataSources[0]} for class ${clazzName}`);
+			}
+			const adviceParams = {
+				propagation: transactionMetadata.propagation,
+				dataSourceGetter: () => {
+					const mysqlDataSource = MysqlDataSourceManager.instance.get(moduleName, datasourceName);
+					if (!mysqlDataSource) throw new Error(`method ${clazzName} not found datasource ${datasourceName}`);
+					return mysqlDataSource;
+				}
+			};
+			assert(adviceParams.propagation === PropagationType.REQUIRED, "Transactional propagation only support required for now");
+			Pointcut(TransactionalAOP, { adviceParams })(ctx.clazz.prototype, transactionMetadata.method);
+		}
+	}
+};
+
+//#endregion
+export { TransactionPrototypeHook };

package/dist/lib/TransactionalAOP.d.ts

@@ -0,0 +1,15 @@
+import { EggProtoImplClass } from "@eggjs/tegg";
+import { MysqlDataSource } from "@eggjs/dal-runtime";
+import { PropagationType } from "@eggjs/tegg/transaction";
+import { AdviceContext, IAdvice } from "@eggjs/tegg/aop";
+
+//#region src/lib/TransactionalAOP.d.ts
+interface TransactionalParams {
+  propagation: PropagationType;
+  dataSourceGetter: () => MysqlDataSource;
+}
+declare class TransactionalAOP implements IAdvice<EggProtoImplClass, TransactionalParams> {
+  around(ctx: AdviceContext<EggProtoImplClass, TransactionalParams>, next: () => Promise<any>): Promise<void>;
+}
+//#endregion
+export { TransactionalAOP, TransactionalParams };

package/dist/lib/TransactionalAOP.js

@@ -0,0 +1,22 @@
+import { __decorate } from "../_virtual/_@oxc-project_runtime@0.93.0/helpers/decorate.js";
+import { AccessLevel, ObjectInitType } from "@eggjs/tegg";
+import { MysqlDataSource } from "@eggjs/dal-runtime";
+import { PropagationType } from "@eggjs/tegg/transaction";
+import { Advice } from "@eggjs/tegg/aop";
+
+//#region src/lib/TransactionalAOP.ts
+let TransactionalAOP = class TransactionalAOP$1 {
+	async around(ctx, next) {
+		const { propagation, dataSourceGetter } = ctx.adviceParams;
+		const dataSource = dataSourceGetter();
+		if (propagation === PropagationType.ALWAYS_NEW) return await dataSource.beginTransactionScope(next);
+		return await dataSource.beginTransactionScope(next);
+	}
+};
+TransactionalAOP = __decorate([Advice({
+	accessLevel: AccessLevel.PUBLIC,
+	initType: ObjectInitType.SINGLETON
+})], TransactionalAOP);
+
+//#endregion
+export { TransactionalAOP };

package/dist/types.d.ts

@@ -0,0 +1 @@
+import "@eggjs/tegg-plugin/types";

package/dist/types.js

@@ -0,0 +1,3 @@
+import "@eggjs/tegg-plugin/types";
+
+export {  };