@segment/action-destinations 3.363.0 → 3.363.1-node-engine-upgrade.1

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

@@ -0,0 +1,9 @@
+export * from './EngageActionPerformer';
+export * from './MessageSendPerformer';
+export * from './operationTracking';
+export * from './EngageLogger';
+export * from './EngageStats';
+export * from './track';
+export * from './isDestinationActionService';
+export * from './ResponseError';
+export * from './IntegrationErrorWrapper';

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

@@ -0,0 +1,22 @@
+"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("./EngageActionPerformer"), exports);
+__exportStar(require("./MessageSendPerformer"), exports);
+__exportStar(require("./operationTracking"), exports);
+__exportStar(require("./EngageLogger"), exports);
+__exportStar(require("./EngageStats"), exports);
+__exportStar(require("./track"), exports);
+__exportStar(require("./isDestinationActionService"), exports);
+__exportStar(require("./ResponseError"), exports);
+__exportStar(require("./IntegrationErrorWrapper"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/destinations/engage/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0DAAuC;AACvC,yDAAsC;AACtC,sDAAmC;AACnC,iDAA8B;AAC9B,gDAA6B;AAC7B,0CAAuB;AACvB,+DAA4C;AAC5C,kDAA+B;AAC/B,4DAAyC"}

package/dist/destinations/engage/utils/isDestinationActionService.d.ts

@@ -0,0 +1 @@
+export declare function isDestinationActionService(): boolean;

package/dist/destinations/engage/utils/isDestinationActionService.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDestinationActionService = void 0;
+function isDestinationActionService() {
+    return (process.env.DESTINATIONS_ACTION_SERVICE === 'true' || process.env.SERVICE_NAME === 'destination-actions-service');
+}
+exports.isDestinationActionService = isDestinationActionService;
+//# sourceMappingURL=isDestinationActionService.js.map

package/dist/destinations/engage/utils/isDestinationActionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDestinationActionService.js","sourceRoot":"","sources":["../../../../src/destinations/engage/utils/isDestinationActionService.ts"],"names":[],"mappings":";;;AAAA,SAAgB,0BAA0B;IAExC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,6BAA6B,CACjH,CAAA;AACH,CAAC;AALD,gEAKC"}

package/dist/destinations/engage/utils/isRetryableError.d.ts

@@ -0,0 +1,2 @@
+export declare function isRetryableError(error: any): boolean;
+export declare function isRetryableStatus(status?: number): boolean;

package/dist/destinations/engage/utils/isRetryableError.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRetryableStatus = exports.isRetryableError = void 0;
+const ResponseError_1 = require("./ResponseError");
+function isRetryableError(error) {
+    return isRetryableStatus(ResponseError_1.getErrorDetails(error).status);
+}
+exports.isRetryableError = isRetryableError;
+function isRetryableStatus(status) {
+    let result = true;
+    const statusGroup = status === undefined ? undefined : Math.floor(status / 100);
+    switch (statusGroup) {
+        case 2:
+        case 4:
+            result = false;
+            break;
+        default:
+            result = true;
+    }
+    switch (status) {
+        case 408:
+        case 423:
+        case 429:
+            result = true;
+            break;
+        case 501:
+            result = false;
+            break;
+    }
+    return result;
+}
+exports.isRetryableStatus = isRetryableStatus;
+//# sourceMappingURL=isRetryableError.js.map

package/dist/destinations/engage/utils/isRetryableError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isRetryableError.js","sourceRoot":"","sources":["../../../../src/destinations/engage/utils/isRetryableError.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAGjD,SAAgB,gBAAgB,CAAC,KAAU;IACzC,OAAO,iBAAiB,CAAC,+BAAe,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAA;AACzD,CAAC;AAFD,4CAEC;AAED,SAAgB,iBAAiB,CAAC,MAAe;IAE/C,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,MAAM,WAAW,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;IAC/E,QAAQ,WAAW,EAAE;QACnB,KAAK,CAAC,CAAC;QACP,KAAK,CAAC;YACJ,MAAM,GAAG,KAAK,CAAA;YACd,MAAK;QACP;YAEE,MAAM,GAAG,IAAI,CAAA;KAChB;IACD,QAAQ,MAAM,EAAE;QACd,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,MAAM,GAAG,IAAI,CAAA;YACb,MAAK;QACP,KAAK,GAAG;YACN,MAAM,GAAG,KAAK,CAAA;YACd,MAAK;KAGR;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AA1BD,8CA0BC"}

package/dist/destinations/engage/utils/operationTracking/GenericMethodDecorator.d.ts

@@ -0,0 +1 @@
+export declare type GenericMethodDecorator<TFunc extends (this: any, ...args: any[]) => any = (this: any, ...args: any) => any> = (target: ThisParameterType<TFunc>, propertyKey: string, descriptor: TypedPropertyDescriptor<TFunc>) => TypedPropertyDescriptor<TFunc> | void;

package/dist/destinations/engage/utils/operationTracking/GenericMethodDecorator.js

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

package/dist/destinations/engage/utils/operationTracking/GenericMethodDecorator.js.map

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

package/dist/destinations/engage/utils/operationTracking/OperationDecorator.d.ts

@@ -0,0 +1,46 @@
+import { GenericMethodDecorator } from './GenericMethodDecorator';
+import { OperationDuration } from './OperationDuration';
+import { OperationErrorHandler } from './OperationErrorHandler';
+import { OperationFinallyHooks } from './OperationFinallyHooks';
+import { OperationTree } from './OperationTree';
+import { FuncFromTryCatchFinallyContext, TryCatchFinallyContext, TryCatchFinallyHook } from './wrapTryCatchFinallyPromisable';
+export interface DecoratorArgs {
+    operation?: string;
+    [key: string]: any;
+}
+export declare type OperationHookContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext, TDecoratorArgs extends DecoratorArgs = DecoratorArgs> = TContext & {
+    decoratorArgs?: TDecoratorArgs;
+};
+export interface OperationHookProvider<TContext extends OperationHookContext = OperationHookContext, TDecoratorUtils = {}> {
+    getTryCatchFinallyHook(ctx: TContext): TryCatchFinallyHook<TContext>;
+    getDecoratorUtils?(): TDecoratorUtils;
+}
+export declare type UnionToIntersection<TUnion> = (TUnion extends any ? (k: TUnion) => void : never) extends (k: infer I) => void ? I : never;
+export declare type ContextFromHookProviders<TProviders extends OperationHookProvider[]> = TProviders extends OperationHookProvider<infer TContext>[] ? UnionToIntersection<TContext> : TryCatchFinallyContext;
+export declare type DecoratorArgsFromContext<TContext extends TryCatchFinallyContext> = TContext extends {
+    decoratorArgs?: infer TDecoratorArgs;
+} ? TDecoratorArgs : DecoratorArgs;
+export declare type DecoratorArgsFromHookProviders<TProviders extends OperationHookProvider[]> = DecoratorArgsFromContext<ContextFromHookProviders<TProviders>>;
+export declare type DecoratorUtilsFromHookProviders<TProviders extends OperationHookProvider[]> = TProviders extends OperationHookProvider<any, infer TDecoratorUtils>[] ? UnionToIntersection<TDecoratorUtils> : {};
+export declare type FuncFromHookProviders<TProviders extends OperationHookProvider[]> = FuncFromTryCatchFinallyContext<ContextFromHookProviders<TProviders>>;
+export declare class OperationDecorator {
+    static createDecoratorFactory<TOperationHookProviders extends OperationHookProvider[]>(...hookProviders: TOperationHookProviders): ((decoratorArgs?: DecoratorArgsFromHookProviders<TOperationHookProviders>) => GenericMethodDecorator<FuncFromHookProviders<TOperationHookProviders>>) & DecoratorUtilsFromHookProviders<TOperationHookProviders> & {
+        _contextType: ContextFromHookProviders<TOperationHookProviders>;
+    };
+    static createDecoratorFactoryWithDefault<TOperationHookProviders extends OperationHookProvider[]>(...customHookProviders: TOperationHookProviders): ((decoratorArgs?: DecoratorArgsFromContext<ContextFromHookProviders<[typeof OperationErrorHandler, typeof OperationTree, typeof OperationDuration, typeof OperationFinallyHooks, ...TOperationHookProviders]>> | undefined) => GenericMethodDecorator<FuncFromTryCatchFinallyContext<ContextFromHookProviders<[typeof OperationErrorHandler, typeof OperationTree, typeof OperationDuration, typeof OperationFinallyHooks, ...TOperationHookProviders]>>>) & DecoratorUtilsFromHookProviders<[typeof OperationErrorHandler, typeof OperationTree, typeof OperationDuration, typeof OperationFinallyHooks, ...TOperationHookProviders]> & {
+        _contextType: ContextFromHookProviders<[typeof OperationErrorHandler, typeof OperationTree, typeof OperationDuration, typeof OperationFinallyHooks, ...TOperationHookProviders]>;
+    };
+    static getOperationName<TContext extends TryCatchFinallyContext>(ctx: TContext): string | undefined;
+}
+export declare type OperationDecoratorContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TContext & {
+    decoratorOf?: {
+        classProto: any;
+        methodName: string;
+        descriptor: TypedPropertyDescriptor<any>;
+        originalMethod: FuncFromTryCatchFinallyContext<TContext>;
+    };
+    decoratorArgs?: DecoratorArgsFromContext<TContext> & DecoratorArgs;
+};
+export declare type ContextFromDecorator<TDecorator> = TDecorator extends {
+    _contextType: infer TContext;
+} ? TContext : never;

package/dist/destinations/engage/utils/operationTracking/OperationDecorator.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationDecorator = void 0;
+const OperationDuration_1 = require("./OperationDuration");
+const OperationErrorHandler_1 = require("./OperationErrorHandler");
+const OperationFinallyHooks_1 = require("./OperationFinallyHooks");
+const OperationTree_1 = require("./OperationTree");
+const wrapTryCatchFinallyPromisable_1 = require("./wrapTryCatchFinallyPromisable");
+class OperationDecorator {
+    static createDecoratorFactory(...hookProviders) {
+        const decorator = (decoratorArgs) => {
+            return function (classProto, methodName, descriptor) {
+                const originalMethod = descriptor.value;
+                if (!(originalMethod instanceof Function))
+                    throw new Error('Track decorator can only be applied to class methods');
+                const decoratorOf = {
+                    classProto,
+                    methodName,
+                    descriptor,
+                    originalMethod
+                };
+                descriptor.value = wrapTryCatchFinallyPromisable_1.wrapTryCatchFinallyPromisable(originalMethod, (ctx) => {
+                    ctx.decoratorOf = decoratorOf;
+                    ctx.decoratorArgs = decoratorArgs;
+                    return hookProviders.map((h) => h.getTryCatchFinallyHook(ctx));
+                });
+            };
+        };
+        const decoratorUtils = {};
+        for (const hookProvider of hookProviders) {
+            Object.assign(decoratorUtils, hookProvider.getDecoratorUtils?.() || {});
+        }
+        return Object.assign(decorator, decoratorUtils);
+    }
+    static createDecoratorFactoryWithDefault(...customHookProviders) {
+        return OperationDecorator.createDecoratorFactory(OperationErrorHandler_1.OperationErrorHandler, OperationTree_1.OperationTree, OperationDuration_1.OperationDuration, OperationFinallyHooks_1.OperationFinallyHooks, ...customHookProviders);
+    }
+    static getOperationName(ctx) {
+        const ctxDecorated = ctx;
+        return (ctxDecorated.decoratorArgs?.operation ||
+            ctxDecorated.decoratorOf?.methodName ||
+            ctxDecorated.decoratorOf?.originalMethod?.name);
+    }
+}
+exports.OperationDecorator = OperationDecorator;
+//# sourceMappingURL=OperationDecorator.js.map

package/dist/destinations/engage/utils/operationTracking/OperationDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationDecorator.js","sourceRoot":"","sources":["../../../../../src/destinations/engage/utils/operationTracking/OperationDecorator.ts"],"names":[],"mappings":";;;AAEA,2DAAuD;AACvD,mEAA+D;AAC/D,mEAA+D;AAC/D,mDAA+C;AAC/C,mFAKwC;AAmFxC,MAAa,kBAAkB;IAO7B,MAAM,CAAC,sBAAsB,CAC3B,GAAG,aAAsC;QAUzC,MAAM,SAAS,GAAG,CAAC,aAA8B,EAAiC,EAAE;YAClF,OAAO,UAAU,UAAU,EAAE,UAAU,EAAE,UAAU;gBACjD,MAAM,cAAc,GAAG,UAAU,CAAC,KAAc,CAAA;gBAChD,IAAI,CAAC,CAAC,cAAc,YAAY,QAAQ,CAAC;oBACvC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;gBAEzE,MAAM,WAAW,GAA6C;oBAC5D,UAAU;oBACV,UAAU;oBACV,UAAU;oBACV,cAAc;iBACf,CAAA;gBACD,UAAU,CAAC,KAAK,GAAG,6DAA6B,CAAC,cAAc,EAAE,CAAC,GAA8B,EAAE,EAAE;oBAClG,GAAG,CAAC,WAAW,GAAG,WAAW,CAAA;oBAC7B,GAAG,CAAC,aAAa,GAAG,aAAa,CAAA;oBACjC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAA;gBAChE,CAAC,CAAC,CAAA;YACJ,CAAC,CAAA;QACH,CAAC,CAAA;QACD,MAAM,cAAc,GAAG,EAAE,CAAA;QACzB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;YACxC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;SACxE;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAQ,CAAA;IACxD,CAAC;IAWD,MAAM,CAAC,iCAAiC,CACtC,GAAG,mBAA4C;QAE/C,OAAO,kBAAkB,CAAC,sBAAsB,CAC9C,6CAAqB,EACrB,6BAAa,EACb,qCAAiB,EACjB,6CAAqB,EACrB,GAAG,mBAAmB,CACvB,CAAA;IACH,CAAC;IAED,MAAM,CAAC,gBAAgB,CAA0C,GAAa;QAC5E,MAAM,YAAY,GAAG,GAAgC,CAAA;QACrD,OAAO,CACL,YAAY,CAAC,aAAa,EAAE,SAAS;YACrC,YAAY,CAAC,WAAW,EAAE,UAAU;YACpC,YAAY,CAAC,WAAW,EAAE,cAAc,EAAE,IAAI,CAC/C,CAAA;IACH,CAAC;CACF;AA1ED,gDA0EC"}

package/dist/destinations/engage/utils/operationTracking/OperationDuration.d.ts

@@ -0,0 +1,12 @@
+import { TryCatchFinallyContext, TryCatchFinallyHook } from './wrapTryCatchFinallyPromisable';
+export declare type OperationDurationContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TContext & {
+    start?: number;
+    duration?: number;
+};
+export declare class OperationDuration {
+    static getTryCatchFinallyHook(_ctx: OperationDurationContext): TryCatchFinallyHook<OperationDurationContext>;
+    static getPriority(): number;
+    static onTry(ctx: OperationDurationContext): void;
+    static onFinally(ctx: OperationDurationContext): void;
+    static getDuration<TContext extends OperationDurationContext>(ctx: TContext): number | undefined;
+}

package/dist/destinations/engage/utils/operationTracking/OperationDuration.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationDuration = void 0;
+class OperationDuration {
+    static getTryCatchFinallyHook(_ctx) {
+        return this;
+    }
+    static getPriority() {
+        return -1000;
+    }
+    static onTry(ctx) {
+        ctx.start = Date.now();
+    }
+    static onFinally(ctx) {
+        if (ctx.start !== undefined)
+            ctx.duration = Date.now() - ctx.start;
+    }
+    static getDuration(ctx) {
+        return ctx.duration;
+    }
+}
+exports.OperationDuration = OperationDuration;
+//# sourceMappingURL=OperationDuration.js.map

package/dist/destinations/engage/utils/operationTracking/OperationDuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationDuration.js","sourceRoot":"","sources":["../../../../../src/destinations/engage/utils/operationTracking/OperationDuration.ts"],"names":[],"mappings":";;;AAOA,MAAa,iBAAiB;IAC5B,MAAM,CAAC,sBAAsB,CAAC,IAA8B;QAC1D,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,CAAC,WAAW;QAChB,OAAO,CAAC,IAAI,CAAA;IACd,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAA6B;QACxC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAA6B;QAC5C,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,CAAA;IACpE,CAAC;IACD,MAAM,CAAC,WAAW,CAA4C,GAAa;QACzE,OAAO,GAAG,CAAC,QAAQ,CAAA;IACrB,CAAC;CACF;AAjBD,8CAiBC"}

package/dist/destinations/engage/utils/operationTracking/OperationErrorHandler.d.ts

@@ -0,0 +1,12 @@
+import { TrackedError } from './TrackedError';
+import { TryCatchFinallyContext, TryCatchFinallyHook } from './wrapTryCatchFinallyPromisable';
+export declare type OperationErrorHandlerContext<TContext extends TryCatchFinallyContext = TryCatchFinallyContext> = TContext & {
+    decoratorArgs?: {
+        onError?: (ctx: OperationErrorHandlerContext<TContext>) => void;
+    };
+};
+export declare class OperationErrorHandler {
+    static getTryCatchFinallyHook(_ctx: OperationErrorHandlerContext): TryCatchFinallyHook<OperationErrorHandlerContext>;
+    static onCatch(ctx: OperationErrorHandlerContext): void;
+    static wrap<TContext extends OperationErrorHandlerContext = OperationErrorHandlerContext>(originalError: unknown, getWrapper: (e: unknown) => unknown | undefined, ctx?: TContext): TrackedError<TryCatchFinallyContext<(this: any, ...args: any[]) => any>> | undefined;
+}

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

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationErrorHandler = void 0;
+class OperationErrorHandler {
+    static getTryCatchFinallyHook(_ctx) {
+        return this;
+    }
+    static onCatch(ctx) {
+        const dArgs = ctx.decoratorArgs;
+        ctx.error = this.wrap(ctx.error, () => {
+            dArgs?.onError?.apply(this, [ctx]);
+            return ctx.error;
+        }, ctx);
+    }
+    static wrap(originalError, getWrapper, ctx) {
+        const wrapper = getWrapper(originalError);
+        if (wrapper && originalError !== wrapper)
+            wrapper.underlyingError = originalError;
+        const trackedError = wrapper;
+        if (!trackedError)
+            return;
+        if (!ctx)
+            return;
+        if (!trackedError.trackedContext)
+            trackedError.trackedContext = ctx;
+        const trackedContextProp = Object.getOwnPropertyDescriptor(trackedError, 'trackedContext');
+        if (trackedContextProp?.enumerable) {
+            trackedContextProp.enumerable = false;
+            Object.defineProperty(trackedError, 'trackedContext', trackedContextProp);
+        }
+        return wrapper;
+    }
+}
+exports.OperationErrorHandler = OperationErrorHandler;
+//# sourceMappingURL=OperationErrorHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OperationErrorHandler.js","sourceRoot":"","sources":["../../../../../src/destinations/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/destinations/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/destinations/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/destinations/engage/utils/operationTracking/OperationFinallyHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationFinallyHooks.js","sourceRoot":"","sources":["../../../../../src/destinations/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/destinations/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/destinations/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/destinations/engage/utils/operationTracking/OperationLogger.js.map

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

package/dist/destinations/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;
+}