alepha 0.14.0 → 0.14.2

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["keysToDelete: string[]"],"sources":["../../../src/cache/core/errors/CacheError.ts","../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","/**\n * Cache provider interface.\n *\n * All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n */\nexport abstract class CacheProvider {\n  /**\n   * Get the value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to get.\n   *\n   * @return The value of the key, or undefined if the key does not exist.\n   */\n  public abstract get(\n    name: string,\n    key: string,\n  ): Promise<Uint8Array | undefined>;\n\n  /**\n   * Set the string value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param ttl The time-to-live of the key, in milliseconds.\n   *\n   * @return The value of the key.\n   */\n  public abstract set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param keys The keys to delete.\n   */\n  public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n  public abstract has(name: string, key: string): Promise<boolean>;\n\n  public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n  /**\n   * Remove all keys from all cache names.\n   */\n  public abstract clear(): Promise<void>;\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport type { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n  data?: Uint8Array;\n  timeout?: Timeout;\n};\n\nexport class MemoryCacheProvider implements CacheProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    return this.store[name]?.[key]?.data;\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    this.store[name][key] ??= {};\n    this.store[name][key].data = value;\n\n    this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n    // clear previous timeout if exists\n    if (this.store[name][key].timeout) {\n      this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n      this.store[name][key].timeout = undefined;\n    }\n\n    if (ttl) {\n      this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n        () => this.del(name, key),\n        ttl,\n      );\n    }\n\n    return this.store[name][key].data;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    // delete all keys in name\n    if (keys.length === 0) {\n      this.log.debug(`Deleting all cache for name`, { name });\n\n      if (this.store[name]) {\n        for (const key of Object.keys(this.store[name])) {\n          const timeout = this.store[name][key]?.timeout;\n          if (timeout) {\n            this.dateTimeProvider.clearTimeout(timeout);\n          }\n        }\n      }\n      delete this.store[name];\n      return;\n    }\n\n    this.log.debug(`Deleting cache for name`, { name, keys });\n\n    // delete specific keys in name\n    for (const key of keys) {\n      if (this.store[name] == null) break;\n\n      const timeout = this.store[name][key]?.timeout;\n      if (timeout) {\n        this.dateTimeProvider.clearTimeout(timeout);\n      }\n\n      delete this.store[name][key];\n    }\n\n    if (Object.keys(this.store[name] ?? {}).length === 0) {\n      // if name is empty, delete it\n      delete this.store[name];\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.store[name]?.[key]?.data != null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const store = this.store[name] ?? {};\n    const keys = Object.keys(store);\n    if (filter) {\n      return keys.filter((key) => key.startsWith(filter));\n    }\n    return keys;\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n\n    // Clear all timeouts before clearing the store\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n  }\n}\n","import {\n  $env,\n  $inject,\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n  t,\n} from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { CacheError } from \"../errors/CacheError.ts\";\nimport { CacheProvider } from \"../providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"../providers/MemoryCacheProvider.ts\";\n\n/**\n * Creates a cache primitive for high-performance data caching with automatic management.\n *\n * Provides a caching layer that improves application performance by storing frequently accessed\n * data in memory or external stores like Redis, with support for both function result caching\n * and manual cache operations.\n *\n * **Key Features**\n * - Automatic function result caching based on input parameters\n * - Multiple storage backends (in-memory, Redis, custom providers)\n * - Intelligent serialization for JSON, strings, and binary data\n * - Configurable TTL with automatic expiration\n * - Pattern-based cache invalidation with wildcard support\n * - Environment controls to enable/disable caching\n *\n * **Storage Backends**\n * - Memory: Fast in-memory cache (default for development)\n * - Redis: Distributed cache for production environments\n * - Custom providers: Implement your own storage backend\n *\n * @example\n * ```ts\n * class DataService {\n *   // Function result caching\n *   getUserData = $cache({\n *     name: \"user-data\",\n *     ttl: [10, \"minutes\"],\n *     handler: async (userId: string) => {\n *       return await database.users.findById(userId);\n *     }\n *   });\n *\n *   // Manual cache operations\n *   sessionCache = $cache<UserSession>({\n *     name: \"sessions\",\n *     ttl: [1, \"hour\"]\n *   });\n *\n *   async storeSession(id: string, session: UserSession) {\n *     await this.sessionCache.set(id, session);\n *   }\n *\n *   async invalidateUserSessions(userId: string) {\n *     await this.sessionCache.invalidate(`user:${userId}:*`);\n *   }\n * }\n * ```\n */\nexport const $cache = <TReturn = string, TParameter extends any[] = any[]>(\n  options: CachePrimitiveOptions<TReturn, TParameter> = {},\n): CachePrimitiveFn<TReturn, TParameter> => {\n  const instance = createPrimitive(\n    CachePrimitive<TReturn, TParameter>,\n    options,\n  );\n  const fn = (...args: TParameter): Promise<TReturn> => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as CachePrimitiveFn<\n    TReturn,\n    TParameter\n  >;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface CachePrimitiveOptions<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> {\n  /**\n   * The cache name. This is useful for invalidating multiple caches at once.\n   *\n   * Store key as `cache:$name:$key`.\n   *\n   * @default Name of the key of the class.\n   */\n  name?: string;\n\n  /**\n   * Function which returns cached data.\n   */\n  handler?: (...args: TParameter) => TReturn;\n\n  /**\n   * The key generator for the cache.\n   * If not provided, the arguments will be json.stringify().\n   */\n  key?: (...args: TParameter) => string;\n\n  /**\n   * The store provider for the cache.\n   * If not provided, the default store provider will be used.\n   */\n  provider?: InstantiableClass<CacheProvider> | \"memory\";\n\n  /**\n   * The time-to-live for the cache in seconds.\n   * Set 0 to skip expiration.\n   *\n   * @default 300 (5 minutes).\n   */\n  ttl?: DurationLike;\n\n  /**\n   * If the cache is disabled.\n   */\n  disabled?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  CACHE_ENABLED: t.boolean({ default: true }),\n  CACHE_DEFAULT_TTL: t.number({\n    default: 300, // 5 minutes\n    description: \"The default time to live for cache entries. In seconds.\",\n  }),\n});\n\nexport class CachePrimitive<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends Primitive<CachePrimitiveOptions<TReturn, TParameter>> {\n  protected readonly env = $env(envSchema);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly provider = this.$provider();\n  protected encoder: TextEncoder = new TextEncoder();\n  protected decoder: TextDecoder = new TextDecoder();\n  protected codes = {\n    BINARY: 0x01,\n    JSON: 0x02,\n    STRING: 0x03,\n  };\n\n  public get container(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}:${this.config.propertyKey}`\n    );\n  }\n\n  public async run(...args: TParameter): Promise<TReturn> {\n    const handler = this.options.handler;\n    if (!handler) {\n      throw new Error(\"Cache handler is not defined.\");\n    }\n\n    const key = this.key(...args);\n    const cached = await this.get(key);\n    if (cached) {\n      return cached;\n    }\n\n    const result = await handler(...args);\n    // note: when exception occurs, don't cache the result\n\n    await this.set(key, result);\n\n    return result;\n  }\n\n  public key(...args: TParameter): string {\n    return this.options.key ? this.options.key(...args) : JSON.stringify(args);\n  }\n\n  public async invalidate(...keys: string[]): Promise<void> {\n    const keysToDelete: string[] = [];\n\n    for (const key of keys) {\n      if (key.endsWith(\"*\")) {\n        const result = await this.provider.keys(\n          this.container,\n          key.slice(0, -1),\n        );\n        keysToDelete.push(...result);\n      } else {\n        keysToDelete.push(key);\n      }\n    }\n\n    await this.provider.del(this.container, ...keysToDelete);\n  }\n\n  public async set(\n    key: string,\n    value: TReturn,\n    ttl?: DurationLike,\n  ): Promise<void> {\n    const px = this.dateTimeProvider\n      .duration(\n        ttl ?? this.options.ttl ?? [this.env.CACHE_DEFAULT_TTL, \"seconds\"],\n      )\n      .as(\"milliseconds\");\n\n    await this.provider.set(\n      this.container,\n      key,\n      this.serialize(value),\n      px > 0 ? px : undefined,\n    );\n  }\n\n  public async get(key: string): Promise<TReturn | undefined> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.env.CACHE_ENABLED\n    ) {\n      return undefined;\n    }\n\n    const data = await this.provider.get(this.container, key);\n    if (data) {\n      return await this.deserialize<TReturn>(data);\n    }\n\n    return undefined;\n  }\n\n  protected serialize<TReturn>(value: TReturn): Uint8Array {\n    if (value instanceof Uint8Array) {\n      return new Uint8Array([this.codes.BINARY, ...value]); // TODO: check if copy is ok?\n    }\n\n    if (typeof value === \"string\") {\n      return new Uint8Array([this.codes.STRING, ...this.encoder.encode(value)]);\n    }\n\n    return new Uint8Array([\n      this.codes.JSON,\n      ...this.encoder.encode(JSON.stringify(value)),\n    ]);\n  }\n\n  protected async deserialize<TReturn>(\n    uint8Array: Uint8Array,\n  ): Promise<TReturn> {\n    const type = uint8Array[0];\n    const payload = uint8Array.slice(1);\n\n    if (type === this.codes.BINARY) {\n      return payload as TReturn;\n    }\n    if (type === this.codes.JSON) {\n      return JSON.parse(this.decoder.decode(payload)) as TReturn;\n    }\n    if (type === this.codes.STRING) {\n      return this.decoder.decode(payload) as TReturn;\n    }\n\n    throw new CacheError(`Unknown serialization type: ${type}`);\n  }\n\n  protected $provider(): CacheProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(CacheProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryCacheProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\nexport interface CachePrimitiveFn<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends CachePrimitive<TReturn, TParameter> {\n  /**\n   * Run the cache primitive with the provided arguments.\n   */\n  (...args: TParameter): Promise<TReturn>;\n}\n\n$cache[KIND] = CachePrimitive;\n","import { $module } from \"alepha\";\nimport { $cache } from \"./primitives/$cache.ts\";\nimport { CacheProvider } from \"./providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$cache.ts\";\nexport * from \"./providers/CacheProvider.ts\";\nexport * from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides high-performance caching capabilities for Alepha applications with configurable TTL and multiple storage backends.\n *\n * The cache module enables declarative caching through the `$cache` primitive, allowing you to cache method results,\n * API responses, or computed values with automatic invalidation and type safety. It supports both in-memory and\n * persistent storage backends for different performance and durability requirements.\n *\n * @see {@link $cache}\n * @see {@link CacheProvider}\n * @module alepha.cache\n */\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  primitives: [$cache],\n  services: [CacheProvider, MemoryCacheProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: MemoryCacheProvider,\n    }),\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/core/errors/CacheError.ts","../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","/**\n * Cache provider interface.\n *\n * All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n */\nexport abstract class CacheProvider {\n  /**\n   * Get the value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to get.\n   *\n   * @return The value of the key, or undefined if the key does not exist.\n   */\n  public abstract get(\n    name: string,\n    key: string,\n  ): Promise<Uint8Array | undefined>;\n\n  /**\n   * Set the string value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param ttl The time-to-live of the key, in milliseconds.\n   *\n   * @return The value of the key.\n   */\n  public abstract set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param keys The keys to delete.\n   */\n  public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n  public abstract has(name: string, key: string): Promise<boolean>;\n\n  public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n  /**\n   * Remove all keys from all cache names.\n   */\n  public abstract clear(): Promise<void>;\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport type { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n  data?: Uint8Array;\n  timeout?: Timeout;\n};\n\nexport class MemoryCacheProvider implements CacheProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    return this.store[name]?.[key]?.data;\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    this.store[name][key] ??= {};\n    this.store[name][key].data = value;\n\n    this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n    // clear previous timeout if exists\n    if (this.store[name][key].timeout) {\n      this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n      this.store[name][key].timeout = undefined;\n    }\n\n    if (ttl) {\n      this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n        () => this.del(name, key),\n        ttl,\n      );\n    }\n\n    return this.store[name][key].data;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    // delete all keys in name\n    if (keys.length === 0) {\n      this.log.debug(`Deleting all cache for name`, { name });\n\n      if (this.store[name]) {\n        for (const key of Object.keys(this.store[name])) {\n          const timeout = this.store[name][key]?.timeout;\n          if (timeout) {\n            this.dateTimeProvider.clearTimeout(timeout);\n          }\n        }\n      }\n      delete this.store[name];\n      return;\n    }\n\n    this.log.debug(`Deleting cache for name`, { name, keys });\n\n    // delete specific keys in name\n    for (const key of keys) {\n      if (this.store[name] == null) break;\n\n      const timeout = this.store[name][key]?.timeout;\n      if (timeout) {\n        this.dateTimeProvider.clearTimeout(timeout);\n      }\n\n      delete this.store[name][key];\n    }\n\n    if (Object.keys(this.store[name] ?? {}).length === 0) {\n      // if name is empty, delete it\n      delete this.store[name];\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.store[name]?.[key]?.data != null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const store = this.store[name] ?? {};\n    const keys = Object.keys(store);\n    if (filter) {\n      return keys.filter((key) => key.startsWith(filter));\n    }\n    return keys;\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n\n    // Clear all timeouts before clearing the store\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n  }\n}\n","import {\n  $env,\n  $inject,\n  createPrimitive,\n  type InstantiableClass,\n  KIND,\n  Primitive,\n  t,\n} from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { CacheError } from \"../errors/CacheError.ts\";\nimport { CacheProvider } from \"../providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"../providers/MemoryCacheProvider.ts\";\n\n/**\n * Creates a cache primitive for high-performance data caching with automatic management.\n *\n * Provides a caching layer that improves application performance by storing frequently accessed\n * data in memory or external stores like Redis, with support for both function result caching\n * and manual cache operations.\n *\n * **Key Features**\n * - Automatic function result caching based on input parameters\n * - Multiple storage backends (in-memory, Redis, custom providers)\n * - Intelligent serialization for JSON, strings, and binary data\n * - Configurable TTL with automatic expiration\n * - Pattern-based cache invalidation with wildcard support\n * - Environment controls to enable/disable caching\n *\n * **Storage Backends**\n * - Memory: Fast in-memory cache (default for development)\n * - Redis: Distributed cache for production environments\n * - Custom providers: Implement your own storage backend\n *\n * @example\n * ```ts\n * class DataService {\n *   // Function result caching\n *   getUserData = $cache({\n *     name: \"user-data\",\n *     ttl: [10, \"minutes\"],\n *     handler: async (userId: string) => {\n *       return await database.users.findById(userId);\n *     }\n *   });\n *\n *   // Manual cache operations\n *   sessionCache = $cache<UserSession>({\n *     name: \"sessions\",\n *     ttl: [1, \"hour\"]\n *   });\n *\n *   async storeSession(id: string, session: UserSession) {\n *     await this.sessionCache.set(id, session);\n *   }\n *\n *   async invalidateUserSessions(userId: string) {\n *     await this.sessionCache.invalidate(`user:${userId}:*`);\n *   }\n * }\n * ```\n */\nexport const $cache = <TReturn = string, TParameter extends any[] = any[]>(\n  options: CachePrimitiveOptions<TReturn, TParameter> = {},\n): CachePrimitiveFn<TReturn, TParameter> => {\n  const instance = createPrimitive(\n    CachePrimitive<TReturn, TParameter>,\n    options,\n  );\n  const fn = (...args: TParameter): Promise<TReturn> => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as CachePrimitiveFn<\n    TReturn,\n    TParameter\n  >;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface CachePrimitiveOptions<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> {\n  /**\n   * The cache name. This is useful for invalidating multiple caches at once.\n   *\n   * Store key as `cache:$name:$key`.\n   *\n   * @default Name of the key of the class.\n   */\n  name?: string;\n\n  /**\n   * Function which returns cached data.\n   */\n  handler?: (...args: TParameter) => TReturn;\n\n  /**\n   * The key generator for the cache.\n   * If not provided, the arguments will be json.stringify().\n   */\n  key?: (...args: TParameter) => string;\n\n  /**\n   * The store provider for the cache.\n   * If not provided, the default store provider will be used.\n   */\n  provider?: InstantiableClass<CacheProvider> | \"memory\";\n\n  /**\n   * The time-to-live for the cache in seconds.\n   * Set 0 to skip expiration.\n   *\n   * @default 300 (5 minutes).\n   */\n  ttl?: DurationLike;\n\n  /**\n   * If the cache is disabled.\n   */\n  disabled?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  CACHE_ENABLED: t.boolean({ default: true }),\n  CACHE_DEFAULT_TTL: t.number({\n    default: 300, // 5 minutes\n    description: \"The default time to live for cache entries. In seconds.\",\n  }),\n});\n\nexport class CachePrimitive<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends Primitive<CachePrimitiveOptions<TReturn, TParameter>> {\n  protected readonly env = $env(envSchema);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly provider = this.$provider();\n  protected encoder: TextEncoder = new TextEncoder();\n  protected decoder: TextDecoder = new TextDecoder();\n  protected codes = {\n    BINARY: 0x01,\n    JSON: 0x02,\n    STRING: 0x03,\n  };\n\n  public get container(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}:${this.config.propertyKey}`\n    );\n  }\n\n  public async run(...args: TParameter): Promise<TReturn> {\n    const handler = this.options.handler;\n    if (!handler) {\n      throw new Error(\"Cache handler is not defined.\");\n    }\n\n    const key = this.key(...args);\n    const cached = await this.get(key);\n    if (cached) {\n      return cached;\n    }\n\n    const result = await handler(...args);\n    // note: when exception occurs, don't cache the result\n\n    await this.set(key, result);\n\n    return result;\n  }\n\n  public key(...args: TParameter): string {\n    return this.options.key ? this.options.key(...args) : JSON.stringify(args);\n  }\n\n  public async invalidate(...keys: string[]): Promise<void> {\n    const keysToDelete: string[] = [];\n\n    for (const key of keys) {\n      if (key.endsWith(\"*\")) {\n        const result = await this.provider.keys(\n          this.container,\n          key.slice(0, -1),\n        );\n        keysToDelete.push(...result);\n      } else {\n        keysToDelete.push(key);\n      }\n    }\n\n    await this.provider.del(this.container, ...keysToDelete);\n  }\n\n  public async set(\n    key: string,\n    value: TReturn,\n    ttl?: DurationLike,\n  ): Promise<void> {\n    const px = this.dateTimeProvider\n      .duration(\n        ttl ?? this.options.ttl ?? [this.env.CACHE_DEFAULT_TTL, \"seconds\"],\n      )\n      .as(\"milliseconds\");\n\n    await this.provider.set(\n      this.container,\n      key,\n      this.serialize(value),\n      px > 0 ? px : undefined,\n    );\n  }\n\n  public async get(key: string): Promise<TReturn | undefined> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.env.CACHE_ENABLED\n    ) {\n      return undefined;\n    }\n\n    const data = await this.provider.get(this.container, key);\n    if (data) {\n      return await this.deserialize<TReturn>(data);\n    }\n\n    return undefined;\n  }\n\n  protected serialize<TReturn>(value: TReturn): Uint8Array {\n    if (value instanceof Uint8Array) {\n      return new Uint8Array([this.codes.BINARY, ...value]); // TODO: check if copy is ok?\n    }\n\n    if (typeof value === \"string\") {\n      return new Uint8Array([this.codes.STRING, ...this.encoder.encode(value)]);\n    }\n\n    return new Uint8Array([\n      this.codes.JSON,\n      ...this.encoder.encode(JSON.stringify(value)),\n    ]);\n  }\n\n  protected async deserialize<TReturn>(\n    uint8Array: Uint8Array,\n  ): Promise<TReturn> {\n    const type = uint8Array[0];\n    const payload = uint8Array.slice(1);\n\n    if (type === this.codes.BINARY) {\n      return payload as TReturn;\n    }\n    if (type === this.codes.JSON) {\n      return JSON.parse(this.decoder.decode(payload)) as TReturn;\n    }\n    if (type === this.codes.STRING) {\n      return this.decoder.decode(payload) as TReturn;\n    }\n\n    throw new CacheError(`Unknown serialization type: ${type}`);\n  }\n\n  protected $provider(): CacheProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(CacheProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryCacheProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\nexport interface CachePrimitiveFn<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends CachePrimitive<TReturn, TParameter> {\n  /**\n   * Run the cache primitive with the provided arguments.\n   */\n  (...args: TParameter): Promise<TReturn>;\n}\n\n$cache[KIND] = CachePrimitive;\n","import { $module } from \"alepha\";\nimport { $cache } from \"./primitives/$cache.ts\";\nimport { CacheProvider } from \"./providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$cache.ts\";\nexport * from \"./providers/CacheProvider.ts\";\nexport * from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides high-performance caching capabilities for Alepha applications with configurable TTL and multiple storage backends.\n *\n * The cache module enables declarative caching through the `$cache` primitive, allowing you to cache method results,\n * API responses, or computed values with automatic invalidation and type safety. It supports both in-memory and\n * persistent storage backends for different performance and durability requirements.\n *\n * @see {@link $cache}\n * @see {@link CacheProvider}\n * @module alepha.cache\n */\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  primitives: [$cache],\n  services: [CacheProvider, MemoryCacheProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: MemoryCacheProvider,\n    }),\n});\n"],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -1,9 +1,11 @@
 import * as alepha0 from "alepha";
-import { Alepha } from "alepha";
+import { Alepha, Static } from "alepha";
 import { FileSystemProvider } from "alepha/file";
 import * as alepha_command0 from "alepha/command";
-import { CliProvider, RunnerMethod } from "alepha/command";
-import * as alepha_logger3 from "alepha/logger";
+import { CliProvider, CommandPrimitive, EnvUtils, RunnerMethod } from "alepha/command";
+import * as alepha_logger5 from "alepha/logger";
+import * as typebox0 from "typebox";
+import { DatabaseProvider } from "alepha/orm";
 
 //#region ../../src/cli/apps/AlephaCli.d.ts
 declare const AlephaCli: alepha0.Service<alepha0.Module>;
@@ -20,10 +22,37 @@ declare class AlephaPackageBuilderCli {
   src: string;
   dist: string;
   fs: FileSystemProvider;
-  make: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
+  make: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
 }
 declare function analyzeModules(srcDir: string, packageName: string): Promise<Module[]>;
 //#endregion
+//#region ../../src/cli/atoms/changelogOptions.d.ts
+/**
+ * Default scopes to ignore in changelog generation.
+ * Commits with these scopes won't appear in release notes.
+ */
+declare const DEFAULT_IGNORE: string[];
+/**
+ * Changelog configuration atom.
+ *
+ * Configure in `alepha.config.ts`:
+ * ```ts
+ * import { changelogOptions } from "alepha/cli";
+ *
+ * alepha.set(changelogOptions, {
+ *   ignore: ["project", "release", "chore", "docs"],
+ * });
+ * ```
+ */
+declare const changelogOptions: alepha0.Atom<alepha0.TObject<{
+  /**
+   * Scopes to ignore (e.g., "project", "release", "chore").
+   * Commits like `feat(chore): ...` will be excluded from changelog.
+   */
+  ignore: alepha0.TOptional<alepha0.TArray<alepha0.TString>>;
+}>, "alepha.changelog">;
+type ChangelogOptions = Static<typeof changelogOptions.schema>;
+//#endregion
 //#region ../../src/cli/services/AlephaCliUtils.d.ts
 /**
  * Utility service for common project operations used by CLI commands.
@@ -36,8 +65,9 @@ declare function analyzeModules(srcDir: string, packageName: string): Promise<Mo
  * - Alepha instance loading
  */
 declare class AlephaCliUtils {
-  protected readonly log: alepha_logger3.Logger;
+  protected readonly log: alepha_logger5.Logger;
   protected readonly fs: FileSystemProvider;
+  protected readonly envUtils: EnvUtils;
   /**
    * Execute a command using npx with inherited stdio.
    *
@@ -173,7 +203,7 @@ declare class AlephaCliUtils {
    * Reads the .env file in the specified root directory and sets
    * the environment variables in process.env.
    */
-  loadEnvFile(root: string, files?: string[]): Promise<void>;
+  loadEnv(root: string, files?: string[]): Promise<void>;
   getPackageManager(root: string, flags?: {
     yarn?: boolean;
     pnpm?: boolean;
@@ -233,112 +263,177 @@ interface DependencyModes {
   expo?: boolean;
 }
 //#endregion
-//#region ../../src/cli/commands/BiomeCommands.d.ts
-declare class BiomeCommands {
-  protected readonly log: alepha_logger3.Logger;
+//#region ../../src/cli/commands/build.d.ts
+declare class BuildCommand {
+  protected readonly log: alepha_logger5.Logger;
   protected readonly utils: AlephaCliUtils;
-  readonly format: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
-  readonly lint: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
+  readonly build: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    stats: alepha0.TOptional<alepha0.TBoolean>;
+    vercel: alepha0.TOptional<alepha0.TBoolean>;
+    cloudflare: alepha0.TOptional<alepha0.TBoolean>;
+    docker: alepha0.TOptional<alepha0.TBoolean>;
+    sitemap: alepha0.TOptional<alepha0.TString>;
+  }>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
 }
 //#endregion
-//#region ../../src/cli/commands/CoreCommands.d.ts
-declare class CoreCommands {
-  protected readonly log: alepha_logger3.Logger;
-  protected readonly cli: CliProvider;
-  protected readonly utils: AlephaCliUtils;
+//#region ../../src/cli/services/GitMessageParser.d.ts
+/**
+ * Service for parsing git commit messages into structured format.
+ *
+ * Only parses **conventional commits with a scope**:
+ * - `feat(scope): description` → feature
+ * - `fix(scope): description` → bug fix
+ * - `feat(scope)!: description` → breaking change
+ *
+ * Commits without scope are ignored, allowing developers to commit
+ * work-in-progress changes without polluting release notes:
+ * - `cli: work in progress` → ignored (no type)
+ * - `fix: quick patch` → ignored (no scope)
+ * - `feat(cli): add command` → included
+ */
+declare class GitMessageParser {
+  protected readonly log: alepha_logger5.Logger;
   /**
-   * Called when no command is provided
+   * Parse a git commit line into a structured Commit object.
+   *
+   * **Format:** `type(scope): description` or `type(scope)!: description`
+   *
+   * **Supported types:** feat, fix, docs, refactor, perf, revert
+   *
+   * **Breaking changes:** Use `!` before `:` (e.g., `feat(api)!: remove endpoint`)
+   *
+   * @returns Commit object or null if not matching/ignored
    */
-  readonly root: alepha_command0.CommandPrimitive<alepha0.TObject<{
-    version: alepha0.TOptional<alepha0.TBoolean>;
-  }>, alepha0.TSchema>;
+  parseCommit(line: string, config: ChangelogOptions): Commit | null;
+}
+//#endregion
+//#region ../../src/cli/commands/changelog.d.ts
+/**
+ * Git provider for executing git commands.
+ * Can be substituted in tests with a mock implementation.
+ */
+declare class GitProvider {
+  exec(cmd: string, cwd: string): Promise<string>;
+}
+interface Commit {
+  hash: string;
+  type: string;
+  scope: string | null;
+  description: string;
+  breaking: boolean;
+}
+interface ChangelogEntry {
+  features: Commit[];
+  fixes: Commit[];
+}
+/**
+ * Changelog command for generating release notes from git commits.
+ *
+ * Usage:
+ * - `alepha changelog` - Show unreleased changes since latest tag to HEAD
+ * - `alepha changelog --from=1.0.0` - Show changes from version to HEAD
+ * - `alepha changelog --from=1.0.0 --to=1.1.0` - Show changes between two refs
+ * - `alepha changelog | tee -a CHANGELOG.md` - Append to file
+ */
+declare class ChangelogCommand {
+  protected readonly log: alepha_logger5.Logger;
+  protected readonly git: GitProvider;
+  protected readonly parser: GitMessageParser;
+  protected readonly config: Readonly<{
+    ignore?: string[] | undefined;
+  }>;
   /**
-   * Clean the project, removing the "dist" directory
+   * Format a single commit line.
+   * Example: `- **cli**: add new command (\`abc1234\`)`
+   * Breaking changes are flagged: `- **cli**: add new command [BREAKING] (\`abc1234\`)`
    */
-  readonly clean: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
+  protected formatCommit(commit: Commit): string;
   /**
-   * Ensure the project has the necessary Alepha configuration files.
-   * Add the correct dependencies to package.json and install them.
+   * Format the changelog entry with sections.
    */
-  readonly init: alepha_command0.CommandPrimitive<alepha0.TObject<{
-    yarn: alepha0.TOptional<alepha0.TBoolean>;
-    pnpm: alepha0.TOptional<alepha0.TBoolean>;
-    npm: alepha0.TOptional<alepha0.TBoolean>;
-    bun: alepha0.TOptional<alepha0.TBoolean>;
-    react: alepha0.TOptional<alepha0.TBoolean>;
-    ui: alepha0.TOptional<alepha0.TBoolean>;
-    test: alepha0.TOptional<alepha0.TBoolean>;
-  }>, alepha0.TSchema>;
+  protected formatEntry(entry: ChangelogEntry): string;
+  /**
+   * Parse git log output into a changelog entry.
+   */
+  protected parseCommits(commitsOutput: string): ChangelogEntry;
+  /**
+   * Check if entry has any public commits.
+   */
+  protected hasChanges(entry: ChangelogEntry): boolean;
+  /**
+   * Get the latest version tag.
+   */
+  protected getLatestTag(git: (cmd: string) => Promise<string>): Promise<string | null>;
+  readonly changelog: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    /**
+     * Show changes from this ref (tag, commit, branch).
+     * Defaults to the latest version tag.
+     * Example: --from=1.0.0
+     */
+    from: alepha0.TOptional<alepha0.TString>;
+    /**
+     * Show changes up to this ref (tag, commit, branch).
+     * Defaults to HEAD.
+     * Example: --to=main
+     */
+    to: alepha0.TOptional<alepha0.TString>;
+  }>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
 }
 //#endregion
-//#region ../../src/cli/commands/DrizzleCommands.d.ts
-declare class DrizzleCommands {
-  log: alepha_logger3.Logger;
-  utils: AlephaCliUtils;
+//#region ../../src/cli/commands/clean.d.ts
+declare class CleanCommand {
+  /**
+   * Clean the project, removing the "dist" directory
+   */
+  readonly clean: alepha_command0.CommandPrimitive<typebox0.TObject<typebox0.TProperties>, typebox0.TSchema, typebox0.TObject<typebox0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/db.d.ts
+declare class DbCommand {
+  protected readonly log: alepha_logger5.Logger;
+  protected readonly utils: AlephaCliUtils;
   /**
    * Check if database migrations are up to date.
    */
-  check: alepha_command0.CommandPrimitive<alepha0.TObject<{
+  protected readonly check: alepha_command0.CommandPrimitive<alepha0.TObject<{
     provider: alepha0.TOptional<alepha0.TString>;
     mode: alepha0.TOptional<alepha0.TString>;
-  }>, alepha0.TOptional<alepha0.TString>>;
+  }>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
   /**
    * Generate database migration files
-   *
-   * - Loads the Alepha instance from the specified entry file.
-   * - Retrieves all repository primitives to gather database models.
-   * - Creates temporary entity definitions based on the current database schema.
-   * - Writes these definitions to a temporary schema file. (node_modules/.db/entities.ts)
-   * - Invokes Drizzle Kit's CLI to generate migration files based on the current schema.
    */
-  generate: alepha_command0.CommandPrimitive<alepha0.TObject<{
+  protected readonly generate: alepha_command0.CommandPrimitive<alepha0.TObject<{
     provider: alepha0.TOptional<alepha0.TString>;
     mode: alepha0.TOptional<alepha0.TString>;
     custom: alepha0.TOptional<alepha0.TString>;
-  }>, alepha0.TOptional<alepha0.TString>>;
+  }>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
   /**
    * Push database schema changes directly to the database
-   *
-   * - Loads the Alepha instance from the specified entry file.
-   * - Retrieves all repository primitives to gather database models.
-   * - Creates temporary entity definitions and Drizzle config.
-   * - Invokes Drizzle Kit's push command to apply schema changes directly.
    */
-  push: alepha_command0.CommandPrimitive<alepha0.TObject<{
+  protected readonly push: alepha_command0.CommandPrimitive<alepha0.TObject<{
     provider: alepha0.TOptional<alepha0.TString>;
     mode: alepha0.TOptional<alepha0.TString>;
-  }>, alepha0.TOptional<alepha0.TString>>;
+  }>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
   /**
    * Apply pending database migrations
-   *
-   * - Loads the Alepha instance from the specified entry file.
-   * - Retrieves all repository primitives to gather database models.
-   * - Creates temporary entity definitions and Drizzle config.
-   * - Invokes Drizzle Kit's migrate command to apply pending migrations.
    */
-  migrate: alepha_command0.CommandPrimitive<alepha0.TObject<{
+  protected readonly migrate: alepha_command0.CommandPrimitive<alepha0.TObject<{
     provider: alepha0.TOptional<alepha0.TString>;
     mode: alepha0.TOptional<alepha0.TString>;
-  }>, alepha0.TOptional<alepha0.TString>>;
+  }>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
   /**
    * Launch Drizzle Studio database browser
-   *
-   * - Loads the Alepha instance from the specified entry file.
-   * - Retrieves all repository primitives to gather database models.
-   * - Creates temporary entity definitions and Drizzle config.
-   * - Invokes Drizzle Kit's studio command to launch the web-based database browser.
    */
-  studio: alepha_command0.CommandPrimitive<alepha0.TObject<{
+  protected readonly studio: alepha_command0.CommandPrimitive<alepha0.TObject<{
     provider: alepha0.TOptional<alepha0.TString>;
     mode: alepha0.TOptional<alepha0.TString>;
-  }>, alepha0.TOptional<alepha0.TString>>;
+  }>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
+  /**
+   * Parent command for database operations.
+   */
+  readonly db: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
   /**
    * Run a drizzle-kit command for all database providers in an Alepha instance.
-   *
-   * Iterates through all repository providers, prepares Drizzle config for each,
-   * and executes the specified drizzle-kit command.
-   *
-   * @param options - Configuration including command to run, flags, and logging
    */
   runDrizzleKitCommand(options: {
     root: string;
@@ -351,16 +446,10 @@ declare class DrizzleCommands {
   }): Promise<void>;
   /**
    * Prepare Drizzle configuration files for a database provider.
-   *
-   * Creates temporary entities.js and drizzle.config.js files needed
-   * for Drizzle Kit commands to run properly.
-   *
-   * @param options - Configuration options including kit, provider info, and paths
-   * @returns Path to the generated drizzle.config.js file
    */
   prepareDrizzleConfig(options: {
     kit: any;
-    provider: any;
+    provider: DatabaseProvider;
     providerName: string;
     providerUrl: string;
     dialect: string;
@@ -369,8 +458,125 @@ declare class DrizzleCommands {
   }): Promise<string>;
 }
 //#endregion
-//#region ../../src/cli/commands/VerifyCommands.d.ts
-declare class VerifyCommands {
+//#region ../../src/cli/commands/deploy.d.ts
+declare class DeployCommand {
+  protected readonly log: alepha_logger5.Logger;
+  protected readonly utils: AlephaCliUtils;
+  /**
+   * Deploy the project to a hosting platform (e.g., Vercel, Cloudflare, Surge)
+   *
+   * Deploy command can be overridden by creating a alepha.config.ts in the project root:
+   *
+   * ```ts
+   * import { defineConfig } from "alepha/cli";
+   *
+   * export default defineConfig({
+   *   commands: {
+   *     deploy: {
+   *       handler: async ({ root, mode, flags }) => {
+   *         // Custom deployment logic here
+   *       },
+   *     },
+   *   },
+   * });
+   * ```
+   */
+  readonly deploy: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    build: alepha0.TBoolean;
+    migrate: alepha0.TBoolean;
+  }>, alepha0.TSchema, alepha0.TObject<{
+    VERCEL_TOKEN: alepha0.TOptional<alepha0.TString>;
+    VERCEL_ORG_ID: alepha0.TOptional<alepha0.TString>;
+    VERCEL_PROJECT_ID: alepha0.TOptional<alepha0.TString>;
+    CLOUDFLARE_API_TOKEN: alepha0.TOptional<alepha0.TString>;
+    CLOUDFLARE_ACCOUNT_ID: alepha0.TOptional<alepha0.TString>;
+  }>>;
+}
+//#endregion
+//#region ../../src/cli/commands/dev.d.ts
+declare class DevCommand {
+  protected readonly log: alepha_logger5.Logger;
+  protected readonly utils: AlephaCliUtils;
+  /**
+   * Will run the project in watch mode.
+   *
+   * - If an index.html file is found in the project root, it will run Vite in dev mode.
+   * - Otherwise, it will look for a server entry file and run it with tsx in watch mode.
+   */
+  readonly dev: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TOptional<alepha0.TString>, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/format.d.ts
+declare class FormatCommand {
+  protected readonly utils: AlephaCliUtils;
+  readonly format: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/init.d.ts
+declare class InitCommand {
+  protected readonly utils: AlephaCliUtils;
+  /**
+   * Ensure the project has the necessary Alepha configuration files.
+   * Add the correct dependencies to package.json and install them.
+   */
+  readonly init: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    yarn: alepha0.TOptional<alepha0.TBoolean>;
+    pnpm: alepha0.TOptional<alepha0.TBoolean>;
+    npm: alepha0.TOptional<alepha0.TBoolean>;
+    bun: alepha0.TOptional<alepha0.TBoolean>;
+    react: alepha0.TOptional<alepha0.TBoolean>;
+    ui: alepha0.TOptional<alepha0.TBoolean>;
+    test: alepha0.TOptional<alepha0.TBoolean>;
+  }>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/lint.d.ts
+declare class LintCommand {
+  protected readonly utils: AlephaCliUtils;
+  readonly lint: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/root.d.ts
+declare class RootCommand {
+  protected readonly log: alepha_logger5.Logger;
+  protected readonly cli: CliProvider;
+  /**
+   * Called when no command is provided
+   */
+  readonly root: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    version: alepha0.TOptional<alepha0.TBoolean>;
+  }>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/run.d.ts
+declare class RunCommand {
+  protected readonly utils: AlephaCliUtils;
+  readonly run: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    watch: alepha0.TOptional<alepha0.TBoolean>;
+  }>, alepha0.TString, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/test.d.ts
+declare class TestCommand {
+  protected readonly utils: AlephaCliUtils;
+  readonly test: alepha_command0.CommandPrimitive<alepha0.TObject<{
+    config: alepha0.TOptional<alepha0.TString>;
+  }>, alepha0.TSchema, alepha0.TObject<{
+    VITEST_ARGS: alepha0.TOptional<alepha0.TString>;
+  }>>;
+}
+//#endregion
+//#region ../../src/cli/commands/typecheck.d.ts
+declare class TypecheckCommand {
+  protected readonly utils: AlephaCliUtils;
+  /**
+   * Run TypeScript type checking across the codebase with no emit.
+   */
+  readonly typecheck: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/commands/verify.d.ts
+declare class VerifyCommand {
   protected readonly utils: AlephaCliUtils;
   /**
    * Run a series of verification commands to ensure code quality and correctness.
@@ -385,43 +591,26 @@ declare class VerifyCommands {
    * - Build the project
    * - Clean the project again
    */
-  readonly verify: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
-  /**
-   * Run TypeScript type checking across the codebase with no emit.
-   */
-  readonly typecheck: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
+  readonly verify: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
 }
 //#endregion
-//#region ../../src/cli/commands/ViteCommands.d.ts
-declare class ViteCommands {
-  protected readonly log: alepha_logger3.Logger;
-  protected readonly utils: AlephaCliUtils;
-  protected readonly env: {
-    VITEST_ARGS: string;
-  };
-  readonly run: alepha_command0.CommandPrimitive<alepha0.TObject<{
-    watch: alepha0.TOptional<alepha0.TBoolean>;
-  }>, alepha0.TString>;
-  /**
-   * Will run the project in watch mode.
-   *
-   * - If an index.html file is found in the project root, it will run Vite in dev mode.
-   * - Otherwise, it will look for a server entry file and run it with tsx in watch mode.
-   */
-  readonly dev: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TOptional<alepha0.TString>>;
-  readonly build: alepha_command0.CommandPrimitive<alepha0.TObject<{
-    stats: alepha0.TOptional<alepha0.TBoolean>;
-    vercel: alepha0.TOptional<alepha0.TBoolean>;
-    cloudflare: alepha0.TOptional<alepha0.TBoolean>;
-    docker: alepha0.TOptional<alepha0.TBoolean>;
-    sitemap: alepha0.TOptional<alepha0.TString>;
-    prerender: alepha0.TOptional<alepha0.TBoolean>;
-  }>, alepha0.TOptional<alepha0.TString>>;
-  readonly test: alepha_command0.CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema>;
-}
+//#region ../../src/cli/defineConfig.d.ts
+type AlephaCliConfig = (alepha: Alepha) => {
+  commands?: Record<string, CommandPrimitive>;
+  services?: Array<any>;
+};
+declare const defineConfig: (config: AlephaCliConfig) => (alepha: Alepha) => {
+  [x: string]: CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+};
+/**
+ * @alias defineConfig
+ */
+declare const defineAlephaConfig: (config: AlephaCliConfig) => (alepha: Alepha) => {
+  [x: string]: CommandPrimitive<alepha0.TObject<alepha0.TProperties>, alepha0.TSchema, alepha0.TObject<alepha0.TProperties>>;
+};
 //#endregion
 //#region ../../src/cli/version.d.ts
 declare const version: any;
 //#endregion
-export { AlephaCli, AlephaCliUtils, AlephaPackageBuilderCli, BiomeCommands, CoreCommands, DependencyModes, DrizzleCommands, VerifyCommands, ViteCommands, analyzeModules, version };
+export { AlephaCli, AlephaCliConfig, AlephaCliUtils, AlephaPackageBuilderCli, BuildCommand, ChangelogCommand, type ChangelogOptions, CleanCommand, Commit, DEFAULT_IGNORE, DbCommand, DependencyModes, DeployCommand, DevCommand, FormatCommand, GitMessageParser, GitProvider, InitCommand, LintCommand, RootCommand, RunCommand, TestCommand, TypecheckCommand, VerifyCommand, analyzeModules, changelogOptions, defineAlephaConfig, defineConfig, version };
 //# sourceMappingURL=index.d.ts.map