@spike-forms/sdk 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,2345 @@
+/**
+ * HTTP Client for the Spike Forms SDK
+ *
+ * Provides a wrapper around fetch that handles:
+ * - Authentication with Bearer token
+ * - Request timeout with AbortController
+ * - Query parameter encoding
+ * - Error response mapping to SDK error types
+ */
+/**
+ * Options for HTTP requests
+ */
+interface RequestOptions {
+    /** Query parameters to append to the URL */
+    params?: Record<string, string | number | boolean | undefined>;
+    /** Additional headers to include in the request */
+    headers?: Record<string, string>;
+}
+/**
+ * Configuration for the HTTP client
+ */
+interface HttpClientConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for API requests */
+    baseUrl: string;
+    /** Request timeout in milliseconds */
+    timeout: number;
+}
+/**
+ * HTTP client for making authenticated requests to the Spike Forms API.
+ *
+ * @example
+ * ```typescript
+ * const http = new HttpClient({
+ *   apiKey: 'sk_test_123',
+ *   baseUrl: 'https://spike.ac',
+ *   timeout: 30000
+ * });
+ *
+ * const forms = await http.get<Form[]>('/api/forms');
+ * ```
+ */
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(config: HttpClientConfig);
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a POST request with authentication
+     */
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PATCH request
+     */
+    patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PUT request
+     */
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a POST request without authentication (for public form submissions)
+     */
+    postPublic<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Build a URL with query parameters
+     */
+    buildUrl(path: string, params?: Record<string, string | number | boolean | undefined>): string;
+    /**
+     * Make an HTTP request with timeout and error handling
+     */
+    private request;
+    /**
+     * Handle error responses and throw appropriate SDK errors
+     */
+    private handleErrorResponse;
+}
+
+/**
+ * Type definitions for the Spike Forms SDK
+ *
+ * This file contains all TypeScript interfaces for:
+ * - Core entities (Form, Submission, Project, Team, User, etc.)
+ * - Request/response types for all API operations
+ * - Pagination parameter types
+ *
+ * @module types
+ */
+/**
+ * Represents a form in Spike Forms
+ */
+interface Form {
+    /** Unique identifier for the form */
+    id: string;
+    /** URL-friendly slug for the form */
+    slug: string;
+    /** Display name of the form */
+    name: string;
+    /** ID of the project this form belongs to, or null if not in a project */
+    project_id: string | null;
+    /** ID of the user who owns this form */
+    user_id: string;
+    /** Whether the form is currently accepting submissions */
+    is_active: boolean;
+    /** Total number of submissions received */
+    submission_count: number;
+    /** ISO 8601 timestamp of when the form was created */
+    created_at: string;
+    /** ISO 8601 timestamp of when the form was last updated */
+    updated_at: string;
+}
+/**
+ * Represents a submission to a form
+ */
+interface Submission {
+    /** Unique identifier for the submission */
+    id: string;
+    /** ID of the form this submission belongs to */
+    form_id: string;
+    /** The submitted form data as key-value pairs */
+    data: Record<string, unknown>;
+    /** Whether this submission has been marked as spam */
+    is_spam: boolean;
+    /** Whether this submission has been read */
+    is_read: boolean;
+    /** Whether this submission has been starred */
+    is_starred: boolean;
+    /** IP address of the submitter, or null if not captured */
+    ip_address: string | null;
+    /** User agent string of the submitter, or null if not captured */
+    user_agent: string | null;
+    /** ISO 8601 timestamp of when the submission was created */
+    created_at: string;
+}
+/**
+ * Statistics about submissions for a form
+ */
+interface SubmissionStats {
+    /** Total number of submissions */
+    total: number;
+    /** Number of submissions marked as spam */
+    spam: number;
+    /** Number of unread submissions */
+    unread: number;
+    /** Number of starred submissions */
+    starred: number;
+    /** Number of submissions received today */
+    today: number;
+    /** Number of submissions received this week */
+    this_week: number;
+    /** Number of submissions received this month */
+    this_month: number;
+}
+/**
+ * Represents a project for organizing forms
+ */
+interface Project {
+    /** Unique identifier for the project */
+    id: string;
+    /** Display name of the project */
+    name: string;
+    /** ID of the user who owns this project */
+    user_id: string;
+    /** Number of forms in this project */
+    form_count: number;
+    /** ISO 8601 timestamp of when the project was created */
+    created_at: string;
+    /** ISO 8601 timestamp of when the project was last updated */
+    updated_at: string;
+}
+/**
+ * Represents a team for collaborative form management
+ */
+interface Team {
+    /** Unique identifier for the team */
+    id: string;
+    /** Display name of the team */
+    name: string;
+    /** ID of the user who owns this team */
+    owner_id: string;
+    /** Number of members in this team */
+    member_count: number;
+    /** ISO 8601 timestamp of when the team was created */
+    created_at: string;
+    /** ISO 8601 timestamp of when the team was last updated */
+    updated_at: string;
+}
+/**
+ * Role types for team members
+ */
+type TeamMemberRole = 'owner' | 'admin' | 'member';
+/**
+ * Role types for team invitations (owner cannot be invited)
+ */
+type TeamInvitationRole = 'admin' | 'member';
+/**
+ * Represents a member of a team
+ */
+interface TeamMember {
+    /** Unique identifier for the team membership */
+    id: string;
+    /** ID of the team */
+    team_id: string;
+    /** ID of the user */
+    user_id: string;
+    /** Role of the member in the team */
+    role: TeamMemberRole;
+    /** Basic user information */
+    user: {
+        /** User's unique identifier */
+        id: string;
+        /** User's display name */
+        name: string;
+        /** User's email address */
+        email: string;
+    };
+    /** ISO 8601 timestamp of when the member joined */
+    created_at: string;
+}
+/**
+ * Represents a pending invitation to join a team
+ */
+interface TeamInvitation {
+    /** Unique identifier for the invitation */
+    id: string;
+    /** ID of the team being invited to */
+    team_id: string;
+    /** Email address of the invitee */
+    email: string;
+    /** Role the invitee will have upon accepting */
+    role: TeamInvitationRole;
+    /** Unique token for accepting the invitation */
+    token: string;
+    /** ISO 8601 timestamp of when the invitation expires */
+    expires_at: string;
+    /** ISO 8601 timestamp of when the invitation was created */
+    created_at: string;
+}
+/**
+ * Represents a user account
+ */
+interface User {
+    /** Unique identifier for the user */
+    id: string;
+    /** User's display name */
+    name: string;
+    /** User's email address */
+    email: string;
+    /** Whether two-factor authentication is enabled */
+    two_factor_enabled: boolean;
+    /** ISO 8601 timestamp of when the user was created */
+    created_at: string;
+    /** ISO 8601 timestamp of when the user was last updated */
+    updated_at: string;
+}
+/**
+ * Represents an API key for authentication
+ */
+interface ApiKey {
+    /** Unique identifier for the API key */
+    id: string;
+    /** Display name for the API key */
+    name: string;
+    /** The API key value (only shown on creation) */
+    key: string;
+    /** ISO 8601 timestamp of when the key was last used, or null if never used */
+    last_used_at: string | null;
+    /** ISO 8601 timestamp of when the key was created */
+    created_at: string;
+}
+/**
+ * Operators available for rule conditions
+ */
+type RuleConditionOperator = 'equals' | 'contains' | 'starts_with' | 'ends_with' | 'regex';
+/**
+ * Action types available for rules
+ */
+type RuleActionType = 'email' | 'webhook' | 'slack' | 'discord';
+/**
+ * Represents a condition in a rule
+ */
+interface RuleCondition {
+    /** The field name to evaluate */
+    field: string;
+    /** The comparison operator */
+    operator: RuleConditionOperator;
+    /** The value to compare against */
+    value: string;
+}
+/**
+ * Represents an action to take when rule conditions are met
+ */
+interface RuleAction {
+    /** The type of action */
+    type: RuleActionType;
+    /** Configuration specific to the action type */
+    config: Record<string, unknown>;
+}
+/**
+ * Represents a rule for conditional processing of submissions
+ */
+interface Rule {
+    /** Unique identifier for the rule */
+    id: string;
+    /** ID of the form this rule belongs to */
+    form_id: string;
+    /** Display name of the rule */
+    name: string;
+    /** Conditions that must be met for the rule to trigger */
+    conditions: RuleCondition[];
+    /** Actions to take when conditions are met */
+    actions: RuleAction[];
+    /** Whether the rule is currently active */
+    is_active: boolean;
+    /** ISO 8601 timestamp of when the rule was created */
+    created_at: string;
+    /** ISO 8601 timestamp of when the rule was last updated */
+    updated_at: string;
+}
+/**
+ * Generic success response
+ */
+interface SuccessResponse {
+    /** Whether the operation was successful */
+    success: boolean;
+}
+/**
+ * Response from submitting to a form
+ */
+interface SubmissionResponse {
+    /** Whether the submission was successful */
+    success: boolean;
+    /** ID of the created submission (if successful) */
+    submission_id?: string;
+}
+/**
+ * Parameters for listing forms
+ */
+interface ListFormsParams {
+    /** Maximum number of forms to return */
+    limit?: number;
+    /** Number of forms to skip for pagination */
+    offset?: number;
+    /** Filter forms by project ID */
+    project_id?: string;
+    /** Include inactive forms in the results */
+    include_inactive?: boolean;
+}
+/**
+ * Request body for creating a form
+ */
+interface CreateFormRequest {
+    /** Display name for the form */
+    name: string;
+    /** ID of the project to add the form to */
+    project_id?: string;
+}
+/**
+ * Request body for updating a form
+ */
+interface UpdateFormRequest {
+    /** New display name for the form */
+    name?: string;
+    /** ID of the project to move the form to */
+    project_id?: string | null;
+    /** Whether the form should be active */
+    is_active?: boolean;
+}
+/**
+ * Sort order for submissions
+ */
+type SubmissionOrder = 'asc' | 'desc';
+/**
+ * Parameters for listing submissions
+ */
+interface ListSubmissionsParams {
+    /** Maximum number of submissions to return */
+    limit?: number;
+    /** Number of submissions to skip for pagination */
+    offset?: number;
+    /** Only return submissions created after this ISO 8601 timestamp */
+    since?: string;
+    /** Sort order for submissions */
+    order?: SubmissionOrder;
+    /** Filter string for searching submissions */
+    filter?: string;
+    /** Filter by spam status */
+    is_spam?: boolean;
+    /** Filter by read status */
+    is_read?: boolean;
+}
+/**
+ * Available bulk actions for submissions
+ */
+type BulkAction = 'markRead' | 'markUnread' | 'star' | 'unstar' | 'markSpam' | 'notSpam';
+/**
+ * Request body for bulk updating submissions
+ */
+interface BulkUpdateRequest {
+    /** The action to perform */
+    action: BulkAction;
+    /** IDs of submissions to update */
+    submission_ids: string[];
+}
+/**
+ * Request body for creating a rule
+ */
+interface CreateRuleRequest {
+    /** Display name for the rule */
+    name: string;
+    /** Conditions that must be met for the rule to trigger */
+    conditions: RuleCondition[];
+    /** Actions to take when conditions are met */
+    actions: RuleAction[];
+    /** Whether the rule should be active (defaults to true) */
+    is_active?: boolean;
+}
+/**
+ * Request body for updating a rule
+ */
+interface UpdateRuleRequest {
+    /** New display name for the rule */
+    name?: string;
+    /** New conditions for the rule */
+    conditions?: RuleCondition[];
+    /** New actions for the rule */
+    actions?: RuleAction[];
+    /** Whether the rule should be active */
+    is_active?: boolean;
+}
+/**
+ * Request body for creating a project
+ */
+interface CreateProjectRequest {
+    /** Display name for the project */
+    name: string;
+}
+/**
+ * Request body for updating a project
+ */
+interface UpdateProjectRequest {
+    /** New display name for the project */
+    name?: string;
+}
+/**
+ * Request body for creating a team
+ */
+interface CreateTeamRequest {
+    /** Display name for the team */
+    name: string;
+}
+/**
+ * Request body for updating a team
+ */
+interface UpdateTeamRequest {
+    /** New display name for the team */
+    name?: string;
+}
+/**
+ * Request body for inviting a member to a team
+ */
+interface InviteMemberRequest {
+    /** Email address of the person to invite */
+    email: string;
+    /** Role to assign to the new member */
+    role: TeamInvitationRole;
+}
+/**
+ * Request body for updating a team member's role
+ */
+interface UpdateMemberRequest {
+    /** New role for the member */
+    role: TeamInvitationRole;
+}
+/**
+ * Request body for updating user profile
+ */
+interface UpdateUserRequest {
+    /** New display name */
+    name?: string;
+    /** New email address */
+    email?: string;
+}
+/**
+ * Response from initiating 2FA setup
+ */
+interface Setup2FAResponse {
+    /** The TOTP secret for the authenticator app */
+    secret: string;
+    /** QR code image data for scanning */
+    qr_code: string;
+}
+/**
+ * Request body for creating an API key
+ */
+interface CreateApiKeyRequest {
+    /** Display name for the API key */
+    name: string;
+}
+/**
+ * Request body for creating a checkout session
+ */
+interface CreateCheckoutRequest {
+    /** Stripe price ID for the subscription */
+    price_id: string;
+    /** URL to redirect to on successful checkout */
+    success_url: string;
+    /** URL to redirect to if checkout is cancelled */
+    cancel_url: string;
+}
+/**
+ * Response from creating a checkout session
+ */
+interface CheckoutResponse {
+    /** URL to redirect the user to for checkout */
+    url: string;
+}
+/**
+ * Response from creating a billing portal session
+ */
+interface PortalResponse {
+    /** URL to redirect the user to for the billing portal */
+    url: string;
+}
+/**
+ * Response from getting a file download URL
+ */
+interface FileDownloadResponse {
+    /** Signed URL for downloading the file */
+    url: string;
+    /** ISO 8601 timestamp of when the URL expires */
+    expires_at: string;
+}
+/**
+ * Common pagination parameters
+ */
+interface PaginationParams {
+    /** Maximum number of items to return */
+    limit?: number;
+    /** Number of items to skip */
+    offset?: number;
+}
+/**
+ * Paginated response wrapper
+ */
+interface PaginatedResponse<T> {
+    /** Array of items */
+    data: T[];
+    /** Total number of items available */
+    total: number;
+    /** Number of items returned */
+    count: number;
+    /** Current offset */
+    offset: number;
+    /** Whether there are more items available */
+    has_more: boolean;
+}
+
+/**
+ * Forms Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing forms:
+ * - list: Get all forms with pagination support
+ * - create: Create a new form
+ * - get: Retrieve a single form by ID
+ * - update: Update form properties
+ * - delete: Delete a form by ID
+ * - submit: Submit data to a form (public, no auth required)
+ * - getHtml: Get the HTML template for a form
+ * - saveHtml: Save HTML template for a form
+ *
+ * @module resources/forms
+ */
+
+/**
+ * Response type for getHtml method.
+ */
+interface FormHtmlResponse {
+    html: string;
+}
+/**
+ * Response type for saveHtml method.
+ */
+interface SaveFormHtmlResponse {
+    success: boolean;
+    html_url: string | null;
+}
+/**
+ * Resource class for managing forms in Spike Forms.
+ *
+ * @example
+ * ```typescript
+ * // List all forms
+ * const forms = await client.forms.list({ limit: 10 });
+ *
+ * // Create a new form
+ * const form = await client.forms.create({ name: 'Contact Form' });
+ *
+ * // Get a specific form
+ * const form = await client.forms.get('form_123');
+ *
+ * // Update a form
+ * const updated = await client.forms.update('form_123', { name: 'New Name' });
+ *
+ * // Delete a form
+ * await client.forms.delete('form_123');
+ *
+ * // Submit to a form (public, no auth)
+ * const result = await client.forms.submit('my-form-slug', { email: 'user@example.com' });
+ *
+ * // Get form HTML template
+ * const { html } = await client.forms.getHtml('form_123');
+ *
+ * // Save form HTML template
+ * await client.forms.saveHtml('form_123', '<html>...</html>');
+ * ```
+ */
+declare class FormsResource {
+    private readonly http;
+    /**
+     * Create a new FormsResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * List all forms with optional pagination and filtering.
+     *
+     * @param params - Optional parameters for filtering and pagination
+     * @param params.limit - Maximum number of forms to return
+     * @param params.offset - Number of forms to skip for pagination
+     * @param params.project_id - Filter forms by project ID
+     * @param params.include_inactive - Include inactive forms in the results
+     * @returns Promise resolving to an array of forms
+     *
+     * @example
+     * ```typescript
+     * // Get all forms
+     * const forms = await client.forms.list();
+     *
+     * // Get forms with pagination
+     * const forms = await client.forms.list({ limit: 10, offset: 20 });
+     *
+     * // Get forms for a specific project
+     * const forms = await client.forms.list({ project_id: 'proj_123' });
+     *
+     * // Include inactive forms
+     * const forms = await client.forms.list({ include_inactive: true });
+     * ```
+     *
+     * @see Requirements 4.1
+     */
+    list(params?: ListFormsParams): Promise<Form[]>;
+    /**
+     * Create a new form.
+     *
+     * @param data - The form data to create
+     * @param data.name - Display name for the form (required)
+     * @param data.project_id - ID of the project to add the form to (optional)
+     * @returns Promise resolving to the created form
+     *
+     * @example
+     * ```typescript
+     * // Create a simple form
+     * const form = await client.forms.create({ name: 'Contact Form' });
+     *
+     * // Create a form in a project
+     * const form = await client.forms.create({
+     *   name: 'Feedback Form',
+     *   project_id: 'proj_123'
+     * });
+     * ```
+     *
+     * @see Requirements 4.2
+     */
+    create(data: CreateFormRequest): Promise<Form>;
+    /**
+     * Get a single form by ID.
+     *
+     * @param id - The unique identifier of the form
+     * @returns Promise resolving to the form
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * const form = await client.forms.get('form_123');
+     * console.log(form.name, form.submission_count);
+     * ```
+     *
+     * @see Requirements 4.3
+     */
+    get(id: string): Promise<Form>;
+    /**
+     * Update a form's properties.
+     *
+     * @param id - The unique identifier of the form to update
+     * @param data - The properties to update
+     * @param data.name - New display name for the form
+     * @param data.project_id - ID of the project to move the form to (or null to remove from project)
+     * @param data.is_active - Whether the form should be active
+     * @returns Promise resolving to the updated form
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * // Update form name
+     * const form = await client.forms.update('form_123', { name: 'New Name' });
+     *
+     * // Deactivate a form
+     * const form = await client.forms.update('form_123', { is_active: false });
+     *
+     * // Move form to a different project
+     * const form = await client.forms.update('form_123', { project_id: 'proj_456' });
+     * ```
+     *
+     * @see Requirements 4.4
+     */
+    update(id: string, data: UpdateFormRequest): Promise<Form>;
+    /**
+     * Delete a form by ID.
+     *
+     * @param id - The unique identifier of the form to delete
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * await client.forms.delete('form_123');
+     * ```
+     *
+     * @see Requirements 4.5
+     */
+    delete(id: string): Promise<SuccessResponse>;
+    /**
+     * Submit data to a form. This is a public endpoint that does not require authentication.
+     *
+     * @param slug - The URL-friendly slug of the form
+     * @param data - The form data to submit as key-value pairs
+     * @returns Promise resolving to the submission response
+     * @throws NotFoundError if the form does not exist
+     * @throws ValidationError if the form is inactive or data is invalid
+     *
+     * @example
+     * ```typescript
+     * // Submit to a contact form
+     * const result = await client.forms.submit('contact-form', {
+     *   name: 'John Doe',
+     *   email: 'john@example.com',
+     *   message: 'Hello!'
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Submission ID:', result.submission_id);
+     * }
+     * ```
+     *
+     * @see Requirements 4.6
+     */
+    submit(slug: string, data: Record<string, unknown>): Promise<SubmissionResponse>;
+    /**
+     * Get the HTML template for a form.
+     *
+     * Returns the stored HTML from S3 or a default template if none exists.
+     *
+     * @param id - The unique identifier of the form
+     * @returns Promise resolving to the HTML content
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * const { html } = await client.forms.getHtml('form_123');
+     * console.log(html);
+     * ```
+     */
+    getHtml(id: string): Promise<FormHtmlResponse>;
+    /**
+     * Save HTML template for a form to S3 storage.
+     *
+     * @param id - The unique identifier of the form
+     * @param html - The HTML content to save
+     * @returns Promise resolving to the save response with the S3 URL
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * const result = await client.forms.saveHtml('form_123', '<html>...</html>');
+     * if (result.success) {
+     *   console.log('Saved to:', result.html_url);
+     * }
+     * ```
+     */
+    saveHtml(id: string, html: string): Promise<SaveFormHtmlResponse>;
+}
+
+/**
+ * Submissions Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing form submissions:
+ * - list: Get submissions with filtering options
+ * - getStats: Get submission statistics for a form
+ * - export: Export all submissions as JSON
+ * - bulkUpdate: Perform batch operations on submissions
+ * - bulkDelete: Delete multiple submissions
+ *
+ * @module resources/submissions
+ */
+
+/**
+ * Resource class for managing form submissions in Spike Forms.
+ *
+ * @example
+ * ```typescript
+ * // List submissions for a form
+ * const submissions = await client.submissions.list('form_123', { limit: 10 });
+ *
+ * // Get submission statistics
+ * const stats = await client.submissions.getStats('form_123');
+ *
+ * // Export all submissions
+ * const allSubmissions = await client.submissions.export('form_123');
+ *
+ * // Bulk update submissions
+ * await client.submissions.bulkUpdate('form_123', {
+ *   action: 'markRead',
+ *   submission_ids: ['sub_1', 'sub_2']
+ * });
+ *
+ * // Bulk delete submissions
+ * await client.submissions.bulkDelete('form_123', ['sub_1', 'sub_2']);
+ * ```
+ */
+declare class SubmissionsResource {
+    private readonly http;
+    /**
+     * Create a new SubmissionsResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * List submissions for a form with optional filtering and pagination.
+     *
+     * @param formId - The unique identifier of the form
+     * @param params - Optional parameters for filtering and pagination
+     * @param params.limit - Maximum number of submissions to return
+     * @param params.offset - Number of submissions to skip for pagination
+     * @param params.since - Only return submissions created after this ISO 8601 timestamp
+     * @param params.order - Sort order for submissions ('asc' or 'desc')
+     * @param params.filter - Filter string for searching submissions
+     * @param params.is_spam - Filter by spam status
+     * @param params.is_read - Filter by read status
+     * @returns Promise resolving to an array of submissions
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * // Get all submissions for a form
+     * const submissions = await client.submissions.list('form_123');
+     *
+     * // Get submissions with pagination
+     * const submissions = await client.submissions.list('form_123', {
+     *   limit: 10,
+     *   offset: 20
+     * });
+     *
+     * // Get unread submissions
+     * const unread = await client.submissions.list('form_123', {
+     *   is_read: false
+     * });
+     *
+     * // Get non-spam submissions since a date
+     * const recent = await client.submissions.list('form_123', {
+     *   since: '2024-01-01T00:00:00Z',
+     *   is_spam: false,
+     *   order: 'desc'
+     * });
+     *
+     * // Search submissions
+     * const filtered = await client.submissions.list('form_123', {
+     *   filter: 'john@example.com'
+     * });
+     * ```
+     *
+     * @see Requirements 5.1
+     */
+    list(formId: string, params?: ListSubmissionsParams): Promise<Submission[]>;
+    /**
+     * Get submission statistics for a form.
+     *
+     * @param formId - The unique identifier of the form
+     * @returns Promise resolving to submission statistics
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * const stats = await client.submissions.getStats('form_123');
+     * console.log(`Total: ${stats.total}, Unread: ${stats.unread}, Spam: ${stats.spam}`);
+     * console.log(`Today: ${stats.today}, This week: ${stats.this_week}`);
+     * ```
+     *
+     * @see Requirements 5.2
+     */
+    getStats(formId: string): Promise<SubmissionStats>;
+    /**
+     * Export all submissions for a form as JSON.
+     *
+     * @param formId - The unique identifier of the form
+     * @returns Promise resolving to an array of all submissions
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * // Export all submissions
+     * const allSubmissions = await client.submissions.export('form_123');
+     *
+     * // Process exported data
+     * for (const submission of allSubmissions) {
+     *   console.log(submission.data);
+     * }
+     * ```
+     *
+     * @see Requirements 5.3
+     */
+    export(formId: string): Promise<Submission[]>;
+    /**
+     * Perform a bulk update operation on multiple submissions.
+     *
+     * @param formId - The unique identifier of the form
+     * @param data - The bulk update request
+     * @param data.action - The action to perform ('markRead', 'markUnread', 'star', 'unstar', 'markSpam', 'notSpam')
+     * @param data.submission_ids - Array of submission IDs to update
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the form does not exist
+     * @throws ValidationError if the action is invalid or submission IDs are empty
+     *
+     * @example
+     * ```typescript
+     * // Mark submissions as read
+     * await client.submissions.bulkUpdate('form_123', {
+     *   action: 'markRead',
+     *   submission_ids: ['sub_1', 'sub_2', 'sub_3']
+     * });
+     *
+     * // Star submissions
+     * await client.submissions.bulkUpdate('form_123', {
+     *   action: 'star',
+     *   submission_ids: ['sub_1']
+     * });
+     *
+     * // Mark submissions as spam
+     * await client.submissions.bulkUpdate('form_123', {
+     *   action: 'markSpam',
+     *   submission_ids: ['sub_4', 'sub_5']
+     * });
+     *
+     * // Mark submissions as not spam
+     * await client.submissions.bulkUpdate('form_123', {
+     *   action: 'notSpam',
+     *   submission_ids: ['sub_6']
+     * });
+     * ```
+     *
+     * @see Requirements 5.4
+     */
+    bulkUpdate(formId: string, data: BulkUpdateRequest): Promise<SuccessResponse>;
+    /**
+     * Delete multiple submissions from a form.
+     *
+     * @param formId - The unique identifier of the form
+     * @param submissionIds - Array of submission IDs to delete
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the form does not exist
+     * @throws ValidationError if submission IDs are empty
+     *
+     * @example
+     * ```typescript
+     * // Delete multiple submissions
+     * await client.submissions.bulkDelete('form_123', ['sub_1', 'sub_2', 'sub_3']);
+     * ```
+     *
+     * @see Requirements 5.5
+     */
+    bulkDelete(formId: string, submissionIds: string[]): Promise<SuccessResponse>;
+}
+
+/**
+ * Rules Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing form rules:
+ * - list: Get all rules for a form
+ * - create: Create a new rule for a form
+ * - update: Update a rule by ID
+ * - delete: Delete a rule by ID
+ *
+ * @module resources/rules
+ */
+
+/**
+ * Resource class for managing form rules in Spike Forms.
+ *
+ * Rules allow you to configure conditional routing and processing for form submissions.
+ * Each rule consists of conditions that must be met and actions to take when they are.
+ *
+ * @example
+ * ```typescript
+ * // List all rules for a form
+ * const rules = await client.rules.list('form_123');
+ *
+ * // Create a new rule
+ * const rule = await client.rules.create('form_123', {
+ *   name: 'Email notification',
+ *   conditions: [{ field: 'email', operator: 'contains', value: '@company.com' }],
+ *   actions: [{ type: 'email', config: { to: 'team@company.com' } }]
+ * });
+ *
+ * // Update a rule
+ * const updated = await client.rules.update('form_123', 'rule_456', {
+ *   is_active: false
+ * });
+ *
+ * // Delete a rule
+ * await client.rules.delete('form_123', 'rule_456');
+ * ```
+ */
+declare class RulesResource {
+    private readonly http;
+    /**
+     * Create a new RulesResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * List all rules for a form.
+     *
+     * @param formId - The unique identifier of the form
+     * @returns Promise resolving to an array of rules
+     * @throws NotFoundError if the form does not exist
+     *
+     * @example
+     * ```typescript
+     * // Get all rules for a form
+     * const rules = await client.rules.list('form_123');
+     *
+     * // Filter active rules
+     * const activeRules = rules.filter(rule => rule.is_active);
+     *
+     * // Check rule conditions
+     * for (const rule of rules) {
+     *   console.log(`Rule: ${rule.name}, Conditions: ${rule.conditions.length}`);
+     * }
+     * ```
+     *
+     * @see Requirements 6.1
+     */
+    list(formId: string): Promise<Rule[]>;
+    /**
+     * Create a new rule for a form.
+     *
+     * @param formId - The unique identifier of the form
+     * @param data - The rule data to create
+     * @param data.name - Display name for the rule (required)
+     * @param data.conditions - Array of conditions that must be met (required)
+     * @param data.actions - Array of actions to take when conditions are met (required)
+     * @param data.is_active - Whether the rule should be active (defaults to true)
+     * @returns Promise resolving to the created rule
+     * @throws NotFoundError if the form does not exist
+     * @throws ValidationError if the rule data is invalid
+     *
+     * @example
+     * ```typescript
+     * // Create a simple email notification rule
+     * const rule = await client.rules.create('form_123', {
+     *   name: 'Notify on VIP submission',
+     *   conditions: [
+     *     { field: 'email', operator: 'ends_with', value: '@vip.com' }
+     *   ],
+     *   actions: [
+     *     { type: 'email', config: { to: 'sales@company.com', subject: 'VIP Lead!' } }
+     *   ]
+     * });
+     *
+     * // Create a webhook rule with multiple conditions
+     * const webhookRule = await client.rules.create('form_123', {
+     *   name: 'Send to CRM',
+     *   conditions: [
+     *     { field: 'type', operator: 'equals', value: 'enterprise' },
+     *     { field: 'budget', operator: 'contains', value: '10000' }
+     *   ],
+     *   actions: [
+     *     { type: 'webhook', config: { url: 'https://crm.example.com/leads' } }
+     *   ],
+     *   is_active: true
+     * });
+     *
+     * // Create an inactive rule (for testing)
+     * const testRule = await client.rules.create('form_123', {
+     *   name: 'Test Rule',
+     *   conditions: [{ field: 'test', operator: 'equals', value: 'true' }],
+     *   actions: [{ type: 'slack', config: { channel: '#test' } }],
+     *   is_active: false
+     * });
+     * ```
+     *
+     * @see Requirements 6.2
+     */
+    create(formId: string, data: CreateRuleRequest): Promise<Rule>;
+    /**
+     * Update a rule's properties.
+     *
+     * @param formId - The unique identifier of the form
+     * @param ruleId - The unique identifier of the rule to update
+     * @param data - The properties to update
+     * @param data.name - New display name for the rule
+     * @param data.conditions - New conditions for the rule
+     * @param data.actions - New actions for the rule
+     * @param data.is_active - Whether the rule should be active
+     * @returns Promise resolving to the updated rule
+     * @throws NotFoundError if the form or rule does not exist
+     * @throws ValidationError if the update data is invalid
+     *
+     * @example
+     * ```typescript
+     * // Update rule name
+     * const rule = await client.rules.update('form_123', 'rule_456', {
+     *   name: 'Updated Rule Name'
+     * });
+     *
+     * // Deactivate a rule
+     * const rule = await client.rules.update('form_123', 'rule_456', {
+     *   is_active: false
+     * });
+     *
+     * // Update conditions
+     * const rule = await client.rules.update('form_123', 'rule_456', {
+     *   conditions: [
+     *     { field: 'email', operator: 'contains', value: '@newdomain.com' }
+     *   ]
+     * });
+     *
+     * // Update actions
+     * const rule = await client.rules.update('form_123', 'rule_456', {
+     *   actions: [
+     *     { type: 'discord', config: { webhook_url: 'https://discord.com/api/webhooks/...' } }
+     *   ]
+     * });
+     *
+     * // Update multiple properties at once
+     * const rule = await client.rules.update('form_123', 'rule_456', {
+     *   name: 'New Name',
+     *   is_active: true,
+     *   conditions: [{ field: 'status', operator: 'equals', value: 'urgent' }],
+     *   actions: [{ type: 'email', config: { to: 'urgent@company.com' } }]
+     * });
+     * ```
+     *
+     * @see Requirements 6.3
+     */
+    update(formId: string, ruleId: string, data: UpdateRuleRequest): Promise<Rule>;
+    /**
+     * Delete a rule by ID.
+     *
+     * @param formId - The unique identifier of the form
+     * @param ruleId - The unique identifier of the rule to delete
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the form or rule does not exist
+     *
+     * @example
+     * ```typescript
+     * // Delete a rule
+     * await client.rules.delete('form_123', 'rule_456');
+     *
+     * // Delete multiple rules
+     * const ruleIds = ['rule_1', 'rule_2', 'rule_3'];
+     * for (const ruleId of ruleIds) {
+     *   await client.rules.delete('form_123', ruleId);
+     * }
+     * ```
+     *
+     * @see Requirements 6.4
+     */
+    delete(formId: string, ruleId: string): Promise<SuccessResponse>;
+}
+
+/**
+ * Projects Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing projects:
+ * - list: Get all projects
+ * - create: Create a new project
+ * - get: Retrieve a single project by ID
+ * - update: Update project properties
+ * - delete: Delete a project by ID
+ *
+ * @module resources/projects
+ */
+
+/**
+ * Resource class for managing projects in Spike Forms.
+ *
+ * Projects are used to organize forms into logical groups.
+ *
+ * @example
+ * ```typescript
+ * // List all projects
+ * const projects = await client.projects.list();
+ *
+ * // Create a new project
+ * const project = await client.projects.create({ name: 'Marketing Forms' });
+ *
+ * // Get a specific project
+ * const project = await client.projects.get('proj_123');
+ *
+ * // Update a project
+ * const updated = await client.projects.update('proj_123', { name: 'New Name' });
+ *
+ * // Delete a project
+ * await client.projects.delete('proj_123');
+ * ```
+ */
+declare class ProjectsResource {
+    private readonly http;
+    /**
+     * Create a new ProjectsResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * List all projects.
+     *
+     * @returns Promise resolving to an array of projects
+     *
+     * @example
+     * ```typescript
+     * const projects = await client.projects.list();
+     * console.log(`Found ${projects.length} projects`);
+     * ```
+     *
+     * @see Requirements 7.1
+     */
+    list(): Promise<Project[]>;
+    /**
+     * Create a new project.
+     *
+     * @param data - The project data to create
+     * @param data.name - Display name for the project (required)
+     * @returns Promise resolving to the created project
+     *
+     * @example
+     * ```typescript
+     * const project = await client.projects.create({ name: 'Marketing Forms' });
+     * console.log('Created project:', project.id);
+     * ```
+     *
+     * @see Requirements 7.2
+     */
+    create(data: CreateProjectRequest): Promise<Project>;
+    /**
+     * Get a single project by ID.
+     *
+     * @param id - The unique identifier of the project
+     * @returns Promise resolving to the project
+     * @throws NotFoundError if the project does not exist
+     *
+     * @example
+     * ```typescript
+     * const project = await client.projects.get('proj_123');
+     * console.log(project.name, project.form_count);
+     * ```
+     *
+     * @see Requirements 7.3
+     */
+    get(id: string): Promise<Project>;
+    /**
+     * Update a project's properties.
+     *
+     * @param id - The unique identifier of the project to update
+     * @param data - The properties to update
+     * @param data.name - New display name for the project
+     * @returns Promise resolving to the updated project
+     * @throws NotFoundError if the project does not exist
+     *
+     * @example
+     * ```typescript
+     * const project = await client.projects.update('proj_123', { name: 'New Name' });
+     * console.log('Updated project:', project.name);
+     * ```
+     *
+     * @see Requirements 7.4
+     */
+    update(id: string, data: UpdateProjectRequest): Promise<Project>;
+    /**
+     * Delete a project by ID.
+     *
+     * @param id - The unique identifier of the project to delete
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the project does not exist
+     *
+     * @example
+     * ```typescript
+     * await client.projects.delete('proj_123');
+     * ```
+     *
+     * @see Requirements 7.5
+     */
+    delete(id: string): Promise<SuccessResponse>;
+}
+
+/**
+ * Teams Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing teams and team collaboration:
+ * - list: Get all teams
+ * - create: Create a new team
+ * - get: Retrieve a single team by ID
+ * - update: Update team properties
+ * - delete: Delete a team by ID
+ * - listMembers: Get all members of a team
+ * - addMember: Add a user to a team
+ * - updateMember: Update a member's role
+ * - removeMember: Remove a member from a team
+ * - listInvitations: Get pending invitations for a team
+ * - invite: Create a new invitation
+ * - cancelInvitation: Cancel a pending invitation
+ * - acceptInvitation: Accept an invitation
+ *
+ * @module resources/teams
+ */
+
+/**
+ * Resource class for managing teams in Spike Forms.
+ *
+ * Teams enable collaborative form management with role-based access control.
+ *
+ * @example
+ * ```typescript
+ * // List all teams
+ * const teams = await client.teams.list();
+ *
+ * // Create a new team
+ * const team = await client.teams.create({ name: 'Marketing Team' });
+ *
+ * // Get a specific team
+ * const team = await client.teams.get('team_123');
+ *
+ * // Update a team
+ * const updated = await client.teams.update('team_123', { name: 'New Name' });
+ *
+ * // Delete a team
+ * await client.teams.delete('team_123');
+ *
+ * // Manage team members
+ * const members = await client.teams.listMembers('team_123');
+ * await client.teams.invite('team_123', { email: 'user@example.com', role: 'member' });
+ * ```
+ */
+declare class TeamsResource {
+    private readonly http;
+    /**
+     * Create a new TeamsResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * List all teams.
+     *
+     * @returns Promise resolving to an array of teams
+     *
+     * @example
+     * ```typescript
+     * const teams = await client.teams.list();
+     * console.log(`Found ${teams.length} teams`);
+     * ```
+     *
+     * @see Requirements 8.1
+     */
+    list(): Promise<Team[]>;
+    /**
+     * Create a new team.
+     *
+     * @param data - The team data to create
+     * @param data.name - Display name for the team (required)
+     * @returns Promise resolving to the created team
+     *
+     * @example
+     * ```typescript
+     * const team = await client.teams.create({ name: 'Marketing Team' });
+     * console.log('Created team:', team.id);
+     * ```
+     *
+     * @see Requirements 8.2
+     */
+    create(data: CreateTeamRequest): Promise<Team>;
+    /**
+     * Get a single team by ID.
+     *
+     * @param id - The unique identifier of the team
+     * @returns Promise resolving to the team
+     * @throws NotFoundError if the team does not exist
+     *
+     * @example
+     * ```typescript
+     * const team = await client.teams.get('team_123');
+     * console.log(team.name, team.member_count);
+     * ```
+     *
+     * @see Requirements 8.3
+     */
+    get(id: string): Promise<Team>;
+    /**
+     * Update a team's properties.
+     *
+     * @param id - The unique identifier of the team to update
+     * @param data - The properties to update
+     * @param data.name - New display name for the team
+     * @returns Promise resolving to the updated team
+     * @throws NotFoundError if the team does not exist
+     *
+     * @example
+     * ```typescript
+     * const team = await client.teams.update('team_123', { name: 'New Name' });
+     * console.log('Updated team:', team.name);
+     * ```
+     *
+     * @see Requirements 8.4
+     */
+    update(id: string, data: UpdateTeamRequest): Promise<Team>;
+    /**
+     * Delete a team by ID.
+     *
+     * @param id - The unique identifier of the team to delete
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the team does not exist
+     *
+     * @example
+     * ```typescript
+     * await client.teams.delete('team_123');
+     * ```
+     *
+     * @see Requirements 8.5
+     */
+    delete(id: string): Promise<SuccessResponse>;
+    /**
+     * List all members of a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @returns Promise resolving to an array of team members
+     * @throws NotFoundError if the team does not exist
+     *
+     * @example
+     * ```typescript
+     * const members = await client.teams.listMembers('team_123');
+     * members.forEach(member => {
+     *   console.log(`${member.user.name} (${member.role})`);
+     * });
+     * ```
+     *
+     * @see Requirements 8.6
+     */
+    listMembers(teamId: string): Promise<TeamMember[]>;
+    /**
+     * Add a user to a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param data - The member data
+     * @param data.email - Email address of the user to add
+     * @param data.role - Role to assign ('admin' or 'member')
+     * @returns Promise resolving to the created team member
+     * @throws NotFoundError if the team does not exist
+     * @throws ValidationError if the user is already a member
+     *
+     * @example
+     * ```typescript
+     * const member = await client.teams.addMember('team_123', {
+     *   email: 'user@example.com',
+     *   role: 'member'
+     * });
+     * console.log('Added member:', member.user.name);
+     * ```
+     *
+     * @see Requirements 8.7
+     */
+    addMember(teamId: string, data: InviteMemberRequest): Promise<TeamMember>;
+    /**
+     * Update a team member's role.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param memberId - The unique identifier of the team member
+     * @param data - The properties to update
+     * @param data.role - New role for the member ('admin' or 'member')
+     * @returns Promise resolving to the updated team member
+     * @throws NotFoundError if the team or member does not exist
+     *
+     * @example
+     * ```typescript
+     * const member = await client.teams.updateMember('team_123', 'member_456', {
+     *   role: 'admin'
+     * });
+     * console.log('Updated role to:', member.role);
+     * ```
+     *
+     * @see Requirements 8.8
+     */
+    updateMember(teamId: string, memberId: string, data: UpdateMemberRequest): Promise<TeamMember>;
+    /**
+     * Remove a member from a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param memberId - The unique identifier of the team member to remove
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the team or member does not exist
+     *
+     * @example
+     * ```typescript
+     * await client.teams.removeMember('team_123', 'member_456');
+     * ```
+     *
+     * @see Requirements 8.9
+     */
+    removeMember(teamId: string, memberId: string): Promise<SuccessResponse>;
+    /**
+     * List all pending invitations for a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @returns Promise resolving to an array of pending invitations
+     * @throws NotFoundError if the team does not exist
+     *
+     * @example
+     * ```typescript
+     * const invitations = await client.teams.listInvitations('team_123');
+     * invitations.forEach(inv => {
+     *   console.log(`${inv.email} invited as ${inv.role}`);
+     * });
+     * ```
+     *
+     * @see Requirements 8.10
+     */
+    listInvitations(teamId: string): Promise<TeamInvitation[]>;
+    /**
+     * Create a new invitation to join a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param data - The invitation data
+     * @param data.email - Email address of the person to invite
+     * @param data.role - Role to assign upon acceptance ('admin' or 'member')
+     * @returns Promise resolving to the created invitation
+     * @throws NotFoundError if the team does not exist
+     * @throws ValidationError if an invitation already exists for this email
+     *
+     * @example
+     * ```typescript
+     * const invitation = await client.teams.invite('team_123', {
+     *   email: 'newuser@example.com',
+     *   role: 'member'
+     * });
+     * console.log('Invitation token:', invitation.token);
+     * ```
+     *
+     * @see Requirements 8.11
+     */
+    invite(teamId: string, data: InviteMemberRequest): Promise<TeamInvitation>;
+    /**
+     * Cancel a pending invitation.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param invitationId - The unique identifier of the invitation to cancel
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the team or invitation does not exist
+     *
+     * @example
+     * ```typescript
+     * await client.teams.cancelInvitation('team_123', 'inv_456');
+     * ```
+     *
+     * @see Requirements 8.12
+     */
+    cancelInvitation(teamId: string, invitationId: string): Promise<SuccessResponse>;
+    /**
+     * Accept a team invitation using the invitation token.
+     *
+     * @param token - The unique invitation token
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the invitation does not exist or has expired
+     *
+     * @example
+     * ```typescript
+     * await client.teams.acceptInvitation('inv_token_abc123');
+     * ```
+     *
+     * @see Requirements 8.13
+     */
+    acceptInvitation(token: string): Promise<SuccessResponse>;
+}
+
+/**
+ * User Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing user profile and security settings:
+ * - get: Get the current user profile
+ * - update: Update user profile properties
+ * - delete: Delete the user account
+ * - setup2FA: Initiate 2FA setup and get secret
+ * - enable2FA: Enable 2FA with a verification code
+ * - disable2FA: Disable 2FA with a verification code
+ * - verify2FA: Verify a 2FA code
+ * - listApiKeys: Get all user API keys
+ * - createApiKey: Create a new API key
+ * - deleteApiKey: Delete an API key
+ *
+ * @module resources/user
+ */
+
+/**
+ * Resource class for managing user profile and security settings in Spike Forms.
+ *
+ * Provides access to user profile management, two-factor authentication,
+ * and API key management.
+ *
+ * @example
+ * ```typescript
+ * // Get current user profile
+ * const user = await client.user.get();
+ *
+ * // Update user profile
+ * const updated = await client.user.update({ name: 'New Name' });
+ *
+ * // Set up 2FA
+ * const setup = await client.user.setup2FA();
+ * console.log('Scan QR code:', setup.qr_code);
+ *
+ * // Enable 2FA with verification code
+ * await client.user.enable2FA('123456');
+ *
+ * // Manage API keys
+ * const keys = await client.user.listApiKeys();
+ * const newKey = await client.user.createApiKey({ name: 'My App' });
+ * ```
+ */
+declare class UserResource {
+    private readonly http;
+    /**
+     * Create a new UserResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * Get the current user profile.
+     *
+     * @returns Promise resolving to the current user
+     *
+     * @example
+     * ```typescript
+     * const user = await client.user.get();
+     * console.log(`Hello, ${user.name}!`);
+     * console.log(`2FA enabled: ${user.two_factor_enabled}`);
+     * ```
+     *
+     * @see Requirements 9.1
+     */
+    get(): Promise<User>;
+    /**
+     * Update the current user's profile properties.
+     *
+     * @param data - The properties to update
+     * @param data.name - New display name for the user
+     * @param data.email - New email address for the user
+     * @returns Promise resolving to the updated user
+     *
+     * @example
+     * ```typescript
+     * const user = await client.user.update({ name: 'New Name' });
+     * console.log('Updated name:', user.name);
+     * ```
+     *
+     * @see Requirements 9.2
+     */
+    update(data: UpdateUserRequest): Promise<User>;
+    /**
+     * Delete the current user's account.
+     *
+     * This action is irreversible and will delete all associated data.
+     *
+     * @returns Promise resolving to a success response
+     *
+     * @example
+     * ```typescript
+     * await client.user.delete();
+     * console.log('Account deleted');
+     * ```
+     *
+     * @see Requirements 9.3
+     */
+    delete(): Promise<SuccessResponse>;
+    /**
+     * Initiate two-factor authentication setup.
+     *
+     * Returns a secret and QR code for configuring an authenticator app.
+     *
+     * @returns Promise resolving to the 2FA setup response with secret and QR code
+     *
+     * @example
+     * ```typescript
+     * const setup = await client.user.setup2FA();
+     * console.log('Secret:', setup.secret);
+     * console.log('QR Code:', setup.qr_code);
+     * // Display QR code to user for scanning with authenticator app
+     * ```
+     *
+     * @see Requirements 9.4
+     */
+    setup2FA(): Promise<Setup2FAResponse>;
+    /**
+     * Enable two-factor authentication with a verification code.
+     *
+     * Call this after setup2FA to confirm the user has configured their
+     * authenticator app correctly.
+     *
+     * @param code - The 6-digit verification code from the authenticator app
+     * @returns Promise resolving to a success response
+     * @throws ValidationError if the code is invalid
+     *
+     * @example
+     * ```typescript
+     * await client.user.enable2FA('123456');
+     * console.log('2FA enabled successfully');
+     * ```
+     *
+     * @see Requirements 9.5
+     */
+    enable2FA(code: string): Promise<SuccessResponse>;
+    /**
+     * Disable two-factor authentication.
+     *
+     * Requires a valid verification code to confirm the user's identity.
+     *
+     * @param code - The 6-digit verification code from the authenticator app
+     * @returns Promise resolving to a success response
+     * @throws ValidationError if the code is invalid
+     *
+     * @example
+     * ```typescript
+     * await client.user.disable2FA('123456');
+     * console.log('2FA disabled');
+     * ```
+     *
+     * @see Requirements 9.6
+     */
+    disable2FA(code: string): Promise<SuccessResponse>;
+    /**
+     * Verify a two-factor authentication code.
+     *
+     * Use this to verify a 2FA code during login or sensitive operations.
+     *
+     * @param code - The 6-digit verification code from the authenticator app
+     * @returns Promise resolving to a success response
+     * @throws ValidationError if the code is invalid
+     *
+     * @example
+     * ```typescript
+     * await client.user.verify2FA('123456');
+     * console.log('2FA code verified');
+     * ```
+     *
+     * @see Requirements 9.7
+     */
+    verify2FA(code: string): Promise<SuccessResponse>;
+    /**
+     * List all API keys for the current user.
+     *
+     * Note: The `key` field will only contain the full key value when
+     * the key is first created. For existing keys, it may be masked.
+     *
+     * @returns Promise resolving to an array of API keys
+     *
+     * @example
+     * ```typescript
+     * const keys = await client.user.listApiKeys();
+     * keys.forEach(key => {
+     *   console.log(`${key.name}: last used ${key.last_used_at || 'never'}`);
+     * });
+     * ```
+     *
+     * @see Requirements 9.8
+     */
+    listApiKeys(): Promise<ApiKey[]>;
+    /**
+     * Create a new API key.
+     *
+     * The returned API key will include the full key value in the `key` field.
+     * This is the only time the full key is available - store it securely.
+     *
+     * @param data - The API key data
+     * @param data.name - Display name for the API key (required)
+     * @returns Promise resolving to the created API key with full key value
+     *
+     * @example
+     * ```typescript
+     * const apiKey = await client.user.createApiKey({ name: 'My Application' });
+     * console.log('API Key created:', apiKey.key);
+     * // Store this key securely - it won't be shown again!
+     * ```
+     *
+     * @see Requirements 9.9
+     */
+    createApiKey(data: CreateApiKeyRequest): Promise<ApiKey>;
+    /**
+     * Delete an API key by ID.
+     *
+     * @param id - The unique identifier of the API key to delete
+     * @returns Promise resolving to a success response
+     * @throws NotFoundError if the API key does not exist
+     *
+     * @example
+     * ```typescript
+     * await client.user.deleteApiKey('key_123');
+     * console.log('API key deleted');
+     * ```
+     *
+     * @see Requirements 9.10
+     */
+    deleteApiKey(id: string): Promise<SuccessResponse>;
+}
+
+/**
+ * Billing Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing billing and subscriptions:
+ * - createCheckout: Create a Stripe checkout session for subscription
+ * - createPortal: Create a Stripe billing portal session for managing subscription
+ *
+ * @module resources/billing
+ */
+
+/**
+ * Resource class for managing billing and subscriptions in Spike Forms.
+ *
+ * Provides access to Stripe checkout and billing portal functionality
+ * for managing user subscriptions.
+ *
+ * @example
+ * ```typescript
+ * // Create a checkout session for a new subscription
+ * const checkout = await client.billing.createCheckout({
+ *   price_id: 'price_123',
+ *   success_url: 'https://myapp.com/success',
+ *   cancel_url: 'https://myapp.com/cancel'
+ * });
+ * // Redirect user to checkout.url
+ *
+ * // Create a billing portal session for managing subscription
+ * const portal = await client.billing.createPortal();
+ * // Redirect user to portal.url
+ * ```
+ */
+declare class BillingResource {
+    private readonly http;
+    /**
+     * Create a new BillingResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * Create a Stripe checkout session for starting a new subscription.
+     *
+     * Returns a URL that the user should be redirected to in order to
+     * complete the checkout process on Stripe's hosted checkout page.
+     *
+     * @param data - The checkout session configuration
+     * @param data.price_id - The Stripe price ID for the subscription plan
+     * @param data.success_url - URL to redirect to after successful checkout
+     * @param data.cancel_url - URL to redirect to if checkout is cancelled
+     * @returns Promise resolving to the checkout response with redirect URL
+     *
+     * @example
+     * ```typescript
+     * const checkout = await client.billing.createCheckout({
+     *   price_id: 'price_1234567890',
+     *   success_url: 'https://myapp.com/checkout/success',
+     *   cancel_url: 'https://myapp.com/checkout/cancel'
+     * });
+     *
+     * // Redirect the user to complete checkout
+     * window.location.href = checkout.url;
+     * ```
+     *
+     * @see Requirements 10.1
+     */
+    createCheckout(data: CreateCheckoutRequest): Promise<CheckoutResponse>;
+    /**
+     * Create a Stripe billing portal session for managing an existing subscription.
+     *
+     * Returns a URL that the user should be redirected to in order to
+     * access the Stripe billing portal where they can:
+     * - View and update payment methods
+     * - View billing history and invoices
+     * - Upgrade, downgrade, or cancel their subscription
+     *
+     * @returns Promise resolving to the portal response with redirect URL
+     *
+     * @example
+     * ```typescript
+     * const portal = await client.billing.createPortal();
+     *
+     * // Redirect the user to the billing portal
+     * window.location.href = portal.url;
+     * ```
+     *
+     * @see Requirements 10.2
+     */
+    createPortal(): Promise<PortalResponse>;
+}
+
+/**
+ * Files Resource for the Spike Forms SDK
+ *
+ * Provides methods for managing uploaded files:
+ * - getDownloadUrl: Get a signed download URL for a file
+ * - delete: Delete a file by ID
+ *
+ * @module resources/files
+ */
+
+/**
+ * Resource class for managing uploaded files in Spike Forms.
+ *
+ * Provides access to file download URLs and deletion functionality
+ * for files attached to form submissions.
+ *
+ * @example
+ * ```typescript
+ * // Get a signed download URL for a file
+ * const download = await client.files.getDownloadUrl('file_123');
+ * console.log(download.url); // Signed URL for downloading
+ * console.log(download.expires_at); // When the URL expires
+ *
+ * // Delete a file
+ * const result = await client.files.delete('file_123');
+ * console.log(result.success); // true
+ * ```
+ */
+declare class FilesResource {
+    private readonly http;
+    /**
+     * Create a new FilesResource instance
+     * @param http - The HTTP client to use for API requests
+     */
+    constructor(http: HttpClient);
+    /**
+     * Get a signed download URL for a file.
+     *
+     * Returns a temporary signed URL that can be used to download the file.
+     * The URL will expire at the time indicated in the response.
+     *
+     * @param id - The unique identifier of the file
+     * @returns Promise resolving to the download response with signed URL and expiration
+     *
+     * @example
+     * ```typescript
+     * const download = await client.files.getDownloadUrl('file_abc123');
+     *
+     * // Use the signed URL to download the file
+     * const response = await fetch(download.url);
+     * const blob = await response.blob();
+     *
+     * // Check when the URL expires
+     * console.log(`URL expires at: ${download.expires_at}`);
+     * ```
+     *
+     * @see Requirements 11.1
+     */
+    getDownloadUrl(id: string): Promise<FileDownloadResponse>;
+    /**
+     * Delete a file by ID.
+     *
+     * Permanently removes the file from storage. This action cannot be undone.
+     *
+     * @param id - The unique identifier of the file to delete
+     * @returns Promise resolving to a success response
+     *
+     * @example
+     * ```typescript
+     * const result = await client.files.delete('file_abc123');
+     *
+     * if (result.success) {
+     *   console.log('File deleted successfully');
+     * }
+     * ```
+     *
+     * @see Requirements 11.2
+     */
+    delete(id: string): Promise<SuccessResponse>;
+}
+
+/**
+ * Spike Client for the Spike Forms SDK
+ *
+ * The main entry point for the SDK. Initializes all resource classes
+ * and manages configuration for authenticated API requests.
+ *
+ * @module client
+ */
+
+/**
+ * Configuration options for the Spike client.
+ *
+ * @example
+ * ```typescript
+ * const config: SpikeClientConfig = {
+ *   apiKey: 'sk_live_abc123',
+ *   baseUrl: 'https://spike.ac',
+ *   timeout: 30000
+ * };
+ * ```
+ */
+interface SpikeClientConfig {
+    /**
+     * API key for authentication.
+     * User API keys are prefixed with `sk_`.
+     * @see Requirements 1.1, 1.6
+     */
+    apiKey: string;
+    /**
+     * Base URL for API requests.
+     * @default 'https://api.spike.ac'
+     * @see Requirements 2.2
+     */
+    baseUrl?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     * @see Requirements 1.5
+     */
+    timeout?: number;
+}
+/**
+ * The main Spike Forms SDK client.
+ *
+ * Provides access to all Spike Forms API resources through a unified interface.
+ * Initialize with your API key to start making authenticated requests.
+ *
+ * @example
+ * ```typescript
+ * // Basic initialization
+ * const client = new SpikeClient({ apiKey: 'sk_live_abc123' });
+ *
+ * // With custom configuration
+ * const client = new SpikeClient({
+ *   apiKey: 'sk_live_abc123',
+ *   baseUrl: 'https://custom.spike.ac',
+ *   timeout: 60000
+ * });
+ *
+ * // Use resources
+ * const forms = await client.forms.list();
+ * const projects = await client.projects.list();
+ * const user = await client.user.get();
+ * ```
+ *
+ * @see Requirements 1.1, 1.2, 1.3, 1.4, 1.5, 1.6
+ */
+declare class SpikeClient {
+    /**
+     * Resource for managing forms.
+     * @see FormsResource
+     */
+    readonly forms: FormsResource;
+    /**
+     * Resource for managing form submissions.
+     * @see SubmissionsResource
+     */
+    readonly submissions: SubmissionsResource;
+    /**
+     * Resource for managing form rules.
+     * @see RulesResource
+     */
+    readonly rules: RulesResource;
+    /**
+     * Resource for managing projects.
+     * @see ProjectsResource
+     */
+    readonly projects: ProjectsResource;
+    /**
+     * Resource for managing teams.
+     * @see TeamsResource
+     */
+    readonly teams: TeamsResource;
+    /**
+     * Resource for managing user profile and settings.
+     * @see UserResource
+     */
+    readonly user: UserResource;
+    /**
+     * Resource for managing billing and subscriptions.
+     * @see BillingResource
+     */
+    readonly billing: BillingResource;
+    /**
+     * Resource for managing uploaded files.
+     * @see FilesResource
+     */
+    readonly files: FilesResource;
+    /**
+     * The HTTP client used for API requests.
+     * @internal
+     */
+    private readonly http;
+    /**
+     * Create a new Spike client instance.
+     *
+     * @param config - Configuration options for the client
+     * @throws ValidationError if the API key is missing or empty
+     *
+     * @example
+     * ```typescript
+     * // Basic usage with API key
+     * const client = new SpikeClient({ apiKey: 'sk_live_abc123' });
+     *
+     * // With all configuration options
+     * const client = new SpikeClient({
+     *   apiKey: 'sk_live_abc123',
+     *   baseUrl: 'https://spike.ac',
+     *   timeout: 30000
+     * });
+     * ```
+     *
+     * @see Requirements 1.1, 1.2, 1.3, 1.4, 1.5
+     */
+    constructor(config: SpikeClientConfig);
+}
+
+/**
+ * Error classes for the Spike Forms SDK
+ *
+ * Provides a hierarchy of error types for different API error conditions:
+ * - SpikeError: Base error class for all SDK errors
+ * - AuthenticationError: 401 Unauthorized errors
+ * - NotFoundError: 404 Not Found errors
+ * - RateLimitError: 429 Too Many Requests errors
+ * - ValidationError: 400 Bad Request errors
+ * - NetworkError: Network/connection failures
+ */
+/**
+ * Base error class for all Spike SDK errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.forms.get('invalid-id');
+ * } catch (error) {
+ *   if (error instanceof SpikeError) {
+ *     console.log(error.statusCode); // HTTP status code
+ *     console.log(error.code);       // Error code from API
+ *     console.log(error.requestId);  // Request ID for debugging
+ *   }
+ * }
+ * ```
+ */
+declare class SpikeError extends Error {
+    /** HTTP status code from the API response */
+    statusCode?: number;
+    /** Error code from the API (e.g., 'INVALID_API_KEY', 'FORM_NOT_FOUND') */
+    code?: string;
+    /** Request ID for debugging and support purposes */
+    requestId?: string;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        code?: string;
+        requestId?: string;
+    });
+}
+/**
+ * Error thrown when authentication fails (HTTP 401).
+ *
+ * This error is thrown when:
+ * - The API key is invalid or expired
+ * - The API key is missing from the request
+ * - The API key doesn't have permission for the requested resource
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.forms.list();
+ * } catch (error) {
+ *   if (error instanceof AuthenticationError) {
+ *     console.log('Please check your API key');
+ *   }
+ * }
+ * ```
+ */
+declare class AuthenticationError extends SpikeError {
+    constructor(message: string, options?: {
+        code?: string;
+        requestId?: string;
+    });
+}
+/**
+ * Error thrown when a resource is not found (HTTP 404).
+ *
+ * This error is thrown when:
+ * - The requested form, project, team, or other resource doesn't exist
+ * - The resource ID is invalid
+ * - The resource was deleted
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.forms.get('non-existent-id');
+ * } catch (error) {
+ *   if (error instanceof NotFoundError) {
+ *     console.log('Form not found');
+ *   }
+ * }
+ * ```
+ */
+declare class NotFoundError extends SpikeError {
+    constructor(message: string, options?: {
+        code?: string;
+        requestId?: string;
+    });
+}
+/**
+ * Error thrown when rate limit is exceeded (HTTP 429).
+ *
+ * This error is thrown when too many requests are made in a short period.
+ * The `retryAfter` property indicates how many seconds to wait before retrying.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.forms.list();
+ * } catch (error) {
+ *   if (error instanceof RateLimitError) {
+ *     console.log(`Rate limited. Retry after ${error.retryAfter} seconds`);
+ *     await sleep(error.retryAfter * 1000);
+ *     // Retry the request
+ *   }
+ * }
+ * ```
+ */
+declare class RateLimitError extends SpikeError {
+    /** Number of seconds to wait before retrying the request */
+    retryAfter?: number;
+    constructor(message: string, options?: {
+        code?: string;
+        requestId?: string;
+        retryAfter?: number;
+    });
+}
+/**
+ * Error thrown when request validation fails (HTTP 400).
+ *
+ * This error is thrown when:
+ * - Required fields are missing
+ * - Field values are invalid
+ * - Request body format is incorrect
+ *
+ * The `details` property contains field-specific validation errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.forms.create({ name: '' });
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.log('Validation failed:', error.details);
+ *     // { name: 'Name is required' }
+ *   }
+ * }
+ * ```
+ */
+declare class ValidationError extends SpikeError {
+    /** Field-specific validation error details */
+    details?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        code?: string;
+        requestId?: string;
+        details?: Record<string, unknown>;
+    });
+}
+/**
+ * Error thrown when a network error occurs.
+ *
+ * This error is thrown when:
+ * - The network connection fails
+ * - The request times out
+ * - DNS resolution fails
+ * - The server is unreachable
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.forms.list();
+ * } catch (error) {
+ *   if (error instanceof NetworkError) {
+ *     console.log('Network error:', error.message);
+ *     // Retry with exponential backoff
+ *   }
+ * }
+ * ```
+ */
+declare class NetworkError extends SpikeError {
+    constructor(message: string, options?: {
+        code?: string;
+        requestId?: string;
+    });
+}
+
+/**
+ * @spike-forms/sdk
+ * TypeScript SDK for the Spike Forms API
+ *
+ * This module exports all SDK components including:
+ * - SpikeClient: The main client class for API access
+ * - Error classes: Custom error types for different error conditions
+ * - Type definitions: TypeScript interfaces for all entities and requests
+ * - Resource classes: Individual resource classes for direct use
+ *
+ * @example
+ * ```typescript
+ * import { SpikeClient, SpikeError, NotFoundError } from '@spike-forms/sdk';
+ *
+ * const client = new SpikeClient({ apiKey: 'sk_live_abc123' });
+ *
+ * try {
+ *   const forms = await client.forms.list();
+ *   console.log(forms);
+ * } catch (error) {
+ *   if (error instanceof NotFoundError) {
+ *     console.log('Resource not found');
+ *   } else if (error instanceof SpikeError) {
+ *     console.log('API error:', error.message);
+ *   }
+ * }
+ * ```
+ *
+ * @module @spike-forms/sdk
+ */
+declare const VERSION = "0.1.0";
+
+export { type ApiKey, AuthenticationError, BillingResource, type BulkAction, type BulkUpdateRequest, type CheckoutResponse, type CreateApiKeyRequest, type CreateCheckoutRequest, type CreateFormRequest, type CreateProjectRequest, type CreateRuleRequest, type CreateTeamRequest, type FileDownloadResponse, FilesResource, type Form, FormsResource, type InviteMemberRequest, type ListFormsParams, type ListSubmissionsParams, NetworkError, NotFoundError, type PaginatedResponse, type PaginationParams, type PortalResponse, type Project, ProjectsResource, RateLimitError, type Rule, type RuleAction, type RuleActionType, type RuleCondition, type RuleConditionOperator, RulesResource, type Setup2FAResponse, SpikeClient, type SpikeClientConfig, SpikeError, type Submission, type SubmissionOrder, type SubmissionResponse, type SubmissionStats, SubmissionsResource, type SuccessResponse, type Team, type TeamInvitation, type TeamInvitationRole, type TeamMember, type TeamMemberRole, TeamsResource, type UpdateFormRequest, type UpdateMemberRequest, type UpdateProjectRequest, type UpdateRuleRequest, type UpdateTeamRequest, type UpdateUserRequest, type User, UserResource, VERSION, ValidationError };