@zerotal/core 1.8.0 → 1.9.0

package/api-surface.md

@@ -512,20 +512,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 +562,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 +627,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 +645,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 +683,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 +697,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 +709,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 +725,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 +736,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,8 +807,6 @@ interface ContainerBindings = {
   two_factor: TwoFactorService
 }
 
-interface ContextRegistry = {}
-
 interface CookieOptions = {
   domain?: string
   httpOnly?: boolean
@@ -882,11 +827,6 @@ interface CorsOptions = {
   origin?: string | string[] | ((origin: string) => boolean)
 }
 
-interface DevConfigShape = {
-  disable?: string[]
-  processes?: DevProcessDefinition[]
-}
-
 interface DevProcessDefinition = {
   after?: 'server' | 'none'
   color?: DevProcessColor
@@ -929,30 +869,12 @@ 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[]
-}
-
 interface ModelClass = {
   findOrFail: (id: number | string) => Promise<unknown>
 }
@@ -973,28 +895,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 +911,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
@@ -1100,38 +972,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,8 +994,6 @@ 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>
@@ -1154,22 +1006,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
@@ -2333,6 +2177,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>
@@ -2391,12 +2237,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 +2247,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 +2297,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 +2305,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 +2466,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
@@ -2902,12 +2622,6 @@ 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 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>
@@ -2930,24 +2644,6 @@ 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
-}
-
 ## ./http  `(./src/http/index.ts)`
 
 class Http = {
@@ -3081,12 +2777,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,13 +2801,6 @@ interface CliContext = {
   writeln: (content: string) => void
 }
 
-interface FakeStub = {
-  body?: unknown
-  headers?: Record<string, string>
-  status?: number
-  url: string
-}
-
 interface FileValidationOptions = {
   maxSize?: number
   mimes?: string[]
@@ -3137,20 +2822,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 +2848,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[];}
@@ -3444,14 +3113,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
@@ -3538,6 +3203,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'
+  locale?: string
+  timeStyle?: 'medium' | 'short' | 'full' | 'long'
+  timeZone?: string
+}
+
+interface FormatOptions = {
+  locale?: string
+}
+
+interface MoneyOptions = {
+  currency: string
+  fractionDigits?: number
+  locale?: string
+  minorUnits?: boolean
+}
+
+interface NumberOptions = {
+  locale?: string
+  maximumFractionDigits?: number
+  minimumFractionDigits?: number
+}
+
 ## ./storage  `(./src/storage/index.ts)`
 
 class DiskNotConfiguredError = {
@@ -3699,8 +3408,6 @@ class UnsupportedOperationError = {
 
 const Storage = StorageManager
 
-function mountsFrom = (config: StorageConfigShape) => Mount[]
-
 function StorageConfig = (options?: Partial<StorageConfigShape>) => StorageConfigShape
 
 interface DiskServeConfig = {
@@ -3783,10 +3490,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 +3500,6 @@ function Fragment = ({ children }: {    children?: unknown;}) => SafeHtml
 
 function Raw = ({ html }: {    html: string;}) => SafeHtml
 
-function registerViewFileRouteResolver = () => void
-
 function safe = (html: string) => SafeHtml
 
 type Children = unknown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerotal/core",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "license": "MIT",
   "maturity": "stable",
   "private": false,
@@ -16,6 +16,7 @@
     "./logger": "./src/logger/index.ts",
     "./commands": "./src/command/builtin/index.ts",
     "./helpers": "./src/helpers/index.ts",
+    "./shared": "./src/shared/index.ts",
     "./facades": "./src/facade/facades/index.ts",
     "./carbon": "./src/datetime/index.ts",
     "./http": "./src/http/index.ts",