@segment/actions-core 1.3.0-next.0

package/dist/esm/defaults.js

@@ -0,0 +1,11 @@
+export function defaultValues(fields) {
+    const obj = {};
+    for (const field of Object.keys(fields)) {
+        const defaultValue = fields[field].default;
+        if (typeof defaultValue !== 'undefined') {
+            obj[field] = defaultValue;
+        }
+    }
+    return obj;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVmYXVsdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVmYXVsdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxVQUFVLGFBQWEsQ0FBQyxNQUErQjtJQUMzRCxNQUFNLEdBQUcsR0FBb0MsRUFBRSxDQUFBO0lBRS9DLEtBQUssTUFBTSxLQUFLLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRTtRQUN2QyxNQUFNLFlBQVksR0FBSSxNQUFNLENBQUMsS0FBSyxDQUFpQixDQUFDLE9BQU8sQ0FBQTtRQUMzRCxJQUFJLE9BQU8sWUFBWSxLQUFLLFdBQVcsRUFBRTtZQUN2QyxHQUFHLENBQUMsS0FBSyxDQUFDLEdBQUcsWUFBWSxDQUFBO1NBQzFCO0tBQ0Y7SUFFRCxPQUFPLEdBQUcsQ0FBQTtBQUNaLENBQUMifQ==

package/dist/esm/destination-kit/action.d.ts

@@ -0,0 +1,86 @@
+/// <reference types="node" />
+import Ajv from 'ajv';
+import { EventEmitter } from 'events';
+import { Got } from 'got';
+import { JSONLikeObject } from '../json-object';
+import { ExecuteInput, Step, StepResult, Steps } from './step';
+import type { InputField, RequestExtension } from './types';
+export declare type RequestFn<Settings, Payload> = (request: Got, data: ExecuteInput<Settings, Payload>) => any;
+export interface ActionDefinition<Settings, Payload = any> {
+    /** The unique identifier for the action, e.g. `postToChannel` */
+    /** The display title of the action */
+    title: string;
+    /** The display description of the action */
+    description: string;
+    /** Whether the action is recommended for quick setup */
+    recommended?: boolean;
+    /** An optional fql query that will be used to prepopulate the action when it is first set up */
+    defaultSubscription?: string;
+    /** Whether or not this action should be visible/configurable in the UI */
+    hidden?: boolean;
+    /**
+     * The fields used to perform the action. These fields should match what the partner API expects.
+     *
+     * This is a set of JSON Schema properties right now.
+     * We may eventually auto-generate the JSON Schema from a definition object
+     * instead of requiring devs to build and modify JSON Schema directly.
+     *
+     * Plus, JSON Schema cannot fully represent our action or field definitions
+     * without many custom keywords.
+     */
+    fields: Record<string, InputField>;
+    /**
+     * Temporary way to "register" autocomplete fields.
+     * This is likely going to change as we productionalize the data model and definition object
+     */
+    autocompleteFields?: {
+        [K in keyof Payload]?: RequestFn<Settings, Payload>;
+    };
+    /**
+     * Register fields that should be executed, cached and provided
+     * to the action's `perform` function
+     */
+    cachedFields?: {
+        [field: string]: {
+            key: (data: ExecuteInput<Settings, Payload>) => string;
+            ttl: number;
+            value: RequestFn<Settings, Payload>;
+            negative?: boolean;
+        };
+    };
+    /** The operation to perform when this action is triggered */
+    perform: RequestFn<Settings, Payload>;
+}
+export declare class Validate<Settings, Payload> extends Step<Settings, Payload> {
+    field: ExecuteInputField;
+    validate: Ajv.ValidateFunction;
+    constructor(field: ExecuteInputField, schema: object);
+    executeStep(data: ExecuteInput<Settings, Payload>): Promise<string>;
+}
+interface ExecuteAutocompleteInput<Settings, Payload> {
+    settings: Settings;
+    payload: Payload;
+    cachedFields: {
+        [key: string]: string;
+    };
+    page?: string;
+}
+declare type ExecuteInputField = 'payload' | 'settings';
+/**
+ * Action is the beginning step for all partner actions. Entrypoints always start with the
+ * MapAndValidateInput step.
+ */
+export declare class Action<Settings, Payload extends JSONLikeObject> extends EventEmitter {
+    readonly steps: Steps<Settings, Payload>;
+    private requestExtensions;
+    private autocompleteCache;
+    constructor(definition: ActionDefinition<Settings, Payload>, extendRequest?: RequestExtension<Settings, Payload>);
+    execute(data: ExecuteInput<Settings, Payload>): Promise<StepResult[]>;
+    executeAutocomplete(field: string, data: ExecuteAutocompleteInput<Settings, Payload>): any;
+    private loadDefinition;
+    private validatePayload;
+    private autocomplete;
+    private request;
+    private cachedRequest;
+}
+export {};

package/dist/esm/destination-kit/action.js

@@ -0,0 +1,209 @@
+// @ts-ignore no types
+import { AggregateAjvError } from '@segment/ajv-human-errors';
+import Ajv from 'ajv';
+import { EventEmitter } from 'events';
+import NodeCache from 'node-cache';
+import createRequestClient from '../create-request-client';
+import { get } from '../get';
+import { transform } from '../mapping-kit';
+import { fieldsToJsonSchema } from './fields-to-jsonschema';
+import { Step, Steps } from './step';
+class MapInput extends Step {
+    executeStep(data) {
+        // Transforms the initial payload (event) + action settings (from `subscriptions[0].mapping`)
+        // into input data that the action can use to talk to partner apis
+        if (data.mapping) {
+            // Technically we can't know whether or not `transform` returns the exact shape of Payload here, hence the casting
+            // It will be validated in subsequent steps
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            data.payload = transform(data.mapping, data.payload);
+        }
+        return Promise.resolve('MapInput completed');
+    }
+}
+export class Validate extends Step {
+    constructor(field, schema) {
+        super();
+        this.field = field;
+        const ajv = new Ajv({
+            // Coerce types to be a bit more liberal.
+            coerceTypes: true,
+            // Return all validation errors, not just the first.
+            allErrors: true,
+            // Include reference to schema and data in error values.
+            verbose: true,
+            // Use a more parse-able format for JSON paths.
+            jsonPointers: true
+        });
+        this.validate = ajv.compile(schema);
+    }
+    executeStep(data) {
+        if (!this.validate(data[this.field])) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            throw new AggregateAjvError(this.validate.errors);
+        }
+        return Promise.resolve('Validate completed');
+    }
+}
+/**
+ * Request handles delivering a payload to an external API. It uses the `got` library under the hood.
+ *
+ * The callback should be  able to return the raw request instead of needing to do `return response.data` etc.
+ */
+class Request extends Step {
+    constructor(extensions, requestFn) {
+        super();
+        this.extensions = extensions || [];
+        this.requestFn = requestFn;
+    }
+    async executeStep(data) {
+        if (!this.requestFn) {
+            return '';
+        }
+        const request = this.createRequestClient(data);
+        const response = await this.requestFn(request, data);
+        if (response === null) {
+            return 'TODO: null';
+        }
+        return response.body;
+    }
+    createRequestClient(data) {
+        const options = this.extensions.map((extension) => extension(data));
+        const client = createRequestClient(...options).extend({
+            hooks: {
+                beforeError: [
+                    (error) => {
+                        // @ts-ignore the type is wrong in got
+                        const { response } = error;
+                        this.emit('response', response);
+                        return error;
+                    }
+                ],
+                afterResponse: [
+                    (response) => {
+                        this.emit('response', response);
+                        return response;
+                    }
+                ]
+            }
+        });
+        return client;
+    }
+}
+// CachedRequest is like Request but cached. Next question.
+class CachedRequest extends Request {
+    constructor(extensions, config) {
+        super(extensions);
+        this.keyFn = config.key;
+        this.valueFn = config.value;
+        this.as = config.as;
+        this.negative = config.negative || false;
+        this.cache = new NodeCache({
+            stdTTL: config.ttl,
+            maxKeys: 1000
+        });
+    }
+    async executeStep(data) {
+        const k = this.keyFn(data);
+        let v = this.cache.get(k);
+        if (v !== undefined) {
+            data.cachedFields[this.as] = v;
+            return 'cache hit';
+        }
+        const request = this.createRequestClient(data);
+        try {
+            v = await this.valueFn(request, data);
+        }
+        catch (e) {
+            if (get(e, 'response.statusCode') === 404) {
+                v = undefined;
+            }
+            else {
+                throw e;
+            }
+        }
+        // Only cache if value is not negative *or* negative option is set. Negative caching is off by
+        // default because the common cases are: A) auth token generation, which should never be
+        // negative, and B) create-or-update patterns, where the resource should exist after the first
+        // negative value.
+        if ((v !== null && v !== undefined) || this.negative) {
+            this.cache.set(k, v);
+        }
+        return 'cache miss';
+    }
+}
+/**
+ * Action is the beginning step for all partner actions. Entrypoints always start with the
+ * MapAndValidateInput step.
+ */
+export class Action extends EventEmitter {
+    constructor(definition, extendRequest) {
+        super();
+        this.steps = new Steps();
+        const step = new MapInput();
+        this.steps.push(step);
+        this.autocompleteCache = {};
+        this.requestExtensions = [];
+        if (extendRequest) {
+            // This must come before we load the definition because
+            // it instantiates "steps" with whatever request extensions
+            // are defined at that moment in time
+            this.requestExtensions.push(extendRequest);
+        }
+        this.loadDefinition(definition);
+    }
+    async execute(data) {
+        const results = await this.steps.execute(data);
+        const finalResult = results[results.length - 1];
+        if (finalResult.error) {
+            throw finalResult.error;
+        }
+        return results;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    executeAutocomplete(field, data) {
+        if (!this.autocompleteCache[field]) {
+            return {
+                data: [],
+                pagination: {}
+            };
+        }
+        const step = new Request(this.requestExtensions, this.autocompleteCache[field]);
+        return step.executeStep(data);
+    }
+    loadDefinition(definition) {
+        var _a, _b;
+        if (definition.fields) {
+            this.validatePayload(definition.fields);
+        }
+        Object.entries((_a = definition.autocompleteFields) !== null && _a !== void 0 ? _a : {}).forEach(([field, callback]) => {
+            this.autocomplete(field, callback);
+        });
+        Object.entries((_b = definition.cachedFields) !== null && _b !== void 0 ? _b : {}).forEach(([field, cacheConfig]) => {
+            this.cachedRequest({
+                ...cacheConfig,
+                as: field
+            });
+        });
+        if (definition.perform) {
+            this.request(definition.perform);
+        }
+    }
+    validatePayload(fields) {
+        const step = new Validate('payload', fieldsToJsonSchema(fields));
+        this.steps.push(step);
+    }
+    autocomplete(field, callback) {
+        this.autocompleteCache[field] = callback;
+    }
+    request(requestFn) {
+        const step = new Request(this.requestExtensions, requestFn);
+        step.on('response', (response) => this.emit('response', response));
+        this.steps.push(step);
+    }
+    cachedRequest(config) {
+        const step = new CachedRequest(this.requestExtensions, config);
+        this.steps.push(step);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWN0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2Rlc3RpbmF0aW9uLWtpdC9hY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsc0JBQXNCO0FBQ3RCLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDJCQUEyQixDQUFBO0FBQzdELE9BQU8sR0FBRyxNQUFNLEtBQUssQ0FBQTtBQUNyQixPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sUUFBUSxDQUFBO0FBRXJDLE9BQU8sU0FBUyxNQUFNLFlBQVksQ0FBQTtBQUNsQyxPQUFPLG1CQUFtQixNQUFNLDBCQUEwQixDQUFBO0FBQzFELE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSxRQUFRLENBQUE7QUFFNUIsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGdCQUFnQixDQUFBO0FBQzFDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLHdCQUF3QixDQUFBO0FBQzNELE9BQU8sRUFBZ0IsSUFBSSxFQUFjLEtBQUssRUFBRSxNQUFNLFFBQVEsQ0FBQTtBQStEOUQsTUFBTSxRQUFtRCxTQUFRLElBQXVCO0lBQ3RGLFdBQVcsQ0FBQyxJQUFxQztRQUMvQyw2RkFBNkY7UUFDN0Ysa0VBQWtFO1FBQ2xFLElBQUksSUFBSSxDQUFDLE9BQU8sRUFBRTtZQUNoQixrSEFBa0g7WUFDbEgsMkNBQTJDO1lBQzNDLDhEQUE4RDtZQUM5RCxJQUFJLENBQUMsT0FBTyxHQUFHLFNBQVMsQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxPQUFjLENBQVksQ0FBQTtTQUN2RTtRQUVELE9BQU8sT0FBTyxDQUFDLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxDQUFBO0lBQzlDLENBQUM7Q0FDRjtBQUVELE1BQU0sT0FBTyxRQUE0QixTQUFRLElBQXVCO0lBSXRFLFlBQVksS0FBd0IsRUFBRSxNQUFjO1FBQ2xELEtBQUssRUFBRSxDQUFBO1FBRVAsSUFBSSxDQUFDLEtBQUssR0FB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

package/dist/esm/destination-kit/fields-to-jsonschema.d.ts

@@ -0,0 +1,4 @@
+import { JSONSchema4 } from 'json-schema';
+import type { InputField } from './types';
+export declare function fieldsToJsonSchema(fields?: Record<string, InputField>): JSONSchema4;
+export declare function jsonSchemaToFields(schema?: JSONSchema4): Record<string, InputField>;

package/dist/esm/destination-kit/fields-to-jsonschema.js

@@ -0,0 +1,33 @@
+export function fieldsToJsonSchema(fields = {}) {
+    const required = [];
+    const properties = {};
+    for (const key of Object.keys(fields)) {
+        const field = fields[key];
+        // Remove the `required` property from fields because it'll get lifted up into an array of required keys
+        properties[key] = Object.assign({}, field);
+        delete properties[key].required;
+        // Grab all the field keys with `required: true`
+        if (field.required) {
+            required.push(key);
+        }
+    }
+    return {
+        $schema: 'http://json-schema.org/schema#',
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        required
+    };
+}
+export function jsonSchemaToFields(schema = {}) {
+    var _a, _b;
+    const requiredFields = (_a = schema.required) !== null && _a !== void 0 ? _a : [];
+    const properties = (_b = schema.properties) !== null && _b !== void 0 ? _b : {};
+    for (const key of Object.keys(properties)) {
+        if (requiredFields.includes(key)) {
+            properties[key].required = true;
+        }
+    }
+    return properties;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmllbGRzLXRvLWpzb25zY2hlbWEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGVzdGluYXRpb24ta2l0L2ZpZWxkcy10by1qc29uc2NoZW1hLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBLE1BQU0sVUFBVSxrQkFBa0IsQ0FBQyxTQUFxQyxFQUFFO0lBQ3hFLE1BQU0sUUFBUSxHQUFhLEVBQUUsQ0FBQTtJQUM3QixNQUFNLFVBQVUsR0FBZ0MsRUFBRSxDQUFBO0lBRWxELEtBQUssTUFBTSxHQUFHLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRTtRQUNyQyxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUE7UUFFekIsd0dBQXdHO1FBQ3hHLFVBQVUsQ0FBQyxHQUFHLENBQUMsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsRUFBRSxLQUFLLENBQWdCLENBQUE7UUFDekQsT0FBTyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUMsUUFBUSxDQUFBO1FBRS9CLGdEQUFnRDtRQUNoRCxJQUFJLEtBQUssQ0FBQyxRQUFRLEVBQUU7WUFDbEIsUUFBUSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQTtTQUNuQjtLQUNGO0lBRUQsT0FBTztRQUNMLE9BQU8sRUFBRSxnQ0FBZ0M7UUFDekMsSUFBSSxFQUFFLFFBQVE7UUFDZCxvQkFBb0IsRUFBRSxLQUFLO1FBQzNCLFVBQVU7UUFDVixRQUFRO0tBQ1QsQ0FBQTtBQUNILENBQUM7QUFFRCxNQUFNLFVBQVUsa0JBQWtCLENBQUMsU0FBc0IsRUFBRTs7SUFDekQsTUFBTSxjQUFjLFNBQUksTUFBTSxDQUFDLFFBQXFCLG1DQUFJLEVBQUUsQ0FBQTtJQUMxRCxNQUFNLFVBQVUsU0FBSSxNQUFNLENBQUMsVUFBeUMsbUNBQUksRUFBRSxDQUFBO0lBRTFFLEtBQUssTUFBTSxHQUFHLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsRUFBRTtRQUN6QyxJQUFJLGNBQWMsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEVBQUU7WUFDaEMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUE7U0FDaEM7S0FDRjtJQUVELE9BQU8sVUFBVSxDQUFBO0FBQ25CLENBQUMifQ==

package/dist/esm/destination-kit/index.d.ts

@@ -0,0 +1,84 @@
+import { CancelableRequest, Got, Response } from 'got';
+import { JSONSchema4 } from 'json-schema';
+import { Action, ActionDefinition } from './action';
+import { ExecuteInput, StepResult } from './step';
+import { JSONLikeObject, JSONObject } from '../json-object';
+import { SegmentEvent } from '../segment-event';
+import { fieldsToJsonSchema, jsonSchemaToFields } from './fields-to-jsonschema';
+import type { InputField, RequestExtension } from './types';
+export type { ActionDefinition, ExecuteInput };
+export { fieldsToJsonSchema, jsonSchemaToFields };
+export interface SubscriptionStats {
+    duration: number;
+    destination: string;
+    action: string;
+    subscribe: string;
+    state: string;
+    input: JSONLikeObject;
+    output: StepResult[] | null;
+}
+interface PartnerActions<Settings, Payload extends JSONLikeObject> {
+    [key: string]: Action<Settings, Payload>;
+}
+export interface DestinationDefinition<Settings = unknown> {
+    /** The name of the destination */
+    name: string;
+    /** An optional function to extend requests sent from the destination (including all actions) */
+    extendRequest?: RequestExtension<Settings>;
+    /** Optional authentication configuration */
+    authentication?: AuthenticationScheme<Settings>;
+    /** Actions */
+    actions: {
+        [key: string]: ActionDefinition<Settings>;
+    };
+    /** Subscription presets automatically applied in quick setup */
+    presets?: Subscription[];
+}
+export interface Subscription {
+    name?: string;
+    partnerAction: string;
+    subscribe: string;
+    mapping?: JSONObject;
+}
+interface TestAuthSettings<Settings> {
+    settings: Settings;
+}
+interface Authentication<Settings> {
+    scheme: 'basic' | 'custom';
+    fields: Record<string, InputField>;
+    testAuthentication: (req: Got, input: TestAuthSettings<Settings>) => CancelableRequest<Response<string>>;
+}
+export interface CustomAuthentication<Settings> extends Authentication<Settings> {
+    /** Typically used for "API Key" authentication. */
+    scheme: 'custom';
+}
+export interface BasicAuthentication<Settings> extends Authentication<Settings> {
+    scheme: 'basic';
+}
+export declare type AuthenticationScheme<Settings = any> = BasicAuthentication<Settings> | CustomAuthentication<Settings>;
+interface EventInput<Settings> {
+    readonly event: SegmentEvent;
+    readonly mapping: JSONObject;
+    readonly settings: Settings;
+}
+export declare class Destination<Settings = JSONObject> {
+    readonly definition: DestinationDefinition<Settings>;
+    readonly name: string;
+    readonly authentication?: AuthenticationScheme<Settings>;
+    readonly extendRequest?: RequestExtension<Settings>;
+    readonly actions: PartnerActions<Settings, any>;
+    readonly responses: Response[];
+    readonly settingsSchema?: JSONSchema4;
+    constructor(destination: DestinationDefinition<Settings>);
+    testAuthentication(settings: Settings): Promise<void>;
+    private partnerAction;
+    protected executeAction(actionSlug: string, { event, mapping, settings }: EventInput<Settings>): Promise<StepResult[]>;
+    private onSubscription;
+    /**
+     * Note: Until we move subscriptions upstream (into int-consumer) we've opted
+     * to have failures abort the set of subscriptions and get potentially retried by centrifuge
+     */
+    onEvent(event: SegmentEvent, settings: JSONObject, onComplete?: (stats: SubscriptionStats) => void): Promise<StepResult[]>;
+    private getSubscriptions;
+    private getDestinationSettings;
+}

package/dist/esm/destination-kit/index.js

@@ -0,0 +1,157 @@
+import { validate, parseFql } from '@segment/fab5-subscriptions';
+import { BadRequest } from 'http-errors';
+import got from 'got';
+import { Action, Validate } from './action';
+import { time, duration } from '../time';
+import { fieldsToJsonSchema, jsonSchemaToFields } from './fields-to-jsonschema';
+export { fieldsToJsonSchema, jsonSchemaToFields };
+export class Destination {
+    constructor(destination) {
+        var _a;
+        this.definition = destination;
+        this.name = destination.name;
+        this.extendRequest = destination.extendRequest;
+        this.actions = {};
+        this.authentication = destination.authentication;
+        this.responses = [];
+        // Convert to complete JSON Schema
+        if ((_a = this.authentication) === null || _a === void 0 ? void 0 : _a.fields) {
+            this.settingsSchema = fieldsToJsonSchema(this.authentication.fields);
+        }
+        for (const action of Object.keys(destination.actions)) {
+            this.partnerAction(action, destination.actions[action]);
+        }
+    }
+    async testAuthentication(settings) {
+        var _a;
+        const context = { settings, payload: {}, cachedFields: {} };
+        if (this.settingsSchema) {
+            const step = new Validate('settings', this.settingsSchema);
+            await step.executeStep(context);
+        }
+        if (!((_a = this.authentication) === null || _a === void 0 ? void 0 : _a.testAuthentication)) {
+            return;
+        }
+        let request = got.extend({
+            retry: 0,
+            timeout: 3000,
+            headers: {
+                'user-agent': undefined
+            }
+        });
+        if (typeof this.extendRequest === 'function') {
+            request = request.extend(this.extendRequest(context));
+        }
+        try {
+            await this.authentication.testAuthentication(request, { settings });
+        }
+        catch (error) {
+            throw new Error('Credentials are invalid');
+        }
+    }
+    partnerAction(slug, definition) {
+        const action = new Action(definition, this.extendRequest);
+        action.on('response', (response) => {
+            if (response) {
+                this.responses.push(response);
+            }
+        });
+        this.actions[slug] = action;
+        return this;
+    }
+    executeAction(actionSlug, { event, mapping, settings }) {
+        const action = this.actions[actionSlug];
+        if (!action) {
+            throw new BadRequest(`"${actionSlug}" is not a valid action`);
+        }
+        return action.execute({
+            cachedFields: {},
+            mapping,
+            payload: event,
+            settings
+        });
+    }
+    async onSubscription(subscription, event, settings, onComplete) {
+        const subscriptionStartedAt = time();
+        const actionSlug = subscription.partnerAction;
+        const input = {
+            event,
+            mapping: subscription.mapping || {},
+            settings
+        };
+        let state = 'pending';
+        let results = null;
+        try {
+            if (typeof subscription.subscribe !== 'string') {
+                state = 'skipped';
+                results = [{ output: 'invalid subscription' }];
+                return results;
+            }
+            const isSubscribed = validate(parseFql(subscription.subscribe), event);
+            if (!isSubscribed) {
+                state = 'skipped';
+                results = [{ output: 'not subscribed' }];
+                return results;
+            }
+            results = await this.executeAction(actionSlug, input);
+            state = 'done';
+            return results;
+        }
+        catch (error) {
+            state = 'errored';
+            results = [{ error }];
+            throw error;
+        }
+        finally {
+            const subscriptionEndedAt = time();
+            const subscriptionDuration = duration(subscriptionStartedAt, subscriptionEndedAt);
+            onComplete === null || onComplete === void 0 ? void 0 : onComplete({
+                duration: subscriptionDuration,
+                destination: this.name,
+                action: actionSlug,
+                subscribe: subscription.subscribe,
+                state,
+                input: {
+                    event: input.event,
+                    mapping: input.mapping,
+                    settings: input.settings
+                },
+                output: results
+            });
+        }
+    }
+    /**
+     * Note: Until we move subscriptions upstream (into int-consumer) we've opted
+     * to have failures abort the set of subscriptions and get potentially retried by centrifuge
+     */
+    async onEvent(event, settings, onComplete) {
+        const subscriptions = this.getSubscriptions(settings);
+        const destinationSettings = this.getDestinationSettings(settings);
+        const promises = subscriptions.map((subscription) => this.onSubscription(subscription, event, destinationSettings, onComplete));
+        const results = await Promise.all(promises);
+        return [].concat(...results);
+    }
+    getSubscriptions(settings) {
+        const { subscription, subscriptions } = settings;
+        let parsedSubscriptions;
+        // To support event tester we need to parse and validate multiple subscriptions from the settings
+        if (subscription) {
+            parsedSubscriptions = [subscription];
+        }
+        else if (typeof subscriptions === 'string') {
+            parsedSubscriptions = JSON.parse(subscriptions);
+        }
+        else if (Array.isArray(subscriptions)) {
+            parsedSubscriptions = subscriptions;
+        }
+        else {
+            parsedSubscriptions = [];
+        }
+        return parsedSubscriptions;
+    }
+    getDestinationSettings(settings) {
+        const { subcription, subscriptions, ...otherSettings } = settings;
+        return otherSettings;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGVzdGluYXRpb24ta2l0L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLE1BQU0sNkJBQTZCLENBQUE7QUFDaEUsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQTtBQUN4QyxPQUFPLEdBQXlDLE1BQU0sS0FBSyxDQUFBO0FBRTNELE9BQU8sRUFBRSxNQUFNLEVBQW9CLFFBQVEsRUFBRSxNQUFNLFVBQVUsQ0FBQTtBQUU3RCxPQUFPLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxNQUFNLFNBQVMsQ0FBQTtBQUd4QyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQTtBQUkvRSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsa0JBQWtCLEVBQUUsQ0FBQTtBQXFFakQsTUFBTSxPQUFPLFdBQVc7SUFVdEIsWUFBWSxXQUE0Qzs7UUFDdEQsSUFBSSxDQUFDLFVBQVUsR0FBRyxXQUFXLENBQUE7UUFDN0IsSUFBSSxDQUFDLElBQUksR0FBRyxXQUFXLENBQUMsSUFBSSxDQUFBO1FBQzVCLElBQUksQ0FBQyxhQUFhLEdBQUcsV0FBVyxDQUFDLGFBQWEsQ0FBQTtRQUM5QyxJQUFJLENBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQTtRQUNqQixJQUFJLENBQUMsY0FBYyxHQUFHLFdBQVcsQ0FBQyxjQUFjLENBQUE7UUFDaEQsSUFBSSxDQUFDLFNBQVMsR0FBRyxFQUFFLENBQUE7UUFFbkIsa0NBQWtDO1FBQ2xDLFVBQUksSUFBSSxDQUFDLGNBQWMsMENBQUUsTUFBTSxFQUFFO1lBQy9CLElBQUksQ0FBQyxjQUFjLEdBQUcsa0JBQWtCLENBQUMsSUFBSSxDQUFDLGNBQWMsQ0FBQyxNQUFNLENBQUMsQ0FBQTtTQUNyRTtRQUVELEtBQUssTUFBTSxNQUFNLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLEVBQUU7WUFDckQsSUFBSSxDQUFDLGFBQWEsQ0FBQyxNQUFNLEVBQUUsV0FBVyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFBO1NBQ3hEO0lBQ0gsQ0FBQztJQUVELEtBQUssQ0FBQyxrQkFBa0IsQ0FBQyxRQUFrQjs7UUFDekMsTUFBTSxPQUFPLEdBQStCLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUUsWUFBWSxFQUFFLEVBQUUsRUFBRSxDQUFBO1FBRXZGLElBQUksSUFBSSxDQUFDLGNBQWMsRUFBRTtZQUN2QixNQUFNLElBQUksR0FBRyxJQUFJLFFBQVEsQ0FBQyxVQUFVLEVBQUUsSUFBSSxDQUFDLGNBQWMsQ0FBQyxDQUFBO1lBQzFELE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxPQUFPLENBQUMsQ0FBQTtTQUNoQztRQUVELElBQUksUUFBQyxJQUFJLENBQUMsY0FBYywwQ0FBRSxrQkFBa0IsQ0FBQSxFQUFFO1lBQzVDLE9BQU07U0FDUDtRQUVELElBQUksT0FBTyxHQUFHLEdBQUcsQ0FBQyxNQUFNLENBQUM7WUFDdkIsS0FBSyxFQUFFLENBQUM7WUFDUixPQUFPLEVBQUUsSUFBSTtZQUNiLE9BQU8sRUFBRTtnQkFDUCxZQUFZLEVBQUUsU0FBUzthQUN4QjtTQUNGLENBQUMsQ0FBQTtRQUVGLElBQUksT0FBTyxJQUFJLENBQUMsYUFBYSxLQUFLLFVBQVUsRUFBRTtZQUM1QyxPQUFPLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsYUFBYSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUE7U0FDdEQ7UUFFRCxJQUFJO1lBQ0YsTUFBTSxJQUFJLENBQUMsY0FBYyxDQUFDLGtCQUFrQixDQUFDLE9BQU8sRUFBRSxFQUFFLFFBQVEsRUFBRSxDQUFDLENBQUE7U0FDcEU7UUFBQyxPQUFPLEtBQUssRUFBRTtZQUNkLE1BQU0sSUFBSSxLQUFLLENBQUMseUJBQXlCLENBQUMsQ0FBQTtTQUMzQztJQUNILENBQUM7SUFFTyxhQUFhLENBQUMsSUFBWSxFQUFFLFVBQXNDO1FBQ3hFLE1BQU0sTUFBTSxHQUFHLElBQUksTUFBTSxDQUFlLFVBQVUsRUFBRSxJQUFJLENBQUMsYUFBYSxDQUFDLENBQUE7UUFFdkUsTUFBTSxDQUFDLEVBQUUsQ0FBQyxVQUFVLEVBQUUsQ0FBQyxRQUFRLEVBQUUsRUFBRTtZQUNqQyxJQUFJLFFBQVEsRUFBRTtnQkFDWixJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTthQUM5QjtRQUNILENBQUMsQ0FBQyxDQUFBO1FBRUYsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsR0FBRyxNQUFNLENBQUE7UUFFM0IsT0FBTyxJQUFJLENBQUE7SUFDYixDQUFDO0lBRVMsYUFBYSxDQUNyQixVQUFrQixFQUNsQixFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsUUFBUSxFQUF3QjtRQUVsRCxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQUFBO1FBQ3ZDLElBQUksQ0FBQyxNQUFNLEVBQUU7WUFDWCxNQUFNLElBQUksVUFBVSxDQUFDLElBQUksVUFBVSx5QkFBeUIsQ0FBQyxDQUFBO1NBQzlEO1FBRUQsT0FBTyxNQUFNLENBQUMsT0FBTyxDQUFDO1lBQ3BCLFlBQVksRUFBRSxFQUFFO1lBQ2hCLE9BQU87WUFDUCxPQUFPLEVBQUUsS0FBSztZQUNkLFFBQVE7U0FDVCxDQUFDLENBQUE7SUFDSixDQUFDO0lBRU8sS0FBSyxDQUFDLGNBQWMsQ0FDMUIsWUFBMEIsRUFDMUIsS0FBbUIsRUFDbkIsUUFBa0IsRUFDbEIsVUFBK0M7UUFFL0MsTUFBTSxxQkFBcUIsR0FBRyxJQUFJLEVBQUUsQ0FBQTtRQUNwQyxNQUFNLFVBQVUsR0FBRyxZQUFZLENBQUMsYUFBYSxDQUFBO1FBQzdDLE1BQU0sS0FBSyxHQUFHO1lBQ1osS0FBSztZQUNMLE9BQU8sRUFBRSxZQUFZLENBQUMsT0FBTyxJQUFJLEVBQUU7WUFDbkMsUUFBUTtTQUNULENBQUE7UUFFRCxJQUFJLEtBQUssR0FBRyxTQUFTLENBQUE7UUFDckIsSUFBSSxPQUFPLEdBQXdCLElBQUksQ0FBQTtRQUV2QyxJQUFJO1lBQ0YsSUFBSSxPQUFPLFlBQVksQ0FBQyxTQUFTLEtBQUssUUFBUSxFQUFFO2dCQUM5QyxLQUFLLEdBQUcsU0FBUyxDQUFBO2dCQUNqQixPQUFPLEdBQUcsQ0FBQyxFQUFFLE1BQU0sRUFBRSxzQkFBc0IsRUFBRSxDQUFDLENBQUE7Z0JBQzlDLE9BQU8sT0FBTyxDQUFBO2FBQ2Y7WUFFRCxNQUFNLFlBQVksR0FBRyxRQUFRLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxTQUFTLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQTtZQUN0RSxJQUFJLENBQUMsWUFBWSxFQUFFO2dCQUNqQixLQUFLLEdBQUcsU0FBUyxDQUFBO2dCQUNqQixPQUFPLEdBQUcsQ0FBQyxFQUFFLE1BQU0sRUFBRSxnQkFBZ0IsRUFBRSxDQUFDLENBQUE7Z0JBQ3hDLE9BQU8sT0FBTyxDQUFBO2FBQ2Y7WUFFRCxPQUFPLEdBQUcsTUFBTSxJQUFJLENBQUMsYUFBYSxDQUFDLFVBQVUsRUFBRSxLQUFLLENBQUMsQ0FBQTtZQUNyRCxLQUFLLEdBQUcsTUFBTSxDQUFBO1lBRWQsT0FBTyxPQUFPLENBQUE7U0FDZjtRQUFDLE9BQU8sS0FBSyxFQUFFO1lBQ2QsS0FBSyxHQUFHLFNBQVMsQ0FBQTtZQUNqQixPQUFPLEdBQUcsQ0FBQyxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUE7WUFDckIsTUFBTSxLQUFLLENBQUE7U0FDWjtnQkFBUztZQUNSLE1BQU0sbUJBQW1CLEdBQUcsSUFBSSxFQUFFLENBQUE7WUFDbEMsTUFBTSxvQkFBb0IsR0FBRyxRQUFRLENBQUMscUJBQXFCLEVBQUUsbUJBQW1CLENBQUMsQ0FBQTtZQUVqRixVQUFVLGFBQVYsVUFBVSx1QkFBVixVQUFVLENBQUc7Z0JBQ1gsUUFBUSxFQUFFLG9CQUFvQjtnQkFDOUIsV0FBVyxFQUFFLElBQUksQ0FBQyxJQUFJO2dCQUN0QixNQUFNLEVBQUUsVUFBVTtnQkFDbEIsU0FBUyxFQUFFLFlBQVksQ0FBQyxTQUFTO2dCQUNqQyxLQUFLO2dCQUNMLEtBQUssRUFBRTtvQkFDTCxLQUFLLEVBQUcsS0FBSyxDQUFDLEtBQW1DO29CQUNqRCxPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU87b0JBQ3RCLFFBQVEsRUFBRyxLQUFLLENBQUMsUUFBc0M7aUJBQ3hEO2dCQUNELE1BQU0sRUFBRSxPQUFPO2FBQ2hCLEVBQUM7U0FDSDtJQUNILENBQUM7SUFFRDs7O09BR0c7SUFDSSxLQUFLLENBQUMsT0FBTyxDQUNsQixLQUFtQixFQUNuQixRQUFvQixFQUNwQixVQUErQztRQUUvQyxNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsUUFBUSxDQUFDLENBQUE7UUFDckQsTUFBTSxtQkFBbUIsR0FBRyxJQUFJLENBQUMsc0JBQXNCLENBQUMsUUFBUSxDQUFDLENBQUE7UUFFakUsTUFBTSxRQUFRLEdBQUcsYUFBYSxDQUFDLEdBQUcsQ0FBQyxDQUFDLFlBQVksRUFBRSxFQUFFLENBQ2xELElBQUksQ0FBQyxjQUFjLENBQUMsWUFBWSxFQUFFLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxVQUFVLENBQUMsQ0FDMUUsQ0FBQTtRQUVELE1BQU0sT0FBTyxHQUFHLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsQ0FBQTtRQUUzQyxPQUFRLEVBQW1CLENBQUMsTUFBTSxDQUFDLEdBQUcsT0FBTyxDQUFDLENBQUE7SUFDaEQsQ0FBQztJQUVPLGdCQUFnQixDQUFDLFFBQW9CO1FBQzNDLE1BQU0sRUFBRSxZQUFZLEVBQUUsYUFBYSxFQUFFLEdBQUcsUUFBUSxDQUFBO1FBQ2hELElBQUksbUJBQW1CLENBQUE7UUFFdkIsaUdBQWlHO1FBQ2pHLElBQUksWUFBWSxFQUFFO1lBQ2hCLG1CQUFtQixHQUFHLENBQUMsWUFBWSxDQUFDLENBQUE7U0FDckM7YUFBTSxJQUFJLE9BQU8sYUFBYSxLQUFLLFFBQVEsRUFBRTtZQUM1QyxtQkFBbUIsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLGFBQWEsQ0FBQyxDQUFBO1NBQ2hEO2FBQU0sSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxFQUFFO1lBQ3ZDLG1CQUFtQixHQUFHLGFBQWEsQ0FBQTtTQUNwQzthQUFNO1lBQ0wsbUJBQW1CLEdBQUcsRUFBRSxDQUFBO1NBQ3pCO1FBRUQsT0FBTyxtQkFBcUMsQ0FBQTtJQUM5QyxDQUFDO0lBRU8sc0JBQXNCLENBQUMsUUFBb0I7UUFDakQsTUFBTSxFQUFFLFdBQVcsRUFBRSxhQUFhLEVBQUUsR0FBRyxhQUFhLEVBQUUsR0FBRyxRQUFRLENBQUE7UUFDakUsT0FBUSxhQUFxQyxDQUFBO0lBQy9DLENBQUM7Q0FDRiJ9

package/dist/esm/destination-kit/step.d.ts

@@ -0,0 +1,38 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { JSONObject } from '../json-object';
+export interface StepResult {
+    output?: JSONObject | string | null | undefined;
+    error?: JSONObject | null;
+}
+export interface ExecuteInput<Settings, Payload> {
+    /** The subscription mapping definition */
+    readonly mapping?: JSONObject;
+    /** The global destination settings */
+    readonly settings: Settings;
+    /** The transformed input data, based on `mapping` + `event` */
+    payload: Payload;
+    /** The ids from cached requests */
+    cachedFields: {
+        [key: string]: string;
+    };
+    /** The page used in autocomplete */
+    page?: string;
+}
+/**
+ * Step is the base class for all discrete execution steps. It handles executing the step, logging,
+ * catching errors, and returning a result object.
+ */
+export declare class Step<Settings, Payload> extends EventEmitter {
+    executeStep?(data: ExecuteInput<Settings, Payload>): Promise<string>;
+    execute(data: ExecuteInput<Settings, Payload>): Promise<StepResult>;
+}
+/**
+ * Steps is a list of one or more Step instances that can be executed in-order.
+ */
+export declare class Steps<Settings, Payload> {
+    steps: Step<Settings, Payload>[];
+    constructor();
+    push(step: Step<Settings, Payload>): void;
+    execute(data: ExecuteInput<Settings, Payload>): Promise<StepResult[]>;
+}