@zerotal/core 1.8.1 → 1.10.0

package/api-surface.md

@@ -394,6 +394,7 @@ class LimiterDefinition = {
   register: () => LimiterDefinition
   toMiddleware: () => ThrottleMiddleware
   toMiddlewareClass: () => new () => ThrottleMiddleware
+  trustedProxies: (count: number) => LimiterDefinition
 }
 
 class MarkdownBuilder = {
@@ -512,20 +513,6 @@ class ResponseBuilder = {
   withWarning: (message: string) => ResponseBuilder
 }
 
-class RouterState = {
-  new (): RouterState
-  domain: string | undefined
-  groupMiddleware: MiddlewareClass[]
-  implicitModelResolver: ((paramName: string) => ModelBindingResolver | undefined) | null
-  markdownDirs: MarkdownDir[]
-  middlewareGroups: Map<string, MiddlewareClass[]>
-  namedRoutes: Map<string, string>
-  prefix: string
-  rawRoutes: Map<string, (req: Request) => Response | Promise<Response>>
-  routes: Map<string, RouteDefinition>
-  staticDirs: StaticDir[]
-}
-
 class ScopedResolver = {
   new (_container?: Container | undefined): ScopedResolver
   acquire: () => void
@@ -576,13 +563,6 @@ class ServiceUnavailableError = {
   readonly status: number
 }
 
-class TerminalWriter = {
-  new (): TerminalWriter
-  write: (message: string) => void
-  writeError: (message: string) => void
-  writeLine: (message: string) => void
-}
-
 class ThrottleMiddleware = {
   new (options?: Partial<ThrottleOptions>): ThrottleMiddleware
   static with: <T extends new (...args: any[]) => BaseMiddleware<any>, Opts = T extends new (...args: any[]) => BaseMiddleware<infer U> ? U : object>(this: T, options: DeepPartial<NoInfer<Opts>>) => new () => InstanceType<T>
@@ -648,8 +628,6 @@ const App = {    readonly container: Container;    readonly instance: () => Appl
 
 const Artisan = {    call(commandName: string, parameters?: Record<string, string | boolean | number>): Promise<ArtisanResult>;}
 
-const builtinDoctorChecks = DoctorCheck[]
-
 const Config = ConfigManager
 
 const Events = Emitter
@@ -668,8 +646,6 @@ function app = {    (): Application;    <T>(token: BindingToken<T>): Promise<T>;
 
 function basePath = (...segments: string[]) => string
 
-function buildCookie = (options: CookieOptions) => string
-
 function camelCase = (value: string) => string
 
 function collect = <T>(items: T[]) => Collection<T>
@@ -708,10 +684,6 @@ function make = <T>(token: BindingToken<T>) => Promise<T>
 
 function markdown = (content: string, options?: BunMarkdownOptions & {    title?: string;}, status?: number) => MarkdownBuilder
 
-function pageElements = (current: number, last: number, each?: number) => (number | '...')[]
-
-function parseCookieHeader = (header: string, name: string) => string | undefined
-
 function pipe = <T, R>(value: T, fn: (val: T) => R) => R
 
 function pipeAsync = <T, R>(value: T, fn: (val: T) => Promise<R>) => Promise<R>
@@ -726,8 +698,6 @@ function redirectTo = <N extends RouteTarget>(name: N, params?: RouteParamsArg<N
 
 function registerErrorDiagnoser = (diagnoser: ErrorDiagnoser) => void
 
-function registerFileRouteResolver = (resolver: FileRouteResolver) => void
-
 function request = {    (): HttpContext;    <T = string>(key: string, fallback?: T): T | undefined;}
 
 function requireEnv = (key: string) => string
@@ -740,14 +710,8 @@ function runDoctor = (app: Application, extraChecks?: DoctorCheck[]) => Promise<
 
 function safeEqual = (a: string, b: string) => boolean
 
-function safeRedirectPath = (url: string | null | undefined, origin: string) => string | undefined
-
-function scanFileRoutes = (baseDir: string, reloadId?: string) => Promise<number>
-
 function setAppEnv = (command?: string) => void
 
-function setCurrentPageResolver = (resolver: CurrentPageResolver) => void
-
 function sha256Hex = (input: string | Uint8Array) => string
 
 function singularize = (value: string) => string
@@ -762,12 +726,8 @@ function tap = <T>(value: T, callback: (val: T) => void) => T
 
 function tapAsync = <T>(value: T, callback: (val: T) => Promise<void>) => Promise<T>
 
-function tryCurrentApp = () => Application | undefined
-
 function view = {    (markup: string | {        toString(): string;    }, status?: number): void;    <P extends Record<string, unknown> = Record<string, never>>(component: (ctx: HttpContext, props: P) => ViewMarkup | Promise<ViewMarkup>, props?: P, status?: number): void | Promise<void>;}
 
-function withApp = <T>(app: Application, fn: () => T) => T
-
 function withHeaders = (res: Response, headers: Record<string, string>) => Response
 
 interface ArtisanResult = {
@@ -777,18 +737,6 @@ interface ArtisanResult = {
 
 interface AuthenticatedUser = {}
 
-interface CompiledDomain = {
-  params: string[]
-  regex: RegExp
-  source: string
-}
-
-interface ConcernContext = {
-  app: Application
-  env: AppEnvironment
-  resolve: <T = unknown>(token: string) => T | undefined
-}
-
 interface ConcernDescriptor = {
   dir?: string
   envs?: AppEnvironment[]
@@ -860,31 +808,24 @@ interface ContainerBindings = {
   two_factor: TwoFactorService
 }
 
-interface ContextRegistry = {}
-
 interface CookieOptions = {
-  domain?: string
-  httpOnly?: boolean
-  maxAge?: number
+  domain?: string | undefined
+  httpOnly?: boolean | undefined
+  maxAge?: number | undefined
   name: string
-  path?: string
-  sameSite?: SameSite
-  secure?: boolean
+  path?: string | undefined
+  sameSite?: SameSite | undefined
+  secure?: boolean | undefined
   value: string
 }
 
 interface CorsOptions = {
-  allowedHeaders?: string[]
-  credentials?: boolean
-  exposedHeaders?: string[]
-  maxAge?: number
-  methods?: string[]
-  origin?: string | string[] | ((origin: string) => boolean)
-}
-
-interface DevConfigShape = {
-  disable?: string[]
-  processes?: DevProcessDefinition[]
+  allowedHeaders?: string[] | undefined
+  credentials?: boolean | undefined
+  exposedHeaders?: string[] | undefined
+  maxAge?: number | undefined
+  methods?: string[] | undefined
+  origin?: string | string[] | ((origin: string) => boolean) | undefined
 }
 
 interface DevProcessDefinition = {
@@ -929,28 +870,10 @@ interface ErrorDiagnosis = {
   title: string
 }
 
-interface FileRouteContext = {
-  filePath: string
-  isIndex: boolean
-  layout?: ViewComponent | undefined
-  middleware: MiddlewareClass[]
-  module: Record<string, unknown>
-  name: string
-  urlPath: string
-}
-
 interface GroupOptions = {
-  domain?: string
-  middleware?: string | string[] | MiddlewareClass | MiddlewareClass[]
-  prefix?: string
-}
-
-interface HasResponse = {
-  response: Response | undefined
-}
-
-interface MiddlewareModule = {
-  middleware: MiddlewareClass[]
+  domain?: string | undefined
+  middleware?: string | string[] | MiddlewareClass | MiddlewareClass[] | undefined
+  prefix?: string | undefined
 }
 
 interface ModelClass = {
@@ -973,28 +896,6 @@ interface ProviderReport = {
   name: string
 }
 
-interface QueuedListener = {
-  handle: (event: T) => Promise<void> | void
-  maxAttempts?: number
-  queue: string | boolean
-  retryDelay?: number
-}
-
-interface RequestIPProvider = {
-  requestIP: (req: Request) => {    address: string;    family: string;    port: number;} | null
-}
-
-interface ResolvedDevProcess = {
-  after: 'server' | 'none'
-  argv?: string[]
-  color: DevProcessColor
-  label: string
-  name: string
-  registrant: string
-  restart: 'always' | 'on-failure' | 'never'
-  run?: (signal: AbortSignal) => Promise<void>
-}
-
 interface RouteBuilder = {
   <N extends RouteTarget>(name: N, params?: RouteParamValues | undefined, query?: RouteQuery | undefined): string
   dynamic: (name: string, params?: RouteParamValues, query?: RouteQuery) => string
@@ -1011,34 +912,6 @@ interface RouteDefinition = {
   path: string
 }
 
-interface RouteFileMeta = {
-  DELETE?: {    name?: string;}
-  GET?: {    name?: string;}
-  PATCH?: {    name?: string;}
-  POST?: {    name?: string;}
-  PUT?: {    name?: string;}
-}
-
-interface RouteMethodMiddleware = {
-  ALL?: MiddlewareClass[]
-  DELETE?: MiddlewareClass[]
-  GET?: MiddlewareClass[]
-  PATCH?: MiddlewareClass[]
-  POST?: MiddlewareClass[]
-  PUT?: MiddlewareClass[]
-}
-
-interface RouteModule = {
-  DELETE?: FileHandler
-  GET?: FileHandler
-  PATCH?: FileHandler
-  POST?: FileHandler
-  PUT?: FileHandler
-  default?: ViewComponent | FileHandler
-  layout?: ViewComponent | null
-  middleware?: RouteMiddleware
-}
-
 interface RouteRegistration = {
   bind: (paramName: string, model: ModelClass | ModelBindingResolver) => RouteRegistration
   name: (routeName: string) => RouteRegistration
@@ -1053,25 +926,25 @@ interface RouterMacros = {
 }
 
 interface SecureHeadersOptions = {
-  contentSecurityPolicy?: string
-  frameOptions?: false | 'DENY' | 'SAMEORIGIN'
-  hstsIncludeSubDomains?: boolean
-  hstsMaxAge?: number
-  hstsPreload?: boolean
-  permissionsPolicy?: string | false
-  referrerPolicy?: string
-  secure?: boolean
+  contentSecurityPolicy?: string | undefined
+  frameOptions?: false | 'DENY' | 'SAMEORIGIN' | undefined
+  hstsIncludeSubDomains?: boolean | undefined
+  hstsMaxAge?: number | undefined
+  hstsPreload?: boolean | undefined
+  permissionsPolicy?: string | false | undefined
+  referrerPolicy?: string | undefined
+  secure?: boolean | undefined
 }
 
 interface StartZerotalOptions = {
-  configDir?: string
+  configDir?: string | undefined
 }
 
 interface ThrottleOptions = {
-  keyResolver?: (ctx: HttpContext) => string
+  keyResolver?: ((ctx: HttpContext) => string) | undefined
   maxAttempts: number
-  trustedProxies?: number
-  windowSeconds?: number
+  trustedProxies?: number | undefined
+  windowSeconds?: number | undefined
 }
 
 interface ViewRegistration = {
@@ -1080,14 +953,14 @@ interface ViewRegistration = {
 }
 
 interface WebhookOptions = {
-  algorithm?: 'sha256' | 'sha1' | 'sha512'
-  format?: 'raw' | 'stripe'
-  header?: string
-  prefix?: string
+  algorithm?: 'sha256' | 'sha1' | 'sha512' | undefined
+  format?: 'raw' | 'stripe' | undefined
+  header?: string | undefined
+  prefix?: string | undefined
   secret: string
-  timestampHeader?: string
-  timestampSeparator?: string
-  tolerance?: number
+  timestampHeader?: string | undefined
+  timestampSeparator?: string | undefined
+  tolerance?: number | undefined
 }
 
 interface WebSocketHandlers = {
@@ -1100,38 +973,20 @@ interface WebSocketHandlers = {
 
 type AppEnvironment = 'web' | 'console' | 'worker' | 'test' | 'repl'
 
-type AppScopeInstaller = () => () => void
-
 type ArgDef = {    name: string;    required?: boolean;    default?: string;}
 
 type BindingToken = ClassToken<T> | AbstractToken<T> | keyof ContainerBindings
 
-type ContextKey = never
-
-type ContextValue = ContextRegistry[K]
-
 type ControllerResponse = void | ResponseBuilder | MarkdownBuilder
 
-type CurrentPageResolver = (pageName: string) => number | undefined
-
 type DeepPartial = { [K in keyof T]?: (NonNullable<T[K]> extends _Atomic ? T[K] : NonNullable<T[K]> extends object ? DeepPartial<NonNullable<T[K]>> : T[K]) | undefined; }
 
-type DevProcessColor = 'cyan' | 'magenta' | 'yellow' | 'green' | 'blue' | 'red'
-
 type ErrorDiagnoser = (error: Error, ctx?: HttpContext) => ErrorDiagnosis | null | Promise<ErrorDiagnosis | null>
 
 type Factory = (container: Container) => T | Promise<T>
 
-type FileHandler = (ctx: HttpContext) => void | Response | Promise<void | Response>
-
-type FileRouteHandler = (ctx: HttpContext) => void | Response | Promise<void | Response>
-
-type FileRouteResolver = (ctx: FileRouteContext) => boolean
-
 type FileRoutingConfig = {    [x: string]: FileRoutingEntry;}
 
-type FileRoutingEntry = string | { dir: string; prefix?: string; middleware?: MiddlewareInput }
-
 type FlagDef = {    name: string;    short?: string;    type: 'string' | 'boolean' | 'number';    description?: string;    default?: unknown;}
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
@@ -1140,12 +995,12 @@ type HttpResponse = Promise<void>
 
 type MiddlewareClass = new (...args: any[]) => Pipe<HttpContext>
 
-type ModelBindingResolver = (value: string, ctx: HttpContext) => Promise<unknown>
-
 type NextFn = () => Promise<Response | void>
 
 type ParamsOf = P extends `${string}:${infer Name}/${infer Rest}` ? { [K in Name]: RouteParamValue; } & ParamsOf<`/${Rest}`> : P extends `${string}:${infer Name}` ? { [K in Name]: RouteParamValue; } : P extends `${string}*${string}` ? {    "*": RouteParamValue | readonly RouteParamValue[];} : Record<never, never>
 
+type Resolved = { [K in keyof T]-?: Exclude<T[K], undefined>; }
+
 type RouteArgs = [params?: RouteParamValues, query?: RouteQuery]
 
 type RouteMiddleware = MiddlewareClass[] | RouteMethodMiddleware
@@ -1154,22 +1009,14 @@ type RouteName = never
 
 type RouteParams = { [K in keyof ParamsOf<RoutePattern<N>>]: ParamsOf<RoutePattern<N>>[K]; }
 
-type RouteParamsArg = {    [x: string]: RouteParamValue | readonly RouteParamValue[];}
-
-type RouteParamValue = string | number
-
 type RouteParamValues = {    [x: string]: RouteParamValue | readonly RouteParamValue[];}
 
-type RoutePattern = N extends never ? RouteRegistry[N] extends string ? RouteRegistry[N] : string : string
-
 type RouteQuery = {    [x: string]: string | number | boolean | readonly (string | number | boolean)[] | null | undefined;}
 
 type RouteTarget = string
 
 type RoutingConfig = {    [x: string]: RoutingEntry;}
 
-type RoutingEntry = string | { file: string; prefix?: string; middleware?: MiddlewareInput }
-
 type SameSite = 'Strict' | 'Lax' | 'None'
 
 type ViewComponent = (ctx: HttpContext, props: P) => unknown
@@ -1193,7 +1040,7 @@ function addToDefaultArrayExport = (source: string, identifier: string) => strin
 function registerProvider = (options: RegisterProviderOptions) => Promise<RegisterResult>
 
 interface RegisterProviderOptions = {
-  bootstrapPath?: string
+  bootstrapPath?: string | undefined
   className: string
   importPath: string
 }
@@ -1460,6 +1307,34 @@ class AssetsBuildCommand = {
   write: (msg: string) => void
 }
 
+class AssetsPruneCommand = {
+  new (): AssetsPruneCommand
+  static args: ArgDef[]
+  static commandName: string
+  static description: string
+  static flags: ({    name: string;    type: 'string';    description: string;    default?: never;} | {    name: string;    type: 'boolean';    description: string;    default: boolean;})[]
+  static needsApp: boolean
+  _readLine: () => Promise<string>
+  _writer: OutputWriter
+  app: unknown
+  args: Record<string, string>
+  ask: (question: string, defaultValue?: string) => Promise<string>
+  choice: (question: string, options: string[]) => Promise<string>
+  confirm: (question: string, defaultValue?: boolean) => Promise<boolean>
+  dim: (msg: string) => void
+  error: (msg: string) => void
+  flags: Record<string, string | number | boolean>
+  info: (msg: string) => void
+  line: (msg: string) => void
+  newLine: () => void
+  run: () => Promise<void>
+  secret: (question: string) => Promise<string>
+  section: (title: string) => void
+  table: (rows: [string, string][], indent?: number) => void
+  warn: (msg: string) => void
+  write: (msg: string) => void
+}
+
 class CompileCommand = {
   new (): CompileCommand
   static args: ArgDef[]
@@ -2333,6 +2208,8 @@ class ConfigValidationError = {
   readonly status: number
 }
 
+const CONVENTIONAL_PREFLIGHT_COMMAND = 'release:check'
+
 const DEFAULT_DEPLOY_STEPS = readonly string[]
 
 const DEFAULT_DEPLOY_TARGETS = Record<string, DeployTarget>
@@ -2345,7 +2222,7 @@ function DeployConfig = (options?: Partial<DeployConfigShape>) => DeployConfigSh
 
 interface AppAssetsConfig = {
   entrypoint: string | string[]
-  loader?: Record<string, AssetLoaderKind>
+  loader?: Record<string, AssetLoaderKind> | undefined
   minify: boolean
   outDir: string
   prefix: string
@@ -2353,11 +2230,11 @@ interface AppAssetsConfig = {
 
 interface AppConfigShape = {
   allowedOrigins: string[]
-  assets?: AppAssetsConfig
+  assets?: AppAssetsConfig | undefined
   conventions: ConventionsConfig
   cors: AppCorsConfig
   debug: boolean
-  dev?: DevConfigShape
+  dev?: DevConfigShape | undefined
   env: string
   health: boolean | HealthConfigShape
   http3: boolean
@@ -2369,7 +2246,7 @@ interface AppConfigShape = {
   secureHeaders: AppSecureHeadersConfig
   throttle: AppThrottleConfig
   timezone: string
-  tls?: AppTlsConfig
+  tls?: AppTlsConfig | undefined
   url: string
 }
 
@@ -2391,12 +2268,6 @@ interface ConfigRegistry = {
   logging: LoggingConfigShape
 }
 
-interface ConfigValidationContext = {
-  config: ConfigManager
-  isProduction: boolean
-  namespace: string
-}
-
 interface ConventionsConfig = {
   enabled: boolean
   paths: {    providers: string;    middleware: string;    models: string;    observers: string;    policies: string;    listeners: string;    events: string;    jobs: string;    schedules: string;    validators: string;    commands: string;}
@@ -2407,23 +2278,15 @@ interface DeployConfigShape = {
 }
 
 interface DeployTarget = {
+  preflight?: readonly string[]
   steps?: readonly string[]
   url?: string
 }
 
-interface RegisteredConfigValidator = {
-  namespace: string
-  validate: ConfigValidator
-}
-
 type AssetLoaderKind = 'file' | 'dataurl' | 'base64' | 'text' | 'json' | 'toml'
 
 type ConfigIssueLevel = 'error' | 'warning'
 
-type ConfigMap = {    [x: string]: Record<string, unknown>;}
-
-type ConfigPath = 'lock' | 'app' | 'deploy' | 'health' | 'logging' | 'lock.driver' | 'lock.sqlite' | 'lock.prefix' | 'lock.sqlite.path' | 'app.url' | 'app.name' | 'app.dev' | 'app.port' | 'app.health' | 'app.env' | 'app.key' | 'app.debug' | 'app.locale' | 'app.timezone' | 'app.http3' | 'app.tls' | 'app.maxRequestBodySize' | 'app.allowedOrigins' | 'app.cors' | 'app.throttle' | 'app.secureHeaders' | 'app.assets' | 'app.conventions' | 'app.cors.credentials' | 'app.cors.origin' | 'app.throttle.maxAttempts' | 'app.throttle.windowSeconds' | 'app.secureHeaders.referrerPolicy' | 'app.secureHeaders.frameOptions' | 'app.secureHeaders.secure' | 'app.secureHeaders.hstsMaxAge' | 'app.secureHeaders.hstsIncludeSubDomains' | 'app.secureHeaders.hstsPreload' | 'app.secureHeaders.contentSecurityPolicy' | 'app.conventions.paths' | 'app.conventions.enabled' | 'app.conventions.paths.events' | 'app.conventions.paths.commands' | 'app.conventions.paths.providers' | 'app.conventions.paths.middleware' | 'app.conventions.paths.models' | 'app.conventions.paths.observers' | 'app.conventions.paths.policies' | 'app.conventions.paths.listeners' | 'app.conventions.paths.jobs' | 'app.conventions.paths.schedules' | 'app.conventions.paths.validators' | 'deploy.targets' | `deploy.targets.${string}` | 'health.path' | 'health.enabled' | 'health.secret' | 'health.showDetails' | 'logging.default' | 'logging.file' | 'logging.console' | 'logging.channels' | 'logging.slowQueryMs' | 'logging.requests' | `logging.channels.${string}`
-
 type ConfigValidator = (value: unknown, ctx: ConfigValidationContext) => ConfigIssue[] | void
 
 type ConfigValue = P extends `${infer Head}.${infer Rest}` ? Head extends keyof ConfigRegistry ? ValueAt<ConfigRegistry[Head], Rest> : unknown : P extends keyof ConfigRegistry ? ConfigRegistry[P] : unknown
@@ -2465,75 +2328,6 @@ class DevReloadMiddleware = {
   onError?: (ctx: HttpContext, error: Error) => Promise<void>
 }
 
-class DevSupervisor = {
-  new (options: DevSupervisorOptions): DevSupervisor
-  definitions: () => ResolvedDevProcess[]
-  restart: (name: string) => Promise<void>
-  start: (definitions: ResolvedDevProcess[]) => void
-  statuses: () => DevProcessStatus[]
-  stopAll: () => Promise<void>
-}
-
-class StreamDeck = {
-  new (_writer: OutputWriter, _color: boolean): StreamDeck
-  line: (name: string, text: string, stream: 'stdout' | 'stderr') => void
-  notice: (text: string) => void
-  start: (statuses: DevProcessStatus[]) => void
-  state: (status: DevProcessStatus) => void
-  stop: () => void
-}
-
-class TabsDeck = {
-  new (_options: DeckOptions, _stdout: DeckStdout, _stdin: DeckStdin): TabsDeck
-  line: (name: string, text: string, stream: 'stdout' | 'stderr') => void
-  notice: (text: string) => void
-  start: (statuses: DevProcessStatus[]) => void
-  state: (status: DevProcessStatus) => void
-  stop: () => void
-}
-
-const DEV_RELOAD_CLIENT = string
-
-const SERVER_PROCESS_NAME = 'server'
-
-function bootBuildDecision = (outDirs: string[], env: string | undefined) => Promise<BootBuildDecision>
-
-function buildCssBundle = (input: string, outdir: string, minify?: boolean, loader?: Record<string, string>) => Promise<BundleResult>
-
-function buildJsBundle = (input: string, outdir: string, minify?: boolean) => Promise<BundleResult>
-
-function collectDevProcesses = (app: ProviderHost, config?: ConfigReader) => Promise<ResolvedDevProcess[]>
-
-function createDeck = (options: DeckOptions) => Deck
-
-function detectCssPlugins = (cwd: string) => Promise<BunPlugin[]>
-
-function isWritableDir = (dir: string) => Promise<boolean>
-
-function registerDevHtmlSnippet = (name: string, fn: DevHtmlSnippet) => void
-
-function startDevMode = (options: StartDevModeOptions) => Promise<void>
-
-interface AssetBuildConfig = {
-  clean?: boolean
-  entrypoint: string | string[]
-  loader?: Record<string, string>
-  minify: boolean
-  outDir: string
-  prefix: string
-}
-
-interface BootBuildDecision = {
-  build: boolean
-  reason?: string
-}
-
-interface BuildResult = {
-  logs?: unknown[]
-  skipped?: boolean
-  success: boolean
-}
-
 interface Deck = {
   line: (name: string, text: string, stream: 'stdout' | 'stderr') => void
   notice: (text: string) => void
@@ -2542,57 +2336,6 @@ interface Deck = {
   stop: () => void
 }
 
-interface DeckOptions = {
-  mode?: 'tabs' | 'stream'
-  onQuit: () => void
-  onRestart: (name: string) => void
-  stdin?: DeckStdin
-  stdout?: DeckStdout
-  writer: OutputWriter
-}
-
-interface DevChild = {
-  kill: (signal?: number | NodeJS.Signals) => void
-  readonly exited: Promise<number>
-  readonly stderr: ReadableStream<Uint8Array<ArrayBufferLike>> | null
-  readonly stdout: ReadableStream<Uint8Array<ArrayBufferLike>> | null
-}
-
-interface DevOrchestratorHooks = {
-  onCleanup?: () => void | Promise<void>
-  onNotice?: (text: string, level: 'info' | 'warn' | 'error') => void
-  onServerLine?: (line: string, stream: 'stdout' | 'stderr') => void
-  onServerReady?: () => void | Promise<void>
-  onServerState?: (state: 'starting' | 'running' | 'restarting' | 'parked') => void
-}
-
-interface DevProcessStatus = {
-  attempts: number
-  color: DevProcessColor
-  exitCode?: number
-  label: string
-  name: string
-  state: DevProcessState
-}
-
-interface DevSupervisorOptions = {
-  backoffMs?: number[]
-  cwd: string
-  env?: Record<string, string | undefined>
-  healthyAfterMs?: number
-  onLine?: (name: string, line: string, stream: 'stdout' | 'stderr') => void
-  onState?: (status: DevProcessStatus) => void
-  spawn?: DevSpawnFn
-}
-
-type BuildHookFn = () => Promise<BuildResult>
-
-type DevHtmlSnippet = (ctx: HttpContext) => string
-
-type DevProcessState = 'starting' | 'running' | 'restarting' | 'exited' | 'parked'
-
-type DevSpawnFn = (argv: string[], options: {    cwd: string;    env: Record<string, string | undefined>;}) => DevChild
-
 ## ./env  `(./src/env/index.ts)`
 
 class Def = {
@@ -2754,6 +2497,14 @@ class NotFoundError = {
   readonly status: number
 }
 
+class RuntimeMismatchError = {
+  new (message: string, mismatch: RuntimeMismatch): RuntimeMismatchError
+  readonly code: string
+  readonly context?: Record<string, unknown> | undefined
+  readonly mismatch: RuntimeMismatch
+  readonly status: number
+}
+
 class ScopedAfterFlushError = {
   new (message: string): ScopedAfterFlushError
   readonly code: string
@@ -2859,10 +2610,10 @@ interface HealthCheckReport = {
 }
 
 interface HealthConfigShape = {
-  enabled?: boolean
-  path?: string
-  secret?: string
-  showDetails?: boolean
+  enabled?: boolean | undefined
+  path?: string | undefined
+  secret?: string | undefined
+  showDetails?: boolean | undefined
 }
 
 interface HealthReport = {
@@ -2882,7 +2633,7 @@ interface HealthResult = {
 interface ResolvedHealthConfig = {
   enabled: boolean
   path: string
-  secret?: string
+  secret?: string | undefined
   showDetails: boolean
 }
 
@@ -2900,13 +2651,9 @@ function data_get = (target: unknown, key: string, defaultValue?: unknown) => un
 
 function deepMerge = <T extends object>(base: T, override: DeepPartial<T>) => T
 
-function env = {    (key: string): string | undefined;    (key: string, fallback: string): string;    (key: string, fallback: boolean): boolean;    (key: string, fallback: number): number;}
-
-function escapeHtml = (value: string) => string
-
-function markdownPage = (title: string, body: string) => string
+function definedOnly = <T extends object>(value: T) => { [K in keyof T]?: Exclude<T[K], undefined>; }
 
-function parseCookieHeader = (header: string, name: string) => string | undefined
+function env = {    (key: string): string | undefined;    (key: string, fallback: string): string;    (key: string, fallback: boolean): boolean;    (key: string, fallback: number): number;}
 
 function pipe = <T, R>(value: T, fn: (val: T) => R) => R
 
@@ -2930,23 +2677,7 @@ function tap = <T>(value: T, callback: (val: T) => void) => T
 
 function tapAsync = <T>(value: T, callback: (val: T) => Promise<void>) => Promise<T>
 
-interface BunMarkdownOptions = {
-  autolinks?: boolean | {    url?: boolean;    www?: boolean;    email?: boolean;}
-  collapseWhitespace?: boolean
-  hardSoftBreaks?: boolean
-  headings?: boolean | {    ids?: boolean;}
-  latexMath?: boolean
-  noHtmlBlocks?: boolean
-  noHtmlSpans?: boolean
-  noIndentedCodeBlocks?: boolean
-  permissiveAtxHeaders?: boolean
-  strikethrough?: boolean
-  tables?: boolean
-  tagFilter?: boolean
-  tasklists?: boolean
-  underline?: boolean
-  wikiLinks?: boolean
-}
+type Resolved = { [K in keyof T]-?: Exclude<T[K], undefined>; }
 
 ## ./http  `(./src/http/index.ts)`
 
@@ -3081,12 +2812,8 @@ class UrlKeyMissingError = {
 
 const Url = UrlGenerator
 
-function isAllowedOrigin = (request: Request, allowedOrigins?: string[]) => boolean
-
 function negotiate = (ctx: HttpContext) => <TWeb = void, TJson = void, TCli = void>(map: NegotiateMap<TWeb, TJson, TCli>) => Promise<TWeb | TJson | TCli | void>
 
-function sniffContentType = (bytes: Uint8Array) => SniffedType
-
 function uri = (value?: string | Uri) => Uri
 
 function url = {    (): UrlGenerator;    (path: string, extra?: (string | number)[], secure?: boolean): string;}
@@ -3109,16 +2836,9 @@ interface CliContext = {
   writeln: (content: string) => void
 }
 
-interface FakeStub = {
-  body?: unknown
-  headers?: Record<string, string>
-  status?: number
-  url: string
-}
-
 interface FileValidationOptions = {
-  maxSize?: number
-  mimes?: string[]
+  maxSize?: number | undefined
+  mimes?: string[] | undefined
 }
 
 interface NegotiateMap = {
@@ -3137,20 +2857,6 @@ interface PaginatedData = {
   total: number
 }
 
-interface SniffedType = {
-  contentType: string
-  extension: string
-  recognised: boolean
-}
-
-interface UriQueryString = {
-  all: () => Record<string, QueryValue>
-  get: (key: string) => string | undefined
-  getAll: (key: string) => string[]
-  has: (key: string) => boolean
-  toString: () => string
-}
-
 interface UrlGenerator = {
   current: () => string
   full: () => string
@@ -3177,8 +2883,6 @@ interface WebContext = {
   view: (markup: string | {    toString(): string;}, status?: number) => void
 }
 
-type AnsiColor = 'red' | 'green' | 'yellow' | 'blue' | 'cyan' | 'dim'
-
 type Channel = 'web' | 'json' | 'cli'
 
 type QueryInput = {    [x: string]: string | number | boolean | string[];}
@@ -3286,10 +2990,10 @@ class SqliteLockDriver = {
 function LockConfig = (options?: Partial<LockConfigShape>) => LockConfigShape
 
 interface BlockOptions = {
-  refresh?: boolean
-  refreshEvery?: number
-  retryDelay?: number
-  timeout?: number
+  refresh?: boolean | undefined
+  refreshEvery?: number | undefined
+  retryDelay?: number | undefined
+  timeout?: number | undefined
 }
 
 interface LockConfigShape = {
@@ -3308,8 +3012,8 @@ interface LockDriver = {
 }
 
 interface RefreshOptions = {
-  refresh?: boolean
-  refreshEvery?: number
+  refresh?: boolean | undefined
+  refreshEvery?: number | undefined
 }
 
 type LockedCallback = (lock: ManagedLock, signal: AbortSignal) => Promise<T> | T
@@ -3424,16 +3128,16 @@ interface LogEntry = {
 }
 
 interface LoggerOptions = {
-  format?: 'text' | 'json'
+  format?: 'text' | 'json' | undefined
 }
 
 interface LoggingConfigShape = {
   channels: Record<string, ChannelConfig>
-  console?: ConsoleSinkConfig
+  console?: ConsoleSinkConfig | undefined
   default: string
-  file?: FileSinkConfig
-  requests?: boolean
-  slowQueryMs?: number
+  file?: FileSinkConfig | undefined
+  requests?: boolean | undefined
+  slowQueryMs?: number | undefined
 }
 
 type ChannelConfig = { driver: 'console'; level?: LogLevel; format?: 'json' | 'pretty' } | { driver: 'single'; level?: LogLevel; path: string } | { driver: 'daily'; level?: LogLevel; path: string; days?: number } | { driver: 'stack'; level?: LogLevel; channels: string[] } | { driver: 'null' }
@@ -3444,14 +3148,10 @@ type TableData = Record<string, unknown> | ReadonlyArray<Record<string, unknown>
 
 ## ./macros/config  `(./src/macros/config.macro.ts)`
 
-function loadConfigsSync = (configDir: string) => Record<string, Record<string, unknown>>
+_(no exports)_
 
 ## ./metrics  `(./src/metrics/index.ts)`
 
-function beginHttp = () => void
-
-function endHttp = () => void
-
 function httpMetrics = () => HttpMetricsSnapshot
 
 function recordHttp = (status: number, ms: number) => void
@@ -3499,6 +3199,38 @@ type RouteTable = Readonly<Record<string, string>> | ReadonlyMap<string, string>
 
 type RouteTarget = string
 
+## ./runtime  `(./src/support/runtime.ts)`
+
+const RUNTIME_MISMATCH_ESCAPE = 'ZT_ALLOW_RUNTIME_MISMATCH'
+
+function bunBinary = () => string
+
+function declaredBunFloor = (cwd: string) => {    range: string;    manifest: string;} | null
+
+function installedBunVersion = (cwd: string) => {    version: string;    manifest: string;} | null
+
+function runtimeBelowFloor = (cwd?: string) => RuntimeFloor | null
+
+function runtimeBelowFloorMessage = (floor: RuntimeFloor) => string
+
+function runtimeMismatch = (cwd?: string) => RuntimeMismatch | null
+
+function runtimeMismatchAllowed = () => boolean
+
+function runtimeMismatchMessage = (mismatch: RuntimeMismatch) => string
+
+interface RuntimeFloor = {
+  manifest: string
+  required: string
+  running: string
+}
+
+interface RuntimeMismatch = {
+  installed: string
+  manifest: string
+  running: string
+}
+
 ## ./security  `(./src/security/index.ts)`
 
 class CryptKeyMissingError = {
@@ -3529,7 +3261,7 @@ function redactGraph = (value: unknown, options: RedactGraphOptions) => unknown
 
 interface RedactGraphOptions = {
   circular: string
-  flatten?: (value: unknown) => string | undefined
+  flatten?: ((value: unknown) => string | undefined) | undefined
   mask: string
   maxDepth: number
   sensitive: (key: string) => boolean
@@ -3538,6 +3270,50 @@ interface RedactGraphOptions = {
 
 type HashAlgorithm = 'argon2id' | 'argon2i' | 'argon2d' | 'bcrypt'
 
+## ./shared  `(./src/shared/index.ts)`
+
+const Str = {    camelCase(value: string): string;    snakeCase(value: string): string;    slugify(value: string): string;    titleCase(value: string): string;    pascalCase(value: string): string;    capitalize(value: string): string;    lcfirst(value: string): string;    truncate(value: string, maxLength: number, suffix?: string): string;    isAlphanumeric(value: string): boolean;    padLeft(value: string, length: number, char?: string): string;    kebab(value: string): string;    squish(value: string): string;    finish(value: string, cap: string): string;    start(value: string, prefix: string): string;    after(value: string, needle: string): string;    before(value: string, needle: string): string;    afterLast(value: string, needle: string): string;    beforeLast(value: string, needle: string): string;    contains(value: string, substring: string): boolean;    random(length?: number): string;    replaceFirst(value: string, search: string, replace: string): string;    replaceLast(value: string, search: string, replace: string): string;    reverse(value: string): string;    words(value: string, maxWords: number, suffix?: string): string;    macro(name: string, fn: (...args: unknown[]) => unknown): void;}
+
+function camelCase = (value: string) => string
+
+function formatDate = (value: Date | number | string, options?: DateOptions) => string
+
+function formatMoney = (amount: number, options: MoneyOptions) => string
+
+function formatNumber = (value: number, options?: NumberOptions) => string
+
+function pluralize = (value: string) => string
+
+function singularize = (value: string) => string
+
+function snakeCase = (value: string) => string
+
+function tableNameFor = (className: string) => string
+
+interface DateOptions = {
+  dateStyle?: 'medium' | 'short' | 'full' | 'long' | undefined
+  locale?: string | undefined
+  timeStyle?: 'medium' | 'short' | 'full' | 'long' | undefined
+  timeZone?: string | undefined
+}
+
+interface FormatOptions = {
+  locale?: string | undefined
+}
+
+interface MoneyOptions = {
+  currency: string
+  fractionDigits?: number | undefined
+  locale?: string | undefined
+  minorUnits?: boolean | undefined
+}
+
+interface NumberOptions = {
+  locale?: string | undefined
+  maximumFractionDigits?: number | undefined
+  minimumFractionDigits?: number | undefined
+}
+
 ## ./storage  `(./src/storage/index.ts)`
 
 class DiskNotConfiguredError = {
@@ -3699,15 +3475,13 @@ class UnsupportedOperationError = {
 
 const Storage = StorageManager
 
-function mountsFrom = (config: StorageConfigShape) => Mount[]
-
 function StorageConfig = (options?: Partial<StorageConfigShape>) => StorageConfigShape
 
 interface DiskServeConfig = {
-  expiresIn?: number
-  headers?: Record<string, string>
+  expiresIn?: number | undefined
+  headers?: Record<string, string> | undefined
   path: string
-  signed?: boolean
+  signed?: boolean | undefined
 }
 
 interface FakeStoredFile = {
@@ -3721,24 +3495,24 @@ interface FakeStoredFile = {
 interface LocalDiskConfig = {
   driver: 'local'
   root: string
-  serve?: DiskServeConfig
-  url?: string
+  serve?: DiskServeConfig | undefined
+  url?: string | undefined
 }
 
 interface PutOptions = {
-  contentType?: string
-  visibility?: 'public' | 'private'
+  contentType?: string | undefined
+  visibility?: 'public' | 'private' | undefined
 }
 
 interface S3DiskConfig = {
   bucket: string
   driver: 's3'
-  endpoint?: string
+  endpoint?: string | undefined
   key: string
   region: string
   secret: string
-  serve?: DiskServeConfig
-  url?: string
+  serve?: DiskServeConfig | undefined
+  url?: string | undefined
 }
 
 interface StorageConfigShape = {
@@ -3763,8 +3537,8 @@ interface StorageDriver = {
 }
 
 interface StorageFilesOptions = {
-  mounts?: Mount[]
-  storage?: StorageManager
+  mounts?: Mount[] | undefined
+  storage?: StorageManager | undefined
 }
 
 type DiskConfig = LocalDiskConfig | S3DiskConfig
@@ -3783,10 +3557,6 @@ class SafeHtml = {
   toString: () => string
 }
 
-const VIEW_COMPONENT_PROP = '__zerotalViewComponent'
-
-const VIEW_COMPONENT_SYMBOL = typeof VIEW_COMPONENT_SYMBOL
-
 function defineLayout = <LP extends Record<string, unknown>>(Layout: (props: LP & {    children?: unknown;}) => SafeHtml) => <PP extends Record<string, unknown> = Record<string, never>>(Page: (props: PP & {    children?: unknown;}) => SafeHtml) => (props: LP & PP) => SafeHtml
 
 function definePage = <P extends Record<string, unknown> = Record<string, unknown>>(component: (ctx: HttpContext, params: P) => SafeHtml | string | Promise<SafeHtml | string>) => typeof component
@@ -3797,8 +3567,6 @@ function Fragment = ({ children }: {    children?: unknown;}) => SafeHtml
 
 function Raw = ({ html }: {    html: string;}) => SafeHtml
 
-function registerViewFileRouteResolver = () => void
-
 function safe = (html: string) => SafeHtml
 
 type Children = unknown