alepha 0.9.5 → 0.10.1

package/core.d.ts

@@ -1,11 +1,12 @@
 import { AsyncLocalStorage } from "node:async_hooks";
-import { TypeCheck } from "@sinclair/typebox/compiler";
-import * as TypeBoxValue from "@sinclair/typebox/value";
-import * as TypeBox from "@sinclair/typebox";
-import { ArrayOptions, FormatRegistry, IntegerOptions, NumberOptions, ObjectOptions, SchemaOptions, Static, Static as Static$1, StaticDecode, StaticEncode, StringOptions, TAny, TAny as TAny$1, TArray, TArray as TArray$1, TBoolean, TBoolean as TBoolean$1, TComposite, TInteger, TIntersect, TNull, TNull as TNull$1, TNumber, TNumber as TNumber$1, TObject, TObject as TObject$1, TOmit, TOptional, TOptionalWithFlag, TPartial, TPick, TProperties, TProperties as TProperties$1, TRecord, TRecord as TRecord$1, TSchema, TSchema as TSchema$1, TString, TString as TString$1, TUnion, TUnion as TUnion$1, TUnsafe, TypeGuard, UnsafeOptions } from "@sinclair/typebox";
-import { ValueError } from "@sinclair/typebox/errors";
+import { Validator } from "typebox/compile";
+import * as TypeBox from "typebox";
+import { Static, Static as Static$1, StaticDecode, StaticEncode, TAny, TAny as TAny$1, TArray, TArray as TArray$1, TArrayOptions, TBigInt, TBoolean, TBoolean as TBoolean$1, TInteger, TInteger as TInteger$1, TKeysToIndexer, TNull, TNull as TNull$1, TNumber, TNumber as TNumber$1, TNumberOptions, TNumberOptions as TNumberOptions$1, TObject, TObject as TObject$1, TObjectOptions, TObjectOptions as TObjectOptions$1, TOptional, TOptionalAdd, TOptionalAdd as TOptionalAdd$1, TPick, TProperties, TProperties as TProperties$1, TRecord, TRecord as TRecord$1, TSchema, TSchema as TSchema$1, TSchemaOptions, TString, TString as TString$1, TStringOptions, TStringOptions as TStringOptions$1, TTuple, TUnion, TUnion as TUnion$1, TUnsafe, TVoid } from "typebox";
+import Format from "typebox/format";
+import * as TypeBoxValue from "typebox/value";
 import { Readable } from "node:stream";
 import { ReadableStream as ReadableStream$1 } from "node:stream/web";
+import { TLocalizedValidationError } from "typebox/error";
 
 //#region src/constants/KIND.d.ts
 /**
@@ -255,6 +256,45 @@ interface LoggerInterface {
   error(message: string, data?: unknown): void;
 }
 //#endregion
+//#region src/helpers/EventManager.d.ts
+declare class EventManager {
+  protected logFn?: () => LoggerInterface | undefined;
+  /**
+   * List of events that can be triggered. Powered by $hook().
+   */
+  protected events: Record<string, Array<Hook>>;
+  constructor(logFn?: () => LoggerInterface | undefined);
+  protected get log(): LoggerInterface | undefined;
+  /**
+   * Registers a hook for the specified event.
+   */
+  on<T extends keyof Hooks>(event: T, hookOrFunc: Hook<T> | ((payload: Hooks[T]) => Async<void>)): () => void;
+  /**
+   * Emits the specified event with the given payload.
+   */
+  emit<T extends keyof Hooks>(func: keyof Hooks, payload: Hooks[T], options?: {
+    /**
+     * If true, the hooks will be executed in reverse order.
+     * This is useful for "stop" hooks that should be executed in reverse order.
+     *
+     * @default false
+     */
+    reverse?: boolean;
+    /**
+     * If true, the hooks will be logged with their execution time.
+     *
+     * @default false
+     */
+    log?: boolean;
+    /**
+     * If true, errors will be caught and logged instead of throwing.
+     *
+     * @default false
+     */
+    catch?: boolean;
+  }): Promise<void>;
+}
+//#endregion
 //#region src/providers/AlsProvider.d.ts
 type AsyncLocalStorageData = any;
 declare class AlsProvider {
@@ -268,6 +308,313 @@ declare class AlsProvider {
   set<T>(key: string, value: T): void;
 }
 //#endregion
+//#region src/helpers/StateManager.d.ts
+declare class StateManager<S extends Record<string, any> = State> {
+  protected store: Partial<S>;
+  protected readonly events?: EventManager;
+  protected readonly als?: AlsProvider;
+  constructor(events?: EventManager, als?: AlsProvider);
+  /**
+   * Get a value from the state with proper typing
+   */
+  get<Key extends keyof S>(key: Key): S[Key] | undefined;
+  /**
+   * Set a value in the state
+   */
+  set<Key extends keyof S>(key: Key, value: S[Key] | undefined): this;
+  /**
+   * Check if a key exists in the state
+   */
+  has<Key extends keyof S>(key: Key): boolean;
+  /**
+   * Delete a key from the state (set to undefined)
+   */
+  del<Key extends keyof S>(key: Key): this;
+  /**
+   * Clear all state
+   */
+  clear(): this;
+  /**
+   * Get all keys that exist in the state
+   */
+  keys(): (keyof S)[];
+}
+//#endregion
+//#region src/helpers/FileLike.d.ts
+interface FileLike {
+  /**
+   * Filename.
+   * @default "file"
+   */
+  name: string;
+  /**
+   * Mandatory MIME type of the file.
+   * @default "application/octet-stream"
+   */
+  type: string;
+  /**
+   * Size of the file in bytes.
+   *
+   * Always 0 for streams, as the size is not known until the stream is fully read.
+   *
+   * @default 0
+   */
+  size: number;
+  /**
+   * Last modified timestamp in milliseconds since epoch.
+   *
+   * Always the current timestamp for streams, as the last modified time is not known.
+   * We use this field to ensure compatibility with File API.
+   *
+   * @default Date.now()
+   */
+  lastModified: number;
+  /**
+   * Returns a ReadableStream or Node.js Readable stream of the file content.
+   *
+   * For streams, this is the original stream.
+   */
+  stream(): StreamLike;
+  /**
+   * Returns the file content as an ArrayBuffer.
+   *
+   * For streams, this reads the entire stream into memory.
+   */
+  arrayBuffer(): Promise<ArrayBuffer>;
+  /**
+   * Returns the file content as a string.
+   *
+   * For streams, this reads the entire stream into memory and converts it to a string.
+   */
+  text(): Promise<string>;
+  /**
+   * Optional file path, if the file is stored on disk.
+   *
+   * This is not from the File API, but rather a custom field to indicate where the file is stored.
+   */
+  filepath?: string;
+}
+/**
+ * TypeBox view of FileLike.
+ */
+type TFile = TUnsafe<FileLike>;
+declare const isTypeFile: (value: TSchema$1) => value is TFile;
+declare const isFileLike: (value: any) => value is FileLike;
+type StreamLike = ReadableStream | ReadableStream$1 | Readable | NodeJS.ReadableStream;
+type TStream = TUnsafe<StreamLike>;
+//#endregion
+//#region src/providers/TypeProvider.d.ts
+declare class TypeGuard {
+  isSchema: typeof TypeBox.IsSchema;
+  isObject: typeof TypeBox.IsObject;
+  isNumber: typeof TypeBox.IsNumber;
+  isString: typeof TypeBox.IsString;
+  isBoolean: typeof TypeBox.IsBoolean;
+  isAny: typeof TypeBox.IsAny;
+  isArray: typeof TypeBox.IsArray;
+  isOptional: typeof TypeBox.IsOptional;
+  isUnion: typeof TypeBox.IsUnion;
+  isInteger: typeof TypeBox.IsInteger;
+  isNull: typeof TypeBox.IsNull;
+  isUndefined: typeof TypeBox.IsUndefined;
+  isUnsafe: typeof TypeBox.IsUnsafe;
+  isRecord: typeof TypeBox.IsRecord;
+  isTuple: typeof TypeBox.IsTuple;
+  isVoid: typeof TypeBox.IsVoid;
+  isFile: (value: TSchema$1) => value is TFile;
+  isBigInt: (value: TSchema$1) => value is TString$1;
+  isDate: (value: TSchema$1) => value is TString$1;
+  isDatetime: (value: TSchema$1) => value is TString$1;
+  isUuid: (value: TSchema$1) => value is TString$1;
+}
+declare module "typebox" {
+  interface TString {
+    format?: string;
+    minLength?: number;
+    maxLength?: number;
+  }
+  interface TNumber {
+    format?: "int64";
+  }
+}
+declare class TypeProvider {
+  static format: typeof Format;
+  static isValidBigInt(value: string | number): boolean;
+  /**
+   * Default maximum length for strings.
+   *
+   * It can be set to a larger value:
+   * ```ts
+   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = 1000000;
+   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = undefined; // no limit (not recommended)
+   * ```
+   */
+  static DEFAULT_STRING_MAX_LENGTH: number | undefined;
+  /**
+   * Maximum length for short strings, such as names or titles.
+   */
+  static DEFAULT_SHORT_STRING_MAX_LENGTH: number | undefined;
+  /**
+   * Maximum length for long strings, such as descriptions or comments.
+   * It can be overridden in the string options.
+   *
+   * It can be set to a larger value:
+   * ```ts
+   * TypeProvider.DEFAULT_LONG_STRING_MAX_LENGTH = 2048;
+   * ```
+   */
+  static DEFAULT_LONG_STRING_MAX_LENGTH: number | undefined;
+  /**
+   * Maximum length for rich strings, such as HTML or Markdown.
+   * This is a large value to accommodate rich text content.
+   * > It's also the maximum length of PG's TEXT type.
+   *
+   * It can be overridden in the string options.
+   *
+   * It can be set to a larger value:
+   * ```ts
+   * TypeProvider.DEFAULT_RICH_STRING_MAX_LENGTH = 1000000;
+   * ```
+   */
+  static DEFAULT_RICH_STRING_MAX_LENGTH: number | undefined;
+  /**
+   * Maximum number of items in an array.
+   * This is a default value to prevent excessive memory usage.
+   * It can be overridden in the array options.
+   */
+  static DEFAULT_ARRAY_MAX_ITEMS: number;
+  raw: typeof TypeBox.Type;
+  any: typeof TypeBox.Any;
+  void: typeof TypeBox.Void;
+  undefined: typeof TypeBox.Undefined;
+  record: typeof TypeBox.Record;
+  omit: typeof TypeBox.Omit;
+  partial: typeof TypeBox.Partial;
+  union: typeof TypeBox.Union;
+  pick: typeof TypeBox.Pick;
+  tuple: typeof TypeBox.Tuple;
+  interface: typeof TypeBox.Interface;
+  readonly schema: TypeGuard;
+  /**
+   * Create a schema for an object.
+   */
+  object<T extends TProperties$1>(properties: T, options?: TObjectOptions$1): TObject$1<T>;
+  /**
+   * Create a schema for an array.
+   *
+   * @param schema
+   * @param options
+   */
+  array<T extends TSchema$1>(schema: T, options?: TArrayOptions): TArray$1<T>;
+  /**
+   * Create a schema for a string.
+   */
+  string(options?: AlephaStringOptions): TString$1;
+  /**
+   * Create a schema for a JSON object.
+   * This is a record with string keys and any values.
+   */
+  json(options?: TSchemaOptions): TRecord$1<string, TAny$1>;
+  /**
+   * Create a schema for a boolean.
+   */
+  boolean(options?: TSchemaOptions): TBoolean$1;
+  /**
+   * Create a schema for a number.
+   */
+  number(options?: TNumberOptions$1): TNumber$1;
+  /**
+   * Create a schema for a signed 32-bit integer.
+   */
+  int(options?: TNumberOptions$1): TInteger$1;
+  /**
+   * Mimic a signed 64-bit integer.
+   *
+   * This is NOT a true int64, as JavaScript cannot represent all int64 values.
+   * It is a number that is an integer and between -9007199254740991 and 9007199254740991.
+   * Use `t.bigint()` for true int64 values represented as strings.
+   */
+  int64(options?: TNumberOptions$1): TNumber$1;
+  /**
+   * Make a schema optional.
+   */
+  optional<T extends TSchema$1>(schema: T): TOptionalAdd$1<T>;
+  /**
+   * Make a schema nullable.
+   */
+  nullable<T extends TSchema$1>(schema: T, options?: TObjectOptions$1): TUnion$1<[TNull$1, T]>;
+  /**
+   * Create a schema that maps all properties of an object schema to nullable.
+   */
+  nullify: <T extends TSchema$1>(schema: T, options?: TObjectOptions$1) => TypeBox.TMappedInstantiate<{}, {
+    callstack: [];
+  }, TypeBox.TIdentifier<"K">, TypeBox.TKeyOfInstantiate<{}, {
+    callstack: [];
+  }, T>, TypeBox.TRef<"K">, TUnion$1<[TypeBox.TIndexInstantiate<{}, {
+    callstack: [];
+  }, T, TypeBox.TRef<"K">>, TNull$1]>>;
+  /**
+   * Create a schema for a string enum.
+   */
+  enum<T extends string[]>(values: [...T], options?: TStringOptions$1): TUnsafe<T[number]>;
+  /**
+   * Create a schema for a bigint.
+   * This is NOT a BigInt object, but a string that represents a bigint.
+   */
+  bigint(options?: TStringOptions$1): TString$1;
+  /**
+   * Create a schema for a datetime.
+   * This is NOT a Date object, but a string in ISO 8601 format.
+   */
+  datetime(options?: TStringOptions$1): TString$1;
+  /**
+   * Create a schema for a date.
+   * This is NOT a Date object, but a string in ISO 8601 date format (YYYY-MM-DD).
+   */
+  date(options?: TStringOptions$1): TString$1;
+  /**
+   * Create a schema for a url.
+   */
+  url(options?: TStringOptions$1): TString$1;
+  /**
+   * Create a schema for uuid.
+   */
+  uuid(options?: TStringOptions$1): TString$1;
+  /**
+   * Create a schema for a file-like object.
+   *
+   * File like mimics the File API in browsers, but is adapted to work in Node.js as well.
+   *
+   * Implementation of file-like objects is handled by "alepha/file" package.
+   */
+  file(options?: {
+    maxSize?: number;
+  }): TFile;
+  /**
+   * @experimental
+   */
+  stream(): TStream;
+  /**
+   * Create a schema for a string enum e.g. LIKE_THIS.
+   *
+   * @param options
+   */
+  snakeCase: (options?: TStringOptions$1) => TString$1;
+  /**
+   * Create a schema for an object with a value and label.
+   */
+  valueLabel: (options?: TObjectOptions$1) => TObject$1<{
+    value: TString$1;
+    label: TString$1;
+    description: TypeBox.TOptional<TString$1>;
+  }>;
+}
+type TextLength = "short" | "long" | "rich";
+interface AlephaStringOptions extends TStringOptions$1 {
+  size?: TextLength;
+}
+declare const t: TypeProvider;
+//#endregion
 //#region src/Alepha.d.ts
 /**
  * Core container of the Alepha framework.
@@ -375,7 +722,7 @@ declare class AlsProvider {
  * Alepha.create()
  * 	 .with(App)
  * 	 .start()
- * 	 .then(alepha => alepha.emit("my:custom:hook"));
+ * 	 .then(alepha => alepha.events.emit("my:custom:hook"));
  * ```
  *
  * 	Hooks are fully typed. You can create your own hooks by using module augmentation:
@@ -464,16 +811,12 @@ declare class Alepha {
    * Cache for environment variables.
    * > It allows us to avoid parsing the same schema multiple times.
    */
-  protected cacheEnv: Map<TSchema$1, any>;
+  protected cacheEnv: Map<TSchema, any>;
   /**
    * Cache for TypeBox type checks.
    * > It allows us to avoid compiling the same schema multiple times.
    */
-  protected cacheTypeCheck: Map<TSchema$1, TypeCheck<TSchema$1>>;
-  /**
-   * List of events that can be triggered. Powered by $hook().
-   */
-  protected events: Record<string, Array<Hook>>;
+  protected cacheTypeCheck: Map<TSchema, Validator>;
   /**
    * List of modules that are registered in the container.
    *
@@ -493,6 +836,14 @@ declare class Alepha {
    * Mocked for browser environments.
    */
   readonly context: AlsProvider;
+  /**
+   * Event manager to handle lifecycle events and custom events.
+   */
+  readonly events: EventManager;
+  /**
+   * State manager to store arbitrary values.
+   */
+  readonly state: StateManager<State>;
   /**
    * Get logger instance.
    */
@@ -502,10 +853,6 @@ declare class Alepha {
    */
   get env(): Readonly<Env>;
   constructor(state?: Partial<State>);
-  /**
-   * State accessor and mutator.
-   */
-  state<Key extends keyof State>(key: Key, value?: State[Key]): State[Key];
   /**
    * True when start() is called.
    *
@@ -660,45 +1007,12 @@ declare class Alepha {
   configure<T extends {
     options: object;
   }>(service: Service<T>, state: Partial<T["options"]>): this;
-  /**
-   * Registers a hook for the specified event.
-   */
-  on<T extends keyof Hooks>(event: T, hookOrFunc: Hook<T> | ((payload: Hooks[T]) => Async<void>)): () => void;
-  /**
-   * Emits the specified event with the given payload.
-   */
-  emit<T extends keyof Hooks>(func: keyof Hooks, payload: Hooks[T], options?: {
-    /**
-     * If true, the hooks will be executed in reverse order.
-     * This is useful for "stop" hooks that should be executed in reverse order.
-     *
-     * @default false
-     */
-    reverse?: boolean;
-    /**
-     * If true, the hooks will be logged with their execution time.
-     *
-     * @default false
-     */
-    log?: boolean;
-    /**
-     * If true, errors will be caught and logged instead of throwing.
-     *
-     * @default false
-     */
-    catch?: boolean;
-  }): Promise<void>;
   /**
    * Casts the given value to the specified schema.
    *
    * It uses the TypeBox library to validate the value against the schema.
    */
-  parse<T extends TSchema$1>(schema: T, value?: any, opts?: {
-    /**
-     * Convert `null` to `undefined`
-     * @default true
-     */
-    convertNullToUndefined?: boolean;
+  parse<T extends TSchema>(schema: T, value?: unknown, opts?: {
     /**
      * Clone the value before parsing.
      * @default true
@@ -719,6 +1033,11 @@ declare class Alepha {
      * @default true
      */
     convert?: boolean;
+    /**
+     * Convert `null` to `undefined`
+     * @default true
+     */
+    convertNullToUndefined?: boolean;
     /**
      * Prepare value after being deserialized.
      * @default true
@@ -871,16 +1190,6 @@ interface RunOptions {
  */
 declare const OPTIONS: unique symbol;
 //#endregion
-//#region src/constants/PRIMITIVE.d.ts
-/**
- * Symbol to mark a value as a primitive.
- *
- * Used to enhance TypeBox types with metadata. See @alepha/protobuf.
- *
- * @internal
- */
-declare const PRIMITIVE: unique symbol;
-//#endregion
 //#region src/descriptors/$cursor.d.ts
 /**
  * Get Alepha instance and Class definition from the current context.
@@ -992,7 +1301,7 @@ declare const $env: <T extends TObject$1>(type: T) => Static$1<T>;
  *   }
  * }
  *
- * await alepha.emit("my:custom:hook", { arg1: "value" });
+ * await alepha.events.emit("my:custom:hook", { arg1: "value" });
  * ```
  *
  */
@@ -1062,274 +1371,10 @@ declare class TooLateSubstitutionError extends AlephaError {
 //#region src/errors/TypeBoxError.d.ts
 declare class TypeBoxError extends AlephaError {
   readonly name = "TypeBoxError";
-  readonly value: ValueError;
-  constructor(value: ValueError);
-}
-//#endregion
-//#region src/providers/TypeProvider.d.ts
-declare class TypeProvider {
-  /**
-   * Default maximum length for strings.
-   *
-   * It can be set to a larger value:
-   * ```ts
-   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = 1000000;
-   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = undefined; // no limit (not recommended)
-   * ```
-   */
-  static DEFAULT_STRING_MAX_LENGTH: number | undefined;
-  static DEFAULT_SHORT_STRING_MAX_LENGTH: number | undefined;
-  /**
-   * Maximum length for long strings, such as descriptions or comments.
-   * It can be overridden in the string options.
-   *
-   * It can be set to a larger value:
-   * ```ts
-   * TypeProvider.DEFAULT_LONG_STRING_MAX_LENGTH = 2048;
-   * ```
-   */
-  static DEFAULT_LONG_STRING_MAX_LENGTH: number | undefined;
-  /**
-   * Maximum length for rich strings, such as HTML or Markdown.
-   * This is a large value to accommodate rich text content.
-   * > It's also the maximum length of PG's TEXT type.
-   *
-   * It can be overridden in the string options.
-   *
-   * It can be set to a larger value:
-   * ```ts
-   * TypeProvider.DEFAULT_RICH_STRING_MAX_LENGTH = 1000000;
-   * ```
-   */
-  static DEFAULT_RICH_STRING_MAX_LENGTH: number | undefined;
-  /**
-   * Maximum number of items in an array.
-   * This is a default value to prevent excessive memory usage.
-   * It can be overridden in the array options.
-   */
-  static DEFAULT_ARRAY_MAX_ITEMS: number;
-  static FormatRegistry: typeof FormatRegistry;
-  raw: TypeBox.JavaScriptTypeBuilder;
-  any: (options?: SchemaOptions) => TAny$1;
-  void: (options?: SchemaOptions) => TypeBox.TVoid;
-  undefined: (options?: SchemaOptions) => TypeBox.TUndefined;
-  record: <Key extends TSchema$1, Value extends TSchema$1>(key: Key, value: Value, options?: ObjectOptions) => TypeBox.TRecordOrObject<Key, Value>;
-  omit: {
-    <Type extends TSchema$1, Key extends PropertyKey[]>(type: Type, key: readonly [...Key], options?: SchemaOptions): TOmit<Type, Key>;
-    <Type extends TSchema$1, Key extends TSchema$1>(type: Type, key: Key, options?: SchemaOptions): TOmit<Type, Key>;
-  };
-  partial: {
-    <MappedResult extends TypeBox.TMappedResult>(type: MappedResult, options?: SchemaOptions): TypeBox.TPartialFromMappedResult<MappedResult>;
-    <Type extends TSchema$1>(type: Type, options?: SchemaOptions): TPartial<Type>;
-  };
-  union: <Types extends TSchema$1[]>(types: [...Types], options?: SchemaOptions) => TypeBox.Union<Types>;
-  composite: <T extends TSchema$1[]>(schemas: [...T], options?: ObjectOptions) => TComposite<T>;
-  pick: {
-    <Type extends TSchema$1, Key extends PropertyKey[]>(type: Type, key: readonly [...Key], options?: SchemaOptions): TPick<Type, Key>;
-    <Type extends TSchema$1, Key extends TSchema$1>(type: Type, key: Key, options?: SchemaOptions): TPick<Type, Key>;
-  };
-  /**
-   * Create a schema for an object.
-   *
-   * @param properties The properties of the object.
-   * @param options The options for the object.
-   */
-  object<T extends TProperties$1>(properties: T, options?: ObjectOptions): TObject$1<T>;
-  /**
-   * Create a schema for an array.
-   *
-   * @param schema
-   * @param options
-   */
-  array<T extends TSchema$1>(schema: T, options?: ArrayOptions): TArray$1<T>;
-  /**
-   * Create a schema for a string.
-   *
-   * @param options
-   */
-  string(options?: AlephaStringOptions): TString$1;
-  /**
-   * Create a schema for a JSON object.
-   *
-   * @param options
-   */
-  json(options?: SchemaOptions): TRecord$1<TString$1, TAny$1>;
-  /**
-   * Create a schema for a boolean.
-   *
-   * @param options
-   */
-  boolean(options?: SchemaOptions): TBoolean$1;
-  /**
-   * Create a schema for a number.
-   *
-   * @param options
-   */
-  number(options?: NumberOptions): TNumber$1;
-  /**
-   * Create a schema for an unsigned 8-bit integer.
-   *
-   * @param options
-   */
-  uchar(options?: IntegerOptions): TInteger;
-  /**
-   * Create a schema for an unsigned 32-bit integer.
-   */
-  uint(options?: IntegerOptions): TNumber$1;
-  /**
-   * Create a schema for a signed 32-bit integer.
-   */
-  int(options?: IntegerOptions): TInteger;
-  /**
-   * Create a schema for a signed 32-bit integer.
-   */
-  integer(options?: IntegerOptions): TInteger;
-  /**
-   * Create a schema for a bigint. Bigint is a 64-bit integer.
-   * This is a workaround for TypeBox, which does not support bigint natively.
-   */
-  bigint(options?: NumberOptions): TNumber$1;
-  /**
-   * Make a schema optional.
-   *
-   * @param schema The schema to make optional.
-   */
-  optional<T extends TSchema$1>(schema: T): TOptionalWithFlag<T, true>;
-  /**
-   * Make a schema nullable.
-   *
-   * @param schema The schema to make nullable.
-   * @param options The options for the schema.
-   */
-  nullable<T extends TSchema$1>(schema: T, options?: ObjectOptions): TUnion$1<[TNull$1, T]>;
-  nullify: <T extends TSchema$1>(schema: T, options?: ObjectOptions) => TObject$1<TypeBox.Evaluate<TypeBox.TMappedFunctionReturnType<TypeBox.TIndexPropertyKeys<TypeBox.TKeyOf<T>>, TUnion$1<[TNull$1, TypeBox.TMappedResult<TypeBox.Evaluate<TypeBox.TIndexPropertyKeys<TypeBox.TKeyOf<T>> extends infer T_1 ? T_1 extends TypeBox.TIndexPropertyKeys<TypeBox.TKeyOf<T>> ? T_1 extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? Right extends [infer Left extends PropertyKey, ...infer Right extends PropertyKey[]] ? /*elided*/any : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : { [_ in Left]: TypeBox.Assert<TypeBox.TIndexFromPropertyKey<T, Left>, TSchema$1> } : {} : never : never>>]>, {}>>>;
-  /**
-   * Map a schema to another schema.
-   *
-   * @param schema The schema to map.
-   * @param operations The operations to perform on the schema.
-   * @param options The options for the schema.
-   * @returns The mapped schema.
-   */
-  map<T extends TObject$1 | TIntersect, Omit extends (keyof T["properties"])[], Optional extends (keyof T["properties"])[]>(schema: T, operations: {
-    omit: readonly [...Omit];
-    optional: [...Optional];
-  }, options?: ObjectOptions): TComposite<[TOmit<T, [...Omit, ...Optional]>, TPartial<TPick<T, Optional>>]>;
-  /**
-   * Create a schema for a string enum.
-   *
-   * @param values
-   * @param options
-   */
-  enum<T extends string[]>(values: [...T], options?: StringOptions): TUnsafe<T[number]>;
-  /**
-   * Create a schema for a datetime.
-   *
-   * @param options The options for the date.
-   */
-  datetime(options?: StringOptions): TString$1;
-  /**
-   * Create a schema for a date.
-   *
-   * @param options
-   */
-  date(options?: StringOptions): TString$1;
-  /**
-   * Create a schema for uuid.
-   *
-   * @param options The options for the duration.
-   */
-  uuid(options?: StringOptions): TString$1;
-  unsafe<T>(kind: string, options?: UnsafeOptions): TUnsafe<T>;
-  file(options?: {
-    max?: number;
-  }): TFile;
-  stream(): TStream;
-  /**
-   * Create a schema for a string enum e.g. LIKE_THIS.
-   *
-   * @param options
-   */
-  snakeCase: (options?: StringOptions) => TString$1;
-  /**
-   * Create a schema for an object with a value and label.
-   */
-  valueLabel: (options?: ObjectOptions) => TObject$1<{
-    value: TString$1;
-    label: TString$1;
-    description: TypeBox.TOptional<TString$1>;
-  }>;
+  readonly cause: TLocalizedValidationError;
+  readonly value: any;
+  constructor(error: TLocalizedValidationError, value: any);
 }
-interface FileLike {
-  /**
-   * Filename.
-   * @default "file"
-   */
-  name: string;
-  /**
-   * Mandatory MIME type of the file.
-   * @default "application/octet-stream"
-   */
-  type: string;
-  /**
-   * Size of the file in bytes.
-   *
-   * Always 0 for streams, as the size is not known until the stream is fully read.
-   *
-   * @default 0
-   */
-  size: number;
-  /**
-   * Last modified timestamp in milliseconds since epoch.
-   *
-   * Always the current timestamp for streams, as the last modified time is not known.
-   * We use this field to ensure compatibility with File API.
-   *
-   * @default Date.now()
-   */
-  lastModified: number;
-  /**
-   * Returns a ReadableStream or Node.js Readable stream of the file content.
-   *
-   * For streams, this is the original stream.
-   */
-  stream(): StreamLike;
-  /**
-   * Returns the file content as an ArrayBuffer.
-   *
-   * For streams, this reads the entire stream into memory.
-   */
-  arrayBuffer(): Promise<ArrayBuffer>;
-  /**
-   * Returns the file content as a string.
-   *
-   * For streams, this reads the entire stream into memory and converts it to a string.
-   */
-  text(): Promise<string>;
-  /**
-   * Optional file path, if the file is stored on disk.
-   *
-   * This is not from the File API, but rather a custom field to indicate where the file is stored.
-   */
-  filepath?: string;
-}
-/**
- * TypeBox view of FileLike.
- */
-type TFile = TUnsafe<FileLike>;
-declare const isTypeFile: (value: TSchema$1) => value is TFile;
-declare const isFileLike: (value: any) => value is FileLike;
-type StreamLike = ReadableStream | ReadableStream$1 | Readable | NodeJS.ReadableStream;
-type TStream = TUnsafe<StreamLike>;
-type TextLength = "short" | "long" | "rich";
-interface AlephaStringOptions extends StringOptions {
-  size?: TextLength;
-}
-declare const t: TypeProvider;
-declare function isISODate(str: string): boolean;
-declare function isISODateTime(value: string): boolean;
-declare function isUUID(value: string): boolean;
-declare function isEmail(value: string): boolean;
 //#endregion
 //#region src/index.d.ts
 declare global {
@@ -1345,5 +1390,5 @@ declare global {
  */
 declare const run: (entry: Alepha | Service | Array<Service>, opts?: RunOptions) => void;
 //#endregion
-export { $cursor, $env, $hook, $inject, $module, AbstractClass, Alepha, AlephaError, AlephaStringOptions, AlsProvider, AppNotStartedError, Async, AsyncFn, AsyncLocalStorageData, CircularDependencyError, ContainerLockedError, CursorDescriptor, Descriptor, DescriptorArgs, DescriptorConfig, DescriptorFactory, DescriptorFactoryLike, Env, FileLike, Hook, HookDescriptor, HookOptions, Hooks, InjectDescriptor, InjectOptions, InstantiableClass, KIND, LogLevel, LoggerInterface, MaybePromise, Module, ModuleDescriptorOptions, OPTIONS, PRIMITIVE, Service, ServiceEntry, ServiceSubstitution, State, type Static, type StaticDecode, type StaticEncode, StreamLike, type TAny, type TArray, type TBoolean, TFile, type TNull, type TNumber, type TObject, type TOptional, type TProperties, type TRecord, type TSchema, TStream, type TString, type TUnion, TextLength, TooLateSubstitutionError, TypeBox, TypeBoxError, TypeBoxValue, TypeGuard, TypeProvider, WithModule, __alephaRef, createDescriptor, isEmail, isFileLike, isISODate, isISODateTime, isTypeFile, isUUID, run, t };
+export { $cursor, $env, $hook, $inject, $module, AbstractClass, Alepha, AlephaError, AlephaStringOptions, AlsProvider, AppNotStartedError, Async, AsyncFn, AsyncLocalStorageData, CircularDependencyError, ContainerLockedError, CursorDescriptor, Descriptor, DescriptorArgs, DescriptorConfig, DescriptorFactory, DescriptorFactoryLike, Env, FileLike, Hook, HookDescriptor, HookOptions, Hooks, InjectDescriptor, InjectOptions, InstantiableClass, KIND, LogLevel, LoggerInterface, MaybePromise, Module, ModuleDescriptorOptions, OPTIONS, Service, ServiceEntry, ServiceSubstitution, State, StateManager, type Static, type StaticDecode, type StaticEncode, StreamLike, type TAny, type TArray, type TBigInt, type TBoolean, TFile, type TInteger, type TKeysToIndexer, type TNull, type TNumber, type TNumberOptions, type TObject, type TObjectOptions, type TOptional, type TOptionalAdd, type TPick, type TProperties, type TRecord, type TSchema, TStream, type TString, type TStringOptions, type TTuple, type TUnion, type TVoid, TextLength, TooLateSubstitutionError, TypeBox, TypeBoxError, TypeBoxValue, TypeGuard, TypeProvider, WithModule, __alephaRef, createDescriptor, isFileLike, isTypeFile, run, t };
 //# sourceMappingURL=index.d.ts.map