@automate.ax/catalog 0.64.0 → 0.65.1

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>;
@@ -94,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;
@@ -110,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;
@@ -117,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. */

package/dist/triggers/core.js

@@ -1,6 +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"),
@@ -25,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,
@@ -51,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)),
 });
@@ -212,6 +265,63 @@ 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.
  *

package/package.json

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

package/src/triggers/core.ts

@@ -3,6 +3,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"),
@@ -27,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({
@@ -55,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",
@@ -163,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
@@ -184,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
@@ -332,6 +433,89 @@ export function getDashboardRunEndpointKey(
   ].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.
  *