@btst/stack 1.5.1 → 1.6.0

package/dist/shared/stack.BIh2AXaW.d.mts

@@ -0,0 +1,123 @@
+import { ControllerRenderProps, FieldValues } from 'react-hook-form';
+import * as zod from 'zod';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormEnum({ label, isRequired, field, fieldConfigItem, zodItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormInput({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormNumber({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormRadioGroup({ label, isRequired, field, zodItem, fieldProps, fieldConfigItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare const INPUT_COMPONENTS: {
+    checkbox: typeof AutoFormCheckbox;
+    date: typeof AutoFormDate;
+    select: typeof AutoFormEnum;
+    radio: typeof AutoFormRadioGroup;
+    switch: typeof AutoFormSwitch;
+    textarea: typeof AutoFormTextarea;
+    number: typeof AutoFormNumber;
+    fallback: typeof AutoFormInput;
+};
+
+/**
+ * Shared types between form-builder and auto-form.
+ *
+ * These types ensure consistency when:
+ * - form-builder creates JSON Schema properties
+ * - auto-form consumes JSON Schema properties
+ * - inputProps flow from form-builder → JSON Schema → auto-form
+ */
+
+/**
+ * Common input props shared by all field types.
+ */
+interface BaseInputProps {
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is read-only */
+    readOnly?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether to show the label (auto-form specific) */
+    showLabel?: boolean;
+}
+/**
+ * Generic input props that accept any field type.
+ * Use this when the backing type is not known at compile time.
+ *
+ * This is the catch-all type used for runtime flexibility.
+ */
+interface SerializableInputProps extends BaseInputProps {
+    placeholder?: string;
+    type?: string;
+    defaultValue?: unknown;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    autoComplete?: string;
+    /** Allow additional props for extensibility */
+    [key: string]: unknown;
+}
+
+/**
+ * Input props for form fields.
+ *
+ * This is the runtime type that accepts any input props.
+ * For type-safe props, use the discriminated types:
+ * - StringInputProps for text inputs
+ * - NumberInputProps for number inputs
+ * - BooleanInputProps for checkboxes/switches
+ * - DateInputProps for date pickers
+ * - EnumInputProps for selects/radios
+ */
+type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, keyof SerializableInputProps> & Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, keyof SerializableInputProps>;
+/**
+ * Configuration for a single field in AutoForm.
+ *
+ * Note: This type is designed to align with form-builder's FormBuilderFieldProps
+ * so that JSON Schema properties can be easily converted to field configs.
+ */
+type FieldConfigItem = {
+    /** Description text or React node */
+    description?: React.ReactNode;
+    /** Input props passed to the field component */
+    inputProps?: FieldInputProps;
+    /** Display label */
+    label?: string;
+    /** Field type override - built-in type or custom component */
+    fieldType?: keyof typeof INPUT_COMPONENTS | React.FC<AutoFormInputComponentProps>;
+    /** Wrapper component for custom field layout */
+    renderParent?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement | null;
+    /** Display order for field ordering */
+    order?: number;
+};
+/**
+ * A FormInput component can handle a specific Zod type (e.g. "ZodBoolean")
+ */
+type AutoFormInputComponentProps = {
+    zodInputProps: React.InputHTMLAttributes<HTMLInputElement>;
+    field: ControllerRenderProps<FieldValues, any>;
+    fieldConfigItem: FieldConfigItem;
+    label: string;
+    isRequired: boolean;
+    fieldProps: any;
+    zodItem: zod.ZodType;
+    className?: string;
+};
+
+export type { AutoFormInputComponentProps as A };

package/dist/shared/stack.BIh2AXaW.d.ts

@@ -0,0 +1,123 @@
+import { ControllerRenderProps, FieldValues } from 'react-hook-form';
+import * as zod from 'zod';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function AutoFormCheckbox({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormDate({ label, isRequired, field, fieldConfigItem, fieldProps, zodItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormEnum({ label, isRequired, field, fieldConfigItem, zodItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormInput({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormNumber({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormRadioGroup({ label, isRequired, field, zodItem, fieldProps, fieldConfigItem, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormSwitch({ label, isRequired, field, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare function AutoFormTextarea({ label, isRequired, fieldConfigItem, fieldProps, }: AutoFormInputComponentProps): react_jsx_runtime.JSX.Element;
+
+declare const INPUT_COMPONENTS: {
+    checkbox: typeof AutoFormCheckbox;
+    date: typeof AutoFormDate;
+    select: typeof AutoFormEnum;
+    radio: typeof AutoFormRadioGroup;
+    switch: typeof AutoFormSwitch;
+    textarea: typeof AutoFormTextarea;
+    number: typeof AutoFormNumber;
+    fallback: typeof AutoFormInput;
+};
+
+/**
+ * Shared types between form-builder and auto-form.
+ *
+ * These types ensure consistency when:
+ * - form-builder creates JSON Schema properties
+ * - auto-form consumes JSON Schema properties
+ * - inputProps flow from form-builder → JSON Schema → auto-form
+ */
+
+/**
+ * Common input props shared by all field types.
+ */
+interface BaseInputProps {
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is read-only */
+    readOnly?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether to show the label (auto-form specific) */
+    showLabel?: boolean;
+}
+/**
+ * Generic input props that accept any field type.
+ * Use this when the backing type is not known at compile time.
+ *
+ * This is the catch-all type used for runtime flexibility.
+ */
+interface SerializableInputProps extends BaseInputProps {
+    placeholder?: string;
+    type?: string;
+    defaultValue?: unknown;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    autoComplete?: string;
+    /** Allow additional props for extensibility */
+    [key: string]: unknown;
+}
+
+/**
+ * Input props for form fields.
+ *
+ * This is the runtime type that accepts any input props.
+ * For type-safe props, use the discriminated types:
+ * - StringInputProps for text inputs
+ * - NumberInputProps for number inputs
+ * - BooleanInputProps for checkboxes/switches
+ * - DateInputProps for date pickers
+ * - EnumInputProps for selects/radios
+ */
+type FieldInputProps = SerializableInputProps & Omit<React.InputHTMLAttributes<HTMLInputElement>, keyof SerializableInputProps> & Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, keyof SerializableInputProps>;
+/**
+ * Configuration for a single field in AutoForm.
+ *
+ * Note: This type is designed to align with form-builder's FormBuilderFieldProps
+ * so that JSON Schema properties can be easily converted to field configs.
+ */
+type FieldConfigItem = {
+    /** Description text or React node */
+    description?: React.ReactNode;
+    /** Input props passed to the field component */
+    inputProps?: FieldInputProps;
+    /** Display label */
+    label?: string;
+    /** Field type override - built-in type or custom component */
+    fieldType?: keyof typeof INPUT_COMPONENTS | React.FC<AutoFormInputComponentProps>;
+    /** Wrapper component for custom field layout */
+    renderParent?: (props: {
+        children: React.ReactNode;
+    }) => React.ReactElement | null;
+    /** Display order for field ordering */
+    order?: number;
+};
+/**
+ * A FormInput component can handle a specific Zod type (e.g. "ZodBoolean")
+ */
+type AutoFormInputComponentProps = {
+    zodInputProps: React.InputHTMLAttributes<HTMLInputElement>;
+    field: ControllerRenderProps<FieldValues, any>;
+    fieldConfigItem: FieldConfigItem;
+    label: string;
+    isRequired: boolean;
+    fieldProps: any;
+    zodItem: zod.ZodType;
+    className?: string;
+};
+
+export type { AutoFormInputComponentProps as A };

package/dist/shared/stack.DzH_wcvr.d.cts

@@ -0,0 +1,195 @@
+/**
+ * Form Builder Plugin Types
+ *
+ * Key distinction from CMS Plugin:
+ * - CMS uses developer-defined Zod schemas in code
+ * - Form Builder allows non-technical admins to build forms via drag-and-drop UI
+ * - Forms are serialized to/from JSON Schema for storage
+ */
+/**
+ * Form stored in the database
+ */
+type Form = {
+    id: string;
+    /** Display name for the form */
+    name: string;
+    /** URL-friendly slug - unique identifier for public access */
+    slug: string;
+    /** Optional description for admin UI */
+    description?: string;
+    /** JSON Schema stored as string (includes steps, fieldType, stepGroup, etc.) */
+    schema: string;
+    /** Optional custom success message after submission */
+    successMessage?: string;
+    /** Optional redirect URL after submission */
+    redirectUrl?: string;
+    /** Form status: active, inactive, archived */
+    status: "active" | "inactive" | "archived";
+    /** User who created the form */
+    createdBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * Form submission stored in the database
+ */
+type FormSubmission = {
+    id: string;
+    /** Reference to the form */
+    formId: string;
+    /** Submitted data as JSON string */
+    data: string;
+    /** Submission timestamp */
+    submittedAt: Date;
+    /** Optional user ID if authenticated */
+    submittedBy?: string;
+    /** Client IP address for rate limiting and spam protection */
+    ipAddress?: string;
+    /** User agent for analytics */
+    userAgent?: string;
+};
+/**
+ * Serialized form for API responses (dates as strings)
+ */
+interface SerializedForm extends Omit<Form, "createdAt" | "updatedAt" | "status"> {
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Serialized form submission for API responses (dates as strings)
+ */
+interface SerializedFormSubmission extends Omit<FormSubmission, "submittedAt"> {
+    submittedAt: string;
+}
+/**
+ * Serialized form submission with parsed data
+ */
+interface SerializedFormSubmissionWithData<TData = Record<string, unknown>> extends SerializedFormSubmission {
+    /** Parsed data object (JSON.parse of data field) */
+    parsedData: TData;
+    /** Joined form */
+    form?: SerializedForm;
+}
+/**
+ * Paginated list response for forms
+ */
+interface PaginatedForms {
+    items: SerializedForm[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Paginated list response for form submissions
+ */
+interface PaginatedFormSubmissions<TData = Record<string, unknown>> {
+    items: SerializedFormSubmissionWithData<TData>[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Context passed to all backend hooks
+ */
+interface FormBuilderHookContext {
+    /** User ID if authenticated */
+    userId?: string;
+    /** Request headers */
+    headers?: Headers;
+    /** Client IP address (for rate limiting) */
+    ipAddress?: string;
+    /** User agent string */
+    userAgent?: string;
+}
+/**
+ * Context for submission-specific hooks
+ */
+interface SubmissionHookContext extends FormBuilderHookContext {
+    /** Form slug being submitted */
+    formSlug: string;
+    /** Form ID */
+    formId: string;
+}
+/**
+ * Input data for creating a form
+ */
+interface FormInput {
+    name: string;
+    slug: string;
+    description?: string;
+    schema: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    status?: "active" | "inactive" | "archived";
+    createdBy?: string;
+}
+/**
+ * Input data for updating a form
+ */
+interface FormUpdate {
+    name?: string;
+    slug?: string;
+    description?: string;
+    schema?: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    status?: "active" | "inactive" | "archived";
+}
+/**
+ * Backend hooks for Form Builder plugin
+ *
+ * All CRUD hooks receive ipAddress and headers for auth/rate limiting.
+ * Return false from onBefore* hooks to reject the operation (throws 403).
+ */
+interface FormBuilderBackendHooks {
+    /** Called before listing forms. Return false to deny access (403). */
+    onBeforeListForms?: (ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before creating a form. Return false to deny, or modified data. */
+    onBeforeFormCreated?: (data: FormInput, ctx: FormBuilderHookContext) => Promise<FormInput | false> | FormInput | false;
+    /** Called after a form is created */
+    onAfterFormCreated?: (form: SerializedForm, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /** Called before getting a form by ID or slug. Return false to deny access. */
+    onBeforeGetForm?: (idOrSlug: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before updating a form. Return false to deny, or modified data. */
+    onBeforeFormUpdated?: (id: string, data: FormUpdate, ctx: FormBuilderHookContext) => Promise<FormUpdate | false> | FormUpdate | false;
+    /** Called after a form is updated */
+    onAfterFormUpdated?: (form: SerializedForm, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /** Called before deleting a form. Return false to deny. */
+    onBeforeFormDeleted?: (id: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called after a form is deleted */
+    onAfterFormDeleted?: (id: string, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /**
+     * Called before processing a form submission.
+     * Use for: spam protection, rate limiting, data validation/enrichment.
+     *
+     * @returns false to reject submission (400), or modified data to continue
+     */
+    onBeforeSubmission?: (formSlug: string, data: Record<string, unknown>, ctx: SubmissionHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /**
+     * Called after a submission is saved.
+     * Use for: sending emails, storing in CRM, triggering workflows.
+     */
+    onAfterSubmission?: (submission: SerializedFormSubmission, form: SerializedForm, ctx: SubmissionHookContext) => Promise<void> | void;
+    /** Called when a submission fails */
+    onSubmissionError?: (error: Error, formSlug: string, data: Record<string, unknown>, ctx: SubmissionHookContext) => Promise<void> | void;
+    /** Called before listing submissions. Return false to deny access (403). */
+    onBeforeListSubmissions?: (formId: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before getting a submission. Return false to deny access. */
+    onBeforeGetSubmission?: (submissionId: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before deleting a submission. Return false to deny. */
+    onBeforeSubmissionDeleted?: (submissionId: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called after a submission is deleted */
+    onAfterSubmissionDeleted?: (submissionId: string, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /** Called on any error */
+    onError?: (error: Error, operation: "list" | "get" | "create" | "update" | "delete" | "submit" | "listSubmissions" | "getSubmission" | "deleteSubmission", ctx: FormBuilderHookContext) => Promise<void> | void;
+}
+/**
+ * Configuration for the Form Builder backend plugin
+ */
+interface FormBuilderBackendConfig {
+    /** Optional hooks for customizing behavior */
+    hooks?: FormBuilderBackendHooks;
+}
+
+export type { FormBuilderBackendConfig as F, PaginatedForms as P, SerializedForm as S, SerializedFormSubmission as a, SerializedFormSubmissionWithData as b, PaginatedFormSubmissions as c };

package/dist/shared/stack.DzH_wcvr.d.mts

@@ -0,0 +1,195 @@
+/**
+ * Form Builder Plugin Types
+ *
+ * Key distinction from CMS Plugin:
+ * - CMS uses developer-defined Zod schemas in code
+ * - Form Builder allows non-technical admins to build forms via drag-and-drop UI
+ * - Forms are serialized to/from JSON Schema for storage
+ */
+/**
+ * Form stored in the database
+ */
+type Form = {
+    id: string;
+    /** Display name for the form */
+    name: string;
+    /** URL-friendly slug - unique identifier for public access */
+    slug: string;
+    /** Optional description for admin UI */
+    description?: string;
+    /** JSON Schema stored as string (includes steps, fieldType, stepGroup, etc.) */
+    schema: string;
+    /** Optional custom success message after submission */
+    successMessage?: string;
+    /** Optional redirect URL after submission */
+    redirectUrl?: string;
+    /** Form status: active, inactive, archived */
+    status: "active" | "inactive" | "archived";
+    /** User who created the form */
+    createdBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * Form submission stored in the database
+ */
+type FormSubmission = {
+    id: string;
+    /** Reference to the form */
+    formId: string;
+    /** Submitted data as JSON string */
+    data: string;
+    /** Submission timestamp */
+    submittedAt: Date;
+    /** Optional user ID if authenticated */
+    submittedBy?: string;
+    /** Client IP address for rate limiting and spam protection */
+    ipAddress?: string;
+    /** User agent for analytics */
+    userAgent?: string;
+};
+/**
+ * Serialized form for API responses (dates as strings)
+ */
+interface SerializedForm extends Omit<Form, "createdAt" | "updatedAt" | "status"> {
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Serialized form submission for API responses (dates as strings)
+ */
+interface SerializedFormSubmission extends Omit<FormSubmission, "submittedAt"> {
+    submittedAt: string;
+}
+/**
+ * Serialized form submission with parsed data
+ */
+interface SerializedFormSubmissionWithData<TData = Record<string, unknown>> extends SerializedFormSubmission {
+    /** Parsed data object (JSON.parse of data field) */
+    parsedData: TData;
+    /** Joined form */
+    form?: SerializedForm;
+}
+/**
+ * Paginated list response for forms
+ */
+interface PaginatedForms {
+    items: SerializedForm[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Paginated list response for form submissions
+ */
+interface PaginatedFormSubmissions<TData = Record<string, unknown>> {
+    items: SerializedFormSubmissionWithData<TData>[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Context passed to all backend hooks
+ */
+interface FormBuilderHookContext {
+    /** User ID if authenticated */
+    userId?: string;
+    /** Request headers */
+    headers?: Headers;
+    /** Client IP address (for rate limiting) */
+    ipAddress?: string;
+    /** User agent string */
+    userAgent?: string;
+}
+/**
+ * Context for submission-specific hooks
+ */
+interface SubmissionHookContext extends FormBuilderHookContext {
+    /** Form slug being submitted */
+    formSlug: string;
+    /** Form ID */
+    formId: string;
+}
+/**
+ * Input data for creating a form
+ */
+interface FormInput {
+    name: string;
+    slug: string;
+    description?: string;
+    schema: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    status?: "active" | "inactive" | "archived";
+    createdBy?: string;
+}
+/**
+ * Input data for updating a form
+ */
+interface FormUpdate {
+    name?: string;
+    slug?: string;
+    description?: string;
+    schema?: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    status?: "active" | "inactive" | "archived";
+}
+/**
+ * Backend hooks for Form Builder plugin
+ *
+ * All CRUD hooks receive ipAddress and headers for auth/rate limiting.
+ * Return false from onBefore* hooks to reject the operation (throws 403).
+ */
+interface FormBuilderBackendHooks {
+    /** Called before listing forms. Return false to deny access (403). */
+    onBeforeListForms?: (ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before creating a form. Return false to deny, or modified data. */
+    onBeforeFormCreated?: (data: FormInput, ctx: FormBuilderHookContext) => Promise<FormInput | false> | FormInput | false;
+    /** Called after a form is created */
+    onAfterFormCreated?: (form: SerializedForm, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /** Called before getting a form by ID or slug. Return false to deny access. */
+    onBeforeGetForm?: (idOrSlug: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before updating a form. Return false to deny, or modified data. */
+    onBeforeFormUpdated?: (id: string, data: FormUpdate, ctx: FormBuilderHookContext) => Promise<FormUpdate | false> | FormUpdate | false;
+    /** Called after a form is updated */
+    onAfterFormUpdated?: (form: SerializedForm, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /** Called before deleting a form. Return false to deny. */
+    onBeforeFormDeleted?: (id: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called after a form is deleted */
+    onAfterFormDeleted?: (id: string, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /**
+     * Called before processing a form submission.
+     * Use for: spam protection, rate limiting, data validation/enrichment.
+     *
+     * @returns false to reject submission (400), or modified data to continue
+     */
+    onBeforeSubmission?: (formSlug: string, data: Record<string, unknown>, ctx: SubmissionHookContext) => Promise<Record<string, unknown> | false> | Record<string, unknown> | false;
+    /**
+     * Called after a submission is saved.
+     * Use for: sending emails, storing in CRM, triggering workflows.
+     */
+    onAfterSubmission?: (submission: SerializedFormSubmission, form: SerializedForm, ctx: SubmissionHookContext) => Promise<void> | void;
+    /** Called when a submission fails */
+    onSubmissionError?: (error: Error, formSlug: string, data: Record<string, unknown>, ctx: SubmissionHookContext) => Promise<void> | void;
+    /** Called before listing submissions. Return false to deny access (403). */
+    onBeforeListSubmissions?: (formId: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before getting a submission. Return false to deny access. */
+    onBeforeGetSubmission?: (submissionId: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called before deleting a submission. Return false to deny. */
+    onBeforeSubmissionDeleted?: (submissionId: string, ctx: FormBuilderHookContext) => Promise<boolean> | boolean;
+    /** Called after a submission is deleted */
+    onAfterSubmissionDeleted?: (submissionId: string, ctx: FormBuilderHookContext) => Promise<void> | void;
+    /** Called on any error */
+    onError?: (error: Error, operation: "list" | "get" | "create" | "update" | "delete" | "submit" | "listSubmissions" | "getSubmission" | "deleteSubmission", ctx: FormBuilderHookContext) => Promise<void> | void;
+}
+/**
+ * Configuration for the Form Builder backend plugin
+ */
+interface FormBuilderBackendConfig {
+    /** Optional hooks for customizing behavior */
+    hooks?: FormBuilderBackendHooks;
+}
+
+export type { FormBuilderBackendConfig as F, PaginatedForms as P, SerializedForm as S, SerializedFormSubmission as a, SerializedFormSubmissionWithData as b, PaginatedFormSubmissions as c };