@saastro/forms 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -3781,36 +3781,48 @@ interface TemplateMeta {
 declare const TEMPLATE_META: readonly TemplateMeta[];
 
 /**
- * Build a `CustomSubmitConfig` that routes form submissions to a
- * Saastro Hub site. Used by Astro / React sites whose forms are
- * authored in Hub (`builder.saastro.io` embed mode) and stored there.
+ * Build a `CustomSubmitConfig` that routes form submissions to the
+ * Saastro ingestion endpoint (`submit.saastro.io/v1` by default).
+ * Used by Astro / React sites whose forms are authored in Hub
+ * (`builder.saastro.io` embed mode) and stored there.
  *
  * The flow is:
  *
  *   1. Walk the field values and split into `payload` (scalar/JSON-safe)
- *      and `files` (instances of File). Hub keeps text fields together;
- *      files take a separate path.
- *   2. For each file, POST `/api/public/forms/:siteId/:slug/upload-url`
- *      to get a presigned R2 PUT URL, then PUT the binary directly to
- *      that URL. Hub never touches the file body — R2 receives it.
- *   3. POST `/api/public/forms/:siteId/:slug/submit` with the textual
- *      payload + an `attachments` array describing the uploaded R2
- *      keys. Hub inserts the submission row and dispatches integrations
- *      (Sheets / Resend / etc.) per the form's schema.
- *
- * Turnstile: if the form schema declares `meta.requireCaptcha=true`,
- * the host app must render the Turnstile widget and pass the token
- * via the special `_turnstile` field in the form values. The helper
- * extracts it before sending.
+ *      and `files` (instances of File). The endpoint keeps text fields
+ *      together; files take a separate path.
+ *   2. For each file, POST `/:siteId/:slug/upload-url` to get a
+ *      presigned R2 PUT URL, then PUT the binary directly to that URL.
+ *      The Worker never touches the file body — R2 receives it.
+ *   3. POST `/:siteId/:slug/submit` with the textual payload + an
+ *      `attachments` array describing the uploaded R2 keys. The Worker
+ *      inserts the submission row and dispatches integrations (Sheets
+ *      / Resend / etc.) per the form's schema.
+ *
+ * Captcha: if the form schema declares `meta.captchaProvider`
+ * ('turnstile' or 'recaptcha-v3'), the host app must render the widget
+ * and pass the token via the special `_captchaToken` field (legacy
+ * `_turnstile` is accepted too). The helper extracts it before sending.
  *
  * Honeypot: pass via `_hp` (or whatever `meta.honeypotField` says).
- * The Hub will silently 200 the request and not store anything if
+ * The endpoint will silently 200 the request and not store anything if
  * the honeypot is non-empty.
+ *
+ * Endpoint history:
+ *   - v0.3.x and earlier: `https://hub.saastro.io/api/public/forms/...`
+ *   - v0.4.0+: `https://submit.saastro.io/v1/...` (dedicated worker)
+ *   See https://docs.forms.saastro.io/migration/v0.4 for details.
  */
 
+/** Default canonical ingestion endpoint. Override via `hubUrl` for self-hosting. */
+declare const DEFAULT_HUB_URL = "https://submit.saastro.io/v1";
 interface CreateHubFormSubmitOptions {
-    /** Hub origin, e.g. `https://hub.saastro.io`. No trailing slash. */
-    hubUrl: string;
+    /**
+     * Ingestion endpoint base URL (no trailing slash). Defaults to
+     * `https://submit.saastro.io/v1` — the canonical CF Worker.
+     * Override for self-hosted Hub deployments or test envs.
+     */
+    hubUrl?: string;
     siteId: string;
     formSlug: string;
 }
@@ -3826,8 +3838,12 @@ interface CreateHubFormSubmitOptions {
 declare function createHubFormSubmit(opts: CreateHubFormSubmitOptions): CustomSubmitConfig;
 
 interface HubFormProps {
-    /** Origin of the Hub API. e.g. `https://hub.saastro.io`. No trailing slash. */
-    hubUrl: string;
+    /**
+     * Ingestion endpoint base URL (no trailing slash). Defaults to
+     * `https://submit.saastro.io/v1` — the canonical hosted endpoint.
+     * Override for self-hosted Hub or test envs.
+     */
+    hubUrl?: string;
     siteId: string;
     formSlug: string;
     /** Custom UI while the schema is being fetched. Defaults to a skeleton. */
@@ -3918,4 +3934,4 @@ declare function getFieldClass(formLayout?: {
  */
 declare function getHiddenClasses(hidden?: Partial<Record<Breakpoint, 'visible' | 'hidden'>>): string;
 
-export { type AccordionContentProps, type AccordionItemProps, type AccordionProps, type AccordionTriggerProps, BUILD_METHODS, BUILTIN_RESOLVERS, type BaseFieldProps, type Breakpoint$1 as Breakpoint, type BuiltinTransform, type ButtonCardFieldProps, type ButtonCardOption, type ButtonCheckboxFieldProps, type ButtonConfig, type ButtonProps, type ButtonRadioFieldProps, COMMON_CLASSES, COMMON_METHODS, COMMON_STRINGS, type CalendarProps, type CheckboxFieldProps, type CheckboxGroupFieldProps, type CheckboxProps, type ColumnsValue, type ComboboxFieldProps, type CommandEmptyProps, type CommandFieldProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandProps, type ComponentName, type ComponentOverrides, ComponentProvider, type ComponentProviderProps, type ComponentRegistry, type ComponentRegistryInput, ComponentResolver, type ComponentResolverConfig, type Condition, type ConditionGroup, type ConditionOperator, type CreateHubFormSubmitOptions, type CurrencyFieldProps, type CustomSubmitAction, type CustomSubmitConfig, type DatabowlConfig, type DateFieldProps, type DateRangeFieldProps, type DefaultSubmitConfig, type DefinePlugin, type DialogContentProps, type DialogDescriptionProps, type DialogHeaderProps, type DialogProps, type DialogTitleProps, type DialogTriggerProps, type EmailProvider, type EmailSubmitAction, type EndpointConfig, FIELD_DEFAULTS, FieldBuilder, type FieldConfig, type FieldDescriptionProps, type FieldErrorProps, type FieldLabelProps, type FieldLayoutConfig, type FieldMapEntry, type FieldMapping, type FieldMappingConfig, type FieldProps, FieldRenderer, type FieldResolver, type FieldTransformFn, type Fields, type FileFieldProps, Form, FormBuilder, type FormButtonProps, type FormButtons, FormComponentsProvider, type FormComponentsProviderProps, type FormConfig, type FormControlProps, type FormFieldProps, type FormLayout, type FormPlugin, type FormProps, type FormRef, type FormStepsInfo, type GapValue, type GlobModules, type HiddenFieldProps, type HtmlFieldProps, type HttpAuthConfig, type HttpBodyConfig, type HttpEndpointConfig, type HttpRetryConfig, type HttpSubmitAction, HubForm, type HubFormProps, type InputGroupFieldProps, type InputOTPGroupProps, type InputOTPProps, type InputOTPSlotProps, type InputProps, type InputSize, type IntegrationSubmitAction, InternalComponentProvider, type InternalComponentProviderProps, type LabelProps, MissingComponentFallback, type MissingComponentFallbackProps, type NativeSelectFieldProps, type NativeSelectProps, OPTION_BASED_TYPES, type Option, type OtpFieldProps, type PartialComponentRegistry, PluginManager, type PopoverContentProps, type PopoverProps, type PopoverTriggerProps, type PropertyMapping, type RadioFieldProps, type RadioGroupItemProps, type RadioGroupProps, type RangeFieldProps, type RecaptchaConfig, type RecaptchaPluginConfig, type RepeaterFieldProps, type ResolvedComponents, SUSPENSE_CONFIG, type SchemaType, type SelectContentProps, type SelectFieldProps, type SelectItemProps, type SelectProps, type SelectTriggerProps, type SelectValueProps, type SeparatorProps, type SerializableFieldResolver, type SerializationHint, type SliderFieldProps, type SliderProps, type Step, type StepCondition, type StepInfo, type StepStatus, type Steps, StepsAccordion, StepsNavigation, StepsProgress, type SubmitAction, type SubmitActionCondition, type SubmitActionNode, type SubmitActionResult, type SubmitActionType, type SubmitActionsResult, type SubmitConfig, type SubmitConfirmationConfig, type SubmitExecutionConfig, type SubmitTrigger, type SubmitTriggerType, type SubmitType, type SwitchFieldProps, type SwitchGroupFieldProps, type SwitchProps, TEMPLATES, TEMPLATE_META, TYPE_SPECIFIC_PROPERTIES, type TemplateId, type TemplateMeta, type TestDataLocale, type TestDataOptions, type TextFieldProps, type TextareaFieldProps, type TextareaProps, type TooltipContentProps, type TooltipProps, type TooltipProviderProps, type TooltipTriggerProps, type UseSubmitConfirmationReturn, VALIDATION_METHODS, type ValidateComponentRegistry, type ValidationContext, type ValidationPresetMeta, type ValidationRules, type WebhookSubmitAction, analyticsPlugin, applyBuiltinTransform, applyFieldMapping, applyFieldMappingSync, applyFieldTransforms, applyTransform, autosavePlugin, compileValidationRules, configureComponents, coreComponents, createComponentRegistry, createContactTemplate, createEventRsvpTemplate, createHubFormSubmit, createLeadGenTemplate, createMissingComponentPlaceholder, createNewsletterTemplate, createQuoteRequestTemplate, createShadcnRegistry, databowlAction, databowlPlugin, defaultSubmit, definePlugin, detectLocale, executeCustomAction, executeEmailAction, executeHttpAction, executeSubmitAction, executeSubmitActions, executeSubmitActionsByTrigger, executeWebhookAction, fieldTypeComponents, generateFieldValue, generateTestData, getActionsByTrigger, getAllKnownMethods, getAvailablePresets, getComponentResolver, getFieldClass, getFormGridClass, getHiddenClasses, getInstallCommand, getMinDelayMs, getMissingComponents, getRequiredComponents, globalPluginManager, groupMissingByPackage, iconVariants, iconVariantsConfig, inputVariants, inputVariantsConfig, isAdvancedMapping, isValidationRules, isZodSchema, localStoragePlugin, mergeComponentRegistries, parseGlobModules, pxToRem, recaptchaPlugin, registerPreset, resolvePreset, resolveValue, resolveValueSync, textareaVariants, textareaVariantsConfig, useComponentMode, useComponents, useComputedFields, useFormLayout, useFormState, useFormStepsInfo, useHasComponentProvider, useHiddenFieldResolvers, usePartialComponents, useRecaptcha, useSubmitActionTriggers, useSubmitConfirmation, withComponents };
+export { type AccordionContentProps, type AccordionItemProps, type AccordionProps, type AccordionTriggerProps, BUILD_METHODS, BUILTIN_RESOLVERS, type BaseFieldProps, type Breakpoint$1 as Breakpoint, type BuiltinTransform, type ButtonCardFieldProps, type ButtonCardOption, type ButtonCheckboxFieldProps, type ButtonConfig, type ButtonProps, type ButtonRadioFieldProps, COMMON_CLASSES, COMMON_METHODS, COMMON_STRINGS, type CalendarProps, type CheckboxFieldProps, type CheckboxGroupFieldProps, type CheckboxProps, type ColumnsValue, type ComboboxFieldProps, type CommandEmptyProps, type CommandFieldProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandProps, type ComponentName, type ComponentOverrides, ComponentProvider, type ComponentProviderProps, type ComponentRegistry, type ComponentRegistryInput, ComponentResolver, type ComponentResolverConfig, type Condition, type ConditionGroup, type ConditionOperator, type CreateHubFormSubmitOptions, type CurrencyFieldProps, type CustomSubmitAction, type CustomSubmitConfig, DEFAULT_HUB_URL, type DatabowlConfig, type DateFieldProps, type DateRangeFieldProps, type DefaultSubmitConfig, type DefinePlugin, type DialogContentProps, type DialogDescriptionProps, type DialogHeaderProps, type DialogProps, type DialogTitleProps, type DialogTriggerProps, type EmailProvider, type EmailSubmitAction, type EndpointConfig, FIELD_DEFAULTS, FieldBuilder, type FieldConfig, type FieldDescriptionProps, type FieldErrorProps, type FieldLabelProps, type FieldLayoutConfig, type FieldMapEntry, type FieldMapping, type FieldMappingConfig, type FieldProps, FieldRenderer, type FieldResolver, type FieldTransformFn, type Fields, type FileFieldProps, Form, FormBuilder, type FormButtonProps, type FormButtons, FormComponentsProvider, type FormComponentsProviderProps, type FormConfig, type FormControlProps, type FormFieldProps, type FormLayout, type FormPlugin, type FormProps, type FormRef, type FormStepsInfo, type GapValue, type GlobModules, type HiddenFieldProps, type HtmlFieldProps, type HttpAuthConfig, type HttpBodyConfig, type HttpEndpointConfig, type HttpRetryConfig, type HttpSubmitAction, HubForm, type HubFormProps, type InputGroupFieldProps, type InputOTPGroupProps, type InputOTPProps, type InputOTPSlotProps, type InputProps, type InputSize, type IntegrationSubmitAction, InternalComponentProvider, type InternalComponentProviderProps, type LabelProps, MissingComponentFallback, type MissingComponentFallbackProps, type NativeSelectFieldProps, type NativeSelectProps, OPTION_BASED_TYPES, type Option, type OtpFieldProps, type PartialComponentRegistry, PluginManager, type PopoverContentProps, type PopoverProps, type PopoverTriggerProps, type PropertyMapping, type RadioFieldProps, type RadioGroupItemProps, type RadioGroupProps, type RangeFieldProps, type RecaptchaConfig, type RecaptchaPluginConfig, type RepeaterFieldProps, type ResolvedComponents, SUSPENSE_CONFIG, type SchemaType, type SelectContentProps, type SelectFieldProps, type SelectItemProps, type SelectProps, type SelectTriggerProps, type SelectValueProps, type SeparatorProps, type SerializableFieldResolver, type SerializationHint, type SliderFieldProps, type SliderProps, type Step, type StepCondition, type StepInfo, type StepStatus, type Steps, StepsAccordion, StepsNavigation, StepsProgress, type SubmitAction, type SubmitActionCondition, type SubmitActionNode, type SubmitActionResult, type SubmitActionType, type SubmitActionsResult, type SubmitConfig, type SubmitConfirmationConfig, type SubmitExecutionConfig, type SubmitTrigger, type SubmitTriggerType, type SubmitType, type SwitchFieldProps, type SwitchGroupFieldProps, type SwitchProps, TEMPLATES, TEMPLATE_META, TYPE_SPECIFIC_PROPERTIES, type TemplateId, type TemplateMeta, type TestDataLocale, type TestDataOptions, type TextFieldProps, type TextareaFieldProps, type TextareaProps, type TooltipContentProps, type TooltipProps, type TooltipProviderProps, type TooltipTriggerProps, type UseSubmitConfirmationReturn, VALIDATION_METHODS, type ValidateComponentRegistry, type ValidationContext, type ValidationPresetMeta, type ValidationRules, type WebhookSubmitAction, analyticsPlugin, applyBuiltinTransform, applyFieldMapping, applyFieldMappingSync, applyFieldTransforms, applyTransform, autosavePlugin, compileValidationRules, configureComponents, coreComponents, createComponentRegistry, createContactTemplate, createEventRsvpTemplate, createHubFormSubmit, createLeadGenTemplate, createMissingComponentPlaceholder, createNewsletterTemplate, createQuoteRequestTemplate, createShadcnRegistry, databowlAction, databowlPlugin, defaultSubmit, definePlugin, detectLocale, executeCustomAction, executeEmailAction, executeHttpAction, executeSubmitAction, executeSubmitActions, executeSubmitActionsByTrigger, executeWebhookAction, fieldTypeComponents, generateFieldValue, generateTestData, getActionsByTrigger, getAllKnownMethods, getAvailablePresets, getComponentResolver, getFieldClass, getFormGridClass, getHiddenClasses, getInstallCommand, getMinDelayMs, getMissingComponents, getRequiredComponents, globalPluginManager, groupMissingByPackage, iconVariants, iconVariantsConfig, inputVariants, inputVariantsConfig, isAdvancedMapping, isValidationRules, isZodSchema, localStoragePlugin, mergeComponentRegistries, parseGlobModules, pxToRem, recaptchaPlugin, registerPreset, resolvePreset, resolveValue, resolveValueSync, textareaVariants, textareaVariantsConfig, useComponentMode, useComponents, useComputedFields, useFormLayout, useFormState, useFormStepsInfo, useHasComponentProvider, useHiddenFieldResolvers, usePartialComponents, useRecaptcha, useSubmitActionTriggers, useSubmitConfirmation, withComponents };

package/dist/index.js

@@ -6959,9 +6959,10 @@ var TEMPLATE_META = [
 ];
 
 // src/lib/createHubFormSubmit.ts
+var DEFAULT_HUB_URL = "https://submit.saastro.io/v1";
 function publicBase({ hubUrl, siteId, formSlug }) {
-  const cleanHub = hubUrl.replace(/\/+$/, "");
-  return `${cleanHub}/api/public/forms/${encodeURIComponent(siteId)}/${encodeURIComponent(formSlug)}`;
+  const base = (hubUrl ?? DEFAULT_HUB_URL).replace(/\/+$/, "");
+  return `${base}/${encodeURIComponent(siteId)}/${encodeURIComponent(formSlug)}`;
 }
 async function presignAndUpload(base, file) {
   const presignRes = await fetch(`${base}/upload-url`, {
@@ -6999,7 +7000,7 @@ function partitionValues(values) {
   let turnstileToken = null;
   const honeypotEntries = [];
   for (const [key, value] of Object.entries(values)) {
-    if (key === "_turnstile") {
+    if (key === "_captchaToken" || key === "_turnstile") {
       if (typeof value === "string") turnstileToken = value;
       continue;
     }
@@ -7039,7 +7040,10 @@ function createHubFormSubmit(opts) {
         body: JSON.stringify({
           payload,
           attachments,
-          turnstile: turnstileToken ?? void 0,
+          // Send under the canonical name. The worker also accepts the
+          // legacy `turnstile` field for old SDK callers, but new sends
+          // should use `captchaToken`.
+          captchaToken: turnstileToken ?? void 0,
           ...honeypotEntry
         })
       });
@@ -7083,8 +7087,8 @@ function HubForm({
   const [state, setState] = useState5({ status: "loading" });
   useEffect8(() => {
     let cancelled = false;
-    const cleanHub = hubUrl.replace(/\/+$/, "");
-    const url = `${cleanHub}/api/public/forms/${encodeURIComponent(siteId)}/${encodeURIComponent(formSlug)}.json`;
+    const cleanHub = (hubUrl ?? DEFAULT_HUB_URL).replace(/\/+$/, "");
+    const url = `${cleanHub}/${encodeURIComponent(siteId)}/${encodeURIComponent(formSlug)}.json`;
     fetch(url, { headers: { accept: "application/json" } }).then(async (res) => {
       if (!res.ok) throw new Error(`schema fetch failed: ${res.status} ${res.statusText}`);
       return res.json();
@@ -7408,6 +7412,7 @@ export {
   COMMON_STRINGS,
   ComponentProvider,
   ComponentResolver,
+  DEFAULT_HUB_URL,
   FIELD_DEFAULTS,
   FieldBuilder,
   FieldRenderer,