@elsikora/nestjs-crud-automator 4.4.0-dev.2 → 4.5.0-dev.1

package/README.md

@@ -652,6 +652,32 @@ await ApiFunctionTransactionScope.runWithDataSource(dataSource, { name: "registe
 
 The callback receives the exact manager owned by the named scope. Decorated operations join it automatically; use the argument for transaction-bound raw repository or migration work. The scope name is trimmed and must be non-empty. `runWithEntityManager()` is join-only: it accepts only the manager already bound to an active Automator transaction and never opens a second transaction.
 
+Named scopes can also select bounded execution measurements without adding ordinary function subscribers:
+
+```typescript
+await ApiFunctionTransactionScope.runWithDataSource(
+	dataSource,
+	{
+		name: "register-user",
+		observation: {
+			selectors: [{ entity: UserEntity, functionType: EApiFunctionType.CREATE, methodName: "create" }],
+			onSettled(snapshot) {
+				captureTransactionObservation(snapshot);
+			},
+		},
+	},
+	async () => await userService.create(properties),
+);
+```
+
+`captureTransactionObservation` is an application-provided bounded synchronous capture function, not a package API. Selectors match the exact entity constructor, native function type (or `EApiFunctionTransactionTraceType.STEP`) and method name. The package copies the selectors and callback before query-runner work, rejects duplicate selectors and invalid configuration, and allows at most 32 selectors with nonblank method names of at most 256 characters. An empty selector list produces only the owner settlement. `runWithEntityManager()` continues to join the existing owner and cannot replace observation.
+
+Each owner reserves at most 256 selected invocations at their start, including overlapping work. The detached, frozen snapshot contains `measurements` with only `selectorIndex`, fractional `durationMs` and native execution `status`, plus the existing transaction `outcome` and `droppedCount`. The index refers to the configured selector order. Omitted intervals include capacity overflow, incomplete work at settlement and unavailable/invalid clock samples. Late completions are ignored. No transaction IDs, arguments, results, entities, managers or raw errors enter this projection; ordinary transaction event shapes and pending-event rules stay unchanged.
+
+Duration covers the actual native execution callback, including STEP context construction or CUSTOM subscriber work, and excludes its own transaction preflight and event bookkeeping. Nested intervals are inclusive: do not sum them or label them as isolated method-body, SQL or lock-wait time. A successful execution remains `SUCCEEDED` if its owner later rolls back or has an unknown commit outcome. Disabled and unmatched observation performs no clock sampling; rejected preflight or failed owner startup creates no fabricated duration.
+
+`onSettled` runs once after the best-effort release attempt, context exit and terminal lifecycle hooks have finished or failed. It does not run when owner startup fails. Its synchronous throws and accidental Promise/thenable rejections are contained; returned asynchronous work is never awaited and cannot replace the original result or error. Synchronous callback work still adds latency, so capture into a bounded application buffer and let its existing transport own delivery. STEP remains trace-only and does not become an ordinary subscriber event. The public observation types and `API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT` are available from the package root.
+
 Function subscribers can react once after the outer commit or rollback. The observed service must use `@ApiServiceObservable()`, and the subscriber must be registered as a Nest provider:
 
 ```typescript

package/dist/cjs/class/api/function/transaction/registry.class.d.ts

@@ -1,11 +1,16 @@
-import { IApiFunctionTransaction } from '../../../../interface/class/api/function';
+import { EApiFunctionTransactionOutcome, EApiFunctionTransactionEventStatus } from '../../../../enum/decorator/api';
+import { IApiFunctionTransaction, IApiFunctionTransactionObservationOptions, IApiFunctionTransactionObservationSelector } from '../../../../interface/class/api/function';
 import { IApiSubscriberFunctionTransactionContext } from '../../../../interface/class/api/subscriber/function';
 import { TApiFunctionTransactionEvent, TApiFunctionTransactionOwner, TApiFunctionTransactionTraceType } from '../../../../type/class/api/function/transaction';
 export declare class ApiFunctionTransactionRegistry {
     private readonly EVENTS;
     private eventSnapshot?;
+    private isObservationClosed;
+    private readonly MEASUREMENTS;
+    private readonly OBSERVATION?;
+    private observationDroppedCount;
     private readonly TRANSACTION;
-    constructor(id: string, owner: TApiFunctionTransactionOwner);
+    constructor(id: string, owner: TApiFunctionTransactionOwner, observation?: Readonly<IApiFunctionTransactionObservationOptions>);
     beginEvent(options: {
         action?: string;
         entityName: string;
@@ -13,11 +18,28 @@ export declare class ApiFunctionTransactionRegistry {
         isSubscriberObservable: boolean;
         methodName: string;
     }): number;
+    /**
+     * Reserves one selected native callback interval without changing lifecycle events.
+     * @param {Readonly<IApiFunctionTransactionObservationSelector>} selector Reached native invocation.
+     * @returns {number | undefined} Reserved measurement index, or no admitted measurement.
+     */
+    beginObservation(selector: Readonly<IApiFunctionTransactionObservationSelector>): number | undefined;
+    /**
+     * Samples completion before native event bookkeeping; late completion is ignored.
+     * @param {number | undefined} index Reserved measurement index.
+     * @param {EApiFunctionTransactionEventStatus} status Native callback status.
+     */
+    completeObservation(index: number | undefined, status: EApiFunctionTransactionEventStatus): void;
     createContext(matchedEvents: ReadonlyArray<TApiFunctionTransactionEvent>): IApiSubscriberFunctionTransactionContext;
     failEvent(sequence: number, error: unknown): void;
     getEvents(): ReadonlyArray<TApiFunctionTransactionEvent>;
     getObservableEvents(): ReadonlyArray<TApiFunctionTransactionEvent>;
     getTransaction(): Readonly<IApiFunctionTransaction>;
+    /**
+     * Publishes the bounded projection once after the owning transaction lifecycle settles.
+     * @param {EApiFunctionTransactionOutcome} outcome Settled database outcome.
+     */
+    settleObservation(outcome: EApiFunctionTransactionOutcome): void;
     succeedEvent(sequence: number): void;
     private getPendingEvent;
 }

package/dist/cjs/class/api/function/transaction/registry.class.js

@@ -1,5 +1,6 @@
 'use strict';
 
+var apiFunctionTransactionObservation_constant = require('../../../../constant/api-function-transaction-observation.constant.js');
 require('../../../../enum/decorator/api/action.enum.js');
 require('../../../../enum/decorator/api/authentication-type.enum.js');
 require('../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js');
@@ -18,7 +19,7 @@ require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
 require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
 require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
 var traceType_enum = require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
-require('../../../../enum/decorator/api/function/type.enum.js');
+var type_enum = require('../../../../enum/decorator/api/function/type.enum.js');
 require('../../../../enum/decorator/api/function/update-persistence-mode.enum.js');
 require('../../../../enum/decorator/api/on-type.enum.js');
 require('../../../../enum/decorator/api/property/data-type.enum.js');
@@ -34,8 +35,38 @@ var exception_utility = require('../../../../utility/error/exception.utility.js'
 class ApiFunctionTransactionRegistry {
     EVENTS = [];
     eventSnapshot;
+    isObservationClosed = false;
+    MEASUREMENTS = [];
+    OBSERVATION;
+    observationDroppedCount = 0;
     TRANSACTION;
-    constructor(id, owner) {
+    constructor(id, owner, observation) {
+        if (observation !== undefined) {
+            const onSettled = observation?.onSettled;
+            const selectors = observation?.selectors;
+            if (typeof onSettled !== "function" || !Array.isArray(selectors) || selectors.length > apiFunctionTransactionObservation_constant.API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT.MAXIMUM_SELECTORS) {
+                throw exception_utility.ErrorException("Invalid transaction observation options");
+            }
+            const copiedSelectors = [];
+            for (const selector of selectors) {
+                if (typeof selector !== "object" || selector === null || !("entity" in selector) || !("functionType" in selector) || !("methodName" in selector)) {
+                    throw exception_utility.ErrorException("Invalid transaction observation selector");
+                }
+                const entity = selector.entity;
+                const functionType = selector.functionType;
+                const methodName = selector.methodName;
+                if (typeof entity !== "function" ||
+                    ![...Object.values(type_enum.EApiFunctionType), traceType_enum.EApiFunctionTransactionTraceType.STEP].includes(functionType) ||
+                    typeof methodName !== "string" ||
+                    methodName.trim().length === 0 ||
+                    methodName.length > apiFunctionTransactionObservation_constant.API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT.MAXIMUM_METHOD_NAME_LENGTH ||
+                    copiedSelectors.some((candidate) => candidate.entity === entity && candidate.functionType === functionType && candidate.methodName === methodName)) {
+                    throw exception_utility.ErrorException("Invalid transaction observation selector");
+                }
+                copiedSelectors.push(Object.freeze({ entity: entity, functionType: functionType, methodName }));
+            }
+            this.OBSERVATION = Object.freeze({ onSettled, selectors: Object.freeze(copiedSelectors) });
+        }
         this.TRANSACTION = Object.freeze({
             id,
             owner: Object.freeze({ ...owner }),
@@ -52,6 +83,58 @@ class ApiFunctionTransactionRegistry {
         });
         return sequence;
     }
+    /**
+     * Reserves one selected native callback interval without changing lifecycle events.
+     * @param {Readonly<IApiFunctionTransactionObservationSelector>} selector Reached native invocation.
+     * @returns {number | undefined} Reserved measurement index, or no admitted measurement.
+     */
+    beginObservation(selector) {
+        if (!this.OBSERVATION || this.isObservationClosed)
+            return undefined;
+        const selectorIndex = this.OBSERVATION.selectors.findIndex((candidate) => candidate.entity === selector.entity && candidate.functionType === selector.functionType && candidate.methodName === selector.methodName);
+        if (selectorIndex === -1)
+            return undefined;
+        if (this.MEASUREMENTS.length >= apiFunctionTransactionObservation_constant.API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT.MAXIMUM_MEASUREMENTS) {
+            this.observationDroppedCount = Math.min(Number.MAX_SAFE_INTEGER, this.observationDroppedCount + 1);
+            return undefined;
+        }
+        const index = this.MEASUREMENTS.length;
+        const measurement = { selectorIndex };
+        this.MEASUREMENTS.push(measurement);
+        try {
+            const startedAtMs = performance.now();
+            if (Number.isFinite(startedAtMs))
+                measurement.startedAtMs = startedAtMs;
+        }
+        catch {
+            // A missing clock sample drops only this diagnostic interval.
+        }
+        return index;
+    }
+    /**
+     * Samples completion before native event bookkeeping; late completion is ignored.
+     * @param {number | undefined} index Reserved measurement index.
+     * @param {EApiFunctionTransactionEventStatus} status Native callback status.
+     */
+    completeObservation(index, status) {
+        if (index === undefined || this.isObservationClosed)
+            return;
+        const measurement = this.MEASUREMENTS[index];
+        if (!measurement || measurement.status !== undefined)
+            return;
+        measurement.status = status;
+        try {
+            const completedAtMs = performance.now();
+            if (measurement.startedAtMs !== undefined && Number.isFinite(completedAtMs)) {
+                const durationMs = completedAtMs - measurement.startedAtMs;
+                if (Number.isFinite(durationMs) && durationMs >= 0)
+                    measurement.durationMs = durationMs;
+            }
+        }
+        catch {
+            // Capture failures cannot alter a native result or error.
+        }
+    }
     createContext(matchedEvents) {
         const events = this.getEvents();
         return Object.freeze({
@@ -101,6 +184,35 @@ class ApiFunctionTransactionRegistry {
     getTransaction() {
         return this.TRANSACTION;
     }
+    /**
+     * Publishes the bounded projection once after the owning transaction lifecycle settles.
+     * @param {EApiFunctionTransactionOutcome} outcome Settled database outcome.
+     */
+    settleObservation(outcome) {
+        if (!this.OBSERVATION || this.isObservationClosed)
+            return;
+        this.isObservationClosed = true;
+        try {
+            const measurements = [];
+            for (const measurement of this.MEASUREMENTS) {
+                if (measurement.durationMs === undefined || measurement.status === undefined) {
+                    this.observationDroppedCount = Math.min(Number.MAX_SAFE_INTEGER, this.observationDroppedCount + 1);
+                    continue;
+                }
+                measurements.push(Object.freeze({ durationMs: measurement.durationMs, selectorIndex: measurement.selectorIndex, status: measurement.status }));
+            }
+            this.MEASUREMENTS.length = 0;
+            const onSettled = this.OBSERVATION.onSettled;
+            const delivery = onSettled(Object.freeze({ droppedCount: this.observationDroppedCount, measurements: Object.freeze(measurements), outcome }));
+            if (delivery !== undefined)
+                void Promise.resolve(delivery).catch(() => {
+                    // An accidental asynchronous observer rejection remains diagnostic-only.
+                });
+        }
+        catch {
+            // Diagnostic callbacks never participate in transaction error handling.
+        }
+    }
     succeedEvent(sequence) {
         const event = this.getPendingEvent(sequence);
         event.status = eventStatus_enum.EApiFunctionTransactionEventStatus.SUCCEEDED;

package/dist/cjs/class/api/function/transaction/registry.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.class.js","sources":["../../../../../../../src/class/api/function/transaction/registry.class.ts"],"sourcesContent":[null],"names":["ErrorException","EApiFunctionTransactionEventStatus","EApiFunctionTransactionTraceType"],"mappings":"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"}
+{"version":3,"file":"registry.class.js","sources":["../../../../../../../src/class/api/function/transaction/registry.class.ts"],"sourcesContent":[null],"names":["API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT","ErrorException","EApiFunctionType","EApiFunctionTransactionTraceType","EApiFunctionTransactionEventStatus"],"mappings":"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"}

package/dist/cjs/class/api/function/transaction/runtime.class.d.ts

@@ -1,9 +1,11 @@
+import { IApiFunctionTransactionObservationOptions } from '../../../../interface/class/api/function';
 import { TApiFunctionTransactionOwner } from '../../../../type/class/api/function';
 import { DataSource, EntityManager } from 'typeorm';
 export declare class ApiFunctionTransactionRuntime {
     static execute<R>(options: {
         callback: (entityManager: EntityManager) => Promise<R>;
         dataSource: DataSource;
+        observation?: Readonly<IApiFunctionTransactionObservationOptions>;
         owner: TApiFunctionTransactionOwner;
     }): Promise<R>;
     private static releaseBestEffort;

package/dist/cjs/class/api/function/transaction/runtime.class.js

@@ -19,7 +19,7 @@ require('../../../../enum/decorator/api/function/subscriber-transaction-expectat
 require('../../../../enum/decorator/api/function/transaction/event-status.enum.js');
 var failureStage_enum = require('../../../../enum/decorator/api/function/transaction/failure-stage.enum.js');
 require('../../../../enum/decorator/api/function/transaction/mode.enum.js');
-require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
+var outcome_enum = require('../../../../enum/decorator/api/function/transaction/outcome.enum.js');
 require('../../../../enum/decorator/api/function/transaction/owner-kind.enum.js');
 require('../../../../enum/decorator/api/function/transaction/trace-type.enum.js');
 require('../../../../enum/decorator/api/function/type.enum.js');
@@ -43,6 +43,7 @@ class ApiFunctionTransactionRuntime {
         if (contextStorage_class.ApiFunctionContextStorage.getTransactionRegistry()) {
             throw exception_utility.ErrorException("Cannot open an owning transaction inside an active Automator transaction");
         }
+        const registry = new registry_class.ApiFunctionTransactionRegistry(node_crypto.randomUUID(), options.owner, options.observation);
         const queryRunner = options.dataSource.createQueryRunner();
         try {
             await queryRunner.connect();
@@ -52,7 +53,6 @@ class ApiFunctionTransactionRuntime {
             await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
             throw error;
         }
-        const registry = new registry_class.ApiFunctionTransactionRegistry(node_crypto.randomUUID(), options.owner);
         const result = {};
         let commitCleanupFailure;
         let commitError;
@@ -81,17 +81,27 @@ class ApiFunctionTransactionRuntime {
             }
             await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
         });
-        if (hasOperationError) {
-            return await lifecycle_class.ApiFunctionTransactionLifecycle.executeAfterRollback(registry, operationError, rollbackFailure);
-        }
-        if (hasCommitError) {
-            return await lifecycle_class.ApiFunctionTransactionLifecycle.executeCommitUnknown(registry, commitError, commitCleanupFailure);
+        let outcome = outcome_enum.EApiFunctionTransactionOutcome.COMMITTED;
+        if (hasCommitError || rollbackFailure)
+            outcome = outcome_enum.EApiFunctionTransactionOutcome.UNKNOWN;
+        else if (hasOperationError)
+            outcome = outcome_enum.EApiFunctionTransactionOutcome.ROLLED_BACK;
+        try {
+            if (hasOperationError) {
+                return await lifecycle_class.ApiFunctionTransactionLifecycle.executeAfterRollback(registry, operationError, rollbackFailure);
+            }
+            if (hasCommitError) {
+                return await lifecycle_class.ApiFunctionTransactionLifecycle.executeCommitUnknown(registry, commitError, commitCleanupFailure);
+            }
+            if (!("value" in result)) {
+                throw exception_utility.ErrorException("Automator transaction completed without a committed result");
+            }
+            await lifecycle_class.ApiFunctionTransactionLifecycle.executeAfterCommit(registry);
+            return result.value;
         }
-        if (!("value" in result)) {
-            throw exception_utility.ErrorException("Automator transaction completed without a committed result");
+        finally {
+            registry.settleObservation(outcome);
         }
-        await lifecycle_class.ApiFunctionTransactionLifecycle.executeAfterCommit(registry);
-        return result.value;
     }
     static async releaseBestEffort(queryRunner) {
         try {

package/dist/cjs/class/api/function/transaction/runtime.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.class.js","sources":["../../../../../../../src/class/api/function/transaction/runtime.class.ts"],"sourcesContent":[null],"names":["LoggerUtility","ApiFunctionContextStorage","ErrorException","ApiFunctionTransactionRegistry","randomUUID","ApiFunctionTransactionLifecycle","FormatErrorEvidenceForLog","EApiFunctionTransactionFailureStage"],"mappings":"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"}
+{"version":3,"file":"runtime.class.js","sources":["../../../../../../../src/class/api/function/transaction/runtime.class.ts"],"sourcesContent":[null],"names":["LoggerUtility","ApiFunctionContextStorage","ErrorException","ApiFunctionTransactionRegistry","randomUUID","EApiFunctionTransactionOutcome","ApiFunctionTransactionLifecycle","FormatErrorEvidenceForLog","EApiFunctionTransactionFailureStage"],"mappings":"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"}

package/dist/cjs/class/api/function/transaction/scope.class.d.ts

@@ -1,7 +1,9 @@
+import { IApiFunctionTransactionObservationOptions } from '../../../../interface/class/api/function';
 import { DataSource, EntityManager } from 'typeorm';
 export declare class ApiFunctionTransactionScope {
     static runWithDataSource<R>(dataSource: DataSource, properties: {
         name: string;
+        observation?: Readonly<IApiFunctionTransactionObservationOptions>;
     }, callback: (entityManager: EntityManager) => Promise<R>): Promise<R>;
     static runWithEntityManager<R>(entityManager: EntityManager, callback: () => Promise<R>): Promise<R>;
     private static createMissingServiceContextError;

package/dist/cjs/class/api/function/transaction/scope.class.js

@@ -42,6 +42,7 @@ class ApiFunctionTransactionScope {
         return await runtime_class.ApiFunctionTransactionRuntime.execute({
             callback: async (entityManager) => await ApiFunctionTransactionScope.runWithEntityManager(entityManager, async () => await callback(entityManager)),
             dataSource,
+            observation: properties.observation,
             owner: {
                 kind: ownerKind_enum.EApiFunctionTransactionOwnerKind.SCOPE,
                 name,

package/dist/cjs/class/api/function/transaction/scope.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.class.js","sources":["../../../../../../../src/class/api/function/transaction/scope.class.ts"],"sourcesContent":[null],"names":["ErrorException","ApiFunctionTransactionRuntime","EApiFunctionTransactionOwnerKind","ApiFunctionContextStorage"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUa,2BAA2B,CAAA;IAChC,aAAa,iBAAiB,CAAI,UAAsB,EAAE,UAA4B,EAAE,QAAsD,EAAA;QACpJ,MAAM,IAAI,GAAW,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;AAE3C,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,YAAA,MAAMA,gCAAc,CAAC,6DAA6D,CAAC;QACpF;AAEA,QAAA,OAAO,MAAMC,2CAA6B,CAAC,OAAO,CAAC;YAClD,QAAQ,EAAE,OAAO,aAA4B,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,aAAa,EAAE,YAAwB,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC1L,UAAU;AACV,YAAA,KAAK,EAAE;gBACN,IAAI,EAAEC,+CAAgC,CAAC,KAAK;gBAC5C,IAAI;AACJ,aAAA;AACD,SAAA,CAAC;IACH;AAEO,IAAA,aAAa,oBAAoB,CAAI,aAA4B,EAAE,QAA0B,EAAA;QACnG,MAAM,QAAQ,GAA+CC,8CAAyB,CAAC,sCAAsC,CAAC,aAAa,CAAC;QAE5I,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAKA,8CAAyB,CAAC,sBAAsB,EAAE,IAAIA,8CAAyB,CAAC,eAAe,EAAE,KAAK,aAAa,IAAIA,8CAAyB,CAAC,yBAAyB,EAAE,EAAE,OAAO,KAAK,aAAa,EAAE;AACtO,YAAA,MAAMH,gCAAc,CAAC,4GAA4G,CAAC;QACnI;QAEA,MAAM,MAAM,GAA6B,MAAM;AAE/C,QAAA,MAAM,OAAO,GAAwC;YACpD,MAAM;AACN,YAAA,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,YAAA,UAAU,EAAE;AACX,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,gBAAA,MAAM,EAAE,MAAqB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC3G,gBAAA,GAAG,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAClH,gBAAA,OAAO,EAAE,MAAsB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC7G,gBAAA,OAAO,EAAE,MAAsC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;gBAC7H,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,aAAA;AACD,YAAA,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC;SAC/C;QAED,OAAO,MAAMG,8CAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC9D;AAEQ,IAAA,OAAO,gCAAgC,GAAA;AAC9C,QAAA,OAAOH,gCAAc,CAAC,4EAA4E,CAAC;IACpG;AACA;;"}
+{"version":3,"file":"scope.class.js","sources":["../../../../../../../src/class/api/function/transaction/scope.class.ts"],"sourcesContent":[null],"names":["ErrorException","ApiFunctionTransactionRuntime","EApiFunctionTransactionOwnerKind","ApiFunctionContextStorage"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUa,2BAA2B,CAAA;IAChC,aAAa,iBAAiB,CAAI,UAAsB,EAAE,UAA+F,EAAE,QAAsD,EAAA;QACvN,MAAM,IAAI,GAAW,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;AAE3C,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,YAAA,MAAMA,gCAAc,CAAC,6DAA6D,CAAC;QACpF;AAEA,QAAA,OAAO,MAAMC,2CAA6B,CAAC,OAAO,CAAC;YAClD,QAAQ,EAAE,OAAO,aAA4B,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,aAAa,EAAE,YAAwB,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC1L,UAAU;YACV,WAAW,EAAE,UAAU,CAAC,WAAW;AACnC,YAAA,KAAK,EAAE;gBACN,IAAI,EAAEC,+CAAgC,CAAC,KAAK;gBAC5C,IAAI;AACJ,aAAA;AACD,SAAA,CAAC;IACH;AAEO,IAAA,aAAa,oBAAoB,CAAI,aAA4B,EAAE,QAA0B,EAAA;QACnG,MAAM,QAAQ,GAA+CC,8CAAyB,CAAC,sCAAsC,CAAC,aAAa,CAAC;QAE5I,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAKA,8CAAyB,CAAC,sBAAsB,EAAE,IAAIA,8CAAyB,CAAC,eAAe,EAAE,KAAK,aAAa,IAAIA,8CAAyB,CAAC,yBAAyB,EAAE,EAAE,OAAO,KAAK,aAAa,EAAE;AACtO,YAAA,MAAMH,gCAAc,CAAC,4GAA4G,CAAC;QACnI;QAEA,MAAM,MAAM,GAA6B,MAAM;AAE/C,QAAA,MAAM,OAAO,GAAwC;YACpD,MAAM;AACN,YAAA,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,YAAA,UAAU,EAAE;AACX,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,gBAAA,MAAM,EAAE,MAAqB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC3G,gBAAA,GAAG,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAClH,gBAAA,OAAO,EAAE,MAAsB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC7G,gBAAA,OAAO,EAAE,MAAsC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;gBAC7H,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,aAAA;AACD,YAAA,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC;SAC/C;QAED,OAAO,MAAMG,8CAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC9D;AAEQ,IAAA,OAAO,gCAAgC,GAAA;AAC9C,QAAA,OAAOH,gCAAc,CAAC,4EAA4E,CAAC;IACpG;AACA;;"}

package/dist/cjs/constant/api-function-transaction-observation.constant.d.ts

@@ -0,0 +1,5 @@
+export declare const API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT: {
+    readonly MAXIMUM_MEASUREMENTS: number;
+    readonly MAXIMUM_METHOD_NAME_LENGTH: number;
+    readonly MAXIMUM_SELECTORS: number;
+};

package/dist/cjs/constant/api-function-transaction-observation.constant.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const MAXIMUM_MEASUREMENTS = 256;
+const MAXIMUM_METHOD_NAME_LENGTH = 256;
+const MAXIMUM_SELECTORS = 32;
+const API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT = {
+    MAXIMUM_MEASUREMENTS,
+    MAXIMUM_METHOD_NAME_LENGTH,
+    MAXIMUM_SELECTORS,
+};
+
+exports.API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT = API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT;
+//# sourceMappingURL=api-function-transaction-observation.constant.js.map

package/dist/cjs/constant/api-function-transaction-observation.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-function-transaction-observation.constant.js","sources":["../../../../src/constant/api-function-transaction-observation.constant.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA,MAAM,oBAAoB,GAAW,GAAG;AACxC,MAAM,0BAA0B,GAAW,GAAG;AAC9C,MAAM,iBAAiB,GAAW,EAAE;AAE7B,MAAM,6CAA6C,GAItD;IACH,oBAAoB;IACpB,0BAA0B;IAC1B,iBAAiB;;;"}

package/dist/cjs/constant/index.d.ts

@@ -1,3 +1,4 @@
+export { API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT } from './api-function-transaction-observation.constant';
 export * from './class';
 export { DATE_CONSTANT } from './date.constant';
 export * from './decorator';

package/dist/cjs/index.js

@@ -48,6 +48,7 @@ var body_class = require('./class/utility/dto/strategy/body.class.js');
 var query_class = require('./class/utility/dto/strategy/query.class.js');
 var request_class = require('./class/utility/dto/strategy/request.class.js');
 var response_class = require('./class/utility/dto/strategy/response.class.js');
+var apiFunctionTransactionObservation_constant = require('./constant/api-function-transaction-observation.constant.js');
 var auditSinkToken_constant = require('./constant/class/authorization/audit-sink-token.constant.js');
 var hookPermissionSourcesToken_constant = require('./constant/class/authorization/hook-permission-sources-token.constant.js');
 var metadataDecision_constant = require('./constant/class/authorization/metadata-decision.constant.js');
@@ -352,6 +353,7 @@ exports.DtoStrategyBody = body_class.DtoStrategyBody;
 exports.DtoStrategyQuery = query_class.DtoStrategyQuery;
 exports.DtoStrategyRequest = request_class.DtoStrategyRequest;
 exports.DtoStrategyResponse = response_class.DtoStrategyResponse;
+exports.API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT = apiFunctionTransactionObservation_constant.API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT;
 exports.AUTHORIZATION_AUDIT_SINK_TOKEN = auditSinkToken_constant.AUTHORIZATION_AUDIT_SINK_TOKEN;
 exports.AUTHORIZATION_HOOK_PERMISSION_SOURCES_TOKEN = hookPermissionSourcesToken_constant.AUTHORIZATION_HOOK_PERMISSION_SOURCES_TOKEN;
 exports.AUTHORIZATION_DECISION_METADATA_CONSTANT = metadataDecision_constant.AUTHORIZATION_DECISION_METADATA_CONSTANT;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/interface/class/api/function/transaction/index.d.ts

@@ -1,4 +1,5 @@
 export type * from './event';
 export { type IApiFunctionTransactionFailure } from './failure.interface';
 export { type IApiFunctionTransaction } from './interface';
+export type * from './observation';
 export type * from './owner';

package/dist/cjs/interface/class/api/function/transaction/observation/index.d.ts

@@ -0,0 +1,4 @@
+export { type IApiFunctionTransactionObservationMeasurement } from './measurement.interface';
+export { type IApiFunctionTransactionObservationOptions } from './options.interface';
+export { type IApiFunctionTransactionObservationSelector } from './selector.interface';
+export { type IApiFunctionTransactionObservationSnapshot } from './snapshot.interface';

package/dist/cjs/interface/class/api/function/transaction/observation/measurement.interface.d.ts

@@ -0,0 +1,6 @@
+import { EApiFunctionTransactionEventStatus } from '../../../../../../enum/decorator/api';
+export interface IApiFunctionTransactionObservationMeasurement {
+    durationMs: number;
+    selectorIndex: number;
+    status: EApiFunctionTransactionEventStatus;
+}

package/dist/cjs/interface/class/api/function/transaction/observation/options.interface.d.ts

@@ -0,0 +1,6 @@
+import { IApiFunctionTransactionObservationSelector } from './selector.interface';
+import { IApiFunctionTransactionObservationSnapshot } from './snapshot.interface';
+export interface IApiFunctionTransactionObservationOptions {
+    onSettled: (snapshot: Readonly<IApiFunctionTransactionObservationSnapshot>) => void;
+    selectors: ReadonlyArray<Readonly<IApiFunctionTransactionObservationSelector>>;
+}

package/dist/cjs/interface/class/api/function/transaction/observation/selector.interface.d.ts

@@ -0,0 +1,7 @@
+import { IApiBaseEntity } from '../../../../../api-base-entity.interface';
+import { TApiFunctionTransactionTraceType } from '../../../../../../type/class/api/function/transaction';
+export interface IApiFunctionTransactionObservationSelector {
+    entity: new (...arguments_: Array<unknown>) => IApiBaseEntity;
+    functionType: TApiFunctionTransactionTraceType;
+    methodName: string;
+}

package/dist/cjs/interface/class/api/function/transaction/observation/snapshot.interface.d.ts

@@ -0,0 +1,7 @@
+import { EApiFunctionTransactionOutcome } from '../../../../../../enum/decorator/api';
+import { IApiFunctionTransactionObservationMeasurement } from './measurement.interface';
+export interface IApiFunctionTransactionObservationSnapshot {
+    droppedCount: number;
+    measurements: ReadonlyArray<Readonly<IApiFunctionTransactionObservationMeasurement>>;
+    outcome: EApiFunctionTransactionOutcome;
+}

package/dist/cjs/utility/api/function-transaction.utility.js

@@ -15,7 +15,7 @@ require('../../enum/decorator/api/controller/response-target.enum.js');
 require('../../enum/decorator/api/dto-type.enum.js');
 require('../../enum/decorator/api/function/context-storage-kind.enum.js');
 require('../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js');
-require('../../enum/decorator/api/function/transaction/event-status.enum.js');
+var eventStatus_enum = require('../../enum/decorator/api/function/transaction/event-status.enum.js');
 require('../../enum/decorator/api/function/transaction/failure-stage.enum.js');
 var mode_enum = require('../../enum/decorator/api/function/transaction/mode.enum.js');
 require('../../enum/decorator/api/function/transaction/outcome.enum.js');
@@ -65,14 +65,17 @@ async function ApiFunctionExecuteWithTransaction(options) {
             isSubscriberObservable,
             methodName: options.methodName,
         });
+        const observationIndex = registry?.beginObservation(options);
         try {
             const result = await options.callback(eventManager);
+            registry?.completeObservation(observationIndex, eventStatus_enum.EApiFunctionTransactionEventStatus.SUCCEEDED);
             if (sequence !== undefined) {
                 registry?.succeedEvent(sequence);
             }
             return result;
         }
         catch (error) {
+            registry?.completeObservation(observationIndex, eventStatus_enum.EApiFunctionTransactionEventStatus.FAILED);
             if (sequence !== undefined) {
                 registry?.failEvent(sequence, error);
             }

package/dist/cjs/utility/api/function-transaction.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":["ApiFunctionContextStorage","SERVICE_API_DECORATOR_CONSTANT","EApiFunctionTransactionMode","ErrorException","ApiFunctionTransactionRuntime","EApiFunctionTransactionOwnerKind"],"mappings":"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"}
+{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":["ApiFunctionContextStorage","SERVICE_API_DECORATOR_CONSTANT","EApiFunctionTransactionEventStatus","EApiFunctionTransactionMode","ErrorException","ApiFunctionTransactionRuntime","EApiFunctionTransactionOwnerKind"],"mappings":"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"}

package/dist/esm/class/api/function/transaction/registry.class.d.ts

@@ -1,11 +1,16 @@
-import { IApiFunctionTransaction } from '../../../../interface/class/api/function';
+import { EApiFunctionTransactionOutcome, EApiFunctionTransactionEventStatus } from '../../../../enum/decorator/api';
+import { IApiFunctionTransaction, IApiFunctionTransactionObservationOptions, IApiFunctionTransactionObservationSelector } from '../../../../interface/class/api/function';
 import { IApiSubscriberFunctionTransactionContext } from '../../../../interface/class/api/subscriber/function';
 import { TApiFunctionTransactionEvent, TApiFunctionTransactionOwner, TApiFunctionTransactionTraceType } from '../../../../type/class/api/function/transaction';
 export declare class ApiFunctionTransactionRegistry {
     private readonly EVENTS;
     private eventSnapshot?;
+    private isObservationClosed;
+    private readonly MEASUREMENTS;
+    private readonly OBSERVATION?;
+    private observationDroppedCount;
     private readonly TRANSACTION;
-    constructor(id: string, owner: TApiFunctionTransactionOwner);
+    constructor(id: string, owner: TApiFunctionTransactionOwner, observation?: Readonly<IApiFunctionTransactionObservationOptions>);
     beginEvent(options: {
         action?: string;
         entityName: string;
@@ -13,11 +18,28 @@ export declare class ApiFunctionTransactionRegistry {
         isSubscriberObservable: boolean;
         methodName: string;
     }): number;
+    /**
+     * Reserves one selected native callback interval without changing lifecycle events.
+     * @param {Readonly<IApiFunctionTransactionObservationSelector>} selector Reached native invocation.
+     * @returns {number | undefined} Reserved measurement index, or no admitted measurement.
+     */
+    beginObservation(selector: Readonly<IApiFunctionTransactionObservationSelector>): number | undefined;
+    /**
+     * Samples completion before native event bookkeeping; late completion is ignored.
+     * @param {number | undefined} index Reserved measurement index.
+     * @param {EApiFunctionTransactionEventStatus} status Native callback status.
+     */
+    completeObservation(index: number | undefined, status: EApiFunctionTransactionEventStatus): void;
     createContext(matchedEvents: ReadonlyArray<TApiFunctionTransactionEvent>): IApiSubscriberFunctionTransactionContext;
     failEvent(sequence: number, error: unknown): void;
     getEvents(): ReadonlyArray<TApiFunctionTransactionEvent>;
     getObservableEvents(): ReadonlyArray<TApiFunctionTransactionEvent>;
     getTransaction(): Readonly<IApiFunctionTransaction>;
+    /**
+     * Publishes the bounded projection once after the owning transaction lifecycle settles.
+     * @param {EApiFunctionTransactionOutcome} outcome Settled database outcome.
+     */
+    settleObservation(outcome: EApiFunctionTransactionOutcome): void;
     succeedEvent(sequence: number): void;
     private getPendingEvent;
 }

package/dist/esm/class/api/function/transaction/registry.class.js

@@ -1,3 +1,4 @@
+import { API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT } from '../../../../constant/api-function-transaction-observation.constant.js';
 import '../../../../enum/decorator/api/action.enum.js';
 import '../../../../enum/decorator/api/authentication-type.enum.js';
 import '../../../../enum/decorator/api/controller/get-list/query/filter/missing-behavior.enum.js';
@@ -16,7 +17,7 @@ import '../../../../enum/decorator/api/function/transaction/mode.enum.js';
 import '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
 import '../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
 import { EApiFunctionTransactionTraceType } from '../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
-import '../../../../enum/decorator/api/function/type.enum.js';
+import { EApiFunctionType } from '../../../../enum/decorator/api/function/type.enum.js';
 import '../../../../enum/decorator/api/function/update-persistence-mode.enum.js';
 import '../../../../enum/decorator/api/on-type.enum.js';
 import '../../../../enum/decorator/api/property/data-type.enum.js';
@@ -32,8 +33,38 @@ import { ErrorException } from '../../../../utility/error/exception.utility.js';
 class ApiFunctionTransactionRegistry {
     EVENTS = [];
     eventSnapshot;
+    isObservationClosed = false;
+    MEASUREMENTS = [];
+    OBSERVATION;
+    observationDroppedCount = 0;
     TRANSACTION;
-    constructor(id, owner) {
+    constructor(id, owner, observation) {
+        if (observation !== undefined) {
+            const onSettled = observation?.onSettled;
+            const selectors = observation?.selectors;
+            if (typeof onSettled !== "function" || !Array.isArray(selectors) || selectors.length > API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT.MAXIMUM_SELECTORS) {
+                throw ErrorException("Invalid transaction observation options");
+            }
+            const copiedSelectors = [];
+            for (const selector of selectors) {
+                if (typeof selector !== "object" || selector === null || !("entity" in selector) || !("functionType" in selector) || !("methodName" in selector)) {
+                    throw ErrorException("Invalid transaction observation selector");
+                }
+                const entity = selector.entity;
+                const functionType = selector.functionType;
+                const methodName = selector.methodName;
+                if (typeof entity !== "function" ||
+                    ![...Object.values(EApiFunctionType), EApiFunctionTransactionTraceType.STEP].includes(functionType) ||
+                    typeof methodName !== "string" ||
+                    methodName.trim().length === 0 ||
+                    methodName.length > API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT.MAXIMUM_METHOD_NAME_LENGTH ||
+                    copiedSelectors.some((candidate) => candidate.entity === entity && candidate.functionType === functionType && candidate.methodName === methodName)) {
+                    throw ErrorException("Invalid transaction observation selector");
+                }
+                copiedSelectors.push(Object.freeze({ entity: entity, functionType: functionType, methodName }));
+            }
+            this.OBSERVATION = Object.freeze({ onSettled, selectors: Object.freeze(copiedSelectors) });
+        }
         this.TRANSACTION = Object.freeze({
             id,
             owner: Object.freeze({ ...owner }),
@@ -50,6 +81,58 @@ class ApiFunctionTransactionRegistry {
         });
         return sequence;
     }
+    /**
+     * Reserves one selected native callback interval without changing lifecycle events.
+     * @param {Readonly<IApiFunctionTransactionObservationSelector>} selector Reached native invocation.
+     * @returns {number | undefined} Reserved measurement index, or no admitted measurement.
+     */
+    beginObservation(selector) {
+        if (!this.OBSERVATION || this.isObservationClosed)
+            return undefined;
+        const selectorIndex = this.OBSERVATION.selectors.findIndex((candidate) => candidate.entity === selector.entity && candidate.functionType === selector.functionType && candidate.methodName === selector.methodName);
+        if (selectorIndex === -1)
+            return undefined;
+        if (this.MEASUREMENTS.length >= API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT.MAXIMUM_MEASUREMENTS) {
+            this.observationDroppedCount = Math.min(Number.MAX_SAFE_INTEGER, this.observationDroppedCount + 1);
+            return undefined;
+        }
+        const index = this.MEASUREMENTS.length;
+        const measurement = { selectorIndex };
+        this.MEASUREMENTS.push(measurement);
+        try {
+            const startedAtMs = performance.now();
+            if (Number.isFinite(startedAtMs))
+                measurement.startedAtMs = startedAtMs;
+        }
+        catch {
+            // A missing clock sample drops only this diagnostic interval.
+        }
+        return index;
+    }
+    /**
+     * Samples completion before native event bookkeeping; late completion is ignored.
+     * @param {number | undefined} index Reserved measurement index.
+     * @param {EApiFunctionTransactionEventStatus} status Native callback status.
+     */
+    completeObservation(index, status) {
+        if (index === undefined || this.isObservationClosed)
+            return;
+        const measurement = this.MEASUREMENTS[index];
+        if (!measurement || measurement.status !== undefined)
+            return;
+        measurement.status = status;
+        try {
+            const completedAtMs = performance.now();
+            if (measurement.startedAtMs !== undefined && Number.isFinite(completedAtMs)) {
+                const durationMs = completedAtMs - measurement.startedAtMs;
+                if (Number.isFinite(durationMs) && durationMs >= 0)
+                    measurement.durationMs = durationMs;
+            }
+        }
+        catch {
+            // Capture failures cannot alter a native result or error.
+        }
+    }
     createContext(matchedEvents) {
         const events = this.getEvents();
         return Object.freeze({
@@ -99,6 +182,35 @@ class ApiFunctionTransactionRegistry {
     getTransaction() {
         return this.TRANSACTION;
     }
+    /**
+     * Publishes the bounded projection once after the owning transaction lifecycle settles.
+     * @param {EApiFunctionTransactionOutcome} outcome Settled database outcome.
+     */
+    settleObservation(outcome) {
+        if (!this.OBSERVATION || this.isObservationClosed)
+            return;
+        this.isObservationClosed = true;
+        try {
+            const measurements = [];
+            for (const measurement of this.MEASUREMENTS) {
+                if (measurement.durationMs === undefined || measurement.status === undefined) {
+                    this.observationDroppedCount = Math.min(Number.MAX_SAFE_INTEGER, this.observationDroppedCount + 1);
+                    continue;
+                }
+                measurements.push(Object.freeze({ durationMs: measurement.durationMs, selectorIndex: measurement.selectorIndex, status: measurement.status }));
+            }
+            this.MEASUREMENTS.length = 0;
+            const onSettled = this.OBSERVATION.onSettled;
+            const delivery = onSettled(Object.freeze({ droppedCount: this.observationDroppedCount, measurements: Object.freeze(measurements), outcome }));
+            if (delivery !== undefined)
+                void Promise.resolve(delivery).catch(() => {
+                    // An accidental asynchronous observer rejection remains diagnostic-only.
+                });
+        }
+        catch {
+            // Diagnostic callbacks never participate in transaction error handling.
+        }
+    }
     succeedEvent(sequence) {
         const event = this.getPendingEvent(sequence);
         event.status = EApiFunctionTransactionEventStatus.SUCCEEDED;

package/dist/esm/class/api/function/transaction/registry.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.class.js","sources":["../../../../../../../src/class/api/function/transaction/registry.class.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.class.js","sources":["../../../../../../../src/class/api/function/transaction/registry.class.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/class/api/function/transaction/runtime.class.d.ts

@@ -1,9 +1,11 @@
+import { IApiFunctionTransactionObservationOptions } from '../../../../interface/class/api/function';
 import { TApiFunctionTransactionOwner } from '../../../../type/class/api/function';
 import { DataSource, EntityManager } from 'typeorm';
 export declare class ApiFunctionTransactionRuntime {
     static execute<R>(options: {
         callback: (entityManager: EntityManager) => Promise<R>;
         dataSource: DataSource;
+        observation?: Readonly<IApiFunctionTransactionObservationOptions>;
         owner: TApiFunctionTransactionOwner;
     }): Promise<R>;
     private static releaseBestEffort;

package/dist/esm/class/api/function/transaction/runtime.class.js

@@ -17,7 +17,7 @@ import '../../../../enum/decorator/api/function/subscriber-transaction-expectati
 import '../../../../enum/decorator/api/function/transaction/event-status.enum.js';
 import { EApiFunctionTransactionFailureStage } from '../../../../enum/decorator/api/function/transaction/failure-stage.enum.js';
 import '../../../../enum/decorator/api/function/transaction/mode.enum.js';
-import '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
+import { EApiFunctionTransactionOutcome } from '../../../../enum/decorator/api/function/transaction/outcome.enum.js';
 import '../../../../enum/decorator/api/function/transaction/owner-kind.enum.js';
 import '../../../../enum/decorator/api/function/transaction/trace-type.enum.js';
 import '../../../../enum/decorator/api/function/type.enum.js';
@@ -41,6 +41,7 @@ class ApiFunctionTransactionRuntime {
         if (ApiFunctionContextStorage.getTransactionRegistry()) {
             throw ErrorException("Cannot open an owning transaction inside an active Automator transaction");
         }
+        const registry = new ApiFunctionTransactionRegistry(randomUUID(), options.owner, options.observation);
         const queryRunner = options.dataSource.createQueryRunner();
         try {
             await queryRunner.connect();
@@ -50,7 +51,6 @@ class ApiFunctionTransactionRuntime {
             await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
             throw error;
         }
-        const registry = new ApiFunctionTransactionRegistry(randomUUID(), options.owner);
         const result = {};
         let commitCleanupFailure;
         let commitError;
@@ -79,17 +79,27 @@ class ApiFunctionTransactionRuntime {
             }
             await ApiFunctionTransactionRuntime.releaseBestEffort(queryRunner);
         });
-        if (hasOperationError) {
-            return await ApiFunctionTransactionLifecycle.executeAfterRollback(registry, operationError, rollbackFailure);
-        }
-        if (hasCommitError) {
-            return await ApiFunctionTransactionLifecycle.executeCommitUnknown(registry, commitError, commitCleanupFailure);
+        let outcome = EApiFunctionTransactionOutcome.COMMITTED;
+        if (hasCommitError || rollbackFailure)
+            outcome = EApiFunctionTransactionOutcome.UNKNOWN;
+        else if (hasOperationError)
+            outcome = EApiFunctionTransactionOutcome.ROLLED_BACK;
+        try {
+            if (hasOperationError) {
+                return await ApiFunctionTransactionLifecycle.executeAfterRollback(registry, operationError, rollbackFailure);
+            }
+            if (hasCommitError) {
+                return await ApiFunctionTransactionLifecycle.executeCommitUnknown(registry, commitError, commitCleanupFailure);
+            }
+            if (!("value" in result)) {
+                throw ErrorException("Automator transaction completed without a committed result");
+            }
+            await ApiFunctionTransactionLifecycle.executeAfterCommit(registry);
+            return result.value;
         }
-        if (!("value" in result)) {
-            throw ErrorException("Automator transaction completed without a committed result");
+        finally {
+            registry.settleObservation(outcome);
         }
-        await ApiFunctionTransactionLifecycle.executeAfterCommit(registry);
-        return result.value;
     }
     static async releaseBestEffort(queryRunner) {
         try {

package/dist/esm/class/api/function/transaction/runtime.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.class.js","sources":["../../../../../../../src/class/api/function/transaction/runtime.class.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.class.js","sources":["../../../../../../../src/class/api/function/transaction/runtime.class.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/class/api/function/transaction/scope.class.d.ts

@@ -1,7 +1,9 @@
+import { IApiFunctionTransactionObservationOptions } from '../../../../interface/class/api/function';
 import { DataSource, EntityManager } from 'typeorm';
 export declare class ApiFunctionTransactionScope {
     static runWithDataSource<R>(dataSource: DataSource, properties: {
         name: string;
+        observation?: Readonly<IApiFunctionTransactionObservationOptions>;
     }, callback: (entityManager: EntityManager) => Promise<R>): Promise<R>;
     static runWithEntityManager<R>(entityManager: EntityManager, callback: () => Promise<R>): Promise<R>;
     private static createMissingServiceContextError;

package/dist/esm/class/api/function/transaction/scope.class.js

@@ -40,6 +40,7 @@ class ApiFunctionTransactionScope {
         return await ApiFunctionTransactionRuntime.execute({
             callback: async (entityManager) => await ApiFunctionTransactionScope.runWithEntityManager(entityManager, async () => await callback(entityManager)),
             dataSource,
+            observation: properties.observation,
             owner: {
                 kind: EApiFunctionTransactionOwnerKind.SCOPE,
                 name,

package/dist/esm/class/api/function/transaction/scope.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.class.js","sources":["../../../../../../../src/class/api/function/transaction/scope.class.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUa,2BAA2B,CAAA;IAChC,aAAa,iBAAiB,CAAI,UAAsB,EAAE,UAA4B,EAAE,QAAsD,EAAA;QACpJ,MAAM,IAAI,GAAW,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;AAE3C,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,YAAA,MAAM,cAAc,CAAC,6DAA6D,CAAC;QACpF;AAEA,QAAA,OAAO,MAAM,6BAA6B,CAAC,OAAO,CAAC;YAClD,QAAQ,EAAE,OAAO,aAA4B,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,aAAa,EAAE,YAAwB,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC1L,UAAU;AACV,YAAA,KAAK,EAAE;gBACN,IAAI,EAAE,gCAAgC,CAAC,KAAK;gBAC5C,IAAI;AACJ,aAAA;AACD,SAAA,CAAC;IACH;AAEO,IAAA,aAAa,oBAAoB,CAAI,aAA4B,EAAE,QAA0B,EAAA;QACnG,MAAM,QAAQ,GAA+C,yBAAyB,CAAC,sCAAsC,CAAC,aAAa,CAAC;QAE5I,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,yBAAyB,CAAC,sBAAsB,EAAE,IAAI,yBAAyB,CAAC,eAAe,EAAE,KAAK,aAAa,IAAI,yBAAyB,CAAC,yBAAyB,EAAE,EAAE,OAAO,KAAK,aAAa,EAAE;AACtO,YAAA,MAAM,cAAc,CAAC,4GAA4G,CAAC;QACnI;QAEA,MAAM,MAAM,GAA6B,MAAM;AAE/C,QAAA,MAAM,OAAO,GAAwC;YACpD,MAAM;AACN,YAAA,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,YAAA,UAAU,EAAE;AACX,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,gBAAA,MAAM,EAAE,MAAqB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC3G,gBAAA,GAAG,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAClH,gBAAA,OAAO,EAAE,MAAsB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC7G,gBAAA,OAAO,EAAE,MAAsC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;gBAC7H,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,aAAA;AACD,YAAA,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC;SAC/C;QAED,OAAO,MAAM,yBAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC9D;AAEQ,IAAA,OAAO,gCAAgC,GAAA;AAC9C,QAAA,OAAO,cAAc,CAAC,4EAA4E,CAAC;IACpG;AACA;;"}
+{"version":3,"file":"scope.class.js","sources":["../../../../../../../src/class/api/function/transaction/scope.class.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUa,2BAA2B,CAAA;IAChC,aAAa,iBAAiB,CAAI,UAAsB,EAAE,UAA+F,EAAE,QAAsD,EAAA;QACvN,MAAM,IAAI,GAAW,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;AAE3C,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,YAAA,MAAM,cAAc,CAAC,6DAA6D,CAAC;QACpF;AAEA,QAAA,OAAO,MAAM,6BAA6B,CAAC,OAAO,CAAC;YAClD,QAAQ,EAAE,OAAO,aAA4B,KAAiB,MAAM,2BAA2B,CAAC,oBAAoB,CAAC,aAAa,EAAE,YAAwB,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC1L,UAAU;YACV,WAAW,EAAE,UAAU,CAAC,WAAW;AACnC,YAAA,KAAK,EAAE;gBACN,IAAI,EAAE,gCAAgC,CAAC,KAAK;gBAC5C,IAAI;AACJ,aAAA;AACD,SAAA,CAAC;IACH;AAEO,IAAA,aAAa,oBAAoB,CAAI,aAA4B,EAAE,QAA0B,EAAA;QACnG,MAAM,QAAQ,GAA+C,yBAAyB,CAAC,sCAAsC,CAAC,aAAa,CAAC;QAE5I,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,yBAAyB,CAAC,sBAAsB,EAAE,IAAI,yBAAyB,CAAC,eAAe,EAAE,KAAK,aAAa,IAAI,yBAAyB,CAAC,yBAAyB,EAAE,EAAE,OAAO,KAAK,aAAa,EAAE;AACtO,YAAA,MAAM,cAAc,CAAC,4GAA4G,CAAC;QACnI;QAEA,MAAM,MAAM,GAA6B,MAAM;AAE/C,QAAA,MAAM,OAAO,GAAwC;YACpD,MAAM;AACN,YAAA,YAAY,EAAE,aAAa;YAC3B,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,YAAA,UAAU,EAAE;AACX,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,gBAAA,MAAM,EAAE,MAAqB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC3G,gBAAA,GAAG,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAClH,gBAAA,OAAO,EAAE,MAAsB,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AAC7G,gBAAA,OAAO,EAAE,MAAsC,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;gBAC7H,aAAa,EAAE,CAA2B,gBAA6B,KAAoB,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;AACxI,gBAAA,MAAM,EAAE,MAA+B,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,gCAAgC,EAAE,CAAC;AACrH,aAAA;AACD,YAAA,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC;SAC/C;QAED,OAAO,MAAM,yBAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC9D;AAEQ,IAAA,OAAO,gCAAgC,GAAA;AAC9C,QAAA,OAAO,cAAc,CAAC,4EAA4E,CAAC;IACpG;AACA;;"}

package/dist/esm/constant/api-function-transaction-observation.constant.d.ts

@@ -0,0 +1,5 @@
+export declare const API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT: {
+    readonly MAXIMUM_MEASUREMENTS: number;
+    readonly MAXIMUM_METHOD_NAME_LENGTH: number;
+    readonly MAXIMUM_SELECTORS: number;
+};

package/dist/esm/constant/api-function-transaction-observation.constant.js

@@ -0,0 +1,11 @@
+const MAXIMUM_MEASUREMENTS = 256;
+const MAXIMUM_METHOD_NAME_LENGTH = 256;
+const MAXIMUM_SELECTORS = 32;
+const API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT = {
+    MAXIMUM_MEASUREMENTS,
+    MAXIMUM_METHOD_NAME_LENGTH,
+    MAXIMUM_SELECTORS,
+};
+
+export { API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT };
+//# sourceMappingURL=api-function-transaction-observation.constant.js.map

package/dist/esm/constant/api-function-transaction-observation.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-function-transaction-observation.constant.js","sources":["../../../../src/constant/api-function-transaction-observation.constant.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAW,GAAG;AACxC,MAAM,0BAA0B,GAAW,GAAG;AAC9C,MAAM,iBAAiB,GAAW,EAAE;AAE7B,MAAM,6CAA6C,GAItD;IACH,oBAAoB;IACpB,0BAA0B;IAC1B,iBAAiB;;;"}

package/dist/esm/constant/index.d.ts

@@ -1,3 +1,4 @@
+export { API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT } from './api-function-transaction-observation.constant';
 export * from './class';
 export { DATE_CONSTANT } from './date.constant';
 export * from './decorator';

package/dist/esm/index.js

@@ -46,6 +46,7 @@ export { DtoStrategyBody } from './class/utility/dto/strategy/body.class.js';
 export { DtoStrategyQuery } from './class/utility/dto/strategy/query.class.js';
 export { DtoStrategyRequest } from './class/utility/dto/strategy/request.class.js';
 export { DtoStrategyResponse } from './class/utility/dto/strategy/response.class.js';
+export { API_FUNCTION_TRANSACTION_OBSERVATION_CONSTANT } from './constant/api-function-transaction-observation.constant.js';
 export { AUTHORIZATION_AUDIT_SINK_TOKEN } from './constant/class/authorization/audit-sink-token.constant.js';
 export { AUTHORIZATION_HOOK_PERMISSION_SOURCES_TOKEN } from './constant/class/authorization/hook-permission-sources-token.constant.js';
 export { AUTHORIZATION_DECISION_METADATA_CONSTANT } from './constant/class/authorization/metadata-decision.constant.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/interface/class/api/function/transaction/index.d.ts

@@ -1,4 +1,5 @@
 export type * from './event';
 export { type IApiFunctionTransactionFailure } from './failure.interface';
 export { type IApiFunctionTransaction } from './interface';
+export type * from './observation';
 export type * from './owner';

package/dist/esm/interface/class/api/function/transaction/observation/index.d.ts

@@ -0,0 +1,4 @@
+export { type IApiFunctionTransactionObservationMeasurement } from './measurement.interface';
+export { type IApiFunctionTransactionObservationOptions } from './options.interface';
+export { type IApiFunctionTransactionObservationSelector } from './selector.interface';
+export { type IApiFunctionTransactionObservationSnapshot } from './snapshot.interface';

package/dist/esm/interface/class/api/function/transaction/observation/measurement.interface.d.ts

@@ -0,0 +1,6 @@
+import { EApiFunctionTransactionEventStatus } from '../../../../../../enum/decorator/api';
+export interface IApiFunctionTransactionObservationMeasurement {
+    durationMs: number;
+    selectorIndex: number;
+    status: EApiFunctionTransactionEventStatus;
+}

package/dist/esm/interface/class/api/function/transaction/observation/options.interface.d.ts

@@ -0,0 +1,6 @@
+import { IApiFunctionTransactionObservationSelector } from './selector.interface';
+import { IApiFunctionTransactionObservationSnapshot } from './snapshot.interface';
+export interface IApiFunctionTransactionObservationOptions {
+    onSettled: (snapshot: Readonly<IApiFunctionTransactionObservationSnapshot>) => void;
+    selectors: ReadonlyArray<Readonly<IApiFunctionTransactionObservationSelector>>;
+}

package/dist/esm/interface/class/api/function/transaction/observation/selector.interface.d.ts

@@ -0,0 +1,7 @@
+import { IApiBaseEntity } from '../../../../../api-base-entity.interface';
+import { TApiFunctionTransactionTraceType } from '../../../../../../type/class/api/function/transaction';
+export interface IApiFunctionTransactionObservationSelector {
+    entity: new (...arguments_: Array<unknown>) => IApiBaseEntity;
+    functionType: TApiFunctionTransactionTraceType;
+    methodName: string;
+}

package/dist/esm/interface/class/api/function/transaction/observation/snapshot.interface.d.ts

@@ -0,0 +1,7 @@
+import { EApiFunctionTransactionOutcome } from '../../../../../../enum/decorator/api';
+import { IApiFunctionTransactionObservationMeasurement } from './measurement.interface';
+export interface IApiFunctionTransactionObservationSnapshot {
+    droppedCount: number;
+    measurements: ReadonlyArray<Readonly<IApiFunctionTransactionObservationMeasurement>>;
+    outcome: EApiFunctionTransactionOutcome;
+}

package/dist/esm/utility/api/function-transaction.utility.js

@@ -13,7 +13,7 @@ import '../../enum/decorator/api/controller/response-target.enum.js';
 import '../../enum/decorator/api/dto-type.enum.js';
 import '../../enum/decorator/api/function/context-storage-kind.enum.js';
 import '../../enum/decorator/api/function/subscriber-transaction-expectation.enum.js';
-import '../../enum/decorator/api/function/transaction/event-status.enum.js';
+import { EApiFunctionTransactionEventStatus } from '../../enum/decorator/api/function/transaction/event-status.enum.js';
 import '../../enum/decorator/api/function/transaction/failure-stage.enum.js';
 import { EApiFunctionTransactionMode } from '../../enum/decorator/api/function/transaction/mode.enum.js';
 import '../../enum/decorator/api/function/transaction/outcome.enum.js';
@@ -63,14 +63,17 @@ async function ApiFunctionExecuteWithTransaction(options) {
             isSubscriberObservable,
             methodName: options.methodName,
         });
+        const observationIndex = registry?.beginObservation(options);
         try {
             const result = await options.callback(eventManager);
+            registry?.completeObservation(observationIndex, EApiFunctionTransactionEventStatus.SUCCEEDED);
             if (sequence !== undefined) {
                 registry?.succeedEvent(sequence);
             }
             return result;
         }
         catch (error) {
+            registry?.completeObservation(observationIndex, EApiFunctionTransactionEventStatus.FAILED);
             if (sequence !== undefined) {
                 registry?.failEvent(sequence, error);
             }

package/dist/esm/utility/api/function-transaction.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"function-transaction.utility.js","sources":["../../../../../src/utility/api/function-transaction.utility.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsikora/nestjs-crud-automator",
-	"version": "4.4.0-dev.2",
+	"version": "4.5.0-dev.1",
 	"description": "A library for automating the creation of CRUD operations in NestJS.",
 	"keywords": [
 		"NestJS",