@automate.ax/catalog 0.153.2 → 0.154.0

package/src/triggers/core-dashboard.ts

@@ -1,240 +1,10 @@
 import type { TriggerDefinition } from "../types"
-import { sentenceCase } from "./name"
 import * as z from "zod/mini"
-
-const EMAIL_SCHEMA = z.email()
-const URL_SCHEMA = z.url()
-const DATE_SCHEMA = z.iso.date()
-const DATETIME_SCHEMA = z.iso.datetime({ local: true })
-const FIELD_NAME_SCHEMA = z
-  .string()
-  .check(z.trim(), z.minLength(1), z.maxLength(100))
-const FIELD_LABEL_SCHEMA = z
-  .string()
-  .check(z.trim(), z.minLength(1), z.maxLength(255))
-const FIELD_DESCRIPTION_SCHEMA = z.string().check(z.maxLength(2_000))
-const FIELD_LENGTH_SCHEMA = z.int().check(z.nonnegative())
-const DASHBOARD_RUN_FIELD_BASE_SCHEMA = {
-  description: z.optional(FIELD_DESCRIPTION_SCHEMA),
-  label: z.optional(FIELD_LABEL_SCHEMA),
-  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()),
-  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_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,
-        value: FIELD_NAME_SCHEMA,
-      }),
-    )
-    .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.pipe(
-  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,
-  ]),
-  z.transform((field) => ({
-    ...field,
-    label:
-      field.label ??
-      `${sentenceCase(field.name)}${field.type === "checkbox" ? "?" : ""}`,
-  })),
-)
-export 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 type DashboardRunFieldValue =
-  | boolean
-  | number
-  | string
-  | readonly string[]
-  | null
-
-/**
- * Returns the configured fallback for a field without an assigned value.
- *
- * @param field - Field whose fallback should be resolved.
- */
-export function getDashboardRunFieldDefaultValue(field: DashboardRunField) {
-  if (field.defaultValue !== undefined) return field.defaultValue
-  if (field.type === "checkbox") return false
-  if (field.type === "multi-select") return []
-  if (field.type === "number")
-    return field.required === false ? null : undefined
-  return field.required === false ? "" : undefined
-}
-
-/**
- * Checks one decoded value against a dashboard field declaration.
- *
- * @param field - Field declaration whose constraints apply.
- * @param value - Decoded value to validate.
- */
-export function isDashboardRunFieldValueValid(
-  field: DashboardRunField,
-  value: unknown,
-) {
-  if (field.type === "checkbox") {
-    return typeof value === "boolean" && (field.required === false || value)
-  }
-  if (field.type === "multi-select") {
-    return (
-      Array.isArray(value) &&
-      (field.required === false || value.length > 0) &&
-      value.every(
-        (entry) =>
-          typeof entry === "string" &&
-          field.options.some((option) => option.value === entry),
-      )
-    )
-  }
-  if (field.type === "number") {
-    if (value === null) return field.required === false
-    return (
-      typeof value === "number" &&
-      Number.isFinite(value) &&
-      (field.min === undefined || value >= field.min) &&
-      (field.max === undefined || value <= field.max) &&
-      !isDashboardRunStepMismatch(
-        value,
-        field.min ?? field.defaultValue ?? 0,
-        field.step ?? 1,
-      )
-    )
-  }
-  if (typeof value !== "string") return false
-  if (field.type === "radio" || field.type === "select") {
-    return (
-      (field.required === false && value === "") ||
-      field.options.some((option) => option.value === value)
-    )
-  }
-  if (field.type === "date" || field.type === "datetime") {
-    if (field.required === false && value === "") return true
-    const parsed = parseDashboardRunDateValue(field.type, value)
-    return (
-      (field.type === "date" ? DATE_SCHEMA : DATETIME_SCHEMA).safeParse(value)
-        .success &&
-      Number.isFinite(parsed) &&
-      (field.min === undefined ||
-        parsed >= parseDashboardRunDateValue(field.type, field.min)) &&
-      (field.max === undefined ||
-        parsed <= parseDashboardRunDateValue(field.type, field.max)) &&
-      !isDashboardRunStepMismatch(
-        parsed,
-        parseDashboardRunDateValue(
-          field.type,
-          field.min ??
-            field.defaultValue ??
-            (field.type === "date" ? "1970-01-01" : "1970-01-01T00:00"),
-        ),
-        (field.step ?? (field.type === "date" ? 1 : 60)) *
-          (field.type === "date" ? 86_400_000 : 1_000),
-      )
-    )
-  }
-
-  const normalized = value.trim()
-  return (
-    (normalized.length > 0 || field.required === false) &&
-    (field.minLength === undefined || normalized.length >= field.minLength) &&
-    (field.maxLength === undefined || normalized.length <= field.maxLength) &&
-    (field.type !== "email" || EMAIL_SCHEMA.safeParse(normalized).success) &&
-    (field.type !== "url" || URL_SCHEMA.safeParse(normalized).success)
-  )
-}
+import { FORM_FIELDS_SCHEMA, type FormField } from "../form-fields"
 
 export const DASHBOARD_RUN_CONFIG_SCHEMA = z.object({
-  description: z.optional(FIELD_DESCRIPTION_SCHEMA),
-  fields: z.prefault(DASHBOARD_RUN_FIELDS_SCHEMA, []),
+  description: z.optional(z.string().check(z.maxLength(2_000))),
+  fields: z.prefault(FORM_FIELDS_SCHEMA, []),
   submitLabel: z.prefault(
     z.string().check(z.trim(), z.minLength(1), z.maxLength(100)),
     "Run",
@@ -254,86 +24,8 @@ export const dashboardRunTriggerDefinition = {
   type: "dashboard.run",
 } as const satisfies TriggerDefinition
 
-interface DashboardRunFieldBase {
-  /** Supporting text shown below the field. */
-  description?: string
-
-  /** Visible field label. Inferred from `name` when omitted. */
-  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" | "phone" | "text" | "textarea" | "url"
-    })
-  | (DashboardRunFieldBase & {
-      defaultValue?: number
-      max?: number
-      min?: number
-      placeholder?: string
-
-      /** Increment used by the number input. Defaults to 1. */
-      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 }[]
-      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 readonly DashboardRunField[] = readonly DashboardRunField[],
+  TFields extends readonly FormField[] = readonly FormField[],
 > {
   /** Supporting text shown below the form title. */
   description?: string
@@ -381,86 +73,3 @@ 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`)
-}

package/src/triggers/core.ts

@@ -7,16 +7,11 @@ import { cronTickTriggerDefinition } from "./core-schedule"
 
 export {
   DASHBOARD_RUN_CONFIG_SCHEMA,
-  DASHBOARD_RUN_FIELDS_SCHEMA,
   dashboardRunTriggerDefinition,
   getDashboardRunEndpoint,
   getDashboardRunEndpointKey,
-  getDashboardRunFieldDefaultValue,
-  isDashboardRunFieldValueValid,
   type DashboardRunConfig,
   type DashboardRunEndpointOptions,
-  type DashboardRunField,
-  type DashboardRunFieldValue,
 } from "./core-dashboard"
 export {
   getHttpTriggerEndpoint,

package/src/triggers/index.ts

@@ -51,13 +51,8 @@ export {
   getMailhookAddressKey,
   PLATFORM_EMAIL_DOMAIN,
   DASHBOARD_RUN_CONFIG_SCHEMA,
-  DASHBOARD_RUN_FIELDS_SCHEMA,
-  getDashboardRunFieldDefaultValue,
-  isDashboardRunFieldValueValid,
   type DashboardRunConfig,
   type DashboardRunEndpointOptions,
-  type DashboardRunField,
-  type DashboardRunFieldValue,
   type HttpTriggerEndpointOptions,
   type HttpTriggerScope,
   type MailhookAddressOptions,