@oneuptime/common 14.0.11 → 14.0.12

package/build/dist/Types/Workflow/Documentation/UtilityDocumentation.js

@@ -0,0 +1,290 @@
+/*
+ * Help for the steps that shape a run rather than talk to anything outside
+ * it: If / Else, Log, Sleep, Execute Workflow, custom JavaScript and the three
+ * JSON steps.
+ */
+import { ComponentDocumentationNoteType, } from "./ComponentDocumentation";
+import { getSampleValue, ownReference, } from "./DocumentationContext";
+import { WorkflowDocsPaths, docsLink } from "./DocumentationLinks";
+export const getIfElseDocumentation = (context) => {
+    const sample = getSampleValue(context);
+    /*
+     * The settings read as a sentence - If [Value to check] [Comparison]
+     * [Compare with] - so the help names them by those names, and the
+     * comparisons by the words the list uses.
+     */
+    return {
+        summary: "Checks a condition, then carries on down **Yes** when it is met or **No** when it is not.",
+        steps: [
+            "Pick the **Value to check** with { }, usually a value from an earlier step, or type one.",
+            "Choose the **Comparison**, and put what to compare with in **Compare with**. Is empty and is not empty need nothing there.",
+            "Read the sentence under the settings: it says when **Yes** runs, so you can see the condition says what you mean.",
+            "Connect **Yes** and **No** to what should run in each case.",
+        ],
+        examples: sample
+            ? [
+                {
+                    title: "Carry on only when a value matches",
+                    fields: [
+                        { name: "Value to check", value: sample.reference },
+                        { name: "Comparison", value: "is equal to" },
+                        { name: "Compare with", value: "the value to match" },
+                    ],
+                    description: `**Yes** runs when ${sample.description} is that value.`,
+                },
+                {
+                    title: "Carry on only when a value was sent",
+                    fields: [
+                        { name: "Value to check", value: sample.reference },
+                        { name: "Comparison", value: "is not empty" },
+                    ],
+                    description: `**Yes** runs when ${sample.description} holds anything. **No** runs when it is missing or blank.`,
+                },
+            ]
+            : [
+                {
+                    title: "Carry on only when a request succeeded",
+                    fields: [
+                        {
+                            name: "Value to check",
+                            value: "{{local.components.api-get-1.returnValues.response-status}}",
+                        },
+                        { name: "Comparison", value: "is less than" },
+                        { name: "Compare with", value: "400" },
+                    ],
+                    description: "**Yes** runs when an API step called `api-get-1` was answered with a status below 400. The two are compared as numbers.",
+                },
+            ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Tip,
+                text: "The number comparisons, such as is greater than, compare numbers. To compare text or dates letter by letter instead, choose Text under **Compare as**.",
+            },
+        ],
+        learnMore: [
+            {
+                title: "How the values are compared",
+                paragraphs: [
+                    "Is equal to and is not equal to compare text unless **Compare as** says otherwise, and capital letters count: `Error` is not `error`. So do contains, starts with and ends with.",
+                    "Compared as numbers, text that is not a number counts as 0. Compared as true or false, only the value true counts as true; is true and is false compare that way.",
+                ],
+            },
+            {
+                title: "What counts as empty",
+                paragraphs: [
+                    "Is empty is met by nothing at all, blank text, an empty list or object, or a value the earlier step did not have, such as a field the webhook did not send. 0 and false are values, so they are not empty.",
+                ],
+            },
+        ],
+        links: [docsLink("If / Else guide", WorkflowDocsPaths.conditions)],
+    };
+};
+export const getLogDocumentation = (context) => {
+    const sample = getSampleValue(context);
+    return {
+        summary: "Writes a value to this run's log, so you can see what a step received.",
+        steps: [
+            "Put what to record in **Value**: text, a value from an earlier step, or both.",
+            "Connect **Out** to whatever should run next.",
+            "Run the workflow, then open the run's log to read it.",
+        ],
+        examples: [
+            sample
+                ? {
+                    title: "Record a value from another step",
+                    code: `Received: ${sample.reference}`,
+                    description: `The reference puts in ${sample.description}.`,
+                }
+                : {
+                    title: "Record a note",
+                    code: "Reached the cleanup branch.",
+                },
+        ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Tip,
+                text: "Nothing is sent anywhere. Remove Log steps you no longer need, to keep the run log easy to read.",
+            },
+        ],
+        learnMore: [],
+        links: [docsLink("Runs and logs guide", WorkflowDocsPaths.runsAndLogs)],
+    };
+};
+export const getSleepDocumentation = (_context) => {
+    return {
+        summary: "Waits for a while, then carries on with the next steps.",
+        steps: [
+            "Set how long to wait in **Days**, **Hours**, **Minutes** and **Seconds**. They add up.",
+            "Connect **Out** to the steps that should run after the wait.",
+        ],
+        examples: [
+            {
+                title: "Wait an hour and a half",
+                fields: [
+                    { name: "Hours", value: "1" },
+                    { name: "Minutes", value: "30" },
+                ],
+            },
+        ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Tip,
+                text: "The longest wait is 30 days. A longer one is cut to 30 days.",
+            },
+        ],
+        learnMore: [
+            {
+                title: "What happens while it waits",
+                paragraphs: [
+                    "The run is put aside and picked up again when the time is up, so a long wait does not hold anything up. The run's log shows when it went to sleep.",
+                ],
+            },
+        ],
+        links: [docsLink("Sleep guide", WorkflowDocsPaths.sleep)],
+    };
+};
+export const getExecuteWorkflowDocumentation = (_context) => {
+    return {
+        summary: "Starts another workflow in this project, and carries on without waiting for it.",
+        steps: [
+            "Pick the workflow in **Workflow**. It must be turned on and start with a **Manual** trigger.",
+            "Put what it needs in **Arguments**, as JSON.",
+            "Connect **Out** to carry on, and **Error** for when the workflow cannot be started.",
+        ],
+        examples: [
+            {
+                title: "Arguments",
+                code: '{"customerId": "42"}',
+                description: "In the other workflow, `{{local.components.manual-1.returnValues.customerId}}` reads it, where `manual-1` is that workflow's Manual trigger.",
+            },
+        ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Tip,
+                text: "Nothing comes back from the other workflow. This step only starts it.",
+            },
+            {
+                type: ComponentDocumentationNoteType.Warning,
+                text: "A workflow cannot start itself, and there is a limit on how many workflows can start one another in a chain.",
+            },
+        ],
+        learnMore: [],
+        links: [
+            docsLink("Execute Workflow guide", WorkflowDocsPaths.executeWorkflow),
+        ],
+    };
+};
+export const getJavaScriptDocumentation = (context) => {
+    return {
+        summary: "Runs your own JavaScript, and passes what it returns to the next steps.",
+        steps: [
+            "Write the code in **JavaScript Code**, and `return` what later steps need.",
+            "Pass values in through **Arguments**, as JSON. The code reads them as `args`.",
+            "Connect **Success**, and **Error** for when the code throws or runs too long.",
+        ],
+        examples: [
+            {
+                title: "Build a value from two arguments",
+                code: 'return { fullName: args.firstName + " " + args.lastName };',
+                description: `With **Arguments** set to \`{"firstName": "Ada", "lastName": "Lovelace"}\`, a later step reads the name with \`${ownReference(context, "returnValue", ["fullName"])}\`.`,
+            },
+        ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Warning,
+                text: "The code has 5 seconds to finish. For longer work, run it on your own server and call it with an API step.",
+            },
+            {
+                type: ComponentDocumentationNoteType.Tip,
+                text: "Values from other steps are not available in the code directly. Put their references in **Arguments**.",
+            },
+        ],
+        learnMore: [
+            {
+                title: "What the code can use",
+                paragraphs: [
+                    "`args` holds the **Arguments**. `axios` makes HTTP requests, with the same address rules as the API steps. `console.log` writes to the run's log.",
+                    "The code runs in a sandbox: there is no file system, and no other modules can be loaded.",
+                ],
+            },
+        ],
+        links: [docsLink("Custom code guide", WorkflowDocsPaths.customCode)],
+    };
+};
+export const getJsonToTextDocumentation = (context) => {
+    return {
+        summary: "Turns a JSON object into text, for steps that need a string.",
+        steps: [
+            "Put the object in **JSON**. It is usually a value from an earlier step.",
+            "Connect **Success** to the step that needs the text.",
+            "Use the result as **Text** in later steps.",
+        ],
+        examples: [
+            {
+                title: "The object, as text",
+                code: ownReference(context, "text"),
+            },
+        ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Warning,
+                text: "If **JSON** is not an object, the run stops here with an error.",
+            },
+        ],
+        learnMore: [],
+        links: [docsLink("JSON steps guide", WorkflowDocsPaths.json)],
+    };
+};
+export const getTextToJsonDocumentation = (context) => {
+    return {
+        summary: "Reads JSON written as text, so later steps can use its fields.",
+        steps: [
+            "Put the text in **Text**, such as a response body or the JSON a run started with.",
+            "Connect **Success**, and **Error** for when the text is not valid JSON.",
+            "Read fields of the result from **JSON** in later steps.",
+        ],
+        examples: [
+            {
+                title: "Read one field of the result",
+                code: ownReference(context, "json", ["status"]),
+                description: "Change `status` to the name of the field you need.",
+            },
+        ],
+        notes: [],
+        learnMore: [],
+        links: [docsLink("JSON steps guide", WorkflowDocsPaths.json)],
+    };
+};
+export const getMergeJsonDocumentation = (context) => {
+    return {
+        summary: "Combines two JSON objects into one.",
+        steps: [
+            "Put the two objects in **JSON 1** and **JSON 2**.",
+            "Connect **Success** to the step that needs the result.",
+            "Use the combined object as **JSON** in later steps.",
+        ],
+        examples: [
+            {
+                title: "Two objects",
+                fields: [
+                    { name: "JSON 1", value: '{"name": "Checkout", "status": "up"}' },
+                    { name: "JSON 2", value: '{"status": "down"}' },
+                ],
+                description: `\`${ownReference(context, "json")}\` is then \`{"name": "Checkout", "status": "down"}\`.`,
+            },
+        ],
+        notes: [
+            {
+                type: ComponentDocumentationNoteType.Tip,
+                text: "When both objects have the same key, the value in **JSON 2** wins. Objects inside them are replaced, not merged.",
+            },
+            {
+                type: ComponentDocumentationNoteType.Warning,
+                text: "If either value is not an object, the run stops here with an error.",
+            },
+        ],
+        learnMore: [],
+        links: [docsLink("JSON steps guide", WorkflowDocsPaths.json)],
+    };
+};
+//# sourceMappingURL=UtilityDocumentation.js.map

package/build/dist/Types/Workflow/Documentation/UtilityDocumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UtilityDocumentation.js","sourceRoot":"","sources":["../../../../../Types/Workflow/Documentation/UtilityDocumentation.ts"],"names":[],"mappings":"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"}

package/build/dist/Types/Workflow/IncomingEmailTrigger.js

@@ -0,0 +1,275 @@
+import OneUptimeDate from "../Date";
+import EmailAddressList from "../../Utils/Email/EmailAddressList";
+/*
+ * The Incoming Email trigger: every workflow that uses it gets an address of
+ * its own on the server's inbound email domain (INBOUND_EMAIL_DOMAIN, the
+ * domain Incoming Email monitors receive on), and each email sent to that
+ * address starts one run.
+ *
+ * The address is `workflow-{incomingEmailSecretKey}@{inbound domain}`. Like the
+ * Webhook trigger's URL it is a bearer credential - whoever has it can start
+ * the workflow - so the key is a random UUID of its own (never the workflow's
+ * ID, which every reader of the workflow can see) and only people who can edit
+ * the workflow may read or reset it (Workflow.incomingEmailSecretKey).
+ *
+ * The way in is the inbound email webhook Incoming Email monitors already use
+ * (POST /incoming-email/<provider>/<secret>). It tells the two apart by the
+ * recipient's shape (IncomingEmailMonitorAddress.parseRecipient), queues the
+ * email, and the queue worker hands it to the workflow service at
+ * INCOMING_EMAIL_TRIGGER_DELIVERY_PATH, where the trigger
+ * (Server/Types/Workflow/Components/IncomingEmail.ts) finds the workflow and
+ * starts the run.
+ */
+export const INCOMING_EMAIL_TRIGGER_LOCAL_PART_PREFIX = "workflow-";
+/*
+ * Shown in place of the secret key until the reader asks to see it, as the
+ * Webhook trigger's URL is. A fixed length, so it says nothing about the key.
+ */
+export const INCOMING_EMAIL_TRIGGER_SECRET_MASK = "•".repeat(16);
+/*
+ * Where the ingest worker hands an email to the workflow service. Relative to
+ * the workflow service (/workflow), and only for callers with the cluster key.
+ */
+export const INCOMING_EMAIL_TRIGGER_DELIVERY_PATH = "/incoming-email/deliver";
+/*
+ * What became of one email handed to the workflow service. Only Scheduled
+ * starts a run. The rest are not errors - mail to an address nothing uses any
+ * more is ordinary, and the sender is not told either way - so the ingest
+ * worker logs them and moves on rather than retrying.
+ */
+export var IncomingEmailTriggerDeliveryStatus;
+(function (IncomingEmailTriggerDeliveryStatus) {
+    IncomingEmailTriggerDeliveryStatus["Scheduled"] = "Scheduled";
+    // No workflow has this address: it was reset, or never existed.
+    IncomingEmailTriggerDeliveryStatus["NoWorkflow"] = "NoWorkflow";
+    // The workflow's trigger is no longer Incoming Email.
+    IncomingEmailTriggerDeliveryStatus["NotIncomingEmailTrigger"] = "NotIncomingEmailTrigger";
+    // The workflow is off, so it starts no runs.
+    IncomingEmailTriggerDeliveryStatus["WorkflowDisabled"] = "WorkflowDisabled";
+    // The workflow is archived, so it starts no runs until it is unarchived.
+    IncomingEmailTriggerDeliveryStatus["WorkflowArchived"] = "WorkflowArchived";
+})(IncomingEmailTriggerDeliveryStatus || (IncomingEmailTriggerDeliveryStatus = {}));
+/*
+ * The longest body a run is handed, per body. Mail with a larger text or HTML
+ * part is rare (newsletters with inline images come closest), and a run keeps
+ * its trigger's values in its log, so a body is cut here rather than copied
+ * whole into every run's log.
+ */
+export const MAX_INCOMING_EMAIL_TRIGGER_BODY_LENGTH = 1024 * 1024;
+export const INCOMING_EMAIL_TRIGGER_TRUNCATED_SUFFIX = "… [truncated]";
+/*
+ * The values the trigger hands the rest of the workflow. Kept in one place:
+ * the component's metadata, the payload below, the help and the docs all read
+ * these ids.
+ */
+export var IncomingEmailTriggerValue;
+(function (IncomingEmailTriggerValue) {
+    IncomingEmailTriggerValue["From"] = "from";
+    IncomingEmailTriggerValue["To"] = "to";
+    IncomingEmailTriggerValue["Cc"] = "cc";
+    IncomingEmailTriggerValue["Subject"] = "subject";
+    IncomingEmailTriggerValue["Body"] = "body";
+    IncomingEmailTriggerValue["HtmlBody"] = "html-body";
+    IncomingEmailTriggerValue["Headers"] = "headers";
+    IncomingEmailTriggerValue["Attachments"] = "attachments";
+    IncomingEmailTriggerValue["ReceivedAt"] = "received-at";
+})(IncomingEmailTriggerValue || (IncomingEmailTriggerValue = {}));
+const UUID_PATTERN = "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}";
+const LOCAL_PART_PATTERN = new RegExp(`^${INCOMING_EMAIL_TRIGGER_LOCAL_PART_PREFIX}(${UUID_PATTERN})$`, "i");
+export default class IncomingEmailTrigger {
+    static getLocalPart(secretKey) {
+        return `${INCOMING_EMAIL_TRIGGER_LOCAL_PART_PREFIX}${secretKey
+            .toString()
+            .trim()
+            .toLowerCase()}`;
+    }
+    /*
+     * The workflow's address, or null when there is no key to build it from
+     * or the server has no inbound email domain (so nowhere to send mail).
+     */
+    static getAddress(data) {
+        const inboundDomain = (data.inboundDomain || "").trim();
+        const secretKey = (data.secretKey || "").toString().trim();
+        if (!inboundDomain || !secretKey) {
+            return null;
+        }
+        return `${this.getLocalPart(secretKey)}@${inboundDomain}`;
+    }
+    /*
+     * The address with its key masked: `workflow-••••…@inbound.example.com`.
+     * Built without the key, so it can be drawn while the key stays hidden.
+     */
+    static getMaskedAddress(inboundDomain) {
+        return `${INCOMING_EMAIL_TRIGGER_LOCAL_PART_PREFIX}${INCOMING_EMAIL_TRIGGER_SECRET_MASK}@${inboundDomain.trim()}`;
+    }
+    // Whether a local part is a workflow's: `workflow-` and a whole UUID.
+    static isLocalPart(localPart) {
+        return LOCAL_PART_PATTERN.test(localPart.trim());
+    }
+    // The secret key in a workflow's local part, lowercased, or null.
+    static getSecretKeyFromLocalPart(localPart) {
+        const match = localPart
+            .trim()
+            .match(LOCAL_PART_PATTERN);
+        return match && match[1] ? match[1].toLowerCase() : null;
+    }
+    /*
+     * The values a run starts with, from one delivered email. Every value is
+     * there, in the type its metadata names: an address list is one line of
+     * text ("a@example.com, b@example.com"), as a message would quote it.
+     *
+     * The email arrives over the network, so nothing about its shape is taken
+     * on trust: normalizeReturnValues turns whatever is there into those types.
+     */
+    static getReturnValues(email) {
+        return this.normalizeReturnValues({
+            [IncomingEmailTriggerValue.From]: email.from,
+            [IncomingEmailTriggerValue.To]: email.to,
+            [IncomingEmailTriggerValue.Cc]: email.cc,
+            [IncomingEmailTriggerValue.Subject]: email.subject,
+            [IncomingEmailTriggerValue.Body]: email.body,
+            [IncomingEmailTriggerValue.HtmlBody]: email.htmlBody,
+            [IncomingEmailTriggerValue.Headers]: email.headers,
+            [IncomingEmailTriggerValue.Attachments]: email.attachments,
+            [IncomingEmailTriggerValue.ReceivedAt]: email.receivedAt,
+        });
+    }
+    /*
+     * What the trigger hands the next step, whatever it started from: a
+     * delivered email, or the few values someone typed into Run Workflow to
+     * try the workflow out. Every value is present and of its type, so a later
+     * step reading one never gets `undefined`: missing text is "", headers {},
+     * attachments [], and the time received is now.
+     *
+     * Header names are lowercased - email header names are case-insensitive,
+     * and the Webhook trigger hands its headers over the same way - so a
+     * reference such as `headers.message-id` works for every sender.
+     */
+    static normalizeReturnValues(values, now) {
+        const receivedAt = this.toDate(values[IncomingEmailTriggerValue.ReceivedAt]);
+        return {
+            [IncomingEmailTriggerValue.From]: this.toAddressLine(values[IncomingEmailTriggerValue.From]),
+            [IncomingEmailTriggerValue.To]: this.toAddressLine(values[IncomingEmailTriggerValue.To]),
+            [IncomingEmailTriggerValue.Cc]: this.toAddressLine(values[IncomingEmailTriggerValue.Cc]),
+            [IncomingEmailTriggerValue.Subject]: this.toText(values[IncomingEmailTriggerValue.Subject]),
+            [IncomingEmailTriggerValue.Body]: this.toBody(values[IncomingEmailTriggerValue.Body]),
+            [IncomingEmailTriggerValue.HtmlBody]: this.toBody(values[IncomingEmailTriggerValue.HtmlBody]),
+            [IncomingEmailTriggerValue.Headers]: this.toHeaders(values[IncomingEmailTriggerValue.Headers]),
+            [IncomingEmailTriggerValue.Attachments]: this.toAttachments(values[IncomingEmailTriggerValue.Attachments]),
+            [IncomingEmailTriggerValue.ReceivedAt]: OneUptimeDate.toString(receivedAt || now || OneUptimeDate.getCurrentDate()),
+        };
+    }
+    static toText(value) {
+        if (value === null || value === undefined) {
+            return "";
+        }
+        if (typeof value === "string") {
+            return value;
+        }
+        if (typeof value === "number" || typeof value === "boolean") {
+            return String(value);
+        }
+        return "";
+    }
+    /*
+     * A body as long as a run may be handed: cut at
+     * MAX_INCOMING_EMAIL_TRIGGER_BODY_LENGTH, and saying so. Cutting a body
+     * that was already cut changes nothing, so the ingest worker cuts before it
+     * hands the email over - keeping a message with a huge HTML part well
+     * inside the request size limit - and the trigger cuts again, to be sure.
+     */
+    static truncateBody(text) {
+        if (text.length <= MAX_INCOMING_EMAIL_TRIGGER_BODY_LENGTH) {
+            return text;
+        }
+        return (text.slice(0, MAX_INCOMING_EMAIL_TRIGGER_BODY_LENGTH) +
+            INCOMING_EMAIL_TRIGGER_TRUNCATED_SUFFIX);
+    }
+    static toBody(value) {
+        return this.truncateBody(this.toText(value));
+    }
+    /*
+     * "a@example.com, b@example.com" from a list, from a header someone typed
+     * ("Jane <jane@example.com>"), or from text that is not an address at all
+     * (a test run's "From" can be anything) - which is kept as it was typed.
+     */
+    static toAddressLine(value) {
+        if (Array.isArray(value)) {
+            const addresses = [];
+            for (const item of value) {
+                if (typeof item === "string") {
+                    addresses.push(...EmailAddressList.parse(item));
+                }
+            }
+            return EmailAddressList.format(EmailAddressList.merge(addresses));
+        }
+        const text = this.toText(value).trim();
+        if (!text) {
+            return "";
+        }
+        const addresses = EmailAddressList.parse(text);
+        return addresses.length > 0 ? EmailAddressList.format(addresses) : text;
+    }
+    static toHeaders(value) {
+        let source = value;
+        if (typeof source === "string") {
+            try {
+                source = JSON.parse(source);
+            }
+            catch (_a) {
+                return {};
+            }
+        }
+        if (!source || typeof source !== "object" || Array.isArray(source)) {
+            return {};
+        }
+        const headers = {};
+        for (const [name, headerValue] of Object.entries(source)) {
+            const key = name.trim().toLowerCase();
+            if (!key) {
+                continue;
+            }
+            headers[key] = this.toText(headerValue);
+        }
+        return headers;
+    }
+    static toAttachments(value) {
+        let source = value;
+        if (typeof source === "string") {
+            try {
+                source = JSON.parse(source);
+            }
+            catch (_a) {
+                return [];
+            }
+        }
+        if (!Array.isArray(source)) {
+            return [];
+        }
+        const attachments = [];
+        for (const item of source) {
+            if (!item || typeof item !== "object" || Array.isArray(item)) {
+                continue;
+            }
+            const attachment = item;
+            const size = Number(attachment["size"]);
+            attachments.push({
+                filename: this.toText(attachment["filename"]),
+                contentType: this.toText(attachment["contentType"]),
+                size: Number.isFinite(size) && size > 0 ? Math.floor(size) : 0,
+            });
+        }
+        return attachments;
+    }
+    static toDate(value) {
+        if (value instanceof Date) {
+            return isNaN(value.getTime()) ? null : value;
+        }
+        if (typeof value !== "string" || !value.trim()) {
+            return null;
+        }
+        const date = new Date(value);
+        return isNaN(date.getTime()) ? null : date;
+    }
+}
+//# sourceMappingURL=IncomingEmailTrigger.js.map

package/build/dist/Types/Workflow/IncomingEmailTrigger.js.map

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