zerotal 1.7.2 → 1.7.4

package/api-surface.md

@@ -316,6 +316,7 @@ class HttpContext = {
   new <TParams extends Record<string, unknown> = Record<string, string>>(request: Request, container: ScopedResolver): HttpContext<TParams>
   static fake: (url?: string, init?: RequestInit, container?: ScopedResolver) => HttpContext
   static tryGet: () => HttpContext | undefined
+  __: (key: string, replacements?: Replacements, locale?: string) => string
   _afterResponseCallbacks: (() => Promise<void>)[]
   _pageResolver?: (pageName: string) => number | undefined
   _primeBody: (data: Record<string, unknown>) => void
@@ -368,7 +369,6 @@ class HttpContext = {
   string: (key: string, fallback?: string) => string | undefined
   subdomain: (name: string) => string | null
   subdomains: Record<string, string>
-  t: (key: string, replacements?: Replacements, locale?: string) => string
   took: number
   user?: UserModel | undefined
   view: {    (markup: ViewMarkup, status?: number): void;    <P extends Record<string, unknown> = Record<string, never>>(component: (ctx: HttpContext, props: P) => ViewMarkup | Promise<ViewMarkup>, props?: P | undefined, status?: number): void | Promise<void>;}
@@ -1101,6 +1101,7 @@ interface WebhookOptions = {
 interface WebSocketHandlers = {
   close?: (ws: unknown, code: number, reason: string) => void
   drain?: (ws: unknown) => void
+  idleTimeout?: number
   message: (ws: unknown, message: string | Uint8Array) => void
   open?: (ws: unknown) => void
 }
@@ -1111,7 +1112,7 @@ type AppScopeInstaller = () => () => void
 
 type ArgDef = {    name: string;    required?: boolean;    default?: string;}
 
-type BindingToken = keyof ContainerBindings | ClassToken<T> | AbstractToken<T>
+type BindingToken = ClassToken<T> | AbstractToken<T> | keyof ContainerBindings
 
 type ClassRef = abstract new (...args: never[]) => unknown
 
@@ -1139,7 +1140,7 @@ type FileRouteResolver = (ctx: FileRouteContext) => boolean
 
 type FileRoutingConfig = {    [x: string]: FileRoutingEntry;}
 
-type FileRoutingEntry = string | {    dir: string;    prefix?: string;    middleware?: MiddlewareInput;}
+type FileRoutingEntry = string | { dir: string; prefix?: string; middleware?: MiddlewareInput }
 
 type FlagDef = {    name: string;    short?: string;    type: 'string' | 'boolean' | 'number';    description?: string;    default?: unknown;}
 
@@ -1177,7 +1178,7 @@ type RouteTarget = string
 
 type RoutingConfig = {    [x: string]: RoutingEntry;}
 
-type RoutingEntry = string | {    file: string;    prefix?: string;    middleware?: MiddlewareInput;}
+type RoutingEntry = string | { file: string; prefix?: string; middleware?: MiddlewareInput }
 
 type SameSite = 'Strict' | 'Lax' | 'None'
 
@@ -3105,7 +3106,7 @@ type ResponseInterceptor = (ctx: ResponseContext) => ResponseContext | Promise<R
 
 type ResponseOf = `${Method} ${Path}` extends keyof Routes ? Routes[`${Method} ${Path}`] extends {    response: infer R;} ? R : unknown : unknown
 
-type SocketState = 'error' | 'connecting' | 'connected' | 'disconnected' | 'reconnecting'
+type SocketState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting' | 'error'
 
 type TokenSource = string | (() => string | null | undefined | Promise<string | null | undefined>)
 
@@ -4098,7 +4099,7 @@ interface RegisteredConfigValidator = {
   validate: ConfigValidator
 }
 
-type AssetLoaderKind = 'text' | 'file' | 'json' | 'dataurl' | 'base64' | 'toml'
+type AssetLoaderKind = 'file' | 'dataurl' | 'base64' | 'text' | 'json' | 'toml'
 
 type ConfigIssueLevel = 'error' | 'warning'
 
@@ -4315,7 +4316,7 @@ const t = {    readonly string: () => Def<string | undefined>;    readonly numbe
 
 type EnvOutput = { readonly [K in keyof S]: InferDef<S[K]>; }
 
-type FieldType = 'string' | 'number' | 'boolean' | 'url' | 'enum' | 'port'
+type FieldType = 'string' | 'number' | 'boolean' | 'enum' | 'url' | 'port'
 
 type InferDef = D extends Def<infer T> ? T : never
 
@@ -4665,7 +4666,7 @@ interface WebContext = {
   view: (markup: string | {    toString(): string;}, status?: number) => void
 }
 
-type AnsiColor = 'cyan' | 'yellow' | 'green' | 'blue' | 'red' | 'dim'
+type AnsiColor = 'red' | 'green' | 'yellow' | 'blue' | 'cyan' | 'dim'
 
 type Channel = 'web' | 'json' | 'cli'
 
@@ -4926,11 +4927,11 @@ interface LoggingConfigShape = {
   slowQueryMs?: number
 }
 
-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';}
+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' }
 
-type LogLevel = 'error' | 'info' | 'warn' | 'debug' | 'fatal'
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal'
 
-type TableData = Record<string, unknown> | readonly Record<string, unknown>[]
+type TableData = Record<string, unknown> | ReadonlyArray<Record<string, unknown>>
 
 ## ./media  `(./src/media.ts)`
 
@@ -5378,7 +5379,7 @@ interface ResponsiveImageSet = {
   placeholder?: string
 }
 
-type ConversionFit = 'fill' | 'inside' | 'cover'
+type ConversionFit = 'inside' | 'fill' | 'cover'
 
 type ConversionFormat = SafeConversionFormat | 'avif' | 'heic'
 
@@ -5386,7 +5387,7 @@ type ConversionMap = {    [x: string]: ConversionDefinition;}
 
 type MediaCollections = {    [x: string]: CollectionDefinition | (() => CollectionDefinition);}
 
-type MediaSource = ArrayBuffer | Blob | UploadedFile | File | Uint8Array<ArrayBufferLike>
+type MediaSource = UploadedFile | File | Blob | Uint8Array | ArrayBuffer
 
 type SafeConversionFormat = 'jpeg' | 'png' | 'webp'
 
@@ -5529,7 +5530,7 @@ class Blueprint = {
   bigInteger: (name: string) => ColumnBuilder
   binary: (name: string) => ColumnBuilder
   boolean: (name: string) => ColumnBuilder
-  char: (name: string, _length?: number) => ColumnBuilder
+  char: (name: string, length?: number) => ColumnBuilder
   date: (name: string) => ColumnBuilder
   dateTime: (name: string) => ColumnBuilder
   datetime: (name: string) => ColumnBuilder
@@ -5566,7 +5567,7 @@ class Blueprint = {
   smallInteger: (name: string) => ColumnBuilder
   softDeletes: (column?: string) => void
   spatialIndex: (columns: string | string[], name?: string) => Blueprint
-  string: (name: string, _length?: number) => ColumnBuilder
+  string: (name: string, length?: number) => ColumnBuilder
   text: (name: string) => ColumnBuilder
   time: (name: string) => ColumnBuilder
   timestamp: (name: string) => ColumnBuilder
@@ -5595,7 +5596,7 @@ class Cast = {
 }
 
 class ColumnBuilder = {
-  new <Locked extends string = never>(name: string, _sqlType: string, isPrimary?: boolean, isAutoIncrement?: boolean): ColumnBuilder<Locked>
+  new <Locked extends string = never>(name: string, _sqlType: string, isPrimary?: boolean, isAutoIncrement?: boolean, _isBoolean?: boolean, _stringLength?: number | undefined): ColumnBuilder<Locked>
   after: (_column: string) => ColumnBuilder<Locked>
   alter: () => ColumnBuilder<Locked>
   before: (_column: string) => ColumnBuilder<Locked>
@@ -5979,12 +5980,15 @@ class MysqlDialect = {
   advisoryLockSql: (key: number) => DialectQuery
   advisoryUnlockSql: (key: number) => DialectQuery
   autoIncrementColumn: (column: string) => string
+  booleanLiteral: (value: boolean) => string
   dateExpr: (part: DatePart, column: string) => string
   hasColumnSql: (table: string, column: string) => DialectQuery
   hasTableSql: (table: string) => DialectQuery
+  readonly booleanType: 'INTEGER'
   readonly name: 'mysql'
   readonly supportsAdvisoryLocks: true
   readonly supportsTransactionalDdl: false
+  stringType: (length: number) => string
 }
 
 class NPlusOneDetected = {
@@ -6018,12 +6022,15 @@ class PostgresDialect = {
   advisoryLockSql: (key: number) => DialectQuery
   advisoryUnlockSql: (key: number) => DialectQuery
   autoIncrementColumn: (column: string) => string
+  booleanLiteral: (value: boolean) => string
   dateExpr: (part: DatePart, column: string) => string
   hasColumnSql: (table: string, column: string) => DialectQuery
   hasTableSql: (table: string) => DialectQuery
+  readonly booleanType: 'BOOLEAN'
   readonly name: 'postgres'
   readonly supportsAdvisoryLocks: true
   readonly supportsTransactionalDdl: true
+  stringType: () => string
 }
 
 class QueryBuilder = {
@@ -6155,12 +6162,15 @@ class SqliteDialect = {
   advisoryLockSql: () => DialectQuery | null
   advisoryUnlockSql: () => DialectQuery | null
   autoIncrementColumn: (column: string) => string
+  booleanLiteral: (value: boolean) => string
   dateExpr: (part: DatePart, column: string) => string
   hasColumnSql: (table: string, column: string) => DialectQuery
   hasTableSql: (table: string) => DialectQuery
+  readonly booleanType: 'INTEGER'
   readonly name: 'sqlite'
   readonly supportsAdvisoryLocks: false
   readonly supportsTransactionalDdl: true
+  stringType: () => string
 }
 
 class StateError = {
@@ -6673,12 +6683,15 @@ interface SqlDialect = {
   advisoryLockSql: (key: number) => DialectQuery | null
   advisoryUnlockSql: (key: number) => DialectQuery | null
   autoIncrementColumn: (column: string) => string
+  booleanLiteral: (value: boolean) => string
   dateExpr: (part: DatePart, column: string) => string
   hasColumnSql: (table: string, column: string) => DialectQuery
   hasTableSql: (table: string) => DialectQuery
+  readonly booleanType: string
   readonly name: DialectName
   readonly supportsAdvisoryLocks: boolean
   readonly supportsTransactionalDdl: boolean
+  stringType: (length: number) => string
 }
 
 interface SQLInstance = {
@@ -6720,13 +6733,13 @@ type ClassRef = abstract new (...args: never[]) => unknown
 
 type Columns = { [K in keyof T & string]: K extends `_${string}` ? never : T[K] extends (...args: any[]) => any ? never : K; }[keyof T & string]
 
-type ColumnShorthand = 'string' | 'number' | 'boolean' | 'text' | 'date' | 'datetime' | 'array' | 'integer' | 'json' | 'float' | 'encrypted' | 'encrypted:json'
+type ColumnShorthand = 'string' | 'text' | 'integer' | 'number' | 'float' | 'boolean' | 'datetime' | 'date' | 'json' | 'array' | 'encrypted' | 'encrypted:json'
 
 type Constructor = new (...args: any[]) => T
 
 type ContextConnectionResolver = (ModelClass?: typeof BaseModel) => SQLInstance | null
 
-type DatePart = 'date' | 'time' | 'year' | 'month' | 'day'
+type DatePart = 'date' | 'time' | 'day' | 'month' | 'year'
 
 type DialectName = 'sqlite' | 'postgres' | 'mysql'
 
@@ -7061,26 +7074,49 @@ interface WorkerPoolOptions = {
   size: number
 }
 
-type BatchStatus = 'failed' | 'pending' | 'complete'
+type BatchStatus = 'pending' | 'complete' | 'failed'
 
 type JobStatus = 'dispatched' | 'completed' | 'failed' | 'retried'
 
 type SerializedJob = {    className: string;    payload: Record<string, unknown>;}
 
-type WorkerResult = {    success: true;} | {    success: false;    error: string;}
+type WorkerResult = { success: true } | { success: false; error: string }
 
 ## ./routes  `(./src/routes.ts)`
 
 const route = RouteBuilder
 
+function action = <N extends RouteTarget>(name: N, params?: RouteParamValues | undefined, query?: RouteQuery | undefined) => RouteAction
+
+function defineRouteMethods = (table: Readonly<Record<string, string>>) => void
+
 function defineRoutes = (table: RouteTable) => void
 
 function hasRoute = (name: string) => boolean
 
 function resetRoutes = () => void
 
+function routeMethod = (name: string) => string | undefined
+
+interface RouteAction = {
+  method: string
+  url: string
+}
+
+interface RouteMethodRegistry = {}
+
+type MethodedRouteName = never
+
+type RouteArgs = [params?: RouteParamValues, query?: RouteQuery]
+
+type RouteParamValues = {    [x: string]: RouteParamValue | readonly RouteParamValue[];}
+
+type RouteQuery = {    [x: string]: string | number | boolean | readonly (string | number | boolean)[] | null | undefined;}
+
 type RouteTable = Readonly<Record<string, string>> | ReadonlyMap<string, string>
 
+type RouteTarget = string
+
 ## ./scheduler  `(./src/scheduler.ts)`
 
 class CronExpression = {
@@ -7350,7 +7386,7 @@ interface RedactGraphOptions = {
   tooDeep: string
 }
 
-type HashAlgorithm = 'bcrypt' | 'argon2id' | 'argon2i' | 'argon2d'
+type HashAlgorithm = 'argon2id' | 'argon2i' | 'argon2d' | 'bcrypt'
 
 ## ./session  `(./src/session.ts)`
 
@@ -8030,7 +8066,7 @@ type FakeFile = {    create(name: string, content?: string | Uint8Array, type?:
 
 type SessionDecoder = (response: Response) => Promise<Record<string, unknown> | null>
 
-type TestFormValue = string | number | boolean | Blob | File | TestFileInput | null | undefined
+type TestFormValue = string | number | boolean | null | undefined | TestFileInput | File | Blob
 
 ## ./validator  `(./src/validator.ts)`
 
@@ -8159,6 +8195,7 @@ class FormRequest = {
   static macro: (name: string, fn: (this: FormRequest, ...args: unknown[]) => unknown) => void
   static validate: <T extends FormRequest>(this: new () => T) => Promise<Infer<ExtractDefs<ReturnType<T['rules']>>>>
   authorize: () => boolean | Promise<boolean>
+  prepareForValidation: (body: Record<string, unknown>) => Record<string, unknown>
   rules: (_r: RuleBuilder) => Record<string, FieldRule>
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zerotal",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "license": "MIT",
   "maturity": "stable",
   "private": false,
@@ -61,17 +61,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@zerotal/auth": "1.7.2",
-    "@zerotal/cache": "1.7.2",
-    "@zerotal/client": "1.7.2",
-    "@zerotal/core": "1.7.2",
-    "@zerotal/media": "1.7.2",
-    "@zerotal/orm": "1.7.2",
-    "@zerotal/queue": "1.7.2",
-    "@zerotal/scheduler": "1.7.2",
-    "@zerotal/session": "1.7.2",
-    "@zerotal/testing": "1.7.2",
-    "@zerotal/validator": "1.7.2"
+    "@zerotal/auth": "1.7.4",
+    "@zerotal/cache": "1.7.4",
+    "@zerotal/client": "1.7.4",
+    "@zerotal/core": "1.7.4",
+    "@zerotal/media": "1.7.4",
+    "@zerotal/orm": "1.7.4",
+    "@zerotal/queue": "1.7.4",
+    "@zerotal/scheduler": "1.7.4",
+    "@zerotal/session": "1.7.4",
+    "@zerotal/testing": "1.7.4",
+    "@zerotal/validator": "1.7.4"
   },
   "devDependencies": {
     "typescript": "^5.8.0"