tempest-express-sdk 0.26.0 → 0.27.0

package/dist/index.d.cts

@@ -3896,6 +3896,24 @@ interface AdminModelOptions<C extends ModelClass> {
      * its filters and ordering through `?lens=<slug>`.
      */
     lenses?: readonly AdminLens[];
+    /**
+     * String columns rendered as file inputs. The uploaded file is written
+     * through `uploadStorage` and the returned storage key goes in the column.
+     */
+    uploadFields?: readonly string[];
+    /** Backend persisting uploaded files. Required when `uploadFields` is set. */
+    uploadStorage?: UploadStorage;
+    /**
+     * Expose the CSV import page (`GET/POST {prefix}/m/{slug}/import`), which
+     * bulk-creates rows from an uploaded file. Default `false`; also requires
+     * `canCreate`.
+     */
+    canImport?: boolean;
+    /**
+     * Foreign-key columns rendered as a typed search box instead of a `<select>`
+     * of every related row — for target tables too large to pre-load.
+     */
+    autocompleteFields?: readonly string[];
 }
 /**
  * The admin configuration for one model.
@@ -3937,6 +3955,14 @@ declare class AdminModel<C extends ModelClass = ModelClass> {
     readonly auditModel: ModelClass | null;
     /** Saved list-view presets, in declaration order. */
     readonly lenses: AdminLens[];
+    /** Columns rendered as file inputs. */
+    readonly uploadFields: string[];
+    /** Backend persisting uploaded files, or `null`. */
+    readonly uploadStorage: UploadStorage | null;
+    /** Whether the CSV import page is exposed. */
+    readonly canImport: boolean;
+    /** Foreign-key columns rendered as a typed search box. */
+    readonly autocompleteFields: string[];
     private readonly actions;
     private readonly slugOverride;
     private readonly listDisplayOverride;
@@ -4086,6 +4112,81 @@ type AdminPermission = (typeof AdminPermission)[keyof typeof AdminPermission];
  */
 type AdminAccessPolicy = (principal: unknown, admin: AdminModel, action: AdminPermission) => boolean | Promise<boolean>;
 
+/**
+ * Multipart form parsing for the admin's upload and import screens.
+ *
+ * The panel's ordinary forms are `application/x-www-form-urlencoded`, which
+ * Express parses on its own. A form carrying a file is `multipart/form-data`,
+ * which it does not — so this module wraps `busboy`, the streaming parser
+ * behind most of the Node ecosystem's upload middleware.
+ *
+ * `busboy` is an **optional peer**: only a project that configures
+ * `uploadFields` or `canImport` needs it, and the error below says exactly what
+ * to install. Multipart is a wire format with a long tail of correctness
+ * (boundary handling, transfer encodings, filename escaping) — the kind of
+ * parser this SDK depends on rather than reimplements.
+ */
+
+/** One uploaded file, buffered in memory. */
+interface UploadedFile {
+    /** The form field the file arrived on. */
+    field: string;
+    /** The client-supplied filename, already stripped of any path. */
+    filename: string;
+    /** The declared MIME type. */
+    contentType: string;
+    /** The file bytes. */
+    data: Buffer;
+}
+/** The result of parsing a multipart body. */
+interface ParsedMultipart {
+    /** Text fields, keyed by name. A repeated field keeps its last value. */
+    fields: Record<string, string>;
+    /** Uploaded files that carried a filename and at least one byte. */
+    files: UploadedFile[];
+}
+/** Options for {@link parseMultipart}. */
+interface ParseMultipartOptions {
+    /** Reject a file larger than this many bytes. Default `10 * 1024 * 1024`. */
+    maxFileBytes?: number;
+    /** Reject more than this many files in one submission. Default `10`. */
+    maxFiles?: number;
+}
+/**
+ * Raised when a submission exceeds a configured multipart limit.
+ *
+ * Distinct from a parse failure so the caller can turn it into a `400` with a
+ * message the operator can act on ("the file is too large") instead of a
+ * generic failure.
+ */
+declare class MultipartLimitError extends Error {
+    /**
+     * @param message - The operator-facing explanation.
+     */
+    constructor(message: string);
+}
+/**
+ * Parse a `multipart/form-data` request body.
+ *
+ * Files are buffered in memory, which is what the admin needs — an operator
+ * attaching a document or a CSV, not a streaming ingest path — and bounded by
+ * `maxFileBytes` so a large upload cannot exhaust the process.
+ *
+ * @param req - The inbound request.
+ * @param options - Size and count limits.
+ * @returns The text fields and the uploaded files.
+ * @throws MultipartLimitError When a limit is exceeded.
+ * @throws Error When `busboy` is missing or the body is not valid multipart.
+ */
+declare function parseMultipart(req: Request, options?: ParseMultipartOptions): Promise<ParsedMultipart>;
+/**
+ * Whether a request carries a multipart body.
+ *
+ * @param req - The inbound request.
+ * @returns `true` when the content type is `multipart/form-data`.
+ */
+declare function isMultipart(req: Request): boolean;
+
 /**
  * Column introspection for the admin panel, mirroring `admin.forms`' widget
  * derivation.
@@ -4099,7 +4200,7 @@ type AdminAccessPolicy = (principal: unknown, admin: AdminModel, action: AdminPe
  */
 
 /** The set of form controls the admin knows how to render. */
-type AdminWidget = "text" | "textarea" | "number" | "checkbox" | "datetime" | "date" | "time" | "select" | "json";
+type AdminWidget = "text" | "textarea" | "number" | "checkbox" | "datetime" | "date" | "time" | "select" | "json" | "file" | "autocomplete";
 /** A `(value, label)` pair for a `select` widget. */
 interface AdminSelectOption {
     value: string;
@@ -4207,6 +4308,10 @@ interface AdminFormField {
     options: AdminSelectOption[];
     /** Per-field validation error, or `null`. */
     error: string | null;
+    /** For an `autocomplete` widget, the JSON search endpoint backing the input. */
+    autocompleteUrl: string | null;
+    /** For an `autocomplete` widget, the label of the currently selected row. */
+    displayLabel: string;
 }
 /** The outcome of parsing a submitted create/edit form. */
 interface ParsedAdminForm {
@@ -4215,6 +4320,17 @@ interface ParsedAdminForm {
     /** Per-field error messages, keyed by column. Empty when the form is valid. */
     errors: Record<string, string>;
 }
+/** Options for {@link parseFormBody}. */
+interface ParseFormBodyOptions {
+    /**
+     * Read upload columns as plain text instead of skipping them.
+     *
+     * The create/edit form skips them because the router writes the storage key
+     * after saving the file. A CSV import has no file to save — it carries the
+     * key already — so it reads them like any other string column.
+     */
+    uploadsAsText?: boolean;
+}
 /** Options for {@link buildFormFields}. */
 interface BuildFormFieldsOptions {
     /** Current values, keyed by column — a row on edit, a re-submission on error. */
@@ -4227,6 +4343,13 @@ interface BuildFormFieldsOptions {
      * of a raw identity text input.
      */
     foreignKeyOptions?: Record<string, AdminSelectOption[]>;
+    /**
+     * Search endpoints for foreign-key columns listed in `autocompleteFields`,
+     * keyed by column. A field listed here renders as a typed search box.
+     */
+    autocompleteUrls?: Record<string, string>;
+    /** Current labels for autocomplete fields, keyed by column. */
+    autocompleteLabels?: Record<string, string>;
 }
 /**
  * Render a stored value into the string a control pre-fills with.
@@ -4262,7 +4385,7 @@ declare function buildFormFields(admin: AdminModel, options?: BuildFormFieldsOpt
  * @param body - The parsed request body.
  * @returns The coerced values plus any per-field errors.
  */
-declare function parseFormBody(admin: AdminModel, body: Record<string, unknown>): ParsedAdminForm;
+declare function parseFormBody(admin: AdminModel, body: Record<string, unknown>, options?: ParseFormBodyOptions): ParsedAdminForm;
 /**
  * Render a stored value for a read-only list or detail cell.
  *
@@ -4895,6 +5018,8 @@ interface AdminListView {
     sort: Record<string, AdminSortView>;
     /** URL of the create form, or `null` when creation is disabled. */
     newUrl: string | null;
+    /** URL of the CSV import page, or `null` when import is disabled. */
+    importUrl: string | null;
     /** Bulk actions offered above the table. Empty hides the whole bulk UI. */
     bulkActions: BulkActionOption[];
     /** URL the bulk form posts to. */
@@ -4999,6 +5124,38 @@ interface AdminFormView {
  * @throws Error When called without a session, since the form needs a CSRF token.
  */
 declare function renderFormPage(context: AdminRenderContext, view: AdminFormView): string;
+/** The outcome of a CSV import, as the page renders it. */
+interface AdminImportView {
+    /** Plural display name of the model being imported into. */
+    title: string;
+    /** URL the upload form posts to. */
+    actionUrl: string;
+    /** URL of the list view. */
+    backUrl: string;
+    /** The column headers the CSV is expected to carry. */
+    columns: string[];
+    /** A form-level error, or `null`. */
+    error: string | null;
+    /** How many rows were created, or `null` before the first submission. */
+    created: number | null;
+    /** Per-row failures, numbered as the spreadsheet numbers them. */
+    rowErrors: {
+        row: number;
+        message: string;
+    }[];
+}
+/**
+ * Render the CSV import page.
+ *
+ * Row numbers start at 2 because row 1 is the header, so the numbers line up
+ * with what the operator sees in their spreadsheet.
+ *
+ * @param context - The shared chrome data (with an active session).
+ * @param view - The prepared import view model.
+ * @returns The full page.
+ * @throws Error When called without a session, since the form needs a CSRF token.
+ */
+declare function renderImportPage(context: AdminRenderContext, view: AdminImportView): string;
 
 /**
  * The server-rendered admin panel router, mirroring `admin.router`.
@@ -5059,6 +5216,8 @@ interface AdminRouterOptions {
      * lets every signed-in operator do whatever those flags allow.
      */
     accessPolicy?: AdminAccessPolicy;
+    /** Largest upload the panel accepts, in bytes. Default `10485760` (10 MB). */
+    maxUploadBytes?: number;
 }
 /**
  * Build the admin panel router.
@@ -5069,6 +5228,20 @@ interface AdminRouterOptions {
  * @throws Error When the signing key is shorter than 32 characters.
  */
 declare function makeAdminRouter(site: AdminSite, options: AdminRouterOptions): Router;
+/**
+ * Parse a CSV document into one record per row, keyed by the header.
+ *
+ * Implements RFC 4180 quoting rather than splitting on commas: a quoted field
+ * may contain commas, newlines and doubled quotes, and an import that mangles
+ * those silently corrupts exactly the rows a human took the trouble to quote.
+ * The leading UTF-8 BOM Excel writes is stripped, because otherwise the first
+ * header name never matches a column.
+ *
+ * @param text - The CSV document.
+ * @returns One record per data row; `[]` when the file has only a header.
+ * @throws Error When the document has no header row.
+ */
+declare function parseCsv(text: string): Record<string, string>[];
 
 /**
  * Headless admin: resource registry for the JSON admin API.
@@ -6840,6 +7013,6 @@ declare function createTestDatabase(models: readonly ModelClass[]): TestDatabase
 declare function withTestDatabase<T>(models: readonly ModelClass[], fn: (db: TestDatabase) => Promise<T>): Promise<T>;
 
 /** The installed SDK version. Single source of truth for the barrel + CLI. */
-declare const VERSION = "0.26.0";
+declare const VERSION = "0.27.0";
 
-export { ADMIN_CSS, type ActivationInput, ActivationService, type ActivationServiceOptions, type ActivationStore, type AdminAccessPolicy, type AdminAction, type AdminActionCategory, type AdminActionContext, type AdminActionHandler, type AdminActionOptions, type AdminActionResult, type AdminAuditEntryView, type AdminAuditView, type AdminAuthBackend, type AdminAutomapOptions, type AdminBusinessCardView, type AdminDashboardCard, type AdminDashboardMetrics, type AdminDetailView, type AdminFilterKind, type AdminFilterView, type AdminFormField, type AdminFormView, type AdminJsonField, type AdminJsonListQuery, type AdminJsonListResult, type AdminJsonResource, type AdminJsonRouterOptions, AdminJsonSite, type AdminLens, type AdminLensOptions, type AdminListView, type AdminMessage, type AdminMfaVerifier, AdminModel, type AdminModelOptions, type AdminNavEntry, AdminPermission, type AdminRenderContext, type AdminRouterOptions, type AdminRow, type AdminSelectOption, type AdminSession, AdminSessionStore, type AdminSessionStoreOptions, AdminSite, type AdminSiteOptions, type AdminSortView, type AdminTheme, type AdminWidget, AppException, type AppExceptionHandlerOptions, type AppExceptionOptions, type AttachWebSocketOptions, AttemptThrottle, type AttemptThrottleOptions, AuditAction, type AuthResponse, type AuthResultPageOptions, type AuthRouterOptions, type AuthUser, type BackupOptions, type BaseAppSettings, BaseAuditLogModel, BaseController, BaseModel, BaseOAuthClient, BaseOutboxModel, type BaseResponse, BaseService, BaseUserModel, BaseUserRefreshTokenModel, BaseUserTokenModel, type BodySizeLimitOptions, type BroadcastOptions, type BroadcastResult, type BrokerManager, type BuildFormFieldsOptions, type BulkActionOption, CEP_PATTERN, CNPJ_PATTERN, CPF_PATTERN, type CPUMetrics, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type CacheManager, type CachedOptions, type CachedResponse, type CardCompute, type CardData, type CatalogData, CircuitOpenError, type ClientIpOptions, CompositeFeatureFlagBackend, ConflictException, type CreateAppOpenApi, type CreateAppOptions, type CsrfOptions, type CursorPaginationFilter, DEFAULT_DOCS_FAVICON, DEFAULT_LOCALE, type DownloadOptions, type EmailMessage, type EmailOptions, EmailProvider, type EmailProviderOptions, EmailUtils, type Enum, type EnumHelpers, type EnumSpec, EnvFeatureFlagBackend, EventStream, type EventStreamOptions, type ExceptionDetails, ExpiredTokenException, type FeatureFlagBackend, FeatureFlags, type FieldChange, type FileLoggingHandle, type FileLoggingOptions, type FlagContext, ForbiddenException, type GPUMetrics, type GenerateOpenApiOptions, GitHubOAuthClient, GoogleOAuthClient, GracefulShutdown, type GracefulShutdownOptions, HTTPClient, type HTTPClientOptions, HTTP_500_LOG_FILE, HTTP_500_MARKER, type HandshakeInfo, type HealthCheck, type HealthRouterOptions, HttpMetrics, IDEMPOTENCY_HEADER, type IdempotencyOptions, type IdempotencyRedisLike, type IdempotencyStore, type InboundHandler, type InboundMessage, InvalidTokenException, type IssuedSession, JSONLogger, JWTUtils, type JWTUtilsOptions, type JwtAuthOptions, type JwtClaims, type JwtDecoderLike, LEVEL_LOG_FILES, LocalUploadStorage, type LocalUploadStorageOptions, type LogEntry, type LogExtra, type LogLevel, type LogSink, type LogSource, type LoginInput, type LoginResult, type LogsRouterOptions, type MediaKind, MemoryBroker, MemoryCacheManager, MemoryFeatureFlagBackend, MemoryIdempotencyStore, type MemoryMetrics, MemoryRateLimitStore, MemorySessionStore, MemoryThrottleBackend, MessageCatalog, type MessageHandler, MessagingHub, type MessagingProvider, type MetricCard, type MetricPartition, type MetricTrend, type MetricValue, type MetricsRouterOptions, MetricsUtils, type MfaChallenge, type MfaChallengeInput, type MfaCodeInput, type MfaEnrollment, MfaService, type MfaServiceOptions, type MfaStore, NotFoundException, type OAuthClientOptions, OAuthError, type OAuthTokens, type OAuthUser, OIDCProvider, type OIDCProviderOptions, type OpenApiDocument, type OpenApiInfo, type OutboundMedia, type OutboundResult, type OutboxPublisher, OutboxRelay, type OutboxRelayOptions, OutboxStatus, PHONE_BR_PATTERN, type PaginationFilter, type PaginationLinkOptions, type ParsedAdminForm, type PasswordResetConfirmInput, type PasswordResetFormOptions, type PasswordResetRequestInput, PasswordResetService, type PasswordResetServiceOptions, type PasswordResetStore, PasswordUtils, REDOC_CDN_URL, REQUEST_ID_HEADER, RabbitBroker, type RabbitBrokerOptions, type RateLimitKeyFunc, type RateLimitOptions, type RateLimitRedisLike, type RateLimitResult, type RateLimitStore, RedisCacheManager, RedisIdempotencyStore, type RedisLike, type RedisPublisherLike, RedisRateLimitStore, RedisSSEBroker, type RedisSSEBrokerOptions, RedisSessionStore, type RedisSubscriberLike, type RedocBundleSource, type RedocOptions, type RefreshInput, Region, type RegionValue, type RegisterExceptionHandlersOptions, type RequestContext, type RequestTracingOptions, type ResolvedAdminTheme, type ResponseMapper, RetryPolicy, type RunServerOptions, type S3ClientLike, S3UploadStorage, type S3UploadStorageOptions, SSEBroker, type SaveOptions, type SendOptions, ServerSentEvent, type ServerSentEventInit, type Session, type SessionMiddlewareOptions, type SessionRedisLike, SessionService, type SessionServiceOptions, type SessionStore, type SignupInput, type SlowQueryOptions, type SpecProvider, type StateBR, type SwaggerOptions, type SyncFilter, type SystemMetrics, TOTPHelper, type TOTPOptions, type TaskHandler, TaskManager, type TaskManagerOptions, TelegramProvider, type TelegramProviderOptions, TenantScopedRepository, type TestDatabase, type ThrottleBackend, type ThrottleStatus, type ToDictOptions, type TokenPair, TooManyRequestsException, type TooManyRequestsOptions, type ToolSpecOptions, TwilioSmsProvider, type TwilioSmsProviderOptions, type TwilioWebhookOptions, UF, type UFValue, UnauthorizedException, type UnhandledExceptionHandlerOptions, type UploadResult, type UploadStorage, UserAuthService, type UserAuthServiceOptions, UserModelAuthBackend, type UserModelAuthBackendOptions, type UserPublic, type UserStore, UserTokenPurpose, VERSION, ValidationException, type WSEnvelope, WebPushDispatcher, type WebPushDispatcherOptions, WebPushError, WebPushGoneError, type WebPushKeys, type WebPushPayload, type WebPushSubscription, type WebSocketConnection, WebSocketHub, type WebSocketHubOptions, type WebSocketLike, type WebhookSignatureOptions, WebhookSignatureVerifier, WhatsAppProvider, type WhatsAppProviderOptions, type WhatsAppWebhookOptions, type WidgetSpec, activationSchema, addLogSink, adminAction, adminColumns, adminLens, adminThemeCss, attachWebSocketHub, authResponseSchema, authSettingsShape, backupDatabase, baseAppSettingsSchema, baseAppSettingsShape, baseResponseSchema, bearerToken, bodySizeLimitMiddleware, broadcastText, buildContentDisposition, buildFormFields, buildPaginationLinkHeader, cached, centsField, cepField, citiesByUf, cnpjField, coerceFlag, configureFileLogging, configureLogging, corsSettingsShape, cpfField, cpfOrCnpjField, createApp, createOpenApiRegistry, createTestDatabase, createdByColumn, csrfMiddleware, csrfTokenMatches, cursorPaginationFilterSchema, cursorPaginationSchema, databaseSettingsShape, decodeCursor, defaultMessageCatalog, defineEnum, deletedAtColumn, diffSnapshots, emailSettingsShape, encodeCursor, looseBoolean as envBoolean, envList, escapeHtml, filterForColumn, foreignKeyFields, foreignKeyLabel, foreignKeyTable, formatCellValue, formatFieldValue, generateCsrfToken, generateOAuthState, generateOpaqueToken, generateOpenApiDocument, getAuth, getClientIp, getConditions, getPaginationConditions, getRequestId, getState, hashOpaqueToken, hexColorField, humanizeField, idempotencyMiddleware, inboundMessageSchema, isColumnOptional, isSearchableColumn, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, jwtSettingsShape, keyByHeader, keyByIp, keyByJwtClaim, keyByJwtSubject, latitudeField, listStates, loadSettings, logEntrySchema, logSettingsShape, loginSchema, longitudeField, looseBoolean, makeAdminJsonRouter, makeAdminRouter, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeLogsRouter, makeMetricsRouter, makeSessionMiddleware, makeToolSpecRouter, makeTwilioWebhookRouter, makeUnhandledExceptionHandler, makeWhatsAppWebhookRouter, metricCard, mfaChallengeSchema, mfaCodeSchema, mfaEnrollResponseSchema, minioSettingsShape, modifyDict, mountOpenApiJson, mountRedoc, mountSwaggerUi, nonEmptyStrField, nonNegativeFloatField, nonNegativeIntField, normalizeCep, normalizeCnpj, normalizeCpf, normalizeCpfCnpj, normalizePhoneBr, normalizeUf, notFoundHandler, onlyDigits, paginationFilterSchema, paginationSchema, parseAcceptLanguage, parseCookies, parseFormBody, partitionTotal, passwordResetConfirmSchema, passwordResetRequestSchema, percentField, phoneBrField, portField, positiveFloatField, positiveIntField, priceField, prometheusMiddleware, rabbitmqSettingsShape, rateLimitMiddleware, ratingField, ratioField, redisSettingsShape, refreshSchema, registerExceptionHandlers, renderAuthResultPage, renderDashboardPage, renderDetailPage, renderFormPage, renderLayout, renderListPage, renderLoginPage, renderMfaPage, renderPasswordResetFormPage, requestIdMiddleware, requestTracingMiddleware, requireRoles, resolveAdminTheme, resolveDownloadPath, resolveRedocBundle, runServer, runWithRequestContext, sendBytesDownload, sendFileDownload, serverSettingsShape, sessionCookie, sessionSettingsShape, setRequestId, signupSchema, slugField, snapshot, sseResponse, statesByRegion, syncFilterSchema, syncPaginationSchema, tableNameFor, toDict, toUtc, tokenFromUrl, tokenPairSchema, tokenSettingsShape, trendDirection, trendPercent, ufField, updatedByColumn, uploadSettingsShape, userPublicSchema, utcnow, validateTwilioSignature, verifyOpaqueToken, webPushKeysSchema, webPushPayloadSchema, webPushSettingsShape, webPushSubscriptionSchema, webSocketSettingsShape, widgetForColumn, withTestDatabase, wrapWithSlowQueryLog, wsEnvelopeSchema };
+export { ADMIN_CSS, type ActivationInput, ActivationService, type ActivationServiceOptions, type ActivationStore, type AdminAccessPolicy, type AdminAction, type AdminActionCategory, type AdminActionContext, type AdminActionHandler, type AdminActionOptions, type AdminActionResult, type AdminAuditEntryView, type AdminAuditView, type AdminAuthBackend, type AdminAutomapOptions, type AdminBusinessCardView, type AdminDashboardCard, type AdminDashboardMetrics, type AdminDetailView, type AdminFilterKind, type AdminFilterView, type AdminFormField, type AdminFormView, type AdminImportView, type AdminJsonField, type AdminJsonListQuery, type AdminJsonListResult, type AdminJsonResource, type AdminJsonRouterOptions, AdminJsonSite, type AdminLens, type AdminLensOptions, type AdminListView, type AdminMessage, type AdminMfaVerifier, AdminModel, type AdminModelOptions, type AdminNavEntry, AdminPermission, type AdminRenderContext, type AdminRouterOptions, type AdminRow, type AdminSelectOption, type AdminSession, AdminSessionStore, type AdminSessionStoreOptions, AdminSite, type AdminSiteOptions, type AdminSortView, type AdminTheme, type AdminWidget, AppException, type AppExceptionHandlerOptions, type AppExceptionOptions, type AttachWebSocketOptions, AttemptThrottle, type AttemptThrottleOptions, AuditAction, type AuthResponse, type AuthResultPageOptions, type AuthRouterOptions, type AuthUser, type BackupOptions, type BaseAppSettings, BaseAuditLogModel, BaseController, BaseModel, BaseOAuthClient, BaseOutboxModel, type BaseResponse, BaseService, BaseUserModel, BaseUserRefreshTokenModel, BaseUserTokenModel, type BodySizeLimitOptions, type BroadcastOptions, type BroadcastResult, type BrokerManager, type BuildFormFieldsOptions, type BulkActionOption, CEP_PATTERN, CNPJ_PATTERN, CPF_PATTERN, type CPUMetrics, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type CacheManager, type CachedOptions, type CachedResponse, type CardCompute, type CardData, type CatalogData, CircuitOpenError, type ClientIpOptions, CompositeFeatureFlagBackend, ConflictException, type CreateAppOpenApi, type CreateAppOptions, type CsrfOptions, type CursorPaginationFilter, DEFAULT_DOCS_FAVICON, DEFAULT_LOCALE, type DownloadOptions, type EmailMessage, type EmailOptions, EmailProvider, type EmailProviderOptions, EmailUtils, type Enum, type EnumHelpers, type EnumSpec, EnvFeatureFlagBackend, EventStream, type EventStreamOptions, type ExceptionDetails, ExpiredTokenException, type FeatureFlagBackend, FeatureFlags, type FieldChange, type FileLoggingHandle, type FileLoggingOptions, type FlagContext, ForbiddenException, type GPUMetrics, type GenerateOpenApiOptions, GitHubOAuthClient, GoogleOAuthClient, GracefulShutdown, type GracefulShutdownOptions, HTTPClient, type HTTPClientOptions, HTTP_500_LOG_FILE, HTTP_500_MARKER, type HandshakeInfo, type HealthCheck, type HealthRouterOptions, HttpMetrics, IDEMPOTENCY_HEADER, type IdempotencyOptions, type IdempotencyRedisLike, type IdempotencyStore, type InboundHandler, type InboundMessage, InvalidTokenException, type IssuedSession, JSONLogger, JWTUtils, type JWTUtilsOptions, type JwtAuthOptions, type JwtClaims, type JwtDecoderLike, LEVEL_LOG_FILES, LocalUploadStorage, type LocalUploadStorageOptions, type LogEntry, type LogExtra, type LogLevel, type LogSink, type LogSource, type LoginInput, type LoginResult, type LogsRouterOptions, type MediaKind, MemoryBroker, MemoryCacheManager, MemoryFeatureFlagBackend, MemoryIdempotencyStore, type MemoryMetrics, MemoryRateLimitStore, MemorySessionStore, MemoryThrottleBackend, MessageCatalog, type MessageHandler, MessagingHub, type MessagingProvider, type MetricCard, type MetricPartition, type MetricTrend, type MetricValue, type MetricsRouterOptions, MetricsUtils, type MfaChallenge, type MfaChallengeInput, type MfaCodeInput, type MfaEnrollment, MfaService, type MfaServiceOptions, type MfaStore, MultipartLimitError, NotFoundException, type OAuthClientOptions, OAuthError, type OAuthTokens, type OAuthUser, OIDCProvider, type OIDCProviderOptions, type OpenApiDocument, type OpenApiInfo, type OutboundMedia, type OutboundResult, type OutboxPublisher, OutboxRelay, type OutboxRelayOptions, OutboxStatus, PHONE_BR_PATTERN, type PaginationFilter, type PaginationLinkOptions, type ParseFormBodyOptions, type ParseMultipartOptions, type ParsedAdminForm, type ParsedMultipart, type PasswordResetConfirmInput, type PasswordResetFormOptions, type PasswordResetRequestInput, PasswordResetService, type PasswordResetServiceOptions, type PasswordResetStore, PasswordUtils, REDOC_CDN_URL, REQUEST_ID_HEADER, RabbitBroker, type RabbitBrokerOptions, type RateLimitKeyFunc, type RateLimitOptions, type RateLimitRedisLike, type RateLimitResult, type RateLimitStore, RedisCacheManager, RedisIdempotencyStore, type RedisLike, type RedisPublisherLike, RedisRateLimitStore, RedisSSEBroker, type RedisSSEBrokerOptions, RedisSessionStore, type RedisSubscriberLike, type RedocBundleSource, type RedocOptions, type RefreshInput, Region, type RegionValue, type RegisterExceptionHandlersOptions, type RequestContext, type RequestTracingOptions, type ResolvedAdminTheme, type ResponseMapper, RetryPolicy, type RunServerOptions, type S3ClientLike, S3UploadStorage, type S3UploadStorageOptions, SSEBroker, type SaveOptions, type SendOptions, ServerSentEvent, type ServerSentEventInit, type Session, type SessionMiddlewareOptions, type SessionRedisLike, SessionService, type SessionServiceOptions, type SessionStore, type SignupInput, type SlowQueryOptions, type SpecProvider, type StateBR, type SwaggerOptions, type SyncFilter, type SystemMetrics, TOTPHelper, type TOTPOptions, type TaskHandler, TaskManager, type TaskManagerOptions, TelegramProvider, type TelegramProviderOptions, TenantScopedRepository, type TestDatabase, type ThrottleBackend, type ThrottleStatus, type ToDictOptions, type TokenPair, TooManyRequestsException, type TooManyRequestsOptions, type ToolSpecOptions, TwilioSmsProvider, type TwilioSmsProviderOptions, type TwilioWebhookOptions, UF, type UFValue, UnauthorizedException, type UnhandledExceptionHandlerOptions, type UploadResult, type UploadStorage, type UploadedFile, UserAuthService, type UserAuthServiceOptions, UserModelAuthBackend, type UserModelAuthBackendOptions, type UserPublic, type UserStore, UserTokenPurpose, VERSION, ValidationException, type WSEnvelope, WebPushDispatcher, type WebPushDispatcherOptions, WebPushError, WebPushGoneError, type WebPushKeys, type WebPushPayload, type WebPushSubscription, type WebSocketConnection, WebSocketHub, type WebSocketHubOptions, type WebSocketLike, type WebhookSignatureOptions, WebhookSignatureVerifier, WhatsAppProvider, type WhatsAppProviderOptions, type WhatsAppWebhookOptions, type WidgetSpec, activationSchema, addLogSink, adminAction, adminColumns, adminLens, adminThemeCss, attachWebSocketHub, authResponseSchema, authSettingsShape, backupDatabase, baseAppSettingsSchema, baseAppSettingsShape, baseResponseSchema, bearerToken, bodySizeLimitMiddleware, broadcastText, buildContentDisposition, buildFormFields, buildPaginationLinkHeader, cached, centsField, cepField, citiesByUf, cnpjField, coerceFlag, configureFileLogging, configureLogging, corsSettingsShape, cpfField, cpfOrCnpjField, createApp, createOpenApiRegistry, createTestDatabase, createdByColumn, csrfMiddleware, csrfTokenMatches, cursorPaginationFilterSchema, cursorPaginationSchema, databaseSettingsShape, decodeCursor, defaultMessageCatalog, defineEnum, deletedAtColumn, diffSnapshots, emailSettingsShape, encodeCursor, looseBoolean as envBoolean, envList, escapeHtml, filterForColumn, foreignKeyFields, foreignKeyLabel, foreignKeyTable, formatCellValue, formatFieldValue, generateCsrfToken, generateOAuthState, generateOpaqueToken, generateOpenApiDocument, getAuth, getClientIp, getConditions, getPaginationConditions, getRequestId, getState, hashOpaqueToken, hexColorField, humanizeField, idempotencyMiddleware, inboundMessageSchema, isColumnOptional, isMultipart, isSearchableColumn, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, jwtSettingsShape, keyByHeader, keyByIp, keyByJwtClaim, keyByJwtSubject, latitudeField, listStates, loadSettings, logEntrySchema, logSettingsShape, loginSchema, longitudeField, looseBoolean, makeAdminJsonRouter, makeAdminRouter, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeLogsRouter, makeMetricsRouter, makeSessionMiddleware, makeToolSpecRouter, makeTwilioWebhookRouter, makeUnhandledExceptionHandler, makeWhatsAppWebhookRouter, metricCard, mfaChallengeSchema, mfaCodeSchema, mfaEnrollResponseSchema, minioSettingsShape, modifyDict, mountOpenApiJson, mountRedoc, mountSwaggerUi, nonEmptyStrField, nonNegativeFloatField, nonNegativeIntField, normalizeCep, normalizeCnpj, normalizeCpf, normalizeCpfCnpj, normalizePhoneBr, normalizeUf, notFoundHandler, onlyDigits, paginationFilterSchema, paginationSchema, parseAcceptLanguage, parseCookies, parseCsv, parseFormBody, parseMultipart, partitionTotal, passwordResetConfirmSchema, passwordResetRequestSchema, percentField, phoneBrField, portField, positiveFloatField, positiveIntField, priceField, prometheusMiddleware, rabbitmqSettingsShape, rateLimitMiddleware, ratingField, ratioField, redisSettingsShape, refreshSchema, registerExceptionHandlers, renderAuthResultPage, renderDashboardPage, renderDetailPage, renderFormPage, renderImportPage, renderLayout, renderListPage, renderLoginPage, renderMfaPage, renderPasswordResetFormPage, requestIdMiddleware, requestTracingMiddleware, requireRoles, resolveAdminTheme, resolveDownloadPath, resolveRedocBundle, runServer, runWithRequestContext, sendBytesDownload, sendFileDownload, serverSettingsShape, sessionCookie, sessionSettingsShape, setRequestId, signupSchema, slugField, snapshot, sseResponse, statesByRegion, syncFilterSchema, syncPaginationSchema, tableNameFor, toDict, toUtc, tokenFromUrl, tokenPairSchema, tokenSettingsShape, trendDirection, trendPercent, ufField, updatedByColumn, uploadSettingsShape, userPublicSchema, utcnow, validateTwilioSignature, verifyOpaqueToken, webPushKeysSchema, webPushPayloadSchema, webPushSettingsShape, webPushSubscriptionSchema, webSocketSettingsShape, widgetForColumn, withTestDatabase, wrapWithSlowQueryLog, wsEnvelopeSchema };

package/dist/index.d.ts

@@ -3896,6 +3896,24 @@ interface AdminModelOptions<C extends ModelClass> {
      * its filters and ordering through `?lens=<slug>`.
      */
     lenses?: readonly AdminLens[];
+    /**
+     * String columns rendered as file inputs. The uploaded file is written
+     * through `uploadStorage` and the returned storage key goes in the column.
+     */
+    uploadFields?: readonly string[];
+    /** Backend persisting uploaded files. Required when `uploadFields` is set. */
+    uploadStorage?: UploadStorage;
+    /**
+     * Expose the CSV import page (`GET/POST {prefix}/m/{slug}/import`), which
+     * bulk-creates rows from an uploaded file. Default `false`; also requires
+     * `canCreate`.
+     */
+    canImport?: boolean;
+    /**
+     * Foreign-key columns rendered as a typed search box instead of a `<select>`
+     * of every related row — for target tables too large to pre-load.
+     */
+    autocompleteFields?: readonly string[];
 }
 /**
  * The admin configuration for one model.
@@ -3937,6 +3955,14 @@ declare class AdminModel<C extends ModelClass = ModelClass> {
     readonly auditModel: ModelClass | null;
     /** Saved list-view presets, in declaration order. */
     readonly lenses: AdminLens[];
+    /** Columns rendered as file inputs. */
+    readonly uploadFields: string[];
+    /** Backend persisting uploaded files, or `null`. */
+    readonly uploadStorage: UploadStorage | null;
+    /** Whether the CSV import page is exposed. */
+    readonly canImport: boolean;
+    /** Foreign-key columns rendered as a typed search box. */
+    readonly autocompleteFields: string[];
     private readonly actions;
     private readonly slugOverride;
     private readonly listDisplayOverride;
@@ -4086,6 +4112,81 @@ type AdminPermission = (typeof AdminPermission)[keyof typeof AdminPermission];
  */
 type AdminAccessPolicy = (principal: unknown, admin: AdminModel, action: AdminPermission) => boolean | Promise<boolean>;
 
+/**
+ * Multipart form parsing for the admin's upload and import screens.
+ *
+ * The panel's ordinary forms are `application/x-www-form-urlencoded`, which
+ * Express parses on its own. A form carrying a file is `multipart/form-data`,
+ * which it does not — so this module wraps `busboy`, the streaming parser
+ * behind most of the Node ecosystem's upload middleware.
+ *
+ * `busboy` is an **optional peer**: only a project that configures
+ * `uploadFields` or `canImport` needs it, and the error below says exactly what
+ * to install. Multipart is a wire format with a long tail of correctness
+ * (boundary handling, transfer encodings, filename escaping) — the kind of
+ * parser this SDK depends on rather than reimplements.
+ */
+
+/** One uploaded file, buffered in memory. */
+interface UploadedFile {
+    /** The form field the file arrived on. */
+    field: string;
+    /** The client-supplied filename, already stripped of any path. */
+    filename: string;
+    /** The declared MIME type. */
+    contentType: string;
+    /** The file bytes. */
+    data: Buffer;
+}
+/** The result of parsing a multipart body. */
+interface ParsedMultipart {
+    /** Text fields, keyed by name. A repeated field keeps its last value. */
+    fields: Record<string, string>;
+    /** Uploaded files that carried a filename and at least one byte. */
+    files: UploadedFile[];
+}
+/** Options for {@link parseMultipart}. */
+interface ParseMultipartOptions {
+    /** Reject a file larger than this many bytes. Default `10 * 1024 * 1024`. */
+    maxFileBytes?: number;
+    /** Reject more than this many files in one submission. Default `10`. */
+    maxFiles?: number;
+}
+/**
+ * Raised when a submission exceeds a configured multipart limit.
+ *
+ * Distinct from a parse failure so the caller can turn it into a `400` with a
+ * message the operator can act on ("the file is too large") instead of a
+ * generic failure.
+ */
+declare class MultipartLimitError extends Error {
+    /**
+     * @param message - The operator-facing explanation.
+     */
+    constructor(message: string);
+}
+/**
+ * Parse a `multipart/form-data` request body.
+ *
+ * Files are buffered in memory, which is what the admin needs — an operator
+ * attaching a document or a CSV, not a streaming ingest path — and bounded by
+ * `maxFileBytes` so a large upload cannot exhaust the process.
+ *
+ * @param req - The inbound request.
+ * @param options - Size and count limits.
+ * @returns The text fields and the uploaded files.
+ * @throws MultipartLimitError When a limit is exceeded.
+ * @throws Error When `busboy` is missing or the body is not valid multipart.
+ */
+declare function parseMultipart(req: Request, options?: ParseMultipartOptions): Promise<ParsedMultipart>;
+/**
+ * Whether a request carries a multipart body.
+ *
+ * @param req - The inbound request.
+ * @returns `true` when the content type is `multipart/form-data`.
+ */
+declare function isMultipart(req: Request): boolean;
+
 /**
  * Column introspection for the admin panel, mirroring `admin.forms`' widget
  * derivation.
@@ -4099,7 +4200,7 @@ type AdminAccessPolicy = (principal: unknown, admin: AdminModel, action: AdminPe
  */
 
 /** The set of form controls the admin knows how to render. */
-type AdminWidget = "text" | "textarea" | "number" | "checkbox" | "datetime" | "date" | "time" | "select" | "json";
+type AdminWidget = "text" | "textarea" | "number" | "checkbox" | "datetime" | "date" | "time" | "select" | "json" | "file" | "autocomplete";
 /** A `(value, label)` pair for a `select` widget. */
 interface AdminSelectOption {
     value: string;
@@ -4207,6 +4308,10 @@ interface AdminFormField {
     options: AdminSelectOption[];
     /** Per-field validation error, or `null`. */
     error: string | null;
+    /** For an `autocomplete` widget, the JSON search endpoint backing the input. */
+    autocompleteUrl: string | null;
+    /** For an `autocomplete` widget, the label of the currently selected row. */
+    displayLabel: string;
 }
 /** The outcome of parsing a submitted create/edit form. */
 interface ParsedAdminForm {
@@ -4215,6 +4320,17 @@ interface ParsedAdminForm {
     /** Per-field error messages, keyed by column. Empty when the form is valid. */
     errors: Record<string, string>;
 }
+/** Options for {@link parseFormBody}. */
+interface ParseFormBodyOptions {
+    /**
+     * Read upload columns as plain text instead of skipping them.
+     *
+     * The create/edit form skips them because the router writes the storage key
+     * after saving the file. A CSV import has no file to save — it carries the
+     * key already — so it reads them like any other string column.
+     */
+    uploadsAsText?: boolean;
+}
 /** Options for {@link buildFormFields}. */
 interface BuildFormFieldsOptions {
     /** Current values, keyed by column — a row on edit, a re-submission on error. */
@@ -4227,6 +4343,13 @@ interface BuildFormFieldsOptions {
      * of a raw identity text input.
      */
     foreignKeyOptions?: Record<string, AdminSelectOption[]>;
+    /**
+     * Search endpoints for foreign-key columns listed in `autocompleteFields`,
+     * keyed by column. A field listed here renders as a typed search box.
+     */
+    autocompleteUrls?: Record<string, string>;
+    /** Current labels for autocomplete fields, keyed by column. */
+    autocompleteLabels?: Record<string, string>;
 }
 /**
  * Render a stored value into the string a control pre-fills with.
@@ -4262,7 +4385,7 @@ declare function buildFormFields(admin: AdminModel, options?: BuildFormFieldsOpt
  * @param body - The parsed request body.
  * @returns The coerced values plus any per-field errors.
  */
-declare function parseFormBody(admin: AdminModel, body: Record<string, unknown>): ParsedAdminForm;
+declare function parseFormBody(admin: AdminModel, body: Record<string, unknown>, options?: ParseFormBodyOptions): ParsedAdminForm;
 /**
  * Render a stored value for a read-only list or detail cell.
  *
@@ -4895,6 +5018,8 @@ interface AdminListView {
     sort: Record<string, AdminSortView>;
     /** URL of the create form, or `null` when creation is disabled. */
     newUrl: string | null;
+    /** URL of the CSV import page, or `null` when import is disabled. */
+    importUrl: string | null;
     /** Bulk actions offered above the table. Empty hides the whole bulk UI. */
     bulkActions: BulkActionOption[];
     /** URL the bulk form posts to. */
@@ -4999,6 +5124,38 @@ interface AdminFormView {
  * @throws Error When called without a session, since the form needs a CSRF token.
  */
 declare function renderFormPage(context: AdminRenderContext, view: AdminFormView): string;
+/** The outcome of a CSV import, as the page renders it. */
+interface AdminImportView {
+    /** Plural display name of the model being imported into. */
+    title: string;
+    /** URL the upload form posts to. */
+    actionUrl: string;
+    /** URL of the list view. */
+    backUrl: string;
+    /** The column headers the CSV is expected to carry. */
+    columns: string[];
+    /** A form-level error, or `null`. */
+    error: string | null;
+    /** How many rows were created, or `null` before the first submission. */
+    created: number | null;
+    /** Per-row failures, numbered as the spreadsheet numbers them. */
+    rowErrors: {
+        row: number;
+        message: string;
+    }[];
+}
+/**
+ * Render the CSV import page.
+ *
+ * Row numbers start at 2 because row 1 is the header, so the numbers line up
+ * with what the operator sees in their spreadsheet.
+ *
+ * @param context - The shared chrome data (with an active session).
+ * @param view - The prepared import view model.
+ * @returns The full page.
+ * @throws Error When called without a session, since the form needs a CSRF token.
+ */
+declare function renderImportPage(context: AdminRenderContext, view: AdminImportView): string;
 
 /**
  * The server-rendered admin panel router, mirroring `admin.router`.
@@ -5059,6 +5216,8 @@ interface AdminRouterOptions {
      * lets every signed-in operator do whatever those flags allow.
      */
     accessPolicy?: AdminAccessPolicy;
+    /** Largest upload the panel accepts, in bytes. Default `10485760` (10 MB). */
+    maxUploadBytes?: number;
 }
 /**
  * Build the admin panel router.
@@ -5069,6 +5228,20 @@ interface AdminRouterOptions {
  * @throws Error When the signing key is shorter than 32 characters.
  */
 declare function makeAdminRouter(site: AdminSite, options: AdminRouterOptions): Router;
+/**
+ * Parse a CSV document into one record per row, keyed by the header.
+ *
+ * Implements RFC 4180 quoting rather than splitting on commas: a quoted field
+ * may contain commas, newlines and doubled quotes, and an import that mangles
+ * those silently corrupts exactly the rows a human took the trouble to quote.
+ * The leading UTF-8 BOM Excel writes is stripped, because otherwise the first
+ * header name never matches a column.
+ *
+ * @param text - The CSV document.
+ * @returns One record per data row; `[]` when the file has only a header.
+ * @throws Error When the document has no header row.
+ */
+declare function parseCsv(text: string): Record<string, string>[];
 
 /**
  * Headless admin: resource registry for the JSON admin API.
@@ -6840,6 +7013,6 @@ declare function createTestDatabase(models: readonly ModelClass[]): TestDatabase
 declare function withTestDatabase<T>(models: readonly ModelClass[], fn: (db: TestDatabase) => Promise<T>): Promise<T>;
 
 /** The installed SDK version. Single source of truth for the barrel + CLI. */
-declare const VERSION = "0.26.0";
+declare const VERSION = "0.27.0";
 
-export { ADMIN_CSS, type ActivationInput, ActivationService, type ActivationServiceOptions, type ActivationStore, type AdminAccessPolicy, type AdminAction, type AdminActionCategory, type AdminActionContext, type AdminActionHandler, type AdminActionOptions, type AdminActionResult, type AdminAuditEntryView, type AdminAuditView, type AdminAuthBackend, type AdminAutomapOptions, type AdminBusinessCardView, type AdminDashboardCard, type AdminDashboardMetrics, type AdminDetailView, type AdminFilterKind, type AdminFilterView, type AdminFormField, type AdminFormView, type AdminJsonField, type AdminJsonListQuery, type AdminJsonListResult, type AdminJsonResource, type AdminJsonRouterOptions, AdminJsonSite, type AdminLens, type AdminLensOptions, type AdminListView, type AdminMessage, type AdminMfaVerifier, AdminModel, type AdminModelOptions, type AdminNavEntry, AdminPermission, type AdminRenderContext, type AdminRouterOptions, type AdminRow, type AdminSelectOption, type AdminSession, AdminSessionStore, type AdminSessionStoreOptions, AdminSite, type AdminSiteOptions, type AdminSortView, type AdminTheme, type AdminWidget, AppException, type AppExceptionHandlerOptions, type AppExceptionOptions, type AttachWebSocketOptions, AttemptThrottle, type AttemptThrottleOptions, AuditAction, type AuthResponse, type AuthResultPageOptions, type AuthRouterOptions, type AuthUser, type BackupOptions, type BaseAppSettings, BaseAuditLogModel, BaseController, BaseModel, BaseOAuthClient, BaseOutboxModel, type BaseResponse, BaseService, BaseUserModel, BaseUserRefreshTokenModel, BaseUserTokenModel, type BodySizeLimitOptions, type BroadcastOptions, type BroadcastResult, type BrokerManager, type BuildFormFieldsOptions, type BulkActionOption, CEP_PATTERN, CNPJ_PATTERN, CPF_PATTERN, type CPUMetrics, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type CacheManager, type CachedOptions, type CachedResponse, type CardCompute, type CardData, type CatalogData, CircuitOpenError, type ClientIpOptions, CompositeFeatureFlagBackend, ConflictException, type CreateAppOpenApi, type CreateAppOptions, type CsrfOptions, type CursorPaginationFilter, DEFAULT_DOCS_FAVICON, DEFAULT_LOCALE, type DownloadOptions, type EmailMessage, type EmailOptions, EmailProvider, type EmailProviderOptions, EmailUtils, type Enum, type EnumHelpers, type EnumSpec, EnvFeatureFlagBackend, EventStream, type EventStreamOptions, type ExceptionDetails, ExpiredTokenException, type FeatureFlagBackend, FeatureFlags, type FieldChange, type FileLoggingHandle, type FileLoggingOptions, type FlagContext, ForbiddenException, type GPUMetrics, type GenerateOpenApiOptions, GitHubOAuthClient, GoogleOAuthClient, GracefulShutdown, type GracefulShutdownOptions, HTTPClient, type HTTPClientOptions, HTTP_500_LOG_FILE, HTTP_500_MARKER, type HandshakeInfo, type HealthCheck, type HealthRouterOptions, HttpMetrics, IDEMPOTENCY_HEADER, type IdempotencyOptions, type IdempotencyRedisLike, type IdempotencyStore, type InboundHandler, type InboundMessage, InvalidTokenException, type IssuedSession, JSONLogger, JWTUtils, type JWTUtilsOptions, type JwtAuthOptions, type JwtClaims, type JwtDecoderLike, LEVEL_LOG_FILES, LocalUploadStorage, type LocalUploadStorageOptions, type LogEntry, type LogExtra, type LogLevel, type LogSink, type LogSource, type LoginInput, type LoginResult, type LogsRouterOptions, type MediaKind, MemoryBroker, MemoryCacheManager, MemoryFeatureFlagBackend, MemoryIdempotencyStore, type MemoryMetrics, MemoryRateLimitStore, MemorySessionStore, MemoryThrottleBackend, MessageCatalog, type MessageHandler, MessagingHub, type MessagingProvider, type MetricCard, type MetricPartition, type MetricTrend, type MetricValue, type MetricsRouterOptions, MetricsUtils, type MfaChallenge, type MfaChallengeInput, type MfaCodeInput, type MfaEnrollment, MfaService, type MfaServiceOptions, type MfaStore, NotFoundException, type OAuthClientOptions, OAuthError, type OAuthTokens, type OAuthUser, OIDCProvider, type OIDCProviderOptions, type OpenApiDocument, type OpenApiInfo, type OutboundMedia, type OutboundResult, type OutboxPublisher, OutboxRelay, type OutboxRelayOptions, OutboxStatus, PHONE_BR_PATTERN, type PaginationFilter, type PaginationLinkOptions, type ParsedAdminForm, type PasswordResetConfirmInput, type PasswordResetFormOptions, type PasswordResetRequestInput, PasswordResetService, type PasswordResetServiceOptions, type PasswordResetStore, PasswordUtils, REDOC_CDN_URL, REQUEST_ID_HEADER, RabbitBroker, type RabbitBrokerOptions, type RateLimitKeyFunc, type RateLimitOptions, type RateLimitRedisLike, type RateLimitResult, type RateLimitStore, RedisCacheManager, RedisIdempotencyStore, type RedisLike, type RedisPublisherLike, RedisRateLimitStore, RedisSSEBroker, type RedisSSEBrokerOptions, RedisSessionStore, type RedisSubscriberLike, type RedocBundleSource, type RedocOptions, type RefreshInput, Region, type RegionValue, type RegisterExceptionHandlersOptions, type RequestContext, type RequestTracingOptions, type ResolvedAdminTheme, type ResponseMapper, RetryPolicy, type RunServerOptions, type S3ClientLike, S3UploadStorage, type S3UploadStorageOptions, SSEBroker, type SaveOptions, type SendOptions, ServerSentEvent, type ServerSentEventInit, type Session, type SessionMiddlewareOptions, type SessionRedisLike, SessionService, type SessionServiceOptions, type SessionStore, type SignupInput, type SlowQueryOptions, type SpecProvider, type StateBR, type SwaggerOptions, type SyncFilter, type SystemMetrics, TOTPHelper, type TOTPOptions, type TaskHandler, TaskManager, type TaskManagerOptions, TelegramProvider, type TelegramProviderOptions, TenantScopedRepository, type TestDatabase, type ThrottleBackend, type ThrottleStatus, type ToDictOptions, type TokenPair, TooManyRequestsException, type TooManyRequestsOptions, type ToolSpecOptions, TwilioSmsProvider, type TwilioSmsProviderOptions, type TwilioWebhookOptions, UF, type UFValue, UnauthorizedException, type UnhandledExceptionHandlerOptions, type UploadResult, type UploadStorage, UserAuthService, type UserAuthServiceOptions, UserModelAuthBackend, type UserModelAuthBackendOptions, type UserPublic, type UserStore, UserTokenPurpose, VERSION, ValidationException, type WSEnvelope, WebPushDispatcher, type WebPushDispatcherOptions, WebPushError, WebPushGoneError, type WebPushKeys, type WebPushPayload, type WebPushSubscription, type WebSocketConnection, WebSocketHub, type WebSocketHubOptions, type WebSocketLike, type WebhookSignatureOptions, WebhookSignatureVerifier, WhatsAppProvider, type WhatsAppProviderOptions, type WhatsAppWebhookOptions, type WidgetSpec, activationSchema, addLogSink, adminAction, adminColumns, adminLens, adminThemeCss, attachWebSocketHub, authResponseSchema, authSettingsShape, backupDatabase, baseAppSettingsSchema, baseAppSettingsShape, baseResponseSchema, bearerToken, bodySizeLimitMiddleware, broadcastText, buildContentDisposition, buildFormFields, buildPaginationLinkHeader, cached, centsField, cepField, citiesByUf, cnpjField, coerceFlag, configureFileLogging, configureLogging, corsSettingsShape, cpfField, cpfOrCnpjField, createApp, createOpenApiRegistry, createTestDatabase, createdByColumn, csrfMiddleware, csrfTokenMatches, cursorPaginationFilterSchema, cursorPaginationSchema, databaseSettingsShape, decodeCursor, defaultMessageCatalog, defineEnum, deletedAtColumn, diffSnapshots, emailSettingsShape, encodeCursor, looseBoolean as envBoolean, envList, escapeHtml, filterForColumn, foreignKeyFields, foreignKeyLabel, foreignKeyTable, formatCellValue, formatFieldValue, generateCsrfToken, generateOAuthState, generateOpaqueToken, generateOpenApiDocument, getAuth, getClientIp, getConditions, getPaginationConditions, getRequestId, getState, hashOpaqueToken, hexColorField, humanizeField, idempotencyMiddleware, inboundMessageSchema, isColumnOptional, isSearchableColumn, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, jwtSettingsShape, keyByHeader, keyByIp, keyByJwtClaim, keyByJwtSubject, latitudeField, listStates, loadSettings, logEntrySchema, logSettingsShape, loginSchema, longitudeField, looseBoolean, makeAdminJsonRouter, makeAdminRouter, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeLogsRouter, makeMetricsRouter, makeSessionMiddleware, makeToolSpecRouter, makeTwilioWebhookRouter, makeUnhandledExceptionHandler, makeWhatsAppWebhookRouter, metricCard, mfaChallengeSchema, mfaCodeSchema, mfaEnrollResponseSchema, minioSettingsShape, modifyDict, mountOpenApiJson, mountRedoc, mountSwaggerUi, nonEmptyStrField, nonNegativeFloatField, nonNegativeIntField, normalizeCep, normalizeCnpj, normalizeCpf, normalizeCpfCnpj, normalizePhoneBr, normalizeUf, notFoundHandler, onlyDigits, paginationFilterSchema, paginationSchema, parseAcceptLanguage, parseCookies, parseFormBody, partitionTotal, passwordResetConfirmSchema, passwordResetRequestSchema, percentField, phoneBrField, portField, positiveFloatField, positiveIntField, priceField, prometheusMiddleware, rabbitmqSettingsShape, rateLimitMiddleware, ratingField, ratioField, redisSettingsShape, refreshSchema, registerExceptionHandlers, renderAuthResultPage, renderDashboardPage, renderDetailPage, renderFormPage, renderLayout, renderListPage, renderLoginPage, renderMfaPage, renderPasswordResetFormPage, requestIdMiddleware, requestTracingMiddleware, requireRoles, resolveAdminTheme, resolveDownloadPath, resolveRedocBundle, runServer, runWithRequestContext, sendBytesDownload, sendFileDownload, serverSettingsShape, sessionCookie, sessionSettingsShape, setRequestId, signupSchema, slugField, snapshot, sseResponse, statesByRegion, syncFilterSchema, syncPaginationSchema, tableNameFor, toDict, toUtc, tokenFromUrl, tokenPairSchema, tokenSettingsShape, trendDirection, trendPercent, ufField, updatedByColumn, uploadSettingsShape, userPublicSchema, utcnow, validateTwilioSignature, verifyOpaqueToken, webPushKeysSchema, webPushPayloadSchema, webPushSettingsShape, webPushSubscriptionSchema, webSocketSettingsShape, widgetForColumn, withTestDatabase, wrapWithSlowQueryLog, wsEnvelopeSchema };
+export { ADMIN_CSS, type ActivationInput, ActivationService, type ActivationServiceOptions, type ActivationStore, type AdminAccessPolicy, type AdminAction, type AdminActionCategory, type AdminActionContext, type AdminActionHandler, type AdminActionOptions, type AdminActionResult, type AdminAuditEntryView, type AdminAuditView, type AdminAuthBackend, type AdminAutomapOptions, type AdminBusinessCardView, type AdminDashboardCard, type AdminDashboardMetrics, type AdminDetailView, type AdminFilterKind, type AdminFilterView, type AdminFormField, type AdminFormView, type AdminImportView, type AdminJsonField, type AdminJsonListQuery, type AdminJsonListResult, type AdminJsonResource, type AdminJsonRouterOptions, AdminJsonSite, type AdminLens, type AdminLensOptions, type AdminListView, type AdminMessage, type AdminMfaVerifier, AdminModel, type AdminModelOptions, type AdminNavEntry, AdminPermission, type AdminRenderContext, type AdminRouterOptions, type AdminRow, type AdminSelectOption, type AdminSession, AdminSessionStore, type AdminSessionStoreOptions, AdminSite, type AdminSiteOptions, type AdminSortView, type AdminTheme, type AdminWidget, AppException, type AppExceptionHandlerOptions, type AppExceptionOptions, type AttachWebSocketOptions, AttemptThrottle, type AttemptThrottleOptions, AuditAction, type AuthResponse, type AuthResultPageOptions, type AuthRouterOptions, type AuthUser, type BackupOptions, type BaseAppSettings, BaseAuditLogModel, BaseController, BaseModel, BaseOAuthClient, BaseOutboxModel, type BaseResponse, BaseService, BaseUserModel, BaseUserRefreshTokenModel, BaseUserTokenModel, type BodySizeLimitOptions, type BroadcastOptions, type BroadcastResult, type BrokerManager, type BuildFormFieldsOptions, type BulkActionOption, CEP_PATTERN, CNPJ_PATTERN, CPF_PATTERN, type CPUMetrics, CSRF_COOKIE_NAME, CSRF_HEADER_NAME, type CacheManager, type CachedOptions, type CachedResponse, type CardCompute, type CardData, type CatalogData, CircuitOpenError, type ClientIpOptions, CompositeFeatureFlagBackend, ConflictException, type CreateAppOpenApi, type CreateAppOptions, type CsrfOptions, type CursorPaginationFilter, DEFAULT_DOCS_FAVICON, DEFAULT_LOCALE, type DownloadOptions, type EmailMessage, type EmailOptions, EmailProvider, type EmailProviderOptions, EmailUtils, type Enum, type EnumHelpers, type EnumSpec, EnvFeatureFlagBackend, EventStream, type EventStreamOptions, type ExceptionDetails, ExpiredTokenException, type FeatureFlagBackend, FeatureFlags, type FieldChange, type FileLoggingHandle, type FileLoggingOptions, type FlagContext, ForbiddenException, type GPUMetrics, type GenerateOpenApiOptions, GitHubOAuthClient, GoogleOAuthClient, GracefulShutdown, type GracefulShutdownOptions, HTTPClient, type HTTPClientOptions, HTTP_500_LOG_FILE, HTTP_500_MARKER, type HandshakeInfo, type HealthCheck, type HealthRouterOptions, HttpMetrics, IDEMPOTENCY_HEADER, type IdempotencyOptions, type IdempotencyRedisLike, type IdempotencyStore, type InboundHandler, type InboundMessage, InvalidTokenException, type IssuedSession, JSONLogger, JWTUtils, type JWTUtilsOptions, type JwtAuthOptions, type JwtClaims, type JwtDecoderLike, LEVEL_LOG_FILES, LocalUploadStorage, type LocalUploadStorageOptions, type LogEntry, type LogExtra, type LogLevel, type LogSink, type LogSource, type LoginInput, type LoginResult, type LogsRouterOptions, type MediaKind, MemoryBroker, MemoryCacheManager, MemoryFeatureFlagBackend, MemoryIdempotencyStore, type MemoryMetrics, MemoryRateLimitStore, MemorySessionStore, MemoryThrottleBackend, MessageCatalog, type MessageHandler, MessagingHub, type MessagingProvider, type MetricCard, type MetricPartition, type MetricTrend, type MetricValue, type MetricsRouterOptions, MetricsUtils, type MfaChallenge, type MfaChallengeInput, type MfaCodeInput, type MfaEnrollment, MfaService, type MfaServiceOptions, type MfaStore, MultipartLimitError, NotFoundException, type OAuthClientOptions, OAuthError, type OAuthTokens, type OAuthUser, OIDCProvider, type OIDCProviderOptions, type OpenApiDocument, type OpenApiInfo, type OutboundMedia, type OutboundResult, type OutboxPublisher, OutboxRelay, type OutboxRelayOptions, OutboxStatus, PHONE_BR_PATTERN, type PaginationFilter, type PaginationLinkOptions, type ParseFormBodyOptions, type ParseMultipartOptions, type ParsedAdminForm, type ParsedMultipart, type PasswordResetConfirmInput, type PasswordResetFormOptions, type PasswordResetRequestInput, PasswordResetService, type PasswordResetServiceOptions, type PasswordResetStore, PasswordUtils, REDOC_CDN_URL, REQUEST_ID_HEADER, RabbitBroker, type RabbitBrokerOptions, type RateLimitKeyFunc, type RateLimitOptions, type RateLimitRedisLike, type RateLimitResult, type RateLimitStore, RedisCacheManager, RedisIdempotencyStore, type RedisLike, type RedisPublisherLike, RedisRateLimitStore, RedisSSEBroker, type RedisSSEBrokerOptions, RedisSessionStore, type RedisSubscriberLike, type RedocBundleSource, type RedocOptions, type RefreshInput, Region, type RegionValue, type RegisterExceptionHandlersOptions, type RequestContext, type RequestTracingOptions, type ResolvedAdminTheme, type ResponseMapper, RetryPolicy, type RunServerOptions, type S3ClientLike, S3UploadStorage, type S3UploadStorageOptions, SSEBroker, type SaveOptions, type SendOptions, ServerSentEvent, type ServerSentEventInit, type Session, type SessionMiddlewareOptions, type SessionRedisLike, SessionService, type SessionServiceOptions, type SessionStore, type SignupInput, type SlowQueryOptions, type SpecProvider, type StateBR, type SwaggerOptions, type SyncFilter, type SystemMetrics, TOTPHelper, type TOTPOptions, type TaskHandler, TaskManager, type TaskManagerOptions, TelegramProvider, type TelegramProviderOptions, TenantScopedRepository, type TestDatabase, type ThrottleBackend, type ThrottleStatus, type ToDictOptions, type TokenPair, TooManyRequestsException, type TooManyRequestsOptions, type ToolSpecOptions, TwilioSmsProvider, type TwilioSmsProviderOptions, type TwilioWebhookOptions, UF, type UFValue, UnauthorizedException, type UnhandledExceptionHandlerOptions, type UploadResult, type UploadStorage, type UploadedFile, UserAuthService, type UserAuthServiceOptions, UserModelAuthBackend, type UserModelAuthBackendOptions, type UserPublic, type UserStore, UserTokenPurpose, VERSION, ValidationException, type WSEnvelope, WebPushDispatcher, type WebPushDispatcherOptions, WebPushError, WebPushGoneError, type WebPushKeys, type WebPushPayload, type WebPushSubscription, type WebSocketConnection, WebSocketHub, type WebSocketHubOptions, type WebSocketLike, type WebhookSignatureOptions, WebhookSignatureVerifier, WhatsAppProvider, type WhatsAppProviderOptions, type WhatsAppWebhookOptions, type WidgetSpec, activationSchema, addLogSink, adminAction, adminColumns, adminLens, adminThemeCss, attachWebSocketHub, authResponseSchema, authSettingsShape, backupDatabase, baseAppSettingsSchema, baseAppSettingsShape, baseResponseSchema, bearerToken, bodySizeLimitMiddleware, broadcastText, buildContentDisposition, buildFormFields, buildPaginationLinkHeader, cached, centsField, cepField, citiesByUf, cnpjField, coerceFlag, configureFileLogging, configureLogging, corsSettingsShape, cpfField, cpfOrCnpjField, createApp, createOpenApiRegistry, createTestDatabase, createdByColumn, csrfMiddleware, csrfTokenMatches, cursorPaginationFilterSchema, cursorPaginationSchema, databaseSettingsShape, decodeCursor, defaultMessageCatalog, defineEnum, deletedAtColumn, diffSnapshots, emailSettingsShape, encodeCursor, looseBoolean as envBoolean, envList, escapeHtml, filterForColumn, foreignKeyFields, foreignKeyLabel, foreignKeyTable, formatCellValue, formatFieldValue, generateCsrfToken, generateOAuthState, generateOpaqueToken, generateOpenApiDocument, getAuth, getClientIp, getConditions, getPaginationConditions, getRequestId, getState, hashOpaqueToken, hexColorField, humanizeField, idempotencyMiddleware, inboundMessageSchema, isColumnOptional, isMultipart, isSearchableColumn, isValidCep, isValidCity, isValidCnpj, isValidCpf, isValidCpfCnpj, isValidPhoneBr, isValidUf, jwtSettingsShape, keyByHeader, keyByIp, keyByJwtClaim, keyByJwtSubject, latitudeField, listStates, loadSettings, logEntrySchema, logSettingsShape, loginSchema, longitudeField, looseBoolean, makeAdminJsonRouter, makeAdminRouter, makeAppExceptionHandler, makeAuthRouter, makeFlagGuard, makeHealthRouter, makeJwtAuthMiddleware, makeLogsRouter, makeMetricsRouter, makeSessionMiddleware, makeToolSpecRouter, makeTwilioWebhookRouter, makeUnhandledExceptionHandler, makeWhatsAppWebhookRouter, metricCard, mfaChallengeSchema, mfaCodeSchema, mfaEnrollResponseSchema, minioSettingsShape, modifyDict, mountOpenApiJson, mountRedoc, mountSwaggerUi, nonEmptyStrField, nonNegativeFloatField, nonNegativeIntField, normalizeCep, normalizeCnpj, normalizeCpf, normalizeCpfCnpj, normalizePhoneBr, normalizeUf, notFoundHandler, onlyDigits, paginationFilterSchema, paginationSchema, parseAcceptLanguage, parseCookies, parseCsv, parseFormBody, parseMultipart, partitionTotal, passwordResetConfirmSchema, passwordResetRequestSchema, percentField, phoneBrField, portField, positiveFloatField, positiveIntField, priceField, prometheusMiddleware, rabbitmqSettingsShape, rateLimitMiddleware, ratingField, ratioField, redisSettingsShape, refreshSchema, registerExceptionHandlers, renderAuthResultPage, renderDashboardPage, renderDetailPage, renderFormPage, renderImportPage, renderLayout, renderListPage, renderLoginPage, renderMfaPage, renderPasswordResetFormPage, requestIdMiddleware, requestTracingMiddleware, requireRoles, resolveAdminTheme, resolveDownloadPath, resolveRedocBundle, runServer, runWithRequestContext, sendBytesDownload, sendFileDownload, serverSettingsShape, sessionCookie, sessionSettingsShape, setRequestId, signupSchema, slugField, snapshot, sseResponse, statesByRegion, syncFilterSchema, syncPaginationSchema, tableNameFor, toDict, toUtc, tokenFromUrl, tokenPairSchema, tokenSettingsShape, trendDirection, trendPercent, ufField, updatedByColumn, uploadSettingsShape, userPublicSchema, utcnow, validateTwilioSignature, verifyOpaqueToken, webPushKeysSchema, webPushPayloadSchema, webPushSettingsShape, webPushSubscriptionSchema, webSocketSettingsShape, widgetForColumn, withTestDatabase, wrapWithSlowQueryLog, wsEnvelopeSchema };