@fragno-dev/db 0.1.15 → 0.2.1

package/dist/query/{unit-of-work.d.ts → unit-of-work/unit-of-work.d.ts}

@@ -1,11 +1,12 @@
-import { AnySchema, AnyTable, FragnoId, IdColumn, Index, Relation } from "../schema/create.js";
-import { Condition, ConditionBuilder } from "./condition-builder.js";
-import { CompiledJoin } from "./orm/orm.js";
-import { Cursor, CursorResult } from "./cursor.js";
-import { Prettify } from "../util/types.js";
-import { ExtractJoinOut, ExtractSelect, SelectClause, SelectResult, TableToInsertValues, TableToUpdateValues } from "./query.js";
+import { AnySchema, AnyTable, FragnoId, IdColumn, Index, Relation } from "../../schema/create.js";
+import { Condition, ConditionBuilder } from "../condition-builder.js";
+import { CompiledJoin } from "../orm/orm.js";
+import { Cursor, CursorResult } from "../cursor.js";
+import { Prettify } from "../../util/types.js";
+import { HookPayload, HooksMap, TriggerHookOptions, TriggeredHook } from "../../hooks/hooks.js";
+import { ExtractJoinOut, ExtractSelect, SelectClause, SelectResult, TableToInsertValues, TableToUpdateValues } from "../simple-query-interface.js";
 
-//#region src/query/unit-of-work.d.ts
+//#region src/query/unit-of-work/unit-of-work.d.ts
 
 /**
  * Builder for updateMany operations that supports both whereIndex and set chaining
@@ -149,12 +150,16 @@ type MutationOperation<TSchema extends AnySchema, TTable extends AnyTable = TSch
  */
 interface CompiledMutation<TOutput> {
   query: TOutput;
+  /**
+   * The type of mutation operation (create, update, delete, or check).
+   */
+  op: "create" | "update" | "delete" | "check";
   /**
    * Number of rows this operation must affect for the transaction to succeed.
    * If actual affected rows doesn't match, it indicates a version conflict.
    * null means don't check affected rows (e.g., for create operations).
    */
-  expectedAffectedRows: number | null;
+  expectedAffectedRows: bigint | null;
   /**
    * Number of rows this SELECT query must return for the transaction to succeed.
    * Used for check operations to verify version without modifying data.
@@ -210,7 +215,7 @@ interface UOWDecoder<TRawInput = unknown> {
    * @param operations - Array of retrieval operations that produced these results
    * @returns Decoded results in application format
    */
-  (rawResults: TRawInput[], operations: RetrievalOperation<AnySchema>[]): unknown[];
+  decode(rawResults: TRawInput[], operations: RetrievalOperation<AnySchema>[]): unknown[];
 }
 /**
  * Builder for find operations in Unit of Work
@@ -250,6 +255,7 @@ declare class FindBuilder<TTable extends AnyTable, TSelect extends SelectClause<
   before(cursor: Cursor | string): this;
   /**
    * Set the number of results per page
+   * @throws {RangeError} If size is not a positive integer
    */
   pageSize(size: number): this;
   /**
@@ -334,6 +340,7 @@ declare class JoinFindBuilder<TTable extends AnyTable, TSelect extends SelectCla
   orderByIndex<TIndexName extends ValidIndexName<TTable>>(indexName: TIndexName, direction: "asc" | "desc"): this;
   /**
    * Set the number of results to return
+   * @throws {RangeError} If size is not a positive integer
    */
   pageSize(size: number): this;
   /**
@@ -387,9 +394,16 @@ interface IUnitOfWork {
   getRetrievalOperations(): ReadonlyArray<RetrievalOperation<AnySchema>>;
   getMutationOperations(): ReadonlyArray<MutationOperation<AnySchema>>;
   getCreatedIds(): FragnoId[];
-  restrict(): IUnitOfWork;
+  restrict(options?: {
+    readyFor?: "mutation" | "retrieval" | "none";
+  }): IUnitOfWork;
+  signalReadyForRetrieval(): void;
+  signalReadyForMutation(): void;
   reset(): void;
-  forSchema<TOtherSchema extends AnySchema>(schema: TOtherSchema): TypedUnitOfWork<TOtherSchema, [], any>;
+  forSchema<TOtherSchema extends AnySchema, TOtherHooks extends HooksMap = {}>(schema: TOtherSchema, hooks?: TOtherHooks): TypedUnitOfWork<TOtherSchema, [], any, TOtherHooks>;
+  registerSchema(schema: AnySchema, namespace: string): void;
+  triggerHook(hookName: string, payload: unknown, options?: TriggerHookOptions): void;
+  getTriggeredHooks(): readonly TriggeredHook[];
 }
 /**
  * Restricted UOW interface without execute methods.
@@ -439,18 +453,33 @@ interface UnitOfWorkConfig {
 declare class UnitOfWork<const TRawInput = unknown> implements IUnitOfWork {
   #private;
   constructor(compiler: UOWCompiler<unknown>, executor: UOWExecutor<unknown, TRawInput>, decoder: UOWDecoder<TRawInput>, name?: string, config?: UnitOfWorkConfig, schemaNamespaceMap?: WeakMap<AnySchema, string>);
+  /**
+   * Register a schema with its namespace for cross-fragment operations.
+   * This is used for internal fragments like hooks that need to create
+   * records in a different schema during the same transaction.
+   */
+  registerSchema(schema: AnySchema, namespace: string): void;
   /**
    * Get a schema-specific typed view of this UOW for type-safe operations.
    * Returns a wrapper that provides typed operations for the given schema.
    * The namespace is automatically resolved from the schema-namespace map.
+   * The optional hooks parameter is for type inference only - pass your hooks map
+   * to get proper typing for triggerHook. The value is not used at runtime.
    */
-  forSchema<TOtherSchema extends AnySchema, TRawInput>(schema: TOtherSchema): TypedUnitOfWork<TOtherSchema, [], TRawInput>;
+  forSchema<TOtherSchema extends AnySchema, TOtherHooks extends HooksMap = {}>(schema: TOtherSchema, _hooks?: TOtherHooks): TypedUnitOfWork<TOtherSchema, [], TRawInput, TOtherHooks>;
   /**
    * Create a restricted child UOW that cannot execute phases.
    * The child shares the same operation storage but must signal readiness
    * before the parent can execute each phase.
+   *
+   * @param options.readyFor - Controls automatic readiness signaling:
+   *   - "mutation" (default): Signals ready for both retrieval and mutation immediately
+   *   - "retrieval": Signals ready for retrieval only
+   *   - "none": No automatic signaling, caller must signal manually
    */
-  restrict(): UnitOfWork<TRawInput>;
+  restrict(options?: {
+    readyFor?: "mutation" | "retrieval" | "none";
+  }): UnitOfWork<TRawInput>;
   /**
    * Signal that this child is ready for retrieval phase execution.
    * Only valid for restricted (child) UOWs.
@@ -466,6 +495,14 @@ declare class UnitOfWork<const TRawInput = unknown> implements IUnitOfWork {
    * Clears operations, resets state, and resets phase promises.
    */
   reset(): void;
+  /**
+   * Trigger a hook to be executed after the transaction commits.
+   */
+  triggerHook(hookName: string, payload: unknown, options?: TriggerHookOptions): void;
+  /**
+   * Get all triggered hooks for this UOW.
+   */
+  getTriggeredHooks(): ReadonlyArray<TriggeredHook>;
   get state(): UOWState;
   get name(): string | undefined;
   get nonce(): string;
@@ -533,7 +570,7 @@ declare class UnitOfWork<const TRawInput = unknown> implements IUnitOfWork {
  * All operations are stored in the underlying UOW, but this facade ensures type safety and
  * filters retrieval results to only include operations added through this facade.
  */
-declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalResults extends unknown[] = [], const TRawInput = unknown> implements IUnitOfWork {
+declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalResults extends unknown[] = [], const TRawInput = unknown, const THooks extends HooksMap = {}> implements IUnitOfWork {
   #private;
   constructor(schema: TSchema, namespace: string | undefined, uow: UnitOfWork<TRawInput>);
   get $results(): Prettify<TRetrievalResults>;
@@ -550,19 +587,24 @@ declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalR
   executeMutations(): Promise<{
     success: boolean;
   }>;
-  restrict(): IUnitOfWork;
+  restrict(options?: {
+    readyFor?: "mutation" | "retrieval" | "none";
+  }): IUnitOfWork;
+  signalReadyForRetrieval(): void;
+  signalReadyForMutation(): void;
   reset(): void;
-  forSchema<TOtherSchema extends AnySchema>(schema: TOtherSchema): TypedUnitOfWork<TOtherSchema, [], TRawInput>;
+  forSchema<TOtherSchema extends AnySchema, TOtherHooks extends HooksMap = {}>(schema: TOtherSchema, hooks?: TOtherHooks): TypedUnitOfWork<TOtherSchema, [], TRawInput, TOtherHooks>;
+  registerSchema(schema: AnySchema, namespace: string): void;
   compile<TOutput>(compiler: UOWCompiler<TOutput>): {
     name?: string;
     retrievalBatch: TOutput[];
     mutationBatch: CompiledMutation<TOutput>[];
   };
-  find<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>>[]], TRawInput>;
-  find<TTableName extends keyof TSchema["tables"] & string>(tableName: TTableName): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], {}, true>[]], TRawInput>;
-  findFirst<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>> | null], TRawInput>;
-  findFirst<TTableName extends keyof TSchema["tables"] & string>(tableName: TTableName): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], {}, true> | null], TRawInput>;
-  findWithCursor<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, CursorResult<SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>>>], TRawInput>;
+  find<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>>[]], TRawInput, THooks>;
+  find<TTableName extends keyof TSchema["tables"] & string>(tableName: TTableName): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], {}, true>[]], TRawInput, THooks>;
+  findFirst<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>> | null], TRawInput, THooks>;
+  findFirst<TTableName extends keyof TSchema["tables"] & string>(tableName: TTableName): TypedUnitOfWork<TSchema, [...TRetrievalResults, SelectResult<TSchema["tables"][TTableName], {}, true> | null], TRawInput, THooks>;
+  findWithCursor<TTableName extends keyof TSchema["tables"] & string, const TBuilderResult>(tableName: TTableName, builderFn: (builder: Omit<FindBuilder<TSchema["tables"][TTableName]>, "build">) => TBuilderResult): TypedUnitOfWork<TSchema, [...TRetrievalResults, CursorResult<SelectResult<TSchema["tables"][TTableName], ExtractJoinOut<TBuilderResult>, Extract<ExtractSelect<TBuilderResult>, SelectClause<TSchema["tables"][TTableName]>>>>], TRawInput, THooks>;
   create<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, values: TableToInsertValues<TSchema["tables"][TableName]>): FragnoId;
   update<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, id: FragnoId | string, builderFn: (builder: Omit<UpdateBuilder<TSchema["tables"][TableName]>, "build">) => Omit<UpdateBuilder<TSchema["tables"][TableName]>, "build"> | void): void;
   delete<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, id: FragnoId | string, builderFn?: (builder: Omit<DeleteBuilder, "build">) => Omit<DeleteBuilder, "build"> | void): void;
@@ -583,6 +625,12 @@ declare class TypedUnitOfWork<const TSchema extends AnySchema, const TRetrievalR
    * ```
    */
   check<TableName extends keyof TSchema["tables"] & string>(tableName: TableName, id: FragnoId): void;
+  get $hooks(): THooks;
+  /**
+   * Trigger a hook to be executed after the transaction commits.
+   */
+  triggerHook<K$1 extends keyof THooks & string>(hookName: K$1, payload: HookPayload<THooks[K$1]>, options?: TriggerHookOptions): void;
+  getTriggeredHooks(): ReadonlyArray<TriggeredHook>;
 }
 //#endregion
 export { CompiledMutation, DeleteBuilder, FindBuilder, IUnitOfWork, IUnitOfWorkRestricted, IndexColumns, IndexedConditionBuilder, IndexedJoinBuilder, InferIdColumnName, JoinFindBuilder, MutationOperation, MutationResult, RetrievalOperation, TypedUnitOfWork, UOWCompiler, UOWDecoder, UOWExecutor, UOWState, UnitOfWork, UnitOfWorkConfig, UpdateBuilder, UpdateManyBuilder, ValidIndexName, buildJoinIndexed, createUnitOfWork };

package/dist/query/unit-of-work/unit-of-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-of-work.d.ts","names":[],"sources":["../../../src/query/unit-of-work/unit-of-work.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/query/{unit-of-work.js → unit-of-work/unit-of-work.js}

@@ -1,8 +1,8 @@
-import { FragnoId } from "../schema/create.js";
-import { buildCondition } from "./condition-builder.js";
-import { Cursor } from "./cursor.js";
+import { FragnoId } from "../../schema/create.js";
+import { buildCondition } from "../condition-builder.js";
+import { Cursor } from "../cursor.js";
 
-//#region src/query/unit-of-work.ts
+//#region src/query/unit-of-work/unit-of-work.ts
 /**
 * Builder for find operations in Unit of Work
 */
@@ -83,8 +83,10 @@ var FindBuilder = class {
 	}
 	/**
 	* Set the number of results per page
+	* @throws {RangeError} If size is not a positive integer
 	*/
 	pageSize(size) {
+		if (!Number.isInteger(size) || size <= 0) throw new RangeError(`pageSize must be a positive integer, received: ${size}`);
 		this.#pageSizeValue = size;
 		return this;
 	}
@@ -260,8 +262,10 @@ var JoinFindBuilder = class {
 	}
 	/**
 	* Set the number of results to return
+	* @throws {RangeError} If size is not a positive integer
 	*/
 	pageSize(size) {
+		if (!Number.isInteger(size) || size <= 0) throw new RangeError(`pageSize must be a positive integer, received: ${size}`);
 		this.#pageSizeValue = size;
 		return this;
 	}
@@ -546,36 +550,51 @@ var UnitOfWork = class UnitOfWork {
 	#retrievalError = null;
 	#mutationError = null;
 	#coordinator = new UOWChildCoordinator();
+	#triggeredHooks = [];
 	constructor(compiler, executor, decoder, name, config, schemaNamespaceMap) {
 		this.#compiler = compiler;
 		this.#executor = executor;
 		this.#decoder = decoder;
-		this.#schemaNamespaceMap = schemaNamespaceMap;
+		this.#schemaNamespaceMap = schemaNamespaceMap ?? /* @__PURE__ */ new WeakMap();
 		this.#name = name;
 		this.#config = config;
 		this.#nonce = config?.nonce ?? crypto.randomUUID();
 	}
 	/**
+	* Register a schema with its namespace for cross-fragment operations.
+	* This is used for internal fragments like hooks that need to create
+	* records in a different schema during the same transaction.
+	*/
+	registerSchema(schema, namespace) {
+		this.#schemaNamespaceMap.set(schema, namespace);
+	}
+	/**
 	* Get a schema-specific typed view of this UOW for type-safe operations.
 	* Returns a wrapper that provides typed operations for the given schema.
 	* The namespace is automatically resolved from the schema-namespace map.
+	* The optional hooks parameter is for type inference only - pass your hooks map
+	* to get proper typing for triggerHook. The value is not used at runtime.
 	*/
-	forSchema(schema) {
-		const resolvedNamespace = this.#schemaNamespaceMap?.get(schema);
-		return new TypedUnitOfWork(schema, resolvedNamespace, this);
+	forSchema(schema, _hooks) {
+		return new TypedUnitOfWork(schema, this.#schemaNamespaceMap.get(schema), this);
 	}
 	/**
 	* Create a restricted child UOW that cannot execute phases.
 	* The child shares the same operation storage but must signal readiness
 	* before the parent can execute each phase.
+	*
+	* @param options.readyFor - Controls automatic readiness signaling:
+	*   - "mutation" (default): Signals ready for both retrieval and mutation immediately
+	*   - "retrieval": Signals ready for retrieval only
+	*   - "none": No automatic signaling, caller must signal manually
 	*/
-	restrict() {
+	restrict(options) {
+		const readyFor = options?.readyFor ?? "mutation";
 		const child = new UnitOfWork(this.#compiler, this.#executor, this.#decoder, this.#name, {
 			...this.#config,
 			nonce: this.#nonce
 		}, this.#schemaNamespaceMap);
 		child.#coordinator.setAsRestricted(this, this.#coordinator);
-		child.#state = this.#state;
 		child.#retrievalOps = this.#retrievalOps;
 		child.#mutationOps = this.#mutationOps;
 		child.#retrievalResults = this.#retrievalResults;
@@ -584,9 +603,10 @@ var UnitOfWork = class UnitOfWork {
 		child.#mutationPhaseDeferred = this.#mutationPhaseDeferred;
 		child.#retrievalError = this.#retrievalError;
 		child.#mutationError = this.#mutationError;
+		child.#triggeredHooks = this.#triggeredHooks;
 		this.#coordinator.addChild(child);
-		child.signalReadyForRetrieval();
-		child.signalReadyForMutation();
+		if (readyFor === "mutation" || readyFor === "retrieval") child.signalReadyForRetrieval();
+		if (readyFor === "mutation") child.signalReadyForMutation();
 		return child;
 	}
 	/**
@@ -619,9 +639,26 @@ var UnitOfWork = class UnitOfWork {
 		this.#retrievalPhaseDeferred.reset();
 		this.#mutationPhaseDeferred.reset();
 		this.#coordinator.reset();
+		this.#triggeredHooks = [];
+	}
+	/**
+	* Trigger a hook to be executed after the transaction commits.
+	*/
+	triggerHook(hookName, payload, options) {
+		this.#triggeredHooks.push({
+			hookName,
+			payload,
+			options
+		});
+	}
+	/**
+	* Get all triggered hooks for this UOW.
+	*/
+	getTriggeredHooks() {
+		return this.#triggeredHooks;
 	}
 	get state() {
-		return this.#state;
+		return this.#coordinator.parent?.state ?? this.#state;
 	}
 	get name() {
 		return this.#name;
@@ -673,7 +710,7 @@ var UnitOfWork = class UnitOfWork {
 				return emptyResults;
 			}
 			const rawResults = await this.#executor.executeRetrievalPhase(retrievalBatch);
-			this.#retrievalResults = this.#decoder(rawResults, this.#retrievalOps);
+			this.#retrievalResults = this.#decoder.decode(rawResults, this.#retrievalOps);
 			this.#state = "building-mutation";
 			this.#retrievalPhaseDeferred.resolve(this.#retrievalResults);
 			return this.#retrievalResults;
@@ -706,7 +743,10 @@ var UnitOfWork = class UnitOfWork {
 			}
 			const result = await this.#executor.executeMutationPhase(mutationBatch);
 			this.#state = "executed";
-			if (result.success) this.#createdInternalIds = result.createdInternalIds;
+			if (result.success) {
+				this.#createdInternalIds.length = 0;
+				this.#createdInternalIds.push(...result.createdInternalIds);
+			}
 			this.#mutationPhaseDeferred.resolve();
 			return { success: result.success };
 		} catch (error) {
@@ -731,7 +771,7 @@ var UnitOfWork = class UnitOfWork {
 	* Add a retrieval operation (used by TypedUnitOfWork)
 	*/
 	addRetrievalOperation(op) {
-		if (this.#state !== "building-retrieval") throw new Error(`Cannot add retrieval operation in state ${this.#state}. Must be in building-retrieval state.`);
+		if (this.state !== "building-retrieval") throw new Error(`Cannot add retrieval operation in state ${this.state}. Must be in building-retrieval state.`);
 		this.#retrievalOps.push(op);
 		return this.#retrievalOps.length - 1;
 	}
@@ -740,7 +780,7 @@ var UnitOfWork = class UnitOfWork {
 	* Add a mutation operation (used by TypedUnitOfWork)
 	*/
 	addMutationOperation(op) {
-		if (this.#state === "executed") throw new Error(`Cannot add mutation operation in executed state.`);
+		if (this.state === "executed") throw new Error(`Cannot add mutation operation in executed state.`);
 		this.#mutationOps.push(op);
 	}
 	/**
@@ -752,7 +792,7 @@ var UnitOfWork = class UnitOfWork {
 	* @returns Array of FragnoIds in the same order as create() calls
 	*/
 	getCreatedIds() {
-		if (this.#state !== "executed") throw new Error(`getCreatedIds() can only be called after executeMutations(). Current state: ${this.#state}`);
+		if (this.state !== "executed") throw new Error(`getCreatedIds() can only be called after executeMutations(). Current state: ${this.state}`);
 		const createdIds = [];
 		let createIndex = 0;
 		for (const op of this.#mutationOps) if (op.type === "create") {
@@ -849,14 +889,23 @@ var TypedUnitOfWork = class {
 	async executeMutations() {
 		return this.#uow.executeMutations();
 	}
-	restrict() {
-		return this.#uow.restrict();
+	restrict(options) {
+		return this.#uow.restrict(options);
+	}
+	signalReadyForRetrieval() {
+		this.#uow.signalReadyForRetrieval();
+	}
+	signalReadyForMutation() {
+		this.#uow.signalReadyForMutation();
 	}
 	reset() {
 		return this.#uow.reset();
 	}
-	forSchema(schema) {
-		return this.#uow.forSchema(schema);
+	forSchema(schema, hooks) {
+		return this.#uow.forSchema(schema, hooks);
+	}
+	registerSchema(schema, namespace) {
+		this.#uow.registerSchema(schema, namespace);
 	}
 	compile(compiler) {
 		return this.#uow.compile(compiler);
@@ -997,6 +1046,18 @@ var TypedUnitOfWork = class {
 			id
 		});
 	}
+	get $hooks() {
+		throw new Error("type only");
+	}
+	/**
+	* Trigger a hook to be executed after the transaction commits.
+	*/
+	triggerHook(hookName, payload, options) {
+		this.#uow.triggerHook(hookName, payload, options);
+	}
+	getTriggeredHooks() {
+		return this.#uow.getTriggeredHooks();
+	}
 };
 
 //#endregion