@segment/actions-shared 1.97.0 → 1.98.0

package/dist/engage/utils/MessageSendPerformer.js

@@ -0,0 +1,211 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageSendPerformer = exports.SendabilityStatus = void 0;
+const EngageActionPerformer_1 = require("./EngageActionPerformer");
+const isRetryableError_1 = require("./isRetryableError");
+const AggregateError_1 = require("./AggregateError");
+const getProfileApiEndpoint_1 = require("./getProfileApiEndpoint");
+const track_1 = require("./track");
+const actions_core_1 = require("@segment/actions-core");
+var SendabilityStatus;
+(function (SendabilityStatus) {
+    SendabilityStatus["ShouldSend"] = "should_send";
+    SendabilityStatus["NotSubscribed"] = "not_subscribed";
+    SendabilityStatus["NoSupportedExternalIds"] = "no_supported_ids";
+    SendabilityStatus["InvalidSubscriptionStatus"] = "invalid_subscription_status";
+    SendabilityStatus["SendDisabled"] = "send_disabled";
+})(SendabilityStatus = exports.SendabilityStatus || (exports.SendabilityStatus = {}));
+class MessageSendPerformer extends EngageActionPerformer_1.EngageActionPerformer {
+    async doPerform() {
+        const res = this.forAllRecepients((recepient) => this.sendToRecepient(recepient));
+        if (this.executeInput.features) {
+            this.logInfo('Feature flags:' + JSON.stringify(this.executeInput.features));
+        }
+        this.statsEventDeliveryTs();
+        return res;
+    }
+    getStaticMembersOfThisClass() {
+        return this.constructor;
+    }
+    isExternalIdSubscribed(extId) {
+        const staticMems = this.getStaticMembersOfThisClass();
+        const subStatus = extId.subscriptionStatus?.toString()?.toLowerCase();
+        const isOptOutModel = this.payload.sendBasedOnOptOut ? true : false;
+        if (!subStatus)
+            return isOptOutModel;
+        if (staticMems.sendableStatuses.includes(subStatus))
+            return true;
+        if (staticMems.nonSendableStatuses.includes(subStatus))
+            return false;
+        return undefined;
+    }
+    convertSubscriptionStatusText(subVal) {
+        if (subVal == undefined) {
+            return 'unknown';
+        }
+        if (subVal == '') {
+            return 'did_not_subscribe';
+        }
+        return subVal;
+    }
+    getSendabilityPayload() {
+        if (!this.payload.send) {
+            return { sendabilityStatus: SendabilityStatus.SendDisabled };
+        }
+        const supportedExtIdsWithSub = this.payload.externalIds
+            ?.filter((extId) => this.isSupportedExternalId(extId))
+            .map((extId) => ({
+            extId,
+            isSubscribed: this.isExternalIdSubscribed(extId)
+        }));
+        this.payload.sendBasedOnOptOut
+            ? this.currentOperation?.tags.push('SubscriptionOptOutType:' + true)
+            : this.currentOperation?.tags.push('SubscriptionOptOutType:' + false);
+        if (!supportedExtIdsWithSub || !supportedExtIdsWithSub.length)
+            return {
+                sendabilityStatus: SendabilityStatus.NoSupportedExternalIds
+            };
+        this.currentOperation?.tags.push('subscription_status:' + this.convertSubscriptionStatusText(supportedExtIdsWithSub[0]?.extId?.subscriptionStatus));
+        const invalidSubStatuses = supportedExtIdsWithSub.filter((e) => e.isSubscribed === undefined).map((e) => e.extId);
+        const shouldSendExtIds = supportedExtIdsWithSub.filter((e) => e.isSubscribed === true).map((e) => e.extId);
+        if (!shouldSendExtIds.length) {
+            return invalidSubStatuses.length == 0
+                ? {
+                    sendabilityStatus: SendabilityStatus.NotSubscribed
+                }
+                : {
+                    sendabilityStatus: SendabilityStatus.InvalidSubscriptionStatus,
+                    invalid: invalidSubStatuses
+                };
+        }
+        if (shouldSendExtIds.length) {
+            const subWithIds = shouldSendExtIds.filter((extId) => extId.id);
+            return {
+                sendabilityStatus: subWithIds.length > 0 ? SendabilityStatus.ShouldSend : SendabilityStatus.NoSupportedExternalIds,
+                recepients: subWithIds.length > 0 ? subWithIds : shouldSendExtIds,
+                invalid: invalidSubStatuses
+            };
+        }
+        if (invalidSubStatuses.length)
+            return {
+                sendabilityStatus: SendabilityStatus.InvalidSubscriptionStatus,
+                invalid: invalidSubStatuses
+            };
+        return {
+            sendabilityStatus: SendabilityStatus.NoSupportedExternalIds,
+            recepients: supportedExtIdsWithSub.map((e) => e.extId)
+        };
+    }
+    getRecepients() {
+        const sendabilityPayload = this.getSendabilityPayload();
+        const shouldSend = sendabilityPayload.sendabilityStatus === SendabilityStatus.ShouldSend;
+        this.currentOperation?.tags.push('sendability_status:' + sendabilityPayload.sendabilityStatus);
+        this.currentOperation?.logs.push(shouldSend
+            ? `Sending message to recepients (${sendabilityPayload.recepients?.length}): ${sendabilityPayload.recepients
+                ?.map((r) => this.redactPii(r.id))
+                .join(', ')}})`
+            : `Not sending message because ${sendabilityPayload.sendabilityStatus?.toUpperCase()}. Recepients (${sendabilityPayload.recepients?.length})`);
+        return sendabilityPayload.sendabilityStatus == SendabilityStatus.ShouldSend
+            ? sendabilityPayload.recepients || []
+            : [];
+    }
+    beforePerform() {
+        if (!this.settings.region && this.getDefaultSettingsRegion) {
+            this.settings.region = this.getDefaultSettingsRegion();
+        }
+        Object.assign(this.logDetails, {
+            externalIds: this.payload.externalIds?.map((eid) => ({ ...eid, id: this.redactPii(eid.id) })),
+            shouldSend: this.payload.send,
+            settings_region: this.settings.region,
+            sourceId: this.settings.sourceId,
+            spaceId: this.settings.spaceId,
+            messageId: this.executeInput['rawData']?.messageId,
+            channelType: this.getChannelType()
+        });
+        if ('userId' in this.payload)
+            this.logDetails.userId = this.payload.userId;
+        if (this.executeInput.statsContext?.tags) {
+            for (const item of this.executeInput.statsContext?.tags) {
+                if (item.includes('delivery_attempt') || item.includes('replay')) {
+                    this.logDetails[item.split(':')[0]] = item.split(':')[1];
+                }
+            }
+        }
+    }
+    statsEventDeliveryTs() {
+        const eventOccurredTS = this.payload?.eventOccurredTS;
+        if (typeof eventOccurredTS === 'number') {
+            this.statsHistogram('eventDeliveryTS', Date.now() - new Date(eventOccurredTS).getTime());
+        }
+    }
+    async forAllRecepients(sendToRecepient) {
+        const recepients = this.getRecepients();
+        await this.beforeSend?.(recepients);
+        const results = (await Promise.allSettled(recepients.map((recepient) => sendToRecepient(recepient)))).map((r, i) => ({
+            recepient: recepients[i],
+            status: r.status,
+            ...(r.status === 'rejected' ? { error: r.reason } : { result: r.value })
+        }));
+        return this.aggregateSendResults(results);
+    }
+    aggregateSendResults(sendResults) {
+        if (!sendResults.length) {
+            return;
+        }
+        if (sendResults.length === 1) {
+            if (sendResults[0].status === 'rejected') {
+                throw sendResults[0].error;
+            }
+            else {
+                return sendResults[0].result;
+            }
+        }
+        const fulfilled = sendResults.filter((sr) => sr.status === 'fulfilled');
+        if (fulfilled.length) {
+            return fulfilled.map((sr) => sr.result);
+        }
+        const rejected = sendResults.filter((sr) => sr.status === 'rejected');
+        if (rejected.every((r) => isRetryableError_1.isRetryableError(r.error))) {
+            throw AggregateError_1.AggregateError.create({
+                errors: rejected.map((r) => r.error),
+                message: (msg) => 'Failed to send to all subscribed recepients (retryable):' + msg
+            });
+        }
+        const firstNonRetryable = rejected.find((r) => !isRetryableError_1.isRetryableError(r.error))?.error;
+        throw AggregateError_1.AggregateError.create({
+            errors: rejected.map((r) => r.error),
+            takeCodeAndStatusFromError: firstNonRetryable,
+            message: (msg) => 'Failed to send to all subscribed recepients (non-retryable):' + msg
+        });
+    }
+    async getProfileTraits() {
+        if (this.payload.traitEnrichment)
+            return this.payload?.traits || {};
+        if (!this.payload.userId) {
+            throw new actions_core_1.PayloadValidationError('No userId provided and no traits provided');
+        }
+        const endpoint = getProfileApiEndpoint_1.getProfileApiEndpoint(this.settings.profileApiEnvironment, this.settings.region);
+        const encodedProfileId = encodeURIComponent(this.payload.userId);
+        const response = await this.request(`${endpoint}/v1/spaces/${this.settings.spaceId}/collections/users/profiles/user_id:${encodedProfileId}/traits?limit=200`, {
+            headers: {
+                authorization: `Basic ${Buffer.from(this.settings.profileApiAccessToken + ':').toString('base64')}`,
+                'content-type': 'application/json'
+            }
+        });
+        const body = await response.json();
+        return body.traits;
+    }
+}
+MessageSendPerformer.nonSendableStatuses = ['unsubscribed', 'false'];
+MessageSendPerformer.sendableStatuses = ['subscribed', 'true'];
+__decorate([
+    track_1.track()
+], MessageSendPerformer.prototype, "getProfileTraits", null);
+exports.MessageSendPerformer = MessageSendPerformer;
+//# sourceMappingURL=MessageSendPerformer.js.map

package/dist/engage/utils/MessageSendPerformer.js.map

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

package/dist/engage/utils/Profile.d.ts

@@ -0,0 +1,6 @@
+export interface Profile {
+    user_id?: string;
+    anonymous_id?: string;
+    email?: string;
+    traits: Record<string, any>;
+}

package/dist/engage/utils/Profile.js

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

package/dist/engage/utils/Profile.js.map

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

package/dist/engage/utils/ResponseError.d.ts

@@ -0,0 +1,25 @@
+import { HTTPError } from '@segment/actions-core/request-client';
+export interface ResponseError extends HTTPError {
+    response: HTTPError['response'] & {
+        data: {
+            code: string | number;
+            message: string;
+            more_info: string;
+            status?: number;
+            statusCode?: number;
+            errors?: {
+                message: string;
+            }[];
+        };
+        headers?: Response['headers'];
+    };
+    code?: string;
+    status?: number;
+    retry?: boolean;
+}
+export interface ErrorDetails {
+    message: string;
+    code: string;
+    status?: number;
+}
+export declare function getErrorDetails(error: any): ErrorDetails;

package/dist/engage/utils/ResponseError.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorDetails = void 0;
+function getErrorDetails(error) {
+    const respError = error;
+    const status = respError.status || respError.response?.status;
+    const code = respError.code || respError.response?.data?.code;
+    const message = [
+        respError.name || respError.constructor?.name,
+        respError.message,
+        respError.response?.statusText && !respError.message.includes(respError.response?.statusText)
+            ? respError.response?.statusText
+            : undefined,
+        respError?.response?.data?.message,
+        respError?.response?.data?.errors?.[0]?.message
+    ]
+        .filter(Boolean)
+        .join('; ');
+    return { status, code: code?.toString(), message };
+}
+exports.getErrorDetails = getErrorDetails;
+//# sourceMappingURL=ResponseError.js.map

package/dist/engage/utils/ResponseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseError.js","sourceRoot":"","sources":["../../../src/engage/utils/ResponseError.ts"],"names":[],"mappings":";;;AA4BA,SAAgB,eAAe,CAAC,KAAU;IAGxC,MAAM,SAAS,GAAG,KAAsB,CAAA;IAGxC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAA;IAI7D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAA;IAE7D,MAAM,OAAO,GAAG;QACd,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,WAAW,EAAE,IAAI;QAC7C,SAAS,CAAC,OAAO;QACjB,SAAS,CAAC,QAAQ,EAAE,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC;YAC3F,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU;YAChC,CAAC,CAAC,SAAS;QAGb,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO;QAClC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO;KAChD;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAA;AACpD,CAAC;AA1BD,0CA0BC"}

package/dist/engage/utils/getProfileApiEndpoint.d.ts

@@ -0,0 +1,2 @@
+export declare const getProfileApiEndpoint: (environment: string, region?: Region | undefined) => string;
+export declare type Region = 'us-west-2' | 'eu-west-1';

package/dist/engage/utils/getProfileApiEndpoint.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProfileApiEndpoint = void 0;
+const getProfileApiEndpoint = (environment, region) => {
+    const domainName = region === 'eu-west-1' ? 'profiles.euw1.segment' : 'profiles.segment';
+    const topLevelName = environment === 'production' ? 'com' : 'build';
+    return `https://${domainName}.${topLevelName}`;
+};
+exports.getProfileApiEndpoint = getProfileApiEndpoint;
+//# sourceMappingURL=getProfileApiEndpoint.js.map

package/dist/engage/utils/getProfileApiEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProfileApiEndpoint.js","sourceRoot":"","sources":["../../../src/engage/utils/getProfileApiEndpoint.ts"],"names":[],"mappings":";;;AACO,MAAM,qBAAqB,GAAG,CAAC,WAAmB,EAAE,MAAe,EAAU,EAAE;IACpF,MAAM,UAAU,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,kBAAkB,CAAA;IACxF,MAAM,YAAY,GAAG,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAA;IACnE,OAAO,WAAW,UAAU,IAAI,YAAY,EAAE,CAAA;AAChD,CAAC,CAAA;AAJY,QAAA,qBAAqB,yBAIjC"}

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

@@ -0,0 +1,14 @@
+export * from './operationTracking';
+export * from './AggregateError';
+export * from './EngageActionPerformer';
+export * from './EngageLogger';
+export * from './EngageStats';
+export * from './getProfileApiEndpoint';
+export * from './IntegrationErrorWrapper';
+export * from './isDestinationActionService';
+export * from './isRetryableError';
+export * from './MessageSendPerformer';
+export * from './Profile';
+export * from './ResponseError';
+export * from './testUtils';
+export * from './track';

package/dist/engage/utils/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engage/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sDAAmC;AACnC,mDAAgC;AAChC,0DAAuC;AACvC,iDAA8B;AAC9B,gDAA6B;AAC7B,0DAAuC;AACvC,4DAAyC;AACzC,+DAA4C;AAC5C,qDAAkC;AAClC,yDAAsC;AACtC,4CAAyB;AACzB,kDAA+B;AAC/B,8CAA2B;AAC3B,0CAAuB"}

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

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

package/dist/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/engage/utils/isDestinationActionService.js.map

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

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

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

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

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

package/dist/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/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/engage/utils/operationTracking/OperationDecorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OperationDuration.js","sourceRoot":"","sources":["../../../../src/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/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/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