@warlock.js/core 5.26.0 → 5.27.0

package/esm/http/request.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.mts","names":[],"sources":["../../../../../../../core/src/http/request.ts"],"mappings":"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"}
+{"version":3,"file":"request.d.mts","names":[],"sources":["../../../../../../../core/src/http/request.ts"],"mappings":"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"}

package/esm/http/serialized.d.mts

@@ -0,0 +1,114 @@
+import { Model } from "@warlock.js/cascade";
+
+//#region ../core/src/http/serialized.d.ts
+/**
+ * The two wire formats Warlock serializes a value into.
+ *
+ * - `"json"`: an API response. `Response.parse` walks the value, then the body
+ *   is `JSON.stringify`-ed. `Date` becomes a string, `Map` an object, `Set` an
+ *   array.
+ * - `"devalue"`: page loader data. `serializeLoaderData` walks the value, then
+ *   `devalue` encodes it. `Date`, `Map`, `Set`, `RegExp` and `URL` survive as
+ *   native values.
+ */
+type SerializedWire = "json" | "devalue";
+/**
+ * Maps cascade models to the resource that serializes them.
+ *
+ * Empty on purpose: `Model.resource` is a static typed `any`, so a model
+ * instance type cannot reveal its resource. A code generator (or the app)
+ * augments this interface instead, one entry per model:
+ *
+ * @example
+ * declare module "@warlock.js/core" {
+ *   interface ModelResourceRegistry {
+ *     User: { model: User; resource: typeof UserResource };
+ *   }
+ * }
+ *
+ * `Serialized<User>` then resolves to the output of `UserResource`. A model
+ * with no entry resolves to its serialized `data` type instead.
+ */
+interface ModelResourceRegistry {}
+/** Deepest level `Serialized` walks before giving up with `unknown`. */
+type MaxSerializedDepth = 8;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+/** Passes through untouched on both wires (`Buffer` has a `toJSON`, so it must be caught first). */
+type Binary = Buffer | Uint8Array;
+/** Returned whole by `serializeLoaderData` before `toJSON` is considered. */
+type DevalueNative = Date | RegExp | URL | Map<any, any> | Set<any>;
+/**
+ * Built-in classes that are not plain objects and have no `toJSON`. JSON emits
+ * `{}` for them (their state is not enumerable); devalue cannot encode them.
+ */
+type OpaqueBuiltin = Error | WeakMap<any, any> | WeakSet<any> | WeakRef<any>;
+type IsFunctionValued<V> = IsAny<V> extends true ? false : [Exclude<V, undefined>] extends [never] ? false : [Exclude<V, undefined>] extends [(...args: any[]) => any] ? true : false;
+type IsUndefinable<V> = IsAny<V> extends true ? false : unknown extends V ? false : undefined extends V ? true : false;
+/** Keys whose value is not a function: functions are dropped by JSON and by the key-removal rule. */
+type DataKeys<T> = { [K in keyof T]-?: IsFunctionValued<T[K]> extends true ? never : K }[keyof T];
+/** Keys that JSON omits when their value is `undefined`, so they become optional on the json wire. */
+type UndefinableKeys<T> = { [K in keyof T]-?: K extends DataKeys<T> ? (IsUndefinable<T[K]> extends true ? K : never) : never }[keyof T];
+type Flatten<T> = { [K in keyof T]: T[K] };
+/**
+ * Whether `T` has members a mapped copy cannot carry (private, protected or
+ * `#private`). Only such a class is detectable as a class at the type level; a
+ * class with public members only is structurally an interface, so it is treated
+ * as a plain object. Mapping `keyof T` drops the non-public members, which makes
+ * the copy unassignable back to `T`.
+ */
+type HasNonPublicMembers<T> = { [K in keyof T]: T[K] } extends T ? false : true;
+/** Resource registered for the model type `T`, or `never` when `T` has no entry. */
+type RegisteredResource<T> = { [K in keyof ModelResourceRegistry]: ModelResourceRegistry[K] extends {
+  model: infer M;
+  resource: infer R;
+} ? [T] extends [M] ? [M] extends [T] ? R : never : never : never }[keyof ModelResourceRegistry];
+/** What a resource class emits from `toJSON()`, serialized for the wire. */
+type SerializedResource<R, W extends SerializedWire, D extends unknown[]> = R extends (new (...args: any[]) => {
+  toJSON(): infer O;
+}) ? Serialized<O, W, D> : unknown;
+type SerializedModel<T, W extends SerializedWire, D extends unknown[]> = [RegisteredResource<T>] extends [never] ? T extends {
+  data: infer Data;
+} ? Serialized<Data, W, [...D, 0]> : never : SerializedResource<RegisteredResource<T>, W, [...D, 0]>;
+type SerializedJsonObject<T, D extends unknown[]> = Flatten<{ [K in keyof T as K extends Exclude<DataKeys<T>, UndefinableKeys<T>> ? K : never]-?: Serialized<T[K], "json", [...D, 0]> } & { [K in keyof T as K extends UndefinableKeys<T> ? K : never]+?: Serialized<Exclude<T[K], undefined>, "json", [...D, 0]> }>;
+type SerializedDevalueObject<T, D extends unknown[]> = { -readonly [K in keyof T as K extends DataKeys<T> ? K : never]: Serialized<T[K], "devalue", [...D, 0]> };
+type SerializedObject<T, W extends SerializedWire, D extends unknown[]> = W extends "json" ? SerializedJsonObject<T, D> : SerializedDevalueObject<T, D>;
+/**
+ * The type of what a client receives after Warlock serializes a value of type
+ * `T`. It mirrors `Response.parse` (`"json"`, the default) and
+ * `serializeLoaderData` (`"devalue"`), branch for branch and in the same order:
+ *
+ * 1. `any` stays `any`; `unknown` stays `unknown`; primitives pass through.
+ * 2. `Buffer` / `Uint8Array` pass through on both wires.
+ * 3. devalue: `Date`, `RegExp`, `URL`, `Map`, `Set` stay native.
+ *    json: `Map<K, V>` becomes `Record<K, V'>`.
+ * 4. A cascade `Model`: the output of its registered resource (see
+ *    {@link ModelResourceRegistry}), else its serialized `data` type.
+ * 5. Anything with `toJSON()`: the serialized (awaited) result. This is where a
+ *    `Date` becomes a `string` on json.
+ * 6. Arrays and tuples map item by item; other iterables (a `Set` on json,
+ *    generators) become arrays.
+ * 7. Functions are removed from objects (and are `never` on their own).
+ * 8. Objects are mapped key by key. On json a key whose value can be
+ *    `undefined` becomes optional, because `JSON.stringify` omits it.
+ *
+ * Plain object vs class instance cannot be decided by the type system in
+ * general. The rule used: only a class with non-public (private, protected or
+ * `#private`) members, or a built-in such as `Error`, is treated as a class
+ * instance without `toJSON`. It maps to its public data properties on json
+ * (`Error` to `{}`) and to `never` on devalue, where devalue throws at render
+ * time. Any other object type is treated as plain.
+ *
+ * Nesting is walked up to a fixed depth, then the result is `unknown`.
+ *
+ * @example
+ * type UserPayload = Serialized<User>; // resource output or serialized data
+ * type PageData = Serialized<LoaderReturn, "devalue">;
+ */
+type Serialized<T, W extends SerializedWire = "json", D extends unknown[] = []> = IsAny<T> extends true ? any : unknown extends T ? unknown : D["length"] extends MaxSerializedDepth ? unknown : T extends Primitive ? T : T extends Binary ? T : W extends "devalue" ? T extends DevalueNative ? T : T extends PromiseLike<infer V> ? Serialized<V, W, D> : SerializedStructure<T, W, D> : T extends Map<infer K, infer V> ? Record<Extract<K, PropertyKey>, Serialized<V, W, D>> : SerializedStructure<T, W, D>;
+type SerializedStructure<T, W extends SerializedWire, D extends unknown[]> = T extends Model<any> ? SerializedModel<T, W, D> : T extends {
+  toJSON(...args: any[]): infer R;
+} ? Serialized<Awaited<R>, W, [...D, 0]> : T extends readonly unknown[] ? { -readonly [K in keyof T]: Serialized<T[K], W, D> } : T extends Iterable<infer I> ? Serialized<I, W, D>[] : T extends ((...args: any[]) => any) ? never : T extends OpaqueBuiltin ? W extends "json" ? {} : never : HasNonPublicMembers<T> extends true ? W extends "json" ? SerializedObject<T, W, D> : never : SerializedObject<T, W, D>;
+//#endregion
+export { ModelResourceRegistry, Serialized, SerializedWire };
+//# sourceMappingURL=serialized.d.mts.map

package/esm/http/serialized.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized.d.mts","names":[],"sources":["../../../../../../../core/src/http/serialized.ts"],"mappings":"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"}

package/esm/index.d.mts

@@ -64,11 +64,12 @@ import { deriveTraceId, parseTraceparentTraceId } from "./http/tracing/trace-id.
 import { TracingContextSource, buildTracingContext, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, isTracingEnabled, registerTracingHooks, resetTracingConfigForTests, resolveTracingConfig } from "./http/tracing/tracing-dispatcher.mjs";
 import { RequestContextStore, requestContext, useCurrentUser, useRequest, useRequestStore } from "./http/context/request-context.mjs";
 import { requestMemo } from "./http/context/request-memo.mjs";
+import { ModelResourceRegistry, Serialized, SerializedWire } from "./http/serialized.mjs";
 import { LocalizedObject, getLocalized } from "./utils/get-localized.mjs";
 import { ResourceFieldBuilder } from "./resource/resource-field-builder.mjs";
 import { Resource, ResourceConstructor, ResourceContract } from "./resource/resource.mjs";
-import { ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyValue, ResponseSchema } from "./resource/types.mjs";
-import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, NamedApiRoute, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./router/types.mjs";
+import { BaseCastOutput, CastOutput, FieldOutput, ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyOutput, ResponseBodyValue, ResponseSchema, ResponseSchemaOutput } from "./resource/types.mjs";
+import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, NamedApiRoute, NamedApiRoutesOptions, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./router/types.mjs";
 import { PositionalHandlerSuspect, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./router/positional-handler-diagnostics.mjs";
 import { matchesDerivedRouteName, routeNameMethodSuffix } from "./router/route-name-method-suffix.mjs";
 import { RouteRegistry } from "./router/route-registry.mjs";
@@ -138,6 +139,9 @@ import { renderReactMail } from "./mail/react-mail.mjs";
 import { sendMail } from "./mail/send-mail.mjs";
 import { Mail } from "./mail/mail.mjs";
 import { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject } from "./mail/test-mailbox.mjs";
+import { AuthDescriptor, OpenApiBuildResult, OpenApiComponents, OpenApiContext, OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiRequestBody, OpenApiResponse, OpenApiRouteInput, OpenApiSchema, OpenApiSecurityRequirement, OpenApiSecurityScheme, OpenApiValidationResponseConfig, WarningSink } from "./openapi/types.mjs";
+import { getDevelopmentOpenApiDocument, registerDevelopmentOpenApiProvider } from "./openapi/development-openapi-provider.mjs";
+import { OPENAPI_JSON_SCHEMA_DIALECT, buildOpenApiDocument } from "./openapi/build-openapi-document.mjs";
 import { renderReact } from "./react/index.mjs";
 import { RepositoryManager } from "./repositories/repository.manager.mjs";
 import { RepositoryAdapterContract } from "./repositories/contracts/repository-adapter.contract.mjs";
@@ -182,9 +186,10 @@ import { WarlockConfigManager, isUnknownTsExtensionError, warlockConfigManager }
 import { env } from "@mongez/dotenv";
 import { colors } from "@mongez/copper";
 export * from "@mongez/localization";
-export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AggregateExpressionInput, AggregateExpressions, AiConnector, AllRepositoryOptions, AppConfigurations, AppRole, Application, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseConnector, type BenchmarkChannel, type BenchmarkConfigurations, type BenchmarkErrorResult, type BenchmarkOptions, BenchmarkProfiler, type BenchmarkProfilerOptions, type BenchmarkResult, BenchmarkSnapshots, type BenchmarkSnapshotsOptions, type BenchmarkStats, type BenchmarkSuccessResult, BootContext, BootListener, BootSignal, BootSignalType, BootValidator, CLICommand, type CLICommandAction, type CLICommandOption, type CLICommandOptions, type CLICommandPreload, type CLICommandSource, CacheConnector, type CacheMiddlewareOptions, CachedRepositoryOptions, type CapturedMail, CascadeAdapter, CascadeQueryBuilder, ChunkCallback, ClosableServer, CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, type CommandActionData, type ConcurrencyLimitOptions, ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry, ConfigSpecialHandlers, ConflictError, Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, ConsoleChannel, ContainerTypes, CookieJarUnavailableError, CookieOptions, CspConfig, CsrfOriginCheckReason, CsrfOriginVerdict, CursorPaginationOptions, CursorPaginationResult, DEFAULT_CSP_DIRECTIVES, DOSpacesDriver, DatabaseCacheDriver, type DatabaseCacheOptions, DatabaseConnector, DatabaseLog, DatabaseLogModel, DatabaseLogOptions, DecodedAccessToken, DefineResourceOptions, DeleteManyResult, DetectedImageFormat, type DevelopmentModelModuleEntry, type DevelopmentModelModuleState, type DevelopmentModelModules, EncryptionConfigurations, EncryptionPasswordConfigurations, Environment, EventSubscription, ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FastifyInstance, FileNamingStrategy, FileValidationOptions, FileValidator, FileVisibility, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, ForbiddenError, GenerateImageVariantsOptions, GeneratedImageDescriptor, GeneratedImageVariant, GroupByFields, GroupedRoutesOptions, HealthCheck, HealthStatus, HeraldConnector, HttpConfigurations, HttpConnector, HttpContext, HttpError, HttpErrorCodes, HttpReadyReport, HttpServerRebuiltListener, HttpTracingConfig, type IdempotencyOptions, Image, ImageFormat, ImageInput, ImageTransformCallback, ImageTransformConfig, ImageTransformOptions, ImageVariantDefinition, ImageVariantFit, ImageVariantOutputFormat, ImageVariantsConfigError, InvalidCspDirectiveError, type IpFilterOptions, ListOptions, LocalDriver, LocalStorageDriverOptions, LocaleDictionaryEntries, LocaleDictionaryError, LocalizedObject, LogConfigurations, LoggerConnector, MAIL_EVENTS, Mail, type MailAddress, type MailAttachment, type MailConfigurations, MailError, type MailErrorCode, type MailEvents, type MailMode, type MailOptions, type MailPriority, type MailResult, MailerConnector, type MailersConfig, type MaintenanceOptions, Middleware, MiddlewareResponse, MimeTypes, NamedApiRoute, NoopChannel, type NormalizedMail, NotAcceptableError, NotAllowedError, NotificationsConnector, PaginationMode, PaginationResult, ParsedLocaleDictionary, PartialMiddleware, PartialPick, Path, PipeableReactStream, PipelineOptions, PortInUseError, PositionalHandlerSuspect, PrefixConfig, PrefixOptions, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, QueryBuilderContract, Queue, R2Driver, R2StorageDriverOptions, type RateLimitOptions, RegisterConfiguredConnectorsOptions, RegisterResource, RegisteredUseCase, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryManager, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, Request, RequestContextStore, RequestController, RequestControllerContract, RequestEvent, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestLocals, RequestLog, RequestMethod, RequestTranslator, type ResolvedCLICommandOption, ResolvedImageVariantsConfig, Resource, ResourceArraySchema, ResourceCastType, ResourceConstructor, ResourceContract, ResourceFieldBuilder, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceMethod, ResourceNotFoundError, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, Response, ResponseBodyValue, ResponseEvent, ResponseSSEController, ResponseSchema, ResponseStatus, ResponseStreamController, Restful, RestfulMiddleware, ReturnedResponse, Route, RouteOptions, RouteRegistry, RouteResource, Router, RouterGroupCallback, RouterStacks, RuntimeStrategy, S3Driver, type SESConfigurations, type SMTPConfigurations, SafeFetchOptions, SafeFetchResult, SaveAsOptions, SaveMode, SaveOptions, ScopedStorage, ScopedStorageContract, SeedClock, SeedContext, SeedRecordRef, SeedResult, Seeder, SeederDependencyCycleError, SeederMetadata, SendBufferOptions, SendFileOptions, ServerError, ShutdownListener, SocketAdapterFactory, SocketConnector, SocketOptions, Storage, StorageCapabilityError, StorageConfigurations, StorageConnector, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageError, StorageErrorOptions, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StorageNotInitializedError, StoragePutEventPayload, StreamReactResponseOptions, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, TracingContext, TracingContextSource, TracingHooks, TracingPhaseInfo, TracingRequestEndInfo, Track, TrackableModel, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, UnAuthorizedError, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, UnknownSeederDependencyError, UploadedFile, UploadedFileImageOptions, UploadedFileJson, UploadedFileQuery, UploadsConfigurations, UploadsImagesConfigurations, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, ValidationConfiguration, VariantOutputFormat, VariantSourceFormat, WarlockConfig, WarlockConfigManager, WatermarkConfig, WhereOperator, XMLable, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, onHttpServerRebuilt, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerConfiguredConnectors, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveMailConfig, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
+export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AggregateExpressionInput, AggregateExpressions, AiConnector, AllRepositoryOptions, AppConfigurations, AppRole, Application, AuthDescriptor, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseCastOutput, BaseConnector, type BenchmarkChannel, type BenchmarkConfigurations, type BenchmarkErrorResult, type BenchmarkOptions, BenchmarkProfiler, type BenchmarkProfilerOptions, type BenchmarkResult, BenchmarkSnapshots, type BenchmarkSnapshotsOptions, type BenchmarkStats, type BenchmarkSuccessResult, BootContext, BootListener, BootSignal, BootSignalType, BootValidator, CLICommand, type CLICommandAction, type CLICommandOption, type CLICommandOptions, type CLICommandPreload, type CLICommandSource, CacheConnector, type CacheMiddlewareOptions, CachedRepositoryOptions, type CapturedMail, CascadeAdapter, CascadeQueryBuilder, CastOutput, ChunkCallback, ClosableServer, CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, type CommandActionData, type ConcurrencyLimitOptions, ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry, ConfigSpecialHandlers, ConflictError, Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, ConsoleChannel, ContainerTypes, CookieJarUnavailableError, CookieOptions, CspConfig, CsrfOriginCheckReason, CsrfOriginVerdict, CursorPaginationOptions, CursorPaginationResult, DEFAULT_CSP_DIRECTIVES, DOSpacesDriver, DatabaseCacheDriver, type DatabaseCacheOptions, DatabaseConnector, DatabaseLog, DatabaseLogModel, DatabaseLogOptions, DecodedAccessToken, DefineResourceOptions, DeleteManyResult, DetectedImageFormat, type DevelopmentModelModuleEntry, type DevelopmentModelModuleState, type DevelopmentModelModules, EncryptionConfigurations, EncryptionPasswordConfigurations, Environment, EventSubscription, ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FastifyInstance, FieldOutput, FileNamingStrategy, FileValidationOptions, FileValidator, FileVisibility, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, ForbiddenError, GenerateImageVariantsOptions, GeneratedImageDescriptor, GeneratedImageVariant, GroupByFields, GroupedRoutesOptions, HealthCheck, HealthStatus, HeraldConnector, HttpConfigurations, HttpConnector, HttpContext, HttpError, HttpErrorCodes, HttpReadyReport, HttpServerRebuiltListener, HttpTracingConfig, type IdempotencyOptions, Image, ImageFormat, ImageInput, ImageTransformCallback, ImageTransformConfig, ImageTransformOptions, ImageVariantDefinition, ImageVariantFit, ImageVariantOutputFormat, ImageVariantsConfigError, InvalidCspDirectiveError, type IpFilterOptions, ListOptions, LocalDriver, LocalStorageDriverOptions, LocaleDictionaryEntries, LocaleDictionaryError, LocalizedObject, LogConfigurations, LoggerConnector, MAIL_EVENTS, Mail, type MailAddress, type MailAttachment, type MailConfigurations, MailError, type MailErrorCode, type MailEvents, type MailMode, type MailOptions, type MailPriority, type MailResult, MailerConnector, type MailersConfig, type MaintenanceOptions, Middleware, MiddlewareResponse, MimeTypes, ModelResourceRegistry, NamedApiRoute, NamedApiRoutesOptions, NoopChannel, type NormalizedMail, NotAcceptableError, NotAllowedError, NotificationsConnector, OPENAPI_JSON_SCHEMA_DIALECT, OpenApiBuildResult, OpenApiComponents, OpenApiContext, OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiRequestBody, OpenApiResponse, OpenApiRouteInput, OpenApiSchema, OpenApiSecurityRequirement, OpenApiSecurityScheme, OpenApiValidationResponseConfig, PaginationMode, PaginationResult, ParsedLocaleDictionary, PartialMiddleware, PartialPick, Path, PipeableReactStream, PipelineOptions, PortInUseError, PositionalHandlerSuspect, PrefixConfig, PrefixOptions, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, QueryBuilderContract, Queue, R2Driver, R2StorageDriverOptions, type RateLimitOptions, RegisterConfiguredConnectorsOptions, RegisterResource, RegisteredUseCase, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryManager, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, Request, RequestContextStore, RequestController, RequestControllerContract, RequestEvent, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestLocals, RequestLog, RequestMethod, RequestTranslator, type ResolvedCLICommandOption, ResolvedImageVariantsConfig, Resource, ResourceArraySchema, ResourceCastType, ResourceConstructor, ResourceContract, ResourceFieldBuilder, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceMethod, ResourceNotFoundError, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, Response, ResponseBodyOutput, ResponseBodyValue, ResponseEvent, ResponseSSEController, ResponseSchema, ResponseSchemaOutput, ResponseStatus, ResponseStreamController, Restful, RestfulMiddleware, ReturnedResponse, Route, RouteOptions, RouteRegistry, RouteResource, Router, RouterGroupCallback, RouterStacks, RuntimeStrategy, S3Driver, type SESConfigurations, type SMTPConfigurations, SafeFetchOptions, SafeFetchResult, SaveAsOptions, SaveMode, SaveOptions, ScopedStorage, ScopedStorageContract, SeedClock, SeedContext, SeedRecordRef, SeedResult, Seeder, SeederDependencyCycleError, SeederMetadata, SendBufferOptions, SendFileOptions, Serialized, SerializedWire, ServerError, ShutdownListener, SocketAdapterFactory, SocketConnector, SocketOptions, Storage, StorageCapabilityError, StorageConfigurations, StorageConnector, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageError, StorageErrorOptions, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StorageNotInitializedError, StoragePutEventPayload, StreamReactResponseOptions, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, TracingContext, TracingContextSource, TracingHooks, TracingPhaseInfo, TracingRequestEndInfo, Track, TrackableModel, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, UnAuthorizedError, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, UnknownSeederDependencyError, UploadedFile, UploadedFileImageOptions, UploadedFileJson, UploadedFileQuery, UploadsConfigurations, UploadsImagesConfigurations, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, ValidationConfiguration, VariantOutputFormat, VariantSourceFormat, WarlockConfig, WarlockConfigManager, WarningSink, WatermarkConfig, WhereOperator, XMLable, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildOpenApiDocument, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getDevelopmentOpenApiDocument, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, onHttpServerRebuilt, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerConfiguredConnectors, registerDevelopmentOpenApiProvider, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveMailConfig, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
 import "./config/types.mjs";
 import "./http/request.mjs";
+import "./http/serialized.mjs";
 import "./http/types.mjs";
 import "./storage/types.mjs";
 import "./validation/types.mjs";

package/esm/index.mjs

@@ -150,6 +150,9 @@ import "./encryption/index.mjs";
 import { LocaleDictionaryError, parseLocaleDictionary } from "./localization/parse-locale-dictionary.mjs";
 import { registerGroupedTranslationKeys, registerLocaleDictionary, unregisterLocaleDictionary } from "./localization/register-locale-dictionary.mjs";
 import "./localization/index.mjs";
+import { getDevelopmentOpenApiDocument, registerDevelopmentOpenApiProvider } from "./openapi/development-openapi-provider.mjs";
+import { OPENAPI_JSON_SCHEMA_DIALECT, buildOpenApiDocument } from "./openapi/build-openapi-document.mjs";
+import "./openapi/index.mjs";
 import { CascadeQueryBuilder } from "./repositories/adapters/cascade/cascade-query-builder.mjs";
 import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./repositories/adapters/cascade/cascade-adapter.mjs";
 import { RepositoryManager } from "./repositories/repository.manager.mjs";
@@ -178,4 +181,4 @@ import { colors } from "@mongez/copper";
 
 export * from "@mongez/localization"
 
-export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AiConnector, Application, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseConnector, BenchmarkProfiler, BenchmarkSnapshots, CLICommand, CacheConnector, CascadeAdapter, CascadeQueryBuilder, CloudDriver, ConfigSpecialHandlers, ConflictError, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, ConsoleChannel, CookieJarUnavailableError, DEFAULT_CSP_DIRECTIVES, DOSpacesDriver, DatabaseCacheDriver, DatabaseConnector, DatabaseLog, DatabaseLogModel, FileValidator, ForbiddenError, HeraldConnector, HttpConnector, HttpError, HttpErrorCodes, Image, ImageVariantsConfigError, InvalidCspDirectiveError, LocalDriver, LocaleDictionaryError, LoggerConnector, MAIL_EVENTS, Mail, MailError, MailerConnector, MimeTypes, NoopChannel, NotAcceptableError, NotAllowedError, NotificationsConnector, Path, PortInUseError, Queue, R2Driver, RegisterResource, RepositoryManager, Request, RequestController, RequestLog, Resource, ResourceFieldBuilder, ResourceNotFoundError, Response, ResponseStatus, Restful, RouteRegistry, Router, S3Driver, ScopedStorage, SeederDependencyCycleError, ServerError, SocketConnector, Storage, StorageCapabilityError, StorageConnector, StorageError, StorageFile, StorageNotInitializedError, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, UnAuthorizedError, UnknownSeederDependencyError, UploadedFile, WarlockConfigManager, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, onHttpServerRebuilt, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerConfiguredConnectors, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveMailConfig, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
+export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AiConnector, Application, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseConnector, BenchmarkProfiler, BenchmarkSnapshots, CLICommand, CacheConnector, CascadeAdapter, CascadeQueryBuilder, CloudDriver, ConfigSpecialHandlers, ConflictError, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, ConsoleChannel, CookieJarUnavailableError, DEFAULT_CSP_DIRECTIVES, DOSpacesDriver, DatabaseCacheDriver, DatabaseConnector, DatabaseLog, DatabaseLogModel, FileValidator, ForbiddenError, HeraldConnector, HttpConnector, HttpError, HttpErrorCodes, Image, ImageVariantsConfigError, InvalidCspDirectiveError, LocalDriver, LocaleDictionaryError, LoggerConnector, MAIL_EVENTS, Mail, MailError, MailerConnector, MimeTypes, NoopChannel, NotAcceptableError, NotAllowedError, NotificationsConnector, OPENAPI_JSON_SCHEMA_DIALECT, Path, PortInUseError, Queue, R2Driver, RegisterResource, RepositoryManager, Request, RequestController, RequestLog, Resource, ResourceFieldBuilder, ResourceNotFoundError, Response, ResponseStatus, Restful, RouteRegistry, Router, S3Driver, ScopedStorage, SeederDependencyCycleError, ServerError, SocketConnector, Storage, StorageCapabilityError, StorageConnector, StorageError, StorageFile, StorageNotInitializedError, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, UnAuthorizedError, UnknownSeederDependencyError, UploadedFile, WarlockConfigManager, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildOpenApiDocument, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getDevelopmentOpenApiDocument, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, onHttpServerRebuilt, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerConfiguredConnectors, registerDevelopmentOpenApiProvider, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveMailConfig, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };

package/esm/openapi/build-openapi-document.d.mts

@@ -0,0 +1,17 @@
+import { OpenApiBuildResult, OpenApiContext, OpenApiRouteInput } from "./types.mjs";
+
+//#region ../core/src/openapi/build-openapi-document.d.ts
+/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */
+declare const OPENAPI_JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/**
+ * Build an OpenAPI 3.1 document from registered routes.
+ *
+ * Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas
+ * with `toJsonSchema("draft-2020-12")` and returns plain JSON plus the gaps it found as
+ * `warnings`. It never throws for a single route it cannot document; that route is
+ * documented as far as possible and a warning explains what was left out.
+ */
+declare function buildOpenApiDocument(routes: readonly OpenApiRouteInput[], context: OpenApiContext): OpenApiBuildResult;
+//#endregion
+export { OPENAPI_JSON_SCHEMA_DIALECT, buildOpenApiDocument };
+//# sourceMappingURL=build-openapi-document.d.mts.map

package/esm/openapi/build-openapi-document.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-openapi-document.d.mts","names":[],"sources":["../../../../../../../core/src/openapi/build-openapi-document.ts"],"mappings":";;;;cA2Ba,2BAAA;AAAb;;;;AAAwC;AA8BxC;;;AA9BA,iBA8BgB,oBAAA,CACd,MAAA,WAAiB,iBAAA,IACjB,OAAA,EAAS,cAAA,GACR,kBAAA"}

package/esm/openapi/build-openapi-document.mjs

@@ -0,0 +1,124 @@
+import { buildDeclaredResponses } from "./response-schemas.mjs";
+import { buildUnauthorizedResponse, buildValidationFailedResponse, resolveValidationResponse } from "./error-responses.mjs";
+import { buildOperationId, expandMethods, firstSegmentTag, toOpenApiPath } from "./paths.mjs";
+import { buildRequestParts } from "./request-schemas.mjs";
+import { SchemaRegistry } from "./schema-registry.mjs";
+import { SecuritySchemes, readRouteAuth } from "./security.mjs";
+
+//#region ../core/src/openapi/build-openapi-document.ts
+/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */
+const OPENAPI_JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+const UNSAFE_METHODS = [
+	"post",
+	"put",
+	"patch",
+	"delete"
+];
+function describeAuth(auth, method) {
+	const lines = [];
+	if (auth.userTypes.length > 0) lines.push(`Requires an authenticated user of type: ${auth.userTypes.join(", ")}.`);
+	if (auth.sources.some((source) => typeof source !== "string") && UNSAFE_METHODS.includes(method)) lines.push("When authenticating with the cookie, the request must also carry a same-origin Origin or Referer header (CSRF guard).");
+	return lines;
+}
+/**
+* Build an OpenAPI 3.1 document from registered routes.
+*
+* Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas
+* with `toJsonSchema("draft-2020-12")` and returns plain JSON plus the gaps it found as
+* `warnings`. It never throws for a single route it cannot document; that route is
+* documented as far as possible and a warning explains what was left out.
+*/
+function buildOpenApiDocument(routes, context) {
+	const warnings = [];
+	const registry = new SchemaRegistry(context.resolveResourceName, (message) => warnings.push(message));
+	const security = new SecuritySchemes();
+	const validationShape = resolveValidationResponse(context.validationResponse);
+	const paths = {};
+	const tags = /* @__PURE__ */ new Set();
+	const operationIds = /* @__PURE__ */ new Set();
+	for (const route of routes) {
+		if (route.isPage && !context.includePages) continue;
+		const methods = expandMethods(route.method);
+		const label = `${String(route.method).toUpperCase()} ${route.path}`;
+		const warn = (message) => warnings.push(`${label}: ${message}`);
+		if (methods.length === 0) {
+			warn(`unsupported method "${String(route.method)}", route skipped.`);
+			continue;
+		}
+		const handler = route.handler;
+		const validation = handler?.validation;
+		const auth = readRouteAuth(route.middleware, warn);
+		const tag = firstSegmentTag(route.path);
+		const pathKey = toOpenApiPath(route.path);
+		if (validation?.validate) warn("validation.validate is custom middleware and is not documented.");
+		for (const method of methods) {
+			paths[pathKey] ??= {};
+			if (paths[pathKey][method]) {
+				warn(`${method.toUpperCase()} ${pathKey} is already documented by an earlier route; this one is skipped.`);
+				continue;
+			}
+			let operationId = buildOperationId(route.name, method, route.path, methods.length > 1);
+			if (operationIds.has(operationId)) {
+				let suffix = 2;
+				while (operationIds.has(`${operationId}_${suffix}`)) suffix++;
+				warn(`operationId "${operationId}" is already used; renamed to "${operationId}_${suffix}".`);
+				operationId = `${operationId}_${suffix}`;
+			}
+			operationIds.add(operationId);
+			const description = [route.description ?? handler?.description, ...auth ? describeAuth(auth, method) : []].filter((line) => typeof line === "string" && line.length > 0);
+			const request = buildRequestParts({
+				method,
+				path: route.path,
+				validation,
+				warn
+			});
+			const responses = route.isPage ? { "200": {
+				description: "HTML page",
+				content: { "text/html": { schema: { type: "string" } } }
+			} } : buildDeclaredResponses(handler?.responseSchema, registry, warn);
+			if (!Object.keys(responses).some((status) => status.startsWith("2"))) responses["200"] = { description: "Successful response" };
+			if (validation?.schema) {
+				const failed = buildValidationFailedResponse(validationShape, registry);
+				responses[failed.status] ??= failed.response;
+			}
+			if (auth) responses["401"] ??= buildUnauthorizedResponse(registry);
+			if (tag) tags.add(tag);
+			const operation = {
+				operationId,
+				...route.label ? { summary: route.label } : {},
+				...description.length > 0 ? { description: description.join("\n\n") } : {},
+				...tag ? { tags: [tag] } : {},
+				...request.parameters.length > 0 ? { parameters: request.parameters } : {},
+				...request.requestBody ? { requestBody: request.requestBody } : {},
+				responses: sortResponses(responses),
+				...auth ? { security: security.requirementsFor(auth) } : {}
+			};
+			paths[pathKey][method] = operation;
+		}
+	}
+	const document = {
+		openapi: "3.1.0",
+		jsonSchemaDialect: OPENAPI_JSON_SCHEMA_DIALECT,
+		info: { ...context.info },
+		...context.servers && context.servers.length > 0 ? { servers: context.servers.map((url) => ({ url })) } : {},
+		...tags.size > 0 ? { tags: [...tags].sort().map((name) => ({ name })) } : {},
+		paths
+	};
+	const hasSchemas = Object.keys(registry.schemas).length > 0;
+	if (hasSchemas || security.hasSchemes()) {
+		document.components = {};
+		if (hasSchemas) document.components.schemas = registry.schemas;
+		if (security.hasSchemes()) document.components.securitySchemes = security.schemes;
+	}
+	return {
+		document,
+		warnings: [...new Set(warnings)]
+	};
+}
+function sortResponses(responses) {
+	return Object.fromEntries(Object.entries(responses).sort(([first], [second]) => first.localeCompare(second)));
+}
+
+//#endregion
+export { OPENAPI_JSON_SCHEMA_DIALECT, buildOpenApiDocument };
+//# sourceMappingURL=build-openapi-document.mjs.map

package/esm/openapi/build-openapi-document.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-openapi-document.mjs","names":[],"sources":["../../../../../../../core/src/openapi/build-openapi-document.ts"],"sourcesContent":["import {\n  buildUnauthorizedResponse,\n  buildValidationFailedResponse,\n  resolveValidationResponse,\n} from \"./error-responses\";\nimport {\n  buildOperationId,\n  expandMethods,\n  firstSegmentTag,\n  toOpenApiPath,\n  type OpenApiMethod,\n} from \"./paths\";\nimport { buildRequestParts } from \"./request-schemas\";\nimport { buildDeclaredResponses } from \"./response-schemas\";\nimport { SchemaRegistry } from \"./schema-registry\";\nimport { readRouteAuth, SecuritySchemes } from \"./security\";\nimport type {\n  AuthDescriptor,\n  OpenApiBuildResult,\n  OpenApiContext,\n  OpenApiDocument,\n  OpenApiOperation,\n  OpenApiResponse,\n  OpenApiRouteInput,\n} from \"./types\";\n\n/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */\nexport const OPENAPI_JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\n\nconst UNSAFE_METHODS: readonly OpenApiMethod[] = [\"post\", \"put\", \"patch\", \"delete\"];\n\nfunction describeAuth(auth: AuthDescriptor, method: OpenApiMethod): string[] {\n  const lines: string[] = [];\n\n  if (auth.userTypes.length > 0) {\n    lines.push(`Requires an authenticated user of type: ${auth.userTypes.join(\", \")}.`);\n  }\n\n  const usesCookie = auth.sources.some((source) => typeof source !== \"string\");\n\n  if (usesCookie && UNSAFE_METHODS.includes(method)) {\n    lines.push(\n      \"When authenticating with the cookie, the request must also carry a same-origin Origin or Referer header (CSRF guard).\",\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Build an OpenAPI 3.1 document from registered routes.\n *\n * Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas\n * with `toJsonSchema(\"draft-2020-12\")` and returns plain JSON plus the gaps it found as\n * `warnings`. It never throws for a single route it cannot document; that route is\n * documented as far as possible and a warning explains what was left out.\n */\nexport function buildOpenApiDocument(\n  routes: readonly OpenApiRouteInput[],\n  context: OpenApiContext,\n): OpenApiBuildResult {\n  const warnings: string[] = [];\n  const registry = new SchemaRegistry(context.resolveResourceName, (message) => warnings.push(message));\n  const security = new SecuritySchemes();\n  const validationShape = resolveValidationResponse(context.validationResponse);\n  const paths: OpenApiDocument[\"paths\"] = {};\n  const tags = new Set<string>();\n  const operationIds = new Set<string>();\n\n  for (const route of routes) {\n    if (route.isPage && !context.includePages) {\n      continue;\n    }\n\n    const methods = expandMethods(route.method);\n    const label = `${String(route.method).toUpperCase()} ${route.path}`;\n    const warn = (message: string) => warnings.push(`${label}: ${message}`);\n\n    if (methods.length === 0) {\n      warn(`unsupported method \"${String(route.method)}\", route skipped.`);\n\n      continue;\n    }\n\n    const handler = route.handler as OpenApiRouteInput[\"handler\"] | undefined;\n    const validation = handler?.validation;\n    const auth = readRouteAuth(route.middleware, warn);\n    const tag = firstSegmentTag(route.path);\n    const pathKey = toOpenApiPath(route.path);\n\n    if (validation?.validate) {\n      warn(\"validation.validate is custom middleware and is not documented.\");\n    }\n\n    for (const method of methods) {\n      paths[pathKey] ??= {};\n\n      if (paths[pathKey][method]) {\n        warn(`${method.toUpperCase()} ${pathKey} is already documented by an earlier route; this one is skipped.`);\n\n        continue;\n      }\n\n      let operationId = buildOperationId(route.name, method, route.path, methods.length > 1);\n\n      if (operationIds.has(operationId)) {\n        let suffix = 2;\n\n        while (operationIds.has(`${operationId}_${suffix}`)) {\n          suffix++;\n        }\n\n        warn(`operationId \"${operationId}\" is already used; renamed to \"${operationId}_${suffix}\".`);\n        operationId = `${operationId}_${suffix}`;\n      }\n\n      operationIds.add(operationId);\n\n      const description = [\n        route.description ?? handler?.description,\n        ...(auth ? describeAuth(auth, method) : []),\n      ].filter((line): line is string => typeof line === \"string\" && line.length > 0);\n\n      const request = buildRequestParts({ method, path: route.path, validation, warn });\n\n      const responses: Record<string, OpenApiResponse> = route.isPage\n        ? { \"200\": { description: \"HTML page\", content: { \"text/html\": { schema: { type: \"string\" } } } } }\n        : buildDeclaredResponses(handler?.responseSchema, registry, warn);\n\n      if (!Object.keys(responses).some((status) => status.startsWith(\"2\"))) {\n        responses[\"200\"] = { description: \"Successful response\" };\n      }\n\n      if (validation?.schema) {\n        const failed = buildValidationFailedResponse(validationShape, registry);\n\n        responses[failed.status] ??= failed.response;\n      }\n\n      if (auth) {\n        responses[\"401\"] ??= buildUnauthorizedResponse(registry);\n      }\n\n      if (tag) {\n        tags.add(tag);\n      }\n\n      // Built in reading order: identity, prose, inputs, outputs, security.\n      const operation: OpenApiOperation = {\n        operationId,\n        ...(route.label ? { summary: route.label } : {}),\n        ...(description.length > 0 ? { description: description.join(\"\\n\\n\") } : {}),\n        ...(tag ? { tags: [tag] } : {}),\n        ...(request.parameters.length > 0 ? { parameters: request.parameters } : {}),\n        ...(request.requestBody ? { requestBody: request.requestBody } : {}),\n        responses: sortResponses(responses),\n        ...(auth ? { security: security.requirementsFor(auth) } : {}),\n      };\n\n      paths[pathKey][method] = operation;\n    }\n  }\n\n  // Keys in reading order: header, servers, tags, paths, components.\n  const document: OpenApiDocument = {\n    openapi: \"3.1.0\",\n    jsonSchemaDialect: OPENAPI_JSON_SCHEMA_DIALECT,\n    info: { ...context.info },\n    ...(context.servers && context.servers.length > 0\n      ? { servers: context.servers.map((url) => ({ url })) }\n      : {}),\n    ...(tags.size > 0 ? { tags: [...tags].sort().map((name) => ({ name })) } : {}),\n    paths,\n  };\n\n  const hasSchemas = Object.keys(registry.schemas).length > 0;\n\n  if (hasSchemas || security.hasSchemes()) {\n    document.components = {};\n\n    if (hasSchemas) {\n      document.components.schemas = registry.schemas;\n    }\n\n    if (security.hasSchemes()) {\n      document.components.securitySchemes = security.schemes;\n    }\n  }\n\n  return { document, warnings: [...new Set(warnings)] };\n}\n\nfunction sortResponses(responses: Record<string, OpenApiResponse>): Record<string, OpenApiResponse> {\n  return Object.fromEntries(\n    Object.entries(responses).sort(([first], [second]) => first.localeCompare(second)),\n  );\n}\n"],"mappings":"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"}

package/esm/openapi/cast-schema.mjs

@@ -0,0 +1,89 @@
+//#region ../core/src/openapi/cast-schema.ts
+/**
+* JSON Schema of the DEFAULT date output of a resource field (`iso`, `format`, `timestamp`
+* and `humanTime` on; `timezone`, `locale` and `offset` off), matching `BaseCastOutput<"date">`.
+*/
+const DEFAULT_DATE_SCHEMA = {
+	type: "object",
+	properties: {
+		iso: {
+			type: "string",
+			format: "date-time"
+		},
+		format: { type: "string" },
+		timestamp: { type: "number" },
+		humanTime: { type: "string" }
+	},
+	required: [
+		"iso",
+		"format",
+		"timestamp",
+		"humanTime"
+	]
+};
+function baseCastSchema(base) {
+	switch (base) {
+		case "string":
+		case "localized": return { type: "string" };
+		case "url":
+		case "uploadsUrl":
+		case "storageUrl": return {
+			type: "string",
+			format: "uri"
+		};
+		case "number":
+		case "float": return { type: "number" };
+		case "int": return { type: "integer" };
+		case "boolean": return { type: "boolean" };
+		case "object": return { type: "object" };
+		case "array": return { type: "array" };
+		case "date": return structuredClone(DEFAULT_DATE_SCHEMA);
+		default: return;
+	}
+}
+/**
+* Make a schema accept `null` too, the 3.1 way: `type: [T, "null"]`. A schema without a plain
+* `type` (a `$ref`, `{}`) is wrapped in `anyOf` with `{ type: "null" }`.
+*/
+function makeNullable(schema) {
+	if (typeof schema.type === "string") return {
+		...schema,
+		type: [schema.type, "null"]
+	};
+	if (Array.isArray(schema.type)) return schema.type.includes("null") ? schema : {
+		...schema,
+		type: [...schema.type, "null"]
+	};
+	return { anyOf: [schema, { type: "null" }] };
+}
+/**
+* JSON Schema of a resource cast string, suffixes included (`"string"`, `"number?"`,
+* `"string[]"`, `"date[]?"`). `?` means "always present, value or null"; `[]` wraps the base
+* in an array, and with `?` it is the array that may be null.
+*
+* @returns `undefined` for a cast this mapper does not know.
+*/
+function castToJsonSchema(cast) {
+	let base = cast;
+	let nullable = false;
+	let isArray = false;
+	if (base.endsWith("?")) {
+		nullable = true;
+		base = base.slice(0, -1);
+	}
+	if (base.endsWith("[]")) {
+		isArray = true;
+		base = base.slice(0, -2);
+	}
+	const baseSchema = baseCastSchema(base);
+	if (!baseSchema) return;
+	const shaped = isArray ? {
+		type: "array",
+		items: baseSchema
+	} : baseSchema;
+	return nullable ? makeNullable(shaped) : shaped;
+}
+
+//#endregion
+export { castToJsonSchema };
+//# sourceMappingURL=cast-schema.mjs.map

package/esm/openapi/cast-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast-schema.mjs","names":[],"sources":["../../../../../../../core/src/openapi/cast-schema.ts"],"sourcesContent":["import type { OpenApiSchema } from \"./types\";\n\n/**\n * JSON Schema of the DEFAULT date output of a resource field (`iso`, `format`, `timestamp`\n * and `humanTime` on; `timezone`, `locale` and `offset` off), matching `BaseCastOutput<\"date\">`.\n */\nconst DEFAULT_DATE_SCHEMA: OpenApiSchema = {\n  type: \"object\",\n  properties: {\n    iso: { type: \"string\", format: \"date-time\" },\n    format: { type: \"string\" },\n    timestamp: { type: \"number\" },\n    humanTime: { type: \"string\" },\n  },\n  required: [\"iso\", \"format\", \"timestamp\", \"humanTime\"],\n};\n\nfunction baseCastSchema(base: string): OpenApiSchema | undefined {\n  switch (base) {\n    case \"string\":\n    case \"localized\":\n      return { type: \"string\" };\n    case \"url\":\n    case \"uploadsUrl\":\n    case \"storageUrl\":\n      return { type: \"string\", format: \"uri\" };\n    case \"number\":\n    case \"float\":\n      return { type: \"number\" };\n    case \"int\":\n      return { type: \"integer\" };\n    case \"boolean\":\n      return { type: \"boolean\" };\n    case \"object\":\n      return { type: \"object\" };\n    case \"array\":\n      return { type: \"array\" };\n    case \"date\":\n      return structuredClone(DEFAULT_DATE_SCHEMA);\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Make a schema accept `null` too, the 3.1 way: `type: [T, \"null\"]`. A schema without a plain\n * `type` (a `$ref`, `{}`) is wrapped in `anyOf` with `{ type: \"null\" }`.\n */\nexport function makeNullable(schema: OpenApiSchema): OpenApiSchema {\n  if (typeof schema.type === \"string\") {\n    return { ...schema, type: [schema.type, \"null\"] };\n  }\n\n  if (Array.isArray(schema.type)) {\n    return schema.type.includes(\"null\") ? schema : { ...schema, type: [...schema.type, \"null\"] };\n  }\n\n  return { anyOf: [schema, { type: \"null\" }] };\n}\n\n/**\n * JSON Schema of a resource cast string, suffixes included (`\"string\"`, `\"number?\"`,\n * `\"string[]\"`, `\"date[]?\"`). `?` means \"always present, value or null\"; `[]` wraps the base\n * in an array, and with `?` it is the array that may be null.\n *\n * @returns `undefined` for a cast this mapper does not know.\n */\nexport function castToJsonSchema(cast: string): OpenApiSchema | undefined {\n  let base = cast;\n  let nullable = false;\n  let isArray = false;\n\n  if (base.endsWith(\"?\")) {\n    nullable = true;\n    base = base.slice(0, -1);\n  }\n\n  if (base.endsWith(\"[]\")) {\n    isArray = true;\n    base = base.slice(0, -2);\n  }\n\n  const baseSchema = baseCastSchema(base);\n\n  if (!baseSchema) {\n    return undefined;\n  }\n\n  const shaped: OpenApiSchema = isArray ? { type: \"array\", items: baseSchema } : baseSchema;\n\n  return nullable ? makeNullable(shaped) : shaped;\n}\n"],"mappings":";;;;;AAMA,MAAM,sBAAqC;CACzC,MAAM;CACN,YAAY;EACV,KAAK;GAAE,MAAM;GAAU,QAAQ;EAAY;EAC3C,QAAQ,EAAE,MAAM,SAAS;EACzB,WAAW,EAAE,MAAM,SAAS;EAC5B,WAAW,EAAE,MAAM,SAAS;CAC9B;CACA,UAAU;EAAC;EAAO;EAAU;EAAa;CAAW;AACtD;AAEA,SAAS,eAAe,MAAyC;CAC/D,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,aACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK;EACL,KAAK;EACL,KAAK,cACH,OAAO;GAAE,MAAM;GAAU,QAAQ;EAAM;EACzC,KAAK;EACL,KAAK,SACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK,OACH,OAAO,EAAE,MAAM,UAAU;EAC3B,KAAK,WACH,OAAO,EAAE,MAAM,UAAU;EAC3B,KAAK,UACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK,SACH,OAAO,EAAE,MAAM,QAAQ;EACzB,KAAK,QACH,OAAO,gBAAgB,mBAAmB;EAC5C,SACE;CACJ;AACF;;;;;AAMA,SAAgB,aAAa,QAAsC;CACjE,IAAI,OAAO,OAAO,SAAS,UACzB,OAAO;EAAE,GAAG;EAAQ,MAAM,CAAC,OAAO,MAAM,MAAM;CAAE;CAGlD,IAAI,MAAM,QAAQ,OAAO,IAAI,GAC3B,OAAO,OAAO,KAAK,SAAS,MAAM,IAAI,SAAS;EAAE,GAAG;EAAQ,MAAM,CAAC,GAAG,OAAO,MAAM,MAAM;CAAE;CAG7F,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,EAAE;AAC7C;;;;;;;;AASA,SAAgB,iBAAiB,MAAyC;CACxE,IAAI,OAAO;CACX,IAAI,WAAW;CACf,IAAI,UAAU;CAEd,IAAI,KAAK,SAAS,GAAG,GAAG;EACtB,WAAW;EACX,OAAO,KAAK,MAAM,GAAG,EAAE;CACzB;CAEA,IAAI,KAAK,SAAS,IAAI,GAAG;EACvB,UAAU;EACV,OAAO,KAAK,MAAM,GAAG,EAAE;CACzB;CAEA,MAAM,aAAa,eAAe,IAAI;CAEtC,IAAI,CAAC,YACH;CAGF,MAAM,SAAwB,UAAU;EAAE,MAAM;EAAS,OAAO;CAAW,IAAI;CAE/E,OAAO,WAAW,aAAa,MAAM,IAAI;AAC3C"}

package/esm/openapi/collect-openapi-document.mjs

@@ -0,0 +1,40 @@
+import { runRegistrationChild } from "../production/registration-child-runner.mjs";
+import { OPENAPI_RESULT_MESSAGE, parseOpenApiChildResult } from "./openapi-protocol.mjs";
+
+//#region ../core/src/openapi/collect-openapi-document.ts
+/**
+* Build the app's OpenAPI document in a fresh process.
+*
+* Uses the same registration child as `warlock build` (it imports the route modules without
+* booting connectors) in OpenAPI mode: the document is built inside the child, where the Seal
+* schemas and resource classes live, and only the finished JSON crosses IPC.
+*/
+function collectOpenApiDocument(options = {}) {
+	const cwd = options.cwd ?? process.cwd();
+	const openapi = {
+		version: 1,
+		...options.title !== void 0 ? { title: options.title } : {},
+		...options.server !== void 0 ? { server: options.server } : {},
+		...options.includePages !== void 0 ? { includePages: options.includePages } : {}
+	};
+	return runRegistrationChild({
+		cwd,
+		timeoutMs: options.timeoutMs,
+		childEntry: options.childEntry,
+		forkProcess: options.forkProcess,
+		request: {
+			version: 1,
+			cwd,
+			environment: options.environment,
+			runtimeStrategy: options.runtimeStrategy,
+			openapi
+		},
+		resultMessageType: OPENAPI_RESULT_MESSAGE,
+		resultNoun: "document",
+		readResult: (message) => parseOpenApiChildResult(message.result)
+	});
+}
+
+//#endregion
+export { collectOpenApiDocument };
+//# sourceMappingURL=collect-openapi-document.mjs.map

package/esm/openapi/collect-openapi-document.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-openapi-document.mjs","names":[],"sources":["../../../../../../../core/src/openapi/collect-openapi-document.ts"],"sourcesContent":["import {\n  runRegistrationChild,\n  type RegistrationChildForker,\n} from \"../production/registration-child-runner\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport {\n  OPENAPI_PROTOCOL_VERSION,\n  OPENAPI_RESULT_MESSAGE,\n  parseOpenApiChildResult,\n  type OpenApiChildRequestOptions,\n  type OpenApiChildResult,\n} from \"./openapi-protocol\";\n\nexport type CollectOpenApiDocumentOptions = Readonly<{\n  cwd?: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  timeoutMs?: number;\n  childEntry?: string;\n  forkProcess?: RegistrationChildForker;\n  title?: string;\n  server?: string;\n  includePages?: boolean;\n}>;\n\n/**\n * Build the app's OpenAPI document in a fresh process.\n *\n * Uses the same registration child as `warlock build` (it imports the route modules without\n * booting connectors) in OpenAPI mode: the document is built inside the child, where the Seal\n * schemas and resource classes live, and only the finished JSON crosses IPC.\n */\nexport function collectOpenApiDocument(\n  options: CollectOpenApiDocumentOptions = {},\n): Promise<OpenApiChildResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const openapi: OpenApiChildRequestOptions = {\n    version: OPENAPI_PROTOCOL_VERSION,\n    ...(options.title !== undefined ? { title: options.title } : {}),\n    ...(options.server !== undefined ? { server: options.server } : {}),\n    ...(options.includePages !== undefined ? { includePages: options.includePages } : {}),\n  };\n\n  return runRegistrationChild<OpenApiChildResult>({\n    cwd,\n    timeoutMs: options.timeoutMs,\n    childEntry: options.childEntry,\n    forkProcess: options.forkProcess,\n    request: {\n      version: 1,\n      cwd,\n      environment: options.environment,\n      runtimeStrategy: options.runtimeStrategy,\n      openapi,\n    },\n    resultMessageType: OPENAPI_RESULT_MESSAGE,\n    resultNoun: \"document\",\n    readResult: (message) => parseOpenApiChildResult(message.result),\n  });\n}\n"],"mappings":";;;;;;;;;;;AAgCA,SAAgB,uBACd,UAAyC,CAAC,GACb;CAC7B,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,UAAsC;EAC1C;EACA,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EAC9D,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;EACjE,GAAI,QAAQ,iBAAiB,SAAY,EAAE,cAAc,QAAQ,aAAa,IAAI,CAAC;CACrF;CAEA,OAAO,qBAAyC;EAC9C;EACA,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,aAAa,QAAQ;EACrB,SAAS;GACP,SAAS;GACT;GACA,aAAa,QAAQ;GACrB,iBAAiB,QAAQ;GACzB;EACF;EACA,mBAAmB;EACnB,YAAY;EACZ,aAAa,YAAY,wBAAwB,QAAQ,MAAM;CACjE,CAAC;AACH"}

package/esm/openapi/development-openapi-provider.d.mts

@@ -0,0 +1,17 @@
+import { OpenApiBuildResult } from "./types.mjs";
+
+//#region ../core/src/openapi/development-openapi-provider.d.ts
+type DevelopmentOpenApiProvider = () => Promise<OpenApiBuildResult>;
+/**
+ * Called by the dev server at startup. The builder lives under `dev-server/`, so the
+ * production entry never reaches it; this registry is the only thing the root exports.
+ */
+declare function registerDevelopmentOpenApiProvider(build: DevelopmentOpenApiProvider): void;
+/**
+ * The OpenAPI document for the routes registered in this process, built by the dev
+ * server's provider. Throws outside `warlock dev`, where no provider is registered.
+ */
+declare function getDevelopmentOpenApiDocument(): Promise<OpenApiBuildResult>;
+//#endregion
+export { getDevelopmentOpenApiDocument, registerDevelopmentOpenApiProvider };
+//# sourceMappingURL=development-openapi-provider.d.mts.map

package/esm/openapi/development-openapi-provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-openapi-provider.d.mts","names":[],"sources":["../../../../../../../core/src/openapi/development-openapi-provider.ts"],"mappings":";;;KAEK,0BAAA,SAAmC,OAAO,CAAC,kBAAA;;AAFE;;;iBAUlC,kCAAA,CAAmC,KAAiC,EAA1B,0BAA0B;AARlB;AAQlE;;;AARkE,iBAgB5C,6BAAA,IAAiC,OAAO,CAAC,kBAAA"}