alepha 0.13.0 → 0.13.2

package/dist/core/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":["KIND: unique symbol","MODULE: unique symbol","OPTIONS: unique symbol","__alephaRef: {\n  alepha?: Alepha;\n  service?: Service & {\n    [MODULE]?: Service;\n  };\n  parent?: Service;\n}","error: any","obj: any","ctx: any","atoms: Array<AtomWithValue>","entry: ServiceEntry<T>","instance: T","definition: ServiceDefinition<T>","parent","graph: Record<\n      string,\n      { from: string[]; as?: string[]; module?: string }\n    >","list: Array<T>","t: TypeProvider"],"sources":["../../src/core/constants/KIND.ts","../../src/core/constants/MODULE.ts","../../src/core/constants/OPTIONS.ts","../../src/core/errors/AlephaError.ts","../../src/core/descriptors/$module.ts","../../src/core/errors/CircularDependencyError.ts","../../src/core/errors/ContainerLockedError.ts","../../src/core/errors/TooLateSubstitutionError.ts","../../src/core/errors/MissingContextError.ts","../../src/core/helpers/ref.ts","../../src/core/descriptors/$context.ts","../../src/core/helpers/descriptor.ts","../../src/core/interfaces/Service.ts","../../src/core/providers/AlsProvider.ts","../../src/core/descriptors/$inject.ts","../../src/core/providers/Json.ts","../../src/core/providers/SchemaCodec.ts","../../src/core/providers/JsonSchemaCodec.ts","../../src/core/errors/TypeBoxError.ts","../../src/core/providers/SchemaValidator.ts","../../src/core/providers/CodecManager.ts","../../src/core/providers/EventManager.ts","../../src/core/descriptors/$atom.ts","../../src/core/providers/StateManager.ts","../../src/core/Alepha.ts","../../src/core/helpers/FileLike.ts","../../src/core/providers/TypeProvider.ts","../../src/core/descriptors/$env.ts","../../src/core/descriptors/$hook.ts","../../src/core/descriptors/$use.ts","../../src/core/errors/AppNotStartedError.ts","../../src/core/helpers/createPagination.ts","../../src/core/schemas/pageQuerySchema.ts","../../src/core/schemas/pageSchema.ts","../../src/core/index.browser.ts"],"sourcesContent":["/**\n * Used for identifying descriptors.\n *\n * @internal\n */\nexport const KIND: unique symbol = Symbol.for(\"Alepha.Kind\");\n","/**\n * Used for identifying modules.\n *\n * @internal\n */\nexport const MODULE: unique symbol = Symbol.for(\"Alepha.Module\");\n","/**\n * Used for descriptors options.\n *\n * @internal\n */\nexport const OPTIONS: unique symbol = Symbol.for(\"Alepha.Options\");\n","// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Default error class for Alepha.\n */\nexport class AlephaError extends Error {\n  name = \"AlephaError\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n","import type { Alepha } from \"../Alepha.ts\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport type { DescriptorFactoryLike } from \"../helpers/descriptor.ts\";\nimport type { Service } from \"../interfaces/Service.ts\";\n\n/**\n * Wrap Services and Descriptors into a Module.\n *\n * - A module is just a Service with some extra {@link Module}.\n * - You must attach a `name` to it.\n * - Name must follow the pattern: `project.module.submodule`. (e.g. `myapp.users.auth`).\n *\n * @example\n * ```ts\n * import { $module } from \"alepha\";\n * import { MyService } from \"./MyService.ts\";\n *\n * // export MyService, so it can be used everywhere (optional)\n * export * from \"./MyService.ts\";\n *\n * export default $module({\n *  name: \"my.project.module\",\n *  // MyService will have a module context \"my.project.module\"\n *  services: [MyService],\n * });\n * ```\n *\n * ### Why Modules?\n *\n * #### Logging\n *\n * By default, AlephaLogger will log the module name in the logs.\n * This helps to identify where the logs are coming from.\n *\n * You can also set different log levels for different modules.\n * It means you can set 'some.very.specific.module' to 'debug' and keep the rest of the application to 'info'.\n *\n * #### Modulith\n *\n * Force to structure your application in modules, even if it's a single deployable unit.\n * It helps to keep a clean architecture and avoid monolithic applications.\n *\n * A strict mode flag will probably come to enforce module boundaries.\n * -> Throwing errors when a service from another module is injected.\n * But it's not implemented yet.\n *\n * ### When not to use Modules?\n *\n * Small applications does not need modules. It's better to keep it simple.\n * Modules are more useful when the application grows and needs to be structured.\n * If we speak with number of `$actions`, a module should be used when you have more than 30 actions in a single module.\n * Meaning that if you have 100 actions, you should have at least 3 modules.\n */\nexport const $module = <T extends object = {}>(\n  options: ModuleDescriptorOptions,\n): Service<Module> => {\n  const { services = [], descriptors = [], name } = options;\n\n  // ensure name is valid\n  if (!name || !Module.NAME_REGEX.test(name)) {\n    throw new AlephaError(\n      `Invalid module name '${name}'. It should be in the format of 'project.module.submodule'`,\n    );\n  }\n\n  const $ = class extends Module {\n    options = options;\n\n    register(alepha: Alepha): void {\n      if (typeof options.register === \"function\") {\n        options.register(alepha);\n        return;\n      }\n\n      for (const service of services) {\n        alepha.inject(service, {\n          parent: this.constructor as Service<Module>,\n        });\n      }\n    }\n  };\n\n  // force name property\n  Object.defineProperty($, \"name\", {\n    value: name,\n    writable: false,\n  });\n\n  for (const service of services) {\n    if (!Module.is(service)) {\n      (service as WithModule)[MODULE] = $;\n    }\n  }\n\n  for (const factory of descriptors) {\n    if (typeof factory[KIND] === \"function\") {\n      factory[KIND][MODULE] = $;\n    }\n  }\n\n  return $; // module as Service<Module<T>>;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ModuleDescriptorOptions {\n  /**\n   * Name of the module.\n   *\n   * It should be in the format of `project.module.submodule`.\n   */\n  name: string;\n\n  /**\n   * List all services related to this module.\n   *\n   * If you don't declare 'register' function, all services will be registered automatically.\n   * If you declare 'register' function, you must handle the registration of ALL services manually.\n   */\n  services?: Array<Service>;\n\n  /**\n   * List of $descriptors to register in the module.\n   */\n  descriptors?: Array<DescriptorFactoryLike>;\n\n  /**\n   * By default, module will register ALL services.\n   * You can override this behavior by providing a register function.\n   * It's useful when you want to register services conditionally or in a specific order.\n   *\n   * Again, if you declare 'register', you must handle the registration of ALL services manually.\n   */\n  register?: (alepha: Alepha) => void;\n}\n\n/**\n * Base class for all modules.\n */\nexport abstract class Module {\n  public abstract readonly options: ModuleDescriptorOptions;\n\n  public abstract register(alepha: Alepha): void;\n\n  static NAME_REGEX = /^[a-z]+(\\.[a-z][a-z0-9-]*)*$/;\n\n  /**\n   * Check if a Service is a Module.\n   */\n  static is(ctor: Service): boolean {\n    return ctor.prototype instanceof Module;\n  }\n\n  /**\n   * Get the Module of a Service.\n   *\n   * Returns undefined if the Service is not part of a Module.\n   */\n  static of(ctor: Service): Service<Module> | undefined {\n    return (ctor as WithModule)[MODULE];\n  }\n}\n\n/**\n * Helper type to add Module metadata to a Service.\n */\nexport type WithModule<T extends object = any> = T & {\n  [MODULE]?: Service;\n};\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class CircularDependencyError extends AlephaError {\n  readonly name = \"CircularDependencyError\";\n\n  constructor(provider: string, parents?: string[]) {\n    super(\n      `Instance not available. Looks like a circular dependency. ? -> ${parents?.map((name) => `${name} -> `).join(\"\")}${provider} -> ?`,\n    );\n  }\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class ContainerLockedError extends AlephaError {\n  readonly name = \"ContainerLockedError\";\n\n  constructor(\n    message = \"Container is locked. No more providers can be added.\",\n  ) {\n    super(message);\n  }\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class TooLateSubstitutionError extends AlephaError {\n  readonly name = \"TooLateSubstitutionError\";\n\n  constructor(original: string, substitution: string) {\n    super(\n      `Service already substituted. Please, substitute Service '${original}' with Service '${substitution}' before using it.`,\n    );\n  }\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class MissingContextError extends AlephaError {\n  readonly name = \"MissingContextError\";\n\n  constructor() {\n    super(\"Missing context. Did you forget to call Alepha.create()?\");\n    this.name = \"MissingContextError\";\n  }\n}\n","import type { Alepha } from \"../Alepha.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport type { Service } from \"../interfaces/Service.ts\";\n\n/**\n * Store the current context and definition during injection phase.\n *\n * @internal\n */\nexport const __alephaRef: {\n  alepha?: Alepha;\n  service?: Service & {\n    [MODULE]?: Service;\n  };\n  parent?: Service;\n} = {};\n\n/**\n * Note:\n *\n * This file is used to share context between $descriptors and the Alepha core during the injection phase.\n *\n * There is no side effect as long as Alepha is not used concurrently in multiple contexts (which is not the case).\n *\n * // __alephaRef === undefined\n * // begin alepha.with()\n * //   __alephaRef.context = alepha\n * //   ... injection phase ...\n * //   __alephaRef.context = undefined\n * // end alepha.with()\n * // __alephaRef === undefined\n *\n * As .with() is synchronous, there is no risk of context leakage.\n *\n * ---------------------------------------------------------------------------------------------------------------------\n *\n * Why this helper?\n *\n * It allows to avoid passing Alepha instance to every $hook, $inject, etc. calls. It's a beautiful syntactic sugar.\n *\n * With sugar:\n *\n * class A {\n *   on = $hook( ... ) // <- __alephaRef is set here\n * }\n *\n * Without sugar:\n *\n * class A {\n *   constructor(alepha: Alepha) {\n *     this.on = $hook(alepha, ... ) // <- no need of __alephaRef\n *   }\n * }\n *\n * One main goal of Alepha is working with classes but without the class verbosity.\n * Forcing to pass Alepha instance in constructors would be a step back in that direction!\n */\n","import type { Alepha } from \"../Alepha.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport { MissingContextError } from \"../errors/MissingContextError.ts\";\nimport { __alephaRef } from \"../helpers/ref.ts\";\nimport type { Service } from \"../interfaces/Service.ts\";\n\n/**\n * Get Alepha instance and current service from the current context.\n *\n * It can only be used inside $descriptor functions.\n *\n * ```ts\n * import { $context } from \"alepha\";\n *\n * const $hello = () => {\n *   const { alepha, service, module } = $context();\n *\n *   // alepha - alepha instance\n *   // service - class which is creating this descriptor, this is NOT the instance but the service definition\n *   // module - module definition, if any\n *\n *   return {};\n * }\n *\n * class MyService {\n *   hello = $hello();\n * }\n *\n * const alepha = new Alepha().with(MyService);\n * ```\n *\n * @internal\n */\nexport const $context = (): ContextDescriptor => {\n  if (!__alephaRef.alepha) {\n    throw new MissingContextError();\n  }\n\n  return {\n    alepha: __alephaRef.alepha,\n    service: __alephaRef.service,\n    module: __alephaRef.service?.[MODULE],\n  };\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ContextDescriptor {\n  /**\n   * Alepha instance.\n   */\n  alepha: Alepha;\n  /**\n   * Service definition which is creating this descriptor.\n   * This is NOT the instance but the service definition.\n   */\n  service?: Service;\n  /**\n   * Module definition, if any.\n   */\n  module?: Service;\n}\n","import { Alepha } from \"../Alepha.ts\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport { $context } from \"../descriptors/$context.ts\";\nimport type { InstantiableClass, Service } from \"../interfaces/Service.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface DescriptorArgs<T extends object = {}> {\n  options: T;\n  alepha: Alepha;\n  service: InstantiableClass<Service>;\n  module?: Service;\n}\n\nexport interface DescriptorConfig {\n  propertyKey: string;\n  service: InstantiableClass<Service>;\n  module?: Service;\n}\n\nexport abstract class Descriptor<T extends object = {}> {\n  protected readonly alepha: Alepha;\n\n  public readonly options: T;\n  public readonly config: DescriptorConfig;\n\n  constructor(args: DescriptorArgs<T>) {\n    this.alepha = args.alepha;\n    this.options = args.options;\n    this.config = {\n      propertyKey: \"\",\n      service: args.service,\n      module: args.module,\n    };\n  }\n\n  /**\n   * Called automatically by Alepha after the descriptor is created.\n   */\n  protected onInit(): void {\n    // this method can be overridden by subclasses to perform initialization logic.\n    // - use onInit instead of the constructor when you need to access `config.propertyKey`\n    // - onInit must be synchronous\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type DescriptorFactory<TDescriptor extends Descriptor = Descriptor> = {\n  (options: TDescriptor[\"options\"]): TDescriptor;\n  [KIND]: InstantiableClass<TDescriptor>;\n};\n\nexport type DescriptorFactoryLike<T extends object = any> = {\n  (options: T): any;\n  [KIND]: any;\n};\n\nexport const createDescriptor = <TDescriptor extends Descriptor>(\n  descriptor: InstantiableClass<TDescriptor> & { [MODULE]?: Service },\n  options: TDescriptor[\"options\"],\n): TDescriptor => {\n  const { alepha, service } = $context();\n\n  if (MODULE in descriptor && descriptor[MODULE]) {\n    alepha.with(descriptor[MODULE]);\n  }\n\n  return alepha.inject(descriptor, {\n    lifetime: \"transient\",\n    args: [\n      {\n        options,\n        alepha: alepha,\n        service: service ?? Alepha,\n      },\n    ],\n  });\n};\n","// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In Alepha, a service is a class that can be instantiated or an abstract class. Nothing more, nothing less...\n */\nexport type Service<T extends object = any> =\n  | InstantiableClass<T>\n  | AbstractClass<T>\n  | RunFunction<T>;\n\nexport type RunFunction<T extends object = any> = (...args: any[]) => T | void;\n\nexport type InstantiableClass<T extends object = any> = new (\n  ...args: any[]\n) => T;\n\n/**\n * Abstract class is a class that cannot be instantiated directly!\n * It widely used for defining interfaces.\n */\nexport type AbstractClass<T extends object = any> = abstract new (\n  ...args: any[]\n) => T;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Service substitution allows you to register a class as a different class.\n * Providing class A, but using class B instead.\n * This is useful for testing, mocking, or providing a different implementation of a service.\n *\n * class A is mostly an AbstractClass, while class B is an InstantiableClass.\n */\nexport interface ServiceSubstitution<T extends object = any> {\n  /**\n   * Every time someone asks for this class, it will be provided with the 'use' class.\n   */\n  provide: Service<T>;\n\n  /**\n   * Service to use instead of the 'provide' service.\n   *\n   * Syntax is inspired by Angular's DI system.\n   */\n  use: Service<T>;\n\n  /**\n   * If true, if the service already exists -> just ignore the substitution and do not throw an error.\n   * Mostly used for plugins to enforce a substitution without throwing an error.\n   */\n  optional?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Every time you register a service, you can use this type to define it.\n *\n * alepha.with( ServiceEntry )\n * or\n * alepha.with( provide: ServiceEntry, use: MyOwnServiceEntry )\n *\n * And yes, you declare the *type* of the service, not the *instance*.\n */\nexport type ServiceEntry<T extends object = any> =\n  | Service<T>\n  | ServiceSubstitution<T>;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function isClass(func: any): func is InstantiableClass {\n  // Classes have a non-writable prototype.constructor\n  if (typeof func !== \"function\") return false;\n\n  const descriptor = Object.getOwnPropertyDescriptor(func, \"prototype\");\n  return !!descriptor && !descriptor.writable;\n}\n","import type { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport type AsyncLocalStorageData = any;\n\nexport class AlsProvider {\n  static create = (): AsyncLocalStorage<AsyncLocalStorageData> | undefined => {\n    return undefined;\n  };\n\n  public als?: AsyncLocalStorage<AsyncLocalStorageData>;\n\n  constructor() {\n    this.als = AlsProvider.create();\n  }\n\n  public createContextId(): string {\n    return crypto.randomUUID();\n  }\n\n  public run<R>(callback: () => R, data: Record<string, any> = {}): R {\n    if (!this.als) {\n      return callback();\n    }\n\n    data.registry ??= new Map();\n    data.context ??= this.createContextId();\n\n    return this.als.run(data, callback);\n  }\n\n  public exists(): boolean {\n    return !!this.get(\"context\");\n  }\n\n  public get<T>(key: string): T | undefined {\n    if (!this.als) {\n      return undefined;\n    }\n\n    const store = this.als.getStore();\n    if (store) {\n      return store[key] as T;\n    }\n\n    return undefined;\n  }\n\n  public set<T>(key: string, value: T): void {\n    if (!this.als) {\n      return;\n    }\n\n    const store = this.als.getStore();\n    if (store) {\n      store[key] = value;\n    }\n  }\n}\n","import { Descriptor } from \"../helpers/descriptor.ts\";\nimport type { InstantiableClass, Service } from \"../interfaces/Service.ts\";\nimport { $context } from \"./$context.ts\";\n\n/**\n * Get the instance of the specified type from the context.\n *\n * ```ts\n * class A { }\n * class B {\n *   a = $inject(A);\n * }\n * ```\n */\nexport const $inject = <T extends object>(\n  type: Service<T>,\n  opts: InjectOptions<T> = {},\n): T => {\n  const { alepha, service } = $context();\n\n  // _ = $inject(Alepha)\n  if (type === alepha.constructor) {\n    return alepha as T;\n  }\n\n  return alepha.inject(type, {\n    // keep the parent for better error messages and circular dependencies detection\n    parent: service ?? (alepha.constructor as Service),\n    ...opts,\n  });\n};\n\nexport class InjectDescriptor extends Descriptor {}\n\nexport interface InjectOptions<T extends object = any> {\n  /**\n   * - 'transient' → Always a new instance on every inject. Zero caching.\n   * - 'singleton' → One instance per Alepha runtime (per-thread). Never disposed until Alepha shuts down. (default)\n   * - 'scoped' → One instance per AsyncLocalStorage context.\n   *   - A new scope is created when Alepha handles a request, a scheduled job, a queue worker task...\n   *   - You can also start a manual scope via alepha.context.run(() => { ... }).\n   *   - When the scope ends, the scoped registry is discarded.\n   *\n   * @default \"singleton\"\n   */\n  lifetime?: \"transient\" | \"singleton\" | \"scoped\";\n\n  /**\n   * Constructor arguments to pass when creating a new instance.\n   */\n  args?: ConstructorParameters<InstantiableClass<T>>;\n\n  /**\n   * Parent that requested the instance.\n   *\n   * @internal\n   */\n  parent?: Service | null;\n}\n","/**\n * Mimics the JSON global object with stringify and parse methods.\n *\n * Used across the codebase via dependency injection.\n */\nexport class Json {\n  public stringify(\n    value: any,\n    replacer?: (this: any, key: string, value: any) => any,\n    space?: string | number,\n  ): string {\n    return JSON.stringify(value, replacer, space);\n  }\n\n  public parse(\n    text: string,\n    reviver?: (this: any, key: string, value: any) => any,\n  ) {\n    return JSON.parse(text, reviver);\n  }\n}\n","import type { Static, TSchema } from \"./TypeProvider.ts\";\n\nexport abstract class SchemaCodec {\n  /**\n   * Encode the value to a string format.\n   */\n  public abstract encodeToString<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): string;\n\n  /**\n   * Encode the value to a binary format.\n   */\n  public abstract encodeToBinary<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): Uint8Array;\n\n  /**\n   * Decode string, binary, or other formats to the schema type.\n   */\n  public abstract decode<T>(schema: TSchema, value: unknown): T;\n}\n","import type { TSchema } from \"typebox\";\nimport { $inject } from \"../descriptors/$inject.ts\";\nimport { Json } from \"./Json.ts\";\nimport { SchemaCodec } from \"./SchemaCodec.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport class JsonSchemaCodec extends SchemaCodec {\n  protected readonly json = $inject(Json);\n  protected readonly encoder = new TextEncoder();\n  protected readonly decoder = new TextDecoder();\n\n  public encodeToString<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): string {\n    return this.json.stringify(value);\n  }\n\n  public encodeToBinary<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): Uint8Array {\n    return this.encoder.encode(this.encodeToString(schema, value));\n  }\n\n  public decode<T>(schema: TSchema, value: unknown): T {\n    if (value instanceof Uint8Array) {\n      const text = this.decoder.decode(value);\n      return this.json.parse(text);\n    }\n\n    if (typeof value === \"string\") {\n      // Only parse if it looks like JSON (starts with { or [)\n      const trimmed = value.trim();\n      if (trimmed.startsWith(\"{\") || trimmed.startsWith(\"[\")) {\n        return this.json.parse(value);\n      }\n      // Return plain strings as-is\n      return value as T;\n    }\n\n    return value as T;\n  }\n}\n","import type { TLocalizedValidationError } from \"typebox/error\";\nimport { AlephaError } from \"./AlephaError.ts\";\n\nexport class TypeBoxError extends AlephaError {\n  name = \"TypeBoxError\";\n\n  public readonly cause: TLocalizedValidationError;\n  public readonly value: {\n    path: string;\n    message: string;\n  };\n\n  constructor(error: TLocalizedValidationError) {\n    super(\n      `Invalid input: ${error.message}${error.instancePath ? ` at ${error.instancePath}` : \"\"}`,\n      {\n        cause: error,\n      },\n    );\n    const params = error.params as TypeBoxErrorParams;\n    if (params?.requiredProperties) {\n      this.value = {\n        path: `/${params.requiredProperties[0]}`,\n        message: \"must be defined\",\n      };\n    } else {\n      this.value = {\n        path: error.instancePath,\n        message: error.message,\n      };\n    }\n\n    this.cause = error;\n  }\n}\n\nexport interface TypeBoxErrorParams {\n  requiredProperties?: string[];\n}\n","import type { TSchema } from \"typebox\";\nimport { Compile, type Validator } from \"typebox/compile\";\nimport { TypeBoxError } from \"../errors/TypeBoxError.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport class SchemaValidator {\n  protected cache = new Map<TSchema, Validator>();\n\n  /**\n   * Validate the value against the provided schema.\n   *\n   * Validation create a new value by applying some preprocessing. (e.g., trimming text)\n   */\n  public validate<T extends TSchema>(\n    schema: T,\n    value: unknown,\n    options: ValidateOptions = {},\n  ): Static<T> {\n    const newValue = this.beforeParse(schema, value, {\n      trim: options.trim ?? true,\n      nullToUndefined: options.nullToUndefined ?? true,\n      deleteUndefined: options.deleteUndefined ?? true,\n    });\n\n    try {\n      return this.getValidator(schema).Parse(newValue);\n    } catch (error: any) {\n      if (error.cause?.errors?.[0]) {\n        throw new TypeBoxError(error.cause.errors[0]);\n      }\n      throw error;\n    }\n  }\n\n  protected getValidator<T extends TSchema>(schema: T): Validator<{}, T> {\n    if (this.cache.has(schema)) {\n      return this.cache.get(schema) as Validator<{}, T>;\n    }\n\n    const validator = Compile(schema);\n    this.cache.set(schema, validator);\n    return validator as Validator<{}, T>;\n  }\n\n  /**\n   * Preprocess the value based on the schema before validation.\n   *\n   * - If the value is `null` and the schema does not allow `null`, it converts it to `undefined`.\n   * - If the value is a string and the schema has a `~options.trim` flag, it trims whitespace from the string.\n   */\n  public beforeParse(schema: any, value: any, options: ValidateOptions): any {\n    if (!schema) {\n      return value;\n    }\n\n    if (\n      value === null &&\n      !this.isSchemaNullable(schema) &&\n      options.nullToUndefined\n    ) {\n      return undefined;\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((it) => this.beforeParse(schema.items, it, options));\n    }\n\n    if (typeof value === \"string\" && schema.type === \"string\") {\n      let str = value;\n\n      if (options.trim && schema[\"~options\"]?.trim) {\n        str = str.trim();\n      }\n\n      if (schema[\"~options\"]?.lowercase) {\n        str = str.toLowerCase();\n      }\n\n      return str;\n    }\n\n    if (\n      typeof value === \"object\" &&\n      value !== null &&\n      schema.type === \"object\"\n    ) {\n      const obj: any = {};\n\n      for (const key in value) {\n        const newValue = this.beforeParse(\n          schema.properties?.[key],\n          value[key],\n          options,\n        );\n\n        if (newValue === undefined && options.deleteUndefined) {\n          continue;\n        }\n\n        obj[key] = newValue;\n      }\n\n      return obj;\n    }\n\n    return value;\n  }\n\n  /**\n   * Used by `beforeParse` to determine if a schema allows null values.\n   */\n  protected isSchemaNullable = (schema: any): boolean => {\n    if (!schema) {\n      return false;\n    }\n    if (schema.type === \"null\") {\n      return true;\n    }\n    if (Array.isArray(schema.type) && schema.type.includes(\"null\")) {\n      return true;\n    }\n    if (schema.anyOf) {\n      return schema.anyOf.some((it: any) => this.isSchemaNullable(it));\n    }\n    if (schema.oneOf) {\n      return schema.oneOf.some((it: any) => this.isSchemaNullable(it));\n    }\n    if (schema.allOf) {\n      return schema.allOf.some((it: any) => this.isSchemaNullable(it));\n    }\n    return false;\n  };\n}\n\nexport interface ValidateOptions {\n  trim?: boolean;\n  nullToUndefined?: boolean;\n  deleteUndefined?: boolean;\n}\n","import type { StaticEncode, TSchema } from \"typebox\";\nimport { $inject } from \"../descriptors/$inject.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport { JsonSchemaCodec } from \"./JsonSchemaCodec.ts\";\nimport type { SchemaCodec } from \"./SchemaCodec.ts\";\nimport { SchemaValidator, type ValidateOptions } from \"./SchemaValidator.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport type Encoding = \"object\" | \"string\" | \"binary\";\n\nexport interface EncodeOptions<T extends Encoding = Encoding> {\n  /**\n   * The output encoding format:\n   * - 'string': Returns JSON string\n   * - 'binary': Returns Uint8Array (for protobuf, msgpack, etc.)\n   *\n   * @default \"string\"\n   */\n  as?: T;\n\n  /**\n   * The encoder to use (e.g., 'json', 'protobuf', 'msgpack')\n   *\n   * @default \"json\"\n   */\n  encoder?: string;\n\n  /**\n   * Validation options to apply before encoding.\n   */\n  validation?: ValidateOptions | false;\n}\n\nexport type EncodeResult<\n  T extends TSchema,\n  E extends Encoding,\n> = E extends \"string\"\n  ? string\n  : E extends \"binary\"\n    ? Uint8Array\n    : StaticEncode<T>;\n\nexport interface DecodeOptions {\n  /**\n   * The encoder to use (e.g., 'json', 'protobuf', 'msgpack')\n   *\n   * @default \"json\"\n   */\n  encoder?: string;\n\n  /**\n   * Validation options to apply before encoding.\n   */\n  validation?: ValidateOptions | false;\n}\n\n/**\n * CodecManager manages multiple codec formats and provides a unified interface\n * for encoding and decoding data with different formats.\n */\nexport class CodecManager {\n  protected readonly codecs: Map<string, SchemaCodec> = new Map();\n  protected readonly jsonCodec = $inject(JsonSchemaCodec);\n  protected readonly schemaValidator = $inject(SchemaValidator);\n\n  public default = \"json\";\n\n  constructor() {\n    // Register default JSON codec\n    this.register(this.default, this.jsonCodec);\n  }\n\n  /**\n   * Register a new codec format.\n   *\n   * @param name - The name of the codec (e.g., 'json', 'protobuf')\n   * @param codec - The codec implementation\n   */\n  public register(name: string, codec: SchemaCodec): void {\n    this.codecs.set(name, codec);\n  }\n\n  /**\n   * Get a specific codec by name.\n   *\n   * @param name - The name of the codec\n   * @returns The codec instance\n   * @throws {AlephaError} If the codec is not found\n   */\n  public getCodec(name: string): SchemaCodec {\n    const codec = this.codecs.get(name);\n    if (!codec) {\n      throw new AlephaError(\n        `Codec \"${name}\" not found. Available codecs: ${Array.from(this.codecs.keys()).join(\", \")}`,\n      );\n    }\n    return codec;\n  }\n\n  /**\n   * Encode data using the specified codec and output format.\n   */\n  public encode<T extends TSchema, E extends Encoding = \"object\">(\n    schema: T,\n    value: unknown,\n    options?: EncodeOptions<E>,\n  ): EncodeResult<T, E> {\n    const codec = this.getCodec(options?.encoder ?? this.default);\n    const as = options?.as ?? \"object\";\n\n    if (options?.validation !== false) {\n      value = this.schemaValidator.validate(schema, value, options?.validation);\n    }\n\n    if (as === \"object\") {\n      // Return the validated object as-is\n      return value as EncodeResult<T, E>;\n    }\n\n    if (as === \"binary\") {\n      // not used by JSON, but for other codecs like Protobuf, MsgPack, etc.\n      return codec.encodeToBinary(schema, value as Static<T>) as EncodeResult<\n        T,\n        E\n      >;\n    }\n\n    // encode directly to string\n    return codec.encodeToString(schema, value as Static<T>) as EncodeResult<\n      T,\n      E\n    >;\n  }\n\n  /**\n   * Decode data using the specified codec.\n   */\n  public decode<T extends TSchema>(\n    schema: T,\n    data: any,\n    options?: DecodeOptions,\n  ): Static<T> {\n    const encoderName = options?.encoder ?? this.default;\n    const codec = this.getCodec(encoderName);\n    let value = codec.decode(schema, data);\n\n    if (options?.validation !== false) {\n      value = this.schemaValidator.validate(schema, value, options?.validation);\n    }\n\n    return value as Static<T>;\n  }\n\n  /**\n   * Validate decoded data against the schema.\n   *\n   * This is automatically called before encoding or after decoding.\n   */\n  public validate<T extends TSchema>(\n    schema: T,\n    value: unknown,\n    options?: ValidateOptions,\n  ): Static<T> {\n    return this.schemaValidator.validate(schema, value, options);\n  }\n}\n","import type { Hook, Hooks } from \"../Alepha.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport type { Async } from \"../interfaces/Async.ts\";\nimport type { LoggerInterface } from \"../interfaces/LoggerInterface.ts\";\n\nexport class EventManager {\n  protected logFn?: () => LoggerInterface | undefined;\n\n  /**\n   * List of events that can be triggered. Powered by $hook().\n   */\n  protected events: Record<string, Array<Hook>> = {};\n\n  constructor(logFn?: () => LoggerInterface | undefined) {\n    this.logFn = logFn;\n  }\n\n  protected get log(): LoggerInterface | undefined {\n    return this.logFn?.();\n  }\n\n  /**\n   * Registers a hook for the specified event.\n   */\n  public on<T extends keyof Hooks>(\n    event: T,\n    hookOrFunc: Hook<T> | ((payload: Hooks[T]) => Async<void>),\n  ): () => void {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n\n    const hook =\n      typeof hookOrFunc === \"function\" ? { callback: hookOrFunc } : hookOrFunc;\n\n    if (hook.priority === \"first\") {\n      this.events[event].unshift(hook);\n    } else if (hook.priority === \"last\") {\n      this.events[event].push(hook);\n    } else {\n      const index = this.events[event].findIndex(\n        (it) => it.priority === \"last\",\n      );\n      if (index !== -1) {\n        this.events[event].splice(index, 0, hook);\n      } else {\n        this.events[event].push(hook);\n      }\n    }\n\n    return () => {\n      this.events[event] = this.events[event].filter(\n        (it) => it.callback !== hook.callback,\n      );\n    };\n  }\n\n  /**\n   * Emits the specified event with the given payload.\n   */\n  public async emit<T extends keyof Hooks>(\n    func: T,\n    payload: Hooks[T],\n    options: {\n      /**\n       * If true, the hooks will be executed in reverse order.\n       * This is useful for \"stop\" hooks that should be executed in reverse order.\n       *\n       * @default false\n       */\n      reverse?: boolean;\n      /**\n       * If true, the hooks will be logged with their execution time.\n       *\n       * @default false\n       */\n      log?: boolean;\n      /**\n       * If true, errors will be caught and logged instead of throwing.\n       *\n       * @default false\n       */\n      catch?: boolean;\n    } = {},\n  ): Promise<void> {\n    const ctx: any = {};\n\n    if (options.log) {\n      ctx.now = Date.now();\n      this.log?.trace(`${func} ...`);\n    }\n\n    let events = this.events[func] ?? [];\n\n    if (options.reverse) {\n      events = events.toReversed();\n    }\n\n    for (const hook of events) {\n      const name = hook.caller?.name ?? \"unknown\";\n      if (options.log) {\n        ctx.now2 = Date.now();\n        this.log?.trace(`${func}(${name}) ...`);\n      }\n\n      try {\n        await hook.callback(payload);\n      } catch (error) {\n        if (options.catch) {\n          this.log?.error(`${func}(${name}) ERROR`, error);\n          continue;\n        }\n        if (options.log) {\n          throw new AlephaError(\n            `Failed during '${func}()' hook for service: ${name}`,\n            { cause: error },\n          );\n        }\n        throw error;\n      }\n\n      if (options.log) {\n        this.log?.debug(`${func}(${name}) OK [${Date.now() - ctx.now2}ms]`);\n      }\n    }\n\n    if (options.log) {\n      this.log?.debug(`${func} OK [${Date.now() - ctx.now}ms]`);\n    }\n  }\n}\n","import type { TArray } from \"typebox\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport type {\n  Static,\n  TObject,\n  TOptionalAdd,\n} from \"../providers/TypeProvider.ts\";\n\n/**\n * Define an atom for state management.\n *\n * Atom lets you define a piece of state with a name, schema, and default value.\n *\n * By default, Alepha state is just a simple key-value store.\n * Using atoms allows you to have type safety, validation, and default values for your state.\n *\n * You control how state is structured and validated.\n *\n * Features:\n * - Set a schema for validation\n * - Set a default value for initial state\n * - Rules, like read-only, custom validation, etc.\n * - Automatic getter access in services with {@link $use}\n * - SSR support (server state automatically serialized and hydrated on client)\n * - React integration (useAtom hook for automatic component re-renders)\n * - Middleware\n * - Persistence adapters (localStorage, Redis, database, file system, cookie, etc.)\n * - State migrations (version upgrades when schema changes)\n * - Documentation generation & devtools integration\n *\n * Common use cases:\n * - user preferences\n * - feature flags\n * - configuration options\n * - session data\n *\n * Atom must contain only serializable data.\n * Avoid storing complex objects like class instances, functions, or DOM elements.\n * If you need to store complex data, consider using identifiers or references instead.\n */\nexport const $atom = <\n  T extends TObject<TProperties> | TArray,\n  N extends string,\n>(\n  options: AtomOptions<T, N>,\n): Atom<T, N> => {\n  return new Atom<T, N>(options);\n};\n\nexport type AtomOptions<T extends TAtomObject, N extends string> = {\n  name: N;\n  schema: T;\n  description?: string;\n} & (T extends TOptionalAdd<T>\n  ? {\n      default?: Static<T>;\n    }\n  : {\n      default: Static<T>;\n    });\n\nexport class Atom<T extends TAtomObject = TObject, N extends string = string> {\n  public readonly options: AtomOptions<T, N>;\n\n  public get schema(): T {\n    return this.options.schema;\n  }\n\n  public get key(): N {\n    return this.options.name;\n  }\n\n  constructor(options: AtomOptions<T, N>) {\n    this.options = options;\n  }\n}\n\n$atom[KIND] = \"atom\";\n\ntype TProperties = any; // it's required to avoid required [ string ] error, ...\n\nexport type TAtomObject = TObject<any> | TArray;\nexport type AtomStatic<T extends TAtomObject> =\n  T extends TOptionalAdd<T> ? Static<T> | undefined : Static<T>;\n","import type { TObject } from \"typebox\";\nimport type { State as AlephaState } from \"../Alepha.ts\";\nimport {\n  Atom,\n  type AtomStatic,\n  type TAtomObject,\n} from \"../descriptors/$atom.ts\";\nimport { $inject } from \"../descriptors/$inject.ts\";\nimport { AlsProvider } from \"./AlsProvider.ts\";\nimport { EventManager } from \"./EventManager.ts\";\nimport { JsonSchemaCodec } from \"./JsonSchemaCodec.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport interface AtomWithValue {\n  atom: Atom;\n  value: unknown;\n}\n\nexport class StateManager<State extends object = AlephaState> {\n  protected readonly als = $inject(AlsProvider);\n  protected readonly events = $inject(EventManager);\n  protected readonly codec = $inject(JsonSchemaCodec);\n  protected readonly atoms = new Map<keyof State, Atom>();\n\n  protected store: Partial<State> = {};\n\n  constructor(store: Partial<State> = {}) {\n    this.store = store;\n  }\n\n  public getAtoms(context = true): Array<AtomWithValue> {\n    const atoms: Array<AtomWithValue> = [];\n\n    if (context && this.als?.exists()) {\n      // for each this.atoms, check if key is present in als, if yes, add to new map\n      for (const atom of this.atoms.values()) {\n        const value = this.als.get(atom.key);\n        if (value !== undefined) {\n          atoms.push({ atom, value });\n        }\n      }\n    } else {\n      for (const [key, atom] of this.atoms.entries()) {\n        atoms.push({ atom, value: this.store[key] as unknown });\n      }\n    }\n\n    return atoms;\n  }\n\n  public register(atom: Atom<any>): this {\n    const key = atom.key as keyof State;\n\n    if (!this.atoms.has(key)) {\n      this.atoms.set(key, atom);\n      if (!(key in this.store)) {\n        this.set(key, atom.options.default as State[keyof State]);\n      }\n    }\n\n    return this;\n  }\n\n  /**\n   * Get a value from the state with proper typing\n   */\n  public get<T extends TAtomObject>(target: Atom<T>): Static<T>;\n  public get<Key extends keyof State>(target: Key): State[Key] | undefined;\n  public get(target: string | object): any {\n    if (target instanceof Atom) {\n      this.register(target);\n    }\n\n    const key = target instanceof Atom ? target.key : target;\n    const store = this.store as Record<string, any>;\n\n    return this.als?.exists()\n      ? (this.als.get(key as string) ?? store[key])\n      : store[key];\n  }\n\n  /**\n   * Set a value in the state\n   */\n  public set<T extends TAtomObject>(\n    target: Atom<T>,\n    value: AtomStatic<T>,\n  ): this;\n  public set<Key extends keyof State>(\n    target: Key,\n    value: State[Key] | undefined,\n  ): this;\n  public set(target: any, value: any): this {\n    if (target instanceof Atom) {\n      this.register(target);\n    }\n\n    const key = target instanceof Atom ? target.key : target;\n    const store = this.store as Record<string, any>;\n\n    const prevValue = this.get(key);\n    if (prevValue === value) {\n      return this;\n    }\n\n    if (this.als?.exists()) {\n      this.als.set(key as string, value);\n    } else {\n      store[key] = value;\n    }\n\n    this.events\n      ?.emit(\n        \"state:mutate\",\n        { key: key as keyof AlephaState, value, prevValue },\n        { catch: true },\n      )\n      .catch(() => null);\n\n    return this;\n  }\n\n  /**\n   * Mutate a value in the state.\n   */\n  public mut<T extends TObject>(\n    target: Atom<T>,\n    mutator: (current: Static<T>) => Static<T>,\n  ): this;\n  public mut<Key extends keyof State>(\n    target: Key,\n    mutator: (current: State[Key] | undefined) => State[Key] | undefined,\n  ): this;\n  public mut(target: any, mutator: (current: any) => any): this {\n    const current = this.get(target);\n    const updated = mutator(current);\n    return this.set(target, updated);\n  }\n\n  /**\n   * Check if a key exists in the state\n   */\n  public has<Key extends keyof State>(key: Key): boolean {\n    return key in this.store;\n  }\n\n  /**\n   * Delete a key from the state (set to undefined)\n   */\n  public del<Key extends keyof State>(key: Key): this {\n    return this.set(key, undefined);\n  }\n\n  /**\n   * Push a value to an array in the state\n   */\n  public push<Key extends keyof OnlyArray<State>>(\n    key: Key,\n    value: NonNullable<State[Key]> extends Array<infer U> ? U : never,\n  ): this {\n    const current = (this.get(key) ?? []) as Array<any>; // default to empty array\n    if (Array.isArray(current)) {\n      this.set(key, [...current, value] as State[Key]);\n    }\n    return this;\n  }\n\n  /**\n   * Clear all state\n   */\n  public clear(): this {\n    this.store = {};\n    return this;\n  }\n\n  /**\n   * Get all keys that exist in the state\n   */\n  public keys(): (keyof State)[] {\n    return Object.keys(this.store) as (keyof State)[];\n  }\n}\n\ntype OnlyArray<T extends object> = {\n  [K in keyof T]: NonNullable<T[K]> extends Array<any> ? K : never;\n};\n","import type { Static, TObject } from \"typebox\";\nimport { KIND } from \"./constants/KIND.ts\";\nimport { MODULE } from \"./constants/MODULE.ts\";\nimport { OPTIONS } from \"./constants/OPTIONS.ts\";\nimport type { InjectOptions } from \"./descriptors/$inject.ts\";\nimport { Module, type WithModule } from \"./descriptors/$module.ts\";\nimport { AlephaError } from \"./errors/AlephaError.ts\";\nimport { CircularDependencyError } from \"./errors/CircularDependencyError.ts\";\nimport { ContainerLockedError } from \"./errors/ContainerLockedError.ts\";\nimport { TooLateSubstitutionError } from \"./errors/TooLateSubstitutionError.ts\";\nimport { Descriptor } from \"./helpers/descriptor.ts\";\nimport { __alephaRef } from \"./helpers/ref.ts\";\nimport type { Async } from \"./interfaces/Async.ts\";\nimport type { LoggerInterface } from \"./interfaces/LoggerInterface.ts\";\nimport {\n  type InstantiableClass,\n  isClass,\n  type RunFunction,\n  type Service,\n  type ServiceEntry,\n} from \"./interfaces/Service.ts\";\nimport { AlsProvider } from \"./providers/AlsProvider.ts\";\nimport { CodecManager } from \"./providers/CodecManager.ts\";\nimport { EventManager } from \"./providers/EventManager.ts\";\nimport { StateManager } from \"./providers/StateManager.ts\";\nimport type { TSchema } from \"./providers/TypeProvider.ts\";\n\n/**\n * Core container of the Alepha framework.\n *\n * It is responsible for managing the lifecycle of services,\n * handling dependency injection,\n * and providing a unified interface for the application.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n *\n * class MyService {\n *   // business logic here\n * }\n *\n * const alepha = Alepha.create({\n *   // state, env, and other properties\n * })\n *\n * alepha.with(MyService);\n *\n * run(alepha); // trigger .start (and .stop) automatically\n * ```\n *\n * ### Alepha Factory\n *\n * Alepha.create() is an enhanced version of new Alepha().\n * - It merges `process.env` with the provided state.env when available.\n * - It populates the test hooks for Vitest or Jest environments when available.\n *\n * new Alepha() is fine if you don't need these helpers.\n *\n * ### Platforms & Environments\n *\n * Alepha is designed to work in various environments:\n * - **Browser**: Runs in the browser, using the global `window` object.\n * - **Serverless**: Runs in serverless environments like Vercel or Vite.\n * - **Test**: Runs in test environments like Jest or Vitest.\n * - **Production**: Runs in production environments, typically with NODE_ENV set to \"production\".\n * * You can check the current environment using the following methods:\n *\n * - `isBrowser()`: Returns true if the App is running in a browser environment.\n * - `isServerless()`: Returns true if the App is running in a serverless environment.\n * - `isTest()`: Returns true if the App is running in a test environment.\n * - `isProduction()`: Returns true if the App is running in a production environment.\n *\n * ### State & Environment\n *\n * The state of the Alepha container is stored in the `store` property.\n * Most important property is `store.env`, which contains the environment variables.\n *\n * ```ts\n * const alepha = Alepha.create({ env: { MY_VAR: \"value\" } });\n *\n * // You can access the environment variables using alepha.env\n * console.log(alepha.env.MY_VAR); // \"value\"\n *\n * // But you should use $env() descriptor to get typed values from the environment.\n * class App {\n *   env = $env(\n *     t.object({\n *  \t   MY_VAR: t.text(),\n *     })\n *   );\n * }\n * ```\n *\n * ### Modules\n *\n * Modules are a way to group services together.\n * You can register a module using the `$module` descriptor.\n *\n * ```ts\n * import { $module } from \"alepha\";\n *\n * class MyLib {}\n *\n * const myModule = $module({\n *   name: \"my.project.module\",\n *   services: [MyLib],\n * });\n * ```\n *\n * Do not use modules for small applications.\n *\n * ### Hooks\n *\n * Hooks are a way to run async functions from all registered providers/services.\n * You can register a hook using the `$hook` descriptor.\n *\n * ```ts\n * import { $hook } from \"alepha\";\n *\n * class App {\n * \t log = $logger();\n * \t onCustomerHook = $hook({\n * \t\t\ton: \"my:custom:hook\",\n * \t\t\thandler: () => {\n * \t\t \t  this.log?.info(\"App is being configured\");\n * \t \t\t},\n * \t  });\n * \t}\n *\n * Alepha.create()\n * \t .with(App)\n * \t .start()\n * \t .then(alepha => alepha.events.emit(\"my:custom:hook\"));\n * ```\n *\n * \tHooks are fully typed. You can create your own hooks by using module augmentation:\n *\n * \t```ts\n * \tdeclare module \"alepha\" {\n * \t\tinterface Hooks {\n * \t\t  \"my:custom:hook\": {\n * \t\t\t\targ1: string;\n * \t\t  }\n * \t\t}\n * \t}\n * \t```\n *\n * \t@module alepha\n */\nexport class Alepha {\n  /**\n   * Creates a new instance of the Alepha container with some helpers:\n   *\n   * - merges `process.env` with the provided state.env when available.\n   * - populates the test hooks for Vitest or Jest environments when available.\n   *\n   * If you are not interested about these helpers, you can use the constructor directly.\n   */\n  public static create(state: Partial<State> = {}): Alepha {\n    // merge process.env with the state.env\n    if (typeof process === \"object\" && typeof process.env === \"object\") {\n      state.env = {\n        ...state.env,\n        ...process.env,\n      };\n    }\n\n    const alepha = new Alepha(state);\n\n    if (alepha.isTest()) {\n      // inject global hooks for testing purposes\n      // > for vitest, { globals: true } is required in the config\n      const g = globalThis as any;\n      const beforeAll = state[\"alepha.test.beforeAll\"] ?? g.beforeAll;\n      const afterAll = state[\"alepha.test.afterAll\"] ?? g.afterAll;\n      const afterEach = state[\"alepha.test.afterEach\"] ?? g.afterEach;\n      const onTestFinished =\n        state[\"alepha.test.onTestFinished\"] ?? g.onTestFinished;\n\n      beforeAll?.(() => alepha.start());\n      afterAll?.(() => alepha.stop());\n\n      try {\n        onTestFinished?.(() => alepha.stop());\n      } catch (_error) {\n        // ignore\n      }\n\n      alepha.state\n        .set(\"alepha.test.beforeAll\", beforeAll)\n        .set(\"alepha.test.afterAll\", afterAll)\n        .set(\"alepha.test.afterEach\", afterEach)\n        .set(\"alepha.test.onTestFinished\", onTestFinished);\n    }\n\n    return alepha;\n  }\n\n  /**\n   * Flag indicating whether the App won't accept any further changes.\n   * Pass to true when #start() is called.\n   */\n  protected locked = false;\n\n  /**\n   * True if the App has been configured.\n   */\n  protected configured = false;\n\n  /**\n   * True if the App has started.\n   */\n  protected started = false;\n\n  /**\n   * True if the App is ready.\n   */\n  protected ready = false;\n\n  /**\n   * A promise that resolves when the App has started.\n   */\n  protected starting?: PromiseWithResolvers<this>;\n\n  /**\n   * Initial state of the container.\n   *\n   * > Used to initialize the StateManager.\n   */\n  protected init: Partial<State>;\n\n  /**\n   * During the instantiation process, we keep a list of pending instantiations.\n   * > It allows us to detect circular dependencies.\n   */\n  protected pendingInstantiations: Service[] = [];\n\n  /**\n   * Cache for environment variables.\n   * > It allows us to avoid parsing the same schema multiple times.\n   */\n  protected cacheEnv: Map<TSchema, any> = new Map();\n\n  /**\n   * List of modules that are registered in the container.\n   *\n   * Modules are used to group services and provide a way to register them in the container.\n   */\n  protected modules: Array<Module> = [];\n\n  /**\n   * List of service substitutions.\n   *\n   * Services registered here will be replaced by the specified service when injected.\n   */\n  protected substitutions = new Map<Service, { use: Service }>();\n\n  /**\n   * Registry of descriptors.\n   */\n  protected descriptorRegistry = new Map<\n    Service<Descriptor>,\n    Array<Descriptor>\n  >();\n\n  /**\n   *  List of all services + how they are provided.\n   */\n  protected registry: Map<Service, ServiceDefinition> = new Map();\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Node.js feature that allows to store context across asynchronous calls.\n   *\n   * This is used for logging, tracing, and other context-related features.\n   *\n   * Mocked for browser environments.\n   */\n  public get context(): AlsProvider {\n    return this.inject(AlsProvider);\n  }\n\n  /**\n   * Event manager to handle lifecycle events and custom events.\n   */\n  public get events(): EventManager {\n    return this.inject(EventManager, {\n      args: [() => this.log],\n    });\n  }\n\n  /**\n   * State manager to store arbitrary values.\n   */\n  public get state(): StateManager<State> {\n    this.events; // ensure events is initialized first (TODO: move this to constructor?)\n    return this.inject(StateManager, {\n      args: [this.init],\n    });\n  }\n\n  /**\n   * Codec manager for encoding and decoding data with different formats.\n   *\n   * Supports multiple codec formats (JSON, Protobuf, etc.) with a unified interface.\n   */\n  public get codec(): CodecManager {\n    return this.inject(CodecManager);\n  }\n\n  /**\n   * Get logger instance.\n   */\n  public get log(): LoggerInterface | undefined {\n    return this.state.get(\"alepha.logger\");\n  }\n\n  /**\n   * The environment variables for the App.\n   */\n  public get env(): Readonly<Env> {\n    return this.state.get(\"env\") ?? {};\n  }\n\n  constructor(init: Partial<State> = {}) {\n    this.init = init;\n  }\n\n  /**\n   * True when start() is called.\n   *\n   * -> No more services can be added, it's over, bye!\n   */\n  public isLocked(): boolean {\n    return this.locked;\n  }\n\n  /**\n   * Returns whether the App is configured.\n   *\n   * It means that Alepha#configure() has been called.\n   *\n   * > By default, configure() is called automatically when start() is called, but you can also call it manually.\n   */\n  public isConfigured(): boolean {\n    return this.configured;\n  }\n\n  /**\n   * Returns whether the App has started.\n   *\n   * It means that #start() has been called but maybe not all services are ready.\n   */\n  public isStarted(): boolean {\n    return this.started;\n  }\n\n  /**\n   * True if the App is ready. It means that Alepha is started AND ready() hook has beed called.\n   */\n  public isReady(): boolean {\n    return this.ready;\n  }\n\n  /**\n   * True if the App is running in a Continuous Integration environment.\n   */\n  public isCI(): boolean {\n    if (this.env.GITHUB_ACTIONS) {\n      return true;\n    }\n\n    return !!this.env.CI;\n  }\n\n  /**\n   * True if the App is running in a browser environment.\n   */\n  public isBrowser(): boolean {\n    return typeof window !== \"undefined\"; // pretty cheap check\n  }\n\n  /**\n   * Returns whether the App is running in Vite dev mode.\n   */\n  public isViteDev(): boolean {\n    if (this.isBrowser()) {\n      return false;\n    }\n\n    return !!this.env.VITE_ALEPHA_DEV;\n  }\n\n  public isBun(): boolean {\n    return \"Bun\" in globalThis;\n  }\n\n  /**\n   * Returns whether the App is running in a serverless environment.\n   */\n  public isServerless(): boolean {\n    if (this.isBrowser()) {\n      return false;\n    }\n\n    if (this.env.VERCEL_REGION) {\n      return true;\n    }\n\n    if (this.env.ALEPHA_SERVERLESS) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Returns whether the App is in test mode. (Running in a test environment)\n   *\n   * > This is automatically set when running tests with Jest or Vitest.\n   */\n  public isTest(): boolean {\n    const env = this.env.NODE_ENV;\n    return env === \"test\";\n  }\n\n  /**\n   * Returns whether the App is in production mode. (Running in a production environment)\n   *\n   * > This is automatically set by Vite or Vercel. However, you have to set it manually when running Docker apps.\n   */\n  public isProduction(): boolean {\n    const env = this.env.NODE_ENV;\n    return env === \"production\";\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Starts the App.\n   *\n   * - Lock any further changes to the container.\n   * - Run \"configure\" hook for all services. Descriptors will be processed.\n   * - Run \"start\" hook for all services. Providers will connect/listen/...\n   * - Run \"ready\" hook for all services. This is the point where the App is ready to serve requests.\n   *\n   * @return A promise that resolves when the App has started.\n   */\n  public async start(): Promise<this> {\n    if (this.ready) {\n      this.log?.debug(\"App is already started, skipping...\");\n      return this;\n    }\n\n    // make sure that start is called only once\n    if (this.starting) {\n      this.log?.warn(\"App is already starting, waiting for it to finish...\");\n      return this.starting.promise;\n    }\n\n    this.codec; // ensure codec is initialized\n\n    this.starting = Promise.withResolvers();\n\n    const now = Date.now();\n\n    this.log?.info(\"Starting App...\");\n\n    for (const [key] of this.substitutions.entries()) {\n      this.inject(key);\n    }\n\n    const target = this.state.get(\"alepha.target\");\n    if (target) {\n      this.registry = new Map();\n      this.descriptorRegistry = new Map();\n      this.with(target);\n    }\n\n    this.locked = true;\n\n    await this.events.emit(\"configure\", this, { log: true });\n\n    this.configured = true;\n\n    await this.events.emit(\"start\", this, { log: true });\n\n    this.started = true;\n\n    await this.events.emit(\"ready\", this, { log: true });\n\n    this.log?.info(`App is now ready [${Date.now() - now}ms]`);\n\n    this.ready = true;\n\n    this.starting.resolve(this);\n    this.starting = undefined;\n\n    return this;\n  }\n\n  /**\n   * Stops the App.\n   *\n   * - Run \"stop\" hook for all services.\n   *\n   * Stop will NOT reset the container.\n   * Stop will NOT unlock the container.\n   *\n   * > Stop is used to gracefully shut down the application, nothing more. There is no \"restart\".\n   *\n   * @return A promise that resolves when the App has stopped.\n   */\n  public async stop(): Promise<void> {\n    if (!this.started) {\n      return;\n    }\n\n    this.log?.info(\"Stopping App...\");\n    await this.events.emit(\"stop\", this, { reverse: true, log: true });\n    this.log?.info(\"App is now off\");\n\n    this.started = false;\n    this.ready = false;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Check if entry is registered in the container.\n   */\n  public has(\n    entry: ServiceEntry,\n    opts: {\n      /**\n       * Check if the entry is registered in the pending instantiation stack.\n       *\n       * @default true\n       */\n      inStack?: boolean;\n      /**\n       * Check if the entry is registered in the container registry.\n       *\n       * @default true\n       */\n      inRegistry?: boolean;\n      /**\n       * Check if the entry is registered in the substitutions.\n       *\n       * @default true\n       */\n      inSubstitutions?: boolean;\n      /**\n       * Where to look for registered services.\n       *\n       * @default this.registry\n       */\n      registry?: Map<Service, ServiceDefinition>;\n    } = {},\n  ): boolean {\n    if (entry === Alepha) {\n      return true;\n    }\n\n    const {\n      inStack = true,\n      inRegistry = true,\n      inSubstitutions = true,\n      registry = this.registry,\n    } = opts;\n\n    const { provide } =\n      typeof entry === \"object\" && \"provide\" in entry\n        ? entry\n        : { provide: entry };\n\n    if (inSubstitutions) {\n      const substitute = this.substitutions.get(provide);\n      if (substitute) {\n        return true;\n      }\n    }\n\n    if (inRegistry) {\n      const match = registry.get(provide);\n      if (match) {\n        return true;\n      }\n    }\n\n    if (inStack) {\n      const substitute = this.substitutions.get(provide)?.use;\n      if (substitute && this.pendingInstantiations.includes(substitute)) {\n        return true;\n      }\n\n      return this.pendingInstantiations.includes(provide);\n    }\n\n    return false;\n  }\n\n  /**\n   * Registers the specified service in the container.\n   *\n   * - If the service is ALREADY registered, the method does nothing.\n   * - If the service is NOT registered, a new instance is created and registered.\n   *\n   * Method is chainable, so you can register multiple services in a single call.\n   *\n   * > ServiceEntry allows to provide a service **substitution** feature.\n   *\n   * @example\n   * ```ts\n   * class A { value = \"a\"; }\n   * class B { value = \"b\"; }\n   * class M { a = $inject(A); }\n   *\n   * Alepha.create().with({ provide: A, use: B }).get(M).a.value; // \"b\"\n   * ```\n   *\n   * > **Substitution** is an advanced feature that allows you to replace a service with another service.\n   * > It's useful for testing or for providing different implementations of a service.\n   * > If you are interested in configuring a service, use Alepha#configure() instead.\n   *\n   * @param serviceEntry - The service to register in the container.\n   * @return Current instance of Alepha.\n   */\n  public with<T extends object>(\n    serviceEntry: ServiceEntry<T> | { default: ServiceEntry<T> },\n  ): this {\n    const entry: ServiceEntry<T> =\n      \"default\" in serviceEntry ? serviceEntry.default : serviceEntry;\n\n    // just check if the entry is not present in the pending instantiation stack\n    // Alepha#get will handle the rest\n    if (\n      this.has(entry, {\n        inSubstitutions: false,\n        inRegistry: false,\n      })\n    ) {\n      return this;\n    }\n\n    const isSubstitution = typeof entry === \"object\";\n    if (isSubstitution) {\n      if (entry.provide === entry.use) {\n        this.inject(entry.provide);\n        return this;\n      }\n\n      if (!this.substitutions.has(entry.provide) && !this.has(entry.provide)) {\n        if (this.started) {\n          throw new ContainerLockedError();\n        }\n\n        // inherit of module, if service has no module\n        if (\n          MODULE in entry.provide &&\n          typeof entry.provide[MODULE] === \"function\"\n        ) {\n          (entry.use as WithModule)[MODULE] ??= entry.provide[MODULE];\n        }\n\n        this.substitutions.set(entry.provide, {\n          use: entry.use,\n        });\n      } else if (!entry.optional) {\n        throw new TooLateSubstitutionError(entry.provide.name, entry.use.name);\n      }\n\n      return this;\n    }\n\n    this.inject(entry);\n\n    return this;\n  }\n\n  /**\n   * Get an instance of the specified service from the container.\n   *\n   * @see {@link InjectOptions} for the available options.\n   */\n  public inject<T extends object>(\n    service: Service<T> | string,\n    opts: InjectOptions<T> = {},\n  ): T {\n    const lifetime = opts.lifetime ?? \"singleton\";\n    const parent =\n      opts.parent !== undefined ? opts.parent : (__alephaRef?.parent ?? Alepha);\n\n    const transient = lifetime === \"transient\";\n    const registry =\n      lifetime === \"scoped\"\n        ? (this.context.get<Map<Service, ServiceDefinition>>(\"registry\") ??\n          this.registry)\n        : this.registry;\n\n    // If the requested type is the container, the current instance is returned.\n    if ((service as any) === Alepha) {\n      return this as any;\n    }\n\n    if (typeof service === \"string\") {\n      for (const [key, value] of registry.entries()) {\n        if (key.name === service) {\n          return value.instance as T;\n        }\n      }\n      throw new AlephaError(`Service not found: ${service}`);\n    }\n\n    const substitute = this.substitutions.get(service);\n    if (substitute) {\n      return this.inject(substitute.use, {\n        parent,\n        lifetime,\n      });\n    }\n\n    const index = this.pendingInstantiations.indexOf(service);\n    if (index !== -1 && !transient) {\n      throw new CircularDependencyError(\n        service.name,\n        this.pendingInstantiations.slice(0, index).map((it) => it.name),\n      );\n    }\n\n    if (!transient) {\n      // the requested type is searched in the container\n      const match = registry.get(service);\n      if (match) {\n        if (!match.parents.includes(parent) && parent !== service) {\n          match.parents.push(parent);\n        }\n\n        return match.instance;\n      }\n\n      if (this.started) {\n        throw new ContainerLockedError(\n          `Container is locked. No more services can be added. ${parent?.name} -> ${service.name}`,\n        );\n      }\n    }\n\n    const module = (service as WithModule)[MODULE];\n    if (module && typeof module === \"function\") {\n      this.with(module);\n    }\n\n    // check if service has been registered by a module\n    if (this.has(service, { registry }) && !transient) {\n      // if the service is already registered, we just return the instance\n      return this.inject(service, { parent, lifetime });\n    }\n\n    const instance: T = this.new(service, opts.args);\n\n    const definition: ServiceDefinition<T> = {\n      parents: [parent],\n      instance,\n    };\n\n    if (!transient) {\n      registry.set(service, definition);\n    }\n\n    // [feature]: modules - it's just a way to group services together\n    if (instance instanceof Module) {\n      this.modules.push(instance);\n\n      const parent = __alephaRef.parent;\n\n      // propagate the current module\n      __alephaRef.parent = instance.constructor as Service;\n\n      instance.register(this);\n\n      // restore the previous $get context\n      __alephaRef.parent = parent;\n    }\n\n    return instance;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Applies environment variables to the provided schema and state object.\n   *\n   * It replaces also all templated $ENV inside string values.\n   *\n   * @param schema - The schema object to apply environment variables to.\n   * @return The schema object with environment variables applied.\n   */\n  public parseEnv<T extends TObject>(schema: T): Static<T> {\n    if (this.cacheEnv.has(schema)) {\n      return this.cacheEnv.get(schema) as Static<T>;\n    }\n\n    const config = this.codec.validate(schema, this.env) as Record<string, any>;\n\n    for (const key in config) {\n      if (typeof config[key] === \"string\") {\n        for (const env in config) {\n          config[key] = config[key].replace(\n            new RegExp(`\\\\$${env}`, \"gim\"),\n            config[env],\n          );\n        }\n      }\n    }\n\n    this.cacheEnv.set(schema, config);\n\n    return config as Static<T>;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Dump the current dependency graph of the App.\n   *\n   * This method returns a record where the keys are the names of the services.\n   */\n  public graph(): Record<\n    string,\n    { from: string[]; as?: string[]; module?: string }\n  > {\n    for (const [key] of this.substitutions.entries()) {\n      if (!this.has(key)) {\n        this.inject(key);\n      }\n    }\n\n    const graph: Record<\n      string,\n      { from: string[]; as?: string[]; module?: string }\n    > = {};\n\n    for (const [provide, { parents }] of this.registry.entries()) {\n      graph[provide.name] = {\n        from: parents.filter((it) => !!it).map((it) => it.name),\n      };\n\n      const aliases = this.substitutions\n        .entries()\n        .filter((it) => it[1].use === provide)\n        .map((it) => it[0].name)\n        .toArray();\n\n      if (aliases.length) {\n        graph[provide.name].as = aliases;\n      }\n\n      const module = Module.of(provide);\n      if (module) {\n        graph[provide.name].module = module.name;\n      }\n    }\n\n    return graph;\n  }\n\n  public services<T extends object>(base: Service<T>): Array<T> {\n    const list: Array<T> = [];\n    for (const [key, value] of this.registry.entries()) {\n      if (value.instance instanceof base) {\n        list.push(value.instance as T);\n      }\n    }\n    return list;\n  }\n\n  /**\n   * Get all descriptors of the specified type.\n   */\n  public descriptors<TDescriptor extends Descriptor>(\n    factory:\n      | {\n          [KIND]: InstantiableClass<TDescriptor>;\n        }\n      | string,\n  ): Array<TDescriptor> {\n    if (typeof factory === \"string\") {\n      const key1 = factory.toLowerCase().replace(\"$\", \"\");\n      const key2 = `${key1}descriptor`;\n      for (const [key, value] of this.descriptorRegistry.entries()) {\n        const name = key.name.toLowerCase();\n        if (name === key1 || name === key2) {\n          return value as Array<TDescriptor>;\n        }\n      }\n      return [];\n    }\n    return (this.descriptorRegistry.get(factory[KIND]) ??\n      []) as Array<TDescriptor>;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  protected new<T extends object>(service: Service<T>, args: any[] = []): T {\n    // we keep a tree of dependencies to detect circular dependencies\n    // it's also useful for cleaning are global cursor\n    this.pendingInstantiations.push(service);\n\n    //\n    // we use a global cursor to store the current context and definition\n    // as new() is synchronous, there is no worry to do that\n    //\n    __alephaRef.alepha = this;\n    __alephaRef.service = service;\n\n    const instance: T = isClass(service)\n      ? new service(...args)\n      : (((service as RunFunction)(...args) ?? {}) as T);\n\n    const obj = instance as unknown as Record<string, any>;\n    for (const [key, value] of Object.entries(obj)) {\n      if (value instanceof Descriptor) {\n        this.processDescriptor(value, key);\n      }\n      if (\n        typeof value === \"object\" &&\n        value !== null &&\n        typeof value[OPTIONS] === \"object\" &&\n        \"getter\" in value[OPTIONS]\n      ) {\n        const getter = value[OPTIONS].getter as keyof State;\n        Object.defineProperty(obj, key, {\n          get: () => this.state.get(getter),\n        });\n      }\n    }\n\n    this.pendingInstantiations.pop();\n\n    // tree is empty, now we can clean the global cursor\n    if (this.pendingInstantiations.length === 0) {\n      __alephaRef.alepha = undefined;\n    }\n\n    __alephaRef.service =\n      this.pendingInstantiations[this.pendingInstantiations.length - 1];\n\n    return instance;\n  }\n\n  protected processDescriptor(value: Descriptor, propertyKey = \"\") {\n    value.config.propertyKey = propertyKey;\n    (value as any).onInit();\n\n    const kind = value.constructor as Service;\n    const list = this.descriptorRegistry.get(kind) ?? [];\n    this.descriptorRegistry.set(kind, [...list, value]);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Hook<T extends keyof Hooks = any> {\n  caller?: Service;\n  priority?: \"first\" | \"last\";\n  callback: (payload: Hooks[T]) => Async<void>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * This is how we store services in the Alepha container.\n */\ninterface ServiceDefinition<T extends object = any> {\n  /**\n   * The instance of the class or type definition.\n   * Mostly used for caching / singleton but can be used for other purposes like forcing the instance.\n   */\n  instance: T;\n\n  /**\n   * List of classes which use this class.\n   */\n  parents: Array<Service | null>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Env {\n  [key: string]: string | boolean | number | undefined;\n\n  /**\n   * Optional environment variable that indicates the current environment.\n   */\n  NODE_ENV?: \"dev\" | \"test\" | \"production\";\n\n  /**\n   * Optional name of the application.\n   */\n  APP_NAME?: string;\n\n  /**\n   * Optional root module name.\n   */\n  MODULE_NAME?: string;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface State {\n  /**\n   * Environment variables for the application.\n   */\n  env?: Readonly<Env>;\n\n  /**\n   * Logger instance to be used by the Alepha container.\n   *\n   * @internal\n   */\n  \"alepha.logger\"?: LoggerInterface;\n\n  /**\n   * If defined, the Alepha container will only register this service and its dependencies.\n   */\n  \"alepha.target\"?: Service;\n\n  // test hooks\n\n  /**\n   * Bind to Vitest 'beforeAll' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'beforeAll' is available.\n   */\n  \"alepha.test.beforeAll\"?: (run: any) => any;\n\n  /**\n   * Bind to Vitest 'afterAll' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'afterAll' is available.\n   */\n  \"alepha.test.afterAll\"?: (run: any) => any;\n\n  /**\n   * Bind to Vitest 'afterEach' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'afterEach' is available.\n   */\n  \"alepha.test.afterEach\"?: (run: any) => any;\n\n  /**\n   * Bind to Vitest 'onTestFinished' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'onTestFinished' is available.\n   */\n  \"alepha.test.onTestFinished\"?: (run: any) => any;\n\n  /**\n   * List of static assets to be copied to the output directory during the build process.\n   *\n   * Used for Alepha-based applications that require static assets.\n   *\n   * See alepha/vite for more details.\n   */\n  \"alepha.build.assets\"?: Array<string>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Hooks {\n  /**\n   * Used for testing purposes.\n   */\n  echo: unknown;\n\n  /**\n   * Triggered during the configuration phase. Before the start phase.\n   */\n  configure: Alepha;\n\n  /**\n   * Triggered during the start phase. When `Alepha#start()` is called.\n   */\n  start: Alepha;\n\n  /**\n   * Triggered during the ready phase. After the start phase.\n   */\n  ready: Alepha;\n\n  /**\n   * Triggered during the stop phase.\n   *\n   * - Stop should be called after a SIGINT or SIGTERM signal in order to gracefully shutdown the application. (@see `run()` method)\n   *\n   */\n  stop: Alepha;\n\n  /**\n   * Triggered when a state value is mutated.\n   */\n  \"state:mutate\": {\n    /**\n     * The key of the state that was mutated.\n     */\n    key: keyof State;\n\n    /**\n     * The new value of the state.\n     */\n    value: any;\n\n    /**\n     * The previous value of the state.\n     */\n    prevValue: any;\n  };\n}\n","import type { Readable } from \"node:stream\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport type { TSchema, TUnsafe } from \"typebox\";\n\nexport interface FileLike {\n  /**\n   * Filename.\n   * @default \"file\"\n   */\n  name: string;\n\n  /**\n   * Mandatory MIME type of the file.\n   * @default \"application/octet-stream\"\n   */\n  type: string;\n\n  /**\n   * Size of the file in bytes.\n   *\n   * Always 0 for streams, as the size is not known until the stream is fully read.\n   *\n   * @default 0\n   */\n  size: number;\n\n  /**\n   * Last modified timestamp in milliseconds since epoch.\n   *\n   * Always the current timestamp for streams, as the last modified time is not known.\n   * We use this field to ensure compatibility with File API.\n   *\n   * @default Date.now()\n   */\n  lastModified: number;\n\n  /**\n   * Returns a ReadableStream or Node.js Readable stream of the file content.\n   *\n   * For streams, this is the original stream.\n   */\n  stream(): StreamLike;\n\n  /**\n   * Returns the file content as an ArrayBuffer.\n   *\n   * For streams, this reads the entire stream into memory.\n   */\n  arrayBuffer(): Promise<ArrayBuffer>;\n\n  /**\n   * Returns the file content as a string.\n   *\n   * For streams, this reads the entire stream into memory and converts it to a string.\n   */\n  text(): Promise<string>;\n\n  // -- node specific fields --\n\n  /**\n   * Optional file path, if the file is stored on disk.\n   *\n   * This is not from the File API, but rather a custom field to indicate where the file is stored.\n   */\n  filepath?: string;\n}\n\n/**\n * TypeBox view of FileLike.\n */\nexport type TFile = TUnsafe<FileLike>;\n\nexport const isTypeFile = (value: TSchema): value is TFile => {\n  return (\n    value &&\n    typeof value === \"object\" &&\n    \"format\" in value &&\n    value.format === \"binary\"\n  );\n};\n\nexport const isFileLike = (value: any): value is FileLike => {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    typeof value.name === \"string\" &&\n    typeof value.type === \"string\" &&\n    typeof value.size === \"number\" &&\n    typeof value.stream.bind(value) === \"function\"\n  );\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n// TODO: remove it, replace with WebStream\nexport type StreamLike =\n  | ReadableStream\n  | WebReadableStream\n  | Readable\n  | NodeJS.ReadableStream;\n\nexport type TStream = TUnsafe<StreamLike>;\n","import type {\n  TAny,\n  TArray,\n  TArrayOptions,\n  TBoolean,\n  TInteger,\n  TInterface,\n  TKeysToIndexer,\n  TNull,\n  TNumber,\n  TNumberOptions,\n  TObject,\n  TObjectOptions,\n  TOmit,\n  TOptionalAdd,\n  TPartial,\n  TPick,\n  TProperties,\n  TRecord,\n  TSchema,\n  TSchemaOptions,\n  TString,\n  TStringOptions,\n  TUnion,\n  TUnsafe,\n} from \"typebox\";\nimport * as TypeBox from \"typebox\";\nimport { Type } from \"typebox\";\nimport type {\n  TLocalizedValidationError,\n  TLocalizedValidationMessageCallback,\n} from \"typebox/error\";\nimport TypeBoxFormat from \"typebox/format\";\nimport { Locale } from \"typebox/system\";\nimport * as TypeBoxValue from \"typebox/value\";\nimport { OPTIONS } from \"../constants/OPTIONS.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport type { TypeBoxError } from \"../errors/TypeBoxError.ts\";\nimport { isTypeFile, type TFile, type TStream } from \"../helpers/FileLike.ts\";\n\nexport { TypeBox, TypeBoxValue, TypeBoxFormat };\n\nexport const isUUID = TypeBoxFormat.IsUuid;\nexport const isEmail = TypeBoxFormat.IsEmail;\nexport const isURL = TypeBoxFormat.IsUrl;\nexport const isDateTime = TypeBoxFormat.IsDateTime;\nexport const isDate = TypeBoxFormat.IsDate;\nexport const isTime = TypeBoxFormat.IsTime;\nexport const isDuration = TypeBoxFormat.IsDuration;\n\nexport type {\n  StaticDecode,\n  StaticDecode as Static,\n  StaticEncode,\n  TAny,\n  TArray,\n  TBigInt,\n  TBoolean,\n  TInteger,\n  TKeysToIndexer,\n  TNull,\n  TNumber,\n  TNumberOptions,\n  TObject,\n  TObjectOptions,\n  TOptional,\n  TOptionalAdd,\n  TPick,\n  TProperties,\n  TRecord,\n  TSchema,\n  TString,\n  TStringOptions,\n  TTuple,\n  TUnion,\n  TUnsafe,\n  TVoid,\n} from \"typebox\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class TypeGuard {\n  // -------------------------------------------------------------------------------------------------------------------\n  isBigInt = (value: TSchema): value is TString =>\n    TypeBox.IsString(value) && \"format\" in value && value.format === \"bigint\";\n  isUUID = (value: TSchema): value is TString =>\n    TypeBox.IsString(value) && \"format\" in value && value.format === \"uuid\";\n  isObject = TypeBox.IsObject;\n  isNumber = TypeBox.IsNumber;\n  isString = TypeBox.IsString;\n  isBoolean = TypeBox.IsBoolean;\n  isAny = TypeBox.IsAny;\n  isArray = TypeBox.IsArray;\n  isOptional = TypeBox.IsOptional;\n  isUnion = TypeBox.IsUnion;\n  isInteger = TypeBox.IsInteger;\n  isNull = TypeBox.IsNull;\n  isUndefined = TypeBox.IsUndefined;\n  isUnsafe = TypeBox.IsUnsafe;\n  isRecord = TypeBox.IsRecord;\n  isTuple = TypeBox.IsTuple;\n  isVoid = TypeBox.IsVoid;\n  isLiteral = TypeBox.IsLiteral;\n  isSchema = TypeBox.IsSchema;\n  // -------------------------------------------------------------------------------------------------------------------\n  isFile = isTypeFile;\n  isDateTime = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"date-time\";\n  };\n  isDate = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"date\";\n  };\n  isTime = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"time\";\n  };\n  isDuration = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"duration\";\n  };\n}\n\ndeclare module \"typebox\" {\n  interface TString {\n    format?: string;\n    minLength?: number;\n    maxLength?: number;\n  }\n\n  interface TNumber {\n    format?: \"int64\";\n  }\n}\n\nexport class TypeProvider {\n  static format = TypeBoxFormat;\n\n  static {\n    TypeBoxFormat.Set(\"bigint\", (value: string | number) =>\n      TypeProvider.isValidBigInt(value),\n    );\n  }\n\n  static translateError(error: TypeBoxError, locale?: string): string {\n    if (!locale) {\n      return error.cause.message;\n    }\n\n    for (const [key, value] of Object.entries(Locale)) {\n      if (key === \"Set\" || key === \"Get\" || key === \"Reset\") continue;\n      if (key === locale || key.startsWith(`${locale}_`)) {\n        return (value as (error: TLocalizedValidationError) => string)(\n          error.cause,\n        );\n      }\n    }\n    return error.cause.message;\n  }\n\n  static setLocale(locale: string) {\n    for (const [key, value] of Object.entries(Locale)) {\n      if (key === \"Set\" || key === \"Get\" || key === \"Reset\") continue;\n      if (key === locale || key.startsWith(`${locale}_`)) {\n        Locale.Set(value as TLocalizedValidationMessageCallback);\n        return;\n      }\n    }\n    throw new AlephaError(`Locale not found: ${locale}`);\n  }\n\n  static isValidBigInt(value: string | number) {\n    if (typeof value === \"number\") {\n      return Number.isInteger(value);\n    }\n\n    // Reject empty or whitespace-only strings\n    if (!value.trim()) return false;\n    // Regex: optional minus, then digits only\n    if (!/^-?\\d+$/.test(value)) return false;\n\n    try {\n      BigInt(value); // Will throw if invalid\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Default maximum length for strings.\n   *\n   * It can be set to a larger value:\n   * ```ts\n   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = 1000000;\n   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = undefined; // no limit (not recommended)\n   * ```\n   */\n  static DEFAULT_STRING_MAX_LENGTH: number | undefined = 255;\n\n  /**\n   * Maximum length for short strings, such as names or titles.\n   */\n  static DEFAULT_SHORT_STRING_MAX_LENGTH: number | undefined = 64;\n\n  /**\n   * Maximum length for long strings, such as descriptions or comments.\n   * It can be overridden in the string options.\n   *\n   * It can be set to a larger value:\n   * ```ts\n   * TypeProvider.DEFAULT_LONG_STRING_MAX_LENGTH = 2048;\n   * ```\n   */\n  static DEFAULT_LONG_STRING_MAX_LENGTH: number | undefined = 1024;\n\n  /**\n   * Maximum length for rich strings, such as HTML or Markdown.\n   * This is a large value to accommodate rich text content.\n   * > It's also the maximum length of PG's TEXT type.\n   *\n   * It can be overridden in the string options.\n   *\n   * It can be set to a larger value:\n   * ```ts\n   * TypeProvider.DEFAULT_RICH_STRING_MAX_LENGTH = 1000000;\n   * ```\n   */\n  static DEFAULT_RICH_STRING_MAX_LENGTH: number | undefined = 65535;\n\n  /**\n   * Maximum number of items in an array.\n   * This is a default value to prevent excessive memory usage.\n   * It can be overridden in the array options.\n   */\n  static DEFAULT_ARRAY_MAX_ITEMS = 1000;\n\n  // -------------------------------------------------------------------------------------------------------------------\n  public raw = Type; // typebox reference\n  public any = Type.Any;\n  public void = Type.Void;\n  public undefined = Type.Undefined;\n  public record = Type.Record;\n  public union = Type.Union;\n  public tuple = Type.Tuple;\n  public null = Type.Null;\n  public const = Type.Literal;\n  public options = Type.Options;\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Type guards to check the type of schema.\n   * This is not a runtime type check, but a compile-time type guard.\n   *\n   * @example\n   * ```ts\n   * if (t.schema.isString(schema)) {\n   *   // schema is TString\n   * }\n   * ```\n   */\n  public readonly schema = new TypeGuard();\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  public extend<T extends TSchema[], U extends TProperties>(\n    schema: [...T],\n    properties: U,\n    options?: TSchemaOptions,\n  ): TInterface<T, U>;\n  public extend<T extends TObject, U extends TProperties>(\n    schema: T,\n    properties: U,\n    options?: TSchemaOptions,\n  ): TInterface<[T], U>;\n  public extend(\n    schema: TSchema | TSchema[],\n    properties: Record<string, any>,\n    options?: TSchemaOptions,\n  ): any {\n    return Type.Interface(\n      Array.isArray(schema) ? schema : [schema],\n      properties,\n      {\n        additionalProperties: false,\n        ...options,\n      },\n    );\n  }\n\n  public pick<T extends TObject, Indexer extends PropertyKey[]>(\n    schema: T,\n    keys: [...Indexer],\n    options?: TObjectOptions,\n  ): TPick<T, TKeysToIndexer<Indexer>> {\n    return Type.Pick(schema, keys, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  public omit<T extends TObject, Indexer extends PropertyKey[]>(\n    schema: T,\n    keys: [...Indexer],\n    options?: TObjectOptions,\n  ): TOmit<T, TKeysToIndexer<Indexer>> {\n    return Type.Omit(schema, keys, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  public partial<T extends TSchema>(\n    schema: T,\n    options?: TSchemaOptions,\n  ): TPartial<T> {\n    return Type.Partial(schema, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for an object.\n   * By default, additional properties are not allowed.\n   *\n   * @example\n   * ```ts\n   * const userSchema = t.object({\n   *   id: t.integer(),\n   *   name: t.string(),\n   * });\n   * ```\n   */\n  public object<T extends TProperties>(\n    properties: T,\n    options?: TObjectOptions,\n  ): TObject<T> {\n    return Type.Object(properties, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for an array.\n   * By default, the maximum number of items is limited to prevent excessive memory usage.\n   *\n   * @see TypeProvider.DEFAULT_ARRAY_MAX_ITEMS\n   */\n  public array<T extends TSchema>(\n    schema: T,\n    options?: TArrayOptions,\n  ): TArray<T> {\n    return Type.Array(schema, {\n      maxItems: TypeProvider.DEFAULT_ARRAY_MAX_ITEMS,\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a string.\n   * For db or input fields, consider using `t.text()` instead, which has length limits.\n   *\n   * If you need a string with specific format (e.g. email, uuid), consider using the corresponding method (e.g. `t.email()`, `t.uuid()`).\n   */\n  public string(options: TStringOptions = {}): TString {\n    return Type.String({\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a string with length limits.\n   * For internal strings without length limits, consider using `t.string()` instead.\n   *\n   * Default size is \"regular\", which has a max length of 255 characters.\n   */\n  public text(options: TTextOptions = {}): TString {\n    const { size, ...rest } = options;\n    const maxLength =\n      size === \"short\"\n        ? TypeProvider.DEFAULT_SHORT_STRING_MAX_LENGTH\n        : size === \"long\"\n          ? TypeProvider.DEFAULT_LONG_STRING_MAX_LENGTH\n          : size === \"rich\"\n            ? TypeProvider.DEFAULT_RICH_STRING_MAX_LENGTH\n            : TypeProvider.DEFAULT_STRING_MAX_LENGTH;\n\n    return Type.String({\n      maxLength,\n      \"~options\": {\n        trim: options.trim ?? true,\n        lowercase: options.lowercase ?? false,\n      },\n      ...rest,\n    });\n  }\n\n  /**\n   * Create a schema for a JSON object.\n   * This is a record with string keys and any values.\n   */\n  public json(options?: TSchemaOptions): TRecord<string, TAny> {\n    return t.record(t.text(), t.any(), options);\n  }\n\n  /**\n   * Create a schema for a boolean.\n   */\n  public boolean(options?: TSchemaOptions): TBoolean {\n    return Type.Boolean({\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a number.\n   */\n  public number(options?: TNumberOptions): TNumber {\n    return Type.Number({\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for an integer.\n   */\n  public integer(options?: TNumberOptions): TInteger {\n    return Type.Integer({\n      ...options,\n    });\n  }\n\n  public int32(options?: TNumberOptions): TInteger {\n    return Type.Integer({\n      minimum: -2147483647,\n      maximum: 2147483647,\n      ...options,\n    });\n  }\n\n  /**\n   * Mimic a signed 64-bit integer.\n   *\n   * This is NOT a true int64, as JavaScript cannot represent all int64 values.\n   * It is a number that is an integer and between -9007199254740991 and 9007199254740991.\n   * Use `t.bigint()` for true int64 values represented as strings.\n   */\n  public int64(options?: TNumberOptions): TNumber {\n    return Type.Number({\n      format: \"int64\",\n      multipleOf: 1,\n      minimum: -9007199254740991,\n      maximum: 9007199254740991,\n      ...options,\n    });\n  }\n\n  /**\n   * Make a schema optional.\n   */\n  public optional<T extends TSchema>(schema: T): TOptionalAdd<T> {\n    return Type.Optional(schema);\n  }\n\n  /**\n   * Make a schema nullable.\n   */\n  public nullable<T extends TSchema>(\n    schema: T,\n    options?: TObjectOptions,\n  ): TUnion<[TNull, T]> {\n    return Type.Union([Type.Null(), schema], options);\n  }\n\n  /**\n   * Create a schema that maps all properties of an object schema to nullable.\n   */\n  public nullify = <T extends TSchema>(schema: T, options?: TObjectOptions) =>\n    Type.Mapped(\n      Type.Identifier(\"K\"),\n      Type.KeyOf(schema),\n      Type.Ref(\"K\"),\n      Type.Union([Type.Index(schema, Type.Ref(\"K\")), Type.Null()]),\n      options,\n    );\n\n  /**\n   * Create a schema for a string enum.\n   */\n  public enum<T extends string[]>(\n    values: [...T],\n    options?: TTextOptions,\n  ): TUnsafe<T[number]> {\n    return Type.Unsafe<T[number]>(\n      t.text({\n        enum: values,\n        pattern: values.map((v) => `^${v}$`).join(\"|\"),\n        ...options,\n      }),\n    );\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  // Codec types\n\n  /**\n   * Create a schema for a bigint represented as a string.\n   * This is a string that validates bigint format (e.g. \"123456789\").\n   */\n  public bigint(options?: TStringOptions) {\n    return t.string({\n      ...options,\n      format: \"bigint\",\n    });\n  }\n\n  /**\n   * Create a schema for a URL represented as a string.\n   */\n  public url(options?: TStringOptions) {\n    return this.string({\n      ...options,\n      format: \"url\",\n    });\n  }\n\n  /**\n   * Create a schema for binary data represented as a base64 string.\n   */\n  public binary(options: TStringOptions) {\n    return this.string({\n      ...options,\n      format: \"binary\",\n    });\n  }\n\n  /**\n   * Create a schema for uuid.\n   */\n  public uuid(options?: TStringOptions): TString {\n    return this.string({\n      ...options,\n      format: \"uuid\",\n    });\n  }\n\n  /**\n   * Create a schema for a file-like object.\n   *\n   * File like mimics the File API in browsers, but is adapted to work in Node.js as well.\n   *\n   * Implementation of file-like objects is handled by \"alepha/file\" package.\n   */\n  public file(options?: { maxSize?: number }): TFile {\n    return Type.Unsafe(\n      Type.Any({\n        [OPTIONS]: options,\n        format: \"binary\",\n      }),\n    );\n  }\n\n  /**\n   * @experimental\n   */\n  public stream(): TStream {\n    return Type.Unsafe(\n      Type.Any({\n        format: \"stream\",\n        type: \"string\",\n      }),\n    );\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n  // Exotic types\n\n  public email(options?: TStringOptions): TString {\n    return this.text({\n      ...options,\n      format: \"email\",\n      trim: true,\n      lowercase: true,\n    });\n  }\n\n  public e164(options?: TStringOptions): TString {\n    return this.text({\n      ...options,\n      description: \"Phone number in E.164 format, e.g. +1234567890.\",\n      pattern: \"^\\\\+[1-9]\\\\d{1,14}$\",\n    });\n  }\n\n  public bcp47(options?: TStringOptions): TString {\n    return this.text({\n      ...options,\n      description: \"BCP 47 language tag, e.g. en, en-US, fr, fr-CA.\",\n      pattern: \"^[a-z]{2,3}(?:-[A-Z]{2})?$\",\n    });\n  }\n\n  /**\n   * Create a schema for short text, such as names or titles.\n   * Default max length is 64 characters.\n   */\n  public shortText(options?: TStringOptions): TString {\n    return this.text({\n      size: \"short\",\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for long text, such as descriptions or comments.\n   * Default max length is 1024 characters.\n   */\n  public longText(options?: TStringOptions): TString {\n    return this.text({\n      size: \"long\",\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for rich text, such as HTML or Markdown.\n   * Default max length is 65535 characters.\n   */\n  public richText(options?: TStringOptions): TString {\n    return this.text({\n      size: \"rich\",\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a string enum e.g. LIKE_THIS.\n   */\n  public snakeCase = (options?: TStringOptions) =>\n    this.text({\n      pattern: \"^[A-Z_-]+$\",\n      ...options,\n    });\n\n  /**\n   * Create a schema for an object with a value and label.\n   */\n  public valueLabel = (options?: TObjectOptions) =>\n    this.object(\n      {\n        value: this.snakeCase({\n          description: \"Machine-readable value.\",\n        }),\n        label: this.text({\n          description: \"Human-readable label.\",\n        }),\n        description: this.optional(\n          this.text({\n            description: \"Description of the value.\",\n            size: \"long\",\n          }),\n        ),\n      },\n      options,\n    );\n\n  public datetime = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"date-time\",\n    });\n\n  public date = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"date\",\n    });\n\n  public time = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"time\",\n    });\n\n  public duration = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"duration\",\n    });\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type TextLength = \"short\" | \"regular\" | \"long\" | \"rich\";\n\nexport interface TTextOptions extends TStringOptions {\n  /**\n   * Predefined size of the text.\n   *\n   * - `short` - short text, such as names or titles. Default max length is 64 characters.\n   * - `regular` - regular text, such as single-line input. Default max length is 255 characters.\n   * - `long` - long text, such as descriptions or comments. Default max length is 1024 characters.\n   * - `rich` - rich text, such as HTML or Markdown. Default max length is 65535 characters.\n   *\n   * You can override the default max length by specifying `maxLength` in the options.\n   *\n   * @default \"regular\"\n   */\n  size?: TextLength;\n\n  /**\n   * Trim whitespace from both ends of the string.\n   *\n   * @default true\n   */\n  trim?: boolean;\n\n  /**\n   * Convert the string to lowercase.\n   *\n   * @default false\n   */\n  lowercase?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const t: TypeProvider = new TypeProvider();\n","import type { Static, TObject } from \"typebox\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport { t } from \"../providers/TypeProvider.ts\";\nimport { $context } from \"./$context.ts\";\n\n/**\n * Get typed values from environment variables.\n *\n * @example\n * ```ts\n * const alepha = Alepha.create({\n *   env: {\n *     // Alepha.create() will also use process.env when running on Node.js\n *     HELLO: \"world\",\n *   }\n * });\n *\n * class App {\n *   log = $logger();\n *\n *   // program expect a var env \"HELLO\" as string to works\n *   env = $env(t.object({\n *     HELLO: t.text()\n *   }));\n *\n *   sayHello = () => this.log.info(\"Hello ${this.env.HELLO}\")\n * }\n *\n * run(alepha.with(App));\n * ```\n */\nexport const $env = <T extends TObject>(type: T): Static<T> => {\n  const { alepha } = $context();\n\n  // allow to inject TypeBox schemas\n  if (!t.schema.isObject(type)) {\n    throw new AlephaError(\"Type must be an TObject\");\n  }\n\n  return alepha.parseEnv(type) as Static<T>;\n};\n","import type { Hooks } from \"../Alepha.ts\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport { createDescriptor, Descriptor } from \"../helpers/descriptor.ts\";\nimport type { Async } from \"../interfaces/Async.ts\";\n\n/**\n * Registers a new hook.\n *\n * ```ts\n * import { $hook } from \"alepha\";\n *\n * class MyProvider {\n *   onStart = $hook({\n *     name: \"start\", // or \"configure\", \"ready\", \"stop\", ...\n *     handler: async (app) => {\n *       // await db.connect(); ...\n *     }\n *   });\n * }\n * ```\n *\n * Hooks are used to run async functions from all registered providers/services.\n *\n * You can't register a hook after the App has started.\n *\n * It's used under the hood by the `configure`, `start`, and `stop` methods.\n * Some modules also use hooks to run their own logic. (e.g. `alepha/server`).\n *\n * You can create your own hooks by using module augmentation:\n *\n * ```ts\n * declare module \"alepha\" {\n *\n *   interface Hooks {\n *     \"my:custom:hook\": {\n *       arg1: string;\n *     }\n *   }\n * }\n *\n * await alepha.events.emit(\"my:custom:hook\", { arg1: \"value\" });\n * ```\n *\n */\nexport const $hook = <T extends keyof Hooks>(options: HookOptions<T>) =>\n  createDescriptor(HookDescriptor<T>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface HookOptions<T extends keyof Hooks> {\n  /**\n   * The name of the hook. \"configure\", \"start\", \"ready\", \"stop\", ...\n   */\n  on: T;\n\n  /**\n   * The handler to run when the hook is triggered.\n   */\n  handler: (args: Hooks[T]) => Async<any>;\n\n  /**\n   * Force the hook to run first or last on the list of hooks.\n   */\n  priority?: \"first\" | \"last\";\n\n  /**\n   * Empty placeholder, not implemented yet. :-)\n   */\n  before?: object | Array<object>;\n\n  /**\n   * Empty placeholder, not implemented yet. :-)\n   */\n  after?: object | Array<object>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HookDescriptor<T extends keyof Hooks> extends Descriptor<\n  HookOptions<T>\n> {\n  public called = 0;\n\n  protected onInit() {\n    this.alepha.events.on(this.options.on, {\n      caller: this.config.service,\n      priority: this.options.priority,\n      callback: async (args: any) => {\n        this.called += 1;\n        await this.options.handler(args);\n      },\n    });\n  }\n}\n\n$hook[KIND] = HookDescriptor;\n","import type { State } from \"../Alepha.ts\";\nimport { OPTIONS } from \"../constants/OPTIONS.ts\";\nimport type { Static, TObject } from \"../providers/TypeProvider.ts\";\nimport type { Atom } from \"./$atom.ts\";\nimport { $context } from \"./$context.ts\";\n\n/**\n * Subscribes to an atom's state and returns its current value for use in components.\n *\n * Creates a reactive connection between an atom and a component, automatically registering\n * the atom in the application state if not already registered. The returned value is reactive\n * and will update when the atom's state changes.\n *\n * **Use Cases**: Accessing global state, sharing data between components, reactive UI updates\n *\n * @example\n * ```ts\n * const userState = $atom({ schema: t.object({ name: t.text(), role: t.text() }) });\n *\n * class UserComponent {\n *   user = $use(userState); // Reactive reference to atom state\n *\n *   render() {\n *     return <div>Hello {this.user.name}!</div>;\n *   }\n * }\n * ```\n */\nexport const $use = <T extends TObject, N extends string>(\n  atom: Atom<T, N>,\n): Readonly<Static<T>> => {\n  const { alepha } = $context();\n\n  // register atom in state if not already registered\n  alepha.state.register(atom);\n\n  const init = alepha.state.get(atom.key as keyof State) as object;\n\n  return {\n    [OPTIONS]: { getter: atom.key }, // alepha will replace this with by a real 'get prop()'\n    ...init,\n  } as Static<T>;\n};\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class AppNotStartedError extends AlephaError {\n  readonly name = \"AppNotStartedError\";\n\n  constructor() {\n    super(\"App not started. Please start the app before.\");\n  }\n}\n","import type { Page } from \"../schemas/pageSchema.ts\";\n\n/**\n * Create a pagination object from an array of entities.\n *\n * This is a pure function that works with any data source (databases, APIs, caches, arrays, etc.).\n * It handles the core pagination logic including:\n * - Slicing the content to the requested page size\n * - Calculating pagination metadata (offset, page number, etc.)\n * - Determining navigation state (isFirst, isLast)\n * - Including sort metadata when provided\n *\n * @param entities - The entities to paginate (should include one extra item to detect if there's a next page)\n * @param limit - The limit of the pagination (page size)\n * @param offset - The offset of the pagination (starting position)\n * @param sort - Optional sort metadata to include in response\n * @returns A complete Page object with content and metadata\n *\n * @example Basic pagination\n * ```ts\n * const users = await fetchUsers({ limit: 11, offset: 0 }); // Fetch limit + 1\n * const page = createPagination(users, 10, 0);\n * // page.content has max 10 items\n * // page.page.isLast tells us if there are more pages\n * ```\n *\n * @example With sorting\n * ```ts\n * const page = createPagination(\n *   entities,\n *   10,\n *   0,\n *   [{ column: \"name\", direction: \"asc\" }]\n * );\n * ```\n *\n * @example In a custom service\n * ```ts\n * class MyService {\n *   async listItems(page: number, size: number) {\n *     const items = await this.fetchItems({ limit: size + 1, offset: page * size });\n *     return createPagination(items, size, page * size);\n *   }\n * }\n * ```\n */\nexport function createPagination<T>(\n  entities: T[],\n  limit = 10,\n  offset = 0,\n  sort?: Array<{ column: string; direction: \"asc\" | \"desc\" }>,\n): Page<T> {\n  const content = entities.slice(0, limit);\n  const hasNext = entities.length === limit + 1;\n  const pageNumber = Math.floor(offset / limit);\n\n  return {\n    content,\n    page: {\n      number: pageNumber,\n      size: limit,\n      offset,\n      numberOfElements: content.length,\n      isEmpty: content.length === 0,\n      isFirst: pageNumber === 0,\n      isLast: !hasNext,\n      ...(sort && sort.length > 0\n        ? {\n            sort: {\n              sorted: true,\n              fields: sort.map((s) => ({\n                field: s.column,\n                direction: s.direction,\n              })),\n            },\n          }\n        : {}),\n    },\n  };\n}\n","import { type Static, t } from \"../providers/TypeProvider.ts\";\n\nexport const pageQuerySchema = t.object({\n  page: t.optional(\n    t.integer({\n      description: \"The page number to retrieve.\",\n      minimum: 0,\n      default: 0,\n    }),\n  ),\n  size: t.optional(\n    t.integer({\n      description: \"The number of items per page.\",\n      minimum: 1,\n      maximum: 100,\n      default: 10,\n    }),\n  ),\n  sort: t.optional(\n    t.text({\n      description:\n        \"Sort by field(s). Multiple columns separated by comma. Prefix with '-' for DESC. Examples: 'name' (ASC), '-createdAt' (DESC), 'role,-name' (role ASC, name DESC)\",\n    }),\n  ),\n});\n\nexport type PageQuery = Static<typeof pageQuerySchema>;\n","import {\n  type Static,\n  type TArray,\n  type TObject,\n  type TObjectOptions,\n  type TRecord,\n  TypeProvider,\n  t,\n} from \"../providers/TypeProvider.ts\";\n\nexport const pageMetadataSchema = t.object({\n  number: t.integer({ description: \"Page number, starting from 0\" }),\n  size: t.integer({\n    description: \"Number of items per page (requested page size)\",\n  }),\n  offset: t.integer({\n    description: \"Offset in the dataset (page × size)\",\n  }),\n  numberOfElements: t.integer({\n    description:\n      \"Number of elements in THIS page (content.length). Different from totalElements which is the total across all pages.\",\n  }),\n  totalElements: t.optional(\n    t.integer({\n      description:\n        \"Total number of elements across all pages. Only available when counting is enabled.\",\n    }),\n  ),\n  totalPages: t.optional(\n    t.integer({\n      description:\n        \"Total number of pages. Only available when `totalElements` is present.\",\n    }),\n  ),\n  isEmpty: t.boolean({\n    description:\n      \"Indicates if the current page has no items (numberOfElements === 0)\",\n  }),\n  isFirst: t.boolean({\n    description: \"Indicates if this is the first page (number === 0)\",\n  }),\n  isLast: t.boolean({\n    description:\n      \"Indicates if this is the last page (no more pages after this)\",\n  }),\n  sort: t.optional(\n    t.object({\n      sorted: t.boolean({\n        description: \"Whether the results are sorted\",\n      }),\n      fields: t.array(\n        t.object({\n          field: t.text({\n            description: \"The field used for sorting\",\n          }),\n          direction: t.enum([\"asc\", \"desc\"], {\n            description: \"The direction of the sort. Either 'asc' or 'desc'\",\n          }),\n        }),\n      ),\n    }),\n  ),\n});\n\n/**\n * Create a pagination schema for the given object schema.\n *\n * Provides a standardized pagination response format compatible with Spring Data's Page interface.\n * This schema can be used across any data source (databases, APIs, caches, etc.).\n *\n * @example\n * ```ts\n * const userSchema = t.object({ id: t.integer(), name: t.text() });\n * const userPageSchema = pageSchema(userSchema);\n * ```\n *\n * @example In an API endpoint\n * ```ts\n * $action({\n *   output: pageSchema(UserSchema),\n *   handler: async () => {\n *     return await userRepo.paginate();\n *   }\n * })\n * ```\n */\nexport const pageSchema = <T extends TObject | TRecord>(\n  objectSchema: T,\n  options?: TObjectOptions,\n): TPage<T> =>\n  t.object(\n    {\n      content: t.array(objectSchema),\n      page: pageMetadataSchema,\n    },\n    options,\n  );\n\nexport type TPage<T extends TObject | TRecord> = TObject<{\n  content: TArray<T>;\n  page: typeof pageMetadataSchema;\n}>;\n\n/**\n * Opinionated type definition for a paginated response.\n *\n * Inspired by Spring Data's Page interface with all essential pagination metadata.\n * This generic type can be used with any data source.\n *\n * @example\n * ```ts\n * const page: Page<User> = {\n *   content: [user1, user2, ...],\n *   page: {\n *     number: 0,\n *     size: 10,\n *     offset: 0,\n *     numberOfElements: 10,\n *     totalElements: 1200,\n *     totalPages: 120,\n *     isEmpty: false,\n *     isFirst: true,\n *     isLast: false,\n *     sort: {\n *       sorted: true,\n *       fields: [\n *         { field: \"name\", direction: \"asc\" }\n *       ]\n *     }\n *   }\n * }\n * ```\n */\nexport type Page<T> = {\n  /**\n   * Array of items on the current page.\n   */\n  content: T[];\n  page: Static<typeof pageMetadataSchema>;\n};\n\nexport type PageMetadata = Static<typeof pageMetadataSchema>;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface TypeProvider {\n    /**\n     * Create a schema for a paginated response.\n     */\n    page<T extends TObject | TRecord>(itemSchema: T): TPage<T>;\n  }\n}\n\nTypeProvider.prototype.page = (itemSchema) => pageSchema(itemSchema);\n","import { Alepha } from \"./Alepha.ts\";\nimport type { RunOptions } from \"./interfaces/Run.ts\";\nimport type { Service } from \"./interfaces/Service.ts\";\n\nexport * from \"./index.shared.ts\";\n\nexport const run = (\n  entry: Alepha | Service | Array<Service>,\n  opts?: RunOptions,\n): Alepha => {\n  const alepha =\n    entry instanceof Alepha ? entry : Alepha.create({ env: { ...opts?.env } });\n\n  if (!(entry instanceof Alepha)) {\n    const entries = Array.isArray(entry) ? entry : [entry];\n    for (const e of entries) {\n      alepha.with(e);\n    }\n  }\n\n  if (import.meta?.hot) {\n    import.meta.hot.on(\"alepha:reload\", async () => {\n      window.location.reload();\n    });\n  }\n\n  (async () => {\n    try {\n      await opts?.configure?.(alepha);\n\n      await alepha.start();\n\n      if (opts?.ready) {\n        await opts.ready(alepha);\n      }\n    } catch (error) {\n      alepha.log?.error(\"Alepha failed to start\", error);\n    }\n  })();\n\n  (window as any).alepha = alepha;\n\n  return alepha;\n};\n"],"mappings":";;;;;;;;;;;;;AAKA,MAAaA,OAAsB,OAAO,IAAI,cAAc;;;;;;;;;ACA5D,MAAaC,SAAwB,OAAO,IAAI,gBAAgB;;;;;;;;;ACAhE,MAAaC,UAAyB,OAAO,IAAI,iBAAiB;;;;;;;ACAlE,IAAa,cAAb,cAAiC,MAAM;CACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACiDT,MAAa,WACX,YACoB;CACpB,MAAM,EAAE,WAAW,EAAE,EAAE,cAAc,EAAE,EAAE,SAAS;AAGlD,KAAI,CAAC,QAAQ,CAAC,OAAO,WAAW,KAAK,KAAK,CACxC,OAAM,IAAI,YACR,wBAAwB,KAAK,6DAC9B;CAGH,MAAM,IAAI,cAAc,OAAO;EAC7B,UAAU;EAEV,SAAS,QAAsB;AAC7B,OAAI,OAAO,QAAQ,aAAa,YAAY;AAC1C,YAAQ,SAAS,OAAO;AACxB;;AAGF,QAAK,MAAM,WAAW,SACpB,QAAO,OAAO,SAAS,EACrB,QAAQ,KAAK,aACd,CAAC;;;AAMR,QAAO,eAAe,GAAG,QAAQ;EAC/B,OAAO;EACP,UAAU;EACX,CAAC;AAEF,MAAK,MAAM,WAAW,SACpB,KAAI,CAAC,OAAO,GAAG,QAAQ,CACrB,CAAC,QAAuB,UAAU;AAItC,MAAK,MAAM,WAAW,YACpB,KAAI,OAAO,QAAQ,UAAU,WAC3B,SAAQ,MAAM,UAAU;AAI5B,QAAO;;;;;AAuCT,IAAsB,SAAtB,MAAsB,OAAO;CAK3B,OAAO,aAAa;;;;CAKpB,OAAO,GAAG,MAAwB;AAChC,SAAO,KAAK,qBAAqB;;;;;;;CAQnC,OAAO,GAAG,MAA4C;AACpD,SAAQ,KAAoB;;;;;;AC/JhC,IAAa,0BAAb,cAA6C,YAAY;CACvD,AAAS,OAAO;CAEhB,YAAY,UAAkB,SAAoB;AAChD,QACE,kEAAkE,SAAS,KAAK,SAAS,GAAG,KAAK,MAAM,CAAC,KAAK,GAAG,GAAG,SAAS,OAC7H;;;;;;ACNL,IAAa,uBAAb,cAA0C,YAAY;CACpD,AAAS,OAAO;CAEhB,YACE,UAAU,wDACV;AACA,QAAM,QAAQ;;;;;;ACNlB,IAAa,2BAAb,cAA8C,YAAY;CACxD,AAAS,OAAO;CAEhB,YAAY,UAAkB,cAAsB;AAClD,QACE,4DAA4D,SAAS,kBAAkB,aAAa,oBACrG;;;;;;ACNL,IAAa,sBAAb,cAAyC,YAAY;CACnD,AAAS,OAAO;CAEhB,cAAc;AACZ,QAAM,2DAA2D;AACjE,OAAK,OAAO;;;;;;;;;;;ACEhB,MAAaC,cAMT,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACkBN,MAAa,iBAAoC;AAC/C,KAAI,CAAC,YAAY,OACf,OAAM,IAAI,qBAAqB;AAGjC,QAAO;EACL,QAAQ,YAAY;EACpB,SAAS,YAAY;EACrB,QAAQ,YAAY,UAAU;EAC/B;;;;;ACrBH,IAAsB,aAAtB,MAAwD;CACtD,AAAmB;CAEnB,AAAgB;CAChB,AAAgB;CAEhB,YAAY,MAAyB;AACnC,OAAK,SAAS,KAAK;AACnB,OAAK,UAAU,KAAK;AACpB,OAAK,SAAS;GACZ,aAAa;GACb,SAAS,KAAK;GACd,QAAQ,KAAK;GACd;;;;;CAMH,AAAU,SAAe;;AAmB3B,MAAa,oBACX,YACA,YACgB;CAChB,MAAM,EAAE,QAAQ,YAAY,UAAU;AAEtC,KAAI,UAAU,cAAc,WAAW,QACrC,QAAO,KAAK,WAAW,QAAQ;AAGjC,QAAO,OAAO,OAAO,YAAY;EAC/B,UAAU;EACV,MAAM,CACJ;GACE;GACQ;GACR,SAAS,WAAW;GACrB,CACF;EACF,CAAC;;;;;ACRJ,SAAgB,QAAQ,MAAsC;AAE5D,KAAI,OAAO,SAAS,WAAY,QAAO;CAEvC,MAAM,aAAa,OAAO,yBAAyB,MAAM,YAAY;AACrE,QAAO,CAAC,CAAC,cAAc,CAAC,WAAW;;;;;ACvErC,IAAa,cAAb,MAAa,YAAY;CACvB,OAAO,eAAqE;CAI5E,AAAO;CAEP,cAAc;AACZ,OAAK,MAAM,YAAY,QAAQ;;CAGjC,AAAO,kBAA0B;AAC/B,SAAO,OAAO,YAAY;;CAG5B,AAAO,IAAO,UAAmB,OAA4B,EAAE,EAAK;AAClE,MAAI,CAAC,KAAK,IACR,QAAO,UAAU;AAGnB,OAAK,6BAAa,IAAI,KAAK;AAC3B,OAAK,YAAY,KAAK,iBAAiB;AAEvC,SAAO,KAAK,IAAI,IAAI,MAAM,SAAS;;CAGrC,AAAO,SAAkB;AACvB,SAAO,CAAC,CAAC,KAAK,IAAI,UAAU;;CAG9B,AAAO,IAAO,KAA4B;AACxC,MAAI,CAAC,KAAK,IACR;EAGF,MAAM,QAAQ,KAAK,IAAI,UAAU;AACjC,MAAI,MACF,QAAO,MAAM;;CAMjB,AAAO,IAAO,KAAa,OAAgB;AACzC,MAAI,CAAC,KAAK,IACR;EAGF,MAAM,QAAQ,KAAK,IAAI,UAAU;AACjC,MAAI,MACF,OAAM,OAAO;;;;;;;;;;;;;;;;ACxCnB,MAAa,WACX,MACA,OAAyB,EAAE,KACrB;CACN,MAAM,EAAE,QAAQ,YAAY,UAAU;AAGtC,KAAI,SAAS,OAAO,YAClB,QAAO;AAGT,QAAO,OAAO,OAAO,MAAM;EAEzB,QAAQ,WAAY,OAAO;EAC3B,GAAG;EACJ,CAAC;;AAGJ,IAAa,mBAAb,cAAsC,WAAW;;;;;;;;;AC3BjD,IAAa,OAAb,MAAkB;CAChB,AAAO,UACL,OACA,UACA,OACQ;AACR,SAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;CAG/C,AAAO,MACL,MACA,SACA;AACA,SAAO,KAAK,MAAM,MAAM,QAAQ;;;;;;AChBpC,IAAsB,cAAtB,MAAkC;;;;ACIlC,IAAa,kBAAb,cAAqC,YAAY;CAC/C,AAAmB,OAAO,QAAQ,KAAK;CACvC,AAAmB,UAAU,IAAI,aAAa;CAC9C,AAAmB,UAAU,IAAI,aAAa;CAE9C,AAAO,eACL,QACA,OACQ;AACR,SAAO,KAAK,KAAK,UAAU,MAAM;;CAGnC,AAAO,eACL,QACA,OACY;AACZ,SAAO,KAAK,QAAQ,OAAO,KAAK,eAAe,QAAQ,MAAM,CAAC;;CAGhE,AAAO,OAAU,QAAiB,OAAmB;AACnD,MAAI,iBAAiB,YAAY;GAC/B,MAAM,OAAO,KAAK,QAAQ,OAAO,MAAM;AACvC,UAAO,KAAK,KAAK,MAAM,KAAK;;AAG9B,MAAI,OAAO,UAAU,UAAU;GAE7B,MAAM,UAAU,MAAM,MAAM;AAC5B,OAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,IAAI,CACpD,QAAO,KAAK,KAAK,MAAM,MAAM;AAG/B,UAAO;;AAGT,SAAO;;;;;;ACtCX,IAAa,eAAb,cAAkC,YAAY;CAC5C,OAAO;CAEP,AAAgB;CAChB,AAAgB;CAKhB,YAAY,OAAkC;AAC5C,QACE,kBAAkB,MAAM,UAAU,MAAM,eAAe,OAAO,MAAM,iBAAiB,MACrF,EACE,OAAO,OACR,CACF;EACD,MAAM,SAAS,MAAM;AACrB,MAAI,QAAQ,mBACV,MAAK,QAAQ;GACX,MAAM,IAAI,OAAO,mBAAmB;GACpC,SAAS;GACV;MAED,MAAK,QAAQ;GACX,MAAM,MAAM;GACZ,SAAS,MAAM;GAChB;AAGH,OAAK,QAAQ;;;;;;AC3BjB,IAAa,kBAAb,MAA6B;CAC3B,AAAU,wBAAQ,IAAI,KAAyB;;;;;;CAO/C,AAAO,SACL,QACA,OACA,UAA2B,EAAE,EAClB;EACX,MAAM,WAAW,KAAK,YAAY,QAAQ,OAAO;GAC/C,MAAM,QAAQ,QAAQ;GACtB,iBAAiB,QAAQ,mBAAmB;GAC5C,iBAAiB,QAAQ,mBAAmB;GAC7C,CAAC;AAEF,MAAI;AACF,UAAO,KAAK,aAAa,OAAO,CAAC,MAAM,SAAS;WACzCC,OAAY;AACnB,OAAI,MAAM,OAAO,SAAS,GACxB,OAAM,IAAI,aAAa,MAAM,MAAM,OAAO,GAAG;AAE/C,SAAM;;;CAIV,AAAU,aAAgC,QAA6B;AACrE,MAAI,KAAK,MAAM,IAAI,OAAO,CACxB,QAAO,KAAK,MAAM,IAAI,OAAO;EAG/B,MAAM,YAAY,QAAQ,OAAO;AACjC,OAAK,MAAM,IAAI,QAAQ,UAAU;AACjC,SAAO;;;;;;;;CAST,AAAO,YAAY,QAAa,OAAY,SAA+B;AACzE,MAAI,CAAC,OACH,QAAO;AAGT,MACE,UAAU,QACV,CAAC,KAAK,iBAAiB,OAAO,IAC9B,QAAQ,gBAER;AAGF,MAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,KAAK,OAAO,KAAK,YAAY,OAAO,OAAO,IAAI,QAAQ,CAAC;AAGvE,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,UAAU;GACzD,IAAI,MAAM;AAEV,OAAI,QAAQ,QAAQ,OAAO,aAAa,KACtC,OAAM,IAAI,MAAM;AAGlB,OAAI,OAAO,aAAa,UACtB,OAAM,IAAI,aAAa;AAGzB,UAAO;;AAGT,MACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,SAAS,UAChB;GACA,MAAMC,MAAW,EAAE;AAEnB,QAAK,MAAM,OAAO,OAAO;IACvB,MAAM,WAAW,KAAK,YACpB,OAAO,aAAa,MACpB,MAAM,MACN,QACD;AAED,QAAI,aAAa,UAAa,QAAQ,gBACpC;AAGF,QAAI,OAAO;;AAGb,UAAO;;AAGT,SAAO;;;;;CAMT,AAAU,oBAAoB,WAAyB;AACrD,MAAI,CAAC,OACH,QAAO;AAET,MAAI,OAAO,SAAS,OAClB,QAAO;AAET,MAAI,MAAM,QAAQ,OAAO,KAAK,IAAI,OAAO,KAAK,SAAS,OAAO,CAC5D,QAAO;AAET,MAAI,OAAO,MACT,QAAO,OAAO,MAAM,MAAM,OAAY,KAAK,iBAAiB,GAAG,CAAC;AAElE,MAAI,OAAO,MACT,QAAO,OAAO,MAAM,MAAM,OAAY,KAAK,iBAAiB,GAAG,CAAC;AAElE,MAAI,OAAO,MACT,QAAO,OAAO,MAAM,MAAM,OAAY,KAAK,iBAAiB,GAAG,CAAC;AAElE,SAAO;;;;;;;;;;ACtEX,IAAa,eAAb,MAA0B;CACxB,AAAmB,yBAAmC,IAAI,KAAK;CAC/D,AAAmB,YAAY,QAAQ,gBAAgB;CACvD,AAAmB,kBAAkB,QAAQ,gBAAgB;CAE7D,AAAO,UAAU;CAEjB,cAAc;AAEZ,OAAK,SAAS,KAAK,SAAS,KAAK,UAAU;;;;;;;;CAS7C,AAAO,SAAS,MAAc,OAA0B;AACtD,OAAK,OAAO,IAAI,MAAM,MAAM;;;;;;;;;CAU9B,AAAO,SAAS,MAA2B;EACzC,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK;AACnC,MAAI,CAAC,MACH,OAAM,IAAI,YACR,UAAU,KAAK,iCAAiC,MAAM,KAAK,KAAK,OAAO,MAAM,CAAC,CAAC,KAAK,KAAK,GAC1F;AAEH,SAAO;;;;;CAMT,AAAO,OACL,QACA,OACA,SACoB;EACpB,MAAM,QAAQ,KAAK,SAAS,SAAS,WAAW,KAAK,QAAQ;EAC7D,MAAM,KAAK,SAAS,MAAM;AAE1B,MAAI,SAAS,eAAe,MAC1B,SAAQ,KAAK,gBAAgB,SAAS,QAAQ,OAAO,SAAS,WAAW;AAG3E,MAAI,OAAO,SAET,QAAO;AAGT,MAAI,OAAO,SAET,QAAO,MAAM,eAAe,QAAQ,MAAmB;AAOzD,SAAO,MAAM,eAAe,QAAQ,MAAmB;;;;;CASzD,AAAO,OACL,QACA,MACA,SACW;EACX,MAAM,cAAc,SAAS,WAAW,KAAK;EAE7C,IAAI,QADU,KAAK,SAAS,YAAY,CACtB,OAAO,QAAQ,KAAK;AAEtC,MAAI,SAAS,eAAe,MAC1B,SAAQ,KAAK,gBAAgB,SAAS,QAAQ,OAAO,SAAS,WAAW;AAG3E,SAAO;;;;;;;CAQT,AAAO,SACL,QACA,OACA,SACW;AACX,SAAO,KAAK,gBAAgB,SAAS,QAAQ,OAAO,QAAQ;;;;;;AC9JhE,IAAa,eAAb,MAA0B;CACxB,AAAU;;;;CAKV,AAAU,SAAsC,EAAE;CAElD,YAAY,OAA2C;AACrD,OAAK,QAAQ;;CAGf,IAAc,MAAmC;AAC/C,SAAO,KAAK,SAAS;;;;;CAMvB,AAAO,GACL,OACA,YACY;AACZ,MAAI,CAAC,KAAK,OAAO,OACf,MAAK,OAAO,SAAS,EAAE;EAGzB,MAAM,OACJ,OAAO,eAAe,aAAa,EAAE,UAAU,YAAY,GAAG;AAEhE,MAAI,KAAK,aAAa,QACpB,MAAK,OAAO,OAAO,QAAQ,KAAK;WACvB,KAAK,aAAa,OAC3B,MAAK,OAAO,OAAO,KAAK,KAAK;OACxB;GACL,MAAM,QAAQ,KAAK,OAAO,OAAO,WAC9B,OAAO,GAAG,aAAa,OACzB;AACD,OAAI,UAAU,GACZ,MAAK,OAAO,OAAO,OAAO,OAAO,GAAG,KAAK;OAEzC,MAAK,OAAO,OAAO,KAAK,KAAK;;AAIjC,eAAa;AACX,QAAK,OAAO,SAAS,KAAK,OAAO,OAAO,QACrC,OAAO,GAAG,aAAa,KAAK,SAC9B;;;;;;CAOL,MAAa,KACX,MACA,SACA,UAoBI,EAAE,EACS;EACf,MAAMC,MAAW,EAAE;AAEnB,MAAI,QAAQ,KAAK;AACf,OAAI,MAAM,KAAK,KAAK;AACpB,QAAK,KAAK,MAAM,GAAG,KAAK,MAAM;;EAGhC,IAAI,SAAS,KAAK,OAAO,SAAS,EAAE;AAEpC,MAAI,QAAQ,QACV,UAAS,OAAO,YAAY;AAG9B,OAAK,MAAM,QAAQ,QAAQ;GACzB,MAAM,OAAO,KAAK,QAAQ,QAAQ;AAClC,OAAI,QAAQ,KAAK;AACf,QAAI,OAAO,KAAK,KAAK;AACrB,SAAK,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,OAAO;;AAGzC,OAAI;AACF,UAAM,KAAK,SAAS,QAAQ;YACrB,OAAO;AACd,QAAI,QAAQ,OAAO;AACjB,UAAK,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,UAAU,MAAM;AAChD;;AAEF,QAAI,QAAQ,IACV,OAAM,IAAI,YACR,kBAAkB,KAAK,wBAAwB,QAC/C,EAAE,OAAO,OAAO,CACjB;AAEH,UAAM;;AAGR,OAAI,QAAQ,IACV,MAAK,KAAK,MAAM,GAAG,KAAK,GAAG,KAAK,QAAQ,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK;;AAIvE,MAAI,QAAQ,IACV,MAAK,KAAK,MAAM,GAAG,KAAK,OAAO,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACvF/D,MAAa,SAIX,YACe;AACf,QAAO,IAAI,KAAW,QAAQ;;AAehC,IAAa,OAAb,MAA8E;CAC5E,AAAgB;CAEhB,IAAW,SAAY;AACrB,SAAO,KAAK,QAAQ;;CAGtB,IAAW,MAAS;AAClB,SAAO,KAAK,QAAQ;;CAGtB,YAAY,SAA4B;AACtC,OAAK,UAAU;;;AAInB,MAAM,QAAQ;;;;AC3Dd,IAAa,eAAb,MAA8D;CAC5D,AAAmB,MAAM,QAAQ,YAAY;CAC7C,AAAmB,SAAS,QAAQ,aAAa;CACjD,AAAmB,QAAQ,QAAQ,gBAAgB;CACnD,AAAmB,wBAAQ,IAAI,KAAwB;CAEvD,AAAU,QAAwB,EAAE;CAEpC,YAAY,QAAwB,EAAE,EAAE;AACtC,OAAK,QAAQ;;CAGf,AAAO,SAAS,UAAU,MAA4B;EACpD,MAAMC,QAA8B,EAAE;AAEtC,MAAI,WAAW,KAAK,KAAK,QAAQ,CAE/B,MAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,EAAE;GACtC,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,IAAI;AACpC,OAAI,UAAU,OACZ,OAAM,KAAK;IAAE;IAAM;IAAO,CAAC;;MAI/B,MAAK,MAAM,CAAC,KAAK,SAAS,KAAK,MAAM,SAAS,CAC5C,OAAM,KAAK;GAAE;GAAM,OAAO,KAAK,MAAM;GAAiB,CAAC;AAI3D,SAAO;;CAGT,AAAO,SAAS,MAAuB;EACrC,MAAM,MAAM,KAAK;AAEjB,MAAI,CAAC,KAAK,MAAM,IAAI,IAAI,EAAE;AACxB,QAAK,MAAM,IAAI,KAAK,KAAK;AACzB,OAAI,EAAE,OAAO,KAAK,OAChB,MAAK,IAAI,KAAK,KAAK,QAAQ,QAA8B;;AAI7D,SAAO;;CAQT,AAAO,IAAI,QAA8B;AACvC,MAAI,kBAAkB,KACpB,MAAK,SAAS,OAAO;EAGvB,MAAM,MAAM,kBAAkB,OAAO,OAAO,MAAM;EAClD,MAAM,QAAQ,KAAK;AAEnB,SAAO,KAAK,KAAK,QAAQ,GACpB,KAAK,IAAI,IAAI,IAAc,IAAI,MAAM,OACtC,MAAM;;CAcZ,AAAO,IAAI,QAAa,OAAkB;AACxC,MAAI,kBAAkB,KACpB,MAAK,SAAS,OAAO;EAGvB,MAAM,MAAM,kBAAkB,OAAO,OAAO,MAAM;EAClD,MAAM,QAAQ,KAAK;EAEnB,MAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,MAAI,cAAc,MAChB,QAAO;AAGT,MAAI,KAAK,KAAK,QAAQ,CACpB,MAAK,IAAI,IAAI,KAAe,MAAM;MAElC,OAAM,OAAO;AAGf,OAAK,QACD,KACA,gBACA;GAAO;GAA0B;GAAO;GAAW,EACnD,EAAE,OAAO,MAAM,CAChB,CACA,YAAY,KAAK;AAEpB,SAAO;;CAcT,AAAO,IAAI,QAAa,SAAsC;EAE5D,MAAM,UAAU,QADA,KAAK,IAAI,OAAO,CACA;AAChC,SAAO,KAAK,IAAI,QAAQ,QAAQ;;;;;CAMlC,AAAO,IAA6B,KAAmB;AACrD,SAAO,OAAO,KAAK;;;;;CAMrB,AAAO,IAA6B,KAAgB;AAClD,SAAO,KAAK,IAAI,KAAK,OAAU;;;;;CAMjC,AAAO,KACL,KACA,OACM;EACN,MAAM,UAAW,KAAK,IAAI,IAAI,IAAI,EAAE;AACpC,MAAI,MAAM,QAAQ,QAAQ,CACxB,MAAK,IAAI,KAAK,CAAC,GAAG,SAAS,MAAM,CAAe;AAElD,SAAO;;;;;CAMT,AAAO,QAAc;AACnB,OAAK,QAAQ,EAAE;AACf,SAAO;;;;;CAMT,AAAO,OAAwB;AAC7B,SAAO,OAAO,KAAK,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC7BlC,IAAa,SAAb,MAAa,OAAO;;;;;;;;;CASlB,OAAc,OAAO,QAAwB,EAAE,EAAU;AAEvD,MAAI,OAAO,YAAY,YAAY,OAAO,QAAQ,QAAQ,SACxD,OAAM,MAAM;GACV,GAAG,MAAM;GACT,GAAG,QAAQ;GACZ;EAGH,MAAM,SAAS,IAAI,OAAO,MAAM;AAEhC,MAAI,OAAO,QAAQ,EAAE;GAGnB,MAAM,IAAI;GACV,MAAM,YAAY,MAAM,4BAA4B,EAAE;GACtD,MAAM,WAAW,MAAM,2BAA2B,EAAE;GACpD,MAAM,YAAY,MAAM,4BAA4B,EAAE;GACtD,MAAM,iBACJ,MAAM,iCAAiC,EAAE;AAE3C,qBAAkB,OAAO,OAAO,CAAC;AACjC,oBAAiB,OAAO,MAAM,CAAC;AAE/B,OAAI;AACF,2BAAuB,OAAO,MAAM,CAAC;YAC9B,QAAQ;AAIjB,UAAO,MACJ,IAAI,yBAAyB,UAAU,CACvC,IAAI,wBAAwB,SAAS,CACrC,IAAI,yBAAyB,UAAU,CACvC,IAAI,8BAA8B,eAAe;;AAGtD,SAAO;;;;;;CAOT,AAAU,SAAS;;;;CAKnB,AAAU,aAAa;;;;CAKvB,AAAU,UAAU;;;;CAKpB,AAAU,QAAQ;;;;CAKlB,AAAU;;;;;;CAOV,AAAU;;;;;CAMV,AAAU,wBAAmC,EAAE;;;;;CAM/C,AAAU,2BAA8B,IAAI,KAAK;;;;;;CAOjD,AAAU,UAAyB,EAAE;;;;;;CAOrC,AAAU,gCAAgB,IAAI,KAAgC;;;;CAK9D,AAAU,qCAAqB,IAAI,KAGhC;;;;CAKH,AAAU,2BAA4C,IAAI,KAAK;;;;;;;;CAW/D,IAAW,UAAuB;AAChC,SAAO,KAAK,OAAO,YAAY;;;;;CAMjC,IAAW,SAAuB;AAChC,SAAO,KAAK,OAAO,cAAc,EAC/B,MAAM,OAAO,KAAK,IAAI,EACvB,CAAC;;;;;CAMJ,IAAW,QAA6B;AACtC,OAAK;AACL,SAAO,KAAK,OAAO,cAAc,EAC/B,MAAM,CAAC,KAAK,KAAK,EAClB,CAAC;;;;;;;CAQJ,IAAW,QAAsB;AAC/B,SAAO,KAAK,OAAO,aAAa;;;;;CAMlC,IAAW,MAAmC;AAC5C,SAAO,KAAK,MAAM,IAAI,gBAAgB;;;;;CAMxC,IAAW,MAAqB;AAC9B,SAAO,KAAK,MAAM,IAAI,MAAM,IAAI,EAAE;;CAGpC,YAAY,OAAuB,EAAE,EAAE;AACrC,OAAK,OAAO;;;;;;;CAQd,AAAO,WAAoB;AACzB,SAAO,KAAK;;;;;;;;;CAUd,AAAO,eAAwB;AAC7B,SAAO,KAAK;;;;;;;CAQd,AAAO,YAAqB;AAC1B,SAAO,KAAK;;;;;CAMd,AAAO,UAAmB;AACxB,SAAO,KAAK;;;;;CAMd,AAAO,OAAgB;AACrB,MAAI,KAAK,IAAI,eACX,QAAO;AAGT,SAAO,CAAC,CAAC,KAAK,IAAI;;;;;CAMpB,AAAO,YAAqB;AAC1B,SAAO,OAAO,WAAW;;;;;CAM3B,AAAO,YAAqB;AAC1B,MAAI,KAAK,WAAW,CAClB,QAAO;AAGT,SAAO,CAAC,CAAC,KAAK,IAAI;;CAGpB,AAAO,QAAiB;AACtB,SAAO,SAAS;;;;;CAMlB,AAAO,eAAwB;AAC7B,MAAI,KAAK,WAAW,CAClB,QAAO;AAGT,MAAI,KAAK,IAAI,cACX,QAAO;AAGT,MAAI,KAAK,IAAI,kBACX,QAAO;AAGT,SAAO;;;;;;;CAQT,AAAO,SAAkB;AAEvB,SADY,KAAK,IAAI,aACN;;;;;;;CAQjB,AAAO,eAAwB;AAE7B,SADY,KAAK,IAAI,aACN;;;;;;;;;;;;CAejB,MAAa,QAAuB;AAClC,MAAI,KAAK,OAAO;AACd,QAAK,KAAK,MAAM,sCAAsC;AACtD,UAAO;;AAIT,MAAI,KAAK,UAAU;AACjB,QAAK,KAAK,KAAK,uDAAuD;AACtE,UAAO,KAAK,SAAS;;AAGvB,OAAK;AAEL,OAAK,WAAW,QAAQ,eAAe;EAEvC,MAAM,MAAM,KAAK,KAAK;AAEtB,OAAK,KAAK,KAAK,kBAAkB;AAEjC,OAAK,MAAM,CAAC,QAAQ,KAAK,cAAc,SAAS,CAC9C,MAAK,OAAO,IAAI;EAGlB,MAAM,SAAS,KAAK,MAAM,IAAI,gBAAgB;AAC9C,MAAI,QAAQ;AACV,QAAK,2BAAW,IAAI,KAAK;AACzB,QAAK,qCAAqB,IAAI,KAAK;AACnC,QAAK,KAAK,OAAO;;AAGnB,OAAK,SAAS;AAEd,QAAM,KAAK,OAAO,KAAK,aAAa,MAAM,EAAE,KAAK,MAAM,CAAC;AAExD,OAAK,aAAa;AAElB,QAAM,KAAK,OAAO,KAAK,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;AAEpD,OAAK,UAAU;AAEf,QAAM,KAAK,OAAO,KAAK,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;AAEpD,OAAK,KAAK,KAAK,qBAAqB,KAAK,KAAK,GAAG,IAAI,KAAK;AAE1D,OAAK,QAAQ;AAEb,OAAK,SAAS,QAAQ,KAAK;AAC3B,OAAK,WAAW;AAEhB,SAAO;;;;;;;;;;;;;;CAeT,MAAa,OAAsB;AACjC,MAAI,CAAC,KAAK,QACR;AAGF,OAAK,KAAK,KAAK,kBAAkB;AACjC,QAAM,KAAK,OAAO,KAAK,QAAQ,MAAM;GAAE,SAAS;GAAM,KAAK;GAAM,CAAC;AAClE,OAAK,KAAK,KAAK,iBAAiB;AAEhC,OAAK,UAAU;AACf,OAAK,QAAQ;;;;;CAQf,AAAO,IACL,OACA,OAyBI,EAAE,EACG;AACT,MAAI,UAAU,OACZ,QAAO;EAGT,MAAM,EACJ,UAAU,MACV,aAAa,MACb,kBAAkB,MAClB,WAAW,KAAK,aACd;EAEJ,MAAM,EAAE,YACN,OAAO,UAAU,YAAY,aAAa,QACtC,QACA,EAAE,SAAS,OAAO;AAExB,MAAI,iBAEF;OADmB,KAAK,cAAc,IAAI,QAAQ,CAEhD,QAAO;;AAIX,MAAI,YAEF;OADc,SAAS,IAAI,QAAQ,CAEjC,QAAO;;AAIX,MAAI,SAAS;GACX,MAAM,aAAa,KAAK,cAAc,IAAI,QAAQ,EAAE;AACpD,OAAI,cAAc,KAAK,sBAAsB,SAAS,WAAW,CAC/D,QAAO;AAGT,UAAO,KAAK,sBAAsB,SAAS,QAAQ;;AAGrD,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BT,AAAO,KACL,cACM;EACN,MAAMC,QACJ,aAAa,eAAe,aAAa,UAAU;AAIrD,MACE,KAAK,IAAI,OAAO;GACd,iBAAiB;GACjB,YAAY;GACb,CAAC,CAEF,QAAO;AAIT,MADuB,OAAO,UAAU,UACpB;AAClB,OAAI,MAAM,YAAY,MAAM,KAAK;AAC/B,SAAK,OAAO,MAAM,QAAQ;AAC1B,WAAO;;AAGT,OAAI,CAAC,KAAK,cAAc,IAAI,MAAM,QAAQ,IAAI,CAAC,KAAK,IAAI,MAAM,QAAQ,EAAE;AACtE,QAAI,KAAK,QACP,OAAM,IAAI,sBAAsB;AAIlC,QACE,UAAU,MAAM,WAChB,OAAO,MAAM,QAAQ,YAAY,WAEjC,CAAC,MAAM,IAAmB,YAAY,MAAM,QAAQ;AAGtD,SAAK,cAAc,IAAI,MAAM,SAAS,EACpC,KAAK,MAAM,KACZ,CAAC;cACO,CAAC,MAAM,SAChB,OAAM,IAAI,yBAAyB,MAAM,QAAQ,MAAM,MAAM,IAAI,KAAK;AAGxE,UAAO;;AAGT,OAAK,OAAO,MAAM;AAElB,SAAO;;;;;;;CAQT,AAAO,OACL,SACA,OAAyB,EAAE,EACxB;EACH,MAAM,WAAW,KAAK,YAAY;EAClC,MAAM,SACJ,KAAK,WAAW,SAAY,KAAK,SAAU,aAAa,UAAU;EAEpE,MAAM,YAAY,aAAa;EAC/B,MAAM,WACJ,aAAa,WACR,KAAK,QAAQ,IAAqC,WAAW,IAC9D,KAAK,WACL,KAAK;AAGX,MAAK,YAAoB,OACvB,QAAO;AAGT,MAAI,OAAO,YAAY,UAAU;AAC/B,QAAK,MAAM,CAAC,KAAK,UAAU,SAAS,SAAS,CAC3C,KAAI,IAAI,SAAS,QACf,QAAO,MAAM;AAGjB,SAAM,IAAI,YAAY,sBAAsB,UAAU;;EAGxD,MAAM,aAAa,KAAK,cAAc,IAAI,QAAQ;AAClD,MAAI,WACF,QAAO,KAAK,OAAO,WAAW,KAAK;GACjC;GACA;GACD,CAAC;EAGJ,MAAM,QAAQ,KAAK,sBAAsB,QAAQ,QAAQ;AACzD,MAAI,UAAU,MAAM,CAAC,UACnB,OAAM,IAAI,wBACR,QAAQ,MACR,KAAK,sBAAsB,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO,GAAG,KAAK,CAChE;AAGH,MAAI,CAAC,WAAW;GAEd,MAAM,QAAQ,SAAS,IAAI,QAAQ;AACnC,OAAI,OAAO;AACT,QAAI,CAAC,MAAM,QAAQ,SAAS,OAAO,IAAI,WAAW,QAChD,OAAM,QAAQ,KAAK,OAAO;AAG5B,WAAO,MAAM;;AAGf,OAAI,KAAK,QACP,OAAM,IAAI,qBACR,uDAAuD,QAAQ,KAAK,MAAM,QAAQ,OACnF;;EAIL,MAAM,SAAU,QAAuB;AACvC,MAAI,UAAU,OAAO,WAAW,WAC9B,MAAK,KAAK,OAAO;AAInB,MAAI,KAAK,IAAI,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,UAEtC,QAAO,KAAK,OAAO,SAAS;GAAE;GAAQ;GAAU,CAAC;EAGnD,MAAMC,WAAc,KAAK,IAAI,SAAS,KAAK,KAAK;EAEhD,MAAMC,aAAmC;GACvC,SAAS,CAAC,OAAO;GACjB;GACD;AAED,MAAI,CAAC,UACH,UAAS,IAAI,SAAS,WAAW;AAInC,MAAI,oBAAoB,QAAQ;AAC9B,QAAK,QAAQ,KAAK,SAAS;GAE3B,MAAMC,WAAS,YAAY;AAG3B,eAAY,SAAS,SAAS;AAE9B,YAAS,SAAS,KAAK;AAGvB,eAAY,SAASA;;AAGvB,SAAO;;;;;;;;;;CAaT,AAAO,SAA4B,QAAsB;AACvD,MAAI,KAAK,SAAS,IAAI,OAAO,CAC3B,QAAO,KAAK,SAAS,IAAI,OAAO;EAGlC,MAAM,SAAS,KAAK,MAAM,SAAS,QAAQ,KAAK,IAAI;AAEpD,OAAK,MAAM,OAAO,OAChB,KAAI,OAAO,OAAO,SAAS,SACzB,MAAK,MAAM,OAAO,OAChB,QAAO,OAAO,OAAO,KAAK,QACxB,IAAI,OAAO,MAAM,OAAO,MAAM,EAC9B,OAAO,KACR;AAKP,OAAK,SAAS,IAAI,QAAQ,OAAO;AAEjC,SAAO;;;;;;;CAUT,AAAO,QAGL;AACA,OAAK,MAAM,CAAC,QAAQ,KAAK,cAAc,SAAS,CAC9C,KAAI,CAAC,KAAK,IAAI,IAAI,CAChB,MAAK,OAAO,IAAI;EAIpB,MAAMC,QAGF,EAAE;AAEN,OAAK,MAAM,CAAC,SAAS,EAAE,cAAc,KAAK,SAAS,SAAS,EAAE;AAC5D,SAAM,QAAQ,QAAQ,EACpB,MAAM,QAAQ,QAAQ,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,GAAG,KAAK,EACxD;GAED,MAAM,UAAU,KAAK,cAClB,SAAS,CACT,QAAQ,OAAO,GAAG,GAAG,QAAQ,QAAQ,CACrC,KAAK,OAAO,GAAG,GAAG,KAAK,CACvB,SAAS;AAEZ,OAAI,QAAQ,OACV,OAAM,QAAQ,MAAM,KAAK;GAG3B,MAAM,SAAS,OAAO,GAAG,QAAQ;AACjC,OAAI,OACF,OAAM,QAAQ,MAAM,SAAS,OAAO;;AAIxC,SAAO;;CAGT,AAAO,SAA2B,MAA4B;EAC5D,MAAMC,OAAiB,EAAE;AACzB,OAAK,MAAM,CAAC,KAAK,UAAU,KAAK,SAAS,SAAS,CAChD,KAAI,MAAM,oBAAoB,KAC5B,MAAK,KAAK,MAAM,SAAc;AAGlC,SAAO;;;;;CAMT,AAAO,YACL,SAKoB;AACpB,MAAI,OAAO,YAAY,UAAU;GAC/B,MAAM,OAAO,QAAQ,aAAa,CAAC,QAAQ,KAAK,GAAG;GACnD,MAAM,OAAO,GAAG,KAAK;AACrB,QAAK,MAAM,CAAC,KAAK,UAAU,KAAK,mBAAmB,SAAS,EAAE;IAC5D,MAAM,OAAO,IAAI,KAAK,aAAa;AACnC,QAAI,SAAS,QAAQ,SAAS,KAC5B,QAAO;;AAGX,UAAO,EAAE;;AAEX,SAAQ,KAAK,mBAAmB,IAAI,QAAQ,MAAM,IAChD,EAAE;;CAKN,AAAU,IAAsB,SAAqB,OAAc,EAAE,EAAK;AAGxE,OAAK,sBAAsB,KAAK,QAAQ;AAMxC,cAAY,SAAS;AACrB,cAAY,UAAU;EAEtB,MAAMJ,WAAc,QAAQ,QAAQ,GAChC,IAAI,QAAQ,GAAG,KAAK,GACjB,QAAwB,GAAG,KAAK,IAAI,EAAE;EAE7C,MAAM,MAAM;AACZ,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,EAAE;AAC9C,OAAI,iBAAiB,WACnB,MAAK,kBAAkB,OAAO,IAAI;AAEpC,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,MAAM,aAAa,YAC1B,YAAY,MAAM,UAClB;IACA,MAAM,SAAS,MAAM,SAAS;AAC9B,WAAO,eAAe,KAAK,KAAK,EAC9B,WAAW,KAAK,MAAM,IAAI,OAAO,EAClC,CAAC;;;AAIN,OAAK,sBAAsB,KAAK;AAGhC,MAAI,KAAK,sBAAsB,WAAW,EACxC,aAAY,SAAS;AAGvB,cAAY,UACV,KAAK,sBAAsB,KAAK,sBAAsB,SAAS;AAEjE,SAAO;;CAGT,AAAU,kBAAkB,OAAmB,cAAc,IAAI;AAC/D,QAAM,OAAO,cAAc;AAC3B,EAAC,MAAc,QAAQ;EAEvB,MAAM,OAAO,MAAM;EACnB,MAAM,OAAO,KAAK,mBAAmB,IAAI,KAAK,IAAI,EAAE;AACpD,OAAK,mBAAmB,IAAI,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC;;;;;;ACv3BvD,MAAa,cAAc,UAAmC;AAC5D,QACE,SACA,OAAO,UAAU,YACjB,YAAY,SACZ,MAAM,WAAW;;AAIrB,MAAa,cAAc,UAAkC;AAC3D,QACE,CAAC,CAAC,SACF,OAAO,UAAU,YACjB,CAAC,MAAM,QAAQ,MAAM,IACrB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,OAAO,KAAK,MAAM,KAAK;;;;;AC/CxC,MAAa,SAAS,cAAc;AACpC,MAAa,UAAU,cAAc;AACrC,MAAa,QAAQ,cAAc;AACnC,MAAa,aAAa,cAAc;AACxC,MAAa,SAAS,cAAc;AACpC,MAAa,SAAS,cAAc;AACpC,MAAa,aAAa,cAAc;AAiCxC,IAAa,YAAb,MAAuB;CAErB,YAAY,UACV,QAAQ,SAAS,MAAM,IAAI,YAAY,SAAS,MAAM,WAAW;CACnE,UAAU,UACR,QAAQ,SAAS,MAAM,IAAI,YAAY,SAAS,MAAM,WAAW;CACnE,WAAW,QAAQ;CACnB,WAAW,QAAQ;CACnB,WAAW,QAAQ;CACnB,YAAY,QAAQ;CACpB,QAAQ,QAAQ;CAChB,UAAU,QAAQ;CAClB,aAAa,QAAQ;CACrB,UAAU,QAAQ;CAClB,YAAY,QAAQ;CACpB,SAAS,QAAQ;CACjB,cAAc,QAAQ;CACtB,WAAW,QAAQ;CACnB,WAAW,QAAQ;CACnB,UAAU,QAAQ;CAClB,SAAS,QAAQ;CACjB,YAAY,QAAQ;CACpB,WAAW,QAAQ;CAEnB,SAAS;CACT,cAAc,WAAoB;AAChC,SAAO,EAAE,OAAO,SAAS,OAAO,IAAI,OAAO,WAAW;;CAExD,UAAU,WAAoB;AAC5B,SAAO,EAAE,OAAO,SAAS,OAAO,IAAI,OAAO,WAAW;;CAExD,UAAU,WAAoB;AAC5B,SAAO,EAAE,OAAO,SAAS,OAAO,IAAI,OAAO,WAAW;;CAExD,cAAc,WAAoB;AAChC,SAAO,EAAE,OAAO,SAAS,OAAO,IAAI,OAAO,WAAW;;;AAgB1D,IAAa,eAAb,MAAa,aAAa;CACxB,OAAO,SAAS;CAEhB;AACE,gBAAc,IAAI,WAAW,UAC3B,aAAa,cAAc,MAAM,CAClC;;CAGH,OAAO,eAAe,OAAqB,QAAyB;AAClE,MAAI,CAAC,OACH,QAAO,MAAM,MAAM;AAGrB,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,EAAE;AACjD,OAAI,QAAQ,SAAS,QAAQ,SAAS,QAAQ,QAAS;AACvD,OAAI,QAAQ,UAAU,IAAI,WAAW,GAAG,OAAO,GAAG,CAChD,QAAQ,MACN,MAAM,MACP;;AAGL,SAAO,MAAM,MAAM;;CAGrB,OAAO,UAAU,QAAgB;AAC/B,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,EAAE;AACjD,OAAI,QAAQ,SAAS,QAAQ,SAAS,QAAQ,QAAS;AACvD,OAAI,QAAQ,UAAU,IAAI,WAAW,GAAG,OAAO,GAAG,EAAE;AAClD,WAAO,IAAI,MAA6C;AACxD;;;AAGJ,QAAM,IAAI,YAAY,qBAAqB,SAAS;;CAGtD,OAAO,cAAc,OAAwB;AAC3C,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,UAAU,MAAM;AAIhC,MAAI,CAAC,MAAM,MAAM,CAAE,QAAO;AAE1B,MAAI,CAAC,UAAU,KAAK,MAAM,CAAE,QAAO;AAEnC,MAAI;AACF,UAAO,MAAM;AACb,UAAO;UACD;AACN,UAAO;;;;;;;;;;;;CAaX,OAAO,4BAAgD;;;;CAKvD,OAAO,kCAAsD;;;;;;;;;;CAW7D,OAAO,iCAAqD;;;;;;;;;;;;;CAc5D,OAAO,iCAAqD;;;;;;CAO5D,OAAO,0BAA0B;CAGjC,AAAO,MAAM;CACb,AAAO,MAAM,KAAK;CAClB,AAAO,OAAO,KAAK;CACnB,AAAO,YAAY,KAAK;CACxB,AAAO,SAAS,KAAK;CACrB,AAAO,QAAQ,KAAK;CACpB,AAAO,QAAQ,KAAK;CACpB,AAAO,OAAO,KAAK;CACnB,AAAO,QAAQ,KAAK;CACpB,AAAO,UAAU,KAAK;;;;;;;;;;;;CActB,AAAgB,SAAS,IAAI,WAAW;CAcxC,AAAO,OACL,QACA,YACA,SACK;AACL,SAAO,KAAK,UACV,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EACzC,YACA;GACE,sBAAsB;GACtB,GAAG;GACJ,CACF;;CAGH,AAAO,KACL,QACA,MACA,SACmC;AACnC,SAAO,KAAK,KAAK,QAAQ,MAAM;GAC7B,sBAAsB;GACtB,GAAG;GACJ,CAAC;;CAGJ,AAAO,KACL,QACA,MACA,SACmC;AACnC,SAAO,KAAK,KAAK,QAAQ,MAAM;GAC7B,sBAAsB;GACtB,GAAG;GACJ,CAAC;;CAGJ,AAAO,QACL,QACA,SACa;AACb,SAAO,KAAK,QAAQ,QAAQ;GAC1B,sBAAsB;GACtB,GAAG;GACJ,CAAC;;;;;;;;;;;;;;CAeJ,AAAO,OACL,YACA,SACY;AACZ,SAAO,KAAK,OAAO,YAAY;GAC7B,sBAAsB;GACtB,GAAG;GACJ,CAAC;;;;;;;;CASJ,AAAO,MACL,QACA,SACW;AACX,SAAO,KAAK,MAAM,QAAQ;GACxB,UAAU,aAAa;GACvB,GAAG;GACJ,CAAC;;;;;;;;CASJ,AAAO,OAAO,UAA0B,EAAE,EAAW;AACnD,SAAO,KAAK,OAAO,EACjB,GAAG,SACJ,CAAC;;;;;;;;CASJ,AAAO,KAAK,UAAwB,EAAE,EAAW;EAC/C,MAAM,EAAE,MAAM,GAAG,SAAS;EAC1B,MAAM,YACJ,SAAS,UACL,aAAa,kCACb,SAAS,SACP,aAAa,iCACb,SAAS,SACP,aAAa,iCACb,aAAa;AAEvB,SAAO,KAAK,OAAO;GACjB;GACA,YAAY;IACV,MAAM,QAAQ,QAAQ;IACtB,WAAW,QAAQ,aAAa;IACjC;GACD,GAAG;GACJ,CAAC;;;;;;CAOJ,AAAO,KAAK,SAAiD;AAC3D,SAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ;;;;;CAM7C,AAAO,QAAQ,SAAoC;AACjD,SAAO,KAAK,QAAQ,EAClB,GAAG,SACJ,CAAC;;;;;CAMJ,AAAO,OAAO,SAAmC;AAC/C,SAAO,KAAK,OAAO,EACjB,GAAG,SACJ,CAAC;;;;;CAMJ,AAAO,QAAQ,SAAoC;AACjD,SAAO,KAAK,QAAQ,EAClB,GAAG,SACJ,CAAC;;CAGJ,AAAO,MAAM,SAAoC;AAC/C,SAAO,KAAK,QAAQ;GAClB,SAAS;GACT,SAAS;GACT,GAAG;GACJ,CAAC;;;;;;;;;CAUJ,AAAO,MAAM,SAAmC;AAC9C,SAAO,KAAK,OAAO;GACjB,QAAQ;GACR,YAAY;GACZ,SAAS;GACT,SAAS;GACT,GAAG;GACJ,CAAC;;;;;CAMJ,AAAO,SAA4B,QAA4B;AAC7D,SAAO,KAAK,SAAS,OAAO;;;;;CAM9B,AAAO,SACL,QACA,SACoB;AACpB,SAAO,KAAK,MAAM,CAAC,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ;;;;;CAMnD,AAAO,WAA8B,QAAW,YAC9C,KAAK,OACH,KAAK,WAAW,IAAI,EACpB,KAAK,MAAM,OAAO,EAClB,KAAK,IAAI,IAAI,EACb,KAAK,MAAM,CAAC,KAAK,MAAM,QAAQ,KAAK,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,EAC5D,QACD;;;;CAKH,AAAO,KACL,QACA,SACoB;AACpB,SAAO,KAAK,OACV,EAAE,KAAK;GACL,MAAM;GACN,SAAS,OAAO,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,IAAI;GAC9C,GAAG;GACJ,CAAC,CACH;;;;;;CAWH,AAAO,OAAO,SAA0B;AACtC,SAAO,EAAE,OAAO;GACd,GAAG;GACH,QAAQ;GACT,CAAC;;;;;CAMJ,AAAO,IAAI,SAA0B;AACnC,SAAO,KAAK,OAAO;GACjB,GAAG;GACH,QAAQ;GACT,CAAC;;;;;CAMJ,AAAO,OAAO,SAAyB;AACrC,SAAO,KAAK,OAAO;GACjB,GAAG;GACH,QAAQ;GACT,CAAC;;;;;CAMJ,AAAO,KAAK,SAAmC;AAC7C,SAAO,KAAK,OAAO;GACjB,GAAG;GACH,QAAQ;GACT,CAAC;;;;;;;;;CAUJ,AAAO,KAAK,SAAuC;AACjD,SAAO,KAAK,OACV,KAAK,IAAI;IACN,UAAU;GACX,QAAQ;GACT,CAAC,CACH;;;;;CAMH,AAAO,SAAkB;AACvB,SAAO,KAAK,OACV,KAAK,IAAI;GACP,QAAQ;GACR,MAAM;GACP,CAAC,CACH;;CAMH,AAAO,MAAM,SAAmC;AAC9C,SAAO,KAAK,KAAK;GACf,GAAG;GACH,QAAQ;GACR,MAAM;GACN,WAAW;GACZ,CAAC;;CAGJ,AAAO,KAAK,SAAmC;AAC7C,SAAO,KAAK,KAAK;GACf,GAAG;GACH,aAAa;GACb,SAAS;GACV,CAAC;;CAGJ,AAAO,MAAM,SAAmC;AAC9C,SAAO,KAAK,KAAK;GACf,GAAG;GACH,aAAa;GACb,SAAS;GACV,CAAC;;;;;;CAOJ,AAAO,UAAU,SAAmC;AAClD,SAAO,KAAK,KAAK;GACf,MAAM;GACN,GAAG;GACJ,CAAC;;;;;;CAOJ,AAAO,SAAS,SAAmC;AACjD,SAAO,KAAK,KAAK;GACf,MAAM;GACN,GAAG;GACJ,CAAC;;;;;;CAOJ,AAAO,SAAS,SAAmC;AACjD,SAAO,KAAK,KAAK;GACf,MAAM;GACN,GAAG;GACJ,CAAC;;;;;CAMJ,AAAO,aAAa,YAClB,KAAK,KAAK;EACR,SAAS;EACT,GAAG;EACJ,CAAC;;;;CAKJ,AAAO,cAAc,YACnB,KAAK,OACH;EACE,OAAO,KAAK,UAAU,EACpB,aAAa,2BACd,CAAC;EACF,OAAO,KAAK,KAAK,EACf,aAAa,yBACd,CAAC;EACF,aAAa,KAAK,SAChB,KAAK,KAAK;GACR,aAAa;GACb,MAAM;GACP,CAAC,CACH;EACF,EACD,QACD;CAEH,AAAO,YAAY,YACjB,EAAE,KAAK;EACL,GAAG;EACH,QAAQ;EACT,CAAC;CAEJ,AAAO,QAAQ,YACb,EAAE,KAAK;EACL,GAAG;EACH,QAAQ;EACT,CAAC;CAEJ,AAAO,QAAQ,YACb,EAAE,KAAK;EACL,GAAG;EACH,QAAQ;EACT,CAAC;CAEJ,AAAO,YAAY,YACjB,EAAE,KAAK;EACL,GAAG;EACH,QAAQ;EACT,CAAC;;AAuCN,MAAaK,IAAkB,IAAI,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACxrBjD,MAAa,QAA2B,SAAuB;CAC7D,MAAM,EAAE,WAAW,UAAU;AAG7B,KAAI,CAAC,EAAE,OAAO,SAAS,KAAK,CAC1B,OAAM,IAAI,YAAY,0BAA0B;AAGlD,QAAO,OAAO,SAAS,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACK9B,MAAa,SAAgC,YAC3C,iBAAiB,gBAAmB,QAAQ;AAiC9C,IAAa,iBAAb,cAA2D,WAEzD;CACA,AAAO,SAAS;CAEhB,AAAU,SAAS;AACjB,OAAK,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI;GACrC,QAAQ,KAAK,OAAO;GACpB,UAAU,KAAK,QAAQ;GACvB,UAAU,OAAO,SAAc;AAC7B,SAAK,UAAU;AACf,UAAM,KAAK,QAAQ,QAAQ,KAAK;;GAEnC,CAAC;;;AAIN,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;ACnEd,MAAa,QACX,SACwB;CACxB,MAAM,EAAE,WAAW,UAAU;AAG7B,QAAO,MAAM,SAAS,KAAK;CAE3B,MAAM,OAAO,OAAO,MAAM,IAAI,KAAK,IAAmB;AAEtD,QAAO;GACJ,UAAU,EAAE,QAAQ,KAAK,KAAK;EAC/B,GAAG;EACJ;;;;;ACvCH,IAAa,qBAAb,cAAwC,YAAY;CAClD,AAAS,OAAO;CAEhB,cAAc;AACZ,QAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACwC1D,SAAgB,iBACd,UACA,QAAQ,IACR,SAAS,GACT,MACS;CACT,MAAM,UAAU,SAAS,MAAM,GAAG,MAAM;CACxC,MAAM,UAAU,SAAS,WAAW,QAAQ;CAC5C,MAAM,aAAa,KAAK,MAAM,SAAS,MAAM;AAE7C,QAAO;EACL;EACA,MAAM;GACJ,QAAQ;GACR,MAAM;GACN;GACA,kBAAkB,QAAQ;GAC1B,SAAS,QAAQ,WAAW;GAC5B,SAAS,eAAe;GACxB,QAAQ,CAAC;GACT,GAAI,QAAQ,KAAK,SAAS,IACtB,EACE,MAAM;IACJ,QAAQ;IACR,QAAQ,KAAK,KAAK,OAAO;KACvB,OAAO,EAAE;KACT,WAAW,EAAE;KACd,EAAE;IACJ,EACF,GACD,EAAE;GACP;EACF;;;;;AC5EH,MAAa,kBAAkB,EAAE,OAAO;CACtC,MAAM,EAAE,SACN,EAAE,QAAQ;EACR,aAAa;EACb,SAAS;EACT,SAAS;EACV,CAAC,CACH;CACD,MAAM,EAAE,SACN,EAAE,QAAQ;EACR,aAAa;EACb,SAAS;EACT,SAAS;EACT,SAAS;EACV,CAAC,CACH;CACD,MAAM,EAAE,SACN,EAAE,KAAK,EACL,aACE,oKACH,CAAC,CACH;CACF,CAAC;;;;ACdF,MAAa,qBAAqB,EAAE,OAAO;CACzC,QAAQ,EAAE,QAAQ,EAAE,aAAa,gCAAgC,CAAC;CAClE,MAAM,EAAE,QAAQ,EACd,aAAa,kDACd,CAAC;CACF,QAAQ,EAAE,QAAQ,EAChB,aAAa,uCACd,CAAC;CACF,kBAAkB,EAAE,QAAQ,EAC1B,aACE,uHACH,CAAC;CACF,eAAe,EAAE,SACf,EAAE,QAAQ,EACR,aACE,uFACH,CAAC,CACH;CACD,YAAY,EAAE,SACZ,EAAE,QAAQ,EACR,aACE,0EACH,CAAC,CACH;CACD,SAAS,EAAE,QAAQ,EACjB,aACE,uEACH,CAAC;CACF,SAAS,EAAE,QAAQ,EACjB,aAAa,sDACd,CAAC;CACF,QAAQ,EAAE,QAAQ,EAChB,aACE,iEACH,CAAC;CACF,MAAM,EAAE,SACN,EAAE,OAAO;EACP,QAAQ,EAAE,QAAQ,EAChB,aAAa,kCACd,CAAC;EACF,QAAQ,EAAE,MACR,EAAE,OAAO;GACP,OAAO,EAAE,KAAK,EACZ,aAAa,8BACd,CAAC;GACF,WAAW,EAAE,KAAK,CAAC,OAAO,OAAO,EAAE,EACjC,aAAa,qDACd,CAAC;GACH,CAAC,CACH;EACF,CAAC,CACH;CACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwBF,MAAa,cACX,cACA,YAEA,EAAE,OACA;CACE,SAAS,EAAE,MAAM,aAAa;CAC9B,MAAM;CACP,EACD,QACD;AA0DH,aAAa,UAAU,QAAQ,eAAe,WAAW,WAAW;;;;ACpJpE,MAAa,OACX,OACA,SACW;CACX,MAAM,SACJ,iBAAiB,SAAS,QAAQ,OAAO,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;AAE5E,KAAI,EAAE,iBAAiB,SAAS;EAC9B,MAAM,UAAU,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;AACtD,OAAK,MAAM,KAAK,QACd,QAAO,KAAK,EAAE;;AAIlB,KAAI,OAAO,MAAM,IACf,QAAO,KAAK,IAAI,GAAG,iBAAiB,YAAY;AAC9C,SAAO,SAAS,QAAQ;GACxB;AAGJ,EAAC,YAAY;AACX,MAAI;AACF,SAAM,MAAM,YAAY,OAAO;AAE/B,SAAM,OAAO,OAAO;AAEpB,OAAI,MAAM,MACR,OAAM,KAAK,MAAM,OAAO;WAEnB,OAAO;AACd,UAAO,KAAK,MAAM,0BAA0B,MAAM;;KAElD;AAEJ,CAAC,OAAe,SAAS;AAEzB,QAAO"}
+{"version":3,"file":"index.browser.js","names":["KIND: unique symbol","MODULE: unique symbol","OPTIONS: unique symbol","__alephaRef: {\n  alepha?: Alepha;\n  service?: Service & {\n    [MODULE]?: Service;\n  };\n  parent?: Service;\n}","error: any","obj: any","ctx: any","atoms: Array<AtomWithValue>","entry: ServiceEntry<T>","instance: T","definition: ServiceDefinition<T>","parent","graph: Record<\n      string,\n      { from: string[]; as?: string[]; module?: string }\n    >","list: Array<T>","t: TypeProvider"],"sources":["../../src/core/constants/KIND.ts","../../src/core/constants/MODULE.ts","../../src/core/constants/OPTIONS.ts","../../src/core/errors/AlephaError.ts","../../src/core/errors/CircularDependencyError.ts","../../src/core/errors/ContainerLockedError.ts","../../src/core/errors/TooLateSubstitutionError.ts","../../src/core/errors/MissingContextError.ts","../../src/core/helpers/ref.ts","../../src/core/primitives/$context.ts","../../src/core/helpers/primitive.ts","../../src/core/interfaces/Service.ts","../../src/core/primitives/$module.ts","../../src/core/providers/AlsProvider.ts","../../src/core/primitives/$inject.ts","../../src/core/providers/Json.ts","../../src/core/providers/SchemaCodec.ts","../../src/core/providers/JsonSchemaCodec.ts","../../src/core/errors/TypeBoxError.ts","../../src/core/providers/SchemaValidator.ts","../../src/core/providers/CodecManager.ts","../../src/core/providers/EventManager.ts","../../src/core/primitives/$atom.ts","../../src/core/providers/StateManager.ts","../../src/core/Alepha.ts","../../src/core/errors/AppNotStartedError.ts","../../src/core/helpers/createPagination.ts","../../src/core/helpers/FileLike.ts","../../src/core/providers/TypeProvider.ts","../../src/core/primitives/$env.ts","../../src/core/primitives/$hook.ts","../../src/core/primitives/$use.ts","../../src/core/schemas/pageQuerySchema.ts","../../src/core/schemas/pageSchema.ts","../../src/core/index.browser.ts"],"sourcesContent":["/**\n * Used for identifying primitives.\n *\n * @internal\n */\nexport const KIND: unique symbol = Symbol.for(\"Alepha.Kind\");\n","/**\n * Used for identifying modules.\n *\n * @internal\n */\nexport const MODULE: unique symbol = Symbol.for(\"Alepha.Module\");\n","/**\n * Used for primitives options.\n *\n * @internal\n */\nexport const OPTIONS: unique symbol = Symbol.for(\"Alepha.Options\");\n","// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Default error class for Alepha.\n */\nexport class AlephaError extends Error {\n  name = \"AlephaError\";\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class CircularDependencyError extends AlephaError {\n  readonly name = \"CircularDependencyError\";\n\n  constructor(provider: string, parents?: string[]) {\n    super(\n      `Instance not available. Looks like a circular dependency. ? -> ${parents?.map((name) => `${name} -> `).join(\"\")}${provider} -> ?`,\n    );\n  }\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class ContainerLockedError extends AlephaError {\n  readonly name = \"ContainerLockedError\";\n\n  constructor(\n    message = \"Container is locked. No more providers can be added.\",\n  ) {\n    super(message);\n  }\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class TooLateSubstitutionError extends AlephaError {\n  readonly name = \"TooLateSubstitutionError\";\n\n  constructor(original: string, substitution: string) {\n    super(\n      `Service already substituted. Please, substitute Service '${original}' with Service '${substitution}' before using it.`,\n    );\n  }\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class MissingContextError extends AlephaError {\n  readonly name = \"MissingContextError\";\n\n  constructor() {\n    super(\"Missing context. Did you forget to call Alepha.create()?\");\n    this.name = \"MissingContextError\";\n  }\n}\n","import type { Alepha } from \"../Alepha.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport type { Service } from \"../interfaces/Service.ts\";\n\n/**\n * Store the current context and definition during injection phase.\n *\n * @internal\n */\nexport const __alephaRef: {\n  alepha?: Alepha;\n  service?: Service & {\n    [MODULE]?: Service;\n  };\n  parent?: Service;\n} = {};\n\n/**\n * Note:\n *\n * This file is used to share context between $primitives and the Alepha core during the injection phase.\n *\n * There is no side effect as long as Alepha is not used concurrently in multiple contexts (which is not the case).\n *\n * // __alephaRef === undefined\n * // begin alepha.with()\n * //   __alephaRef.context = alepha\n * //   ... injection phase ...\n * //   __alephaRef.context = undefined\n * // end alepha.with()\n * // __alephaRef === undefined\n *\n * As .with() is synchronous, there is no risk of context leakage.\n *\n * ---------------------------------------------------------------------------------------------------------------------\n *\n * Why this helper?\n *\n * It allows to avoid passing Alepha instance to every $hook, $inject, etc. calls. It's a beautiful syntactic sugar.\n *\n * With sugar:\n *\n * class A {\n *   on = $hook( ... ) // <- __alephaRef is set here\n * }\n *\n * Without sugar:\n *\n * class A {\n *   constructor(alepha: Alepha) {\n *     this.on = $hook(alepha, ... ) // <- no need of __alephaRef\n *   }\n * }\n *\n * One main goal of Alepha is working with classes but without the class verbosity.\n * Forcing to pass Alepha instance in constructors would be a step back in that direction!\n */\n","import type { Alepha } from \"../Alepha.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport { MissingContextError } from \"../errors/MissingContextError.ts\";\nimport { __alephaRef } from \"../helpers/ref.ts\";\nimport type { Service } from \"../interfaces/Service.ts\";\n\n/**\n * Get Alepha instance and current service from the current context.\n *\n * It can only be used inside $primitive functions.\n *\n * ```ts\n * import { $context } from \"alepha\";\n *\n * const $hello = () => {\n *   const { alepha, service, module } = $context();\n *\n *   // alepha - alepha instance\n *   // service - class which is creating this primitive, this is NOT the instance but the service definition\n *   // module - module definition, if any\n *\n *   return {};\n * }\n *\n * class MyService {\n *   hello = $hello();\n * }\n *\n * const alepha = new Alepha().with(MyService);\n * ```\n *\n * @internal\n */\nexport const $context = (): ContextPrimitive => {\n  if (!__alephaRef.alepha) {\n    throw new MissingContextError();\n  }\n\n  return {\n    alepha: __alephaRef.alepha,\n    service: __alephaRef.service,\n    module: __alephaRef.service?.[MODULE],\n  };\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ContextPrimitive {\n  /**\n   * Alepha instance.\n   */\n  alepha: Alepha;\n  /**\n   * Service definition which is creating this primitive.\n   * This is NOT the instance but the service definition.\n   */\n  service?: Service;\n  /**\n   * Module definition, if any.\n   */\n  module?: Service;\n}\n","import { Alepha } from \"../Alepha.ts\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport type { InstantiableClass, Service } from \"../interfaces/Service.ts\";\nimport { $context } from \"../primitives/$context.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface PrimitiveArgs<T extends object = {}> {\n  options: T;\n  alepha: Alepha;\n  service: InstantiableClass<Service>;\n  module?: Service;\n}\n\nexport interface PrimitiveConfig {\n  propertyKey: string;\n  service: InstantiableClass<Service>;\n  module?: Service;\n}\n\nexport abstract class Primitive<T extends object = {}> {\n  protected readonly alepha: Alepha;\n\n  public readonly options: T;\n  public readonly config: PrimitiveConfig;\n\n  constructor(args: PrimitiveArgs<T>) {\n    this.alepha = args.alepha;\n    this.options = args.options;\n    this.config = {\n      propertyKey: \"\",\n      service: args.service,\n      module: args.module,\n    };\n  }\n\n  /**\n   * Called automatically by Alepha after the primitive is created.\n   */\n  protected onInit(): void {\n    // this method can be overridden by subclasses to perform initialization logic.\n    // - use onInit instead of the constructor when you need to access `config.propertyKey`\n    // - onInit must be synchronous\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type PrimitiveFactory<TPrimitive extends Primitive = Primitive> = {\n  (options: TPrimitive[\"options\"]): TPrimitive;\n  [KIND]: InstantiableClass<TPrimitive>;\n};\n\nexport type PrimitiveFactoryLike<T extends object = any> = {\n  (options: T): any;\n  [KIND]: any;\n};\n\nexport const createPrimitive = <TPrimitive extends Primitive>(\n  primitive: InstantiableClass<TPrimitive> & { [MODULE]?: Service },\n  options: TPrimitive[\"options\"],\n): TPrimitive => {\n  const { alepha, service } = $context();\n\n  if (MODULE in primitive && primitive[MODULE]) {\n    alepha.with(primitive[MODULE]);\n  }\n\n  return alepha.inject(primitive, {\n    lifetime: \"transient\",\n    args: [\n      {\n        options,\n        alepha: alepha,\n        service: service ?? Alepha,\n      },\n    ],\n  });\n};\n","// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In Alepha, a service is a class that can be instantiated or an abstract class. Nothing more, nothing less...\n */\nexport type Service<T extends object = any> =\n  | InstantiableClass<T>\n  | AbstractClass<T>\n  | RunFunction<T>;\n\nexport type RunFunction<T extends object = any> = (...args: any[]) => T | void;\n\nexport type InstantiableClass<T extends object = any> = new (\n  ...args: any[]\n) => T;\n\n/**\n * Abstract class is a class that cannot be instantiated directly!\n * It widely used for defining interfaces.\n */\nexport type AbstractClass<T extends object = any> = abstract new (\n  ...args: any[]\n) => T;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Service substitution allows you to register a class as a different class.\n * Providing class A, but using class B instead.\n * This is useful for testing, mocking, or providing a different implementation of a service.\n *\n * class A is mostly an AbstractClass, while class B is an InstantiableClass.\n */\nexport interface ServiceSubstitution<T extends object = any> {\n  /**\n   * Every time someone asks for this class, it will be provided with the 'use' class.\n   */\n  provide: Service<T>;\n\n  /**\n   * Service to use instead of the 'provide' service.\n   *\n   * Syntax is inspired by Angular's DI system.\n   */\n  use: Service<T>;\n\n  /**\n   * If true, if the service already exists -> just ignore the substitution and do not throw an error.\n   * Mostly used for plugins to enforce a substitution without throwing an error.\n   */\n  optional?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Every time you register a service, you can use this type to define it.\n *\n * alepha.with( ServiceEntry )\n * or\n * alepha.with( provide: ServiceEntry, use: MyOwnServiceEntry )\n *\n * And yes, you declare the *type* of the service, not the *instance*.\n */\nexport type ServiceEntry<T extends object = any> =\n  | Service<T>\n  | ServiceSubstitution<T>;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport function isClass(func: any): func is InstantiableClass {\n  // Classes have a non-writable prototype.constructor\n  if (typeof func !== \"function\") return false;\n\n  const descriptor = Object.getOwnPropertyDescriptor(func, \"prototype\");\n  return !!descriptor && !descriptor.writable;\n}\n","import type { Alepha } from \"../Alepha.ts\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport { MODULE } from \"../constants/MODULE.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport type { PrimitiveFactoryLike } from \"../helpers/primitive.ts\";\nimport type { Service } from \"../interfaces/Service.ts\";\n\n/**\n * Wrap Services and Primitives into a Module.\n *\n * - A module is just a Service with some extra {@link Module}.\n * - You must attach a `name` to it.\n * - Name must follow the pattern: `project.module.submodule`. (e.g. `myapp.users.auth`).\n *\n * @example\n * ```ts\n * import { $module } from \"alepha\";\n * import { MyService } from \"./MyService.ts\";\n *\n * // export MyService, so it can be used everywhere (optional)\n * export * from \"./MyService.ts\";\n *\n * export default $module({\n *  name: \"my.project.module\",\n *  // MyService will have a module context \"my.project.module\"\n *  services: [MyService],\n * });\n * ```\n *\n * ### Why Modules?\n *\n * #### Logging\n *\n * By default, AlephaLogger will log the module name in the logs.\n * This helps to identify where the logs are coming from.\n *\n * You can also set different log levels for different modules.\n * It means you can set 'some.very.specific.module' to 'debug' and keep the rest of the application to 'info'.\n *\n * #### Modulith\n *\n * Force to structure your application in modules, even if it's a single deployable unit.\n * It helps to keep a clean architecture and avoid monolithic applications.\n *\n * A strict mode flag will probably come to enforce module boundaries.\n * -> Throwing errors when a service from another module is injected.\n * But it's not implemented yet.\n *\n * ### When not to use Modules?\n *\n * Small applications does not need modules. It's better to keep it simple.\n * Modules are more useful when the application grows and needs to be structured.\n * If we speak with number of `$actions`, a module should be used when you have more than 30 actions in a single module.\n * Meaning that if you have 100 actions, you should have at least 3 modules.\n */\nexport const $module = <T extends object = {}>(\n  options: ModulePrimitiveOptions,\n): Service<Module> => {\n  const { services = [], primitives = [], name } = options;\n\n  // ensure name is valid\n  if (!name || !Module.NAME_REGEX.test(name)) {\n    throw new AlephaError(\n      `Invalid module name '${name}'. It should be in the format of 'project.module.submodule'`,\n    );\n  }\n\n  const $ = class extends Module {\n    options = options;\n\n    register(alepha: Alepha): void {\n      if (typeof options.register === \"function\") {\n        options.register(alepha);\n        return;\n      }\n\n      for (const service of services) {\n        alepha.inject(service, {\n          parent: this.constructor as Service<Module>,\n        });\n      }\n    }\n  };\n\n  // force name property\n  Object.defineProperty($, \"name\", {\n    value: name,\n    writable: false,\n  });\n\n  for (const service of services) {\n    if (!Module.is(service)) {\n      (service as WithModule)[MODULE] = $;\n    }\n  }\n\n  for (const factory of primitives) {\n    if (typeof factory[KIND] === \"function\") {\n      factory[KIND][MODULE] = $;\n    }\n  }\n\n  return $; // module as Service<Module<T>>;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface ModulePrimitiveOptions {\n  /**\n   * Name of the module.\n   *\n   * It should be in the format of `project.module.submodule`.\n   */\n  name: string;\n\n  /**\n   * List all services related to this module.\n   *\n   * If you don't declare 'register' function, all services will be registered automatically.\n   * If you declare 'register' function, you must handle the registration of ALL services manually.\n   */\n  services?: Array<Service>;\n\n  /**\n   * List of $primitives to register in the module.\n   */\n  primitives?: Array<PrimitiveFactoryLike>;\n\n  /**\n   * By default, module will register ALL services.\n   * You can override this behavior by providing a register function.\n   * It's useful when you want to register services conditionally or in a specific order.\n   *\n   * Again, if you declare 'register', you must handle the registration of ALL services manually.\n   */\n  register?: (alepha: Alepha) => void;\n}\n\n/**\n * Base class for all modules.\n */\nexport abstract class Module {\n  public abstract readonly options: ModulePrimitiveOptions;\n\n  public abstract register(alepha: Alepha): void;\n\n  static NAME_REGEX = /^[a-z]+(\\.[a-z][a-z0-9-]*)*$/;\n\n  /**\n   * Check if a Service is a Module.\n   */\n  static is(ctor: Service): boolean {\n    return ctor.prototype instanceof Module;\n  }\n\n  /**\n   * Get the Module of a Service.\n   *\n   * Returns undefined if the Service is not part of a Module.\n   */\n  static of(ctor: Service): Service<Module> | undefined {\n    return (ctor as WithModule)[MODULE];\n  }\n}\n\n/**\n * Helper type to add Module metadata to a Service.\n */\nexport type WithModule<T extends object = any> = T & {\n  [MODULE]?: Service;\n};\n","import type { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport type AsyncLocalStorageData = any;\n\nexport class AlsProvider {\n  static create = (): AsyncLocalStorage<AsyncLocalStorageData> | undefined => {\n    return undefined;\n  };\n\n  public als?: AsyncLocalStorage<AsyncLocalStorageData>;\n\n  constructor() {\n    this.als = AlsProvider.create();\n  }\n\n  public createContextId(): string {\n    return crypto.randomUUID();\n  }\n\n  public run<R>(callback: () => R, data: Record<string, any> = {}): R {\n    if (!this.als) {\n      return callback();\n    }\n\n    data.registry ??= new Map();\n    data.context ??= this.createContextId();\n\n    return this.als.run(data, callback);\n  }\n\n  public exists(): boolean {\n    return !!this.get(\"context\");\n  }\n\n  public get<T>(key: string): T | undefined {\n    if (!this.als) {\n      return undefined;\n    }\n\n    const store = this.als.getStore();\n    if (store) {\n      return store[key] as T;\n    }\n\n    return undefined;\n  }\n\n  public set<T>(key: string, value: T): void {\n    if (!this.als) {\n      return;\n    }\n\n    const store = this.als.getStore();\n    if (store) {\n      store[key] = value;\n    }\n  }\n}\n","import { Primitive } from \"../helpers/primitive.ts\";\nimport type { InstantiableClass, Service } from \"../interfaces/Service.ts\";\nimport { $context } from \"./$context.ts\";\n\n/**\n * Get the instance of the specified type from the context.\n *\n * ```ts\n * class A { }\n * class B {\n *   a = $inject(A);\n * }\n * ```\n */\nexport const $inject = <T extends object>(\n  type: Service<T>,\n  opts: InjectOptions<T> = {},\n): T => {\n  const { alepha, service } = $context();\n\n  // _ = $inject(Alepha)\n  if (type === alepha.constructor) {\n    return alepha as T;\n  }\n\n  return alepha.inject(type, {\n    // keep the parent for better error messages and circular dependencies detection\n    parent: service ?? (alepha.constructor as Service),\n    ...opts,\n  });\n};\n\nexport class InjectPrimitive extends Primitive {}\n\nexport interface InjectOptions<T extends object = any> {\n  /**\n   * - 'transient' → Always a new instance on every inject. Zero caching.\n   * - 'singleton' → One instance per Alepha runtime (per-thread). Never disposed until Alepha shuts down. (default)\n   * - 'scoped' → One instance per AsyncLocalStorage context.\n   *   - A new scope is created when Alepha handles a request, a scheduled job, a queue worker task...\n   *   - You can also start a manual scope via alepha.context.run(() => { ... }).\n   *   - When the scope ends, the scoped registry is discarded.\n   *\n   * @default \"singleton\"\n   */\n  lifetime?: \"transient\" | \"singleton\" | \"scoped\";\n\n  /**\n   * Constructor arguments to pass when creating a new instance.\n   */\n  args?: ConstructorParameters<InstantiableClass<T>>;\n\n  /**\n   * Parent that requested the instance.\n   *\n   * @internal\n   */\n  parent?: Service | null;\n}\n","/**\n * Mimics the JSON global object with stringify and parse methods.\n *\n * Used across the codebase via dependency injection.\n */\nexport class Json {\n  public stringify(\n    value: any,\n    replacer?: (this: any, key: string, value: any) => any,\n    space?: string | number,\n  ): string {\n    return JSON.stringify(value, replacer, space);\n  }\n\n  public parse(\n    text: string,\n    reviver?: (this: any, key: string, value: any) => any,\n  ) {\n    return JSON.parse(text, reviver);\n  }\n}\n","import type { Static, TSchema } from \"./TypeProvider.ts\";\n\nexport abstract class SchemaCodec {\n  /**\n   * Encode the value to a string format.\n   */\n  public abstract encodeToString<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): string;\n\n  /**\n   * Encode the value to a binary format.\n   */\n  public abstract encodeToBinary<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): Uint8Array;\n\n  /**\n   * Decode string, binary, or other formats to the schema type.\n   */\n  public abstract decode<T>(schema: TSchema, value: unknown): T;\n}\n","import type { TSchema } from \"typebox\";\nimport { $inject } from \"../primitives/$inject.ts\";\nimport { Json } from \"./Json.ts\";\nimport { SchemaCodec } from \"./SchemaCodec.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport class JsonSchemaCodec extends SchemaCodec {\n  protected readonly json = $inject(Json);\n  protected readonly encoder = new TextEncoder();\n  protected readonly decoder = new TextDecoder();\n\n  public encodeToString<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): string {\n    return this.json.stringify(value);\n  }\n\n  public encodeToBinary<T extends TSchema>(\n    schema: T,\n    value: Static<T>,\n  ): Uint8Array {\n    return this.encoder.encode(this.encodeToString(schema, value));\n  }\n\n  public decode<T>(schema: TSchema, value: unknown): T {\n    if (value instanceof Uint8Array) {\n      const text = this.decoder.decode(value);\n      return this.json.parse(text);\n    }\n\n    if (typeof value === \"string\") {\n      // Only parse if it looks like JSON (starts with { or [)\n      const trimmed = value.trim();\n      if (trimmed.startsWith(\"{\") || trimmed.startsWith(\"[\")) {\n        return this.json.parse(value);\n      }\n      // Return plain strings as-is\n      return value as T;\n    }\n\n    return value as T;\n  }\n}\n","import type { TLocalizedValidationError } from \"typebox/error\";\nimport { AlephaError } from \"./AlephaError.ts\";\n\nexport class TypeBoxError extends AlephaError {\n  name = \"TypeBoxError\";\n\n  public readonly cause: TLocalizedValidationError;\n  public readonly value: {\n    path: string;\n    message: string;\n  };\n\n  constructor(error: TLocalizedValidationError) {\n    super(\n      `Invalid input: ${error.message}${error.instancePath ? ` at ${error.instancePath}` : \"\"}`,\n      {\n        cause: error,\n      },\n    );\n    const params = error.params as TypeBoxErrorParams;\n    if (params?.requiredProperties) {\n      this.value = {\n        path: `/${params.requiredProperties[0]}`,\n        message: \"must be defined\",\n      };\n    } else {\n      this.value = {\n        path: error.instancePath,\n        message: error.message,\n      };\n    }\n\n    this.cause = error;\n  }\n}\n\nexport interface TypeBoxErrorParams {\n  requiredProperties?: string[];\n}\n","import type { TSchema } from \"typebox\";\nimport { Compile, type Validator } from \"typebox/compile\";\nimport { TypeBoxError } from \"../errors/TypeBoxError.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport class SchemaValidator {\n  protected cache = new Map<TSchema, Validator>();\n\n  /**\n   * Validate the value against the provided schema.\n   *\n   * Validation create a new value by applying some preprocessing. (e.g., trimming text)\n   */\n  public validate<T extends TSchema>(\n    schema: T,\n    value: unknown,\n    options: ValidateOptions = {},\n  ): Static<T> {\n    const newValue = this.beforeParse(schema, value, {\n      trim: options.trim ?? true,\n      nullToUndefined: options.nullToUndefined ?? true,\n      deleteUndefined: options.deleteUndefined ?? true,\n    });\n\n    try {\n      return this.getValidator(schema).Parse(newValue);\n    } catch (error: any) {\n      if (error.cause?.errors?.[0]) {\n        throw new TypeBoxError(error.cause.errors[0]);\n      }\n      throw error;\n    }\n  }\n\n  protected getValidator<T extends TSchema>(schema: T): Validator<{}, T> {\n    if (this.cache.has(schema)) {\n      return this.cache.get(schema) as Validator<{}, T>;\n    }\n\n    const validator = Compile(schema);\n    this.cache.set(schema, validator);\n    return validator as Validator<{}, T>;\n  }\n\n  /**\n   * Preprocess the value based on the schema before validation.\n   *\n   * - If the value is `null` and the schema does not allow `null`, it converts it to `undefined`.\n   * - If the value is a string and the schema has a `~options.trim` flag, it trims whitespace from the string.\n   */\n  public beforeParse(schema: any, value: any, options: ValidateOptions): any {\n    if (!schema) {\n      return value;\n    }\n\n    if (\n      value === null &&\n      !this.isSchemaNullable(schema) &&\n      options.nullToUndefined\n    ) {\n      return undefined;\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((it) => this.beforeParse(schema.items, it, options));\n    }\n\n    if (typeof value === \"string\" && schema.type === \"string\") {\n      let str = value;\n\n      if (options.trim && schema[\"~options\"]?.trim) {\n        str = str.trim();\n      }\n\n      if (schema[\"~options\"]?.lowercase) {\n        str = str.toLowerCase();\n      }\n\n      return str;\n    }\n\n    if (\n      typeof value === \"object\" &&\n      value !== null &&\n      schema.type === \"object\"\n    ) {\n      const obj: any = {};\n\n      for (const key in value) {\n        const newValue = this.beforeParse(\n          schema.properties?.[key],\n          value[key],\n          options,\n        );\n\n        if (newValue === undefined && options.deleteUndefined) {\n          continue;\n        }\n\n        obj[key] = newValue;\n      }\n\n      return obj;\n    }\n\n    return value;\n  }\n\n  /**\n   * Used by `beforeParse` to determine if a schema allows null values.\n   */\n  protected isSchemaNullable = (schema: any): boolean => {\n    if (!schema) {\n      return false;\n    }\n    if (schema.type === \"null\") {\n      return true;\n    }\n    if (Array.isArray(schema.type) && schema.type.includes(\"null\")) {\n      return true;\n    }\n    if (schema.anyOf) {\n      return schema.anyOf.some((it: any) => this.isSchemaNullable(it));\n    }\n    if (schema.oneOf) {\n      return schema.oneOf.some((it: any) => this.isSchemaNullable(it));\n    }\n    if (schema.allOf) {\n      return schema.allOf.some((it: any) => this.isSchemaNullable(it));\n    }\n    return false;\n  };\n}\n\nexport interface ValidateOptions {\n  trim?: boolean;\n  nullToUndefined?: boolean;\n  deleteUndefined?: boolean;\n}\n","import type { StaticEncode, TSchema } from \"typebox\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport { $inject } from \"../primitives/$inject.ts\";\nimport { JsonSchemaCodec } from \"./JsonSchemaCodec.ts\";\nimport type { SchemaCodec } from \"./SchemaCodec.ts\";\nimport { SchemaValidator, type ValidateOptions } from \"./SchemaValidator.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport type Encoding = \"object\" | \"string\" | \"binary\";\n\nexport interface EncodeOptions<T extends Encoding = Encoding> {\n  /**\n   * The output encoding format:\n   * - 'string': Returns JSON string\n   * - 'binary': Returns Uint8Array (for protobuf, msgpack, etc.)\n   *\n   * @default \"string\"\n   */\n  as?: T;\n\n  /**\n   * The encoder to use (e.g., 'json', 'protobuf', 'msgpack')\n   *\n   * @default \"json\"\n   */\n  encoder?: string;\n\n  /**\n   * Validation options to apply before encoding.\n   */\n  validation?: ValidateOptions | false;\n}\n\nexport type EncodeResult<\n  T extends TSchema,\n  E extends Encoding,\n> = E extends \"string\"\n  ? string\n  : E extends \"binary\"\n    ? Uint8Array\n    : StaticEncode<T>;\n\nexport interface DecodeOptions {\n  /**\n   * The encoder to use (e.g., 'json', 'protobuf', 'msgpack')\n   *\n   * @default \"json\"\n   */\n  encoder?: string;\n\n  /**\n   * Validation options to apply before encoding.\n   */\n  validation?: ValidateOptions | false;\n}\n\n/**\n * CodecManager manages multiple codec formats and provides a unified interface\n * for encoding and decoding data with different formats.\n */\nexport class CodecManager {\n  protected readonly codecs: Map<string, SchemaCodec> = new Map();\n  protected readonly jsonCodec = $inject(JsonSchemaCodec);\n  protected readonly schemaValidator = $inject(SchemaValidator);\n\n  public default = \"json\";\n\n  constructor() {\n    // Register default JSON codec\n    this.register(this.default, this.jsonCodec);\n  }\n\n  /**\n   * Register a new codec format.\n   *\n   * @param name - The name of the codec (e.g., 'json', 'protobuf')\n   * @param codec - The codec implementation\n   */\n  public register(name: string, codec: SchemaCodec): void {\n    this.codecs.set(name, codec);\n  }\n\n  /**\n   * Get a specific codec by name.\n   *\n   * @param name - The name of the codec\n   * @returns The codec instance\n   * @throws {AlephaError} If the codec is not found\n   */\n  public getCodec(name: string): SchemaCodec {\n    const codec = this.codecs.get(name);\n    if (!codec) {\n      throw new AlephaError(\n        `Codec \"${name}\" not found. Available codecs: ${Array.from(this.codecs.keys()).join(\", \")}`,\n      );\n    }\n    return codec;\n  }\n\n  /**\n   * Encode data using the specified codec and output format.\n   */\n  public encode<T extends TSchema, E extends Encoding = \"object\">(\n    schema: T,\n    value: unknown,\n    options?: EncodeOptions<E>,\n  ): EncodeResult<T, E> {\n    const codec = this.getCodec(options?.encoder ?? this.default);\n    const as = options?.as ?? \"object\";\n\n    if (options?.validation !== false) {\n      value = this.schemaValidator.validate(schema, value, options?.validation);\n    }\n\n    if (as === \"object\") {\n      // Return the validated object as-is\n      return value as EncodeResult<T, E>;\n    }\n\n    if (as === \"binary\") {\n      // not used by JSON, but for other codecs like Protobuf, MsgPack, etc.\n      return codec.encodeToBinary(schema, value as Static<T>) as EncodeResult<\n        T,\n        E\n      >;\n    }\n\n    // encode directly to string\n    return codec.encodeToString(schema, value as Static<T>) as EncodeResult<\n      T,\n      E\n    >;\n  }\n\n  /**\n   * Decode data using the specified codec.\n   */\n  public decode<T extends TSchema>(\n    schema: T,\n    data: any,\n    options?: DecodeOptions,\n  ): Static<T> {\n    const encoderName = options?.encoder ?? this.default;\n    const codec = this.getCodec(encoderName);\n    let value = codec.decode(schema, data);\n\n    if (options?.validation !== false) {\n      value = this.schemaValidator.validate(schema, value, options?.validation);\n    }\n\n    return value as Static<T>;\n  }\n\n  /**\n   * Validate decoded data against the schema.\n   *\n   * This is automatically called before encoding or after decoding.\n   */\n  public validate<T extends TSchema>(\n    schema: T,\n    value: unknown,\n    options?: ValidateOptions,\n  ): Static<T> {\n    return this.schemaValidator.validate(schema, value, options);\n  }\n}\n","import type { Hook, Hooks } from \"../Alepha.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport type { Async } from \"../interfaces/Async.ts\";\nimport type { LoggerInterface } from \"../interfaces/LoggerInterface.ts\";\n\nexport class EventManager {\n  protected logFn?: () => LoggerInterface | undefined;\n\n  /**\n   * List of events that can be triggered. Powered by $hook().\n   */\n  protected events: Record<string, Array<Hook>> = {};\n\n  constructor(logFn?: () => LoggerInterface | undefined) {\n    this.logFn = logFn;\n  }\n\n  protected get log(): LoggerInterface | undefined {\n    return this.logFn?.();\n  }\n\n  /**\n   * Registers a hook for the specified event.\n   */\n  public on<T extends keyof Hooks>(\n    event: T,\n    hookOrFunc: Hook<T> | ((payload: Hooks[T]) => Async<void>),\n  ): () => void {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n\n    const hook =\n      typeof hookOrFunc === \"function\" ? { callback: hookOrFunc } : hookOrFunc;\n\n    if (hook.priority === \"first\") {\n      this.events[event].unshift(hook);\n    } else if (hook.priority === \"last\") {\n      this.events[event].push(hook);\n    } else {\n      const index = this.events[event].findIndex(\n        (it) => it.priority === \"last\",\n      );\n      if (index !== -1) {\n        this.events[event].splice(index, 0, hook);\n      } else {\n        this.events[event].push(hook);\n      }\n    }\n\n    return () => {\n      this.events[event] = this.events[event].filter(\n        (it) => it.callback !== hook.callback,\n      );\n    };\n  }\n\n  /**\n   * Emits the specified event with the given payload.\n   */\n  public async emit<T extends keyof Hooks>(\n    func: T,\n    payload: Hooks[T],\n    options: {\n      /**\n       * If true, the hooks will be executed in reverse order.\n       * This is useful for \"stop\" hooks that should be executed in reverse order.\n       *\n       * @default false\n       */\n      reverse?: boolean;\n      /**\n       * If true, the hooks will be logged with their execution time.\n       *\n       * @default false\n       */\n      log?: boolean;\n      /**\n       * If true, errors will be caught and logged instead of throwing.\n       *\n       * @default false\n       */\n      catch?: boolean;\n    } = {},\n  ): Promise<void> {\n    const ctx: any = {};\n\n    if (options.log) {\n      ctx.now = Date.now();\n      this.log?.trace(`${func} ...`);\n    }\n\n    let events = this.events[func] ?? [];\n\n    if (options.reverse) {\n      events = events.toReversed();\n    }\n\n    for (const hook of events) {\n      const name = hook.caller?.name ?? \"unknown\";\n      if (options.log) {\n        ctx.now2 = Date.now();\n        this.log?.trace(`${func}(${name}) ...`);\n      }\n\n      try {\n        await hook.callback(payload);\n      } catch (error) {\n        if (options.catch) {\n          this.log?.error(`${func}(${name}) ERROR`, error);\n          continue;\n        }\n        if (options.log) {\n          throw new AlephaError(\n            `Failed during '${func}()' hook for service: ${name}`,\n            { cause: error },\n          );\n        }\n        throw error;\n      }\n\n      if (options.log) {\n        this.log?.debug(`${func}(${name}) OK [${Date.now() - ctx.now2}ms]`);\n      }\n    }\n\n    if (options.log) {\n      this.log?.debug(`${func} OK [${Date.now() - ctx.now}ms]`);\n    }\n  }\n}\n","import type { TArray } from \"typebox\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport type {\n  Static,\n  TObject,\n  TOptionalAdd,\n} from \"../providers/TypeProvider.ts\";\n\n/**\n * Define an atom for state management.\n *\n * Atom lets you define a piece of state with a name, schema, and default value.\n *\n * By default, Alepha state is just a simple key-value store.\n * Using atoms allows you to have type safety, validation, and default values for your state.\n *\n * You control how state is structured and validated.\n *\n * Features:\n * - Set a schema for validation\n * - Set a default value for initial state\n * - Rules, like read-only, custom validation, etc.\n * - Automatic getter access in services with {@link $use}\n * - SSR support (server state automatically serialized and hydrated on client)\n * - React integration (useAtom hook for automatic component re-renders)\n * - Middleware\n * - Persistence adapters (localStorage, Redis, database, file system, cookie, etc.)\n * - State migrations (version upgrades when schema changes)\n * - Documentation generation & devtools integration\n *\n * Common use cases:\n * - user preferences\n * - feature flags\n * - configuration options\n * - session data\n *\n * Atom must contain only serializable data.\n * Avoid storing complex objects like class instances, functions, or DOM elements.\n * If you need to store complex data, consider using identifiers or references instead.\n */\nexport const $atom = <\n  T extends TObject<TProperties> | TArray,\n  N extends string,\n>(\n  options: AtomOptions<T, N>,\n): Atom<T, N> => {\n  return new Atom<T, N>(options);\n};\n\nexport type AtomOptions<T extends TAtomObject, N extends string> = {\n  name: N;\n  schema: T;\n  description?: string;\n} & (T extends TOptionalAdd<T>\n  ? {\n      default?: Static<T>;\n    }\n  : {\n      default: Static<T>;\n    });\n\nexport class Atom<T extends TAtomObject = TObject, N extends string = string> {\n  public readonly options: AtomOptions<T, N>;\n\n  public get schema(): T {\n    return this.options.schema;\n  }\n\n  public get key(): N {\n    return this.options.name;\n  }\n\n  constructor(options: AtomOptions<T, N>) {\n    this.options = options;\n  }\n}\n\n$atom[KIND] = \"atom\";\n\ntype TProperties = any; // it's required to avoid required [ string ] error, ...\n\nexport type TAtomObject = TObject<any> | TArray;\nexport type AtomStatic<T extends TAtomObject> =\n  T extends TOptionalAdd<T> ? Static<T> | undefined : Static<T>;\n","import type { TObject } from \"typebox\";\nimport type { State as AlephaState } from \"../Alepha.ts\";\nimport {\n  Atom,\n  type AtomStatic,\n  type TAtomObject,\n} from \"../primitives/$atom.ts\";\nimport { $inject } from \"../primitives/$inject.ts\";\nimport { AlsProvider } from \"./AlsProvider.ts\";\nimport { EventManager } from \"./EventManager.ts\";\nimport { JsonSchemaCodec } from \"./JsonSchemaCodec.ts\";\nimport type { Static } from \"./TypeProvider.ts\";\n\nexport interface AtomWithValue {\n  atom: Atom;\n  value: unknown;\n}\n\nexport class StateManager<State extends object = AlephaState> {\n  protected readonly als = $inject(AlsProvider);\n  protected readonly events = $inject(EventManager);\n  protected readonly codec = $inject(JsonSchemaCodec);\n  protected readonly atoms = new Map<keyof State, Atom>();\n\n  protected store: Partial<State> = {};\n\n  constructor(store: Partial<State> = {}) {\n    this.store = store;\n  }\n\n  public getAtoms(context = true): Array<AtomWithValue> {\n    const atoms: Array<AtomWithValue> = [];\n\n    if (context && this.als?.exists()) {\n      // for each this.atoms, check if key is present in als, if yes, add to new map\n      for (const atom of this.atoms.values()) {\n        const value = this.als.get(atom.key);\n        if (value !== undefined) {\n          atoms.push({ atom, value });\n        }\n      }\n    } else {\n      for (const [key, atom] of this.atoms.entries()) {\n        atoms.push({ atom, value: this.store[key] as unknown });\n      }\n    }\n\n    return atoms;\n  }\n\n  public register(atom: Atom<any>): this {\n    const key = atom.key as keyof State;\n\n    if (!this.atoms.has(key)) {\n      this.atoms.set(key, atom);\n      if (!(key in this.store)) {\n        this.set(key, atom.options.default as State[keyof State]);\n      }\n    }\n\n    return this;\n  }\n\n  /**\n   * Get a value from the state with proper typing\n   */\n  public get<T extends TAtomObject>(target: Atom<T>): Static<T>;\n  public get<Key extends keyof State>(target: Key): State[Key] | undefined;\n  public get(target: string | object): any {\n    if (target instanceof Atom) {\n      this.register(target);\n    }\n\n    const key = target instanceof Atom ? target.key : target;\n    const store = this.store as Record<string, any>;\n\n    return this.als?.exists()\n      ? (this.als.get(key as string) ?? store[key])\n      : store[key];\n  }\n\n  /**\n   * Set a value in the state\n   */\n  public set<T extends TAtomObject>(\n    target: Atom<T>,\n    value: AtomStatic<T>,\n  ): this;\n  public set<Key extends keyof State>(\n    target: Key,\n    value: State[Key] | undefined,\n  ): this;\n  public set(target: any, value: any): this {\n    if (target instanceof Atom) {\n      this.register(target);\n    }\n\n    const key = target instanceof Atom ? target.key : target;\n    const store = this.store as Record<string, any>;\n\n    const prevValue = this.get(key);\n    if (prevValue === value) {\n      return this;\n    }\n\n    if (this.als?.exists()) {\n      this.als.set(key as string, value);\n    } else {\n      store[key] = value;\n    }\n\n    this.events\n      ?.emit(\n        \"state:mutate\",\n        { key: key as keyof AlephaState, value, prevValue },\n        { catch: true },\n      )\n      .catch(() => null);\n\n    return this;\n  }\n\n  /**\n   * Mutate a value in the state.\n   */\n  public mut<T extends TObject>(\n    target: Atom<T>,\n    mutator: (current: Static<T>) => Static<T>,\n  ): this;\n  public mut<Key extends keyof State>(\n    target: Key,\n    mutator: (current: State[Key] | undefined) => State[Key] | undefined,\n  ): this;\n  public mut(target: any, mutator: (current: any) => any): this {\n    const current = this.get(target);\n    const updated = mutator(current);\n    return this.set(target, updated);\n  }\n\n  /**\n   * Check if a key exists in the state\n   */\n  public has<Key extends keyof State>(key: Key): boolean {\n    return key in this.store;\n  }\n\n  /**\n   * Delete a key from the state (set to undefined)\n   */\n  public del<Key extends keyof State>(key: Key): this {\n    return this.set(key, undefined);\n  }\n\n  /**\n   * Push a value to an array in the state\n   */\n  public push<Key extends keyof OnlyArray<State>>(\n    key: Key,\n    value: NonNullable<State[Key]> extends Array<infer U> ? U : never,\n  ): this {\n    const current = (this.get(key) ?? []) as Array<any>; // default to empty array\n    if (Array.isArray(current)) {\n      this.set(key, [...current, value] as State[Key]);\n    }\n    return this;\n  }\n\n  /**\n   * Clear all state\n   */\n  public clear(): this {\n    this.store = {};\n    return this;\n  }\n\n  /**\n   * Get all keys that exist in the state\n   */\n  public keys(): (keyof State)[] {\n    return Object.keys(this.store) as (keyof State)[];\n  }\n}\n\ntype OnlyArray<T extends object> = {\n  [K in keyof T]: NonNullable<T[K]> extends Array<any> ? K : never;\n};\n","import type { Static, TObject } from \"typebox\";\nimport { KIND } from \"./constants/KIND.ts\";\nimport { MODULE } from \"./constants/MODULE.ts\";\nimport { OPTIONS } from \"./constants/OPTIONS.ts\";\nimport { AlephaError } from \"./errors/AlephaError.ts\";\nimport { CircularDependencyError } from \"./errors/CircularDependencyError.ts\";\nimport { ContainerLockedError } from \"./errors/ContainerLockedError.ts\";\nimport { TooLateSubstitutionError } from \"./errors/TooLateSubstitutionError.ts\";\nimport { Primitive } from \"./helpers/primitive.ts\";\nimport { __alephaRef } from \"./helpers/ref.ts\";\nimport type { Async } from \"./interfaces/Async.ts\";\nimport type { LoggerInterface } from \"./interfaces/LoggerInterface.ts\";\nimport {\n  type InstantiableClass,\n  isClass,\n  type RunFunction,\n  type Service,\n  type ServiceEntry,\n} from \"./interfaces/Service.ts\";\nimport type { InjectOptions } from \"./primitives/$inject.ts\";\nimport { Module, type WithModule } from \"./primitives/$module.ts\";\nimport { AlsProvider } from \"./providers/AlsProvider.ts\";\nimport { CodecManager } from \"./providers/CodecManager.ts\";\nimport { EventManager } from \"./providers/EventManager.ts\";\nimport { StateManager } from \"./providers/StateManager.ts\";\nimport type { TSchema } from \"./providers/TypeProvider.ts\";\n\n/**\n * Core container of the Alepha framework.\n *\n * It is responsible for managing the lifecycle of services,\n * handling dependency injection,\n * and providing a unified interface for the application.\n *\n * @example\n * ```ts\n * import { Alepha, run } from \"alepha\";\n *\n * class MyService {\n *   // business logic here\n * }\n *\n * const alepha = Alepha.create({\n *   // state, env, and other properties\n * })\n *\n * alepha.with(MyService);\n *\n * run(alepha); // trigger .start (and .stop) automatically\n * ```\n *\n * ### Alepha Factory\n *\n * Alepha.create() is an enhanced version of new Alepha().\n * - It merges `process.env` with the provided state.env when available.\n * - It populates the test hooks for Vitest or Jest environments when available.\n *\n * new Alepha() is fine if you don't need these helpers.\n *\n * ### Platforms & Environments\n *\n * Alepha is designed to work in various environments:\n * - **Browser**: Runs in the browser, using the global `window` object.\n * - **Serverless**: Runs in serverless environments like Vercel or Vite.\n * - **Test**: Runs in test environments like Jest or Vitest.\n * - **Production**: Runs in production environments, typically with NODE_ENV set to \"production\".\n * * You can check the current environment using the following methods:\n *\n * - `isBrowser()`: Returns true if the App is running in a browser environment.\n * - `isServerless()`: Returns true if the App is running in a serverless environment.\n * - `isTest()`: Returns true if the App is running in a test environment.\n * - `isProduction()`: Returns true if the App is running in a production environment.\n *\n * ### State & Environment\n *\n * The state of the Alepha container is stored in the `store` property.\n * Most important property is `store.env`, which contains the environment variables.\n *\n * ```ts\n * const alepha = Alepha.create({ env: { MY_VAR: \"value\" } });\n *\n * // You can access the environment variables using alepha.env\n * console.log(alepha.env.MY_VAR); // \"value\"\n *\n * // But you should use $env() primitive to get typed values from the environment.\n * class App {\n *   env = $env(\n *     t.object({\n *  \t   MY_VAR: t.text(),\n *     })\n *   );\n * }\n * ```\n *\n * ### Modules\n *\n * Modules are a way to group services together.\n * You can register a module using the `$module` primitive.\n *\n * ```ts\n * import { $module } from \"alepha\";\n *\n * class MyLib {}\n *\n * const myModule = $module({\n *   name: \"my.project.module\",\n *   services: [MyLib],\n * });\n * ```\n *\n * Do not use modules for small applications.\n *\n * ### Hooks\n *\n * Hooks are a way to run async functions from all registered providers/services.\n * You can register a hook using the `$hook` primitive.\n *\n * ```ts\n * import { $hook } from \"alepha\";\n *\n * class App {\n * \t log = $logger();\n * \t onCustomerHook = $hook({\n * \t\t\ton: \"my:custom:hook\",\n * \t\t\thandler: () => {\n * \t\t \t  this.log?.info(\"App is being configured\");\n * \t \t\t},\n * \t  });\n * \t}\n *\n * Alepha.create()\n * \t .with(App)\n * \t .start()\n * \t .then(alepha => alepha.events.emit(\"my:custom:hook\"));\n * ```\n *\n * \tHooks are fully typed. You can create your own hooks by using module augmentation:\n *\n * \t```ts\n * \tdeclare module \"alepha\" {\n * \t\tinterface Hooks {\n * \t\t  \"my:custom:hook\": {\n * \t\t\t\targ1: string;\n * \t\t  }\n * \t\t}\n * \t}\n * \t```\n *\n * \t@module alepha\n */\nexport class Alepha {\n  /**\n   * Creates a new instance of the Alepha container with some helpers:\n   *\n   * - merges `process.env` with the provided state.env when available.\n   * - populates the test hooks for Vitest or Jest environments when available.\n   *\n   * If you are not interested about these helpers, you can use the constructor directly.\n   */\n  public static create(state: Partial<State> = {}): Alepha {\n    // merge process.env with the state.env\n    if (typeof process === \"object\" && typeof process.env === \"object\") {\n      state.env = {\n        ...state.env,\n        ...process.env,\n      };\n    }\n\n    const alepha = new Alepha(state);\n\n    if (alepha.isTest()) {\n      // inject global hooks for testing purposes\n      // > for vitest, { globals: true } is required in the config\n      const g = globalThis as any;\n      const beforeAll = state[\"alepha.test.beforeAll\"] ?? g.beforeAll;\n      const afterAll = state[\"alepha.test.afterAll\"] ?? g.afterAll;\n      const afterEach = state[\"alepha.test.afterEach\"] ?? g.afterEach;\n      const onTestFinished =\n        state[\"alepha.test.onTestFinished\"] ?? g.onTestFinished;\n\n      beforeAll?.(() => alepha.start());\n      afterAll?.(() => alepha.stop());\n\n      try {\n        onTestFinished?.(() => alepha.stop());\n      } catch (_error) {\n        // ignore\n      }\n\n      alepha.store\n        .set(\"alepha.test.beforeAll\", beforeAll)\n        .set(\"alepha.test.afterAll\", afterAll)\n        .set(\"alepha.test.afterEach\", afterEach)\n        .set(\"alepha.test.onTestFinished\", onTestFinished);\n    }\n\n    return alepha;\n  }\n\n  /**\n   * Flag indicating whether the App won't accept any further changes.\n   * Pass to true when #start() is called.\n   */\n  protected locked = false;\n\n  /**\n   * True if the App has been configured.\n   */\n  protected configured = false;\n\n  /**\n   * True if the App has started.\n   */\n  protected started = false;\n\n  /**\n   * True if the App is ready.\n   */\n  protected ready = false;\n\n  /**\n   * A promise that resolves when the App has started.\n   */\n  protected starting?: PromiseWithResolvers<this>;\n\n  /**\n   * Initial state of the container.\n   *\n   * > Used to initialize the StateManager.\n   */\n  protected init: Partial<State>;\n\n  /**\n   * During the instantiation process, we keep a list of pending instantiations.\n   * > It allows us to detect circular dependencies.\n   */\n  protected pendingInstantiations: Service[] = [];\n\n  /**\n   * Cache for environment variables.\n   * > It allows us to avoid parsing the same schema multiple times.\n   */\n  protected cacheEnv: Map<TSchema, any> = new Map();\n\n  /**\n   * List of modules that are registered in the container.\n   *\n   * Modules are used to group services and provide a way to register them in the container.\n   */\n  protected modules: Array<Module> = [];\n\n  /**\n   * List of service substitutions.\n   *\n   * Services registered here will be replaced by the specified service when injected.\n   */\n  protected substitutions = new Map<Service, { use: Service }>();\n\n  /**\n   * Registry of primitives.\n   */\n  protected primitiveRegistry = new Map<Service<Primitive>, Array<Primitive>>();\n\n  /**\n   *  List of all services + how they are provided.\n   */\n  protected registry: Map<Service, ServiceDefinition> = new Map();\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Node.js feature that allows to store context across asynchronous calls.\n   *\n   * This is used for logging, tracing, and other context-related features.\n   *\n   * Mocked for browser environments.\n   */\n  public get context(): AlsProvider {\n    return this.inject(AlsProvider);\n  }\n\n  /**\n   * Event manager to handle lifecycle events and custom events.\n   */\n  public get events(): EventManager {\n    return this.inject(EventManager, {\n      args: [() => this.log],\n    });\n  }\n\n  /**\n   * State manager to store arbitrary values.\n   */\n  public get store(): StateManager<State> {\n    this.events; // ensure events is initialized first (TODO: move this to constructor?)\n    return this.inject(StateManager, {\n      args: [this.init],\n    });\n  }\n\n  /**\n   * Codec manager for encoding and decoding data with different formats.\n   *\n   * Supports multiple codec formats (JSON, Protobuf, etc.) with a unified interface.\n   */\n  public get codec(): CodecManager {\n    return this.inject(CodecManager);\n  }\n\n  /**\n   * Get logger instance.\n   */\n  public get log(): LoggerInterface | undefined {\n    return this.store.get(\"alepha.logger\");\n  }\n\n  /**\n   * The environment variables for the App.\n   */\n  public get env(): Readonly<Env> {\n    return this.store.get(\"env\") ?? {};\n  }\n\n  constructor(init: Partial<State> = {}) {\n    this.init = init;\n  }\n\n  /**\n   * True when start() is called.\n   *\n   * -> No more services can be added, it's over, bye!\n   */\n  public isLocked(): boolean {\n    return this.locked;\n  }\n\n  /**\n   * Returns whether the App is configured.\n   *\n   * It means that Alepha#configure() has been called.\n   *\n   * > By default, configure() is called automatically when start() is called, but you can also call it manually.\n   */\n  public isConfigured(): boolean {\n    return this.configured;\n  }\n\n  /**\n   * Returns whether the App has started.\n   *\n   * It means that #start() has been called but maybe not all services are ready.\n   */\n  public isStarted(): boolean {\n    return this.started;\n  }\n\n  /**\n   * True if the App is ready. It means that Alepha is started AND ready() hook has beed called.\n   */\n  public isReady(): boolean {\n    return this.ready;\n  }\n\n  /**\n   * True if the App is running in a Continuous Integration environment.\n   */\n  public isCI(): boolean {\n    if (this.env.GITHUB_ACTIONS) {\n      return true;\n    }\n\n    return !!this.env.CI;\n  }\n\n  /**\n   * True if the App is running in a browser environment.\n   */\n  public isBrowser(): boolean {\n    return typeof window !== \"undefined\"; // pretty cheap check\n  }\n\n  /**\n   * Returns whether the App is running in Vite dev mode.\n   */\n  public isViteDev(): boolean {\n    if (this.isBrowser()) {\n      return false;\n    }\n\n    return !!this.env.VITE_ALEPHA_DEV;\n  }\n\n  public isBun(): boolean {\n    return \"Bun\" in globalThis;\n  }\n\n  /**\n   * Returns whether the App is running in a serverless environment.\n   */\n  public isServerless(): boolean {\n    if (this.isBrowser()) {\n      return false;\n    }\n\n    if (this.env.VERCEL_REGION) {\n      return true;\n    }\n\n    if (this.env.ALEPHA_SERVERLESS) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Returns whether the App is in test mode. (Running in a test environment)\n   *\n   * > This is automatically set when running tests with Jest or Vitest.\n   */\n  public isTest(): boolean {\n    const env = this.env.NODE_ENV;\n    return env === \"test\";\n  }\n\n  /**\n   * Returns whether the App is in production mode. (Running in a production environment)\n   *\n   * > This is automatically set by Vite or Vercel. However, you have to set it manually when running Docker apps.\n   */\n  public isProduction(): boolean {\n    const env = this.env.NODE_ENV;\n    return env === \"production\";\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Starts the App.\n   *\n   * - Lock any further changes to the container.\n   * - Run \"configure\" hook for all services. Primitives will be processed.\n   * - Run \"start\" hook for all services. Providers will connect/listen/...\n   * - Run \"ready\" hook for all services. This is the point where the App is ready to serve requests.\n   *\n   * @return A promise that resolves when the App has started.\n   */\n  public async start(): Promise<this> {\n    if (this.ready) {\n      this.log?.debug(\"App is already started, skipping...\");\n      return this;\n    }\n\n    // make sure that start is called only once\n    if (this.starting) {\n      this.log?.warn(\"App is already starting, waiting for it to finish...\");\n      return this.starting.promise;\n    }\n\n    this.codec; // ensure codec is initialized\n\n    this.starting = Promise.withResolvers();\n\n    const now = Date.now();\n\n    this.log?.info(\"Starting App...\");\n\n    for (const [key] of this.substitutions.entries()) {\n      this.inject(key);\n    }\n\n    const target = this.store.get(\"alepha.target\");\n    if (target) {\n      this.registry = new Map();\n      this.primitiveRegistry = new Map();\n      this.with(target);\n    }\n\n    this.locked = true;\n\n    await this.events.emit(\"configure\", this, { log: true });\n\n    this.configured = true;\n\n    await this.events.emit(\"start\", this, { log: true });\n\n    this.started = true;\n\n    await this.events.emit(\"ready\", this, { log: true });\n\n    this.log?.info(`App is now ready [${Date.now() - now}ms]`);\n\n    this.ready = true;\n\n    this.starting.resolve(this);\n    this.starting = undefined;\n\n    return this;\n  }\n\n  /**\n   * Stops the App.\n   *\n   * - Run \"stop\" hook for all services.\n   *\n   * Stop will NOT reset the container.\n   * Stop will NOT unlock the container.\n   *\n   * > Stop is used to gracefully shut down the application, nothing more. There is no \"restart\".\n   *\n   * @return A promise that resolves when the App has stopped.\n   */\n  public async stop(): Promise<void> {\n    if (!this.started) {\n      return;\n    }\n\n    this.log?.info(\"Stopping App...\");\n    await this.events.emit(\"stop\", this, { reverse: true, log: true });\n    this.log?.info(\"App is now off\");\n\n    this.started = false;\n    this.ready = false;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Check if entry is registered in the container.\n   */\n  public has(\n    entry: ServiceEntry,\n    opts: {\n      /**\n       * Check if the entry is registered in the pending instantiation stack.\n       *\n       * @default true\n       */\n      inStack?: boolean;\n      /**\n       * Check if the entry is registered in the container registry.\n       *\n       * @default true\n       */\n      inRegistry?: boolean;\n      /**\n       * Check if the entry is registered in the substitutions.\n       *\n       * @default true\n       */\n      inSubstitutions?: boolean;\n      /**\n       * Where to look for registered services.\n       *\n       * @default this.registry\n       */\n      registry?: Map<Service, ServiceDefinition>;\n    } = {},\n  ): boolean {\n    if (entry === Alepha) {\n      return true;\n    }\n\n    const {\n      inStack = true,\n      inRegistry = true,\n      inSubstitutions = true,\n      registry = this.registry,\n    } = opts;\n\n    const { provide } =\n      typeof entry === \"object\" && \"provide\" in entry\n        ? entry\n        : { provide: entry };\n\n    if (inSubstitutions) {\n      const substitute = this.substitutions.get(provide);\n      if (substitute) {\n        return true;\n      }\n    }\n\n    if (inRegistry) {\n      const match = registry.get(provide);\n      if (match) {\n        return true;\n      }\n    }\n\n    if (inStack) {\n      const substitute = this.substitutions.get(provide)?.use;\n      if (substitute && this.pendingInstantiations.includes(substitute)) {\n        return true;\n      }\n\n      return this.pendingInstantiations.includes(provide);\n    }\n\n    return false;\n  }\n\n  /**\n   * Registers the specified service in the container.\n   *\n   * - If the service is ALREADY registered, the method does nothing.\n   * - If the service is NOT registered, a new instance is created and registered.\n   *\n   * Method is chainable, so you can register multiple services in a single call.\n   *\n   * > ServiceEntry allows to provide a service **substitution** feature.\n   *\n   * @example\n   * ```ts\n   * class A { value = \"a\"; }\n   * class B { value = \"b\"; }\n   * class M { a = $inject(A); }\n   *\n   * Alepha.create().with({ provide: A, use: B }).get(M).a.value; // \"b\"\n   * ```\n   *\n   * > **Substitution** is an advanced feature that allows you to replace a service with another service.\n   * > It's useful for testing or for providing different implementations of a service.\n   * > If you are interested in configuring a service, use Alepha#configure() instead.\n   *\n   * @param serviceEntry - The service to register in the container.\n   * @return Current instance of Alepha.\n   */\n  public with<T extends object>(\n    serviceEntry: ServiceEntry<T> | { default: ServiceEntry<T> },\n  ): this {\n    const entry: ServiceEntry<T> =\n      \"default\" in serviceEntry ? serviceEntry.default : serviceEntry;\n\n    // just check if the entry is not present in the pending instantiation stack\n    // Alepha#get will handle the rest\n    if (\n      this.has(entry, {\n        inSubstitutions: false,\n        inRegistry: false,\n      })\n    ) {\n      return this;\n    }\n\n    const isSubstitution = typeof entry === \"object\";\n    if (isSubstitution) {\n      if (entry.provide === entry.use) {\n        this.inject(entry.provide);\n        return this;\n      }\n\n      if (!this.substitutions.has(entry.provide) && !this.has(entry.provide)) {\n        if (this.started) {\n          throw new ContainerLockedError();\n        }\n\n        // inherit of module, if service has no module\n        if (\n          MODULE in entry.provide &&\n          typeof entry.provide[MODULE] === \"function\"\n        ) {\n          (entry.use as WithModule)[MODULE] ??= entry.provide[MODULE];\n        }\n\n        this.substitutions.set(entry.provide, {\n          use: entry.use,\n        });\n      } else if (!entry.optional) {\n        throw new TooLateSubstitutionError(entry.provide.name, entry.use.name);\n      }\n\n      return this;\n    }\n\n    this.inject(entry);\n\n    return this;\n  }\n\n  /**\n   * Get an instance of the specified service from the container.\n   *\n   * @see {@link InjectOptions} for the available options.\n   */\n  public inject<T extends object>(\n    service: Service<T> | string,\n    opts: InjectOptions<T> = {},\n  ): T {\n    const lifetime = opts.lifetime ?? \"singleton\";\n    const parent =\n      opts.parent !== undefined ? opts.parent : (__alephaRef?.parent ?? Alepha);\n\n    const transient = lifetime === \"transient\";\n    const registry =\n      lifetime === \"scoped\"\n        ? (this.context.get<Map<Service, ServiceDefinition>>(\"registry\") ??\n          this.registry)\n        : this.registry;\n\n    // If the requested type is the container, the current instance is returned.\n    if ((service as any) === Alepha) {\n      return this as any;\n    }\n\n    if (typeof service === \"string\") {\n      for (const [key, value] of registry.entries()) {\n        if (key.name === service) {\n          return value.instance as T;\n        }\n      }\n      throw new AlephaError(`Service not found: ${service}`);\n    }\n\n    const substitute = this.substitutions.get(service);\n    if (substitute) {\n      return this.inject(substitute.use, {\n        parent,\n        lifetime,\n      });\n    }\n\n    const index = this.pendingInstantiations.indexOf(service);\n    if (index !== -1 && !transient) {\n      throw new CircularDependencyError(\n        service.name,\n        this.pendingInstantiations.slice(0, index).map((it) => it.name),\n      );\n    }\n\n    if (!transient) {\n      // the requested type is searched in the container\n      const match = registry.get(service);\n      if (match) {\n        if (!match.parents.includes(parent) && parent !== service) {\n          match.parents.push(parent);\n        }\n\n        return match.instance;\n      }\n\n      if (this.started) {\n        throw new ContainerLockedError(\n          `Container is locked. No more services can be added. ${parent?.name} -> ${service.name}`,\n        );\n      }\n    }\n\n    const module = (service as WithModule)[MODULE];\n    if (module && typeof module === \"function\") {\n      this.with(module);\n    }\n\n    // check if service has been registered by a module\n    if (this.has(service, { registry }) && !transient) {\n      // if the service is already registered, we just return the instance\n      return this.inject(service, { parent, lifetime });\n    }\n\n    const instance: T = this.new(service, opts.args);\n\n    const definition: ServiceDefinition<T> = {\n      parents: [parent],\n      instance,\n    };\n\n    if (!transient) {\n      registry.set(service, definition);\n    }\n\n    // [feature]: modules - it's just a way to group services together\n    if (instance instanceof Module) {\n      this.modules.push(instance);\n\n      const parent = __alephaRef.parent;\n\n      // propagate the current module\n      __alephaRef.parent = instance.constructor as Service;\n\n      instance.register(this);\n\n      // restore the previous $get context\n      __alephaRef.parent = parent;\n    }\n\n    return instance;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Applies environment variables to the provided schema and state object.\n   *\n   * It replaces also all templated $ENV inside string values.\n   *\n   * @param schema - The schema object to apply environment variables to.\n   * @return The schema object with environment variables applied.\n   */\n  public parseEnv<T extends TObject>(schema: T): Static<T> {\n    if (this.cacheEnv.has(schema)) {\n      return this.cacheEnv.get(schema) as Static<T>;\n    }\n\n    const config = this.codec.validate(schema, this.env) as Record<string, any>;\n\n    for (const key in config) {\n      if (typeof config[key] === \"string\") {\n        for (const env in config) {\n          config[key] = config[key].replace(\n            new RegExp(`\\\\$${env}`, \"gim\"),\n            config[env],\n          );\n        }\n      }\n    }\n\n    this.cacheEnv.set(schema, config);\n\n    return config as Static<T>;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Dump the current dependency graph of the App.\n   *\n   * This method returns a record where the keys are the names of the services.\n   */\n  public graph(): Record<\n    string,\n    { from: string[]; as?: string[]; module?: string }\n  > {\n    for (const [key] of this.substitutions.entries()) {\n      if (!this.has(key)) {\n        this.inject(key);\n      }\n    }\n\n    const graph: Record<\n      string,\n      { from: string[]; as?: string[]; module?: string }\n    > = {};\n\n    for (const [provide, { parents }] of this.registry.entries()) {\n      graph[provide.name] = {\n        from: parents.filter((it) => !!it).map((it) => it.name),\n      };\n\n      const aliases = this.substitutions\n        .entries()\n        .filter((it) => it[1].use === provide)\n        .map((it) => it[0].name)\n        .toArray();\n\n      if (aliases.length) {\n        graph[provide.name].as = aliases;\n      }\n\n      const module = Module.of(provide);\n      if (module) {\n        graph[provide.name].module = module.name;\n      }\n    }\n\n    return graph;\n  }\n\n  public services<T extends object>(base: Service<T>): Array<T> {\n    const list: Array<T> = [];\n    for (const [key, value] of this.registry.entries()) {\n      if (value.instance instanceof base) {\n        list.push(value.instance as T);\n      }\n    }\n    return list;\n  }\n\n  /**\n   * Get all primitives of the specified type.\n   */\n  public primitives<TPrimitive extends Primitive>(\n    factory:\n      | {\n          [KIND]: InstantiableClass<TPrimitive>;\n        }\n      | string,\n  ): Array<TPrimitive> {\n    if (typeof factory === \"string\") {\n      const key1 = factory.toLowerCase().replace(\"$\", \"\");\n      const key2 = `${key1}primitive`;\n      for (const [key, value] of this.primitiveRegistry.entries()) {\n        const name = key.name.toLowerCase();\n        if (name === key1 || name === key2) {\n          return value as Array<TPrimitive>;\n        }\n      }\n      return [];\n    }\n    return (this.primitiveRegistry.get(factory[KIND]) ??\n      []) as Array<TPrimitive>;\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  protected new<T extends object>(service: Service<T>, args: any[] = []): T {\n    // we keep a tree of dependencies to detect circular dependencies\n    // it's also useful for cleaning are global cursor\n    this.pendingInstantiations.push(service);\n\n    //\n    // we use a global cursor to store the current context and definition\n    // as new() is synchronous, there is no worry to do that\n    //\n    __alephaRef.alepha = this;\n    __alephaRef.service = service;\n\n    const instance: T = isClass(service)\n      ? new service(...args)\n      : (((service as RunFunction)(...args) ?? {}) as T);\n\n    const obj = instance as unknown as Record<string, any>;\n    for (const [key, value] of Object.entries(obj)) {\n      if (value instanceof Primitive) {\n        this.processPrimitive(value, key);\n      }\n      if (\n        typeof value === \"object\" &&\n        value !== null &&\n        typeof value[OPTIONS] === \"object\" &&\n        \"getter\" in value[OPTIONS]\n      ) {\n        const getter = value[OPTIONS].getter as keyof State;\n        Object.defineProperty(obj, key, {\n          get: () => this.store.get(getter),\n        });\n      }\n    }\n\n    this.pendingInstantiations.pop();\n\n    // tree is empty, now we can clean the global cursor\n    if (this.pendingInstantiations.length === 0) {\n      __alephaRef.alepha = undefined;\n    }\n\n    __alephaRef.service =\n      this.pendingInstantiations[this.pendingInstantiations.length - 1];\n\n    return instance;\n  }\n\n  protected processPrimitive(value: Primitive, propertyKey = \"\") {\n    value.config.propertyKey = propertyKey;\n    (value as any).onInit();\n\n    const kind = value.constructor as Service;\n    const list = this.primitiveRegistry.get(kind) ?? [];\n    this.primitiveRegistry.set(kind, [...list, value]);\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Hook<T extends keyof Hooks = any> {\n  caller?: Service;\n  priority?: \"first\" | \"last\";\n  callback: (payload: Hooks[T]) => Async<void>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * This is how we store services in the Alepha container.\n */\ninterface ServiceDefinition<T extends object = any> {\n  /**\n   * The instance of the class or type definition.\n   * Mostly used for caching / singleton but can be used for other purposes like forcing the instance.\n   */\n  instance: T;\n\n  /**\n   * List of classes which use this class.\n   */\n  parents: Array<Service | null>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Env {\n  [key: string]: string | boolean | number | undefined;\n\n  /**\n   * Optional environment variable that indicates the current environment.\n   */\n  NODE_ENV?: \"dev\" | \"test\" | \"production\";\n\n  /**\n   * Optional name of the application.\n   */\n  APP_NAME?: string;\n\n  /**\n   * Optional root module name.\n   */\n  MODULE_NAME?: string;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface State {\n  /**\n   * Environment variables for the application.\n   */\n  env?: Readonly<Env>;\n\n  /**\n   * Logger instance to be used by the Alepha container.\n   *\n   * @internal\n   */\n  \"alepha.logger\"?: LoggerInterface;\n\n  /**\n   * If defined, the Alepha container will only register this service and its dependencies.\n   */\n  \"alepha.target\"?: Service;\n\n  // test hooks\n\n  /**\n   * Bind to Vitest 'beforeAll' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'beforeAll' is available.\n   */\n  \"alepha.test.beforeAll\"?: (run: any) => any;\n\n  /**\n   * Bind to Vitest 'afterAll' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'afterAll' is available.\n   */\n  \"alepha.test.afterAll\"?: (run: any) => any;\n\n  /**\n   * Bind to Vitest 'afterEach' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'afterEach' is available.\n   */\n  \"alepha.test.afterEach\"?: (run: any) => any;\n\n  /**\n   * Bind to Vitest 'onTestFinished' hook.\n   * Used for testing purposes.\n   * This is automatically attached if Alepha#create() detects a test environment and global 'onTestFinished' is available.\n   */\n  \"alepha.test.onTestFinished\"?: (run: any) => any;\n\n  /**\n   * List of static assets to be copied to the output directory during the build process.\n   *\n   * Used for Alepha-based applications that require static assets.\n   *\n   * See alepha/vite for more details.\n   */\n  \"alepha.build.assets\"?: Array<string>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Hooks {\n  /**\n   * Used for testing purposes.\n   */\n  echo: unknown;\n\n  /**\n   * Triggered during the configuration phase. Before the start phase.\n   */\n  configure: Alepha;\n\n  /**\n   * Triggered during the start phase. When `Alepha#start()` is called.\n   */\n  start: Alepha;\n\n  /**\n   * Triggered during the ready phase. After the start phase.\n   */\n  ready: Alepha;\n\n  /**\n   * Triggered during the stop phase.\n   *\n   * - Stop should be called after a SIGINT or SIGTERM signal in order to gracefully shutdown the application. (@see `run()` method)\n   *\n   */\n  stop: Alepha;\n\n  /**\n   * Triggered when a state value is mutated.\n   */\n  \"state:mutate\": {\n    /**\n     * The key of the state that was mutated.\n     */\n    key: keyof State;\n\n    /**\n     * The new value of the state.\n     */\n    value: any;\n\n    /**\n     * The previous value of the state.\n     */\n    prevValue: any;\n  };\n}\n","import { AlephaError } from \"./AlephaError.ts\";\n\nexport class AppNotStartedError extends AlephaError {\n  readonly name = \"AppNotStartedError\";\n\n  constructor() {\n    super(\"App not started. Please start the app before.\");\n  }\n}\n","import type { Page } from \"../schemas/pageSchema.ts\";\n\n/**\n * Create a pagination object from an array of entities.\n *\n * This is a pure function that works with any data source (databases, APIs, caches, arrays, etc.).\n * It handles the core pagination logic including:\n * - Slicing the content to the requested page size\n * - Calculating pagination metadata (offset, page number, etc.)\n * - Determining navigation state (isFirst, isLast)\n * - Including sort metadata when provided\n *\n * @param entities - The entities to paginate (should include one extra item to detect if there's a next page)\n * @param limit - The limit of the pagination (page size)\n * @param offset - The offset of the pagination (starting position)\n * @param sort - Optional sort metadata to include in response\n * @returns A complete Page object with content and metadata\n *\n * @example Basic pagination\n * ```ts\n * const users = await fetchUsers({ limit: 11, offset: 0 }); // Fetch limit + 1\n * const page = createPagination(users, 10, 0);\n * // page.content has max 10 items\n * // page.page.isLast tells us if there are more pages\n * ```\n *\n * @example With sorting\n * ```ts\n * const page = createPagination(\n *   entities,\n *   10,\n *   0,\n *   [{ column: \"name\", direction: \"asc\" }]\n * );\n * ```\n *\n * @example In a custom service\n * ```ts\n * class MyService {\n *   async listItems(page: number, size: number) {\n *     const items = await this.fetchItems({ limit: size + 1, offset: page * size });\n *     return createPagination(items, size, page * size);\n *   }\n * }\n * ```\n */\nexport function createPagination<T>(\n  entities: T[],\n  limit = 10,\n  offset = 0,\n  sort?: Array<{ column: string; direction: \"asc\" | \"desc\" }>,\n): Page<T> {\n  const content = entities.slice(0, limit);\n  const hasNext = entities.length === limit + 1;\n  const pageNumber = Math.floor(offset / limit);\n\n  return {\n    content,\n    page: {\n      number: pageNumber,\n      size: limit,\n      offset,\n      numberOfElements: content.length,\n      isEmpty: content.length === 0,\n      isFirst: pageNumber === 0,\n      isLast: !hasNext,\n      ...(sort && sort.length > 0\n        ? {\n            sort: {\n              sorted: true,\n              fields: sort.map((s) => ({\n                field: s.column,\n                direction: s.direction,\n              })),\n            },\n          }\n        : {}),\n    },\n  };\n}\n","import type { Readable } from \"node:stream\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport type { TSchema, TUnsafe } from \"typebox\";\n\nexport interface FileLike {\n  /**\n   * Filename.\n   * @default \"file\"\n   */\n  name: string;\n\n  /**\n   * Mandatory MIME type of the file.\n   * @default \"application/octet-stream\"\n   */\n  type: string;\n\n  /**\n   * Size of the file in bytes.\n   *\n   * Always 0 for streams, as the size is not known until the stream is fully read.\n   *\n   * @default 0\n   */\n  size: number;\n\n  /**\n   * Last modified timestamp in milliseconds since epoch.\n   *\n   * Always the current timestamp for streams, as the last modified time is not known.\n   * We use this field to ensure compatibility with File API.\n   *\n   * @default Date.now()\n   */\n  lastModified: number;\n\n  /**\n   * Returns a ReadableStream or Node.js Readable stream of the file content.\n   *\n   * For streams, this is the original stream.\n   */\n  stream(): StreamLike;\n\n  /**\n   * Returns the file content as an ArrayBuffer.\n   *\n   * For streams, this reads the entire stream into memory.\n   */\n  arrayBuffer(): Promise<ArrayBuffer>;\n\n  /**\n   * Returns the file content as a string.\n   *\n   * For streams, this reads the entire stream into memory and converts it to a string.\n   */\n  text(): Promise<string>;\n\n  // -- node specific fields --\n\n  /**\n   * Optional file path, if the file is stored on disk.\n   *\n   * This is not from the File API, but rather a custom field to indicate where the file is stored.\n   */\n  filepath?: string;\n}\n\n/**\n * TypeBox view of FileLike.\n */\nexport type TFile = TUnsafe<FileLike>;\n\nexport const isTypeFile = (value: TSchema): value is TFile => {\n  return (\n    value &&\n    typeof value === \"object\" &&\n    \"format\" in value &&\n    value.format === \"binary\"\n  );\n};\n\nexport const isFileLike = (value: any): value is FileLike => {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    typeof value.name === \"string\" &&\n    typeof value.type === \"string\" &&\n    typeof value.size === \"number\" &&\n    typeof value.stream.bind(value) === \"function\"\n  );\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n// TODO: remove it, replace with WebStream\nexport type StreamLike =\n  | ReadableStream\n  | WebReadableStream\n  | Readable\n  | NodeJS.ReadableStream;\n\nexport type TStream = TUnsafe<StreamLike>;\n","import type {\n  TAny,\n  TArray,\n  TArrayOptions,\n  TBoolean,\n  TInteger,\n  TInterface,\n  TKeysToIndexer,\n  TNull,\n  TNumber,\n  TNumberOptions,\n  TObject,\n  TObjectOptions,\n  TOmit,\n  TOptionalAdd,\n  TPartial,\n  TPick,\n  TProperties,\n  TRecord,\n  TSchema,\n  TSchemaOptions,\n  TString,\n  TStringOptions,\n  TUnion,\n  TUnsafe,\n} from \"typebox\";\nimport * as TypeBox from \"typebox\";\nimport { Type } from \"typebox\";\nimport type {\n  TLocalizedValidationError,\n  TLocalizedValidationMessageCallback,\n} from \"typebox/error\";\nimport TypeBoxFormat from \"typebox/format\";\nimport { Locale } from \"typebox/system\";\nimport * as TypeBoxValue from \"typebox/value\";\nimport { OPTIONS } from \"../constants/OPTIONS.ts\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport type { TypeBoxError } from \"../errors/TypeBoxError.ts\";\nimport { isTypeFile, type TFile, type TStream } from \"../helpers/FileLike.ts\";\n\nexport { TypeBox, TypeBoxValue, TypeBoxFormat };\n\nexport const isUUID = TypeBoxFormat.IsUuid;\nexport const isEmail = TypeBoxFormat.IsEmail;\nexport const isURL = TypeBoxFormat.IsUrl;\nexport const isDateTime = TypeBoxFormat.IsDateTime;\nexport const isDate = TypeBoxFormat.IsDate;\nexport const isTime = TypeBoxFormat.IsTime;\nexport const isDuration = TypeBoxFormat.IsDuration;\n\nexport type {\n  StaticDecode,\n  StaticDecode as Static,\n  StaticEncode,\n  TAny,\n  TArray,\n  TBigInt,\n  TBoolean,\n  TInteger,\n  TKeysToIndexer,\n  TNull,\n  TNumber,\n  TNumberOptions,\n  TObject,\n  TObjectOptions,\n  TOptional,\n  TOptionalAdd,\n  TPick,\n  TProperties,\n  TRecord,\n  TSchema,\n  TString,\n  TStringOptions,\n  TTuple,\n  TUnion,\n  TUnsafe,\n  TVoid,\n} from \"typebox\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class TypeGuard {\n  // -------------------------------------------------------------------------------------------------------------------\n  isBigInt = (value: TSchema): value is TString =>\n    TypeBox.IsString(value) && \"format\" in value && value.format === \"bigint\";\n  isUUID = (value: TSchema): value is TString =>\n    TypeBox.IsString(value) && \"format\" in value && value.format === \"uuid\";\n  isObject = TypeBox.IsObject;\n  isNumber = TypeBox.IsNumber;\n  isString = TypeBox.IsString;\n  isBoolean = TypeBox.IsBoolean;\n  isAny = TypeBox.IsAny;\n  isArray = TypeBox.IsArray;\n  isOptional = TypeBox.IsOptional;\n  isUnion = TypeBox.IsUnion;\n  isInteger = TypeBox.IsInteger;\n  isNull = TypeBox.IsNull;\n  isUndefined = TypeBox.IsUndefined;\n  isUnsafe = TypeBox.IsUnsafe;\n  isRecord = TypeBox.IsRecord;\n  isTuple = TypeBox.IsTuple;\n  isVoid = TypeBox.IsVoid;\n  isLiteral = TypeBox.IsLiteral;\n  isSchema = TypeBox.IsSchema;\n  // -------------------------------------------------------------------------------------------------------------------\n  isFile = isTypeFile;\n  isDateTime = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"date-time\";\n  };\n  isDate = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"date\";\n  };\n  isTime = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"time\";\n  };\n  isDuration = (schema: unknown) => {\n    return t.schema.isString(schema) && schema.format === \"duration\";\n  };\n}\n\ndeclare module \"typebox\" {\n  interface TString {\n    format?: string;\n    minLength?: number;\n    maxLength?: number;\n  }\n\n  interface TNumber {\n    format?: \"int64\";\n  }\n}\n\nexport class TypeProvider {\n  static format = TypeBoxFormat;\n\n  static {\n    TypeBoxFormat.Set(\"bigint\", (value: string | number) =>\n      TypeProvider.isValidBigInt(value),\n    );\n  }\n\n  static translateError(error: TypeBoxError, locale?: string): string {\n    if (!locale) {\n      return error.cause.message;\n    }\n\n    for (const [key, value] of Object.entries(Locale)) {\n      if (key === \"Set\" || key === \"Get\" || key === \"Reset\") continue;\n      if (key === locale || key.startsWith(`${locale}_`)) {\n        return (value as (error: TLocalizedValidationError) => string)(\n          error.cause,\n        );\n      }\n    }\n    return error.cause.message;\n  }\n\n  static setLocale(locale: string) {\n    for (const [key, value] of Object.entries(Locale)) {\n      if (key === \"Set\" || key === \"Get\" || key === \"Reset\") continue;\n      if (key === locale || key.startsWith(`${locale}_`)) {\n        Locale.Set(value as TLocalizedValidationMessageCallback);\n        return;\n      }\n    }\n    throw new AlephaError(`Locale not found: ${locale}`);\n  }\n\n  static isValidBigInt(value: string | number) {\n    if (typeof value === \"number\") {\n      return Number.isInteger(value);\n    }\n\n    // Reject empty or whitespace-only strings\n    if (!value.trim()) return false;\n    // Regex: optional minus, then digits only\n    if (!/^-?\\d+$/.test(value)) return false;\n\n    try {\n      BigInt(value); // Will throw if invalid\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Default maximum length for strings.\n   *\n   * It can be set to a larger value:\n   * ```ts\n   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = 1000000;\n   * TypeProvider.DEFAULT_STRING_MAX_LENGTH = undefined; // no limit (not recommended)\n   * ```\n   */\n  static DEFAULT_STRING_MAX_LENGTH: number | undefined = 255;\n\n  /**\n   * Maximum length for short strings, such as names or titles.\n   */\n  static DEFAULT_SHORT_STRING_MAX_LENGTH: number | undefined = 64;\n\n  /**\n   * Maximum length for long strings, such as descriptions or comments.\n   * It can be overridden in the string options.\n   *\n   * It can be set to a larger value:\n   * ```ts\n   * TypeProvider.DEFAULT_LONG_STRING_MAX_LENGTH = 2048;\n   * ```\n   */\n  static DEFAULT_LONG_STRING_MAX_LENGTH: number | undefined = 1024;\n\n  /**\n   * Maximum length for rich strings, such as HTML or Markdown.\n   * This is a large value to accommodate rich text content.\n   * > It's also the maximum length of PG's TEXT type.\n   *\n   * It can be overridden in the string options.\n   *\n   * It can be set to a larger value:\n   * ```ts\n   * TypeProvider.DEFAULT_RICH_STRING_MAX_LENGTH = 1000000;\n   * ```\n   */\n  static DEFAULT_RICH_STRING_MAX_LENGTH: number | undefined = 65535;\n\n  /**\n   * Maximum number of items in an array.\n   * This is a default value to prevent excessive memory usage.\n   * It can be overridden in the array options.\n   */\n  static DEFAULT_ARRAY_MAX_ITEMS = 1000;\n\n  // -------------------------------------------------------------------------------------------------------------------\n  public raw = Type; // typebox reference\n  public any = Type.Any;\n  public void = Type.Void;\n  public undefined = Type.Undefined;\n  public record = Type.Record;\n  public union = Type.Union;\n  public tuple = Type.Tuple;\n  public null = Type.Null;\n  public const = Type.Literal;\n  public options = Type.Options;\n  // -------------------------------------------------------------------------------------------------------------------\n\n  /**\n   * Type guards to check the type of schema.\n   * This is not a runtime type check, but a compile-time type guard.\n   *\n   * @example\n   * ```ts\n   * if (t.schema.isString(schema)) {\n   *   // schema is TString\n   * }\n   * ```\n   */\n  public readonly schema = new TypeGuard();\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  public extend<T extends TSchema[], U extends TProperties>(\n    schema: [...T],\n    properties: U,\n    options?: TSchemaOptions,\n  ): TInterface<T, U>;\n  public extend<T extends TObject, U extends TProperties>(\n    schema: T,\n    properties: U,\n    options?: TSchemaOptions,\n  ): TInterface<[T], U>;\n  public extend(\n    schema: TSchema | TSchema[],\n    properties: Record<string, any>,\n    options?: TSchemaOptions,\n  ): any {\n    return Type.Interface(\n      Array.isArray(schema) ? schema : [schema],\n      properties,\n      {\n        additionalProperties: false,\n        ...options,\n      },\n    );\n  }\n\n  public pick<T extends TObject, Indexer extends PropertyKey[]>(\n    schema: T,\n    keys: [...Indexer],\n    options?: TObjectOptions,\n  ): TPick<T, TKeysToIndexer<Indexer>> {\n    return Type.Pick(schema, keys, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  public omit<T extends TObject, Indexer extends PropertyKey[]>(\n    schema: T,\n    keys: [...Indexer],\n    options?: TObjectOptions,\n  ): TOmit<T, TKeysToIndexer<Indexer>> {\n    return Type.Omit(schema, keys, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  public partial<T extends TSchema>(\n    schema: T,\n    options?: TSchemaOptions,\n  ): TPartial<T> {\n    return Type.Partial(schema, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for an object.\n   * By default, additional properties are not allowed.\n   *\n   * @example\n   * ```ts\n   * const userSchema = t.object({\n   *   id: t.integer(),\n   *   name: t.string(),\n   * });\n   * ```\n   */\n  public object<T extends TProperties>(\n    properties: T,\n    options?: TObjectOptions,\n  ): TObject<T> {\n    return Type.Object(properties, {\n      additionalProperties: false,\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for an array.\n   * By default, the maximum number of items is limited to prevent excessive memory usage.\n   *\n   * @see TypeProvider.DEFAULT_ARRAY_MAX_ITEMS\n   */\n  public array<T extends TSchema>(\n    schema: T,\n    options?: TArrayOptions,\n  ): TArray<T> {\n    return Type.Array(schema, {\n      maxItems: TypeProvider.DEFAULT_ARRAY_MAX_ITEMS,\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a string.\n   * For db or input fields, consider using `t.text()` instead, which has length limits.\n   *\n   * If you need a string with specific format (e.g. email, uuid), consider using the corresponding method (e.g. `t.email()`, `t.uuid()`).\n   */\n  public string(options: TStringOptions = {}): TString {\n    return Type.String({\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a string with length limits.\n   * For internal strings without length limits, consider using `t.string()` instead.\n   *\n   * Default size is \"regular\", which has a max length of 255 characters.\n   */\n  public text(options: TTextOptions = {}): TString {\n    const { size, ...rest } = options;\n    const maxLength =\n      size === \"short\"\n        ? TypeProvider.DEFAULT_SHORT_STRING_MAX_LENGTH\n        : size === \"long\"\n          ? TypeProvider.DEFAULT_LONG_STRING_MAX_LENGTH\n          : size === \"rich\"\n            ? TypeProvider.DEFAULT_RICH_STRING_MAX_LENGTH\n            : TypeProvider.DEFAULT_STRING_MAX_LENGTH;\n\n    return Type.String({\n      maxLength,\n      \"~options\": {\n        trim: options.trim ?? true,\n        lowercase: options.lowercase ?? false,\n      },\n      ...rest,\n    });\n  }\n\n  /**\n   * Create a schema for a JSON object.\n   * This is a record with string keys and any values.\n   */\n  public json(options?: TSchemaOptions): TRecord<string, TAny> {\n    return t.record(t.text(), t.any(), options);\n  }\n\n  /**\n   * Create a schema for a boolean.\n   */\n  public boolean(options?: TSchemaOptions): TBoolean {\n    return Type.Boolean({\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a number.\n   */\n  public number(options?: TNumberOptions): TNumber {\n    return Type.Number({\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for an integer.\n   */\n  public integer(options?: TNumberOptions): TInteger {\n    return Type.Integer({\n      ...options,\n    });\n  }\n\n  public int32(options?: TNumberOptions): TInteger {\n    return Type.Integer({\n      minimum: -2147483647,\n      maximum: 2147483647,\n      ...options,\n    });\n  }\n\n  /**\n   * Mimic a signed 64-bit integer.\n   *\n   * This is NOT a true int64, as JavaScript cannot represent all int64 values.\n   * It is a number that is an integer and between -9007199254740991 and 9007199254740991.\n   * Use `t.bigint()` for true int64 values represented as strings.\n   */\n  public int64(options?: TNumberOptions): TNumber {\n    return Type.Number({\n      format: \"int64\",\n      multipleOf: 1,\n      minimum: -9007199254740991,\n      maximum: 9007199254740991,\n      ...options,\n    });\n  }\n\n  /**\n   * Make a schema optional.\n   */\n  public optional<T extends TSchema>(schema: T): TOptionalAdd<T> {\n    return Type.Optional(schema);\n  }\n\n  /**\n   * Make a schema nullable.\n   */\n  public nullable<T extends TSchema>(\n    schema: T,\n    options?: TObjectOptions,\n  ): TUnion<[TNull, T]> {\n    return Type.Union([Type.Null(), schema], options);\n  }\n\n  /**\n   * Create a schema that maps all properties of an object schema to nullable.\n   */\n  public nullify = <T extends TSchema>(schema: T, options?: TObjectOptions) =>\n    Type.Mapped(\n      Type.Identifier(\"K\"),\n      Type.KeyOf(schema),\n      Type.Ref(\"K\"),\n      Type.Union([Type.Index(schema, Type.Ref(\"K\")), Type.Null()]),\n      options,\n    );\n\n  /**\n   * Create a schema for a string enum.\n   */\n  public enum<T extends string[]>(\n    values: [...T],\n    options?: TTextOptions,\n  ): TUnsafe<T[number]> {\n    return Type.Unsafe<T[number]>(\n      t.text({\n        enum: values,\n        pattern: values.map((v) => `^${v}$`).join(\"|\"),\n        ...options,\n      }),\n    );\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  // Codec types\n\n  /**\n   * Create a schema for a bigint represented as a string.\n   * This is a string that validates bigint format (e.g. \"123456789\").\n   */\n  public bigint(options?: TStringOptions) {\n    return t.string({\n      ...options,\n      format: \"bigint\",\n    });\n  }\n\n  /**\n   * Create a schema for a URL represented as a string.\n   */\n  public url(options?: TStringOptions) {\n    return this.string({\n      ...options,\n      format: \"url\",\n    });\n  }\n\n  /**\n   * Create a schema for binary data represented as a base64 string.\n   */\n  public binary(options: TStringOptions) {\n    return this.string({\n      ...options,\n      format: \"binary\",\n    });\n  }\n\n  /**\n   * Create a schema for uuid.\n   */\n  public uuid(options?: TStringOptions): TString {\n    return this.string({\n      ...options,\n      format: \"uuid\",\n    });\n  }\n\n  /**\n   * Create a schema for a file-like object.\n   *\n   * File like mimics the File API in browsers, but is adapted to work in Node.js as well.\n   *\n   * Implementation of file-like objects is handled by \"alepha/file\" package.\n   */\n  public file(options?: { maxSize?: number }): TFile {\n    return Type.Unsafe(\n      Type.Any({\n        [OPTIONS]: options,\n        format: \"binary\",\n      }),\n    );\n  }\n\n  /**\n   * @experimental\n   */\n  public stream(): TStream {\n    return Type.Unsafe(\n      Type.Any({\n        format: \"stream\",\n        type: \"string\",\n      }),\n    );\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n  // Exotic types\n\n  public email(options?: TStringOptions): TString {\n    return this.text({\n      ...options,\n      format: \"email\",\n      trim: true,\n      lowercase: true,\n    });\n  }\n\n  public e164(options?: TStringOptions): TString {\n    return this.text({\n      ...options,\n      description: \"Phone number in E.164 format, e.g. +1234567890.\",\n      pattern: \"^\\\\+[1-9]\\\\d{1,14}$\",\n    });\n  }\n\n  public bcp47(options?: TStringOptions): TString {\n    return this.text({\n      ...options,\n      description: \"BCP 47 language tag, e.g. en, en-US, fr, fr-CA.\",\n      pattern: \"^[a-z]{2,3}(?:-[A-Z]{2})?$\",\n    });\n  }\n\n  /**\n   * Create a schema for short text, such as names or titles.\n   * Default max length is 64 characters.\n   */\n  public shortText(options?: TStringOptions): TString {\n    return this.text({\n      size: \"short\",\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for long text, such as descriptions or comments.\n   * Default max length is 1024 characters.\n   */\n  public longText(options?: TStringOptions): TString {\n    return this.text({\n      size: \"long\",\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for rich text, such as HTML or Markdown.\n   * Default max length is 65535 characters.\n   */\n  public richText(options?: TStringOptions): TString {\n    return this.text({\n      size: \"rich\",\n      ...options,\n    });\n  }\n\n  /**\n   * Create a schema for a string enum e.g. LIKE_THIS.\n   */\n  public snakeCase = (options?: TStringOptions) =>\n    this.text({\n      pattern: \"^[A-Z_-]+$\",\n      ...options,\n    });\n\n  /**\n   * Create a schema for an object with a value and label.\n   */\n  public valueLabel = (options?: TObjectOptions) =>\n    this.object(\n      {\n        value: this.snakeCase({\n          description: \"Machine-readable value.\",\n        }),\n        label: this.text({\n          description: \"Human-readable label.\",\n        }),\n        description: this.optional(\n          this.text({\n            description: \"Description of the value.\",\n            size: \"long\",\n          }),\n        ),\n      },\n      options,\n    );\n\n  public datetime = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"date-time\",\n    });\n\n  public date = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"date\",\n    });\n\n  public time = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"time\",\n    });\n\n  public duration = (options?: TStringOptions) =>\n    t.text({\n      ...options,\n      format: \"duration\",\n    });\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type TextLength = \"short\" | \"regular\" | \"long\" | \"rich\";\n\nexport interface TTextOptions extends TStringOptions {\n  /**\n   * Predefined size of the text.\n   *\n   * - `short` - short text, such as names or titles. Default max length is 64 characters.\n   * - `regular` - regular text, such as single-line input. Default max length is 255 characters.\n   * - `long` - long text, such as descriptions or comments. Default max length is 1024 characters.\n   * - `rich` - rich text, such as HTML or Markdown. Default max length is 65535 characters.\n   *\n   * You can override the default max length by specifying `maxLength` in the options.\n   *\n   * @default \"regular\"\n   */\n  size?: TextLength;\n\n  /**\n   * Trim whitespace from both ends of the string.\n   *\n   * @default true\n   */\n  trim?: boolean;\n\n  /**\n   * Convert the string to lowercase.\n   *\n   * @default false\n   */\n  lowercase?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const t: TypeProvider = new TypeProvider();\n","import type { Static, TObject } from \"typebox\";\nimport { AlephaError } from \"../errors/AlephaError.ts\";\nimport { t } from \"../providers/TypeProvider.ts\";\nimport { $context } from \"./$context.ts\";\n\n/**\n * Get typed values from environment variables.\n *\n * @example\n * ```ts\n * const alepha = Alepha.create({\n *   env: {\n *     // Alepha.create() will also use process.env when running on Node.js\n *     HELLO: \"world\",\n *   }\n * });\n *\n * class App {\n *   log = $logger();\n *\n *   // program expect a var env \"HELLO\" as string to works\n *   env = $env(t.object({\n *     HELLO: t.text()\n *   }));\n *\n *   sayHello = () => this.log.info(\"Hello ${this.env.HELLO}\")\n * }\n *\n * run(alepha.with(App));\n * ```\n */\nexport const $env = <T extends TObject>(type: T): Static<T> => {\n  const { alepha } = $context();\n\n  // allow to inject TypeBox schemas\n  if (!t.schema.isObject(type)) {\n    throw new AlephaError(\"Type must be an TObject\");\n  }\n\n  return alepha.parseEnv(type) as Static<T>;\n};\n","import type { Hooks } from \"../Alepha.ts\";\nimport { KIND } from \"../constants/KIND.ts\";\nimport { createPrimitive, Primitive } from \"../helpers/primitive.ts\";\nimport type { Async } from \"../interfaces/Async.ts\";\n\n/**\n * Registers a new hook.\n *\n * ```ts\n * import { $hook } from \"alepha\";\n *\n * class MyProvider {\n *   onStart = $hook({\n *     name: \"start\", // or \"configure\", \"ready\", \"stop\", ...\n *     handler: async (app) => {\n *       // await db.connect(); ...\n *     }\n *   });\n * }\n * ```\n *\n * Hooks are used to run async functions from all registered providers/services.\n *\n * You can't register a hook after the App has started.\n *\n * It's used under the hood by the `configure`, `start`, and `stop` methods.\n * Some modules also use hooks to run their own logic. (e.g. `alepha/server`).\n *\n * You can create your own hooks by using module augmentation:\n *\n * ```ts\n * declare module \"alepha\" {\n *\n *   interface Hooks {\n *     \"my:custom:hook\": {\n *       arg1: string;\n *     }\n *   }\n * }\n *\n * await alepha.events.emit(\"my:custom:hook\", { arg1: \"value\" });\n * ```\n *\n */\nexport const $hook = <T extends keyof Hooks>(options: HookOptions<T>) =>\n  createPrimitive(HookPrimitive<T>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface HookOptions<T extends keyof Hooks> {\n  /**\n   * The name of the hook. \"configure\", \"start\", \"ready\", \"stop\", ...\n   */\n  on: T;\n\n  /**\n   * The handler to run when the hook is triggered.\n   */\n  handler: (args: Hooks[T]) => Async<any>;\n\n  /**\n   * Force the hook to run first or last on the list of hooks.\n   */\n  priority?: \"first\" | \"last\";\n\n  /**\n   * Empty placeholder, not implemented yet. :-)\n   */\n  before?: object | Array<object>;\n\n  /**\n   * Empty placeholder, not implemented yet. :-)\n   */\n  after?: object | Array<object>;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HookPrimitive<T extends keyof Hooks> extends Primitive<\n  HookOptions<T>\n> {\n  public called = 0;\n\n  protected onInit() {\n    this.alepha.events.on(this.options.on, {\n      caller: this.config.service,\n      priority: this.options.priority,\n      callback: async (args: any) => {\n        this.called += 1;\n        await this.options.handler(args);\n      },\n    });\n  }\n}\n\n$hook[KIND] = HookPrimitive;\n","import type { State } from \"../Alepha.ts\";\nimport { OPTIONS } from \"../constants/OPTIONS.ts\";\nimport type { Static, TObject } from \"../providers/TypeProvider.ts\";\nimport type { Atom } from \"./$atom.ts\";\nimport { $context } from \"./$context.ts\";\n\n/**\n * Subscribes to an atom's state and returns its current value for use in components.\n *\n * Creates a reactive connection between an atom and a component, automatically registering\n * the atom in the application state if not already registered. The returned value is reactive\n * and will update when the atom's state changes.\n *\n * **Use Cases**: Accessing global state, sharing data between components, reactive UI updates\n *\n * @example\n * ```ts\n * const userState = $atom({ schema: t.object({ name: t.text(), role: t.text() }) });\n *\n * class UserComponent {\n *   user = $use(userState); // Reactive reference to atom state\n *\n *   render() {\n *     return <div>Hello {this.user.name}!</div>;\n *   }\n * }\n * ```\n */\nexport const $use = <T extends TObject, N extends string>(\n  atom: Atom<T, N>,\n): Readonly<Static<T>> => {\n  const { alepha } = $context();\n\n  // register atom in state if not already registered\n  alepha.store.register(atom);\n\n  const init = alepha.store.get(atom.key as keyof State) as object;\n\n  return {\n    [OPTIONS]: { getter: atom.key }, // alepha will replace this with by a real 'get prop()'\n    ...init,\n  } as Static<T>;\n};\n","import { type Static, t } from \"../providers/TypeProvider.ts\";\n\nexport const pageQuerySchema = t.object({\n  page: t.optional(\n    t.integer({\n      description: \"The page number to retrieve.\",\n      minimum: 0,\n      default: 0,\n    }),\n  ),\n  size: t.optional(\n    t.integer({\n      description: \"The number of items per page.\",\n      minimum: 1,\n      maximum: 100,\n      default: 10,\n    }),\n  ),\n  sort: t.optional(\n    t.text({\n      description:\n        \"Sort by field(s). Multiple columns separated by comma. Prefix with '-' for DESC. Examples: 'name' (ASC), '-createdAt' (DESC), 'role,-name' (role ASC, name DESC)\",\n    }),\n  ),\n});\n\nexport type PageQuery = Static<typeof pageQuerySchema>;\n","import {\n  type Static,\n  type TArray,\n  type TObject,\n  type TObjectOptions,\n  type TRecord,\n  TypeProvider,\n  t,\n} from \"../providers/TypeProvider.ts\";\n\nexport const pageMetadataSchema = t.object({\n  number: t.integer({ description: \"Page number, starting from 0\" }),\n  size: t.integer({\n    description: \"Number of items per page (requested page size)\",\n  }),\n  offset: t.integer({\n    description: \"Offset in the dataset (page × size)\",\n  }),\n  numberOfElements: t.integer({\n    description:\n      \"Number of elements in THIS page (content.length). Different from totalElements which is the total across all pages.\",\n  }),\n  totalElements: t.optional(\n    t.integer({\n      description:\n        \"Total number of elements across all pages. Only available when counting is enabled.\",\n    }),\n  ),\n  totalPages: t.optional(\n    t.integer({\n      description:\n        \"Total number of pages. Only available when `totalElements` is present.\",\n    }),\n  ),\n  isEmpty: t.boolean({\n    description:\n      \"Indicates if the current page has no items (numberOfElements === 0)\",\n  }),\n  isFirst: t.boolean({\n    description: \"Indicates if this is the first page (number === 0)\",\n  }),\n  isLast: t.boolean({\n    description:\n      \"Indicates if this is the last page (no more pages after this)\",\n  }),\n  sort: t.optional(\n    t.object({\n      sorted: t.boolean({\n        description: \"Whether the results are sorted\",\n      }),\n      fields: t.array(\n        t.object({\n          field: t.text({\n            description: \"The field used for sorting\",\n          }),\n          direction: t.enum([\"asc\", \"desc\"], {\n            description: \"The direction of the sort. Either 'asc' or 'desc'\",\n          }),\n        }),\n      ),\n    }),\n  ),\n});\n\n/**\n * Create a pagination schema for the given object schema.\n *\n * Provides a standardized pagination response format compatible with Spring Data's Page interface.\n * This schema can be used across any data source (databases, APIs, caches, etc.).\n *\n * @example\n * ```ts\n * const userSchema = t.object({ id: t.integer(), name: t.text() });\n * const userPageSchema = pageSchema(userSchema);\n * ```\n *\n * @example In an API endpoint\n * ```ts\n * $action({\n *   output: pageSchema(UserSchema),\n *   handler: async () => {\n *     return await userRepo.paginate();\n *   }\n * })\n * ```\n */\nexport const pageSchema = <T extends TObject | TRecord>(\n  objectSchema: T,\n  options?: TObjectOptions,\n): TPage<T> =>\n  t.object(\n    {\n      content: t.array(objectSchema),\n      page: pageMetadataSchema,\n    },\n    options,\n  );\n\nexport type TPage<T extends TObject | TRecord> = TObject<{\n  content: TArray<T>;\n  page: typeof pageMetadataSchema;\n}>;\n\n/**\n * Opinionated type definition for a paginated response.\n *\n * Inspired by Spring Data's Page interface with all essential pagination metadata.\n * This generic type can be used with any data source.\n *\n * @example\n * ```ts\n * const page: Page<User> = {\n *   content: [user1, user2, ...],\n *   page: {\n *     number: 0,\n *     size: 10,\n *     offset: 0,\n *     numberOfElements: 10,\n *     totalElements: 1200,\n *     totalPages: 120,\n *     isEmpty: false,\n *     isFirst: true,\n *     isLast: false,\n *     sort: {\n *       sorted: true,\n *       fields: [\n *         { field: \"name\", direction: \"asc\" }\n *       ]\n *     }\n *   }\n * }\n * ```\n */\nexport type Page<T> = {\n  /**\n   * Array of items on the current page.\n   */\n  content: T[];\n  page: Static<typeof pageMetadataSchema>;\n};\n\nexport type PageMetadata = Static<typeof pageMetadataSchema>;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface TypeProvider {\n    /**\n     * Create a schema for a paginated response.\n     */\n    page<T extends TObject | TRecord>(itemSchema: T): TPage<T>;\n  }\n}\n\nTypeProvider.prototype.page = (itemSchema) => pageSchema(itemSchema);\n","import { Alepha } from \"./Alepha.ts\";\nimport type { RunOptions } from \"./interfaces/Run.ts\";\nimport type { Service } from \"./interfaces/Service.ts\";\n\nexport * from \"./index.shared.ts\";\n\nexport const run = (\n  entry: Alepha | Service | Array<Service>,\n  opts?: RunOptions,\n): Alepha => {\n  const alepha =\n    entry instanceof Alepha ? entry : Alepha.create({ env: { ...opts?.env } });\n\n  if (!(entry instanceof Alepha)) {\n    const entries = Array.isArray(entry) ? entry : [entry];\n    for (const e of entries) {\n      alepha.with(e);\n    }\n  }\n\n  if (import.meta?.hot) {\n    import.meta.hot.on(\"alepha:reload\", async () => {\n      window.location.reload();\n    });\n  }\n\n  (async () => {\n    try {\n      await opts?.configure?.(alepha);\n\n      await alepha.start();\n\n      if (opts?.ready) {\n        await opts.ready(alepha);\n      }\n    } catch (error) {\n      alepha.log?.error(\"Alepha failed to start\", error);\n    }\n  })();\n\n  (window as any).alepha = alepha;\n\n  return alepha;\n};\n"],"mappings":"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"}