@automate.ax/catalog 0.63.0 → 0.65.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, cloudflareService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, type IntegrationServiceId, } from "./catalog.js";
 export { defineIntegrationCatalog, defineIntegrationService, integrationScope, type IntegrationAccountConnectionOption, type IntegrationAccountRequirement, type IntegrationConnectionDefinition, type IntegrationFormField, type IntegrationScopeRequirement, type IntegrationServiceDefinition, type ScopeRequirementGroup, type TriggerDefinition, type TriggerPresentation, type TriggerPresentationContext, type TriggerPresentationDetail, type TriggerScopePresentation, type TriggerPresentationValue, } from "./types.js";
-export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, type TriggerType, } from "./triggers/index.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, PLATFORM_EMAIL_DOMAIN, triggerCatalog, triggerDefinitions, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, type MailhookAddressOptions, type MailhookScope, type TriggerType, } from "./triggers/index.js";

package/dist/index.js

@@ -1,3 +1,3 @@
 export { airtableService, anthropicService, apolloService, asanaService, brevoService, cerebrasService, cloudflareService, cohereService, deepinfraService, deepseekService, firecrawlService, fireworksService, getIntegrationService, githubService, googleGenaiService, googleService, groqService, huggingfaceService, integrationCatalog, linearService, microsoftService, millionverifierService, mistralService, openaiService, openrouterService, perplexityService, postgresService, resendService, scrapflyService, slackService, tidycalService, togetheraiService, trelloService, vercelAiGatewayService, vercelService, whatsappService, xaiService, } from "./catalog.js";
 export { defineIntegrationCatalog, defineIntegrationService, integrationScope, } from "./types.js";
-export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, DASHBOARD_RUN_CONFIG_SCHEMA, getTriggerDefinition, getTriggerName, getTriggerPresentation, isTriggerVisible, PLATFORM_EMAIL_DOMAIN, triggerCatalog, triggerDefinitions, } from "./triggers/index.js";

package/dist/triggers/core.d.ts

@@ -1,44 +1,97 @@
 import * as z from "zod/mini";
 export declare const DASHBOARD_RUN_CONFIG_SCHEMA: z.ZodMiniObject<{
     description: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    fields: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    fields: z.ZodMiniPrefault<z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+        defaultValue: z.ZodMiniOptional<z.ZodMiniString<string>>;
         maxLength: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
         minLength: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
         placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
         type: z.ZodMiniEnum<{
             email: "email";
             text: "text";
             url: "url";
+            phone: "phone";
             textarea: "textarea";
         }>;
         description: z.ZodMiniOptional<z.ZodMiniString<string>>;
         label: z.ZodMiniString<string>;
-        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+        name: z.ZodMiniString<string>;
     }, z.core.$strip>, z.ZodMiniObject<{
+        defaultValue: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
         max: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
         min: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
         placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
         step: z.ZodMiniPrefault<z.ZodMiniNumber<number>>;
         type: z.ZodMiniLiteral<"number">;
         description: z.ZodMiniOptional<z.ZodMiniString<string>>;
         label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        defaultValue: z.ZodMiniOptional<z.iso.ZodMiniISODate>;
+        max: z.ZodMiniOptional<z.iso.ZodMiniISODate>;
+        min: z.ZodMiniOptional<z.iso.ZodMiniISODate>;
         required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+        step: z.ZodMiniPrefault<z.ZodMiniNumberFormat>;
+        type: z.ZodMiniLiteral<"date">;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
     }, z.core.$strip>, z.ZodMiniObject<{
+        defaultValue: z.ZodMiniOptional<z.iso.ZodMiniISODateTime>;
+        max: z.ZodMiniOptional<z.iso.ZodMiniISODateTime>;
+        min: z.ZodMiniOptional<z.iso.ZodMiniISODateTime>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+        step: z.ZodMiniPrefault<z.ZodMiniNumber<number>>;
+        type: z.ZodMiniLiteral<"datetime">;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"select">;
+        defaultValue: z.ZodMiniOptional<z.ZodMiniString<string>>;
         options: z.ZodMiniArray<z.ZodMiniObject<{
             label: z.ZodMiniString<string>;
             value: z.ZodMiniString<string>;
         }, z.core.$strip>>;
         placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        type: z.ZodMiniLiteral<"select">;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
         description: z.ZodMiniOptional<z.ZodMiniString<string>>;
         label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        type: z.ZodMiniLiteral<"radio">;
+        defaultValue: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        options: z.ZodMiniArray<z.ZodMiniObject<{
+            label: z.ZodMiniString<string>;
+            value: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
         required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
     }, z.core.$strip>, z.ZodMiniObject<{
-        type: z.ZodMiniLiteral<"checkbox">;
+        defaultValue: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        options: z.ZodMiniArray<z.ZodMiniObject<{
+            label: z.ZodMiniString<string>;
+            value: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        placeholder: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
+        type: z.ZodMiniLiteral<"multi-select">;
         description: z.ZodMiniOptional<z.ZodMiniString<string>>;
         label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        defaultValue: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
         required: z.ZodMiniPrefault<z.ZodMiniBoolean<boolean>>;
-    }, z.core.$strip>], "type">>;
+        type: z.ZodMiniLiteral<"checkbox">;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        label: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+    }, z.core.$strip>], "type">>>;
     submitLabel: z.ZodMiniPrefault<z.ZodMiniString<string>>;
     title: z.ZodMiniString<string>;
 }, z.core.$strip>;
@@ -70,6 +123,15 @@ export declare const coreTriggerDefinitions: {
         readonly name: "HTTP request";
         readonly type: "http.request";
     };
+    readonly mailhookEmailReceived: {
+        readonly getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }: import("..").TriggerPresentationContext) => {
+            copyable: true;
+            value: string;
+        };
+        readonly icon: "webhook";
+        readonly name: "Mailhook";
+        readonly type: "mailhook.email.received";
+    };
     readonly dashboardRun: {
         readonly getDetails: ({ config }: import("..").TriggerPresentationContext) => {
             label: string;
@@ -85,15 +147,19 @@ interface DashboardRunFieldBase {
     description?: string;
     /** Visible field label. */
     label: string;
+    /** Property name used in submitted trigger data. */
+    name: string;
     /** Whether the form must contain a value. Defaults to true. */
     required?: boolean;
 }
 export type DashboardRunField = (DashboardRunFieldBase & {
+    defaultValue?: string;
     maxLength?: number;
     minLength?: number;
     placeholder?: string;
-    type: "email" | "text" | "textarea" | "url";
+    type: "email" | "phone" | "text" | "textarea" | "url";
 }) | (DashboardRunFieldBase & {
+    defaultValue?: number;
     max?: number;
     min?: number;
     placeholder?: string;
@@ -101,6 +167,23 @@ export type DashboardRunField = (DashboardRunFieldBase & {
     step?: number;
     type: "number";
 }) | (DashboardRunFieldBase & {
+    /** Initial local date in `YYYY-MM-DD` format. */
+    defaultValue?: string;
+    max?: string;
+    min?: string;
+    /** Allowed increment in days. Defaults to 1. */
+    step?: number;
+    type: "date";
+}) | (DashboardRunFieldBase & {
+    /** Initial local date and time in `YYYY-MM-DDTHH:mm` format. */
+    defaultValue?: string;
+    max?: string;
+    min?: string;
+    /** Allowed increment in seconds. Defaults to 60. */
+    step?: number;
+    type: "datetime";
+}) | (DashboardRunFieldBase & {
+    defaultValue?: string;
     options: readonly {
         label: string;
         value: string;
@@ -108,13 +191,32 @@ export type DashboardRunField = (DashboardRunFieldBase & {
     placeholder?: string;
     type: "select";
 }) | (DashboardRunFieldBase & {
+    defaultValue?: string;
+    options: readonly {
+        label: string;
+        value: string;
+    }[];
+    type: "radio";
+}) | (DashboardRunFieldBase & {
+    defaultValue?: readonly string[];
+    options: readonly {
+        label: string;
+        value: string;
+    }[];
+    placeholder?: string;
+    type: "multi-select";
+}) | (DashboardRunFieldBase & {
+    /** Initial checked state. Defaults to false. */
+    defaultValue?: boolean;
+    /** Whether the checkbox must be checked. Defaults to false. */
+    required?: boolean;
     type: "checkbox";
 });
-export interface DashboardRunConfig<TFields extends Record<string, DashboardRunField> = Record<string, DashboardRunField>> {
+export interface DashboardRunConfig<TFields extends readonly DashboardRunField[] = readonly DashboardRunField[]> {
     /** Supporting text shown below the form title. */
     description?: string;
-    /** Named fields rendered in declaration order. */
-    fields: TFields;
+    /** Ordered fields. Omit to run immediately. */
+    fields?: TFields;
     /** Submit button text. Defaults to "Run". */
     submitLabel?: string;
     /** Form heading. */
@@ -127,6 +229,8 @@ export interface DashboardRunEndpointOptions {
     scopePath?: readonly number[];
 }
 export type HttpTriggerScope = "trigger" | "automation" | "project";
+export type MailhookScope = HttpTriggerScope;
+export declare const PLATFORM_EMAIL_DOMAIN = "automations.automate.ax";
 export interface HttpTriggerEndpointOptions {
     appOrigin: string;
     automationId: string;
@@ -135,6 +239,14 @@ export interface HttpTriggerEndpointOptions {
     scope: HttpTriggerScope;
     scopePath?: readonly number[];
 }
+export interface MailhookAddressOptions {
+    automationId: string;
+    hookSlot: number;
+    plusPath?: string;
+    projectId: string;
+    scope: MailhookScope;
+    scopePath?: readonly number[];
+}
 /**
  * Returns the public URL for one deployed HTTP trigger.
  *
@@ -147,6 +259,21 @@ export declare function getHttpTriggerEndpoint(options: HttpTriggerEndpointOptio
  * @param options - Trigger and owning resource identity.
  */
 export declare function getHttpTriggerEndpointKey(options: Omit<HttpTriggerEndpointOptions, "appOrigin">): string;
+/**
+ * Returns the unique inbound address for one deployed mailhook.
+ *
+ * Add `+suffix` before the `@` to carry a routing value into the event.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ * @throws When the generated local part exceeds the email size limit.
+ */
+export declare function getMailhookAddress(options: MailhookAddressOptions): string;
+/**
+ * Returns the local-part router key for one configured mailhook scope.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ */
+export declare function getMailhookAddressKey(options: MailhookAddressOptions): string;
 /**
  * Returns the organization-authenticated submission endpoint for one dashboard
  * run.

package/dist/triggers/core.js

@@ -1,4 +1,7 @@
 import * as z from "zod/mini";
+const MAX_EMAIL_LOCAL_PART_BYTES = 64;
+const EMAIL_SCHEMA = z.email();
+const URL_SCHEMA = z.url();
 const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
     schedule: z.string(),
     timeZone: z.prefault(z.string(), "UTC"),
@@ -6,6 +9,9 @@ const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
 const HTTP_PRESENTATION_CONFIG_SCHEMA = z.object({
     scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
 });
+const MAILHOOK_PRESENTATION_CONFIG_SCHEMA = z.object({
+    scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
+});
 const INVOCATION_PRESENTATION_CONFIG_SCHEMA = z.object({
     entrypoint: z.string(),
 });
@@ -20,25 +26,48 @@ const FIELD_LENGTH_SCHEMA = z.int().check(z.nonnegative());
 const DASHBOARD_RUN_FIELD_BASE_SCHEMA = {
     description: z.optional(FIELD_DESCRIPTION_SCHEMA),
     label: FIELD_LABEL_SCHEMA,
-    required: z.prefault(z.boolean(), true),
+    name: FIELD_NAME_SCHEMA,
 };
 const DASHBOARD_RUN_TEXT_FIELD_SCHEMA = z.object({
     ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.optional(z.string()),
     maxLength: z.optional(FIELD_LENGTH_SCHEMA),
     minLength: z.optional(FIELD_LENGTH_SCHEMA),
     placeholder: z.optional(z.string()),
-    type: z.enum(["email", "text", "textarea", "url"]),
+    required: z.prefault(z.boolean(), true),
+    type: z.enum(["email", "phone", "text", "textarea", "url"]),
 });
 const DASHBOARD_RUN_NUMBER_FIELD_SCHEMA = z.object({
     ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.optional(z.number()),
     max: z.optional(z.number()),
     min: z.optional(z.number()),
     placeholder: z.optional(z.string()),
+    required: z.prefault(z.boolean(), true),
     step: z.prefault(z.number().check(z.positive()), 1),
     type: z.literal("number"),
 });
-const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+const DASHBOARD_RUN_DATE_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.optional(z.iso.date()),
+    max: z.optional(z.iso.date()),
+    min: z.optional(z.iso.date()),
+    required: z.prefault(z.boolean(), true),
+    step: z.prefault(z.int().check(z.positive()), 1),
+    type: z.literal("date"),
+});
+const DASHBOARD_RUN_DATETIME_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.optional(z.iso.datetime({ local: true })),
+    max: z.optional(z.iso.datetime({ local: true })),
+    min: z.optional(z.iso.datetime({ local: true })),
+    required: z.prefault(z.boolean(), true),
+    step: z.prefault(z.number().check(z.positive()), 60),
+    type: z.literal("datetime"),
+});
+const DASHBOARD_RUN_CHOICE_FIELD_SCHEMA = {
     ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.optional(FIELD_NAME_SCHEMA),
     options: z
         .array(z.object({
         label: FIELD_LABEL_SCHEMA,
@@ -46,20 +75,49 @@ const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
     }))
         .check(z.minLength(1)),
     placeholder: z.optional(z.string()),
+    required: z.prefault(z.boolean(), true),
+};
+const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_CHOICE_FIELD_SCHEMA,
     type: z.literal("select"),
 });
+const DASHBOARD_RUN_RADIO_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_CHOICE_FIELD_SCHEMA,
+    type: z.literal("radio"),
+});
+const DASHBOARD_RUN_MULTI_SELECT_FIELD_SCHEMA = z.object({
+    ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.optional(z.array(FIELD_NAME_SCHEMA)),
+    options: z
+        .array(z.object({
+        label: FIELD_LABEL_SCHEMA,
+        value: FIELD_NAME_SCHEMA,
+    }))
+        .check(z.minLength(1)),
+    placeholder: z.optional(z.string()),
+    required: z.prefault(z.boolean(), true),
+    type: z.literal("multi-select"),
+});
 const DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA = z.object({
     ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+    defaultValue: z.prefault(z.boolean(), false),
+    required: z.prefault(z.boolean(), false),
     type: z.literal("checkbox"),
 });
+const DASHBOARD_RUN_FIELD_SCHEMA = z.discriminatedUnion("type", [
+    DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
+    DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
+    DASHBOARD_RUN_DATE_FIELD_SCHEMA,
+    DASHBOARD_RUN_DATETIME_FIELD_SCHEMA,
+    DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
+    DASHBOARD_RUN_RADIO_FIELD_SCHEMA,
+    DASHBOARD_RUN_MULTI_SELECT_FIELD_SCHEMA,
+    DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
+]);
+const DASHBOARD_RUN_FIELDS_SCHEMA = z.array(DASHBOARD_RUN_FIELD_SCHEMA).check(z.refine((fields) => new Set(fields.map((field) => field.name)).size === fields.length, "Dashboard run field names must be unique."), z.refine((fields) => fields.every(isDashboardRunFieldDefaultValid), "Dashboard run field defaults must satisfy their field constraints."));
 export const DASHBOARD_RUN_CONFIG_SCHEMA = z.object({
     description: z.optional(FIELD_DESCRIPTION_SCHEMA),
-    fields: z.record(FIELD_NAME_SCHEMA, z.discriminatedUnion("type", [
-        DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
-        DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
-        DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
-        DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
-    ])),
+    fields: z.prefault(DASHBOARD_RUN_FIELDS_SCHEMA, []),
     submitLabel: z.prefault(z.string().check(z.trim(), z.minLength(1), z.maxLength(100)), "Run"),
     title: z.string().check(z.trim(), z.minLength(1), z.maxLength(255)),
 });
@@ -103,6 +161,21 @@ export const coreTriggerDefinitions = {
         name: "HTTP request",
         type: "http.request",
     },
+    mailhookEmailReceived: {
+        getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }) => ({
+            copyable: true,
+            value: getMailhookAddress({
+                automationId,
+                hookSlot,
+                projectId,
+                scope: MAILHOOK_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+                scopePath,
+            }),
+        }),
+        icon: "webhook",
+        name: "Mailhook",
+        type: "mailhook.email.received",
+    },
     dashboardRun: {
         getDetails: ({ config }) => [
             {
@@ -115,6 +188,7 @@ export const coreTriggerDefinitions = {
         type: "dashboard.run",
     },
 };
+export const PLATFORM_EMAIL_DOMAIN = "automations.automate.ax";
 /**
  * Returns the public URL for one deployed HTTP trigger.
  *
@@ -138,6 +212,39 @@ export function getHttpTriggerEndpointKey(options) {
         options.hookSlot,
     ].join(".")}`;
 }
+/**
+ * Returns the unique inbound address for one deployed mailhook.
+ *
+ * Add `+suffix` before the `@` to carry a routing value into the event.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ * @throws When the generated local part exceeds the email size limit.
+ */
+export function getMailhookAddress(options) {
+    const localPart = `${getMailhookAddressKey(options)}${options.plusPath ? `+${options.plusPath}` : ""}`;
+    if (new TextEncoder().encode(localPart).length > MAX_EMAIL_LOCAL_PART_BYTES) {
+        throw new RangeError("Mailhook address local part exceeds 64 bytes.");
+    }
+    return EMAIL_SCHEMA.parse(`${localPart}@${PLATFORM_EMAIL_DOMAIN}`);
+}
+/**
+ * Returns the local-part router key for one configured mailhook scope.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ */
+export function getMailhookAddressKey(options) {
+    if (options.scope === "project")
+        return `p${typeIdSuffix(options.projectId)}`;
+    if (options.scope === "automation") {
+        return `a${typeIdSuffix(options.automationId)}`;
+    }
+    return `a${typeIdSuffix(options.automationId)}.${[
+        ...(options.scopePath ?? []),
+        options.hookSlot,
+    ]
+        .map((segment) => segment.toString(36))
+        .join(".")}`;
+}
 /**
  * Returns the organization-authenticated submission endpoint for one dashboard
  * run.
@@ -158,3 +265,68 @@ export function getDashboardRunEndpointKey(options) {
         options.hookSlot,
     ].join(".")}`;
 }
+/**
+ * Checks a configured default against the same constraints as submitted data.
+ *
+ * @param field - Field definition to validate.
+ */
+function isDashboardRunFieldDefaultValid(field) {
+    if (field.type === "checkbox" || field.defaultValue === undefined)
+        return true;
+    if (field.type === "multi-select") {
+        if (field.required !== false && field.defaultValue.length === 0)
+            return false;
+        return field.defaultValue.every((value) => field.options.some((option) => option.value === value));
+    }
+    if (field.type === "radio" || field.type === "select") {
+        return field.options.some((option) => option.value === field.defaultValue);
+    }
+    if (field.type === "number") {
+        return ((field.min === undefined || field.defaultValue >= field.min) &&
+            (field.max === undefined || field.defaultValue <= field.max) &&
+            !isDashboardRunStepMismatch(field.defaultValue, field.min ?? field.defaultValue, field.step ?? 1));
+    }
+    if (field.type === "date" || field.type === "datetime") {
+        const defaultValue = parseDashboardRunDateValue(field.type, field.defaultValue);
+        return ((field.min === undefined ||
+            defaultValue >= parseDashboardRunDateValue(field.type, field.min)) &&
+            (field.max === undefined ||
+                defaultValue <= parseDashboardRunDateValue(field.type, field.max)) &&
+            !isDashboardRunStepMismatch(defaultValue, parseDashboardRunDateValue(field.type, field.min ?? field.defaultValue), (field.step ?? (field.type === "date" ? 1 : 60)) *
+                (field.type === "date" ? 86_400_000 : 1_000)));
+    }
+    const defaultValue = field.defaultValue.trim();
+    return ((defaultValue.length > 0 || field.required === false) &&
+        (field.minLength === undefined || defaultValue.length >= field.minLength) &&
+        (field.maxLength === undefined || defaultValue.length <= field.maxLength) &&
+        (field.type !== "email" || EMAIL_SCHEMA.safeParse(defaultValue).success) &&
+        (field.type !== "url" || URL_SCHEMA.safeParse(defaultValue).success));
+}
+/**
+ * Checks whether a value falls outside an allowed step interval.
+ *
+ * @param value - Configured default value.
+ * @param base - Value from which step intervals begin.
+ * @param step - Allowed interval size.
+ */
+function isDashboardRunStepMismatch(value, base, step) {
+    const intervals = (value - base) / step;
+    return Math.abs(intervals - Math.round(intervals)) > 1e-9;
+}
+/**
+ * Converts a validated local date or date-time string to a UTC number.
+ *
+ * @param type - Temporal field type.
+ * @param value - Local ISO value to convert.
+ */
+function parseDashboardRunDateValue(type, value) {
+    return Date.parse(type === "date" ? `${value}T00:00:00Z` : `${value}Z`);
+}
+/**
+ * Removes the redundant TypeID prefix from an address router.
+ *
+ * @param id - Project or automation TypeID.
+ */
+function typeIdSuffix(id) {
+    return id.includes("_") ? id.slice(id.indexOf("_") + 1) : id;
+}

package/dist/triggers/index.d.ts

@@ -1,5 +1,5 @@
 import type { TriggerDefinition, TriggerPresentation, TriggerPresentationContext, TriggerScopePresentation } from "../types.js";
-export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, DASHBOARD_RUN_CONFIG_SCHEMA, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, } from "./core.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, PLATFORM_EMAIL_DOMAIN, DASHBOARD_RUN_CONFIG_SCHEMA, type DashboardRunConfig, type DashboardRunEndpointOptions, type DashboardRunField, type HttpTriggerEndpointOptions, type HttpTriggerScope, type MailhookAddressOptions, type MailhookScope, } from "./core.js";
 /** Plain shared definitions for every public trigger type. */
 export declare const triggerDefinitions: {
     readonly whatsappMessageDelivered: {
@@ -1075,6 +1075,15 @@ export declare const triggerDefinitions: {
         readonly name: "HTTP request";
         readonly type: "http.request";
     };
+    readonly mailhookEmailReceived: {
+        readonly getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }: TriggerPresentationContext) => {
+            copyable: true;
+            value: string;
+        };
+        readonly icon: "webhook";
+        readonly name: "Mailhook";
+        readonly type: "mailhook.email.received";
+    };
     readonly dashboardRun: {
         readonly getDetails: ({ config }: TriggerPresentationContext) => {
             label: string;
@@ -1564,6 +1573,14 @@ export declare const triggerCatalog: ({
     };
     icon: "webhook";
     type: "http.request";
+} | {
+    name: string;
+    getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }: TriggerPresentationContext) => {
+        copyable: true;
+        value: string;
+    };
+    icon: "webhook";
+    type: "mailhook.email.received";
 } | {
     name: string;
     getDetails: ({ config }: TriggerPresentationContext) => {

package/dist/triggers/index.js

@@ -12,7 +12,7 @@ import { trelloTriggerDefinitions } from "./trello.js";
 import { vercelTriggerDefinitions } from "./vercel.js";
 import { whatsappTriggerDefinitions } from "./whatsapp.js";
 import { getIntegrationService } from "../catalog.js";
-export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, DASHBOARD_RUN_CONFIG_SCHEMA, } from "./core.js";
+export { getDashboardRunEndpoint, getDashboardRunEndpointKey, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, getMailhookAddress, getMailhookAddressKey, PLATFORM_EMAIL_DOMAIN, DASHBOARD_RUN_CONFIG_SCHEMA, } from "./core.js";
 /** Plain shared definitions for every public trigger type. */
 export const triggerDefinitions = {
     ...airtableTriggerDefinitions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/catalog",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "Shared integration service and trigger definitions for Automate.ax.",
   "license": "MIT",
   "repository": {

package/src/index.ts

@@ -61,11 +61,14 @@ export {
   getDashboardRunEndpointKey,
   getHttpTriggerEndpoint,
   getHttpTriggerEndpointKey,
+  getMailhookAddress,
+  getMailhookAddressKey,
   DASHBOARD_RUN_CONFIG_SCHEMA,
   getTriggerDefinition,
   getTriggerName,
   getTriggerPresentation,
   isTriggerVisible,
+  PLATFORM_EMAIL_DOMAIN,
   triggerCatalog,
   triggerDefinitions,
   type DashboardRunConfig,
@@ -73,5 +76,7 @@ export {
   type DashboardRunField,
   type HttpTriggerEndpointOptions,
   type HttpTriggerScope,
+  type MailhookAddressOptions,
+  type MailhookScope,
   type TriggerType,
 } from "./triggers"

package/src/triggers/core.ts

@@ -1,6 +1,9 @@
 import type { TriggerDefinition } from "../types"
 import * as z from "zod/mini"
 
+const MAX_EMAIL_LOCAL_PART_BYTES = 64
+const EMAIL_SCHEMA = z.email()
+const URL_SCHEMA = z.url()
 const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
   schedule: z.string(),
   timeZone: z.prefault(z.string(), "UTC"),
@@ -8,6 +11,9 @@ const CRON_PRESENTATION_CONFIG_SCHEMA = z.object({
 const HTTP_PRESENTATION_CONFIG_SCHEMA = z.object({
   scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
 })
+const MAILHOOK_PRESENTATION_CONFIG_SCHEMA = z.object({
+  scope: z.prefault(z.enum(["trigger", "automation", "project"]), "trigger"),
+})
 const INVOCATION_PRESENTATION_CONFIG_SCHEMA = z.object({
   entrypoint: z.string(),
 })
@@ -22,25 +28,48 @@ const FIELD_LENGTH_SCHEMA = z.int().check(z.nonnegative())
 const DASHBOARD_RUN_FIELD_BASE_SCHEMA = {
   description: z.optional(FIELD_DESCRIPTION_SCHEMA),
   label: FIELD_LABEL_SCHEMA,
-  required: z.prefault(z.boolean(), true),
+  name: FIELD_NAME_SCHEMA,
 }
 const DASHBOARD_RUN_TEXT_FIELD_SCHEMA = z.object({
   ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.string()),
   maxLength: z.optional(FIELD_LENGTH_SCHEMA),
   minLength: z.optional(FIELD_LENGTH_SCHEMA),
   placeholder: z.optional(z.string()),
-  type: z.enum(["email", "text", "textarea", "url"]),
+  required: z.prefault(z.boolean(), true),
+  type: z.enum(["email", "phone", "text", "textarea", "url"]),
 })
 const DASHBOARD_RUN_NUMBER_FIELD_SCHEMA = z.object({
   ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.number()),
   max: z.optional(z.number()),
   min: z.optional(z.number()),
   placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
   step: z.prefault(z.number().check(z.positive()), 1),
   type: z.literal("number"),
 })
-const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+const DASHBOARD_RUN_DATE_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.iso.date()),
+  max: z.optional(z.iso.date()),
+  min: z.optional(z.iso.date()),
+  required: z.prefault(z.boolean(), true),
+  step: z.prefault(z.int().check(z.positive()), 1),
+  type: z.literal("date"),
+})
+const DASHBOARD_RUN_DATETIME_FIELD_SCHEMA = z.object({
   ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.iso.datetime({ local: true })),
+  max: z.optional(z.iso.datetime({ local: true })),
+  min: z.optional(z.iso.datetime({ local: true })),
+  required: z.prefault(z.boolean(), true),
+  step: z.prefault(z.number().check(z.positive()), 60),
+  type: z.literal("datetime"),
+})
+const DASHBOARD_RUN_CHOICE_FIELD_SCHEMA = {
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(FIELD_NAME_SCHEMA),
   options: z
     .array(
       z.object({
@@ -50,24 +79,62 @@ const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
     )
     .check(z.minLength(1)),
   placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
+}
+const DASHBOARD_RUN_SELECT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_CHOICE_FIELD_SCHEMA,
   type: z.literal("select"),
 })
+const DASHBOARD_RUN_RADIO_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_CHOICE_FIELD_SCHEMA,
+  type: z.literal("radio"),
+})
+const DASHBOARD_RUN_MULTI_SELECT_FIELD_SCHEMA = z.object({
+  ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.optional(z.array(FIELD_NAME_SCHEMA)),
+  options: z
+    .array(
+      z.object({
+        label: FIELD_LABEL_SCHEMA,
+        value: FIELD_NAME_SCHEMA,
+      }),
+    )
+    .check(z.minLength(1)),
+  placeholder: z.optional(z.string()),
+  required: z.prefault(z.boolean(), true),
+  type: z.literal("multi-select"),
+})
 const DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA = z.object({
   ...DASHBOARD_RUN_FIELD_BASE_SCHEMA,
+  defaultValue: z.prefault(z.boolean(), false),
+  required: z.prefault(z.boolean(), false),
   type: z.literal("checkbox"),
 })
+const DASHBOARD_RUN_FIELD_SCHEMA = z.discriminatedUnion("type", [
+  DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
+  DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
+  DASHBOARD_RUN_DATE_FIELD_SCHEMA,
+  DASHBOARD_RUN_DATETIME_FIELD_SCHEMA,
+  DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
+  DASHBOARD_RUN_RADIO_FIELD_SCHEMA,
+  DASHBOARD_RUN_MULTI_SELECT_FIELD_SCHEMA,
+  DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
+])
+const DASHBOARD_RUN_FIELDS_SCHEMA = z.array(DASHBOARD_RUN_FIELD_SCHEMA).check(
+  z.refine(
+    (fields) =>
+      new Set(fields.map((field) => field.name)).size === fields.length,
+    "Dashboard run field names must be unique.",
+  ),
+  z.refine(
+    (fields) => fields.every(isDashboardRunFieldDefaultValid),
+    "Dashboard run field defaults must satisfy their field constraints.",
+  ),
+)
 
 export const DASHBOARD_RUN_CONFIG_SCHEMA = z.object({
   description: z.optional(FIELD_DESCRIPTION_SCHEMA),
-  fields: z.record(
-    FIELD_NAME_SCHEMA,
-    z.discriminatedUnion("type", [
-      DASHBOARD_RUN_TEXT_FIELD_SCHEMA,
-      DASHBOARD_RUN_NUMBER_FIELD_SCHEMA,
-      DASHBOARD_RUN_SELECT_FIELD_SCHEMA,
-      DASHBOARD_RUN_CHECKBOX_FIELD_SCHEMA,
-    ]),
-  ),
+  fields: z.prefault(DASHBOARD_RUN_FIELDS_SCHEMA, []),
   submitLabel: z.prefault(
     z.string().check(z.trim(), z.minLength(1), z.maxLength(100)),
     "Run",
@@ -123,6 +190,21 @@ export const coreTriggerDefinitions = {
     name: "HTTP request",
     type: "http.request",
   },
+  mailhookEmailReceived: {
+    getPrimary: ({ automationId, config, hookSlot, projectId, scopePath }) => ({
+      copyable: true,
+      value: getMailhookAddress({
+        automationId,
+        hookSlot,
+        projectId,
+        scope: MAILHOOK_PRESENTATION_CONFIG_SCHEMA.parse(config).scope,
+        scopePath,
+      }),
+    }),
+    icon: "webhook",
+    name: "Mailhook",
+    type: "mailhook.email.received",
+  },
   dashboardRun: {
     getDetails: ({ config }) => [
       {
@@ -143,18 +225,23 @@ interface DashboardRunFieldBase {
   /** Visible field label. */
   label: string
 
+  /** Property name used in submitted trigger data. */
+  name: string
+
   /** Whether the form must contain a value. Defaults to true. */
   required?: boolean
 }
 
 export type DashboardRunField =
   | (DashboardRunFieldBase & {
+      defaultValue?: string
       maxLength?: number
       minLength?: number
       placeholder?: string
-      type: "email" | "text" | "textarea" | "url"
+      type: "email" | "phone" | "text" | "textarea" | "url"
     })
   | (DashboardRunFieldBase & {
+      defaultValue?: number
       max?: number
       min?: number
       placeholder?: string
@@ -164,25 +251,59 @@ export type DashboardRunField =
       type: "number"
     })
   | (DashboardRunFieldBase & {
+      /** Initial local date in `YYYY-MM-DD` format. */
+      defaultValue?: string
+      max?: string
+      min?: string
+
+      /** Allowed increment in days. Defaults to 1. */
+      step?: number
+      type: "date"
+    })
+  | (DashboardRunFieldBase & {
+      /** Initial local date and time in `YYYY-MM-DDTHH:mm` format. */
+      defaultValue?: string
+      max?: string
+      min?: string
+
+      /** Allowed increment in seconds. Defaults to 60. */
+      step?: number
+      type: "datetime"
+    })
+  | (DashboardRunFieldBase & {
+      defaultValue?: string
       options: readonly { label: string; value: string }[]
       placeholder?: string
       type: "select"
     })
   | (DashboardRunFieldBase & {
+      defaultValue?: string
+      options: readonly { label: string; value: string }[]
+      type: "radio"
+    })
+  | (DashboardRunFieldBase & {
+      defaultValue?: readonly string[]
+      options: readonly { label: string; value: string }[]
+      placeholder?: string
+      type: "multi-select"
+    })
+  | (DashboardRunFieldBase & {
+      /** Initial checked state. Defaults to false. */
+      defaultValue?: boolean
+
+      /** Whether the checkbox must be checked. Defaults to false. */
+      required?: boolean
       type: "checkbox"
     })
 
 export interface DashboardRunConfig<
-  TFields extends Record<string, DashboardRunField> = Record<
-    string,
-    DashboardRunField
-  >,
+  TFields extends readonly DashboardRunField[] = readonly DashboardRunField[],
 > {
   /** Supporting text shown below the form title. */
   description?: string
 
-  /** Named fields rendered in declaration order. */
-  fields: TFields
+  /** Ordered fields. Omit to run immediately. */
+  fields?: TFields
 
   /** Submit button text. Defaults to "Run". */
   submitLabel?: string
@@ -199,6 +320,9 @@ export interface DashboardRunEndpointOptions {
 }
 
 export type HttpTriggerScope = "trigger" | "automation" | "project"
+export type MailhookScope = HttpTriggerScope
+
+export const PLATFORM_EMAIL_DOMAIN = "automations.automate.ax"
 
 export interface HttpTriggerEndpointOptions {
   appOrigin: string
@@ -209,6 +333,15 @@ export interface HttpTriggerEndpointOptions {
   scopePath?: readonly number[]
 }
 
+export interface MailhookAddressOptions {
+  automationId: string
+  hookSlot: number
+  plusPath?: string
+  projectId: string
+  scope: MailhookScope
+  scopePath?: readonly number[]
+}
+
 /**
  * Returns the public URL for one deployed HTTP trigger.
  *
@@ -237,6 +370,42 @@ export function getHttpTriggerEndpointKey(
   ].join(".")}`
 }
 
+/**
+ * Returns the unique inbound address for one deployed mailhook.
+ *
+ * Add `+suffix` before the `@` to carry a routing value into the event.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ * @throws When the generated local part exceeds the email size limit.
+ */
+export function getMailhookAddress(options: MailhookAddressOptions) {
+  const localPart = `${getMailhookAddressKey(options)}${options.plusPath ? `+${options.plusPath}` : ""}`
+  if (new TextEncoder().encode(localPart).length > MAX_EMAIL_LOCAL_PART_BYTES) {
+    throw new RangeError("Mailhook address local part exceeds 64 bytes.")
+  }
+
+  return EMAIL_SCHEMA.parse(`${localPart}@${PLATFORM_EMAIL_DOMAIN}`)
+}
+
+/**
+ * Returns the local-part router key for one configured mailhook scope.
+ *
+ * @param options - Mailhook identity and sharing scope.
+ */
+export function getMailhookAddressKey(options: MailhookAddressOptions) {
+  if (options.scope === "project") return `p${typeIdSuffix(options.projectId)}`
+  if (options.scope === "automation") {
+    return `a${typeIdSuffix(options.automationId)}`
+  }
+
+  return `a${typeIdSuffix(options.automationId)}.${[
+    ...(options.scopePath ?? []),
+    options.hookSlot,
+  ]
+    .map((segment) => segment.toString(36))
+    .join(".")}`
+}
+
 /**
  * Returns the organization-authenticated submission endpoint for one dashboard
  * run.
@@ -263,3 +432,95 @@ export function getDashboardRunEndpointKey(
     options.hookSlot,
   ].join(".")}`
 }
+
+/**
+ * Checks a configured default against the same constraints as submitted data.
+ *
+ * @param field - Field definition to validate.
+ */
+function isDashboardRunFieldDefaultValid(field: DashboardRunField) {
+  if (field.type === "checkbox" || field.defaultValue === undefined) return true
+
+  if (field.type === "multi-select") {
+    if (field.required !== false && field.defaultValue.length === 0)
+      return false
+    return field.defaultValue.every((value) =>
+      field.options.some((option) => option.value === value),
+    )
+  }
+
+  if (field.type === "radio" || field.type === "select") {
+    return field.options.some((option) => option.value === field.defaultValue)
+  }
+
+  if (field.type === "number") {
+    return (
+      (field.min === undefined || field.defaultValue >= field.min) &&
+      (field.max === undefined || field.defaultValue <= field.max) &&
+      !isDashboardRunStepMismatch(
+        field.defaultValue,
+        field.min ?? field.defaultValue,
+        field.step ?? 1,
+      )
+    )
+  }
+
+  if (field.type === "date" || field.type === "datetime") {
+    const defaultValue = parseDashboardRunDateValue(
+      field.type,
+      field.defaultValue,
+    )
+    return (
+      (field.min === undefined ||
+        defaultValue >= parseDashboardRunDateValue(field.type, field.min)) &&
+      (field.max === undefined ||
+        defaultValue <= parseDashboardRunDateValue(field.type, field.max)) &&
+      !isDashboardRunStepMismatch(
+        defaultValue,
+        parseDashboardRunDateValue(field.type, field.min ?? field.defaultValue),
+        (field.step ?? (field.type === "date" ? 1 : 60)) *
+          (field.type === "date" ? 86_400_000 : 1_000),
+      )
+    )
+  }
+
+  const defaultValue = field.defaultValue.trim()
+  return (
+    (defaultValue.length > 0 || field.required === false) &&
+    (field.minLength === undefined || defaultValue.length >= field.minLength) &&
+    (field.maxLength === undefined || defaultValue.length <= field.maxLength) &&
+    (field.type !== "email" || EMAIL_SCHEMA.safeParse(defaultValue).success) &&
+    (field.type !== "url" || URL_SCHEMA.safeParse(defaultValue).success)
+  )
+}
+
+/**
+ * Checks whether a value falls outside an allowed step interval.
+ *
+ * @param value - Configured default value.
+ * @param base - Value from which step intervals begin.
+ * @param step - Allowed interval size.
+ */
+function isDashboardRunStepMismatch(value: number, base: number, step: number) {
+  const intervals = (value - base) / step
+  return Math.abs(intervals - Math.round(intervals)) > 1e-9
+}
+
+/**
+ * Converts a validated local date or date-time string to a UTC number.
+ *
+ * @param type - Temporal field type.
+ * @param value - Local ISO value to convert.
+ */
+function parseDashboardRunDateValue(type: "date" | "datetime", value: string) {
+  return Date.parse(type === "date" ? `${value}T00:00:00Z` : `${value}Z`)
+}
+
+/**
+ * Removes the redundant TypeID prefix from an address router.
+ *
+ * @param id - Project or automation TypeID.
+ */
+function typeIdSuffix(id: string) {
+  return id.includes("_") ? id.slice(id.indexOf("_") + 1) : id
+}

package/src/triggers/index.ts

@@ -24,12 +24,17 @@ export {
   getDashboardRunEndpointKey,
   getHttpTriggerEndpoint,
   getHttpTriggerEndpointKey,
+  getMailhookAddress,
+  getMailhookAddressKey,
+  PLATFORM_EMAIL_DOMAIN,
   DASHBOARD_RUN_CONFIG_SCHEMA,
   type DashboardRunConfig,
   type DashboardRunEndpointOptions,
   type DashboardRunField,
   type HttpTriggerEndpointOptions,
   type HttpTriggerScope,
+  type MailhookAddressOptions,
+  type MailhookScope,
 } from "./core"
 
 /** Plain shared definitions for every public trigger type. */