import type { FormEventType } from '@entrolytics/shared';
export type { FormEventType };
export interface FormEventPayload {
    /** Form event type */
    eventType: FormEventType;
    /** Form identifier */
    formId: string;
    /** Human-readable form name */
    formName?: string;
    /** Page path where form exists */
    urlPath: string;
    /** Field name (for field events) */
    fieldName?: string;
    /** Field type */
    fieldType?: string;
    /** Field position */
    fieldIndex?: number;
    /** Time spent on field (ms) */
    timeOnField?: number;
    /** Time since form start (ms) */
    timeSinceStart?: number;
    /** Error message */
    errorMessage?: string;
    /** Whether submission was successful */
    success?: boolean;
}
export interface TrackFormConfig {
    /** Entrolytics host URL */
    host: string;
    /** Public collection API key */
    apiKey: string;
    /** Website ID */
    websiteId: string;
    /** Optional stable session ID */
    sessionId?: string;
    /** Optional stable visitor ID */
    visitorId?: string;
}
/**
 * Track a form event from server side (Server Actions, API routes)
 *
 * @example
 * ```ts
 * // In a Server Action
 * 'use server';
 * import { trackServerFormEvent } from '@entrolytics/nextjs/server';
 *
 * export async function submitContactForm(formData: FormData) {
 *   const result = await saveToDatabase(formData);
 *
 *   await trackServerFormEvent(
 *     {
 *       host: process.env.ENTROLYTICS_HOST!,
 *       websiteId: process.env.ENTROLYTICS_WEBSITE_ID!,
 *     },
 *     {
 *       eventType: 'submit',
 *       formId: 'contact-form',
 *       formName: 'Contact Form',
 *       urlPath: '/contact',
 *       success: result.ok,
 *     }
 *   );
 *
 *   return result;
 * }
 * ```
 */
export declare function trackServerFormEvent(config: TrackFormConfig, event: FormEventPayload): Promise<{
    ok: boolean;
    error?: string;
}>;
/**
 * Track multiple form events at once
 */
export declare function trackServerFormEventsBatch(config: TrackFormConfig, events: FormEventPayload[]): Promise<{
    ok: boolean;
    error?: string;
}>;
/**
 * Helper to create a form submission tracker
 * Wraps a Server Action to automatically track submit events
 *
 * @example
 * ```ts
 * 'use server';
 * import { withFormTracking } from '@entrolytics/nextjs/server';
 *
 * const trackedAction = withFormTracking(
 *   { host: '...', websiteId: '...' },
 *   { formId: 'signup', formName: 'Signup Form', urlPath: '/signup' }
 * );
 *
 * export async function signup(formData: FormData) {
 *   return trackedAction(async () => {
 *     const result = await createUser(formData);
 *     return { success: result.ok };
 *   });
 * }
 * ```
 */
export declare function withFormTracking(config: TrackFormConfig, formInfo: {
    formId: string;
    formName?: string;
    urlPath: string;
}): <T extends {
    success?: boolean;
}>(action: () => Promise<T>) => Promise<T>;
//# sourceMappingURL=forms.d.ts.map