Skip to content

Beautiful Open-Source Form Builder

30.4 KB
Raw Blame
<?php

use App\Http\Controllers\Auth\ForgotPasswordController;
use App\Http\Controllers\Auth\LoginController;
use App\Http\Controllers\Auth\OAuthController;
use App\Http\Controllers\Auth\OidcLinkController;
use App\Http\Controllers\Auth\RegisterController;
use App\Http\Controllers\Auth\ResetPasswordController;
use App\Http\Controllers\Auth\UserController;
use App\Http\Controllers\Auth\VerificationController;
use App\Http\Controllers\Forms\FormController;
use App\Http\Controllers\Forms\FormStatsController;
use App\Http\Controllers\Forms\FormSummaryController;
use App\Http\Controllers\Forms\FormSubmissionController;
use App\Http\Controllers\Forms\Integration\FormIntegrationsController;
use App\Http\Controllers\Forms\Integration\FormIntegrationsEventController;
use App\Http\Controllers\Forms\Integration\FormZapierWebhookController;
use App\Http\Controllers\Forms\FormImportController;
use App\Http\Controllers\Forms\PublicFormController;
use App\Http\Controllers\Pdf\PdfTemplateController;
use App\Http\Controllers\Pdf\PdfGenerateController;
use App\Http\Controllers\Settings\OAuthProviderController;
use App\Http\Controllers\Settings\PasswordController;
use App\Http\Controllers\Settings\ProfileController;
use App\Http\Controllers\Settings\TokenController;
use App\Http\Controllers\Settings\McpSettingsController;
use App\Http\Controllers\SubscriptionController;
use App\Http\Controllers\Forms\TemplateController;
use App\Http\Controllers\Auth\UserInviteController;
use App\Http\Controllers\Forms\FormPaymentController;
use App\Http\Controllers\WorkspaceController;
use App\Http\Controllers\WorkspaceUserController;
use App\Http\Controllers\VersionController;
use App\Service\Storage\SafeFileResponseService;
use Illuminate\Foundation\Http\Middleware\HandlePrecognitiveRequests;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
use App\Http\Controllers\HealthCheckController;
use App\Http\Controllers\AgentFormDraftController;
use App\Http\Controllers\McpOAuthSessionController;
use App\Http\Controllers\RevokeMcpOAuthSessionController;

/*
|--------------------------------------------------------------------------
| API Routes
|--------------------------------------------------------------------------
|
| Here is where you can register API routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| is assigned the "api" middleware group. Enjoy building your API!
|
*/

if (config('app.self_hosted')) {
    Route::get('/healthcheck', [HealthCheckController::class, 'apiCheck']);
}

Route::middleware('mcp.enabled')->group(function () {
    Route::prefix('agent-drafts')->name('agent-drafts.')->middleware('mcp.guest-drafts')->group(function () {
        Route::get('/preview/{draft}', [AgentFormDraftController::class, 'preview'])
            ->withoutMiddleware('throttle:internal-api')
            ->middleware(['signed', 'throttle:agent-draft-preview'])
            ->name('preview');
        Route::post('/handoff/consume', [AgentFormDraftController::class, 'consume'])
            ->withoutMiddleware('throttle:internal-api')
            ->middleware('throttle:agent-draft-handoff')
            ->name('handoff.consume');
        Route::get('/editor/current', [AgentFormDraftController::class, 'current'])
            ->withoutMiddleware('throttle:internal-api')
            ->middleware('throttle:agent-draft-editor')
            ->name('editor.current');
        Route::put('/editor/current', [AgentFormDraftController::class, 'replace'])
            ->withoutMiddleware('throttle:internal-api')
            ->middleware('throttle:agent-draft-editor')
            ->name('editor.replace');
        Route::post('/editor/claim', [AgentFormDraftController::class, 'claim'])
            ->withoutMiddleware('throttle:internal-api')
            ->middleware(['auth.multi', 'throttle:30,1'])
            ->name('editor.claim');
    });

    if (config('oauth.enabled', false)) {
        Route::post('/mcp-oauth/session', McpOAuthSessionController::class)
            ->middleware(['auth.multi', 'throttle:30,1'])
            ->name('mcp-oauth.session');
        Route::delete('/mcp-oauth/session', RevokeMcpOAuthSessionController::class)
            ->middleware(['auth.mcp.optional', 'throttle:30,1'])
            ->name('mcp-oauth.session.revoke');
    }
});

Route::prefix('open')->name('open.')->group(function () {
    Route::prefix('forms')->name('forms.')->group(function () {
        Route::post('/import', [FormImportController::class, 'import'])
            ->middleware('throttle:10,1')
            ->name('import');
    });
});

Route::group(['middleware' => 'auth.multi'], function () {
    Route::post('logout', [LoginController::class, 'logout'])->name('logout');
    Route::post('auth/oidc/link', [OidcLinkController::class, 'link'])->name('oidc.link');

    // Versions
    Route::prefix('versions')->name('versions.')->group(function () {
        Route::get('{model_type}/{id}', [VersionController::class, 'index'])->name('index');
        Route::post('{versionId}/restore', [VersionController::class, 'restore'])->name('restore');
    });

    // Unsplash
    Route::get('/unsplash', [\App\Http\Controllers\Content\UnsplashController::class, 'index'])->name('unsplash.index');
    Route::post('/unsplash/download', [\App\Http\Controllers\Content\UnsplashController::class, 'download'])->name('unsplash.download');

    Route::get('user', [UserController::class, 'current'])->name('user.current');
    Route::delete('user', [UserController::class, 'deleteAccount']);

    Route::prefix('/settings')->name('settings.')->group(function () {
        Route::patch('/profile', [ProfileController::class, 'update']);
        Route::patch('/password', [PasswordController::class, 'update']);

        Route::prefix('/tokens')->name('tokens.')->group(function () {
            Route::get('/abilities', [\App\Http\Controllers\Settings\TokenController::class, 'abilities'])->name('abilities');
            Route::get('/', [TokenController::class, 'index'])->name('index');
            Route::post('/', [TokenController::class, 'store'])->name('store');
            Route::delete('{token}', [TokenController::class, 'destroy'])->name('destroy');
        });

        Route::prefix('/providers')->name('providers.')->group(function () {
            Route::delete('/{provider}', [OAuthProviderController::class, 'destroy'])->name('destroy');
        });

        Route::prefix('/license')->name('license.')->middleware(['self-hosted'])->group(function () {
            Route::get('/status', [\App\Http\Controllers\Settings\LicenseController::class, 'status'])->name('status');
            Route::post('/activate', [\App\Http\Controllers\Settings\LicenseController::class, 'activate'])->name('activate');
            Route::post('/deactivate', [\App\Http\Controllers\Settings\LicenseController::class, 'deactivate'])->name('deactivate');
            Route::post('/portal', [\App\Http\Controllers\Settings\LicenseController::class, 'portal'])->name('portal');
        });

        Route::prefix('/mcp')->name('mcp.')->group(function () {
            Route::get('/', [McpSettingsController::class, 'show'])->name('show');
            Route::put('/', [McpSettingsController::class, 'update'])->middleware(['self-hosted'])->name('update');
        });

        Route::prefix('/two-factor')->name('two-factor.')->group(function () {
            Route::post('/enable', [\App\Http\Controllers\Settings\TwoFactorController::class, 'enable'])->name('enable');
            Route::post('/confirm', [\App\Http\Controllers\Settings\TwoFactorController::class, 'confirm'])->name('confirm');
            Route::post('/disable', [\App\Http\Controllers\Settings\TwoFactorController::class, 'disable'])->name('disable');
            Route::post('/recovery-codes', [\App\Http\Controllers\Settings\TwoFactorController::class, 'recoveryCodes'])->name('recovery-codes');
            Route::post('/recovery-codes/regenerate', [\App\Http\Controllers\Settings\TwoFactorController::class, 'regenerateRecoveryCodes'])->name('recovery-codes.regenerate');
        });
    });

    Route::prefix('subscription')->name('subscription.')->group(function () {
        Route::put('/update-customer-details', [SubscriptionController::class, 'updateStripeDetails'])->name('update-stripe-details');
        Route::get('/new/{subscription}/{plan}/checkout/{trial?}', [SubscriptionController::class, 'checkout'])
            ->name('checkout')
            ->where('subscription', '(' . implode('|', SubscriptionController::SUBSCRIPTION_NAMES) . ')')
            ->where('plan', '(' . implode('|', SubscriptionController::SUBSCRIPTION_PLANS) . ')');
        Route::get('/billing-portal', [SubscriptionController::class, 'billingPortal'])->name('billing-portal');
        Route::get('/users-count', [SubscriptionController::class, 'getUsersCount'])->name('users-count');
        Route::post('/change-plan', [SubscriptionController::class, 'changePlan'])->name('change-plan');
    });

    Route::prefix('open')->name('open.')->group(function () {
        Route::get('/providers', [OAuthProviderController::class, 'index'])->name('providers');

        Route::get('/forms', [FormController::class, 'indexAll'])->name('forms.index-all');
        Route::get('/forms/{form}', [FormController::class, 'show'])->name('forms.show');

        Route::prefix('workspaces')->name('workspaces.')->group(function () {
            Route::get('/', [WorkspaceController::class, 'index'])->name('index');
            Route::post('/create', [WorkspaceController::class, 'create'])->name('create');

            Route::prefix('/{workspace}')->group(function () {
                Route::get(
                    '/users',
                    [WorkspaceUserController::class, 'listUsers']
                )->name('users.index');
                Route::get(
                    '/invites',
                    [UserInviteController::class, 'listInvites']
                )->name('invites.index');

                Route::post(
                    '/users/add',
                    [WorkspaceUserController::class, 'addUser']
                )->name('users.add');

                Route::delete(
                    '/users/{user}/remove',
                    [WorkspaceUserController::class, 'removeUser']
                )->name('users.remove');

                Route::post(
                    '/invites/{inviteId}/resend',
                    [UserInviteController::class, 'resendInvite']
                )->name('invites.resend');

                Route::delete(
                    '/invites/{inviteId}/cancel',
                    [UserInviteController::class, 'cancelInvite']
                )->name('invites.cancel');

                Route::put(
                    '/users/{user}/update-role',
                    [WorkspaceUserController::class, 'updateUserRole']
                )->name('users.update-role');

                // leave workspace route
                Route::post(
                    '/leave',
                    [WorkspaceUserController::class, 'leaveWorkspace']
                )->name('leave');

                Route::get(
                    '/forms',
                    [FormController::class, 'index']
                )->name('forms.index');
                Route::get('/custom-domains/verification', [WorkspaceController::class, 'customDomainVerification'])->name('custom-domain-verification');
                Route::put('/custom-domains', [WorkspaceController::class, 'saveCustomDomain'])->name('save-custom-domains');
                Route::put('/email-settings', [WorkspaceController::class, 'saveEmailSettings'])->name('save-email-settings');
                Route::put('/custom-code-settings', [WorkspaceController::class, 'saveCustomCodeSettings'])->name('save-custom-code-settings');
                Route::put('/external-file-link-settings', [WorkspaceController::class, 'saveExternalFileLinkSettings'])->name('save-external-file-link-settings');
                Route::put('/', [WorkspaceController::class, 'update'])->name('update');
                Route::delete('/', [WorkspaceController::class, 'delete'])->name('delete');

                // OIDC Connections
                Route::prefix('oidc-connections')->name('oidc-connections.')->group(function () {
                    Route::get('/', [\App\Http\Controllers\Settings\OidcConnectionController::class, 'index'])->name('index');
                    Route::post('/', [\App\Http\Controllers\Settings\OidcConnectionController::class, 'store'])->name('store');
                    Route::get('/{connection}', [\App\Http\Controllers\Settings\OidcConnectionController::class, 'show'])->name('show');
                    Route::patch('/{connection}', [\App\Http\Controllers\Settings\OidcConnectionController::class, 'update'])->name('update');
                    Route::delete('/{connection}', [\App\Http\Controllers\Settings\OidcConnectionController::class, 'destroy'])->name('destroy');
                });

                Route::middleware('feature:form_analytics')->group(function () {
                    Route::get('form-stats/{form}', [FormStatsController::class, 'getFormStats'])->name('form.stats');
                    Route::get('form-stats-details/{form}', [FormStatsController::class, 'getFormStatsDetails'])->name('form.stats-details');
                });

                // Summary endpoints - Pro plan required, with rate limiting
                Route::middleware(['feature:form_summary', 'throttle.form-summary'])->group(function () {
                    Route::get('form-summary/{form}', [FormSummaryController::class, 'getSummary'])->name('form.summary');
                    Route::get('form-summary/{form}/field/{fieldId}/values', [FormSummaryController::class, 'getFieldValues'])->name('form.summary.field-values');
                });
            });
        });

        Route::prefix('forms')->name('forms.')->group(function () {
            Route::post('/', [FormController::class, 'store'])->name('store');
            Route::post('/{form}/validate-definition', [FormController::class, 'validateDefinition'])->name('validate-definition');
            Route::post('/{form}/workspace/{workspace}', [FormController::class, 'updateWorkspace'])->name('workspace.update');
            Route::put('/{form}', [FormController::class, 'update'])->name('update');
            Route::delete('/{form}', [FormController::class, 'destroy'])->name('destroy');
            Route::get('/{form}/mobile-editor-email', [FormController::class, 'mobileEditorEmail'])->name('mobile-editor-email');

            Route::prefix('/{form}/submissions')->name('submissions.')->group(function () {
                Route::get('/', [FormSubmissionController::class, 'submissions'])->name('index');
                Route::get('/{submission_id}', [FormSubmissionController::class, 'fetch'])->name('fetch');
                Route::put('/{submission_id}', [FormSubmissionController::class, 'update'])->name('update');
                Route::post('/export', [FormSubmissionController::class, 'export'])
                    ->withoutMiddleware(['throttle:internal-api'])
                    ->middleware('throttle:export')
                    ->name('export');
                Route::get('/export/status/{jobId}', [FormSubmissionController::class, 'exportStatus'])
                    ->withoutMiddleware(['throttle:internal-api'])
                    ->middleware('throttle:export-status')
                    ->name('export.status');
                Route::get('/file/{filename}', [FormSubmissionController::class, 'submissionFile'])
                    ->middleware(['signed:relative', 'throttle:submission-files'])
                    ->withoutMiddleware(['auth.multi', 'throttle:internal-api'])
                    ->name('file');
                Route::delete('/{submission_id}', [FormSubmissionController::class, 'destroy'])->name('destroy');
                Route::post('/multi', [FormSubmissionController::class, 'destroyMulti'])->name('destroy-multi');
            });

            // Form Admin tool
            Route::put(
                '/{form}/regenerate-link/{option}',
                [FormController::class, 'regenerateLink']
            )
                ->where('option', '(uuid|slug|custom)')
                ->name('regenerate-link');
            Route::post(
                '/{form}/duplicate',
                [FormController::class, 'duplicate']
            )->name('duplicate');

            // Assets & uploaded files
            Route::post(
                '/assets/upload',
                [FormController::class, 'uploadAsset']
            )->middleware('throttle:public-uploads')->withoutMiddleware(['auth.multi'])->name('assets.upload');
            Route::get(
                '/{form}/uploaded-file/{filename}',
                [FormController::class, 'viewFile']
            )->name('uploaded_file');

            // Integrations
            Route::post(
                '/webhooks/zapier',
                [FormZapierWebhookController::class, 'store']
            )->name('integrations.zapier-hooks.store');
            Route::delete(
                '/webhooks/zapier/{id}',
                [FormZapierWebhookController::class, 'delete']
            )->name('integrations.zapier-hooks.delete');
            Route::get(
                '/{form}/integrations',
                [FormIntegrationsController::class, 'index']
            )->name('integrations.index');
            Route::post(
                '/{form}/integrations',
                [FormIntegrationsController::class, 'create']
            )->name('integrations.create');
            Route::put(
                '/{form}/integrations/{integrationid}',
                [FormIntegrationsController::class, 'update']
            )->name('integrations.update');
            Route::delete(
                '/{form}/integrations/{integrationid}',
                [FormIntegrationsController::class, 'destroy']
            )->name('integrations.destroy');
            Route::get(
                '/{form}/integrations/{integrationid}/events',
                [FormIntegrationsEventController::class, 'index']
            )->name('integrations.events');
            Route::post(
                '/{form}/integrations/{integrationid}/events/{event}/retry',
                [FormIntegrationsEventController::class, 'retry']
            )->whereNumber(['integrationid', 'event'])
                ->middleware('throttle:integration-retries')->name('integrations.events.retry');

            // PDF Templates
            Route::prefix('/{form}/pdf-templates')->name('pdf-templates.')->group(function () {
                Route::get('/', [PdfTemplateController::class, 'index'])->name('index');
                Route::post('/', [PdfTemplateController::class, 'store'])->name('store');
                Route::post('/{pdfTemplate}/duplicate', [PdfTemplateController::class, 'duplicate'])->name('duplicate');
                Route::get('/{pdfTemplate}', [PdfTemplateController::class, 'show'])->name('show');
                Route::put('/{pdfTemplate}', [PdfTemplateController::class, 'update'])->name('update');
                Route::delete('/{pdfTemplate}', [PdfTemplateController::class, 'destroy'])->name('destroy');
                Route::get('/{pdfTemplate}/download', [PdfTemplateController::class, 'download'])->name('download');

                // Get signed URL for submission PDF download
                Route::get(
                    '/{pdfTemplate}/submissions/{submission_id}/signed-url',
                    [PdfGenerateController::class, 'getTemplateSignedUrl']
                )->name('submission.signed-url');

                // Get signed URL for preview PDF (admin)
                Route::get(
                    '/{pdfTemplate}/preview/signed-url',
                    [PdfGenerateController::class, 'getPreviewSignedUrl']
                )->name('preview.signed-url');
            });

            // Template-based PDF download (signed, no auth required)
            Route::get(
                '/{form}/pdf-templates/{pdfTemplate}/submissions/{submission_id}/download',
                [PdfGenerateController::class, 'downloadByTemplate']
            )
                ->middleware('signed:relative')
                ->withoutMiddleware(['auth.multi'])
                ->name('pdf-templates.download-submission');

            // Template-based PDF preview (signed, no auth required)
            Route::get(
                '/{form}/pdf-templates/{pdfTemplate}/preview',
                [PdfGenerateController::class, 'previewBySignature']
            )
                ->middleware('signed:relative')
                ->withoutMiddleware(['auth.multi'])
                ->name('pdf-templates.preview-signed');
        });
    });

    Route::group(['middleware' => 'moderator', 'prefix' => 'moderator'], function () {
        Route::post(
            'create-template',
            [\App\Http\Controllers\Admin\AdminController::class, 'createTemplate']
        );
        Route::get(
            'fetch-user/{identifier}',
            [\App\Http\Controllers\Admin\AdminController::class, 'fetchUser']
        );
        Route::get(
            'impersonate/{user}',
            [\App\Http\Controllers\Admin\ImpersonationController::class, 'impersonate']
        );
        Route::patch(
            'apply-discount',
            [\App\Http\Controllers\Admin\AdminController::class, 'applyDiscount']
        );
        Route::patch(
            'extend-trial',
            [\App\Http\Controllers\Admin\AdminController::class, 'extendTrial']
        );
        Route::patch(
            'cancellation-subscription',
            [\App\Http\Controllers\Admin\AdminController::class, 'cancelSubscription']
        );
        Route::patch(
            'refund-payment',
            [\App\Http\Controllers\Admin\AdminController::class, 'refundPayment']
        );

        Route::patch(
            'send-password-reset-email',
            [\App\Http\Controllers\Admin\AdminController::class, 'sendPasswordResetEmail']
        );

        Route::post(
            'block-user',
            [\App\Http\Controllers\Admin\AdminController::class, 'blockUser']
        );
        Route::post(
            'unblock-user',
            [\App\Http\Controllers\Admin\AdminController::class, 'unblockUser']
        );

        Route::post(
            'disable-two-factor-authentication',
            [\App\Http\Controllers\Admin\AdminController::class, 'disableTwoFactorAuthentication']
        );

        Route::post(
            'clear-user-cache',
            [\App\Http\Controllers\Admin\AdminController::class, 'clearUserCache']
        );

        Route::group(['prefix'  => 'billing'], function () {
            Route::get('{user}/customer', [\App\Http\Controllers\Admin\BillingController::class, 'getCustomer']);
            Route::patch('/customer', [\App\Http\Controllers\Admin\BillingController::class, 'updateCustomer']);
            Route::get('{user}/subscriptions', [\App\Http\Controllers\Admin\BillingController::class, 'getSubscriptions']);
            Route::get('{user}/payments', [\App\Http\Controllers\Admin\BillingController::class, 'getPayments']);
        });

        Route::group(['prefix' => 'forms'], function () {
            Route::get('{user}/deleted-forms', [\App\Http\Controllers\Admin\FormController::class, 'getDeletedForms']);
            Route::patch('{slug}/restore', [\App\Http\Controllers\Admin\FormController::class, 'restoreDeletedForm']);
        });
    });
});

Route::group(['middleware' => 'guest:api'], function () {
    Route::post('login', [LoginController::class, 'login'])->name('login');
    Route::post('register', [RegisterController::class, 'register']);

    Route::post('password/email', [ForgotPasswordController::class, 'sendResetLinkEmail'])
        ->middleware('throttle:password-reset');
    Route::post('password/reset', [ResetPasswordController::class, 'reset']);

    Route::post('email/verify/{user}', [VerificationController::class, 'verify'])->name('verification.verify');
    Route::post('email/resend', [VerificationController::class, 'resend']);

    // OIDC email lookup endpoint (for login flow)
    Route::post('auth/oidc/options', [\App\Http\Controllers\Auth\SsoController::class, 'getOptionsForEmail'])->name('sso.options');

    // Two-factor authentication verification (public, but requires pending auth token)
    Route::post('/auth/two-factor/verify', [\App\Http\Controllers\Auth\TwoFactorVerificationController::class, 'verify'])->name('two-factor.verify');
});

Route::group(['prefix' => 'appsumo'], function () {
    Route::get('oauth/callback', [\App\Http\Controllers\Auth\AppSumoAuthController::class, 'handleCallback'])->name('appsumo.callback');
    Route::post('webhook', [\App\Http\Controllers\Webhook\AppSumoController::class, 'handle'])->name('appsumo.webhook');
});

/*
 * OAuth routes (public - authentication handled in controller)
 */
Route::prefix('oauth')->name('oauth.')->group(function () {
    Route::post('/connect/{provider}', [OAuthController::class, 'redirect'])->name('redirect');
    Route::post('/{provider}/callback', [OAuthController::class, 'callback'])->name('callback');
    Route::post('/widget-callback/{provider}', [OAuthController::class, 'handleWidgetCallback'])->name('widget.callback');
});

/*
 * OIDC SSO routes (public - authentication handled in controller)
 */
Route::prefix('auth')->name('sso.')->group(function () {
    // Starting an authorization request allocates server-side state. Keep this
    // separate from the callback so a stale callback cannot lock out a user.
    Route::post('/{slug}/redirect', [\App\Http\Controllers\Auth\SsoController::class, 'redirect'])
        ->middleware('throttle:oidc-init')
        ->name('redirect');

    // The callback remains behind the API limit. With the default connection
    // settings, it validates a single-use state and verifier before exchanging
    // the authorization code, so it must not share the smaller bucket above.
    Route::get('/{slug}/callback', [\App\Http\Controllers\Auth\SsoController::class, 'callback'])->name('callback');
});

/*
 * Public Forms related routes
 */
Route::prefix('forms')->name('forms.')->group(function () {
    Route::middleware('protected-form')->group(function () {
        Route::get('{form}/view', [PublicFormController::class, 'view'])->name('view');
        Route::post('{form}/answer', [PublicFormController::class, 'answer'])->name('answer')->middleware(HandlePrecognitiveRequests::class);
        Route::get('{form}/stripe-connect/get-account', [FormPaymentController::class, 'getAccount'])->name('stripe-connect.get-account')->middleware(HandlePrecognitiveRequests::class);
        Route::post('{form}/stripe-connect/payment-intent', [FormPaymentController::class, 'createIntent'])->name('stripe-connect.create-intent')->middleware(HandlePrecognitiveRequests::class);
    });

    // File uploads
    Route::get('assets/{assetFileName}', [PublicFormController::class, 'showAsset'])->name('assets.show');

    // Get form and submit
    Route::get('{form}', [PublicFormController::class, 'show'])->name('show');
    Route::get('{form}/submissions/{submission_id}', [PublicFormController::class, 'fetchSubmission'])->name('fetchSubmission');

    // AI
    Route::post('ai/generate', [\App\Http\Controllers\Forms\AiFormController::class, 'generateForm'])->name('ai.generate');
    Route::get('ai/formula/{aiFormCompletion}', [\App\Http\Controllers\Forms\AiFormController::class, 'showFormula'])
        ->middleware('auth.multi')
        ->name('ai.formula.show');
    Route::get('ai/{aiFormCompletion}', [\App\Http\Controllers\Forms\AiFormController::class, 'show'])->name('ai.show');
    Route::post('ai/generate-fields', [\App\Http\Controllers\Forms\AiFormController::class, 'generateFields'])->name('ai.generate-fields');
    Route::post('ai/generate-formula', [\App\Http\Controllers\Forms\AiFormController::class, 'generateFormula'])
        ->middleware(['auth.multi', 'throttle:ai-formula-generation'])
        ->name('ai.generate-formula');
});

/**
 * Other public routes
 */
Route::prefix('content')->name('content.')->group(function () {
    Route::get('/feature-flags', [\App\Http\Controllers\Content\FeatureFlagsController::class, 'index'])->name('feature-flags');
    Route::get('/plans', [\App\Http\Controllers\Content\PlansController::class, 'index'])->name('plans');
    Route::get('changelog/entries', [\App\Http\Controllers\Content\ChangelogController::class, 'index'])->name('changelog.entries');
});

Route::get('/sitemap-urls', [\App\Http\Controllers\Content\SitemapController::class, 'index'])->name('sitemap.index');

// Fonts
Route::get('/fonts', [\App\Http\Controllers\Content\FontsController::class, 'index'])->name('fonts.index');

// Templates
Route::prefix('templates')->group(function () {
    Route::get('/', [TemplateController::class, 'index'])->name('templates.index');
    Route::post('/', [TemplateController::class, 'create'])->name('templates.create');
    Route::get('/{slug}', [TemplateController::class, 'show'])->name('templates.show');
    Route::put('/{id}', [TemplateController::class, 'update'])->name('templates.update');
    Route::delete('/{id}', [TemplateController::class, 'destroy'])->name('templates.destroy');
});

Route::post(
    '/stripe/webhook',
    [\App\Http\Controllers\Webhook\StripeController::class, 'handleWebhook']
)->name('cashier.webhook');

/*
 * Cloud API: Self-hosted license endpoints
 * Only available on cloud instances (not self-hosted)
 */
Route::prefix('licenses')->middleware(['cloud', 'throttle:30,1'])->group(function () {
    Route::post('/create', [\App\Http\Controllers\CloudApi\LicenseController::class, 'create'])->name('licenses.create');
    Route::post('/validate', [\App\Http\Controllers\CloudApi\LicenseController::class, 'validateKey'])->name('licenses.validate');
    Route::post('/portal', [\App\Http\Controllers\CloudApi\LicenseController::class, 'portal'])->name('licenses.portal');
});

Route::post(
    '/vapor/signed-storage-url',
    [\App\Http\Controllers\Content\SignedStorageUrlController::class, 'store']
)->name('vapor.signed-storage-url');
Route::post(
    '/upload-file',
    [\App\Http\Controllers\Content\FileUploadController::class, 'upload']
)->middleware('throttle:public-uploads')->name('upload-file');

Route::get('local/temp/{path}', function (Request $request, string $path) {
    if (!$request->hasValidRelativeSignature()) {
        abort(401);
    }

    return app(SafeFileResponseService::class)->serve($path, basename($path));
})->where('path', '(.*)')->name('local.temp');

Route::get('caddy/ask-certificate/{secret?}', [\App\Http\Controllers\CaddyController::class, 'ask'])
    ->name('caddy.ask')->middleware(\App\Http\Middleware\CaddyRequestMiddleware::class);

Route::post('/aws/sns/ses/integration-events', \App\Http\Controllers\Integrations\SesIntegrationFeedbackController::class)
    ->withoutMiddleware(['throttle:internal-api', 'throttle:150,1', 'throttle:api']);