@segment/actions-shared 1.97.0 → 1.98.0

package/dist/engage/utils/operationTracking/OperationErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationErrorHandler.js","sourceRoot":"","sources":["../../../../src/engage/utils/operationTracking/OperationErrorHandler.ts"],"names":[],"mappings":";;;AAaA,MAAa,qBAAqB;IAChC,MAAM,CAAC,sBAAsB,CAAC,IAAkC;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAiC;QAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAA;QAG/B,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CACnB,GAAG,CAAC,KAAK,EACT,GAAG,EAAE;YAEH,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAClC,OAAO,GAAG,CAAC,KAAqB,CAAA;QAClC,CAAC,EACD,GAAG,CACJ,CAAA;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CACT,aAAsB,EACtB,UAA+C,EAC/C,GAAc;QAEd,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAiB,CAAA;QAEzD,IAAI,OAAO,IAAI,aAAa,KAAK,OAAO;YAAE,OAAO,CAAC,eAAe,GAAG,aAAa,CAAA;QAEjF,MAAM,YAAY,GAAG,OAAO,CAAA;QAC5B,IAAI,CAAC,YAAY;YAAE,OAAM;QAEzB,IAAI,CAAC,GAAG;YAAE,OAAM;QAGhB,IAAI,CAAC,YAAY,CAAC,cAAc;YAAE,YAAY,CAAC,cAAc,GAAG,GAAG,CAAA;QAGnE,MAAM,kBAAkB,GAAG,MAAM,CAAC,wBAAwB,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAA;QAC1F,IAAI,kBAAkB,EAAE,UAAU,EAAE;YAElC,kBAAkB,CAAC,UAAU,GAAG,KAAK,CAAA;YACrC,MAAM,CAAC,cAAc,CAAC,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAA;SAC1E;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF;AA/CD,sDA+CC"}

package/dist/engage/utils/operationTracking/OperationFinallyHooks.d.ts

@@ -0,0 +1,14 @@
+import { TryCatchFinallyContext, TryCatchFinallyHook } from './wrapTryCatchFinallyPromisable';
+export declare type OperationFinallyHooksContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TContext & {
+    onFinally: (() => void)[];
+    decoratorArgs?: {
+        onTry?: (ctx: TContext) => void;
+        onFinally?: (ctx: TContext) => void;
+    };
+};
+export declare class OperationFinallyHooks {
+    static getTryCatchFinallyHook(_ctx: OperationFinallyHooksContext): TryCatchFinallyHook<OperationFinallyHooksContext>;
+    static getPriority(): number;
+    static onTry<TContext extends TryCatchFinallyContext>(ctx: OperationFinallyHooksContext<TContext>): void;
+    static onFinally<TContext extends TryCatchFinallyContext>(ctx: OperationFinallyHooksContext<TContext>): void;
+}

package/dist/engage/utils/operationTracking/OperationFinallyHooks.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationFinallyHooks = void 0;
+class OperationFinallyHooks {
+    static getTryCatchFinallyHook(_ctx) {
+        return this;
+    }
+    static getPriority() {
+        return 100;
+    }
+    static onTry(ctx) {
+        ctx.onFinally = [];
+        ctx.decoratorArgs?.onTry?.(ctx);
+    }
+    static onFinally(ctx) {
+        for (const hook of ctx.onFinally) {
+            try {
+                hook();
+            }
+            catch (e) {
+                const error = e;
+                const loggerCtx = ctx;
+                if (loggerCtx.logs)
+                    loggerCtx.logs.push(`Error in onFinally hook: ${error?.message || error.toString()}`);
+            }
+        }
+        ctx.decoratorArgs?.onFinally?.(ctx);
+    }
+}
+exports.OperationFinallyHooks = OperationFinallyHooks;
+//# sourceMappingURL=OperationFinallyHooks.js.map

package/dist/engage/utils/operationTracking/OperationFinallyHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationFinallyHooks.js","sourceRoot":"","sources":["../../../../src/engage/utils/operationTracking/OperationFinallyHooks.ts"],"names":[],"mappings":";;;AAeA,MAAa,qBAAqB;IAChC,MAAM,CAAC,sBAAsB,CAAC,IAAkC;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,CAAC,WAAW;QAChB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,CAAC,KAAK,CAA0C,GAA2C;QAC/F,GAAG,CAAC,SAAS,GAAG,EAAE,CAAA;QAClB,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAED,MAAM,CAAC,SAAS,CAA0C,GAA2C;QACnG,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,SAAS,EAAE;YAChC,IAAI;gBACF,IAAI,EAAE,CAAA;aACP;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,KAAK,GAAG,CAAU,CAAA;gBAExB,MAAM,SAAS,GAAG,GAAsC,CAAA;gBACxD,IAAI,SAAS,CAAC,IAAI;oBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;aAC1G;SACF;QACD,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAA;IACrC,CAAC;CACF;AA1BD,sDA0BC"}

package/dist/engage/utils/operationTracking/OperationLogger.d.ts

@@ -0,0 +1,31 @@
+import { TryCatchFinallyContext, TryCatchFinallyHook } from './wrapTryCatchFinallyPromisable';
+import { TrackedError } from './TrackedError';
+import { OperationDecoratorContext } from './OperationDecorator';
+export declare type OperationLoggerContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TContext & {
+    logs: string[];
+    logMetadata?: Record<string, unknown>;
+    decoratorArgs?: OperationLoggerDecoratorArgs;
+    sharedContext: OperationLoggerSharedContext;
+};
+export interface OperationLoggerSharedContext {
+    logs: string[];
+    logMetadata?: Record<string, unknown>;
+}
+export interface OperationLoggerDecoratorArgs {
+    shouldLog?: (ctx: OperationLoggerContext) => boolean | void;
+}
+export declare abstract class OperationLogger implements TryCatchFinallyHook<OperationLoggerContext> {
+    static getTryCatchFinallyHook(_ctx: OperationLoggerContext): TryCatchFinallyHook<OperationLoggerContext>;
+    abstract logInfo(msg: string, metadata?: object): void;
+    abstract logError(msg: string, metadata?: object): void;
+    onTry(ctx: OperationLoggerContext): () => void;
+    onFinally(ctx: OperationLoggerContext): () => void;
+    stageLog(ctx: OperationLoggerContext): () => void;
+    shouldLogDefault(_ctx: OperationLoggerContext): boolean;
+    getOperationLogMessages(ctx: OperationLoggerContext): string[];
+    getOperationTryMessage(ctx: OperationLoggerContext): string;
+    getOperationName<TContext extends OperationDecoratorContext>(ctx: TContext, fullPath?: boolean, separator?: string): string;
+    getOperationCompletedMessage(ctx: OperationLoggerContext): string;
+    getOperationErrorDetails(error: TrackedError, ctx: OperationLoggerContext): string[];
+    getErrorMessage(error: unknown, _ctx?: OperationLoggerContext): string;
+}

package/dist/engage/utils/operationTracking/OperationLogger.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationLogger = void 0;
+const OperationTree_1 = require("./OperationTree");
+const OperationDecorator_1 = require("./OperationDecorator");
+class OperationLogger {
+    static getTryCatchFinallyHook(_ctx) {
+        throw new Error('OperationLogger.getTryCatchFinallyHook is abstract and must be implemented by derived class');
+    }
+    onTry(ctx) {
+        return this.stageLog(ctx);
+    }
+    onFinally(ctx) {
+        return this.stageLog(ctx);
+    }
+    stageLog(ctx) {
+        if (!ctx.sharedContext.logs)
+            ctx.sharedContext.logs = [];
+        if (!ctx.logs)
+            ctx.logs = [];
+        const stageLogMessages = this.getOperationLogMessages(ctx);
+        if (stageLogMessages)
+            ctx.logs.push(...stageLogMessages);
+        return () => {
+            let shouldLog = ctx.decoratorArgs?.shouldLog?.(ctx);
+            if (shouldLog === undefined)
+                shouldLog = this.shouldLogDefault(ctx);
+            if (shouldLog) {
+                const fullLogMessage = (ctx.logs || [])
+                    .concat(...(ctx.sharedContext.logs || []))
+                    .filter((t) => t)
+                    .join('. ');
+                const logDetails = ctx.logMetadata || ctx.sharedContext.logMetadata
+                    ? { ...ctx.sharedContext.logMetadata, ...ctx.logMetadata }
+                    : undefined;
+                if (ctx.error)
+                    this.logError(fullLogMessage, { error: ctx.error, ...logDetails });
+                else
+                    this.logInfo(fullLogMessage, logDetails);
+            }
+            ctx.logs.length = 0;
+        };
+    }
+    shouldLogDefault(_ctx) {
+        return true;
+    }
+    getOperationLogMessages(ctx) {
+        const res = [];
+        switch (ctx.stage) {
+            case 'try':
+                res.push(this.getOperationTryMessage(ctx));
+                break;
+            case 'finally':
+                res.push(this.getOperationCompletedMessage(ctx));
+                if (ctx.error) {
+                    const error = ctx.error;
+                    res.push(...(this.getOperationErrorDetails(error, ctx) || []));
+                }
+                break;
+            default:
+                break;
+        }
+        return res;
+    }
+    getOperationTryMessage(ctx) {
+        return `${this.getOperationName(ctx)} starting...`;
+    }
+    getOperationName(ctx, fullPath = true, separator = ' > ') {
+        if (!fullPath)
+            return OperationDecorator_1.OperationDecorator.getOperationName(ctx) || '(anonymous)';
+        const fullOperationName = OperationTree_1.OperationTree.getOperationsStack(ctx)
+            .map((op) => this.getOperationName(op, false))
+            .join(separator);
+        return fullOperationName;
+    }
+    getOperationCompletedMessage(ctx) {
+        const hasError = !!ctx.error;
+        const fullOperationName = this.getOperationName(ctx);
+        const duration = ctx.duration;
+        if (duration !== undefined)
+            return `${fullOperationName} ${hasError ? 'failed' : 'succeeded'} after ${duration} ms`;
+        else
+            return `${fullOperationName} ${hasError ? 'failed' : 'succeeded'}`;
+    }
+    getOperationErrorDetails(error, ctx) {
+        const errorContext = error.trackedContext;
+        const logMessages = [];
+        logMessages.push(this.getErrorMessage(error, ctx));
+        if (errorContext == ctx && error.underlyingError) {
+            logMessages.push(`Underlying error: ${this.getErrorMessage(error.underlyingError, ctx)}`);
+        }
+        return logMessages;
+    }
+    getErrorMessage(error, _ctx) {
+        if (error instanceof Error) {
+            const trError = error;
+            const errorClass = trError?.constructor?.name;
+            return `${errorClass || '[undefined]'}: ${trError.message}`;
+        }
+        return error?.toString?.() || 'unknown error';
+    }
+}
+exports.OperationLogger = OperationLogger;
+//# sourceMappingURL=OperationLogger.js.map

package/dist/engage/utils/operationTracking/OperationLogger.js.map

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

package/dist/engage/utils/operationTracking/OperationStats.d.ts

@@ -0,0 +1,39 @@
+import { TrackedError } from './TrackedError';
+import { TryCatchFinallyContext, TryCatchFinallyHook } from './wrapTryCatchFinallyPromisable';
+export declare type OperationStatsContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TContext & {
+    tags: string[];
+    sharedContext: {
+        tags: string[];
+    };
+    decoratorArgs?: {
+        shouldStats?: (args: OperationStatsEventArgs) => boolean | void;
+    };
+};
+export declare abstract class OperationStats<TContext extends OperationStatsContext = OperationStatsContext> implements TryCatchFinallyHook<TContext> {
+    static getTryCatchFinallyHook(_ctx: OperationStatsContext): TryCatchFinallyHook<OperationStatsContext>;
+    abstract stats(args: StatsArgs): void;
+    getMetricName(ctx: OperationStatsContext): string | undefined;
+    onTry(ctx: OperationStatsContext): () => void;
+    mergeTags(...tagSets: (string[] | undefined)[]): string[];
+    statsOperationEvent(args: OperationStatsEventArgs): void;
+    onCatch(ctx: OperationStatsContext): void;
+    onFinally(ctx: OperationStatsContext): () => void;
+    getHistogramMetric(ctx: OperationStatsContext): string | undefined;
+    extractTagsFromError(error: TrackedError, ctx: OperationStatsContext): string[];
+    getErrorOperationNameTag(error: TrackedError, ctx: OperationStatsContext): string | undefined;
+    getOperationNameTag(ctx: OperationStatsContext): string | undefined;
+}
+export declare type StatsMethod = 'incr' | 'histogram' | 'set';
+export declare type StatsArgs = {
+    method?: StatsMethod;
+    metric: string;
+    value?: number;
+    tags?: string[];
+};
+export declare type OperationStatsEvent = OperationStatsContext['stage'] | 'duration';
+export interface OperationStatsEventArgs {
+    event: OperationStatsEvent;
+    context: OperationStatsContext;
+    stats: StatsArgs;
+    shouldStats: boolean;
+}

package/dist/engage/utils/operationTracking/OperationStats.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationStats = void 0;
+const OperationDuration_1 = require("./OperationDuration");
+const OperationDecorator_1 = require("./OperationDecorator");
+class OperationStats {
+    static getTryCatchFinallyHook(_ctx) {
+        throw new Error('OperationStats.getTryCatchFinallyHook is abstract and must be implemented by derived class');
+    }
+    getMetricName(ctx) {
+        const opName = OperationDecorator_1.OperationDecorator.getOperationName(ctx);
+        if (!opName)
+            return undefined;
+        switch (ctx.stage) {
+            case 'try':
+                return `${opName}.try`;
+            case 'catch':
+                return `${opName}.catch`;
+            case 'finally':
+            default:
+                return `${opName}`;
+        }
+    }
+    onTry(ctx) {
+        ctx.tags = [];
+        if (!ctx.sharedContext.tags)
+            ctx.sharedContext.tags = [];
+        return () => {
+            const metricName = this.getMetricName(ctx);
+            if (metricName)
+                this.statsOperationEvent({
+                    context: ctx,
+                    event: 'try',
+                    shouldStats: false,
+                    stats: {
+                        metric: metricName,
+                        method: 'incr',
+                        value: 1,
+                        tags: this.mergeTags(ctx.sharedContext.tags, ctx.tags)
+                    }
+                });
+        };
+    }
+    mergeTags(...tagSets) {
+        const res = [];
+        for (const tags of tagSets) {
+            if (tags)
+                res.push(...tags);
+        }
+        return res.filter((t) => t);
+    }
+    statsOperationEvent(args) {
+        if (args.context.decoratorArgs?.shouldStats) {
+            const shouldStats = args.context.decoratorArgs.shouldStats(args);
+            if (shouldStats !== undefined)
+                args.shouldStats = shouldStats;
+        }
+        if (args.shouldStats && args.stats) {
+            this.stats(args.stats);
+        }
+    }
+    onCatch(ctx) {
+        const metricName = this.getMetricName(ctx);
+        if (metricName)
+            this.statsOperationEvent({
+                context: ctx,
+                event: ctx.stage,
+                shouldStats: false,
+                stats: {
+                    metric: metricName,
+                    method: 'incr',
+                    value: 1,
+                    tags: this.mergeTags(ctx.sharedContext.tags, ctx.tags)
+                }
+            });
+    }
+    onFinally(ctx) {
+        const finallyTags = [];
+        if (ctx.stage == 'finally')
+            finallyTags.push(`error:${ctx.error ? 'true' : 'false'}`);
+        if (ctx.error) {
+            const error = ctx.error;
+            finallyTags.push(...(this.extractTagsFromError(error, ctx) || []));
+        }
+        ctx.tags.push(...finallyTags);
+        return () => {
+            const finallyTags = this.mergeTags(ctx.sharedContext.tags, ctx.tags);
+            const metricName = this.getMetricName(ctx);
+            if (metricName)
+                this.statsOperationEvent({
+                    context: ctx,
+                    event: 'finally',
+                    shouldStats: true,
+                    stats: { metric: metricName, method: 'incr', value: 1, tags: [...finallyTags] }
+                });
+            const duration = OperationDuration_1.OperationDuration.getDuration(ctx);
+            const histogramMetric = this.getHistogramMetric(ctx);
+            if (duration !== undefined && histogramMetric)
+                this.statsOperationEvent({
+                    context: ctx,
+                    event: 'duration',
+                    shouldStats: true,
+                    stats: { metric: histogramMetric, method: 'histogram', value: duration, tags: [...finallyTags] }
+                });
+        };
+    }
+    getHistogramMetric(ctx) {
+        const opName = OperationDecorator_1.OperationDecorator.getOperationName(ctx);
+        if (!opName)
+            return undefined;
+        return `${opName}.duration`;
+    }
+    extractTagsFromError(error, ctx) {
+        const res = [];
+        const errorOperation = this.getErrorOperationNameTag(error, ctx);
+        if (errorOperation)
+            res.push(`error_operation:${errorOperation}`);
+        res.push(`error_class:${error?.constructor?.name || typeof error}`);
+        return res;
+    }
+    getErrorOperationNameTag(error, ctx) {
+        const errorContext = error.trackedContext;
+        return errorContext ? this.getOperationNameTag(errorContext) : this.getOperationNameTag(ctx);
+    }
+    getOperationNameTag(ctx) {
+        return OperationDecorator_1.OperationDecorator.getOperationName(ctx);
+    }
+}
+exports.OperationStats = OperationStats;
+//# sourceMappingURL=OperationStats.js.map

package/dist/engage/utils/operationTracking/OperationStats.js.map

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

package/dist/engage/utils/operationTracking/OperationTree.d.ts

@@ -0,0 +1,23 @@
+import { ContextFromHookProviders, FuncFromHookProviders, OperationHookProvider } from './OperationDecorator';
+import { TryCatchFinallyHook, TryCatchFinallyContext } from './wrapTryCatchFinallyPromisable';
+declare type OperationTreeContext<TParentContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TParentContext & {
+    parent?: OperationTreeContext<TParentContext>;
+    sharedContext: {};
+};
+export declare class OperationTree {
+    static getTryCatchFinallyHook(_ctx: OperationTreeContext): TryCatchFinallyHook<OperationTreeContext>;
+    static getPriority(): number;
+    static onTry(ctx: OperationTreeContext): void;
+    static onFinally(ctx: OperationTreeContext): () => void;
+    static getCurrentOperationFromTrackedClassInstance<TClassInstance>(classInstance: TClassInstance): OperationTreeContext<TryCatchFinallyContext<(this: any, ...args: any[]) => any>>;
+    static getCurrentOperationFromContext(ctx: OperationTreeContext): OperationTreeContext<TryCatchFinallyContext<(this: any, ...args: any[]) => any>>;
+    protected static setCurrentOperationToContext(ctx: OperationTreeContext, newCurrentOperation: OperationTreeContext | undefined): void;
+    static getOperationsStack<TContext extends OperationTreeContext>(ctx: TContext): TContext[];
+    static getDecoratorUtils(): {
+        getCurrentOperation(classInstance: any): OperationTreeContext | undefined;
+    };
+}
+export declare type CanGetCurrentOperation<TOperationHookProviders extends OperationHookProvider[]> = {
+    getCurrentOperation(classInstance: ThisParameterType<FuncFromHookProviders<TOperationHookProviders>>): ContextFromHookProviders<TOperationHookProviders> | undefined;
+};
+export {};

package/dist/engage/utils/operationTracking/OperationTree.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationTree = void 0;
+class OperationTree {
+    static getTryCatchFinallyHook(_ctx) {
+        return this;
+    }
+    static getPriority() {
+        return -1;
+    }
+    static onTry(ctx) {
+        const parent = this.getCurrentOperationFromContext(ctx);
+        ctx.sharedContext = parent?.sharedContext || {};
+        ctx.parent = parent;
+        this.setCurrentOperationToContext(ctx, ctx);
+    }
+    static onFinally(ctx) {
+        return () => {
+            this.setCurrentOperationToContext(ctx, ctx.parent);
+        };
+    }
+    static getCurrentOperationFromTrackedClassInstance(classInstance) {
+        return classInstance?.currentOperation;
+    }
+    static getCurrentOperationFromContext(ctx) {
+        return ctx.funcThis.currentOperation;
+    }
+    static setCurrentOperationToContext(ctx, newCurrentOperation) {
+        ctx.funcThis.currentOperation = newCurrentOperation;
+    }
+    static getOperationsStack(ctx) {
+        const stack = [];
+        let current = ctx;
+        while (current) {
+            stack.unshift(current);
+            current = current.parent;
+        }
+        return stack;
+    }
+    static getDecoratorUtils() {
+        return {
+            getCurrentOperation(classInstance) {
+                return classInstance?.currentOperation;
+            }
+        };
+    }
+}
+exports.OperationTree = OperationTree;
+//# sourceMappingURL=OperationTree.js.map

package/dist/engage/utils/operationTracking/OperationTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationTree.js","sourceRoot":"","sources":["../../../../src/engage/utils/operationTracking/OperationTree.ts"],"names":[],"mappings":";;;AAWA,MAAa,aAAa;IACxB,MAAM,CAAC,sBAAsB,CAAC,IAA0B;QAEtD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,CAAC,WAAW;QAChB,OAAO,CAAC,CAAC,CAAA;IACX,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAyB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,8BAA8B,CAAC,GAAG,CAAC,CAAA;QACvD,GAAG,CAAC,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,EAAE,CAAA;QAC/C,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;QACnB,IAAI,CAAC,4BAA4B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC7C,CAAC;IACD,MAAM,CAAC,SAAS,CAAC,GAAyB;QACxC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,4BAA4B,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QACpD,CAAC,CAAA;IACH,CAAC;IACD,MAAM,CAAC,2CAA2C,CAAiB,aAA6B;QAE9F,OAAQ,aAAqB,EAAE,gBAAwC,CAAA;IACzE,CAAC;IACD,MAAM,CAAC,8BAA8B,CAAC,GAAyB;QAC7D,OAAO,GAAG,CAAC,QAAQ,CAAC,gBAAwC,CAAA;IAC9D,CAAC;IACS,MAAM,CAAC,4BAA4B,CAC3C,GAAyB,EACzB,mBAAqD;QAErD,GAAG,CAAC,QAAQ,CAAC,gBAAgB,GAAG,mBAAmB,CAAA;IACrD,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAwC,GAAa;QAC5E,MAAM,KAAK,GAAe,EAAE,CAAA;QAC5B,IAAI,OAAO,GAAG,GAAG,CAAA;QACjB,OAAO,OAAO,EAAE;YACd,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAEtB,OAAO,GAAG,OAAO,CAAC,MAAkB,CAAA;SACrC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,CAAC,iBAAiB;QACtB,OAAO;YAEL,mBAAmB,CAAC,aAAkB;gBACpC,OAAO,aAAa,EAAE,gBAAgB,CAAA;YACxC,CAAC;SACF,CAAA;IACH,CAAC;CACF;AApDD,sCAoDC"}

package/dist/engage/utils/operationTracking/TrackedError.d.ts

@@ -0,0 +1,6 @@
+import { TryCatchFinallyContext } from './wrapTryCatchFinallyPromisable';
+export interface TrackedError<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> extends Error {
+    underlyingError?: unknown;
+    trackedContext?: TContext;
+    [key: string]: any;
+}

package/dist/engage/utils/operationTracking/TrackedError.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TrackedError.js.map

package/dist/engage/utils/operationTracking/TrackedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackedError.js","sourceRoot":"","sources":["../../../../src/engage/utils/operationTracking/TrackedError.ts"],"names":[],"mappings":""}

package/dist/engage/utils/operationTracking/index.d.ts

@@ -0,0 +1,10 @@
+export * from './wrapTryCatchFinallyPromisable';
+export * from './OperationDecorator';
+export * from './GenericMethodDecorator';
+export * from './OperationTree';
+export * from './OperationFinallyHooks';
+export * from './OperationLogger';
+export * from './OperationDuration';
+export * from './OperationStats';
+export * from './OperationErrorHandler';
+export * from './TrackedError';

package/dist/engage/utils/operationTracking/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./wrapTryCatchFinallyPromisable"), exports);
+__exportStar(require("./OperationDecorator"), exports);
+__exportStar(require("./GenericMethodDecorator"), exports);
+__exportStar(require("./OperationTree"), exports);
+__exportStar(require("./OperationFinallyHooks"), exports);
+__exportStar(require("./OperationLogger"), exports);
+__exportStar(require("./OperationDuration"), exports);
+__exportStar(require("./OperationStats"), exports);
+__exportStar(require("./OperationErrorHandler"), exports);
+__exportStar(require("./TrackedError"), exports);
+//# sourceMappingURL=index.js.map

package/dist/engage/utils/operationTracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engage/utils/operationTracking/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,kEAA+C;AAC/C,uDAAoC;AACpC,2DAAwC;AACxC,kDAA+B;AAC/B,0DAAuC;AACvC,oDAAiC;AACjC,sDAAmC;AACnC,mDAAgC;AAChC,0DAAuC;AACvC,iDAA8B"}

package/dist/engage/utils/operationTracking/wrapTryCatchFinallyPromisable.d.ts

@@ -0,0 +1,21 @@
+export interface TryCatchFinallyContext<TFunc extends (this: any, ...args: any[]) => any = (this: any, ...args: any[]) => any> {
+    func: TFunc;
+    funcArgs: Parameters<TFunc>;
+    funcThis: ThisParameterType<TFunc>;
+    result?: ReturnType<TFunc> | Awaited<ReturnType<TFunc>>;
+    error?: unknown;
+    stage: 'try' | 'success' | 'catch' | 'finally';
+}
+export interface TryCatchFinallyHook<TContext extends TryCatchFinallyContext<any> = TryCatchFinallyContext<(...args: any[]) => any>> {
+    onTry?(ctx: TContext): void | (() => void);
+    onSuccess?(ctx: TContext): void | (() => void);
+    onCatch?(ctx: TContext): void | (() => void);
+    onFinally?(ctx: TContext): void | (() => void);
+    getPriority?(ctx: TContext): number | void;
+}
+export declare type FuncFromTryCatchFinallyContext<TWrapContext extends TryCatchFinallyContext<any>> = TWrapContext extends TryCatchFinallyContext<infer TFunc> ? TFunc : never;
+export declare const DefaultHookPriority = 0;
+export declare function wrapTryCatchFinallyPromisable<TFunc extends (...args: any[]) => any, TContext extends TryCatchFinallyContext<TFunc> = TryCatchFinallyContext<TFunc>, THooks extends TryCatchFinallyHook<TContext>[] = TryCatchFinallyHook<TContext>[]>(func: TFunc, getHooks: (ctx: TContext) => THooks, onHookError?: (e: unknown) => unknown | undefined): TFunc;
+export declare type Awaited<T> = T extends null | undefined ? T : T extends object & {
+    then(onfulfilled: infer F, ...args: infer _): any;
+} ? F extends (value: infer V, ...args: infer _) => any ? Awaited<V> : never : T;

package/dist/engage/utils/operationTracking/wrapTryCatchFinallyPromisable.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapTryCatchFinallyPromisable = exports.DefaultHookPriority = void 0;
+exports.DefaultHookPriority = 0;
+function wrapTryCatchFinallyPromisable(func, getHooks, onHookError) {
+    function forEachHook(hooks, inContext, doThis) {
+        const prioritizedHooks = Object.values(hooks).sort((h1, h2) => {
+            const p1 = h1.getPriority ? h1.getPriority(inContext) : exports.DefaultHookPriority;
+            const p2 = h2.getPriority ? h2.getPriority(inContext) : exports.DefaultHookPriority;
+            return (p1 === undefined ? exports.DefaultHookPriority : p1) - (p2 === undefined ? exports.DefaultHookPriority : p2);
+        });
+        const postCallbacks = [];
+        for (const hook of prioritizedHooks) {
+            try {
+                const callback = doThis(hook);
+                if (callback instanceof Function)
+                    postCallbacks.push(callback);
+            }
+            catch (hookError) {
+                let errorToThrow = hookError;
+                if (onHookError)
+                    errorToThrow = onHookError(errorToThrow);
+                if (errorToThrow)
+                    throw errorToThrow;
+            }
+        }
+        for (const callback of postCallbacks.reverse()) {
+            try {
+                callback();
+            }
+            catch (callbackError) {
+                let errorToThrow = callbackError;
+                if (onHookError)
+                    errorToThrow = onHookError(errorToThrow);
+                if (errorToThrow)
+                    throw errorToThrow;
+            }
+        }
+    }
+    return function (...funcArgs) {
+        const ctx = {
+            funcArgs: funcArgs,
+            funcThis: this,
+            func,
+            stage: 'try'
+        };
+        let isPromise = false;
+        const hooks = getHooks(ctx);
+        try {
+            forEachHook(hooks, ctx, (hook) => hook.onTry?.(ctx));
+            const funcResMayBePromise = func.apply(this, funcArgs);
+            isPromise = isValuePromise(funcResMayBePromise);
+            if (isPromise) {
+                const wrappedPromise = (async () => {
+                    try {
+                        ctx.result = await funcResMayBePromise;
+                        ctx.stage = 'success';
+                        forEachHook(hooks, ctx, (hook) => hook.onSuccess?.(ctx));
+                    }
+                    catch (error) {
+                        ctx.stage = 'catch';
+                        ctx.error = error;
+                        forEachHook(hooks, ctx, (hook) => hook.onCatch?.(ctx));
+                        if (ctx.error)
+                            throw ctx.error;
+                    }
+                    finally {
+                        ctx.stage = 'finally';
+                        forEachHook(hooks, ctx, (hook) => hook.onFinally?.(ctx));
+                    }
+                    return ctx.result;
+                })();
+                return wrappedPromise;
+            }
+            ctx.result = funcResMayBePromise;
+            ctx.stage = 'success';
+            forEachHook(hooks, ctx, (hook) => hook.onSuccess?.(ctx));
+        }
+        catch (error) {
+            ctx.stage = 'catch';
+            ctx.error = error;
+            forEachHook(hooks, ctx, (hook) => hook.onCatch?.(ctx));
+            if (ctx.error)
+                throw ctx.error;
+        }
+        finally {
+            if (!isPromise) {
+                ctx.stage = 'finally';
+                forEachHook(hooks, ctx, (hook) => hook.onFinally?.(ctx));
+            }
+        }
+        return ctx.result;
+    };
+}
+exports.wrapTryCatchFinallyPromisable = wrapTryCatchFinallyPromisable;
+function isValuePromise(obj) {
+    return obj instanceof Object && 'then' in obj && typeof obj.then === 'function';
+}
+//# sourceMappingURL=wrapTryCatchFinallyPromisable.js.map

package/dist/engage/utils/operationTracking/wrapTryCatchFinallyPromisable.js.map

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